@theholocron/discord-client 1.47.1 → 1.49.0

package/README.md

@@ -101,8 +101,8 @@ the create response.
 
 | Resource             | Methods                                                                                                                                                                                                                                                                |
 | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `client.users`       | `me()` — `GET /users/@me`, a cheap token check; `get(id)` — a user's name                                                                                                                                                                                              |
-| `client.application` | `get`, `modify` (the bot's own application: description, tags, install settings, URLs)                                                                                                                                                                                 |
+| `client.users`       | `me()` — `GET /users/@me`, a cheap token check; `get(id)` — a user's name; `guilds({ limit, after })` — `GET /users/@me/guilds`, the servers the bot is in and whether it owns each (look here before retrying `guilds.create`)                                        |
+| `client.application` | `get`, `modify` (the bot's own application: description, tags, install settings, URLs, and `flags` for the privileged-intent toggles; `redirect_uris` can be read but not written, so add them in the developer portal)                                                |
 | `client.guilds`      | `get`, `modify`, `channels`, `createChannel`, `roles`, `createRole`, `modifyRole`, `create`, `delete`, `emojis`, `member`, `members`, `membersWithRole`, `addMemberRole`, `removeMemberRole`, `welcomeScreen`, `modifyWelcomeScreen`, `onboarding`, `modifyOnboarding` |
 | `client.channels`    | `modify`, `webhooks`, `createWebhook`, `createMessage`, `createInvite`, `messages`, `pin`, `deleteMessage`                                                                                                                                                             |
 | `client.webhooks`    | `modify` (name, avatar), `delete`                                                                                                                                                                                                                                      |

package/dist/index.d.mts

@@ -45,6 +45,21 @@ interface DiscordUser {
   username: string;
   bot?: boolean;
 }
+/** A server as `GET /users/@me/guilds` lists it: a summary, not the full guild. */
+interface DiscordUserGuild {
+  id: string;
+  name: string;
+  /** Whether the caller (here, the bot) owns the server. */
+  owner: boolean;
+  /** The caller's permission bitfield in the server, as a decimal string. */
+  permissions?: string;
+}
+/** Page options for `users.guilds`; Discord allows a `limit` of 1–200; values outside that are clamped. */
+interface ListUserGuildsInput {
+  limit?: number;
+  /** Return servers after this server id. */
+  after?: string;
+}
 /** Guild fields `guilds.modify` can change; the numeric enums are Discord's own. */
 interface DiscordGuild {
   id: string;
@@ -238,6 +253,18 @@ interface DiscordInstallParams {
   /** Permission bitfield the default install link asks for, as a string. */
   permissions: string;
 }
+/**
+ * Bits of the application's `flags`. The `*Limited` ones are the portal's privileged-intent toggles for an app
+ * that Discord has not verified; once verified, the plain ones take over and the toggle is Discord's to change.
+ */
+declare const ApplicationFlag: {
+  readonly GatewayPresence: number;
+  readonly GatewayPresenceLimited: number;
+  readonly GatewayGuildMembers: number;
+  readonly GatewayGuildMembersLimited: number;
+  readonly GatewayMessageContent: number;
+  readonly GatewayMessageContentLimited: number;
+};
 /** The bot's own application, as `GET /applications/@me` returns it. Fields Discord leaves out are absent or null. */
 interface DiscordApplication {
   id: string;
@@ -257,6 +284,11 @@ interface DiscordApplication {
   bot_public?: boolean;
   bot_require_code_grant?: boolean;
   flags?: number;
+  /**
+   * The OAuth2 redirect URIs registered on the application. Read-only here: Discord accepts a write to this
+   * field and silently ignores it, so add them in the developer portal (OAuth2 → Redirects).
+   */
+  redirect_uris?: string[];
 }
 /** What `PATCH /applications/@me` takes; a field left out is left alone, and `null` clears the ones that can be cleared. */
 interface ModifyApplicationInput {
@@ -268,6 +300,11 @@ interface ModifyApplicationInput {
   terms_of_service_url?: string | null;
   privacy_policy_url?: string | null;
   interactions_endpoint_url?: string | null;
+  /**
+   * The whole flags value. Discord keeps only the bits an app may change (the `*Limited` privileged-intent
+   * toggles among them), so read `flags` first and send it back with your bit set or cleared.
+   */
+  flags?: number;
 }
 interface ModifyWebhookInput {
   name?: string;
@@ -337,10 +374,15 @@ declare function createDiscordBotClient(opts: DiscordBotClientOptions): {
     me: () => Promise<DiscordUser>;
     /** `GET /users/:id` — a user's name, for reports that would otherwise show a bare id. */
     get: (userId: string) => Promise<DiscordUser>;
+    /**
+     * `GET /users/@me/guilds` — one page of the servers the bot is in, each with whether it owns it. This is
+     * how a retry finds a server `guilds.create` already made, since that call is not idempotent.
+     */
+    guilds: (opts?: ListUserGuildsInput) => Promise<DiscordUserGuild[]>;
   };
   guilds: {
     get: (guildId: string) => Promise<DiscordGuild>;
-    /** `POST /guilds` — a new server the bot owns. Not idempotent: look one up by name before retrying. */
+    /** `POST /guilds` — a new server the bot owns. Not idempotent: look one up by name (`users.guilds`) before retrying. */
     create: (body: CreateGuildInput) => Promise<DiscordGuild>;
     /** `DELETE /guilds/:id` — only the owner may; a 404 counts as done. */
     delete: (guildId: string) => Promise<void>;
@@ -589,4 +631,4 @@ declare function createDiscordClient(opts?: DiscordClientOptions): {
 };
 type DiscordClient = ReturnType<typeof createDiscordClient>;
 //#endregion
-export { ChannelType, CreateChannelInput, CreateGuildInput, CreateInviteInput, CreateMessageInput, CreateRoleInput, DEFAULT_STATE_TTL_SECONDS, DiscordApplication, DiscordBotClient, DiscordBotClientOptions, DiscordChannel, DiscordChannelMessage, DiscordChannelWebhook, DiscordClient, type DiscordClientOptions, DiscordConnection, DiscordEmoji, DiscordGuild, DiscordGuildMember, DiscordInstallParams, DiscordInvite, DiscordMessage, DiscordOAuthClient, DiscordOAuthClientOptions, DiscordOAuthScope, DiscordOAuthToken, DiscordOAuthUser, DiscordOnboarding, DiscordOnboardingOption, DiscordOnboardingPrompt, DiscordPermissionOverwrite, DiscordRole, DiscordUser, type DiscordWebhookInfo, DiscordWelcomeChannel, DiscordWelcomeScreen, ListMembersInput, ModifyApplicationInput, ModifyChannelInput, ModifyGuildInput, ModifyRoleInput, ModifyWebhookInput, ModifyWelcomeScreenInput, Permission, PermissionName, createDiscordBotClient, createDiscordClient, createDiscordOAuthClient, findVerifiedConnection, parseWebhookUrl, permissionNames, permissions, signOAuthState, verifyOAuthState };
+export { ApplicationFlag, ChannelType, CreateChannelInput, CreateGuildInput, CreateInviteInput, CreateMessageInput, CreateRoleInput, DEFAULT_STATE_TTL_SECONDS, DiscordApplication, DiscordBotClient, DiscordBotClientOptions, DiscordChannel, DiscordChannelMessage, DiscordChannelWebhook, DiscordClient, type DiscordClientOptions, DiscordConnection, DiscordEmoji, DiscordGuild, DiscordGuildMember, DiscordInstallParams, DiscordInvite, DiscordMessage, DiscordOAuthClient, DiscordOAuthClientOptions, DiscordOAuthScope, DiscordOAuthToken, DiscordOAuthUser, DiscordOnboarding, DiscordOnboardingOption, DiscordOnboardingPrompt, DiscordPermissionOverwrite, DiscordRole, DiscordUser, DiscordUserGuild, type DiscordWebhookInfo, DiscordWelcomeChannel, DiscordWelcomeScreen, ListMembersInput, ListUserGuildsInput, ModifyApplicationInput, ModifyChannelInput, ModifyGuildInput, ModifyRoleInput, ModifyWebhookInput, ModifyWelcomeScreenInput, Permission, PermissionName, createDiscordBotClient, createDiscordClient, createDiscordOAuthClient, findVerifiedConnection, parseWebhookUrl, permissionNames, permissions, signOAuthState, verifyOAuthState };

package/dist/index.mjs

@@ -158,11 +158,20 @@ function createDiscordBotClient(opts) {
 			/** `GET /users/@me` — the bot's own user; a cheap token check. */
 			me: () => rest.request("/users/@me"),
 			/** `GET /users/:id` — a user's name, for reports that would otherwise show a bare id. */
-			get: (userId) => rest.request(`/users/${id(userId)}`)
+			get: (userId) => rest.request(`/users/${id(userId)}`),
+			/**
+			* `GET /users/@me/guilds` — one page of the servers the bot is in, each with whether it owns it. This is
+			* how a retry finds a server `guilds.create` already made, since that call is not idempotent.
+			*/
+			guilds: (opts = {}) => {
+				const query = { limit: String(Math.min(Math.max(opts.limit ?? 200, 1), 200)) };
+				if (opts.after !== void 0) query.after = id(opts.after);
+				return rest.request("/users/@me/guilds", { query });
+			}
 		},
 		guilds: {
 			get: (guildId) => rest.request(`/guilds/${id(guildId)}`),
-			/** `POST /guilds` — a new server the bot owns. Not idempotent: look one up by name before retrying. */
+			/** `POST /guilds` — a new server the bot owns. Not idempotent: look one up by name (`users.guilds`) before retrying. */
 			create: (body) => rest.request("/guilds", {
 				method: "POST",
 				body
@@ -343,6 +352,18 @@ const ChannelType = {
 	Announcement: 5,
 	Forum: 15
 };
+/**
+* Bits of the application's `flags`. The `*Limited` ones are the portal's privileged-intent toggles for an app
+* that Discord has not verified; once verified, the plain ones take over and the toggle is Discord's to change.
+*/
+const ApplicationFlag = {
+	GatewayPresence: 4096,
+	GatewayPresenceLimited: 8192,
+	GatewayGuildMembers: 16384,
+	GatewayGuildMembersLimited: 32768,
+	GatewayMessageContent: 1 << 18,
+	GatewayMessageContentLimited: 1 << 19
+};
 //#endregion
 //#region ../../../../../src/bot/permissions.ts
 /**
@@ -550,4 +571,4 @@ function createDiscordClient(opts = {}) {
 	return { webhooks: webhooks(opts.baseUrl ?? "https://discord.com/api/v10", opts.fetch ?? globalThis.fetch) };
 }
 //#endregion
-export { ChannelType, DEFAULT_STATE_TTL_SECONDS, Permission, createDiscordBotClient, createDiscordClient, createDiscordOAuthClient, findVerifiedConnection, parseWebhookUrl, permissionNames, permissions, signOAuthState, verifyOAuthState };
+export { ApplicationFlag, ChannelType, DEFAULT_STATE_TTL_SECONDS, Permission, createDiscordBotClient, createDiscordClient, createDiscordOAuthClient, findVerifiedConnection, parseWebhookUrl, permissionNames, permissions, signOAuthState, verifyOAuthState };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/discord-client",
-  "version": "1.47.1",
+  "version": "1.49.0",
   "description": "A TypeScript client for the Discord webhooks API",
   "keywords": [
     "discord",
@@ -32,7 +32,7 @@
     "dist"
   ],
   "dependencies": {
-    "@theholocron/http-client": "^1.47.1"
+    "@theholocron/http-client": "^1.49.0"
   },
   "devDependencies": {
     "@theholocron/cli": "5.0.0-alpha.79",