Skip to content

feat(structures): add guild and related structures#11394

Open
keston-dev wants to merge 16 commits intodiscordjs:mainfrom
keston-dev:feat/guild-structure
Open

feat(structures): add guild and related structures#11394
keston-dev wants to merge 16 commits intodiscordjs:mainfrom
keston-dev:feat/guild-structure

Conversation

@keston-dev
Copy link

This will add all Guild-related API structures.

As of this first post, only the Guild structure, and its necessary substructures, GuildWelcomeScreen and GuildIncidentsData have been created.

Mentioning #10981 for visibility.

@vercel
Copy link

vercel bot commented Jan 23, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

2 Skipped Deployments
Project Deployment Actions Updated (UTC)
discord-js Skipped Skipped Feb 5, 2026 4:51pm
discord-js-guide Skipped Skipped Feb 5, 2026 4:51pm

Request Review

@vercel vercel bot temporarily deployed to Preview – discord-js January 23, 2026 15:25 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js-guide January 23, 2026 15:25 Inactive
@keston-dev keston-dev changed the title Feat/guild structure feat(structures): add guild structure Jan 23, 2026
@vercel vercel bot temporarily deployed to Preview – discord-js-guide January 23, 2026 19:07 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js January 23, 2026 19:07 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js January 23, 2026 19:13 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js-guide January 23, 2026 19:13 Inactive
@keston-dev keston-dev changed the title feat(structures): add guild structure feat(structures): add guild and related structures Jan 23, 2026
@vercel vercel bot temporarily deployed to Preview – discord-js January 24, 2026 03:53 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js-guide January 24, 2026 03:53 Inactive
@keston-dev
Copy link
Author

keston-dev commented Jan 24, 2026

To add a quick progress update (based on #10981):

  • Guild:
    • Guild
    • Guild Preview
    • Guild Widget
    • Guild Member
    • Integration
    • Guild Ban
    • Member screening (undocumented)
  • Guild Scheduled Events (As of 6bf4888)
  • Guild Template (As of 6bf4888)

@vercel vercel bot temporarily deployed to Preview – discord-js January 24, 2026 05:44 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js-guide January 24, 2026 05:44 Inactive
@keston-dev keston-dev marked this pull request as ready for review January 24, 2026 21:49
@keston-dev keston-dev requested a review from a team as a code owner January 24, 2026 21:49
@vercel vercel bot temporarily deployed to Preview – discord-js January 24, 2026 22:33 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js January 24, 2026 22:36 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js-guide January 24, 2026 22:36 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js-guide January 24, 2026 23:49 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js January 24, 2026 23:49 Inactive
@keston-dev keston-dev marked this pull request as ready for review January 25, 2026 02:44
@github-project-automation github-project-automation bot moved this from Todo to Review in Progress in discord.js Jan 25, 2026
@vercel vercel bot temporarily deployed to Preview – discord-js-guide January 25, 2026 19:05 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js January 25, 2026 19:05 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js-guide January 30, 2026 01:11 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js January 30, 2026 01:11 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js January 30, 2026 01:14 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js-guide January 30, 2026 01:14 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js January 30, 2026 01:19 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js-guide January 30, 2026 01:19 Inactive
@codecov
Copy link

codecov bot commented Jan 30, 2026

Codecov Report

❌ Patch coverage is 2.81426% with 518 lines in your changes missing coverage. Please review.
✅ Project coverage is 30.55%. Comparing base (c71228a) to head (e682914).

Files with missing lines Patch % Lines
packages/structures/src/guild/Guild.ts 0.00% 103 Missing ⚠️
packages/structures/src/guild/GuildMember.ts 0.00% 65 Missing ⚠️
...s/src/guild/scheduled-event/GuildScheduledEvent.ts 0.00% 63 Missing ⚠️
packages/structures/src/guild/IncidentsData.ts 0.00% 56 Missing ⚠️
packages/structures/src/guild/GuildIntegration.ts 0.00% 47 Missing ⚠️
packages/structures/src/guild/GuildTemplate.ts 0.00% 46 Missing ⚠️
...heduled-event/GuildScheduledEventRecurrenceRule.ts 0.00% 46 Missing ⚠️
packages/structures/src/guild/GuildPreview.ts 0.00% 30 Missing ⚠️
packages/structures/src/guild/GuildWidget.ts 0.00% 16 Missing ⚠️
.../structures/src/guild/GuildWelcomeScreenChannel.ts 0.00% 11 Missing ⚠️
... and 7 more
Additional details and impacted files
@@            Coverage Diff             @@
##             main   #11394      +/-   ##
==========================================
- Coverage   31.62%   30.55%   -1.07%     
==========================================
  Files         385      402      +17     
  Lines       13918    14451     +533     
  Branches     1096     1163      +67     
==========================================
+ Hits         4401     4416      +15     
- Misses       9383     9901     +518     
  Partials      134      134              
Flag Coverage Δ
structures 26.73% <2.81%> (-8.94%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@vercel vercel bot temporarily deployed to Preview – discord-js February 5, 2026 16:51 Inactive
@vercel vercel bot temporarily deployed to Preview – discord-js-guide February 5, 2026 16:51 Inactive
@keston-dev keston-dev requested a review from Qjuh February 13, 2026 23:03
Copy link
Member

@Qjuh Qjuh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also still blocked until we make a definite decision about exposing arrays of primitive data types as getters as well as the proposed change to use createdDate naming conventions instead of the current createdAt (and any similar getters) to make the distinction of the returned data type more explicit.

: null;
}

public get permissions() {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing JSDoc and this doesn't even use the correct symbol field. The one this uses will always be undefined because of DataTemplate omitting it.

*
* @typeParam Omitted - Specify the properties that will not be stored in the raw data field as a union, implement via `DataTemplate`
* @remarks Intentionally does not export `channels`, or `members`,
* so extending classes can map each array to `GuildWidgetChannel[]`, and `GuildWidgetMember[]` respectively.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are no such structures by that name. They would just be (partial) Channel and GuildMember structures, right?

/**
* The time the guild scheduled event will start at.
*/
public get scheduledStartAt() {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
public get scheduledStartAt() {
public get scheduledStartDate() {

Just as a blocker to not get merged before changed everywhere

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Review in Progress

Development

Successfully merging this pull request may close these issues.

3 participants