@notidotbot/noti-api-client 1.4.23 → 1.5.0

package/dist/classes/games.d.ts

@@ -84,6 +84,55 @@ export interface ChangelogEntry {
     publishedAt: string;
     feedLabel: string;
 }
+export type RobloxSignal = 'update' | 'event';
+export interface RobloxEntry {
+    id: string;
+    signal: RobloxSignal;
+    universeId: number;
+    /** canonical root place — the game URL is roblox.com/games/<placeId> */
+    placeId: number;
+    gameTitle: string;
+    /** update: "<name> was updated" · event: the event title */
+    title: string;
+    /** event description; null for updates (no notes text exists) */
+    description: string | null;
+    url: string;
+    thumbnail: string | null;
+    /** event window (null for updates) */
+    startsAt: string | null;
+    endsAt: string | null;
+    /** event status: 'active' | 'upcoming' | … (null for updates) */
+    status: string | null;
+    /** live players (update signal); null for events */
+    playing: number | null;
+    publishedAt: string;
+}
+/** A followable Roblox discovery card (popular grid + name search). `following` reflects THIS
+ * guild's follows — the bot recomputes gameApi's GLOBAL flag against the guild before returning. */
+export interface RobloxPopularGame {
+    universeId: number;
+    placeId: number;
+    name: string;
+    playing: number | null;
+    thumbnail: string | null;
+    following: boolean;
+}
+/** Live preview of a pasted `roblox.com/games/<id>` URL or bare place id before following.
+ * `inWatchlist` is recomputed against THIS guild's follows (not the global gameApi set). */
+export interface RobloxLookupResult {
+    placeId: number;
+    universeId: number;
+    rootPlaceId: number | null;
+    title: string | null;
+    playing: number | null;
+    thumbnail: string | null;
+    inWatchlist: boolean;
+}
+/** Followable-card list — shared by the popular grid and the name search box. */
+export interface RobloxDiscoverResponse {
+    items: RobloxPopularGame[];
+    total: number;
+}
 export interface DealsCatalogResponse {
     items: DealItem[];
     nextCursor: string | null;
@@ -188,6 +237,20 @@ export interface ChangelogGame {
     channelId?: string | null;
     pingRoleId?: string | null;
 }
+export type RobloxKind = 'updates' | 'events' | 'both';
+/** A followed Roblox experience. Keyed by canonical root `placeId` (paste a URL or id); ids are
+ * strings because Roblox ids overflow a 32-bit number column. `universeId` is resolved by the gameApi. */
+export interface RobloxGame {
+    dbId?: string;
+    placeId: string;
+    universeId?: string | null;
+    title?: string | null;
+    /** Which signal(s) to notify on. Default `both`. */
+    kinds?: RobloxKind;
+    /** Optional per-game routing override (else uses the guild's default Roblox channel/role). */
+    channelId?: string | null;
+    pingRoleId?: string | null;
+}
 export interface GameConfig {
     guildId?: string;
     enabled: boolean;
@@ -217,9 +280,12 @@ export interface GameConfig {
     allTimeLowMaxPriceCents: number | null;
     changelogChannelId: string | null;
     changelogPingRoleId: string | null;
+    robloxChannelId: string | null;
+    robloxPingRoleId: string | null;
     categoryRoutes: GameCategoryRoute[];
     trackedGames: TrackedGame[];
     changelogGames: ChangelogGame[];
+    robloxGames: RobloxGame[];
 }
 /** Resolved premium entitlements + limits for the guild (gating is visual, never hidden). */
 export interface GameEntitlements {
@@ -228,6 +294,7 @@ export interface GameEntitlements {
     allTimeLow: boolean;
     customWebhooks: boolean;
     changelogs: boolean;
+    roblox: boolean;
     trackedGameLimit: number;
 }
 export interface GameConfigResponse {
@@ -274,8 +341,14 @@ export type GamesWsEvent = {
     type: 'changelog.new';
     at: string;
     changelog: ChangelogEntry;
+} | {
+    op: 'event';
+    type: GameRobloxEventType;
+    at: string;
+    roblox: RobloxEntry;
 };
 export type GameDealEventType = 'deal.new' | 'deal.updated' | 'deal.expired' | 'deal.enriched' | 'free.new' | 'free.upcoming' | 'free.expired' | 'free.weekend' | 'deal.lowest';
+export type GameRobloxEventType = 'roblox.update' | 'roblox.event';
 export declare class APIGames {
     private web;
     constructor(web: WebDataManager);
@@ -287,6 +360,11 @@ export declare class APIGames {
     updateChangelogGames({ auth, guildId, games }: GamesFunctionsInput['updateChangelogGames']): Promise<WebResponse<{
         games: ChangelogGame[];
     }>>;
+    /** Replace the guild's followed Roblox experiences (replace-semantics). `placeId` accepts a game
+     * URL, a bare id, or a numeric string — the bot extracts the place id. Capped at 500. */
+    updateRobloxGames({ auth, guildId, games }: GamesFunctionsInput['updateRobloxGames']): Promise<WebResponse<{
+        games: RobloxGame[];
+    }>>;
     updateCategoryRoutes({ auth, guildId, routes }: GamesFunctionsInput['updateCategoryRoutes']): Promise<WebResponse<{
         routes: GameCategoryRoute[];
     }>>;
@@ -301,6 +379,13 @@ export declare class APIGames {
     getHealth({ auth, guildId }: GamesFunctionsInput['getHealth']): Promise<WebResponse<GameHealthBundle>>;
     /** Full Steam catalog search by name (proxied from the gameApi) — find ANY Steam game, not just catalog deals. */
     searchSteam({ auth, guildId, q, limit }: GamesFunctionsInput['searchSteam']): Promise<WebResponse<SteamSearchResponse>>;
+    /** Discover grid — top ~100 Roblox games by players. `following` reflects THIS guild's follows. */
+    getRobloxPopular({ auth, guildId }: GamesFunctionsInput['getRobloxPopular']): Promise<WebResponse<RobloxDiscoverResponse>>;
+    /** Search Roblox games by name (live proxy). Same followable-card shape as the popular grid. */
+    searchRoblox({ auth, guildId, q, limit }: GamesFunctionsInput['searchRoblox']): Promise<WebResponse<RobloxDiscoverResponse>>;
+    /** Preview a pasted `roblox.com/games/<id>` URL or bare place id before following — resolves the
+     * title/thumbnail/players. `placeId` accepts a URL or id; the bot extracts the numeric id. */
+    lookupRoblox({ auth, guildId, placeId }: GamesFunctionsInput['lookupRoblox']): Promise<WebResponse<RobloxLookupResult>>;
 }
 export type GameDealsQuery = {
     kind?: string;
@@ -331,7 +416,7 @@ export type GamesFunctionsInput = {
     updateConfig: {
         auth: string;
         guildId: string;
-    } & Partial<Omit<GameConfig, 'guildId' | 'categoryRoutes' | 'trackedGames' | 'changelogGames'>>;
+    } & Partial<Omit<GameConfig, 'guildId' | 'categoryRoutes' | 'trackedGames' | 'changelogGames' | 'robloxGames'>>;
     updateTrackedGames: {
         auth: string;
         guildId: string;
@@ -342,6 +427,11 @@ export type GamesFunctionsInput = {
         guildId: string;
         games: ChangelogGame[];
     };
+    updateRobloxGames: {
+        auth: string;
+        guildId: string;
+        games: RobloxGame[];
+    };
     updateCategoryRoutes: {
         auth: string;
         guildId: string;
@@ -394,6 +484,21 @@ export type GamesFunctionsInput = {
         q: string;
         limit?: number;
     };
+    getRobloxPopular: {
+        auth: string;
+        guildId: string;
+    };
+    searchRoblox: {
+        auth: string;
+        guildId: string;
+        q: string;
+        limit?: number;
+    };
+    lookupRoblox: {
+        auth: string;
+        guildId: string;
+        placeId: string | number;
+    };
 };
 export type GamesReturnTypes = {
     getConfigRaw: Awaited<ReturnType<APIGames['getConfig']>>;

package/dist/classes/games.js

@@ -20,6 +20,11 @@ class APIGames {
     async updateChangelogGames({ auth, guildId, games }) {
         return this.web.request({ method: 'PUT', auth, endpoint: this.web.qp(`/data/guild/${guildId}/games/changelogs`), body: { games } });
     }
+    /** Replace the guild's followed Roblox experiences (replace-semantics). `placeId` accepts a game
+     * URL, a bare id, or a numeric string — the bot extracts the place id. Capped at 500. */
+    async updateRobloxGames({ auth, guildId, games }) {
+        return this.web.request({ method: 'PUT', auth, endpoint: this.web.qp(`/data/guild/${guildId}/games/roblox`), body: { games } });
+    }
     async updateCategoryRoutes({ auth, guildId, routes }) {
         return this.web.request({ method: 'PUT', auth, endpoint: this.web.qp(`/data/guild/${guildId}/games/routes`), body: { routes } });
     }
@@ -53,5 +58,19 @@ class APIGames {
     async searchSteam({ auth, guildId, q, limit }) {
         return this.web.request({ method: 'GET', auth, endpoint: this.web.qp(`/data/guild/${guildId}/games/steam/search`, { q, limit }) });
     }
+    // ── Roblox discovery (three ways to find a followable game) ───────────────
+    /** Discover grid — top ~100 Roblox games by players. `following` reflects THIS guild's follows. */
+    async getRobloxPopular({ auth, guildId }) {
+        return this.web.request({ method: 'GET', auth, endpoint: this.web.qp(`/data/guild/${guildId}/games/roblox/popular`) });
+    }
+    /** Search Roblox games by name (live proxy). Same followable-card shape as the popular grid. */
+    async searchRoblox({ auth, guildId, q, limit }) {
+        return this.web.request({ method: 'GET', auth, endpoint: this.web.qp(`/data/guild/${guildId}/games/roblox/search`, { q, limit }) });
+    }
+    /** Preview a pasted `roblox.com/games/<id>` URL or bare place id before following — resolves the
+     * title/thumbnail/players. `placeId` accepts a URL or id; the bot extracts the numeric id. */
+    async lookupRoblox({ auth, guildId, placeId }) {
+        return this.web.request({ method: 'GET', auth, endpoint: this.web.qp(`/data/guild/${guildId}/games/roblox/lookup`, { placeId }) });
+    }
 }
 exports.APIGames = APIGames;

package/dist/other/zod/gameConfig.zod.d.ts

@@ -67,6 +67,8 @@ export declare const GameConfigZod: {
         allTimeLowMaxPriceCents: z.ZodNullable<z.ZodNumber>;
         changelogChannelId: z.ZodNullable<z.ZodString>;
         changelogPingRoleId: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"everyone">, z.ZodLiteral<"here">]>>;
+        robloxChannelId: z.ZodNullable<z.ZodString>;
+        robloxPingRoleId: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"everyone">, z.ZodLiteral<"here">]>>;
         categoryRoutes: z.ZodArray<z.ZodLazy<z.ZodObject<{
             kinds: z.ZodArray<z.ZodEnum<{
                 free_game: "free_game";
@@ -118,6 +120,18 @@ export declare const GameConfigZod: {
             channelId: z.ZodNullable<z.ZodString>;
             pingRoleId: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"everyone">, z.ZodLiteral<"here">]>>;
         }, z.core.$strip>>>;
+        robloxGames: z.ZodArray<z.ZodLazy<z.ZodObject<{
+            placeId: z.ZodString;
+            universeId: z.ZodNullable<z.ZodString>;
+            title: z.ZodNullable<z.ZodString>;
+            kinds: z.ZodEnum<{
+                updates: "updates";
+                events: "events";
+                both: "both";
+            }>;
+            channelId: z.ZodNullable<z.ZodString>;
+            pingRoleId: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"everyone">, z.ZodLiteral<"here">]>>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>;
     readonly GuildGameCategoryRouteSchema: z.ZodObject<{
         kinds: z.ZodArray<z.ZodEnum<{
@@ -170,5 +184,17 @@ export declare const GameConfigZod: {
         channelId: z.ZodNullable<z.ZodString>;
         pingRoleId: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"everyone">, z.ZodLiteral<"here">]>>;
     }, z.core.$strip>;
+    readonly GuildRobloxGameSchema: z.ZodObject<{
+        placeId: z.ZodString;
+        universeId: z.ZodNullable<z.ZodString>;
+        title: z.ZodNullable<z.ZodString>;
+        kinds: z.ZodEnum<{
+            updates: "updates";
+            events: "events";
+            both: "both";
+        }>;
+        channelId: z.ZodNullable<z.ZodString>;
+        pingRoleId: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"everyone">, z.ZodLiteral<"here">]>>;
+    }, z.core.$strip>;
 };
 export declare const GameConfigZodPartial: PartialZodObject<typeof GameConfigZod>;

package/dist/other/zod/gameConfig.zod.js

@@ -42,6 +42,16 @@ const GuildGameChangelogSchema = zod_2.z.object({
     channelId: zod_1.SnowFlake.nullable(),
     pingRoleId: zod_1.SnowFlakeOrEveryone.nullable(),
 });
+// A Roblox experience the guild follows (updates and/or events). Keyed by canonical root placeId;
+// ids are strings because Roblox ids overflow a 32-bit Int. `universeId` is resolved by the gameApi.
+const GuildRobloxGameSchema = zod_2.z.object({
+    placeId: zod_2.z.string(),
+    universeId: zod_2.z.string().nullable(),
+    title: zod_2.z.string().max(200).nullable(),
+    kinds: schema_zod_1.GameRobloxKindEnum,
+    channelId: zod_1.SnowFlake.nullable(),
+    pingRoleId: zod_1.SnowFlakeOrEveryone.nullable(),
+});
 const GuildGameConfigSchema = zod_2.z.object({
     guildId: zod_1.SnowFlake,
     enabled: zod_2.z.boolean(),
@@ -79,14 +89,19 @@ const GuildGameConfigSchema = zod_2.z.object({
     // Game changelogs routing (PatchBot-style).
     changelogChannelId: zod_1.SnowFlake.nullable(),
     changelogPingRoleId: zod_1.SnowFlakeOrEveryone.nullable(),
+    // Roblox experience tracking routing.
+    robloxChannelId: zod_1.SnowFlake.nullable(),
+    robloxPingRoleId: zod_1.SnowFlakeOrEveryone.nullable(),
     categoryRoutes: (0, zod_1.NoDuplicate)(zod_2.z.array(zod_2.z.lazy(() => GuildGameCategoryRouteSchema)), ['priority']),
     trackedGames: zod_2.z.array(zod_2.z.lazy(() => GuildTrackedGameSchema)),
     changelogGames: (0, zod_1.NoDuplicate)(zod_2.z.array(zod_2.z.lazy(() => GuildGameChangelogSchema)), ['steamAppId']),
+    robloxGames: (0, zod_1.NoDuplicate)(zod_2.z.array(zod_2.z.lazy(() => GuildRobloxGameSchema)), ['placeId']),
 });
 exports.GameConfigZod = {
     GuildGameConfigSchema,
     GuildGameCategoryRouteSchema,
     GuildTrackedGameSchema,
     GuildGameChangelogSchema,
+    GuildRobloxGameSchema,
 };
 exports.GameConfigZodPartial = Object.fromEntries(Object.entries(exports.GameConfigZod).map(([key, value]) => [key, (0, schema_zod_1.deepPartialify)(value)]));

package/dist/other/zod/schema.zod.d.ts

@@ -160,3 +160,8 @@ export declare const GameDeliveryEnum: z.ZodEnum<{
     instant: "instant";
     daily: "daily";
 }>;
+export declare const GameRobloxKindEnum: z.ZodEnum<{
+    updates: "updates";
+    events: "events";
+    both: "both";
+}>;

package/dist/other/zod/schema.zod.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GameDeliveryEnum = exports.GameFlagEnum = exports.GameKindEnum = exports.GameStoreEnum = exports.UserNotificationSeverityEnum = exports.RoleBonusEnum = exports.MediaShareCommandsEnum = exports.MediaShareTypesEnum = exports.FilterEnum = exports.QueryInEnum = exports.RumbleTypeEnum = exports.PlatformsWithVideosEnum = exports.UserMediaSharePermissionsEnum = exports.ClipperCategoryEnum = exports.PlatformEnum = exports.OverridesEnum = exports.GuildSingleMessageTypeEnum = exports.GuildMessageTypeEnum = exports.StreamerMessageTypeEnum = exports.SingleMessageTypeEnum = exports.LeaderBoardTypesEnum = void 0;
+exports.GameRobloxKindEnum = exports.GameDeliveryEnum = exports.GameFlagEnum = exports.GameKindEnum = exports.GameStoreEnum = exports.UserNotificationSeverityEnum = exports.RoleBonusEnum = exports.MediaShareCommandsEnum = exports.MediaShareTypesEnum = exports.FilterEnum = exports.QueryInEnum = exports.RumbleTypeEnum = exports.PlatformsWithVideosEnum = exports.UserMediaSharePermissionsEnum = exports.ClipperCategoryEnum = exports.PlatformEnum = exports.OverridesEnum = exports.GuildSingleMessageTypeEnum = exports.GuildMessageTypeEnum = exports.StreamerMessageTypeEnum = exports.SingleMessageTypeEnum = exports.LeaderBoardTypesEnum = void 0;
 exports.deepPartialify = deepPartialify;
 const zod_1 = require("zod");
 function deepPartialify(schema) {
@@ -214,3 +214,8 @@ exports.GameDeliveryEnum = zod_1.z.enum([
     'daily',
     'weekly',
 ]);
+exports.GameRobloxKindEnum = zod_1.z.enum([
+    'updates',
+    'events',
+    'both',
+]);