@notidotbot/noti-api-client 1.9.62 → 1.9.63

package/dist/classes/guildGiveaway.d.ts

@@ -18,6 +18,10 @@ export declare class APIGuildGiveaway {
     resendGiveawayMessage({ auth, guildId, giveawayId }: GuildGiveawayFunctionsInput['resendGiveawayMessage']): Promise<import("../types").WebResponse<string>>;
     startScheduledGiveaway({ auth, guildId, giveawayId }: GuildGiveawayFunctionsInput['startScheduledGiveaway']): Promise<import("../types").WebResponse<string>>;
     endGiveaway({ auth, guildId, giveawayId }: GuildGiveawayFunctionsInput['endGiveaway']): Promise<import("../types").WebResponse<string>>;
+    /** The server's public giveaways switches. 403 while the `publicGiveaways` flag is hidden for the caller. */
+    getPublicGiveawaySettings({ auth, guildId }: GuildGiveawayFunctionsInput['getPublicGiveawaySettings']): Promise<import("../types").WebResponse<PublicGiveawaySettings>>;
+    /** Change either switch, field by field (booleans only). Answers with both. */
+    updatePublicGiveawaySettings({ auth, guildId, ...body }: GuildGiveawayFunctionsInput['updatePublicGiveawaySettings']): Promise<import("../types").WebResponse<PublicGiveawaySettings>>;
     rerollGiveaway({ auth, guildId, giveawayId }: GuildGiveawayFunctionsInput['rerollGiveaway']): Promise<import("../types").WebResponse<string>>;
     deleteGiveaway({ auth, guildId, giveawayId, type }: GuildGiveawayFunctionsInput['deleteGiveaway']): Promise<import("../types").WebResponse<string>>;
 }
@@ -53,8 +57,16 @@ export type GuildGiveawayFunctionsInput<T extends WhenCreate = never> = {
         auth: string;
         guildId: string;
         giveawayId: string;
-        body: Pick<DeepPartial<GuildGiveawayZod>, 'winnerCount' | 'durationMinutes' | 'name'>;
+        body: Pick<DeepPartial<GuildGiveawayZod>, 'winnerCount' | 'durationMinutes' | 'name' | 'publicListing'>;
     };
+    'getPublicGiveawaySettings': {
+        auth: string;
+        guildId: string;
+    };
+    'updatePublicGiveawaySettings': {
+        auth: string;
+        guildId: string;
+    } & Partial<PublicGiveawaySettings>;
     'resendGiveawayMessage': {
         auth: string;
         guildId: string;
@@ -96,9 +108,18 @@ export type GuildGiveawayReturnTypes = {
     'deleteGiveawaySuccess': CancelOutWebResponses<Awaited<ReturnType<APIGuildGiveaway['deleteGiveaway']>>>;
     'endGiveawayRaw': Awaited<ReturnType<APIGuildGiveaway['endGiveaway']>>;
     'endGiveawaySuccess': CancelOutWebResponses<Awaited<ReturnType<APIGuildGiveaway['endGiveaway']>>>;
+    'getPublicGiveawaySettingsRaw': Awaited<ReturnType<APIGuildGiveaway['getPublicGiveawaySettings']>>;
+    'getPublicGiveawaySettingsSuccess': CancelOutWebResponses<Awaited<ReturnType<APIGuildGiveaway['getPublicGiveawaySettings']>>>;
+    'updatePublicGiveawaySettingsRaw': Awaited<ReturnType<APIGuildGiveaway['updatePublicGiveawaySettings']>>;
+    'updatePublicGiveawaySettingsSuccess': CancelOutWebResponses<Awaited<ReturnType<APIGuildGiveaway['updatePublicGiveawaySettings']>>>;
     'rerollGiveawayRaw': Awaited<ReturnType<APIGuildGiveaway['rerollGiveaway']>>;
     'rerollGiveawaySuccess': CancelOutWebResponses<Awaited<ReturnType<APIGuildGiveaway['rerollGiveaway']>>>;
 };
+/** `publicGiveaways`: list this server's giveaways on noti.bot (default on). `giveawayJoinLinks`: let people join from there (default off). */
+export type PublicGiveawaySettings = {
+    publicGiveaways: boolean;
+    giveawayJoinLinks: boolean;
+};
 export type WhenCreate = 'now' | 'later';
 export type StateType = 'live' | 'scheduled';
 export type GuildGiveawaysType = {
@@ -124,6 +145,12 @@ export type GuildGiveawaysType = {
         canBonusEntries: boolean;
         canRequirements: boolean;
         canModifyWhileRunning: boolean;
+        /** Claim to win (Premium Plus). Gate the claim window control on this. */
+        canClaim: boolean;
+        /** Winner role (Premium). Gate the winner role and its removal days on this. */
+        canWinnerRole: boolean;
+        /** The claim windows the server accepts, in minutes. Same list as `GIVEAWAY_CLAIM_WINDOWS`. */
+        claimWindowChoices: number[];
     };
     /** Which tier those caps came from, so the UI can name the plan in a limit message. */
     premium: {

package/dist/classes/guildGiveaway.js

@@ -58,6 +58,20 @@ class APIGuildGiveaway {
             endpoint: this.web.qp('/data/giveaways/' + guildId + '/' + giveawayId + '/end'),
         });
     }
+    /** The server's public giveaways switches. 403 while the `publicGiveaways` flag is hidden for the caller. */
+    async getPublicGiveawaySettings({ auth, guildId }) {
+        return await this.web.request({
+            method: 'GET', auth,
+            endpoint: this.web.qp('/data/guild/' + guildId + '/public-giveaways'),
+        });
+    }
+    /** Change either switch, field by field (booleans only). Answers with both. */
+    async updatePublicGiveawaySettings({ auth, guildId, ...body }) {
+        return await this.web.request({
+            method: 'PATCH', auth, body,
+            endpoint: this.web.qp('/data/guild/' + guildId + '/public-giveaways'),
+        });
+    }
     async rerollGiveaway({ auth, guildId, giveawayId }) {
         return await this.web.request({
             method: 'POST', auth,

package/dist/classes/publicDrops.d.ts

@@ -0,0 +1,147 @@
+import { CancelOutWebResponses } from '../types';
+import { WebDataManager } from '../core/manager';
+/**
+ * The PUBLIC drops and badges pages - current and upcoming Kick and Twitch drops campaigns, and the chat
+ * badges they reward.
+ *
+ * ── WHO SEES WHAT ──────────────────────────────────────────────────────────
+ * `listPublicDrops` / `listPublicBadges` need no session: the first 12. The `*All*` methods page the rest for
+ * any logged-in user (no server permission), so pass `auth`.
+ *
+ * ── SOURCES ────────────────────────────────────────────────────────────────
+ * Every response carries `sources`: whether the Kick or Twitch drops source is failing right now. An empty list
+ * with a failing source means "unavailable", not "no drops" - show it that way.
+ *
+ * Behind the `publicDrops` launch flag: while it is hidden for the caller the lists are EMPTY (not 403).
+ * Built from the bot's last successful sync (every 5 minutes), so a new campaign can take that long to appear.
+ */
+export declare class APIPublicDrops {
+    private web;
+    constructor(web: WebDataManager);
+    /** The first 12 drops campaigns, live (ending soonest) then upcoming. No session. */
+    listPublicDrops({ platform }?: PublicDropsFunctionsInput['listPublicDrops']): Promise<import("../types").WebResponse<PublicDropList>>;
+    /** Every drops campaign, 24 per page. Pass the previous page's `nextCursor`; null = last page. */
+    listAllPublicDrops({ auth, platform, cursor }: PublicDropsFunctionsInput['listAllPublicDrops']): Promise<import("../types").WebResponse<PublicDropPage>>;
+    /** The first 12 chat badges from drops, live then upcoming. No session. */
+    listPublicBadges({ platform }?: PublicDropsFunctionsInput['listPublicBadges']): Promise<import("../types").WebResponse<PublicBadgeList>>;
+    /** Every chat badge, 24 per page. */
+    listAllPublicBadges({ auth, platform, cursor }: PublicDropsFunctionsInput['listAllPublicBadges']): Promise<import("../types").WebResponse<PublicBadgePage>>;
+}
+/** `all` (or omitted) = both platforms. */
+export type PublicDropsPlatformFilter = 'kick' | 'twitch' | 'all';
+export type PublicDropsFunctionsInput = {
+    'listPublicDrops': {
+        platform?: PublicDropsPlatformFilter;
+    };
+    'listAllPublicDrops': {
+        auth: string;
+        platform?: PublicDropsPlatformFilter;
+        cursor?: string | null;
+    };
+    'listPublicBadges': {
+        platform?: PublicDropsPlatformFilter;
+    };
+    'listAllPublicBadges': {
+        auth: string;
+        platform?: PublicDropsPlatformFilter;
+        cursor?: string | null;
+    };
+};
+export type PublicDropsGetReturnTypes = {
+    'listPublicDropsRaw': Awaited<ReturnType<APIPublicDrops['listPublicDrops']>>;
+    'listPublicDropsSuccess': CancelOutWebResponses<Awaited<ReturnType<APIPublicDrops['listPublicDrops']>>>;
+    'listAllPublicDropsRaw': Awaited<ReturnType<APIPublicDrops['listAllPublicDrops']>>;
+    'listAllPublicDropsSuccess': CancelOutWebResponses<Awaited<ReturnType<APIPublicDrops['listAllPublicDrops']>>>;
+    'listPublicBadgesRaw': Awaited<ReturnType<APIPublicDrops['listPublicBadges']>>;
+    'listPublicBadgesSuccess': CancelOutWebResponses<Awaited<ReturnType<APIPublicDrops['listPublicBadges']>>>;
+    'listAllPublicBadgesRaw': Awaited<ReturnType<APIPublicDrops['listAllPublicBadges']>>;
+    'listAllPublicBadgesSuccess': CancelOutWebResponses<Awaited<ReturnType<APIPublicDrops['listAllPublicBadges']>>>;
+};
+/** Is each drops source failing right now. `since` is ISO, set while failing. */
+export type PublicDropsSources = {
+    kick: {
+        ok: boolean;
+        since: string | null;
+    };
+    twitch: {
+        ok: boolean;
+        since: string | null;
+    };
+};
+export type PublicDropReward = {
+    name: string;
+    imageUrl: string | null;
+    requiredMinutes: number | null;
+    /** Subscriptions the reward needs (Twitch only); null when none. */
+    requiredSubs: number | null;
+    isBadge: boolean;
+};
+/** One campaign. Mirrors `PublicDropCard` in Noti-v3's `src/modules/publicDrops.ts`. */
+export type PublicDropCard = {
+    /** `<platform>:<campaignId>`. */
+    id: string;
+    platform: 'kick' | 'twitch';
+    name: string;
+    game: {
+        name: string;
+        imageUrl: string | null;
+    };
+    /** Kick only. */
+    organization: string | null;
+    /** ISO. */
+    startsAt: string;
+    /** ISO. */
+    endsAt: string;
+    status: 'live' | 'upcoming';
+    /** Where to watch: the Kick category page, or the Twitch campaign page. */
+    url: string | null;
+    rewards: PublicDropReward[];
+    /** Kick drops earned only by watching these streamers; null for everyone else. */
+    exclusive: {
+        streamers: {
+            username: string;
+            url: string;
+        }[];
+    } | null;
+};
+/** One chat badge. Mirrors `PublicBadgeCard` in Noti-v3. */
+export type PublicBadgeCard = {
+    /** `<platform>:<rewardId>`. */
+    key: string;
+    platform: 'kick' | 'twitch';
+    name: string;
+    imageUrl: string | null;
+    game: string;
+    campaign: string;
+    /** ISO. */
+    startsAt: string;
+    /** ISO. */
+    endsAt: string;
+    /** Claimable right now. */
+    active: boolean;
+    url: string | null;
+    requiredMinutes: number | null;
+    requiredSubs: number | null;
+};
+export type PublicDropList = {
+    drops: PublicDropCard[];
+    total: number;
+    sources: PublicDropsSources;
+};
+export type PublicDropPage = {
+    drops: PublicDropCard[];
+    nextCursor: string | null;
+    total: number;
+    sources: PublicDropsSources;
+};
+export type PublicBadgeList = {
+    badges: PublicBadgeCard[];
+    total: number;
+    sources: PublicDropsSources;
+};
+export type PublicBadgePage = {
+    badges: PublicBadgeCard[];
+    nextCursor: string | null;
+    total: number;
+    sources: PublicDropsSources;
+};

package/dist/classes/publicDrops.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APIPublicDrops = void 0;
+// Data.
+/**
+ * The PUBLIC drops and badges pages - current and upcoming Kick and Twitch drops campaigns, and the chat
+ * badges they reward.
+ *
+ * ── WHO SEES WHAT ──────────────────────────────────────────────────────────
+ * `listPublicDrops` / `listPublicBadges` need no session: the first 12. The `*All*` methods page the rest for
+ * any logged-in user (no server permission), so pass `auth`.
+ *
+ * ── SOURCES ────────────────────────────────────────────────────────────────
+ * Every response carries `sources`: whether the Kick or Twitch drops source is failing right now. An empty list
+ * with a failing source means "unavailable", not "no drops" - show it that way.
+ *
+ * Behind the `publicDrops` launch flag: while it is hidden for the caller the lists are EMPTY (not 403).
+ * Built from the bot's last successful sync (every 5 minutes), so a new campaign can take that long to appear.
+ */
+class APIPublicDrops {
+    web;
+    constructor(web) {
+        this.web = web;
+    }
+    /** The first 12 drops campaigns, live (ending soonest) then upcoming. No session. */
+    async listPublicDrops({ platform } = {}) {
+        return await this.web.request({
+            method: 'GET',
+            endpoint: this.web.qp('/public/drops', platform ? { platform } : {}),
+        });
+    }
+    /** Every drops campaign, 24 per page. Pass the previous page's `nextCursor`; null = last page. */
+    async listAllPublicDrops({ auth, platform, cursor }) {
+        return await this.web.request({
+            method: 'GET', auth,
+            endpoint: this.web.qp('/public/drops/all', { ...(platform ? { platform } : {}), ...(cursor ? { cursor } : {}) }),
+        });
+    }
+    /** The first 12 chat badges from drops, live then upcoming. No session. */
+    async listPublicBadges({ platform } = {}) {
+        return await this.web.request({
+            method: 'GET',
+            endpoint: this.web.qp('/public/badges', platform ? { platform } : {}),
+        });
+    }
+    /** Every chat badge, 24 per page. */
+    async listAllPublicBadges({ auth, platform, cursor }) {
+        return await this.web.request({
+            method: 'GET', auth,
+            endpoint: this.web.qp('/public/badges/all', { ...(platform ? { platform } : {}), ...(cursor ? { cursor } : {}) }),
+        });
+    }
+}
+exports.APIPublicDrops = APIPublicDrops;

package/dist/classes/publicGiveaways.d.ts

@@ -0,0 +1,152 @@
+import { CancelOutWebResponses } from '../types';
+import { WebDataManager } from '../core/manager';
+/**
+ * The PUBLIC giveaways page - running giveaways from every server that lists them on noti.bot.
+ *
+ * ── WHO SEES WHAT ──────────────────────────────────────────────────────────
+ * `listPublicGiveaways` needs no session: the latest 10. Everything else needs a logged-in user (any
+ * Discord account - no server permission), so pass `auth`.
+ *
+ * ── LISTED BY DEFAULT ──────────────────────────────────────────────────────
+ * A server's giveaways are listed unless it switched them off (`guildGiveaway.updatePublicGiveawaySettings`),
+ * and each giveaway can override that (`publicListing`). Behind the `publicGiveaways` launch flag: while it
+ * is hidden for the caller the lists are EMPTY (not 403) and single lookups 404.
+ *
+ * ── WHAT A CARD NEVER CARRIES ──────────────────────────────────────────────
+ * No host, winners, entrants or internal ids. Roles are names, dates are ISO strings, and a role deleted
+ * since the giveaway was made reads "deleted role" rather than disappearing.
+ *
+ * The lists are cached on the server for up to a minute, so an entry count can trail by that much.
+ */
+export declare class APIPublicGiveaways {
+    private web;
+    constructor(web: WebDataManager);
+    /** The latest 10 listed giveaways and how many are listed in all. No session. */
+    listPublicGiveaways(): Promise<import("../types").WebResponse<PublicGiveawayList>>;
+    /** Every listed giveaway, 24 per page, newest first. Pass the previous page's `nextCursor`; null = last page. */
+    listAllPublicGiveaways({ auth, cursor }: PublicGiveawaysFunctionsInput['listAllPublicGiveaways']): Promise<import("../types").WebResponse<PublicGiveawayPage>>;
+    /** One listed giveaway, plus where the logged-in user stands on it. 404 when it is not listed (or ended). */
+    getPublicGiveaway({ auth, giveawayId }: PublicGiveawaysFunctionsInput['getPublicGiveaway']): Promise<import("../types").WebResponse<PublicGiveawayWithViewer>>;
+    /**
+     * Enter a listed giveaway as the logged-in user - the same rules as the Discord button. A refusal is
+     * `{ status: 400 | 404 | 429, error: { code } }` with `code` from `PUBLIC_ENTRY_REFUSALS`; word it on the
+     * page (the card's `requirements` say what is required). 10 attempts per user per minute.
+     */
+    createPublicGiveawayEntry({ auth, giveawayId }: PublicGiveawaysFunctionsInput['createPublicGiveawayEntry']): Promise<import("../types").WebResponse<PublicGiveawayEntryResult>>;
+    /**
+     * A link to join the giveaway's server - only when the card's `canJoin` is true. 404 when the server does
+     * not allow it or no invite could be made. The same link is reused; do not call it per render.
+     */
+    getPublicGiveawayJoinLink({ auth, giveawayId }: PublicGiveawaysFunctionsInput['getPublicGiveawayJoinLink']): Promise<import("../types").WebResponse<{
+        url: string;
+    }>>;
+}
+export type PublicGiveawaysFunctionsInput = {
+    'listAllPublicGiveaways': {
+        auth: string;
+        cursor?: string | null;
+    };
+    'getPublicGiveaway': {
+        auth: string;
+        giveawayId: string;
+    };
+    'createPublicGiveawayEntry': {
+        auth: string;
+        giveawayId: string;
+    };
+    'getPublicGiveawayJoinLink': {
+        auth: string;
+        giveawayId: string;
+    };
+};
+export type PublicGiveawaysGetReturnTypes = {
+    'listPublicGiveawaysRaw': Awaited<ReturnType<APIPublicGiveaways['listPublicGiveaways']>>;
+    'listPublicGiveawaysSuccess': CancelOutWebResponses<Awaited<ReturnType<APIPublicGiveaways['listPublicGiveaways']>>>;
+    'listAllPublicGiveawaysRaw': Awaited<ReturnType<APIPublicGiveaways['listAllPublicGiveaways']>>;
+    'listAllPublicGiveawaysSuccess': CancelOutWebResponses<Awaited<ReturnType<APIPublicGiveaways['listAllPublicGiveaways']>>>;
+    'getPublicGiveawayRaw': Awaited<ReturnType<APIPublicGiveaways['getPublicGiveaway']>>;
+    'getPublicGiveawaySuccess': CancelOutWebResponses<Awaited<ReturnType<APIPublicGiveaways['getPublicGiveaway']>>>;
+    'createPublicGiveawayEntryRaw': Awaited<ReturnType<APIPublicGiveaways['createPublicGiveawayEntry']>>;
+    'createPublicGiveawayEntrySuccess': CancelOutWebResponses<Awaited<ReturnType<APIPublicGiveaways['createPublicGiveawayEntry']>>>;
+    'getPublicGiveawayJoinLinkRaw': Awaited<ReturnType<APIPublicGiveaways['getPublicGiveawayJoinLink']>>;
+    'getPublicGiveawayJoinLinkSuccess': CancelOutWebResponses<Awaited<ReturnType<APIPublicGiveaways['getPublicGiveawayJoinLink']>>>;
+};
+/**
+ * Every reason an entry can be refused. Mirrors `PUBLIC_ENTRY_REFUSALS` in Noti-v3's
+ * `src/modules/publicGiveaways.ts`; the eligibility ones match the card's `requirements` / `entryFilter`.
+ */
+export declare const PUBLIC_ENTRY_REFUSALS: readonly ["not_listed", "ended", "full", "not_member", "already_entered", "rate_limited", "role_whitelist", "role_blacklist", "joined_server_before", "account_created_before", "min_account_age", "boosting_server", "roles", "message_count"];
+export type PublicEntryRefusal = typeof PUBLIC_ENTRY_REFUSALS[number];
+export type PublicGiveawayRole = {
+    id: string;
+    name: string;
+};
+/** One giveaway as the public page shows it. Mirrors `PublicGiveawayCard` in Noti-v3. */
+export type PublicGiveawayCard = {
+    giveawayId: string;
+    name: string;
+    emoji: string | null;
+    /** ISO. */
+    endsAt: string;
+    winnerCount: number;
+    maxEntries: number | null;
+    entryCount: number;
+    /** Minutes winners have to press Claim; null when the giveaway does not need claiming. */
+    claimWindowMinutes: number | null;
+    /** Voting for Noti counts as a second entry. */
+    doubleVoteEntry: boolean;
+    requirements: {
+        /** ISO. */
+        joinedServerBefore: string | null;
+        /** ISO. */
+        accountCreatedBefore: string | null;
+        minAccountAgeDays: number | null;
+        boostingServer: boolean;
+        messageCount: number | null;
+        roles: PublicGiveawayRole[];
+    } | null;
+    entryFilter: {
+        mode: 'whitelist' | 'blacklist';
+        roles: PublicGiveawayRole[];
+    } | null;
+    /** `stacks: false` = only the member's highest bonus role counts. */
+    bonusRoles: {
+        roles: PublicGiveawayRole[];
+        additionalEntries: number;
+        stacks: boolean;
+    }[];
+    guild: {
+        id: string;
+        name: string;
+        icon: string | null;
+        memberCount: number;
+    };
+    /** The giveaway message in Discord. */
+    messageUrl: string;
+    /** The server lets people join from noti.bot - offer `getPublicGiveawayJoinLink`. */
+    canJoin: boolean;
+};
+export type PublicGiveawayViewer = {
+    entered: boolean;
+    isMember: boolean;
+    eligible: boolean;
+    /** Why not, when `eligible` is false. */
+    reason: PublicEntryRefusal | null;
+};
+export type PublicGiveawayList = {
+    giveaways: PublicGiveawayCard[];
+    total: number;
+};
+export type PublicGiveawayPage = {
+    giveaways: PublicGiveawayCard[];
+    nextCursor: string | null;
+    total: number;
+};
+export type PublicGiveawayWithViewer = {
+    giveaway: PublicGiveawayCard;
+    viewer: PublicGiveawayViewer;
+};
+export type PublicGiveawayEntryResult = {
+    entered: true;
+    entries: number;
+};

package/dist/classes/publicGiveaways.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PUBLIC_ENTRY_REFUSALS = exports.APIPublicGiveaways = void 0;
+// Data.
+/**
+ * The PUBLIC giveaways page - running giveaways from every server that lists them on noti.bot.
+ *
+ * ── WHO SEES WHAT ──────────────────────────────────────────────────────────
+ * `listPublicGiveaways` needs no session: the latest 10. Everything else needs a logged-in user (any
+ * Discord account - no server permission), so pass `auth`.
+ *
+ * ── LISTED BY DEFAULT ──────────────────────────────────────────────────────
+ * A server's giveaways are listed unless it switched them off (`guildGiveaway.updatePublicGiveawaySettings`),
+ * and each giveaway can override that (`publicListing`). Behind the `publicGiveaways` launch flag: while it
+ * is hidden for the caller the lists are EMPTY (not 403) and single lookups 404.
+ *
+ * ── WHAT A CARD NEVER CARRIES ──────────────────────────────────────────────
+ * No host, winners, entrants or internal ids. Roles are names, dates are ISO strings, and a role deleted
+ * since the giveaway was made reads "deleted role" rather than disappearing.
+ *
+ * The lists are cached on the server for up to a minute, so an entry count can trail by that much.
+ */
+class APIPublicGiveaways {
+    web;
+    constructor(web) {
+        this.web = web;
+    }
+    /** The latest 10 listed giveaways and how many are listed in all. No session. */
+    async listPublicGiveaways() {
+        return await this.web.request({
+            method: 'GET',
+            endpoint: this.web.qp('/public/giveaways'),
+        });
+    }
+    /** Every listed giveaway, 24 per page, newest first. Pass the previous page's `nextCursor`; null = last page. */
+    async listAllPublicGiveaways({ auth, cursor }) {
+        return await this.web.request({
+            method: 'GET', auth,
+            endpoint: this.web.qp('/public/giveaways/all', cursor ? { cursor } : {}),
+        });
+    }
+    /** One listed giveaway, plus where the logged-in user stands on it. 404 when it is not listed (or ended). */
+    async getPublicGiveaway({ auth, giveawayId }) {
+        return await this.web.request({
+            method: 'GET', auth,
+            endpoint: this.web.qp('/public/giveaways/' + giveawayId),
+        });
+    }
+    /**
+     * Enter a listed giveaway as the logged-in user - the same rules as the Discord button. A refusal is
+     * `{ status: 400 | 404 | 429, error: { code } }` with `code` from `PUBLIC_ENTRY_REFUSALS`; word it on the
+     * page (the card's `requirements` say what is required). 10 attempts per user per minute.
+     */
+    async createPublicGiveawayEntry({ auth, giveawayId }) {
+        return await this.web.request({
+            method: 'POST', auth,
+            endpoint: this.web.qp('/public/giveaways/' + giveawayId + '/entries'),
+        });
+    }
+    /**
+     * A link to join the giveaway's server - only when the card's `canJoin` is true. 404 when the server does
+     * not allow it or no invite could be made. The same link is reused; do not call it per render.
+     */
+    async getPublicGiveawayJoinLink({ auth, giveawayId }) {
+        return await this.web.request({
+            method: 'GET', auth,
+            endpoint: this.web.qp('/public/giveaways/' + giveawayId + '/join'),
+        });
+    }
+}
+exports.APIPublicGiveaways = APIPublicGiveaways;
+/**
+ * Every reason an entry can be refused. Mirrors `PUBLIC_ENTRY_REFUSALS` in Noti-v3's
+ * `src/modules/publicGiveaways.ts`; the eligibility ones match the card's `requirements` / `entryFilter`.
+ */
+exports.PUBLIC_ENTRY_REFUSALS = [
+    'not_listed', 'ended', 'full', 'not_member', 'already_entered', 'rate_limited',
+    'role_whitelist', 'role_blacklist', 'joined_server_before', 'account_created_before', 'min_account_age',
+    'boosting_server', 'roles', 'message_count',
+];

package/dist/core/manager.d.ts

@@ -29,6 +29,8 @@ import { APIEmotes } from '../classes/emotes';
 import { APIFiles } from '../classes/files';
 import { APIMinigamesFishing } from '../classes/minigamesFishing';
 import { APIPublicFishing } from '../classes/publicFishing';
+import { APIPublicGiveaways } from '../classes/publicGiveaways';
+import { APIPublicDrops } from '../classes/publicDrops';
 import { APIGuildFishing } from '../classes/guildFishing';
 import { APIAdminFishing } from '../classes/adminFishing';
 import { APIAdmin } from '../classes/admin';
@@ -50,6 +52,8 @@ export declare class WebDataManager {
     readonly guildFishing: APIGuildFishing;
     readonly minigamesFishing: APIMinigamesFishing;
     readonly publicFishing: APIPublicFishing;
+    readonly publicGiveaways: APIPublicGiveaways;
+    readonly publicDrops: APIPublicDrops;
     readonly other: APIOther;
     readonly guild: APIGuild;
     readonly teams: APITeams;

package/dist/core/manager.js

@@ -34,6 +34,8 @@ const emotes_1 = require("../classes/emotes");
 const files_1 = require("../classes/files");
 const minigamesFishing_1 = require("../classes/minigamesFishing");
 const publicFishing_1 = require("../classes/publicFishing");
+const publicGiveaways_1 = require("../classes/publicGiveaways");
+const publicDrops_1 = require("../classes/publicDrops");
 const guildFishing_1 = require("../classes/guildFishing");
 const adminFishing_1 = require("../classes/adminFishing");
 const admin_1 = require("../classes/admin");
@@ -54,6 +56,8 @@ class WebDataManager {
     guildFishing = new guildFishing_1.APIGuildFishing(this);
     minigamesFishing = new minigamesFishing_1.APIMinigamesFishing(this);
     publicFishing = new publicFishing_1.APIPublicFishing(this);
+    publicGiveaways = new publicGiveaways_1.APIPublicGiveaways(this);
+    publicDrops = new publicDrops_1.APIPublicDrops(this);
     other = new other_1.APIOther(this);
     guild = new guild_1.APIGuild(this);
     teams = new teams_1.APITeams(this);

package/dist/index.d.ts

@@ -7,6 +7,8 @@ export * from './classes/adminFishing';
 export * from './classes/guildFishing';
 export * from './classes/minigamesFishing';
 export * from './classes/publicFishing';
+export * from './classes/publicGiveaways';
+export * from './classes/publicDrops';
 export * from './classes/emotes';
 export * from './classes/files';
 export * from './classes/other';
@@ -39,6 +41,8 @@ export { GuildMessageTypeEnum, StreamerMessageTypeEnum, PlatformEnum, $Enums } f
 export { FEATURE_NAMES, } from './other/features';
 export { OFFLINE_GRACE_CHOICES, OFFLINE_GRACE_DEFAULT, OFFLINE_GRACE_PLATFORMS, } from './other/offlineGrace';
 export type { OfflineGraceMinutes, OfflineGracePlatform } from './other/offlineGrace';
+export { GIVEAWAY_CLAIM_WINDOWS, GIVEAWAY_CLAIM_WINDOW_LABELS, GIVEAWAY_MAX_CLAIM_ROUNDS, GIVEAWAY_WINNER_ROLE_MAX_DAYS, GIVEAWAY_MIN_ACCOUNT_AGE_MAX_DAYS, GIVEAWAY_WINNER_ROLE_FORBIDDEN_PERMISSIONS, } from './other/giveawayClaims';
+export type { GiveawayClaimWindow, GiveawayWinnerStatus } from './other/giveawayClaims';
 export type { FeatureName, FeatureStatus, ResolvedFeature, } from './other/features';
 export type { Prisma, TSPrisma } from '@prisma/client';
 export type { ClientChangelog, Guild, User, Team, Member, KickStreamer, TwitchStreamer, YoutubeStreamer, TiktokStreamer, RumbleStreamer, ClubStreamer, TwitterStreamer, GuildGiveaway, GuildRolePanel, GuildClipForward } from '@prisma/client';

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OFFLINE_GRACE_PLATFORMS = exports.OFFLINE_GRACE_DEFAULT = exports.OFFLINE_GRACE_CHOICES = exports.FEATURE_NAMES = exports.$Enums = exports.PlatformEnum = exports.StreamerMessageTypeEnum = exports.GuildMessageTypeEnum = void 0;
+exports.GIVEAWAY_WINNER_ROLE_FORBIDDEN_PERMISSIONS = exports.GIVEAWAY_MIN_ACCOUNT_AGE_MAX_DAYS = exports.GIVEAWAY_WINNER_ROLE_MAX_DAYS = exports.GIVEAWAY_MAX_CLAIM_ROUNDS = exports.GIVEAWAY_CLAIM_WINDOW_LABELS = exports.GIVEAWAY_CLAIM_WINDOWS = exports.OFFLINE_GRACE_PLATFORMS = exports.OFFLINE_GRACE_DEFAULT = exports.OFFLINE_GRACE_CHOICES = exports.FEATURE_NAMES = exports.$Enums = exports.PlatformEnum = exports.StreamerMessageTypeEnum = exports.GuildMessageTypeEnum = void 0;
 __exportStar(require("./core/manager"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./classes/@me"), exports);
@@ -24,6 +24,8 @@ __exportStar(require("./classes/adminFishing"), exports);
 __exportStar(require("./classes/guildFishing"), exports);
 __exportStar(require("./classes/minigamesFishing"), exports);
 __exportStar(require("./classes/publicFishing"), exports);
+__exportStar(require("./classes/publicGiveaways"), exports);
+__exportStar(require("./classes/publicDrops"), exports);
 __exportStar(require("./classes/emotes"), exports);
 __exportStar(require("./classes/files"), exports);
 __exportStar(require("./classes/other"), exports);
@@ -65,3 +67,10 @@ var offlineGrace_1 = require("./other/offlineGrace");
 Object.defineProperty(exports, "OFFLINE_GRACE_CHOICES", { enumerable: true, get: function () { return offlineGrace_1.OFFLINE_GRACE_CHOICES; } });
 Object.defineProperty(exports, "OFFLINE_GRACE_DEFAULT", { enumerable: true, get: function () { return offlineGrace_1.OFFLINE_GRACE_DEFAULT; } });
 Object.defineProperty(exports, "OFFLINE_GRACE_PLATFORMS", { enumerable: true, get: function () { return offlineGrace_1.OFFLINE_GRACE_PLATFORMS; } });
+var giveawayClaims_1 = require("./other/giveawayClaims");
+Object.defineProperty(exports, "GIVEAWAY_CLAIM_WINDOWS", { enumerable: true, get: function () { return giveawayClaims_1.GIVEAWAY_CLAIM_WINDOWS; } });
+Object.defineProperty(exports, "GIVEAWAY_CLAIM_WINDOW_LABELS", { enumerable: true, get: function () { return giveawayClaims_1.GIVEAWAY_CLAIM_WINDOW_LABELS; } });
+Object.defineProperty(exports, "GIVEAWAY_MAX_CLAIM_ROUNDS", { enumerable: true, get: function () { return giveawayClaims_1.GIVEAWAY_MAX_CLAIM_ROUNDS; } });
+Object.defineProperty(exports, "GIVEAWAY_WINNER_ROLE_MAX_DAYS", { enumerable: true, get: function () { return giveawayClaims_1.GIVEAWAY_WINNER_ROLE_MAX_DAYS; } });
+Object.defineProperty(exports, "GIVEAWAY_MIN_ACCOUNT_AGE_MAX_DAYS", { enumerable: true, get: function () { return giveawayClaims_1.GIVEAWAY_MIN_ACCOUNT_AGE_MAX_DAYS; } });
+Object.defineProperty(exports, "GIVEAWAY_WINNER_ROLE_FORBIDDEN_PERMISSIONS", { enumerable: true, get: function () { return giveawayClaims_1.GIVEAWAY_WINNER_ROLE_FORBIDDEN_PERMISSIONS; } });