fix(builders): add proper snowflake validation

[rie03p]

close #11289

Please describe the changes this PR makes and why it should be merged:

This PR adds proper Snowflake validation to the builders package. Previously, multiple instances were using plain z.string() for Snowflake IDs, which didn't validate that the values are numeric strings as required by Discord's Snowflake format.

Changes:

• Added snowflakePredicate (z.string().regex(/^\d{17,20}$/)) to validate Snowflake format
• Replaced z.string() with snowflakePredicate in:
  • emojiPredicate.id
  • buttonPremiumPredicate.sku_id
  • default_values.id for channel, mentionable, role, and user select menu predicates

Status and versioning classification:

• Code changes have been tested against the Discord API, or there are no code changes
• I know how to update typings and have done so, or typings don't need updating

[vercel]

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

2 Skipped Deployments

Project	Deployment	Preview	Comments	Updated (UTC)
discord-js	Skipped			Nov 30, 2025 3:25pm
discord-js-guide	Skipped			Nov 30, 2025 3:25pm

[Jiralite]

I believe this should accept a snowflake too:

discord.js/packages/builders/src/messages/Assertions.ts

Line 18 in c5a6e5e

id: z.union([z.string(), z.number()]),

discord.js/packages/builders/src/messages/Attachment.ts

Line 42 in c5a6e5e

public setId(id: Snowflake | number): this {

[Jiralite]

@rie03p looks like something is not quite right because tests are failing, may need to update them?

[rie03p]

@Jiralite You're right! The validation is now working correctly and rejecting invalid IDs like 'hi!' and '0'. I've updated the existing tests to use valid IDs (numbers or proper snowflakes) so they pass with the new validation.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 43.62%. Comparing base (19253f6) to head (1ece993).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #11290      +/-   ##
==========================================
+ Coverage   43.61%   43.62%   +0.01%     
==========================================
  Files         375      375              
  Lines       19338    19340       +2     
  Branches     1880     1880              
==========================================
+ Hits         8434     8437       +3     
+ Misses      10891    10890       -1     
  Partials       13       13              

Flag	Coverage Δ
builders	81.19% <100.00%> (+0.04%)	⬆️

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.

Resolved.

[rie03p]

I’ve fixed the tests that were failing.

[vladfrangu]

0 is perfectly valid in a snowflake, and could increase the limit too

Resolved