yuzucchii/discord.zig
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

finally finished

Browse Source
This commit is contained in:
Yuzu 2025-04-11 22:21:20 -05:00
parent b56b7062cf
commit f57bbdcf5d
33 changed files with 6045 additions and 5752 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
src/internal.zig
View File

@ -355,6 +355,6 @@ pub fn GatewayDispatchEvent(comptime T: type) type {
ready: ?*const fn (save: T, data: Types.Ready) anyerror!void = undefined,
// TODO: implement // resumed: null = null,
any: ?*const fn (save: T, data: []const u8) anyerror!void = undefined,
any: ?*const fn (save: T, data: std.json.Value) anyerror!void = undefined,
};
}

30
src/json-helper.zig
View File

@ -48,6 +48,7 @@ pub fn AssociativeArray(comptime E: type, comptime V: type) type {
var map: std.EnumMap(E, V) = .{};
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x100
});
@ -60,7 +61,10 @@ pub fn AssociativeArray(comptime E: type, comptime V: type) type {
// eg: enum(u8) would be @"enum".tag_type where tag_type is a u8
const int = std.fmt.parseInt(@typeInfo(E).@"enum".tag_type, k, 10) catch unreachable;
const val = try std.json.parseFromValueLeaky(V, allocator, v, .{.max_value_len = 0x100});
const val = try std.json.parseFromValueLeaky(V, allocator, v, .{
.ignore_unknown_fields = true,
.max_value_len = 0x100,
});
map.put(@enumFromInt(int), val);
}
@ -93,6 +97,7 @@ pub fn DiscriminatedUnion(comptime U: type, comptime key: []const u8) type {
// and should have a key "type" or whichever key might be
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x100
});
@ -107,7 +112,10 @@ pub fn DiscriminatedUnion(comptime U: type, comptime key: []const u8) type {
if (field.value == tag) {
const T = comptime std.meta.fields(U)[field.value].type;
comptime std.debug.assert(@hasField(T, key));
u = @unionInit(U, field.name, try std.json.innerParse(T, allocator, src, .{.max_value_len = 0x100}));
u = @unionInit(U, field.name, try std.json.innerParse(T, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x100,
}));
}
}
@ -122,6 +130,7 @@ pub fn Record(comptime T: type) type {
map: std.StringHashMapUnmanaged(T),
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x100
});
@ -137,7 +146,10 @@ pub fn Record(comptime T: type) type {
// might leak because std.json is retarded
// errdefer allocator.free(k);
// errdefer v.deinit(allocator);
try map.put(allocator, k, try std.json.parseFromValue(T, allocator, v, .{ .max_value_len =0x100}));
try map.put(allocator, k, try std.json.parseFromValue(T, allocator, v, .{
.ignore_unknown_fields = true,
.max_value_len = 0x100,
}));
}
return .{ .map = map };
@ -216,10 +228,14 @@ pub fn parseRight(comptime L: type, comptime R: type, child_allocator: std.mem.A
owned.arena.* = .init(child_allocator);
const allocator = owned.arena.allocator();
const value = try json.parseFromSliceLeaky(json.Value, allocator, data, .{
.ignore_unknown_fields = true,
.max_value_len = 0x100,
});
owned.value = .{ .right = try json.parseFromValueLeaky(R, allocator, value, .{.max_value_len = 0x100}) };
owned.value = .{ .right = try json.parseFromValueLeaky(R, allocator, value, .{
.ignore_unknown_fields = true,
.max_value_len = 0x100,
}) };
errdefer owned.arena.deinit();
return owned;
@ -235,10 +251,14 @@ pub fn parseLeft(comptime L: type, comptime R: type, child_allocator: std.mem.Al
owned.arena.* = .init(child_allocator);
const allocator = owned.arena.allocator();
const value = try json.parseFromSliceLeaky(json.Value, allocator, data, .{
.ignore_unknown_fields = true,
.max_value_len = 0x100,
});
owned.value = .{ .left = try json.parseFromValueLeaky(L, allocator, value, .{.max_value_len = 0x100}) };
owned.value = .{ .left = try json.parseFromValueLeaky(L, allocator, value, .{
.ignore_unknown_fields = true,
.max_value_len = 0x100,
}) };
errdefer owned.arena.deinit();
return owned;

308
src/shard.zig
View File

@ -43,7 +43,6 @@ const Bucket = @import("internal.zig").Bucket;
const default_identify_properties = @import("internal.zig").default_identify_properties;
const Types = @import("./structures/types.zig");
const GatewayPayload = Types.GatewayPayload;
const Opcode = Types.GatewayOpcodes;
const Intents = Types.Intents;
@ -200,7 +199,7 @@ inline fn _connect_ws(allocator: mem.Allocator, url: []const u8) !ws.Client {
.host = url,
});
var buf: [0x100]u8 = undefined;
var buf: [0x1000]u8 = undefined;
const host = try std.fmt.bufPrint(&buf, "host: {s}", .{url});
conn.handshake("/?v=10&encoding=json&compress=zlib-stream", .{
@ -234,28 +233,41 @@ fn readMessage(self: *Self, _: anytype) !void {
const decompressed = try self.inflator.decompressAllAlloc(buf);
defer self.allocator.free(decompressed);
// we use std.json here because I believe it'll perform better
const raw = try std.json.parseFromSlice(struct {
// std.debug.print("Decompressed: {s}\n", .{decompressed});
std.debug.assert(std.json.validate(self.allocator, decompressed) catch
@panic("Invalid JSON"));
// for some reason std.json breaks when you use a generic
const GatewayPayloadType = struct{
/// opcode for the payload
op: isize,
d: std.json.Value,
s: ?i64,
t: ?[]const u8,
}, self.allocator, decompressed, .{});
defer raw.deinit();
/// Event data
d: ?std.json.Value = null,
/// Sequence isize, used for resuming sessions and heartbeats
s: ?isize = null,
/// The event name for this payload
t: ?[]const u8 = null,
};
const raw = try std.json.parseFromSlice(GatewayPayloadType, self.allocator, decompressed, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
errdefer raw.deinit();
const payload = raw.value;
switch (@as(Opcode, @enumFromInt(payload.op))) {
.Dispatch => {
// maybe use threads and call it instead from there
if (payload.t) |name| {
self.sequence.store(payload.s orelse 0, .monotonic);
try self.handleEvent(name, decompressed);
try self.handleEvent(name, payload.d.?);
}
},
.Hello => {
const HelloPayload = struct { heartbeat_interval: u64, _trace: [][]const u8 };
const parsed = try std.json.parseFromValue(HelloPayload, self.allocator, payload.d, .{});
const parsed = try std.json.parseFromValue(HelloPayload, self.allocator, payload.d.?, .{});
defer parsed.deinit();
const helloPayload = parsed.value;
@ -300,7 +312,7 @@ fn readMessage(self: *Self, _: anytype) !void {
session_id: []const u8,
seq: ?isize,
};
const parsed = try std.json.parseFromValue(WithSequence, self.allocator, payload.d, .{});
const parsed = try std.json.parseFromValue(WithSequence, self.allocator, payload.d.?, .{});
defer parsed.deinit();
const resume_payload = parsed.value;
@ -396,398 +408,402 @@ pub fn send(self: *Self, _: bool, data: anytype) SendError!void {
try self.client.write(try string.toOwnedSlice());
}
pub fn handleEvent(self: *Self, name: []const u8, payload: []const u8) !void {
pub fn handleEvent(self: *Self, name: []const u8, payload: json.Value) !void {
if (mem.eql(u8, name, "READY")) if (self.handler.ready) |event| {
const ready = try json.parseFromSlice(GatewayPayload(Types.Ready), self.allocator, payload, .{.max_value_len=0x100});
const ready = try json.parseFromValue(Types.Ready, self.allocator, payload, .{
.ignore_unknown_fields=true,
.max_value_len=0x1000,
});
try event(self, ready.value.d.?);
try event(self, ready.value);
};
if (mem.eql(u8, name, "APPLICATION_COMMAND_PERMISSIONS_UPDATE")) if (self.handler.application_command_permissions_update) |event| {
const acp = try json.parseFromSlice(GatewayPayload(Types.ApplicationCommandPermissions), self.allocator, payload, .{.max_value_len=0x100});
const acp = try json.parseFromValue(Types.ApplicationCommandPermissions, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, acp.value.d.?);
try event(self, acp.value);
};
if (mem.eql(u8, name, "CHANNEL_CREATE")) if (self.handler.channel_create) |event| {
const chan = try json.parseFromSlice(GatewayPayload(Types.Channel), self.allocator, payload, .{.max_value_len=0x100});
const chan = try json.parseFromValue(Types.Channel, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, chan.value.d.?);
try event(self, chan.value);
};
if (mem.eql(u8, name, "CHANNEL_UPDATE")) if (self.handler.channel_update) |event| {
const chan = try json.parseFromSlice(GatewayPayload(Types.Channel), self.allocator, payload, .{.max_value_len=0x100});
const chan = try json.parseFromValue(Types.Channel, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, chan.value.d.?);
try event(self, chan.value);
};
if (mem.eql(u8, name, "CHANNEL_DELETE")) if (self.handler.channel_delete) |event| {
const chan = try json.parseFromSlice(GatewayPayload(Types.Channel), self.allocator, payload, .{.max_value_len=0x100});
const chan = try json.parseFromValue(Types.Channel, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, chan.value.d.?);
try event(self, chan.value);
};
if (mem.eql(u8, name, "CHANNEL_PINS_UPDATE")) if (self.handler.channel_pins_update) |event| {
const chan_pins_update = try json.parseFromSlice(GatewayPayload(Types.ChannelPinsUpdate), self.allocator, payload, .{.max_value_len=0x100});
const chan_pins_update = try json.parseFromValue(Types.ChannelPinsUpdate, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, chan_pins_update.value.d.?);
try event(self, chan_pins_update.value);
};
if (mem.eql(u8, name, "ENTITLEMENT_CREATE")) if (self.handler.entitlement_create) |event| {
const entitlement = try json.parseFromSlice(GatewayPayload(Types.Entitlement), self.allocator, payload, .{.max_value_len=0x100});
const entitlement = try json.parseFromValue(Types.Entitlement, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, entitlement.value.d.?);
try event(self, entitlement.value);
};
if (mem.eql(u8, name, "ENTITLEMENT_UPDATE")) if (self.handler.entitlement_update) |event| {
const entitlement = try json.parseFromSlice(GatewayPayload(Types.Entitlement), self.allocator, payload, .{.max_value_len=0x100});
const entitlement = try json.parseFromValue(Types.Entitlement, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, entitlement.value.d.?);
try event(self, entitlement.value);
};
if (mem.eql(u8, name, "ENTITLEMENT_DELETE")) if (self.handler.entitlement_delete) |event| {
const entitlement = try json.parseFromSlice(GatewayPayload(Types.Entitlement), self.allocator, payload, .{.max_value_len=0x100});
const entitlement = try json.parseFromValue(Types.Entitlement, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, entitlement.value.d.?);
try event(self, entitlement.value);
};
if (mem.eql(u8, name, "INTEGRATION_CREATE")) if (self.handler.integration_create) |event| {
const guild_id = try json.parseFromSlice(GatewayPayload(Types.IntegrationCreateUpdate), self.allocator, payload, .{.max_value_len=0x100});
const guild_id = try json.parseFromValue(Types.IntegrationCreateUpdate, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, guild_id.value.d.?);
try event(self, guild_id.value);
};
if (mem.eql(u8, name, "INTEGRATION_UPDATE")) if (self.handler.integration_update) |event| {
const guild_id = try json.parseFromSlice(GatewayPayload(Types.IntegrationCreateUpdate), self.allocator, payload, .{.max_value_len=0x100});
const guild_id = try json.parseFromValue(Types.IntegrationCreateUpdate, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, guild_id.value.d.?);
try event(self, guild_id.value);
};
if (mem.eql(u8, name, "INTEGRATION_DELETE")) if (self.handler.integration_delete) |event| {
const data = try json.parseFromSlice(GatewayPayload(Types.IntegrationDelete), self.allocator, payload, .{.max_value_len=0x100});
const data = try json.parseFromValue(Types.IntegrationDelete, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, data.value.d.?);
try event(self, data.value);
};
if (mem.eql(u8, name, "INTERACTION_CREATE")) if (self.handler.interaction_create) |event| {
const interaction = try json.parseFromSlice(GatewayPayload(Types.MessageInteraction), self.allocator, payload, .{.max_value_len=0x100});
const interaction = try json.parseFromValue(Types.MessageInteraction, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, interaction.value.d.?);
try event(self, interaction.value);
};
if (mem.eql(u8, name, "INVITE_CREATE")) if (self.handler.invite_create) |event| {
const data = try json.parseFromSlice(GatewayPayload(Types.InviteCreate), self.allocator, payload, .{.max_value_len=0x100});
const data = try json.parseFromValue(Types.InviteCreate, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, data.value.d.?);
try event(self, data.value);
};
if (mem.eql(u8, name, "INVITE_DELETE")) if (self.handler.invite_delete) |event| {
const data = try json.parseFromSlice(GatewayPayload(Types.InviteDelete), self.allocator, payload, .{.max_value_len=0x100});
const data = try json.parseFromValue(Types.InviteDelete, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, data.value.d.?);
try event(self, data.value);
};
if (mem.eql(u8, name, "MESSAGE_CREATE")) if (self.handler.message_create) |event| {
const message = try json.parseFromSlice(GatewayPayload(Types.Message), self.allocator, payload, .{.max_value_len=0x100});
const message = try json.parseFromValue(Types.Message, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, message.value.d.?);
try event(self, message.value);
};
if (mem.eql(u8, name, "MESSAGE_DELETE")) if (self.handler.message_delete) |event| {
const data = try json.parseFromSlice(GatewayPayload(Types.MessageDelete), self.allocator, payload, .{.max_value_len=0x100});
const data = try json.parseFromValue(Types.MessageDelete, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, data.value.d.?);
try event(self, data.value);
};
if (mem.eql(u8, name, "MESSAGE_UPDATE")) if (self.handler.message_update) |event| {
const message = try json.parseFromSlice(GatewayPayload(Types.Message), self.allocator, payload, .{.max_value_len=0x100});
const message = try json.parseFromValue(Types.Message, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, message.value.d.?);
try event(self, message.value);
};
if (mem.eql(u8, name, "MESSAGE_DELETE_BULK")) if (self.handler.message_delete_bulk) |event| {
const data = try json.parseFromSlice(GatewayPayload(Types.MessageDeleteBulk), self.allocator, payload, .{.max_value_len=0x100});
const data = try json.parseFromValue(Types.MessageDeleteBulk, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, data.value.d.?);
try event(self, data.value);
};
if (mem.eql(u8, name, "MESSAGE_REACTION_ADD")) if (self.handler.message_reaction_add) |event| {
const reaction = try json.parseFromSlice(GatewayPayload(Types.MessageReactionAdd), self.allocator, payload, .{.max_value_len=0x100});
const reaction = try json.parseFromValue(Types.MessageReactionAdd, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, reaction.value.d.?);
try event(self, reaction.value);
};
if (mem.eql(u8, name, "MESSAGE_REACTION_REMOVE")) if (self.handler.message_reaction_remove) |event| {
const reaction = try json.parseFromSlice(GatewayPayload(Types.MessageReactionRemove), self.allocator, payload, .{.max_value_len=0x100});
const reaction = try json.parseFromValue(Types.MessageReactionRemove, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, reaction.value.d.?);
try event(self, reaction.value);
};
if (mem.eql(u8, name, "MESSAGE_REACTION_REMOVE_ALL")) if (self.handler.message_reaction_remove_all) |event| {
const data = try json.parseFromSlice(GatewayPayload(Types.MessageReactionRemoveAll), self.allocator, payload, .{.max_value_len=0x100});
const data = try json.parseFromValue(Types.MessageReactionRemoveAll, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, data.value.d.?);
try event(self, data.value);
};
if (mem.eql(u8, name, "MESSAGE_REACTION_REMOVE_EMOJI")) if (self.handler.message_reaction_remove_emoji) |event| {
const emoji = try json.parseFromSlice(GatewayPayload(Types.MessageReactionRemoveEmoji), self.allocator, payload, .{.max_value_len=0x100});
const emoji = try json.parseFromValue(Types.MessageReactionRemoveEmoji, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, emoji.value.d.?);
try event(self, emoji.value);
};
if (mem.eql(u8, name, "GUILD_CREATE")) {
const isAvailable =
try json.parseFromSlice(GatewayPayload(struct { unavailable: ?bool }), self.allocator, payload, .{.max_value_len=0x100});
try json.parseFromValue(struct { unavailable: ?bool }, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
if (isAvailable.value.d.?.unavailable == true) {
const guild = try json.parseFromSlice(GatewayPayload(Types.Guild), self.allocator, payload, .{.max_value_len=0x100});
if (isAvailable.value.unavailable == true) {
const guild = try json.parseFromValue(Types.Guild, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
if (self.handler.guild_create) |event| try event(self, guild.value.d.?);
if (self.handler.guild_create) |event| try event(self, guild.value);
return;
}
const guild = try json.parseFromSlice(GatewayPayload(Types.UnavailableGuild), self.allocator, payload, .{.max_value_len=0x100});
const guild = try json.parseFromValue(Types.UnavailableGuild, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
if (self.handler.guild_create_unavailable) |event| try event(self, guild.value.d.?);
if (self.handler.guild_create_unavailable) |event| try event(self, guild.value);
}
if (mem.eql(u8, name, "GUILD_UPDATE")) if (self.handler.guild_update) |event| {
const guild = try json.parseFromSlice(GatewayPayload(Types.Guild), self.allocator, payload, .{.max_value_len=0x100});
const guild = try json.parseFromValue(Types.Guild, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, guild.value.d.?);
try event(self, guild.value);
};
if (mem.eql(u8, name, "GUILD_DELETE")) if (self.handler.guild_delete) |event| {
const guild = try json.parseFromSlice(GatewayPayload(Types.UnavailableGuild), self.allocator, payload, .{.max_value_len=0x100});
const guild = try json.parseFromValue(Types.UnavailableGuild, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, guild.value.d.?);
try event(self, guild.value);
};
if (mem.eql(u8, name, "GUILD_SCHEDULED_EVENT_CREATE")) if (self.handler.guild_scheduled_event_create) |event| {
const s_event = try json.parseFromSlice(GatewayPayload(Types.ScheduledEvent), self.allocator, payload, .{.max_value_len=0x100});
const s_event = try json.parseFromValue(Types.ScheduledEvent, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, s_event.value.d.?);
try event(self, s_event.value);
};
if (mem.eql(u8, name, "GUILD_SCHEDULED_EVENT_UPDATE")) if (self.handler.guild_scheduled_event_update) |event| {
const s_event = try json.parseFromSlice(GatewayPayload(Types.ScheduledEvent), self.allocator, payload, .{.max_value_len=0x100});
const s_event = try json.parseFromValue(Types.ScheduledEvent, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, s_event.value.d.?);
try event(self, s_event.value);
};
if (mem.eql(u8, name, "GUILD_SCHEDULED_EVENT_DELETE")) if (self.handler.guild_scheduled_event_delete) |event| {
const s_event = try json.parseFromSlice(GatewayPayload(Types.ScheduledEvent), self.allocator, payload, .{.max_value_len=0x100});
const s_event = try json.parseFromValue(Types.ScheduledEvent, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, s_event.value.d.?);
try event(self, s_event.value);
};
if (mem.eql(u8, name, "GUILD_SCHEDULED_EVENT_USER_ADD")) if (self.handler.guild_scheduled_event_user_add) |event| {
const data = try json.parseFromSlice(GatewayPayload(Types.ScheduledEventUserAdd), self.allocator, payload, .{.max_value_len=0x100});
const data = try json.parseFromValue(Types.ScheduledEventUserAdd, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, data.value.d.?);
try event(self, data.value);
};
if (mem.eql(u8, name, "GUILD_SCHEDULED_EVENT_USER_REMOVE")) if (self.handler.guild_scheduled_event_user_remove) |event| {
const data = try json.parseFromSlice(GatewayPayload(Types.ScheduledEventUserRemove), self.allocator, payload, .{.max_value_len=0x100});
const data = try json.parseFromValue(Types.ScheduledEventUserRemove, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, data.value.d.?);
try event(self, data.value);
};
if (mem.eql(u8, name, "GUILD_MEMBER_ADD")) if (self.handler.guild_member_add) |event| {
const guild_id = try json.parseFromSlice(GatewayPayload(Types.GuildMemberAdd), self.allocator, payload, .{.max_value_len=0x100});
const guild_id = try json.parseFromValue(Types.GuildMemberAdd, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, guild_id.value.d.?);
try event(self, guild_id.value);
};
if (mem.eql(u8, name, "GUILD_MEMBER_UPDATE")) if (self.handler.guild_member_update) |event| {
const fields = try json.parseFromSlice(GatewayPayload(Types.GuildMemberUpdate), self.allocator, payload, .{.max_value_len=0x100});
const fields = try json.parseFromValue(Types.GuildMemberUpdate, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, fields.value.d.?);
try event(self, fields.value);
};
if (mem.eql(u8, name, "GUILD_MEMBER_REMOVE")) if (self.handler.guild_member_remove) |event| {
const user = try json.parseFromSlice(GatewayPayload(Types.GuildMemberRemove), self.allocator, payload, .{.max_value_len=0x100});
const user = try json.parseFromValue(Types.GuildMemberRemove, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, user.value.d.?);
try event(self, user.value);
};
if (mem.eql(u8, name, "GUILD_MEMBERS_CHUNK")) if (self.handler.guild_members_chunk) |event| {
const data = try json.parseFromSlice(GatewayPayload(Types.GuildMembersChunk), self.allocator, payload, .{.max_value_len=0x100});
const data = try json.parseFromValue(Types.GuildMembersChunk, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, data.value.d.?);
try event(self, data.value);
};
if (mem.eql(u8, name, "GUILD_ROLE_CREATE")) if (self.handler.guild_role_create) |event| {
const role = try json.parseFromSlice(GatewayPayload(Types.GuildRoleCreate), self.allocator, payload, .{.max_value_len=0x100});
const role = try json.parseFromValue(Types.GuildRoleCreate, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, role.value.d.?);
try event(self, role.value);
};
if (mem.eql(u8, name, "GUILD_ROLE_UPDATE")) if (self.handler.guild_role_update) |event| {
const role = try json.parseFromSlice(GatewayPayload(Types.GuildRoleUpdate), self.allocator, payload, .{.max_value_len=0x100});
const role = try json.parseFromValue(Types.GuildRoleUpdate, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, role.value.d.?);
try event(self, role.value);
};
if (mem.eql(u8, name, "GUILD_ROLE_DELETE")) if (self.handler.guild_role_delete) |event| {
const role_id = try json.parseFromSlice(GatewayPayload(Types.GuildRoleDelete), self.allocator, payload, .{.max_value_len=0x100});
const role_id = try json.parseFromValue(Types.GuildRoleDelete, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, role_id.value.d.?);
try event(self, role_id.value);
};
if (mem.eql(u8, name, "GUILD_DELETE")) if (self.handler.guild_delete) |event| {
const guild = try json.parseFromSlice(GatewayPayload(Types.UnavailableGuild), self.allocator, payload, .{.max_value_len=0x100});
const guild = try json.parseFromValue(Types.UnavailableGuild, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, guild.value.d.?);
try event(self, guild.value);
};
if (mem.eql(u8, name, "GUILD_BAN_ADD")) if (self.handler.guild_ban_add) |event| {
const gba = try json.parseFromSlice(GatewayPayload(Types.GuildBanAddRemove), self.allocator, payload, .{.max_value_len=0x100});
const gba = try json.parseFromValue(Types.GuildBanAddRemove, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, gba.value.d.?);
try event(self, gba.value);
};
if (mem.eql(u8, name, "GUILD_BAN_REMOVE")) if (self.handler.guild_ban_remove) |event| {
const gbr = try json.parseFromSlice(GatewayPayload(Types.GuildBanAddRemove), self.allocator, payload, .{.max_value_len=0x100});
const gbr = try json.parseFromValue(Types.GuildBanAddRemove, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, gbr.value.d.?);
try event(self, gbr.value);
};
if (mem.eql(u8, name, "GUILD_EMOJIS_UPDATE")) if (self.handler.guild_emojis_update) |event| {
const emojis = try json.parseFromSlice(GatewayPayload(Types.GuildEmojisUpdate), self.allocator, payload, .{.max_value_len=0x100});
const emojis = try json.parseFromValue(Types.GuildEmojisUpdate, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, emojis.value.d.?);
try event(self, emojis.value);
};
if (mem.eql(u8, name, "GUILD_STICKERS_UPDATE")) if (self.handler.guild_stickers_update) |event| {
const stickers = try json.parseFromSlice(GatewayPayload(Types.GuildStickersUpdate), self.allocator, payload, .{.max_value_len=0x100});
const stickers = try json.parseFromValue(Types.GuildStickersUpdate, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, stickers.value.d.?);
try event(self, stickers.value);
};
if (mem.eql(u8, name, "GUILD_INTEGRATIONS_UPDATE")) if (self.handler.guild_integrations_update) |event| {
const guild_id = try json.parseFromSlice(GatewayPayload(Types.GuildIntegrationsUpdate), self.allocator, payload, .{.max_value_len=0x100});
const guild_id = try json.parseFromValue(Types.GuildIntegrationsUpdate, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, guild_id.value.d.?);
try event(self, guild_id.value);
};
if (mem.eql(u8, name, "THREAD_CREATE")) if (self.handler.thread_create) |event| {
const thread = try json.parseFromSlice(GatewayPayload(Types.Channel), self.allocator, payload, .{.max_value_len=0x100});
const thread = try json.parseFromValue(Types.Channel, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, thread.value.d.?);
try event(self, thread.value);
};
if (mem.eql(u8, name, "THREAD_UPDATE")) if (self.handler.thread_update) |event| {
const thread = try json.parseFromSlice(GatewayPayload(Types.Channel), self.allocator, payload, .{.max_value_len=0x100});
const thread = try json.parseFromValue(Types.Channel, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, thread.value.d.?);
try event(self, thread.value);
};
if (mem.eql(u8, name, "THREAD_DELETE")) if (self.handler.thread_delete) |event| {
const thread_data = try json.parseFromSlice(GatewayPayload(Types.Partial(Types.Channel)), self.allocator, payload, .{.max_value_len=0x100});
const thread_data = try json.parseFromValue(Types.Partial(Types.Channel), self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, thread_data.value.d.?);
try event(self, thread_data.value);
};
if (mem.eql(u8, name, "THREAD_LIST_SYNC")) if (self.handler.thread_list_sync) |event| {
const data = try json.parseFromSlice(GatewayPayload(Types.ThreadListSync), self.allocator, payload, .{.max_value_len=0x100});
const data = try json.parseFromValue(Types.ThreadListSync, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, data.value.d.?);
try event(self, data.value);
};
if (mem.eql(u8, name, "THREAD_MEMBER_UPDATE")) if (self.handler.thread_member_update) |event| {
const guild_id = try json.parseFromSlice(GatewayPayload(Types.ThreadMemberUpdate), self.allocator, payload, .{.max_value_len=0x100});
const guild_id = try json.parseFromValue(Types.ThreadMemberUpdate, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, guild_id.value.d.?);
try event(self, guild_id.value);
};
if (mem.eql(u8, name, "THREAD_MEMBERS_UPDATE")) if (self.handler.thread_members_update) |event| {
const data = try json.parseFromSlice(GatewayPayload(Types.ThreadMembersUpdate), self.allocator, payload, .{.max_value_len=0x100});
const data = try json.parseFromValue(Types.ThreadMembersUpdate, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, data.value.d.?);
try event(self, data.value);
};
if (mem.eql(u8, name, "TYPING_START")) if (self.handler.typing_start) |event| {
const data = try json.parseFromSlice(GatewayPayload(Types.TypingStart), self.allocator, payload, .{.max_value_len=0x100});
const data = try json.parseFromValue(Types.TypingStart, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, data.value.d.?);
try event(self, data.value);
};
if (mem.eql(u8, name, "USER_UPDATE")) if (self.handler.user_update) |event| {
const user = try json.parseFromSlice(GatewayPayload(Types.User), self.allocator, payload, .{.max_value_len=0x100});
const user = try json.parseFromValue(Types.User, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, user.value.d.?);
try event(self, user.value);
};
if (mem.eql(u8, name, "PRESENCE_UPDATE")) if (self.handler.presence_update) |event| {
const pu = try json.parseFromSlice(GatewayPayload(Types.PresenceUpdate), self.allocator, payload, .{.max_value_len=0x100});
const pu = try json.parseFromValue(Types.PresenceUpdate, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, pu.value.d.?);
try event(self, pu.value);
};
if (mem.eql(u8, name, "MESSSAGE_POLL_VOTE_ADD")) if (self.handler.message_poll_vote_add) |event| {
const data = try json.parseFromSlice(GatewayPayload(Types.PollVoteAdd), self.allocator, payload, .{.max_value_len=0x100});
const data = try json.parseFromValue(Types.PollVoteAdd, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, data.value.d.?);
try event(self, data.value);
};
if (mem.eql(u8, name, "MESSSAGE_POLL_VOTE_REMOVE")) if (self.handler.message_poll_vote_remove) |event| {
const data = try json.parseFromSlice(GatewayPayload(Types.PollVoteRemove), self.allocator, payload, .{.max_value_len=0x100});
const data = try json.parseFromValue(Types.PollVoteRemove, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, data.value.d.?);
try event(self, data.value);
};
if (mem.eql(u8, name, "WEBHOOKS_UPDATE")) if (self.handler.webhooks_update) |event| {
const fields = try json.parseFromSlice(GatewayPayload(Types.WebhookUpdate), self.allocator, payload, .{.max_value_len=0x100});
const fields = try json.parseFromValue(Types.WebhookUpdate, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, fields.value.d.?);
try event(self, fields.value);
};
if (mem.eql(u8, name, "STAGE_INSTANCE_CREATE")) if (self.handler.stage_instance_create) |event| {
const stage = try json.parseFromSlice(GatewayPayload(Types.StageInstance), self.allocator, payload, .{.max_value_len=0x100});
const stage = try json.parseFromValue(Types.StageInstance, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, stage.value.d.?);
try event(self, stage.value);
};
if (mem.eql(u8, name, "STAGE_INSTANCE_UPDATE")) if (self.handler.stage_instance_update) |event| {
const stage = try json.parseFromSlice(GatewayPayload(Types.StageInstance), self.allocator, payload, .{.max_value_len=0x100});
const stage = try json.parseFromValue(Types.StageInstance, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, stage.value.d.?);
try event(self, stage.value);
};
if (mem.eql(u8, name, "STAGE_INSTANCE_DELETE")) if (self.handler.stage_instance_delete) |event| {
const stage = try json.parseFromSlice(GatewayPayload(Types.StageInstance), self.allocator, payload, .{.max_value_len=0x100});
const stage = try json.parseFromValue(Types.StageInstance, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, stage.value.d.?);
try event(self, stage.value);
};
if (mem.eql(u8, name, "AUTO_MODERATION_RULE_CREATE")) if (self.handler.auto_moderation_rule_create) |event| {
const rule = try json.parseFromSlice(GatewayPayload(Types.AutoModerationRule), self.allocator, payload, .{.max_value_len=0x100});
const rule = try json.parseFromValue(Types.AutoModerationRule, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, rule.value.d.?);
try event(self, rule.value);
};
if (mem.eql(u8, name, "AUTO_MODERATION_RULE_UPDATE")) if (self.handler.auto_moderation_rule_update) |event| {
const rule = try json.parseFromSlice(GatewayPayload(Types.AutoModerationRule), self.allocator, payload, .{.max_value_len=0x100});
const rule = try json.parseFromValue(Types.AutoModerationRule, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, rule.value.d.?);
try event(self, rule.value);
};
if (mem.eql(u8, name, "AUTO_MODERATION_RULE_DELETE")) if (self.handler.auto_moderation_rule_delete) |event| {
const rule = try json.parseFromSlice(GatewayPayload(Types.AutoModerationRule), self.allocator, payload, .{.max_value_len=0x100});
const rule = try json.parseFromValue(Types.AutoModerationRule, self.allocator, payload, .{.ignore_unknown_fields=true, .max_value_len=0x1000});
try event(self, rule.value.d.?);
try event(self, rule.value);
};
if (mem.eql(u8, name, "AUTO_MODERATION_ACTION_EXECUTION")) if (self.handler.auto_moderation_action_execution) |event| {
const ax = try json.parseFromSlice(GatewayPayload(Types.AutoModerationActionExecution), self.allocator, payload, .{.max_value_len = 0x100});
const ax = try json.parseFromValue(Types.AutoModerationActionExecution, self.allocator, payload, .{ .ignore_unknown_fields=true, .max_value_len = 0x1000,
});
try event(self, ax.value.d.?);
try event(self, ax.value);
};
// default handler for whoever wants it
if (self.handler.any) |anyEvent|
try anyEvent(self, payload);
//if (self.handler.any) |anyEvent|
//try anyEvent(self, payload);
}
pub const RequestFailedError = MakeRequestError || error{FailedRequest} || json.ParseError(json.Scanner);

72
src/structures/application.zig
View File

@ -30,57 +30,57 @@ pub const Application = struct {
/// The description of the app
description: []const u8,
/// An array of rpc origin urls, if rpc is enabled
rpc_origins: ?[][]const u8,
rpc_origins: ?[][]const u8 = null,
/// The url of the app's terms of service
terms_of_service_url: ?[]const u8,
terms_of_service_url: ?[]const u8 = null,
/// The url of the app's privacy policy
privacy_policy_url: ?[]const u8,
privacy_policy_url: ?[]const u8 = null,
/// The hex encoded key for verification in interactions and the GameSDK's GetTicket
verify_key: []const u8,
///If this application is a game sold on , this field will be the id of the "Game SKU" that is created, if exists
primary_sku_id: ?Snowflake,
primary_sku_id: ?Snowflake = null,
///If this application is a game sold on , this field will be the URL slug that links to the store page
slug: ?[]const u8,
slug: ?[]const u8 = null,
/// The application's public flags
flags: ?ApplicationFlags,
flags: ?ApplicationFlags = null,
/// The id of the app
id: Snowflake,
/// The icon hash of the app
icon: ?[]const u8,
icon: ?[]const u8 = null,
/// When false only app owner can join the app's bot to guilds
bot_public: bool,
/// When true the app's bot will only join upon completion of the full oauth2 code grant flow
bot_require_code_grant: bool,
/// Partial user object containing info on the owner of the application
owner: ?Partial(User),
owner: ?Partial(User) = null,
/// If the application belongs to a team, this will be a list of the members of that team
team: ?Team,
team: ?Team = null,
/// Guild associated with the app. For example, a developer support server.
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// A partial object of the associated guild
guild: ?Partial(Guild),
guild: ?Partial(Guild) = null,
///If this application is a game sold on , this field will be the hash of the image on store embeds
cover_image: ?[]const u8,
cover_image: ?[]const u8 = null,
/// up to 5 tags describing the content and functionality of the application
tags: ?[][]const u8,
tags: ?[][]const u8 = null,
/// settings for the application's default in-app authorization link, if enabled
install_params: ?InstallParams,
install_params: ?InstallParams = null,
// Default scopes and permissions for each supported installation context.
integration_types_config: ?AssociativeArray(ApplicationIntegrationType, ApplicationIntegrationTypeConfiguration),
integration_types_config: ?AssociativeArray(ApplicationIntegrationType, ApplicationIntegrationTypeConfiguration) = null,
/// the application's default custom authorization link, if enabled
custom_install_url: ?[]const u8,
custom_install_url: ?[]const u8 = null,
/// the application's role connection verification entry point, which when configured will render the app as a verification method in the guild role verification configuration
role_connections_verification_url: ?[]const u8,
role_connections_verification_url: ?[]const u8 = null,
/// An approximate count of the app's guild membership.
approximate_guild_count: ?isize,
approximate_guild_count: ?isize = null,
/// Approximate count of users that have installed the app.
approximate_user_install_count: ?isize,
approximate_user_install_count: ?isize = null,
/// Partial user object for the bot user associated with the app
bot: ?Partial(User),
bot: ?Partial(User) = null,
/// Array of redirect URIs for the app
redirect_uris: ?[][]const u8,
redirect_uris: ?[][]const u8 = null,
/// Interactions endpoint URL for the app
interactions_endpoint_url: ?[]const u8,
interactions_endpoint_url: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/resources/application#application-object-application-integration-type-configuration-object
@ -90,7 +90,7 @@ pub const ApplicationIntegrationTypeConfiguration = struct {
///
/// https://discord.com/developers/docs/resources/application#install-params-object-install-params-structure
///
oauth2_install_params: ?InstallParams,
oauth2_install_params: ?InstallParams = null,
};
pub const ApplicationIntegrationType = enum(u4) {
@ -109,37 +109,37 @@ pub const InstallParams = struct {
pub const ModifyApplication = struct {
/// Default custom authorization URL for the app, if enabled
custom_install_url: ?[]const u8,
custom_install_url: ?[]const u8 = null,
/// Description of the app
description: ?[]const u8,
description: ?[]const u8 = null,
/// Role connection verification URL for the app
role_connections_verification_url: ?[]const u8,
role_connections_verification_url: ?[]const u8 = null,
/// Settings for the app's default in-app authorization link, if enabled
install_params: ?InstallParams,
install_params: ?InstallParams = null,
/// Default scopes and permissions for each supported installation context.
integration_types_config: ?ApplicationIntegrationType,
integration_types_config: ?ApplicationIntegrationType = null,
/// App's public flags
/// @remarks
/// Only limited intent flags (`GATEWAY_PRESENCE_LIMITED`, `GATEWAY_GUILD_MEMBERS_LIMITED`, and `GATEWAY_MESSAGE_CONTENT_LIMITED`) can be updated via the API.
flags: ?ApplicationFlags,
flags: ?ApplicationFlags = null,
/// Icon for the app
icon: ?[]const u8,
icon: ?[]const u8 = null,
/// Default rich presence invite cover image for the app
cover_image: ?[]const u8,
cover_image: ?[]const u8 = null,
/// Interactions endpoint URL for the app
/// @remarks
/// To update an Interactions endpoint URL via the API, the URL must be valid
interaction_endpoint_url: ?[]const u8,
interaction_endpoint_url: ?[]const u8 = null,
/// List of tags describing the content and functionality of the app (max of 20 characters per tag)
/// @remarks
/// There can only be a max of 5 tags
tags: ?[][]const u8,
tags: ?[][]const u8 = null,
/// Event webhook URL for the app to receive webhook events
event_webhooks_url: ?[]const u8,
event_webhooks_url: ?[]const u8 = null,
/// If webhook events are enabled for the app. 1 to disable, and 2 to enable.
event_webhooks_status: ?ApplicationEventWebhookStatus,
event_webhooks_status: ?ApplicationEventWebhookStatus = null,
/// List of Webhook event types the app subscribes to
event_webhooks_types: ?[]WebhookEventType,
event_webhooks_types: ?[]WebhookEventType = null,
};
pub const ApplicationEventWebhookStatus = enum(u8) {

18
src/structures/attachment.zig
View File

@ -22,9 +22,9 @@ pub const Attachment = struct {
/// Name of file attached
filename: []const u8,
/// The title of the file
title: ?[]const u8,
title: ?[]const u8 = null,
/// The attachment's [media type](https://en.wikipedia.org/wiki/Media_type)
content_type: ?[]const u8,
content_type: ?[]const u8 = null,
/// Size of file in bytes
size: isize,
/// Source url of file
@ -34,17 +34,17 @@ pub const Attachment = struct {
/// Attachment id
id: Snowflake,
/// description for the file (max 1024 characters)
description: ?[]const u8,
description: ?[]const u8 = null,
/// Height of file (if image)
height: ?isize,
height: ?isize = null,
/// Width of file (if image)
width: ?isize,
width: ?isize = null,
/// whether this attachment is ephemeral. Ephemeral attachments will automatically be removed after a set period of time. Ephemeral attachments on messages are guaranteed to be available as long as the message itself exists.
ephemeral: ?bool,
ephemeral: ?bool = null,
/// The duration of the audio file for a voice message
duration_secs: ?isize,
duration_secs: ?isize = null,
/// A base64 encoded bytearray representing a sampled waveform for a voice message
waveform: ?[]const u8,
waveform: ?[]const u8 = null,
/// Attachment flags combined as a bitfield
flags: ?AttachmentFlags,
flags: ?AttachmentFlags = null,
};

38
src/structures/auditlog.zig
View File

@ -41,9 +41,9 @@ pub const AuditLog = struct {
///
threads: []Channel,
/// List of guild scheduled events found in the audit log
guild_scheduled_events: ?[]ScheduledEvent,
guild_scheduled_events: ?[]ScheduledEvent = null,
/// List of auto moderation rules referenced in the audit log
auto_moderation_rules: ?[]AutoModerationRule,
auto_moderation_rules: ?[]AutoModerationRule = null,
/// List of application commands referenced in the audit log
application_commands: []ApplicationCommand,
};
@ -51,20 +51,20 @@ pub const AuditLog = struct {
/// https://discord.com/developers/docs/resources/audit-log#audit-log-entry-object-audit-log-entry-structure
pub const AuditLogEntry = struct {
/// ID of the affected entity (webhook, user, role, etc.)
target_id: ?Snowflake,
target_id: ?Snowflake = null,
/// Changes made to the `target_id`
/// TODO: change this
changes: ?[]AuditLogChange(noreturn),
changes: ?[]AuditLogChange(noreturn) = null,
/// User or app that made the changes
user_id: ?Snowflake,
user_id: ?Snowflake = null,
/// ID of the entry
id: Snowflake,
/// Type of action that occurred
action_type: AuditLogEvents,
/// Additional info for certain event types
options: ?OptionalAuditEntryInfo,
options: ?OptionalAuditEntryInfo = null,
/// Reason for the change (1-512 characters)
reason: ?[]const u8,
reason: ?[]const u8 = null,
};
pub fn AuditLogChange(comptime T: type) type {
@ -78,71 +78,71 @@ pub const OptionalAuditEntryInfo = struct {
///
/// Event types: `APPLICATION_COMMAND_PERMISSION_UPDATE`,
///
application_id: ?Snowflake,
application_id: ?Snowflake = null,
///
/// Name of the Auto Moderation rule that was triggered.
///
/// Event types: `AUTO_MODERATION_BLOCK_MESSAGE`, `AUTO_MODERATION_FLAG_TO_CHANNEL`, `AUTO_MODERATION_USER_COMMUNICATION_DISABLED`,
///
auto_moderation_rule_name: ?[]const u8,
auto_moderation_rule_name: ?[]const u8 = null,
///
/// Trigger type of the Auto Moderation rule that was triggered.
///
/// Event types: `AUTO_MODERATION_BLOCK_MESSAGE`, `AUTO_MODERATION_FLAG_TO_CHANNEL`, `AUTO_MODERATION_USER_COMMUNICATION_DISABLED`,
///
auto_moderation_rule_trigger_type: ?[]const u8,
auto_moderation_rule_trigger_type: ?[]const u8 = null,
///
/// Channel in which the entities were targeted.
///
/// Event types: `MEMBER_MOVE`, `MESSAGE_PIN`, `MESSAGE_UNPIN`, `MESSAGE_DELETE`, `STAGE_INSTANCE_CREATE`, `STAGE_INSTANCE_UPDATE`, `STAGE_INSTANCE_DELETE`,
///
channel_id: ?Snowflake,
channel_id: ?Snowflake = null,
///
/// isize of entities that were targeted.
///
/// Event types: `MESSAGE_DELETE`, `MESSAGE_BULK_DELETE`, `MEMBER_DISCONNECT`, `MEMBER_MOVE`,
///
count: ?[]const u8,
count: ?[]const u8 = null,
///
/// isize of days after which inactive members were kicked.
///
/// Event types: `MEMBER_PRUNE`,
///
delete_member_days: ?[]const u8,
delete_member_days: ?[]const u8 = null,
///
/// ID of the overwritten entity.
///
/// Event types: `CHANNEL_OVERWRITE_CREATE`, `CHANNEL_OVERWRITE_UPDATE`, `CHANNEL_OVERWRITE_DELETE`,
///
id: ?Snowflake,
id: ?Snowflake = null,
///
/// isize of members removed by the prune.
///
/// Event types: `MEMBER_PRUNE`,
///
members_removed: ?[]const u8,
members_removed: ?[]const u8 = null,
///
/// ID of the message that was targeted.
///
/// Event types: `MESSAGE_PIN`, `MESSAGE_UNPIN`, `STAGE_INSTANCE_CREATE`, `STAGE_INSTANCE_UPDATE`, `STAGE_INSTANCE_DELETE`,
///
message_id: ?Snowflake,
message_id: ?Snowflake = null,
///
/// Name of the role if type is "0" (not present if type is "1").
///
/// Event types: `CHANNEL_OVERWRITE_CREATE`, `CHANNEL_OVERWRITE_UPDATE`, `CHANNEL_OVERWRITE_DELETE`,
///
role_name: ?[]const u8,
role_name: ?[]const u8 = null,
///
/// Type of overwritten entity - "0", for "role", or "1" for "member".
///
/// Event types: `CHANNEL_OVERWRITE_CREATE`, `CHANNEL_OVERWRITE_UPDATE`, `CHANNEL_OVERWRITE_DELETE`,
///
type: ?[]const u8,
type: ?[]const u8 = null,
///
/// The type of integration which performed the action
///
/// Event types: `MEMBER_KICK`, `MEMBER_ROLE_UPDATE`,
///
integration_type: ?[]const u8,
integration_type: ?[]const u8 = null,
};

26
src/structures/automod.zig
View File

@ -71,7 +71,7 @@ pub const AutoModerationRuleTriggerMetadata = struct {
///
/// Can have up to 1000 elements in the array and each []const u8 can have up to 60 characters
///
keyword_filter: ?[][]const u8,
keyword_filter: ?[][]const u8 = null,
///
/// Regular expression patterns which will be matched against content.
///
@ -87,7 +87,7 @@ pub const AutoModerationRuleTriggerMetadata = struct {
/// @remarks
/// Only present with {@link AutoModerationTriggerTypes.KeywordPreset};.
///
presets: ?[]AutoModerationRuleTriggerMetadataPresets,
presets: ?[]AutoModerationRuleTriggerMetadataPresets = null,
///
/// The substrings which will exempt from triggering the preset trigger type.
///
@ -97,7 +97,7 @@ pub const AutoModerationRuleTriggerMetadata = struct {
/// When used with {@link AutoModerationTriggerTypes.Keyword}; and {@link AutoModerationTriggerTypes.MemberProfile}; there can have up to 100 elements in the array and each []const u8 can have up to 60 characters.
/// When used with {@link AutoModerationTriggerTypes.KeywordPreset}; there can have up to 1000 elements in the array and each []const u8 can have up to 60 characters.
///
allow_list: ?[][]const u8,
allow_list: ?[][]const u8 = null,
///
/// Total isize of mentions (role & user) allowed per message.
///
@ -106,14 +106,14 @@ pub const AutoModerationRuleTriggerMetadata = struct {
///
/// Maximum of 50
///
mention_total_limit: ?isize,
mention_total_limit: ?isize = null,
///
/// Whether to automatically detect mention raids.
///
/// @remarks
/// Only present with {@link AutoModerationTriggerTypes.MentionSpam};.
///
mention_raid_protection_enabled: ?bool,
mention_raid_protection_enabled: ?bool = null,
};
pub const AutoModerationRuleTriggerMetadataPresets = enum(u4) {
@ -152,11 +152,11 @@ pub const AutoModerationActionType = enum(u4) {
pub const AutoModerationActionMetadata = struct {
/// The id of channel to which user content should be logged. Only in ActionType.SendAlertMessage
channel_id: ?Snowflake,
channel_id: ?Snowflake = null,
/// Additional explanation that will be shown to members whenever their message is blocked. Maximum of 150 characters. Only supported for AutoModerationActionType.BlockMessage
custom_message: ?[]const u8,
custom_message: ?[]const u8 = null,
/// Timeout duration in seconds maximum of 2419200 seconds (4 weeks). Only supported for TriggerType.Keyword && Only in ActionType.Timeout
duration_seconds: ?isize,
duration_seconds: ?isize = null,
};
/// https://discord.com/developers/docs/topics/gateway-events#auto-moderation-action-execution-auto-moderation-action-execution-event-fields
@ -174,13 +174,13 @@ pub const AutoModerationActionExecution = struct {
/// The trigger type of the rule that was executed.
rule_trigger_type: AutoModerationTriggerTypes,
/// The id of the channel in which user content was posted
channel_id: ?Snowflake,
channel_id: ?Snowflake = null,
/// The id of the message. Will not exist if message was blocked by automod or content was not part of any message
message_id: ?Snowflake,
message_id: ?Snowflake = null,
/// The id of any system auto moderation messages posted as a result of this action
alert_system_message_id: ?Snowflake,
alert_system_message_id: ?Snowflake = null,
/// The word or phrase that triggerred the rule.
matched_keyword: ?[]const u8,
matched_keyword: ?[]const u8 = null,
/// The substring in content that triggered the rule
matched_content: ?[]const u8,
matched_content: ?[]const u8 = null,
};

116
src/structures/channel.zig
View File

@ -32,13 +32,13 @@ const ForumLayout = @import("shared.zig").ForumLayout;
/// https://discord.com/developers/docs/resources/channel#allowed-mentions-object
pub const AllowedMentions = struct {
/// An array of allowed mention types to parse from the content.
parse: ?[]AllowedMentionsTypes,
parse: ?[]AllowedMentionsTypes = null,
/// For replies, whether to mention the author of the message being replied to (default false)
replied_user: ?bool,
replied_user: ?bool = null,
/// Array of role_ids to mention (Max size of 100)
roles: ?[][]const u8,
roles: ?[][]const u8 = null,
/// Array of user_ids to mention (Max size of 100)
users: ?[][]const u8,
users: ?[][]const u8 = null,
};
/// https://discord.com/developers/docs/topics/gateway#typing-start
@ -48,11 +48,11 @@ pub const TypingStart = struct {
/// id of the channel
channel_id: Snowflake,
/// id of the guild
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// id of the user
user_id: Snowflake,
/// The member who started typing if this happened in a guild
member: ?Member,
member: ?Member = null,
};
/// https://discord.com/developers/docs/resources/channel#channel-object
@ -62,79 +62,79 @@ pub const Channel = struct {
/// The type of channel
type: ChannelTypes,
/// The id of the guild
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// Sorting position of the channel (channels with the same position are sorted by id)
position: ?isize,
position: ?isize = null,
/// Explicit permission overwrites for members and roles
permission_overwrites: ?[]Overwrite,
permission_overwrites: ?[]Overwrite = null,
/// The name of the channel (1-100 characters)
name: ?[]const u8,
name: ?[]const u8 = null,
/// The channel topic (0-4096 characters for GUILD_FORUM channels, 0-1024 characters for all others)
topic: ?[]const u8,
topic: ?[]const u8 = null,
/// Whether the channel is nsfw
nsfw: ?bool,
nsfw: ?bool = null,
/// The id of the last message sent in this channel (may not point to an existing or valid message)
last_message_id: ?Snowflake,
last_message_id: ?Snowflake = null,
/// The bitrate (in bits) of the voice or stage channel
bitrate: ?isize,
bitrate: ?isize = null,
/// The user limit of the voice or stage channel
user_limit: ?isize,
user_limit: ?isize = null,
/// Amount of seconds a user has to wait before sending another message (0-21600); bots, as well as users with the permission `manage_messages` or `manage_channel`, are unaffected
rate_limit_per_user: ?isize,
rate_limit_per_user: ?isize = null,
/// the recipients of the DM
recipients: ?[]User,
recipients: ?[]User = null,
/// icon hash of the group DM
icon: ?[]const u8,
icon: ?[]const u8 = null,
/// Id of the creator of the thread
owner_id: ?Snowflake,
owner_id: ?Snowflake = null,
/// Application id of the group DM creator if it is bot-created
application_id: ?Snowflake,
application_id: ?Snowflake = null,
/// For group DM channels: whether the channel is managed by an application via the `gdm.join` OAuth2 scope.,
managed: ?bool,
managed: ?bool = null,
/// For guild channels: Id of the parent category for a channel (each parent category can contain up to 50 channels), for threads: id of the text channel this thread was created,
parent_id: ?Snowflake,
parent_id: ?Snowflake = null,
/// When the last pinned message was pinned. This may be null in events such as GUILD_CREATE when a message is not pinned.
last_pin_timestamp: ?[]const u8,
last_pin_timestamp: ?[]const u8 = null,
/// Voice region id for the voice or stage channel, automatic when set to null
rtc_region: ?[]const u8,
rtc_region: ?[]const u8 = null,
/// The camera video quality mode of the voice channel, 1 when not present
video_quality_mode: ?VideoQualityModes,
video_quality_mode: ?VideoQualityModes = null,
/// An approximate count of messages in a thread, stops counting at 50
message_count: ?isize,
message_count: ?isize = null,
/// An approximate count of users in a thread, stops counting at 50
member_count: ?isize,
member_count: ?isize = null,
/// Thread-specific fields not needed by other channels
thread_metadata: ?ThreadMetadata,
thread_metadata: ?ThreadMetadata = null,
/// Thread member object for the current user, if they have joined the thread, only included on certain API endpoints
member: ?ThreadMember,
member: ?ThreadMember = null,
/// Default duration for newly created threads, in minutes, to automatically archive the thread after recent activity, can be set to: 60, 1440, 4320, 10080,
default_auto_archive_duration: ?isize,
default_auto_archive_duration: ?isize = null,
/// computed permissions for the invoking user in the channel, including overwrites, only included when part of the resolved data received on a slash command interaction. This does not include implicit permissions, which may need to be checked separately.
permissions: ?[]const u8,
permissions: ?[]const u8 = null,
/// The flags of the channel
flags: ?ChannelFlags,
flags: ?ChannelFlags = null,
/// isize of messages ever sent in a thread, it's similar to `message_count` on message creation, but will not decrement the isize when a message is deleted
total_message_sent: ?isize,
total_message_sent: ?isize = null,
/// The set of tags that can be used in a GUILD_FORUM channel
available_tags: ?[]ForumTag,
available_tags: ?[]ForumTag = null,
/// The IDs of the set of tags that have been applied to a thread in a GUILD_FORUM channel
applied_tags: ?[][]const u8,
applied_tags: ?[][]const u8 = null,
/// the emoji to show in the add reaction button on a thread in a GUILD_FORUM channel
default_reaction_emoji: ?DefaultReactionEmoji,
default_reaction_emoji: ?DefaultReactionEmoji = null,
/// the initial rate_limit_per_user to set on newly created threads in a channel. this field is copied to the thread at creation time and does not live update.
default_thread_rate_limit_per_user: ?isize,
default_thread_rate_limit_per_user: ?isize = null,
/// the default sort order type used to order posts in GUILD_FORUM channels. Defaults to null, which indicates a preferred sort order hasn't been set by a channel admin
default_sort_order: ?SortOrderTypes,
default_sort_order: ?SortOrderTypes = null,
/// the default forum layout view used to display posts in `GUILD_FORUM` channels. Defaults to `0`, which indicates a layout view has not been set by a channel admin
default_forum_layout: ?ForumLayout,
default_forum_layout: ?ForumLayout = null,
/// When a thread is created this will be true on that channel payload for the thread.
newly_created: ?bool,
newly_created: ?bool = null,
};
/// https://discord.com/developers/docs/resources/guild#welcome-screen-object-welcome-screen-structure
pub const WelcomeScreen = struct {
/// The server description shown in the welcome screen
description: ?[]const u8,
description: ?[]const u8 = null,
/// The channels shown in the welcome screen, up to 5
welcome_channels: []WelcomeScreenChannel,
};
@ -146,9 +146,9 @@ pub const WelcomeScreenChannel = struct {
/// The channel's id
channel_id: Snowflake,
/// The emoji id, if the emoji is custom
emoji_id: ?Snowflake,
emoji_id: ?Snowflake = null,
/// The emoji name if custom, the unicode character if standard, or `null` if no emoji is set
emoji_name: ?[]const u8,
emoji_name: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/resources/stage-instance#auto-closing-stage-instance-structure
@ -162,7 +162,7 @@ pub const StageInstance = struct {
/// The id of the associated Stage channel
channel_id: Snowflake,
/// The id of the scheduled event for this Stage instance
guild_scheduled_event_id: ?Snowflake,
guild_scheduled_event_id: ?Snowflake = null,
};
pub const Overwrite = struct {
@ -171,9 +171,9 @@ pub const Overwrite = struct {
/// Role or user id
id: Snowflake,
/// Permission bit set
allow: ?[]const u8,
allow: ?[]const u8 = null,
/// Permission bit set
deny: ?[]const u8,
deny: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/resources/channel#followed-channel-object
@ -194,14 +194,14 @@ pub const ForumTag = struct {
/// The id of a guild's custom emoji At most one of emoji_id and emoji_name may be set.
emoji_id: Snowflake,
/// The unicode character of the emoji
emoji_name: ?[]const u8,
emoji_name: ?[]const u8 = null,
};
pub const DefaultReactionEmoji = struct {
/// The id of a guild's custom emoji
emoji_id: Snowflake,
/// The unicode character of the emoji
emoji_name: ?[]const u8,
emoji_name: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/resources/guild#modify-guild-channel-positions
@ -209,26 +209,26 @@ pub const ModifyGuildChannelPositions = struct {
/// Channel id
id: Snowflake,
/// Sorting position of the channel (channels with the same position are sorted by id)
position: ?isize,
position: ?isize = null,
/// Syncs the permission overwrites with the new parent, if moving to a new category
lock_positions: ?bool,
lock_positions: ?bool = null,
/// The new parent ID for the channel that is moved
parent_id: ?Snowflake,
parent_id: ?Snowflake = null,
};
pub const CreateChannelInvite = struct {
/// Duration of invite in seconds before expiry, or 0 for never. Between 0 and 604800 (7 days). Default: 86400 (24 hours)
max_age: ?isize,
max_age: ?isize = null,
/// Max number of users or 0 for unlimited. Between 0 and 100. Default: 0
max_uses: ?isize,
max_uses: ?isize = null,
/// Whether this invite only grants temporary membership. Default: false
temporary: ?bool,
temporary: ?bool = null,
/// If true, don't try to reuse similar invite (useful for creating many unique one time use invites). Default: false
unique: ?bool,
unique: ?bool = null,
/// The type of target for this voice channel invite
target_type: ?TargetTypes,
target_type: ?TargetTypes = null,
/// The id of the user whose stream to display for this invite, required if `target_type` is 1, the user must be streaming in the channel
target_user_id: ?Snowflake,
target_user_id: ?Snowflake = null,
/// The id of the embedded application to open for this invite, required if `target_type` is 2, the application must have the `EMBEDDED` flag
target_application_id: ?Snowflake,
target_application_id: ?Snowflake = null,
};

66
src/structures/command.zig
View File

@ -25,7 +25,7 @@ const ChannelTypes = @import("shared.zig").ChannelTypes;
/// https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-structure
pub const ApplicationCommand = struct {
/// Type of command, defaults to `ApplicationCommandTypes.ChatInput`
type: ?ApplicationCommandTypes,
type: ?ApplicationCommandTypes = null,
///
/// Name of command, 1-32 characters.
/// `ApplicationCommandTypes.ChatInput` command names must match the following regex `^[-_\p{L};\p{N};\p{sc=Deva};\p{sc=Thai};]{1,32};$` with the unicode flag set.
@ -35,15 +35,15 @@ pub const ApplicationCommand = struct {
///
name: []const u8,
/// Localization object for `name` field. Values follow the same restrictions as `name`
name_localizations: ?[]const u8, //?Localization,
name_localizations: ?[]const u8, //?Localization = null,
/// Description for `ApplicationCommandTypes.ChatInput` commands, 1-100 characters.
description: ?[]const u8,
description: ?[]const u8 = null,
/// Localization object for `description` field. Values follow the same restrictions as `description`
description_localizations: ?[]const u8, //?Localization,
description_localizations: ?[]const u8, //?Localization = null,
/// Parameters for the command, max of 25
options: ?[]ApplicationCommandOption,
options: ?[]ApplicationCommandOption = null,
/// Set of permissions represented as a bit set
default_member_permissions: ?[]const u8,
default_member_permissions: ?[]const u8 = null,
///
/// Installation contexts where the command is available
///
@ -51,7 +51,7 @@ pub const ApplicationCommand = struct {
/// This value is available only for globally-scoped commands
/// Defaults to the application configured contexts
///
integration_types: ?[]ApplicationIntegrationType,
integration_types: ?[]ApplicationIntegrationType = null,
///
/// Interaction context(s) where the command can be used
///
@ -59,35 +59,35 @@ pub const ApplicationCommand = struct {
/// This value is available only for globally-scoped commands
/// By default, all interaction context types included for new commands.
///
contexts: ?[]InteractionContextType,
contexts: ?[]InteractionContextType = null,
///
/// Indicates whether the command is available in DMs with the app, only for globally-scoped commands. By default, commands are visible.
///
/// @deprecated use {@link contexts}; instead
///
dm_permission: ?bool,
dm_permission: ?bool = null,
/// Indicates whether the command is age-restricted, defaults to false
nsfw: ?bool,
nsfw: ?bool = null,
/// Auto incrementing version identifier updated during substantial record changes
version: ?[]const u8,
version: ?[]const u8 = null,
///
///Determines whether the interaction is handled by the app's interactions handler or by
///
/// @remarks
/// This can only be set for application commands of type `PRIMARY_ENTRY_POINT` for applications with the `EMBEDDED` flag (i.e. applications that have an Activity).
///
handler: ?InteractionEntryPointCommandHandlerType,
handler: ?InteractionEntryPointCommandHandlerType = null,
/// Unique ID of command
id: Snowflake,
/// ID of the parent application
application_id: Snowflake,
/// Guild id of the command, if not global
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
};
pub const CreateApplicationCommand = struct {
/// Type of command, defaults to `ApplicationCommandTypes.ChatInput`
type: ?ApplicationCommandTypes,
type: ?ApplicationCommandTypes = null,
///
/// Name of command, 1-32 characters.
/// `ApplicationCommandTypes.ChatInput` command names must match the following regex `^[-_\p{L};\p{N};\p{sc=Deva};\p{sc=Thai};]{1,32};$` with the unicode flag set.
@ -99,13 +99,13 @@ pub const CreateApplicationCommand = struct {
/// Localization object for `name` field. Values follow the same restrictions as `name`
name_localizations: []const u8, //?Localization,
/// Description for `ApplicationCommandTypes.ChatInput` commands, 1-100 characters.
description: ?[]const u8,
description: ?[]const u8 = null,
/// Localization object for `description` field. Values follow the same restrictions as `description`
description_localizations: []const u8, //?Localization,
/// Parameters for the command, max of 25
options: ?[]ApplicationCommandOption,
options: ?[]ApplicationCommandOption = null,
/// Set of permissions represented as a bit set
default_member_permissions: ?[]const u8,
default_member_permissions: ?[]const u8 = null,
///
/// Installation contexts where the command is available
///
@ -113,7 +113,7 @@ pub const CreateApplicationCommand = struct {
/// This value is available only for globally-scoped commands
/// Defaults to the application configured contexts
///
integration_types: ?[]ApplicationIntegrationType,
integration_types: ?[]ApplicationIntegrationType = null,
///
/// Interaction context(s) where the command can be used
///
@ -121,24 +121,24 @@ pub const CreateApplicationCommand = struct {
/// This value is available only for globally-scoped commands
/// By default, all interaction context types included for new commands.
///
contexts: ?[]InteractionContextType,
contexts: ?[]InteractionContextType = null,
///
/// Indicates whether the command is available in DMs with the app, only for globally-scoped commands. By default, commands are visible.
///
/// @deprecated use {@link contexts}; instead
///
dm_permission: ?bool,
dm_permission: ?bool = null,
/// Indicates whether the command is age-restricted, defaults to false
nsfw: ?bool,
nsfw: ?bool = null,
/// Auto incrementing version identifier updated during substantial record changes
version: ?[]const u8,
version: ?[]const u8 = null,
///
///Determines whether the interaction is handled by the app's interactions handler or by
///
/// @remarks
/// This can only be set for application commands of type `PRIMARY_ENTRY_POINT` for applications with the `EMBEDDED` flag (i.e. applications that have an Activity).
///
handler: ?InteractionEntryPointCommandHandlerType,
handler: ?InteractionEntryPointCommandHandlerType = null,
};
pub const InteractionEntryPointCommandHandlerType = enum(u4) {
@ -170,14 +170,14 @@ pub const ApplicationCommandOption = struct {
/// 1-100 character description
description: []const u8,
/// Localization object for the `description` field. Values follow the same restrictions as `description`
description_localizations: ?[]const u8, //?Localization,
description_localizations: ?[]const u8, //?Localization = null,
///
/// If the parameter is required or optional. default `false`
///
/// @remarks
/// Valid in all option types except {@link ApplicationCommandOptionTypes.SubCommand | SubCommand}; and {@link ApplicationCommandOptionTypes.SubCommandGroup | SubCommandGroup};
///
required: ?bool,
required: ?bool = null,
///
/// Choices for the option from which the user can choose, max 25
///
@ -186,14 +186,14 @@ pub const ApplicationCommandOption = struct {
///
/// If you provide an array of choices, they will be the ONLY accepted values for this option
///
choices: ?[]ApplicationCommandOptionChoice,
choices: ?[]ApplicationCommandOptionChoice = null,
///
/// If the option is a subcommand or subcommand group type, these nested options will be the parameters
///
/// @remarks
/// Only valid in option of type {@link ApplicationCommandOptionTypes.SubCommand | SubCommand}; or {@link ApplicationCommandOptionTypes.SubCommandGroup | SubCommandGroup};
///
options: ?[]ApplicationCommandOption,
options: ?[]ApplicationCommandOption = null,
///
/// If autocomplete interactions are enabled for this option.
///
@ -202,42 +202,42 @@ pub const ApplicationCommandOption = struct {
///
///When {@link ApplicationCommandOption.choices | choices}; are provided, this may not be set to true
///
autocomplete: ?bool,
autocomplete: ?bool = null,
///
/// The channels shown will be restricted to these types
///
/// @remarks
/// Only valid in option of type {@link ApplicationCommandOptionTypes.Channel | Channel};
///
channel_types: ?[]ChannelTypes,
channel_types: ?[]ChannelTypes = null,
///
/// The minimum permitted value
///
/// @remarks
/// Only valid in options of type {@link ApplicationCommandOptionTypes.Integer | Integer}; or {@link ApplicationCommandOptionTypes.isize | isize};
///
min_value: ?isize,
min_value: ?isize = null,
///
/// The maximum permitted value
///
/// @remarks
/// Only valid in options of type {@link ApplicationCommandOptionTypes.Integer | Integer}; or {@link ApplicationCommandOptionTypes.isize | isize};
///
max_value: ?isize,
max_value: ?isize = null,
///
/// The minimum permitted length, should be in the range of from 0 to 600
///
/// @remarks
/// Only valid in options of type {@link ApplicationCommandOptionTypes.[]const u8 | []const u8};
///
min_length: ?isize,
min_length: ?isize = null,
///
/// The maximum permitted length, should be in the range of from 0 to 600
///
/// @remarks
/// Only valid in options of type {@link ApplicationCommandOptionTypes.[]const u8 | []const u8};
///
max_length: ?isize,
max_length: ?isize = null,
};
/// https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object

146
src/structures/component.zig
View File

@ -14,17 +14,17 @@ pub const Button = struct {
/// A button style
style: ButtonStyles,
/// Text that appears on the button; max 80 characters
label: ?[]const u8,
label: ?[]const u8 = null,
/// name, id, and animated
emoji: Partial(Emoji),
/// Developer-defined identifier for the button; max 100 characters
custom_id: ?[]const u8,
custom_id: ?[]const u8 = null,
/// Identifier for a purchasable SKU, only available when using premium-style buttons
sku_id: ?Snowflake,
sku_id: ?Snowflake = null,
/// URL for link-style buttons
url: ?[]const u8,
url: ?[]const u8 = null,
/// Whether the button is disabled (defaults to false)
disabled: ?bool,
disabled: ?bool = null,
};
pub const SelectOption = struct {
@ -33,11 +33,11 @@ pub const SelectOption = struct {
/// Dev-defined value of the option; max 100 characters
value: []const u8,
/// Additional description of the option; max 100 characters
description: ?[]const u8,
description: ?[]const u8 = null,
/// id, name, and animated
emoji: ?Partial(Emoji),
emoji: ?Partial(Emoji) = null,
/// Will show this option as selected by default
default: ?bool,
default: ?bool = null,
};
pub const DefaultValue = struct {
@ -55,15 +55,15 @@ pub const SelectMenuString = struct {
custom_id: []const u8,
/// Specified choices in a select menu (only required and available for string selects (type 3); max 25
/// * options is required for string select menus (component type 3), and unavailable for all other select menu components.
options: ?[]SelectOption,
options: ?[]SelectOption = null,
/// Placeholder text if nothing is selected; max 150 characters
placeholder: ?[]const u8,
placeholder: ?[]const u8 = null,
/// Minimum number of items that must be chosen (defaults to 1); min 0, max 25
min_values: ?usize,
min_values: ?usize = null,
/// Maximum number of items that can be chosen (defaults to 1); max 25
max_values: ?usize,
max_values: ?usize = null,
/// Whether select menu is disabled (defaults to false)
disabled: ?bool,
disabled: ?bool = null,
};
/// https://discord.com/developers/docs/interactions/message-components#select-menus
@ -73,16 +73,16 @@ pub const SelectMenuUsers = struct {
/// ID for the select menu; max 100 characters
custom_id: []const u8,
/// Placeholder text if nothing is selected; max 150 characters
placeholder: ?[]const u8,
placeholder: ?[]const u8 = null,
/// List of default values for auto-populated select menu components; number of default values must be in the range defined by min_values and max_values
/// *** default_values is only available for auto-populated select menu components, which include user (5), role (6), mentionable (7), and channel (8) components.
default_values: ?[]DefaultValue,
default_values: ?[]DefaultValue = null,
/// Minimum number of items that must be chosen (defaults to 1); min 0, max 25
min_values: ?usize,
min_values: ?usize = null,
/// Maximum number of items that can be chosen (defaults to 1); max 25
max_values: ?usize,
max_values: ?usize = null,
/// Whether select menu is disabled (defaults to false)
disabled: ?bool,
disabled: ?bool = null,
};
/// https://discord.com/developers/docs/interactions/message-components#select-menus
@ -92,16 +92,16 @@ pub const SelectMenuRoles = struct {
/// ID for the select menu; max 100 characters
custom_id: []const u8,
/// Placeholder text if nothing is selected; max 150 characters
placeholder: ?[]const u8,
placeholder: ?[]const u8 = null,
/// List of default values for auto-populated select menu components; number of default values must be in the range defined by min_values and max_values
/// *** default_values is only available for auto-populated select menu components, which include user (5), role (6), mentionable (7), and channel (8) components.
default_values: ?[]DefaultValue,
default_values: ?[]DefaultValue = null,
/// Minimum number of items that must be chosen (defaults to 1); min 0, max 25
min_values: ?usize,
min_values: ?usize = null,
/// Maximum number of items that can be chosen (defaults to 1); max 25
max_values: ?usize,
max_values: ?usize = null,
/// Whether select menu is disabled (defaults to false)
disabled: ?bool,
disabled: ?bool = null,
};
/// https://discord.com/developers/docs/interactions/message-components#select-menus
@ -111,16 +111,16 @@ pub const SelectMenuUsersAndRoles = struct {
/// ID for the select menu; max 100 characters
custom_id: []const u8,
/// Placeholder text if nothing is selected; max 150 characters
placeholder: ?[]const u8,
placeholder: ?[]const u8 = null,
/// List of default values for auto-populated select menu components; number of default values must be in the range defined by min_values and max_values
/// *** default_values is only available for auto-populated select menu components, which include user (5), role (6), mentionable (7), and channel (8) components.
default_values: ?[]DefaultValue,
default_values: ?[]DefaultValue = null,
/// Minimum number of items that must be chosen (defaults to 1); min 0, max 25
min_values: ?usize,
min_values: ?usize = null,
/// Maximum number of items that can be chosen (defaults to 1); max 25
max_values: ?usize,
max_values: ?usize = null,
/// Whether select menu is disabled (defaults to false)
disabled: ?bool,
disabled: ?bool = null,
};
/// https://discord.com/developers/docs/interactions/message-components#select-menus
@ -131,18 +131,18 @@ pub const SelectMenuChannels = struct {
custom_id: []const u8,
/// List of channel types to include in the channel select component (type 8)
/// ** channel_types can only be used for channel select menu components.
channel_types: ?[]ChannelTypes,
channel_types: ?[]ChannelTypes = null,
/// Placeholder text if nothing is selected; max 150 characters
placeholder: ?[]const u8,
placeholder: ?[]const u8 = null,
/// List of default values for auto-populated select menu components; number of default values must be in the range defined by min_values and max_values
/// *** default_values is only available for auto-populated select menu components, which include user (5), role (6), mentionable (7), and channel (8) components.
default_values: ?[]DefaultValue,
default_values: ?[]DefaultValue = null,
/// Minimum number of items that must be chosen (defaults to 1); min 0, max 25
min_values: ?usize,
min_values: ?usize = null,
/// Maximum number of items that can be chosen (defaults to 1); max 25
max_values: ?usize,
max_values: ?usize = null,
/// Whether select menu is disabled (defaults to false)
disabled: ?bool,
disabled: ?bool = null,
};
pub const SelectMenu = union(MessageComponentTypes) {
@ -154,18 +154,34 @@ pub const SelectMenu = union(MessageComponentTypes) {
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.max_value_len = 0x100,
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .object) @panic("coulnd't match against non-object type");
switch (value.object.get("type") orelse @panic("couldn't find property `type`")) {
.integer => |num| return switch (@as(MessageComponentTypes, @enumFromInt(num))) {
.SelectMenu => .{ .SelectMenu = try std.json.parseFromValueLeaky(SelectMenuString, allocator, value, .{.max_value_len = 0x100})},
.SelectMenuUsers => .{ .SelectMenuUsers = try std.json.parseFromValueLeaky(SelectMenuUsers, allocator, value, .{.max_value_len = 0x100})},
.SelectMenuRoles => .{ .SelectMenuRoles = try std.json.parseFromValueLeaky(SelectMenuRoles, allocator, value, .{.max_value_len = 0x100})},
.SelectMenuUsersAndRoles => .{ .SelectMenuUsersAndRoles = try std.json.parseFromValueLeaky(SelectMenuUsersAndRoles, allocator, value, .{.max_value_len = 0x100})},
.SelectMenuChannels => .{ .SelectMenuChannels = try std.json.parseFromValueLeaky(SelectMenuChannels, allocator, value, .{.max_value_len = 0x100})},
.SelectMenu => .{ .SelectMenu = try std.json.parseFromValueLeaky(SelectMenuString, allocator, value, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
})},
.SelectMenuUsers => .{ .SelectMenuUsers = try std.json.parseFromValueLeaky(SelectMenuUsers, allocator, value, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
})},
.SelectMenuRoles => .{ .SelectMenuRoles = try std.json.parseFromValueLeaky(SelectMenuRoles, allocator, value, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
})},
.SelectMenuUsersAndRoles => .{ .SelectMenuUsersAndRoles = try std.json.parseFromValueLeaky(SelectMenuUsersAndRoles, allocator, value, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
})},
.SelectMenuChannels => .{ .SelectMenuChannels = try std.json.parseFromValueLeaky(SelectMenuChannels, allocator, value, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
})},
},
else => @panic("got type but couldn't match against non enum member `type`"),
}
@ -194,15 +210,15 @@ pub const InputText = struct {
/// Label for this component; max 45 characters
label: []const u8,
/// Minimum input length for a text input; min 0, max 4000
min_length: ?usize,
min_length: ?usize = null,
/// Maximum input length for a text input; min 1, max 4000
max_length: ?usize,
max_length: ?usize = null,
/// Whether this component is required to be filled (defaults to true)
required: ?bool,
required: ?bool = null,
/// Pre-filled value for this component; max 4000 characters
value: ?[]const u8,
value: ?[]const u8 = null,
/// Custom placeholder text if the input is empty; max 100 characters
placeholder: ?[]const u8,
placeholder: ?[]const u8 = null,
};
pub const MessageComponent = union(MessageComponentTypes) {
@ -223,21 +239,43 @@ pub const MessageComponent = union(MessageComponentTypes) {
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.max_value_len = 0x100,
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .object) @panic("coulnd't match against non-object type");
switch (value.object.get("type") orelse @panic("couldn't find property `type`")) {
.integer => |num| return switch (@as(MessageComponentTypes, @enumFromInt(num))) {
.ActionRow => .{ .ActionRow = try std.json.parseFromValueLeaky([]MessageComponent, allocator, value, .{.max_value_len = 0x100}) },
.Button => .{ .Button = try std.json.parseFromValueLeaky(Button, allocator, value, .{.max_value_len = 0x100}) },
.SelectMenu => .{ .SelectMenu = try std.json.parseFromValueLeaky(SelectMenuString, allocator, value, .{.max_value_len = 0x100})},
.InputText => .{ .InputText = try std.json.parseFromValueLeaky(InputText, allocator, value, .{.max_value_len = 0x100}) },
.SelectMenuUsers => .{ .SelectMenuUsers = try std.json.parseFromValueLeaky(SelectMenuUsers, allocator, value, .{.max_value_len = 0x100})},
.SelectMenuRoles => .{ .SelectMenuRoles = try std.json.parseFromValueLeaky(SelectMenuRoles, allocator, value, .{.max_value_len = 0x100})},
.SelectMenuUsersAndRoles => .{ .SelectMenuUsersAndRoles = try std.json.parseFromValueLeaky(SelectMenuUsersAndRoles, allocator, value, .{.max_value_len = 0x100})},
.SelectMenuChannels => .{ .SelectMenuChannels = try std.json.parseFromValueLeaky(SelectMenuChannels, allocator, value, .{.max_value_len = 0x100})},
.ActionRow => .{ .ActionRow = try std.json.parseFromValueLeaky([]MessageComponent, allocator, value, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
}) },
.Button => .{ .Button = try std.json.parseFromValueLeaky(Button, allocator, value, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
}) },
.SelectMenu => .{ .SelectMenu = try std.json.parseFromValueLeaky(SelectMenuString, allocator, value, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
})},
.InputText => .{ .InputText = try std.json.parseFromValueLeaky(InputText, allocator, value, .{.max_value_len = 0x1000}) },
.SelectMenuUsers => .{ .SelectMenuUsers = try std.json.parseFromValueLeaky(SelectMenuUsers, allocator, value, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
})},
.SelectMenuRoles => .{ .SelectMenuRoles = try std.json.parseFromValueLeaky(SelectMenuRoles, allocator, value, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
})},
.SelectMenuUsersAndRoles => .{ .SelectMenuUsersAndRoles = try std.json.parseFromValueLeaky(SelectMenuUsersAndRoles, allocator, value, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
})},
.SelectMenuChannels => .{ .SelectMenuChannels = try std.json.parseFromValueLeaky(SelectMenuChannels, allocator, value, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
})},
},
else => @panic("got type but couldn't match against non enum member `type`"),
}

62
src/structures/embed.zig
View File

@ -19,31 +19,31 @@ const EmbedTypes = @import("shared.zig").EmbedTypes;
/// https://discord.com/developers/docs/resources/channel#embed-object
pub const Embed = struct {
/// Title of embed
title: ?[]const u8,
title: ?[]const u8 = null,
/// Type of embed (always "rich" for webhook embeds)
type: ?EmbedTypes,
type: ?EmbedTypes = null,
/// Description of embed
description: ?[]const u8,
description: ?[]const u8 = null,
/// Url of embed
url: ?[]const u8,
url: ?[]const u8 = null,
/// Color code of the embed
color: ?isize,
color: ?isize = null,
/// Timestamp of embed content
timestamp: ?[]const u8,
timestamp: ?[]const u8 = null,
/// Footer information
footer: ?EmbedFooter,
footer: ?EmbedFooter = null,
/// Image information
image: ?EmbedImage,
image: ?EmbedImage = null,
/// Thumbnail information
thumbnail: ?EmbedThumbnail,
thumbnail: ?EmbedThumbnail = null,
/// Video information
video: ?EmbedVideo,
video: ?EmbedVideo = null,
/// Provider information
provider: ?EmbedProvider,
provider: ?EmbedProvider = null,
/// Author information
author: ?EmbedAuthor,
author: ?EmbedAuthor = null,
/// Fields information
fields: ?[]EmbedField,
fields: ?[]EmbedField = null,
};
/// https://discord.com/developers/docs/resources/channel#embed-object-embed-author-structure
@ -51,11 +51,11 @@ pub const EmbedAuthor = struct {
/// Name of author
name: []const u8,
/// Url of author
url: ?[]const u8,
url: ?[]const u8 = null,
/// Url of author icon (only supports http(s) and attachments)
icon_url: ?[]const u8,
icon_url: ?[]const u8 = null,
/// A proxied url of author icon
proxy_icon_url: ?[]const u8,
proxy_icon_url: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/resources/channel#embed-object-embed-field-structure
@ -65,7 +65,7 @@ pub const EmbedField = struct {
/// Value of the field
value: []const u8,
/// Whether or not this field should display inline
@"inline": ?bool,
@"inline" : ?bool = null,
};
/// https://discord.com/developers/docs/resources/channel#embed-object-embed-footer-structure
@ -73,9 +73,9 @@ pub const EmbedFooter = struct {
/// Footer text
text: []const u8,
/// Url of footer icon (only supports http(s) and attachments)
icon_url: ?[]const u8,
icon_url: ?[]const u8 = null,
/// A proxied url of footer icon
proxy_icon_url: ?[]const u8,
proxy_icon_url: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/resources/channel#embed-object-embed-image-structure
@ -83,18 +83,18 @@ pub const EmbedImage = struct {
/// Source url of image (only supports http(s) and attachments)
url: []const u8,
/// A proxied url of the image
proxy_url: ?[]const u8,
proxy_url: ?[]const u8 = null,
/// Height of image
height: ?isize,
height: ?isize = null,
/// Width of image
width: ?isize,
width: ?isize = null,
};
pub const EmbedProvider = struct {
/// Name of provider
name: ?[]const u8,
name: ?[]const u8 = null,
/// Url of provider
url: ?[]const u8,
url: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/resources/channel#embed-object-embed-thumbnail-structure
@ -102,21 +102,21 @@ pub const EmbedThumbnail = struct {
/// Source url of thumbnail (only supports http(s) and attachments)
url: []const u8,
/// A proxied url of the thumbnail
proxy_url: ?[]const u8,
proxy_url: ?[]const u8 = null,
/// Height of thumbnail
height: ?isize,
height: ?isize = null,
/// Width of thumbnail
width: ?isize,
width: ?isize = null,
};
/// https://discord.com/developers/docs/resources/channel#embed-object-embed-video-structure
pub const EmbedVideo = struct {
/// Source url of video
url: ?[]const u8,
url: ?[]const u8 = null,
/// A proxied url of the video
proxy_url: ?[]const u8,
proxy_url: ?[]const u8 = null,
/// Height of video
height: ?isize,
height: ?isize = null,
/// Width of video
width: ?isize,
width: ?isize = null,
};

16
src/structures/emoji.zig
View File

@ -20,19 +20,19 @@ const User = @import("user.zig").User;
/// https://discord.com/developers/docs/resources/emoji#emoji-object-emoji-structure
pub const Emoji = struct {
/// Emoji name (can only be null in reaction emoji objects)
name: ?[]const u8,
name: ?[]const u8 = null,
/// Emoji id
id: ?Snowflake,
id: ?Snowflake = null,
/// Roles allowed to use this emoji
roles: ?[][]const u8,
roles: ?[][]const u8 = null,
/// User that created this emoji
user: ?User,
user: ?User = null,
/// Whether this emoji must be wrapped in colons
require_colons: ?bool,
require_colons: ?bool = null,
/// Whether this emoji is managed
managed: ?bool,
managed: ?bool = null,
/// Whether this emoji is animated
animated: ?bool,
animated: ?bool = null,
/// Whether this emoji can be used, may be false due to loss of Server Boosts
available: ?bool,
available: ?bool = null,
};

246
src/structures/events.zig
View File

@ -57,21 +57,21 @@ pub const GuildMembersChunk = struct {
/// The total isize of expected chunks for this response
chunk_count: isize,
/// If passing an invalid id to `REQUEST_GUILD_MEMBERS`, it will be returned here
not_found: ?[][]const u8,
not_found: ?[][]const u8 = null,
/// If passing true to `REQUEST_GUILD_MEMBERS`, presences of the returned members will be here
presences: ?[]PresenceUpdate,
presences: ?[]PresenceUpdate = null,
/// The nonce used in the Guild Members Request
nonce: ?[]const u8,
nonce: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/topics/gateway#channel-pins-update
pub const ChannelPinsUpdate = struct {
/// The id of the guild
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// The id of the channel
channel_id: Snowflake,
/// The time at which the most recent pinned message was pinned
last_pin_timestamp: ?[]const u8,
last_pin_timestamp: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/topics/gateway#guild-role-delete
@ -99,11 +99,11 @@ pub const MessageReactionRemove = struct {
/// The id of the message
message_id: Snowflake,
/// The id of the guild
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// The emoji used to react
emoji: Partial(Emoji),
/// The id of the author of this message
message_author_id: ?Snowflake,
message_author_id: ?Snowflake = null,
/// true if this is a super-reaction
burst: bool,
/// The type of reaction
@ -119,17 +119,17 @@ pub const MessageReactionAdd = struct {
/// The id of the message
message_id: Snowflake,
/// The id of the guild
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// The member who reacted if this happened in a guild
member: ?MemberWithUser,
member: ?MemberWithUser = null,
/// The emoji used to react
emoji: Partial(Emoji),
/// The id of the author of this message
message_author_id: ?Snowflake,
message_author_id: ?Snowflake = null,
/// true if this is a super-reaction
burst: bool,
/// Colors used for super-reaction animation in "#rrggbb" format
burst_colors: ?[][]const u8,
burst_colors: ?[][]const u8 = null,
/// The type of reaction
type: ReactionType,
};
@ -141,7 +141,7 @@ pub const VoiceServerUpdate = struct {
/// The guild this voice server update is for
guild_id: Snowflake,
/// The voice server host
endpoint: ?[]const u8,
endpoint: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/topics/gateway-events#voice-channel-effect-send-voice-channel-effect-send-event-fields
@ -153,18 +153,18 @@ pub const VoiceChannelEffectSend = struct {
/// ID of the user who sent the effect
user_id: Snowflake,
/// The emoji sent, for emoji reaction and soundboard effects
emoji: ?Emoji,
emoji: ?Emoji = null,
/// The type of emoji animation, for emoji reaction and soundboard effects
animation_type: ?VoiceChannelEffectAnimationType,
animation_type: ?VoiceChannelEffectAnimationType = null,
/// The ID of the emoji animation, for emoji reaction and soundboard effects
animation_id: ?isize,
animation_id: ?isize = null,
/// The ID of the soundboard sound, for soundboard effects
sound_id: union {
string: ?[]const u8,
integer: isize,
},
/// The volume of the soundboard sound, from 0 to 1, for soundboard effects
sound_volume: ?isize,
sound_volume: ?isize = null,
};
/// https://discord.com/developers/docs/topics/gateway-events#voice-channel-effect-send-animation-types
@ -184,9 +184,9 @@ pub const InviteCreate = struct {
/// The time at which the invite was created
created_at: []const u8,
/// The guild of the invite
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// The user that created the invite
inviter: ?User,
inviter: ?User = null,
/// How long the invite is valid for (in seconds)
max_age: isize,
/// The maximum isize of times the invite can be used
@ -194,9 +194,9 @@ pub const InviteCreate = struct {
/// The type of target for this voice channel invite
target_type: TargetTypes,
/// The target user for this invite
target_user: ?User,
target_user: ?User = null,
/// The embedded application to open for this voice channel embedded application invite
target_application: ?Partial(Application),
target_application: ?Partial(Application) = null,
/// Whether or not the invite is temporary (invited users will be kicked on disconnect unless they're assigned a role)
temporary: bool,
/// How many times the invite has been used (always will be 0)
@ -222,7 +222,7 @@ pub const Ready = struct {
/// Gateway url for resuming connections
resume_gateway_url: []const u8,
/// The shard information associated with this session, if sent when identifying
shard: ?[2]isize,
shard: ?[2]isize = null,
/// Contains id and flags, only sent to bots
application: ?struct {
flags: ApplicationFlags,
@ -232,7 +232,7 @@ pub const Ready = struct {
/// https://discord.com/developers/docs/resources/guild#unavailable-guild-object
pub const UnavailableGuild = struct {
unavailable: ?bool,
unavailable: ?bool = null,
id: Snowflake,
};
@ -243,7 +243,7 @@ pub const MessageDeleteBulk = struct {
/// The id of the channel
channel_id: Snowflake,
/// The id of the guild
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
};
/// https://discord.com/developers/docs/resources/template#template-object-template-structure
@ -253,7 +253,7 @@ pub const Template = struct {
/// Template name
name: []const u8,
/// The description for the template
description: ?[]const u8,
description: ?[]const u8 = null,
/// isize of times this template has been used
usage_count: isize,
/// The Id of the user who created the template
@ -268,7 +268,7 @@ pub const Template = struct {
source_guild_id: Snowflake,
/// The guild snapshot this template contains
serialized_source_guild: TemplateSerializedSourceGuild,
is_dirty: ?bool,
is_dirty: ?bool = null,
};
pub const TemplateSerializedSourceGuild = null;
@ -276,29 +276,29 @@ pub const TemplateSerializedSourceGuild = null;
/// https://discord.com/developers/docs/topics/gateway#guild-member-add
pub const GuildMemberAdd = struct {
/// Whether the user is deafened in voice channels
deaf: ?bool,
deaf: ?bool = null,
/// Whether the user is muted in voice channels
mute: ?bool,
mute: ?bool = null,
/// Whether the user has not yet passed the guild's Membership Screening requirements
pending: ?bool,
pending: ?bool = null,
/// This users guild nickname
nick: ?[]const u8,
nick: ?[]const u8 = null,
/// The members custom avatar for this server.
avatar: ?[]const u8,
avatar: ?[]const u8 = null,
/// Array of role object ids
roles: [][]const u8,
/// When the user joined the guild
joined_at: []const u8,
/// When the user started boosting the guild
premium_since: ?[]const u8,
premium_since: ?[]const u8 = null,
/// The permissions this member has in the guild. Only present on interaction events and OAuth2 current member fetch.
permissions: ?[]const u8,
permissions: ?[]const u8 = null,
/// when the user's timeout will expire and the user will be able to communicate in the guild again (set null to remove timeout), null or a time in the past if the user is not timed out
communication_disabled_until: ?[]const u8,
communication_disabled_until: ?[]const u8 = null,
/// Guild member flags
flags: isize,
/// data for the member's guild avatar decoration
avatar_decoration_data: ?AvatarDecorationData,
avatar_decoration_data: ?AvatarDecorationData = null,
/// The user object for this member
user: User,
/// id of the guild
@ -312,7 +312,7 @@ pub const MessageDelete = struct {
/// The id of the channel
channel_id: Snowflake,
/// The id of the guild
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
};
/// https://discord.com/developers/docs/topics/gateway#thread-members-update-thread-members-update-event-fields
@ -322,9 +322,9 @@ pub const ThreadMembersUpdate = struct {
/// The id of the guild
guild_id: Snowflake,
/// The users who were added to the thread
added_members: ?[]ThreadMember,
added_members: ?[]ThreadMember = null,
/// The id of the users who were removed from the thread
removed_member_ids: ?[][]const u8,
removed_member_ids: ?[][]const u8 = null,
/// the approximate isize of members in the thread, capped at 50
member_count: isize,
};
@ -374,32 +374,32 @@ pub const GuildMemberUpdate = struct {
/// The user
user: User,
/// Nickname of the user in the guild
nick: ?[]const u8,
nick: ?[]const u8 = null,
/// the member's [guild avatar hash](https://discord.com/developers/docs/reference#image-formatting)
avatar: []const u8,
/// When the user joined the guild
joined_at: []const u8,
/// When the user starting boosting the guild
premium_since: ?[]const u8,
premium_since: ?[]const u8 = null,
/// whether the user is deafened in voice channels
deaf: ?bool,
deaf: ?bool = null,
/// whether the user is muted in voice channels
mute: ?bool,
mute: ?bool = null,
/// Whether the user has not yet passed the guild's Membership Screening requirements
pending: ?bool,
pending: ?bool = null,
/// when the user's [timeout](https://support.discord.com/hc/en-us/articles/4413305239191-Time-Out-FAQ) will expire and the user will be able to communicate in the guild again, null or a time in the past if the user is not timed out. Will throw a 403 error if the user has the ADMINISTRATOR permission or is the owner of the guild
communication_disabled_until: ?[]const u8,
communication_disabled_until: ?[]const u8 = null,
/// Data for the member's guild avatar decoration
avatar_decoration_data: ?AvatarDecorationData,
avatar_decoration_data: ?AvatarDecorationData = null,
/// Guild member flags
flags: ?isize,
flags: ?isize = null,
};
/// https://discord.com/developers/docs/topics/gateway#message-reaction-remove-all
pub const MessageReactionRemoveAll = struct {
channel_id: Snowflake,
message_id: Snowflake,
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
};
/// https://discord.com/developers/docs/topics/gateway#guild-role-update
@ -423,7 +423,7 @@ pub const ScheduledEventUserAdd = struct {
pub const MessageReactionRemoveEmoji = struct {
channel_id: Snowflake,
message_id: Snowflake,
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
emoji: Emoji,
};
@ -438,7 +438,7 @@ pub const GuildMemberRemove = struct {
/// https://discord.com/developers/docs/resources/guild#ban-object
pub const Ban = struct {
/// The reason for the ban
reason: ?[]const u8,
reason: ?[]const u8 = null,
/// The banned user
user: User,
};
@ -457,7 +457,7 @@ pub const InviteDelete = struct {
/// The channel of the invite
channel_id: Snowflake,
/// The guild of the invite
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// The unique invite code
code: []const u8,
};
@ -480,7 +480,7 @@ pub const GuildWidgetSettings = struct {
/// whether the widget is enabled
enabled: bool,
/// the widget channel id
channel_id: ?Snowflake,
channel_id: ?Snowflake = null,
};
pub const ForumTag = struct {
@ -493,49 +493,49 @@ pub const ForumTag = struct {
/// The id of a guild's custom emoji At most one of emoji_id and emoji_name may be set.
emoji_id: Snowflake,
/// The unicode character of the emoji
emoji_name: ?[]const u8,
emoji_name: ?[]const u8 = null,
};
pub const DefaultReactionEmoji = struct {
/// The id of a guild's custom emoji
emoji_id: Snowflake,
/// The unicode character of the emoji
emoji_name: ?[]const u8,
emoji_name: ?[]const u8 = null,
};
pub const ModifyChannel = struct {
/// 1-100 character channel name
name: ?[]const u8,
name: ?[]const u8 = null,
/// The type of channel; only conversion between text and news is supported and only in guilds with the "NEWS" feature
type: ?ChannelTypes,
type: ?ChannelTypes = null,
/// The position of the channel in the left-hand listing
position: ?isize,
position: ?isize = null,
/// 0-1024 character channel topic
topic: ?[]const u8,
topic: ?[]const u8 = null,
/// Whether the channel is nsfw
nsfw: ?bool,
nsfw: ?bool = null,
/// Amount of seconds a user has to wait before sending another message (0-21600); bots, as well as users with the permission `manage_messages` or `manage_channel`, are unaffected
rate_limit_per_user: ?isize,
rate_limit_per_user: ?isize = null,
/// The bitrate (in bits) of the voice channel; 8000 to 96000 (128000 for VIP servers)
bitrate: ?isize,
bitrate: ?isize = null,
/// The user limit of the voice channel; 0 refers to no limit, 1 to 99 refers to a user limit
user_limit: ?isize,
user_limit: ?isize = null,
/// Channel or category-specific permissions
permission_overwrites: ?[]Overwrite,
permission_overwrites: ?[]Overwrite = null,
/// Id of the new parent category for a channel
parent_id: ?Snowflake,
parent_id: ?Snowflake = null,
/// Voice region id for the voice channel, automatic when set to null
rtc_region: ?[]const u8,
rtc_region: ?[]const u8 = null,
/// The camera video quality mode of the voice channel
video_quality_mode: ?VideoQualityModes,
video_quality_mode: ?VideoQualityModes = null,
/// Whether the thread is archived
archived: ?bool,
archived: ?bool = null,
/// Duration in minutes to automatically archive the thread after recent activity
auto_archive_duration: ?isize,
auto_archive_duration: ?isize = null,
/// When a thread is locked, only users with `MANAGE_THREADS` can unarchive it
locked: ?bool,
locked: ?bool = null,
/// whether non-moderators can add other non-moderators to a thread; only available on private threads
invitable: ?bool,
invitable: ?bool = null,
/// The set of tags that can be used in a GUILD_FORUM channel
available_tags: []struct {
/// The id of the tag
@ -550,20 +550,20 @@ pub const ModifyChannel = struct {
emoji_name: []const u8,
},
/// The IDs of the set of tags that have been applied to a thread in a GUILD_FORUM channel; limited to 5
applied_tags: ?[][]const u8,
applied_tags: ?[][]const u8 = null,
/// the emoji to show in the add reaction button on a thread in a GUILD_FORUM channel
default_reaction_emoji: ?struct {
/// The id of a guild's custom emoji
emoji_id: Snowflake,
/// The unicode character of the emoji
emoji_name: ?[]const u8,
emoji_name: ?[]const u8 = null,
},
/// the initial rate_limit_per_user to set on newly created threads in a channel. this field is copied to the thread at creation time and does not live update.
default_thread_rate_limit_per_user: ?isize,
default_thread_rate_limit_per_user: ?isize = null,
/// the default sort order type used to order posts in forum channels
default_sort_order: ?SortOrderTypes,
default_sort_order: ?SortOrderTypes = null,
/// the default forum layout view used to display posts in `GUILD_FORUM` channels. Defaults to `0`, which indicates a layout view has not been set by a channel admin
default_forum_layout: ?ForumLayout,
default_forum_layout: ?ForumLayout = null,
};
/// https://discord.com/developers/docs/resources/emoji#create-guild-emoji
@ -573,46 +573,46 @@ pub const CreateGuildEmoji = struct {
///The 128x128 emoji image. Emojis and animated emojis have a maximum file size of 256kb. Attempting to upload an emoji larger than this limit will fail and return 400 Bad Request and an error message, but not a JSON status code. If a URL is provided to the image parameter, eno will automatically convert it to a base64 []const u8 internally.
image: []const u8,
/// Roles allowed to use this emoji
roles: ?[][]const u8,
roles: ?[][]const u8 = null,
};
/// https://discord.com/developers/docs/resources/emoji#modify-guild-emoji
pub const ModifyGuildEmoji = struct {
/// Name of the emoji
name: ?[]const u8,
name: ?[]const u8 = null,
/// Roles allowed to use this emoji
roles: ?[][]const u8,
roles: ?[][]const u8 = null,
};
pub const CreateGuildChannel = struct {
/// Channel name (1-100 characters)
name: []const u8,
/// The type of channel
type: ?ChannelTypes,
type: ?ChannelTypes = null,
/// Channel topic (0-1024 characters)
topic: ?[]const u8,
topic: ?[]const u8 = null,
/// The bitrate (in bits) of the voice channel (voice only)
bitrate: ?isize,
bitrate: ?isize = null,
/// The user limit of the voice channel (voice only)
user_limit: ?isize,
user_limit: ?isize = null,
/// Amount of seconds a user has to wait before sending another message (0-21600); bots, as well as users with the permission `manage_messages` or `manage_channel`, are unaffected
rate_limit_per_user: ?isize,
rate_limit_per_user: ?isize = null,
/// Sorting position of the channel
position: ?isize,
position: ?isize = null,
/// The channel's permission overwrites
permission_overwrites: ?[]Overwrite,
permission_overwrites: ?[]Overwrite = null,
/// Id of the parent category for a channel
parent_id: ?Snowflake,
parent_id: ?Snowflake = null,
/// Whether the channel is nsfw
nsfw: ?bool,
nsfw: ?bool = null,
/// Default duration (in minutes) that clients (not the API) use for newly created threads in this channel, to determine when to automatically archive the thread after the last activity
default_auto_archive_duration: ?isize,
default_auto_archive_duration: ?isize = null,
/// Emoji to show in the add reaction button on a thread in a forum channel
default_reaction_emoji: ?struct {
/// The id of a guild's custom emoji. Exactly one of `emojiId` and `emojiName` must be set.
emoji_id: ?Snowflake,
emoji_id: ?Snowflake = null,
/// The unicode character of the emoji. Exactly one of `emojiId` and `emojiName` must be set.
emoji_name: ?[]const u8,
emoji_name: ?[]const u8 = null,
},
/// Set of tags that can be used in a forum channel
available_tags: ?[]struct {
@ -625,55 +625,55 @@ pub const CreateGuildChannel = struct {
/// The id of a guild's custom emoji
emoji_id: Snowflake,
/// The unicode character of the emoji
emoji_name: ?[]const u8,
emoji_name: ?[]const u8 = null,
},
/// the default sort order type used to order posts in forum channels
default_sort_order: ?SortOrderTypes,
default_sort_order: ?SortOrderTypes = null,
};
pub const CreateMessage = struct {
attachments: []Partial(Attachment),
/// The message contents (up to 2000 characters)
content: ?[]const u8,
content: ?[]const u8 = null,
/// Can be used to verify a message was sent (up to 25 characters). Value will appear in the Message Create event.
nonce: ?union(enum) {
string: ?[]const u8,
integer: isize,
},
/// true if this is a TTS message
tts: ?bool,
tts: ?bool = null,
/// Embedded `rich` content (up to 6000 characters)
embeds: ?[]Embed,
embeds: ?[]Embed = null,
/// Allowed mentions for the message
allowed_mentions: ?AllowedMentions,
allowed_mentions: ?AllowedMentions = null,
/// Include to make your message a reply
message_reference: ?struct {
/// id of the originating message
message_id: ?Snowflake,
message_id: ?Snowflake = null,
///
/// id of the originating message's channel
/// Note: `channel_id` is optional when creating a reply, but will always be present when receiving an event/response that includes this data model.,
///
channel_id: ?Snowflake,
channel_id: ?Snowflake = null,
/// id of the originating message's guild
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// When sending, whether to error if the referenced message doesn't exist instead of sending as a normal (non-reply) message, default true
fail_if_not_exists: bool,
},
/// The components you would like to have sent in this message
components: ?[]MessageComponent,
components: ?[]MessageComponent = null,
/// IDs of up to 3 stickers in the server to send in the message
stickerIds: ?[][]const u8,
stickerIds: ?[][]const u8 = null,
};
/// https://discord.com/developers/docs/resources/guild#modify-guild-welcome-screen
pub const ModifyGuildWelcomeScreen = struct {
/// Whether the welcome screen is enabled
enabled: ?bool,
enabled: ?bool = null,
/// Channels linked in the welcome screen and their display options
welcome_screen: ?[]WelcomeScreenChannel,
welcome_screen: ?[]WelcomeScreenChannel = null,
/// The server description to show in the welcome screen
description: ?[]const u8,
description: ?[]const u8 = null,
};
pub const FollowAnnouncementChannel = struct {
@ -695,18 +695,18 @@ pub const ModifyGuildChannelPositions = struct {
/// Channel id
id: Snowflake,
/// Sorting position of the channel
position: ?isize,
position: ?isize = null,
/// Syncs the permission overwrites with the new parent, if moving to a new category
lock_positions: ?bool,
lock_positions: ?bool = null,
/// The new parent ID for the channel that is moved
parent_id: ?Snowflake,
parent_id: ?Snowflake = null,
};
pub const CreateWebhook = struct {
/// Name of the webhook (1-80 characters)
name: []const u8,
/// Image url for the default webhook avatar
avatar: ?[]const u8,
avatar: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/resources/channel#start-thread-in-forum-channel
@ -714,30 +714,30 @@ pub const CreateForumPostWithMessage = struct {
/// 1-100 character channel name
name: []const u8,
/// duration in minutes to automatically archive the thread after recent activity, can be set to: 60, 1440, 4320, 10080,
auto_archive_duration: ?isize,
auto_archive_duration: ?isize = null,
/// amount of seconds a user has to wait before sending another message (0-21600)
rate_limit_per_user: ?isize,
rate_limit_per_user: ?isize = null,
/// contents of the first message in the forum thread
message: struct {
/// Message contents (up to 2000 characters)
content: ?[]const u8,
content: ?[]const u8 = null,
/// Embedded rich content (up to 6000 characters)
embeds: ?[]Embed,
embeds: ?[]Embed = null,
/// Allowed mentions for the message
allowed_mentions: ?[]AllowedMentions,
allowed_mentions: ?[]AllowedMentions = null,
/// Components to include with the message
components: ?[][]MessageComponent,
components: ?[][]MessageComponent = null,
/// IDs of up to 3 stickers in the server to send in the message
sticker_ids: ?[][]const u8,
sticker_ids: ?[][]const u8 = null,
/// JSON-encoded body of non-file params, only for multipart/form-data requests. See {@link https://discord.com/developers/docs/reference#uploading-files Uploading Files};
payload_json: ?[]const u8,
payload_json: ?[]const u8 = null,
/// Attachment objects with filename and description. See {@link https://discord.com/developers/docs/reference#uploading-files Uploading Files};
attachments: ?[]Attachment,
attachments: ?[]Attachment = null,
/// Message flags combined as a bitfield, only SUPPRESS_EMBEDS can be set
flags: ?MessageFlags,
flags: ?MessageFlags = null,
},
/// the IDs of the set of tags that have been applied to a thread in a GUILD_FORUM channel
applied_tags: ?[][]const u8,
applied_tags: ?[][]const u8 = null,
};
pub const ArchivedThreads = struct {
@ -752,7 +752,7 @@ pub const ActiveThreads = struct {
};
pub const VanityUrl = struct {
code: ?[]const u8,
code: ?[]const u8 = null,
uses: isize,
};
@ -806,32 +806,32 @@ pub const GuildOnboardingPromptOption = struct {
/// @remarks
/// When creating or updating a prompt option, the `emoji_id`, `emoji_name`, and `emoji_animated` fields must be used instead of the emoji object.
///
emoji: ?Emoji,
emoji: ?Emoji = null,
///
/// Emoji ID of the option
///
/// @remarks
/// When creating or updating a prompt option, the `emoji_id`, `emoji_name`, and `emoji_animated` fields must be used instead of the emoji object.
///
emoji_id: ?Snowflake,
emoji_id: ?Snowflake = null,
///
/// Emoji name of the option
///
/// @remarks
/// When creating or updating a prompt option, the `emoji_id`, `emoji_name`, and `emoji_animated` fields must be used instead of the emoji object.
///
emoji_name: ?[]const u8,
emoji_name: ?[]const u8 = null,
///
/// Whether the emoji is animated
///
/// @remarks
/// When creating or updating a prompt option, the `emoji_id`, `emoji_name`, and `emoji_animated` fields must be used instead of the emoji object.
///
emoji_animated: ?bool,
emoji_animated: ?bool = null,
/// Title of the option
title: []const u8,
/// Description of the option
description: ?[]const u8,
description: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/resources/guild#guild-onboarding-object-prompt-types

58
src/structures/gateway.zig
View File

@ -67,32 +67,32 @@ pub const Activity = struct {
/// Activity type
type: ActivityTypes,
/// Stream url, is validated when type is 1
url: ?[]const u8,
url: ?[]const u8 = null,
/// Unix timestamp of when the activity was added to the user's session
created_at: isize,
/// What the player is currently doing
details: ?[]const u8,
details: ?[]const u8 = null,
/// The user's current party status
state: ?[]const u8,
state: ?[]const u8 = null,
/// Whether or not the activity is an instanced game session
instance: ?bool,
instance: ?bool = null,
/// Activity flags `OR`d together, describes what the payload includes
flags: ?isize,
flags: ?isize = null,
/// Unix timestamps for start and/or end of the game
timestamps: ?ActivityTimestamps,
timestamps: ?ActivityTimestamps = null,
/// Application id for the game
/// a string
application_id: ?[]const u8,
application_id: ?[]const u8 = null,
/// The emoji used for a custom status
emoji: ?ActivityEmoji,
emoji: ?ActivityEmoji = null,
/// Information for the current party of the player
party: ?ActivityParty,
party: ?ActivityParty = null,
/// Images for the presence and their hover texts
assets: ?ActivityAssets,
assets: ?ActivityAssets = null,
/// Secrets for Rich Presence joining and spectating
secrets: ?ActivitySecrets,
secrets: ?ActivitySecrets = null,
/// The custom buttons shown in the Rich Presence (max 2)
buttons: ?[]ActivityButton,
buttons: ?[]ActivityButton = null,
};
/// https://discord.com/developers/docs/resources/application#get-application-activity-instance-activity-instance-object
@ -122,7 +122,7 @@ pub const ActivityLocation = struct {
/// The id of the Channel
channel_id: Snowflake,
/// The id of the Guild
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
};
/// https://discord.com/developers/docs/resources/application#get-application-activity-instance-activity-location-kind-enum
@ -136,19 +136,19 @@ pub const ActivityLocationKind = union(enum) {
/// https://discord.com/developers/docs/topics/gateway#client-status-object
pub const ClientStatus = struct {
/// The user's status set for an active desktop (Windows, Linux, Mac) application session
desktop: ?[]const u8,
desktop: ?[]const u8 = null,
/// The user's status set for an active mobile (iOS, Android) application session
mobile: ?[]const u8,
mobile: ?[]const u8 = null,
/// The user's status set for an active web (browser, bot account) application session
web: ?[]const u8,
web: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/topics/gateway#activity-object-activity-timestamps
pub const ActivityTimestamps = struct {
/// Unix time (in milliseconds) of when the activity started
start: ?isize,
start: ?isize = null,
/// Unix time (in milliseconds) of when the activity ends
end: ?isize,
end: ?isize = null,
};
/// https://discord.com/developers/docs/topics/gateway#activity-object-activity-emoji
@ -156,40 +156,40 @@ pub const ActivityEmoji = struct {
/// The name of the emoji
name: []const u8,
/// Whether this emoji is animated
animated: ?bool,
animated: ?bool = null,
/// The id of the emoji
/// a string
id: ?[]const u8,
id: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/topics/gateway#activity-object-activity-party
pub const ActivityParty = struct {
/// Used to show the party's current and maximum size
size: ?[2]i64,
size: ?[2]i64 = null,
/// The id of the party
id: ?Snowflake,
id: ?Snowflake = null,
};
/// https://discord.com/developers/docs/topics/gateway#activity-object-activity-assets
pub const ActivityAssets = struct {
/// Text displayed when hovering over the large image of the activity
large_text: ?[]const u8,
large_text: ?[]const u8 = null,
/// Text displayed when hovering over the small image of the activity
small_text: ?[]const u8,
small_text: ?[]const u8 = null,
/// The id for a large asset of the activity, usually a snowflake
large_image: ?[]const u8,
large_image: ?[]const u8 = null,
/// The id for a small asset of the activity, usually a snowflake
small_image: ?[]const u8,
small_image: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/topics/gateway#activity-object-activity-secrets
pub const ActivitySecrets = struct {
/// The secret for joining a party
join: ?[]const u8,
join: ?[]const u8 = null,
/// The secret for spectating a game
spectate: ?[]const u8,
spectate: ?[]const u8 = null,
/// The secret for a specific instanced match
match: ?[]const u8,
match: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/topics/gateway#activity-object-activity-buttons

166
src/structures/guild.zig
View File

@ -39,11 +39,11 @@ pub const Guild = struct {
/// Guild name (2-100 characters, excluding trailing and leading whitespace)
name: []const u8,
/// True if the user is the owner of the guild
owner: ?bool,
owner: ?bool = null,
/// Afk timeout in seconds
afk_timeout: isize,
/// True if the server widget is enabled
widget_enabled: ?bool,
widget_enabled: ?bool = null,
/// Verification level required for the guild
verification_level: VerificationLevels,
/// Default message notifications level
@ -57,31 +57,31 @@ pub const Guild = struct {
/// System channel flags
system_channel_flags: SystemChannelFlags,
/// True if this is considered a large guild
large: ?bool,
large: ?bool = null,
/// True if this guild is unavailable due to an outage
unavailable: ?bool,
unavailable: ?bool = null,
/// Total isize of members in this guild
member_count: ?isize,
member_count: ?isize = null,
/// The maximum isize of presences for the guild (the default value, currently 25000, is in effect when null is returned)
max_presences: ?isize,
max_presences: ?isize = null,
/// The maximum isize of members for the guild
max_members: ?isize,
max_members: ?isize = null,
/// The vanity url code for the guild
vanity_url_code: ?[]const u8,
vanity_url_code: ?[]const u8 = null,
/// The description of a guild
description: ?[]const u8,
description: ?[]const u8 = null,
/// Premium tier (Server Boost level)
premium_tier: PremiumTiers,
/// The isize of boosts this guild currently has
premium_subscription_count: ?isize,
premium_subscription_count: ?isize = null,
/// The maximum amount of users in a video channel
max_video_channel_users: ?isize,
max_video_channel_users: ?isize = null,
/// Maximum amount of users in a stage video channel
max_stage_video_channel_users: ?isize,
max_stage_video_channel_users: ?isize = null,
/// Approximate isize of members in this guild, returned from the GET /guilds/id endpoint when with_counts is true
approximate_member_count: ?isize,
approximate_member_count: ?isize = null,
/// Approximate isize of non-offline members in this guild, returned from the GET /guilds/id endpoint when with_counts is true
approximate_presence_count: ?isize,
approximate_presence_count: ?isize = null,
/// Guild NSFW level
nsfw_level: GuildNsfwLevel,
/// Whether the guild has the boost progress bar enabled
@ -89,57 +89,57 @@ pub const Guild = struct {
/// Guild id
id: Snowflake,
/// Icon hash
icon: ?[]const u8,
icon: ?[]const u8 = null,
/// Icon hash, returned when in the template object
icon_hash: ?[]const u8,
icon_hash: ?[]const u8 = null,
/// Splash hash
splash: ?[]const u8,
splash: ?[]const u8 = null,
/// Discovery splash hash; only present for guilds with the "DISCOVERABLE" feature
discovery_splash: ?[]const u8,
discovery_splash: ?[]const u8 = null,
/// Id of the owner
owner_id: Snowflake,
/// Total permissions for the user in the guild (excludes overwrites and implicit permissions)
permissions: ?[]const u8,
permissions: ?[]const u8 = null,
/// Id of afk channel
afk_channel_id: ?Snowflake,
afk_channel_id: ?Snowflake = null,
/// The channel id that the widget will generate an invite to, or null if set to no invite
widget_channel_id: ?Snowflake,
widget_channel_id: ?Snowflake = null,
/// Roles in the guild
roles: []Role,
/// Custom guild emojis
emojis: []Emoji,
/// Application id of the guild creator if it is bot-created
application_id: ?Snowflake,
application_id: ?Snowflake = null,
/// The id of the channel where guild notices such as welcome messages and boost events are posted
system_channel_id: ?Snowflake,
system_channel_id: ?Snowflake = null,
/// The id of the channel where community guilds can display rules and/or guidelines
rules_channel_id: ?Snowflake,
rules_channel_id: ?Snowflake = null,
/// When this guild was joined at
joined_at: ?[]const u8,
joined_at: ?[]const u8 = null,
// States of members currently in voice channels; lacks the guild_id key
// voice_states: ?[]Omit(VoiceState, .{"guildId"}),
// voice_states: ?[]Omit(VoiceState, .{"guildId"}) = null,
/// Users in the guild
members: ?[]Member,
members: ?[]Member = null,
/// Channels in the guild
channels: ?[]Channel,
channels: ?[]Channel = null,
/// All active threads in the guild that the current user has permission to view
threads: ?[]Channel,
threads: ?[]Channel = null,
/// Presences of the members in the guild, will only include non-offline members if the size is greater than large threshold
presences: ?[]Partial(PresenceUpdate),
presences: ?[]Partial(PresenceUpdate) = null,
/// Banner hash
banner: ?[]const u8,
banner: ?[]const u8 = null,
///The preferred locale of a Community guild; used in server discovery and notices from ; defaults to "en-US"
preferred_locale: []const u8,
///The id of the channel where admins and moderators of Community guilds receive notices from
public_updates_channel_id: ?Snowflake,
public_updates_channel_id: ?Snowflake = null,
/// The welcome screen of a Community guild, shown to new members, returned in an Invite's guild object
welcome_screen: ?WelcomeScreen,
welcome_screen: ?WelcomeScreen = null,
/// Stage instances in the guild
stage_instances: ?[]StageInstance,
stage_instances: ?[]StageInstance = null,
/// Custom guild stickers
stickers: ?[]Sticker,
stickers: ?[]Sticker = null,
///The id of the channel where admins and moderators of Community guilds receive safety alerts from
safety_alerts_channel_id: ?Snowflake,
safety_alerts_channel_id: ?Snowflake = null,
};
/// https://discord.com/developers/docs/resources/voice#voice-state-object-voice-state-structure
@ -147,13 +147,13 @@ pub const VoiceState = struct {
/// The session id for this voice state
session_id: []const u8,
/// The guild id this voice state is for
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// The channel id this user is connected to
channel_id: ?Snowflake,
channel_id: ?Snowflake = null,
/// The user id this voice state is for
user_id: Snowflake,
/// The guild member this voice state is for
member: ?MemberWithUser,
member: ?MemberWithUser = null,
/// Whether this user is deafened by the server
deaf: bool,
/// Whether this user is muted by the server
@ -163,13 +163,13 @@ pub const VoiceState = struct {
/// Whether this user is locally muted
self_mute: bool,
/// Whether this user is streaming using "Go Live"
self_stream: ?bool,
self_stream: ?bool = null,
/// Whether this user's camera is enabled
self_video: bool,
/// Whether this user is muted by the current user
suppress: bool,
/// The time at which the user requested to speak
request_to_speak_timestamp: ?[]const u8,
request_to_speak_timestamp: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/resources/guild#get-guild-widget-example-get-guild-widget
@ -186,7 +186,7 @@ pub const GuildWidget = struct {
id: Snowflake,
username: []const u8,
discriminator: []const u8,
avatar: ?[]const u8,
avatar: ?[]const u8 = null,
status: []const u8,
avatar_url: []const u8,
},
@ -200,11 +200,11 @@ pub const GuildPreview = struct {
/// Guild name (2-100 characters)
name: []const u8,
/// Icon hash
icon: ?[]const u8,
icon: ?[]const u8 = null,
/// Splash hash
splash: ?[]const u8,
splash: ?[]const u8 = null,
/// Discovery splash hash
discovery_splash: ?[]const u8,
discovery_splash: ?[]const u8 = null,
/// Custom guild emojis
emojis: []Emoji,
/// Enabled guild features
@ -214,7 +214,7 @@ pub const GuildPreview = struct {
/// Approximate isize of online members in this guild
approximate_presence_count: isize,
/// The description for the guild, if the guild is discoverable
description: ?[]const u8,
description: ?[]const u8 = null,
/// Custom guild stickers
stickers: []Sticker,
};
@ -224,90 +224,90 @@ pub const CreateGuild = struct {
/// Name of the guild (1-100 characters)
name: []const u8,
/// Base64 128x128 image for the guild icon
icon: ?[]const u8,
icon: ?[]const u8 = null,
/// Verification level
verification_level: ?VerificationLevels,
verification_level: ?VerificationLevels = null,
/// Default message notification level
default_message_notifications: DefaultMessageNotificationLevels,
/// Explicit content filter level
explicit_content_filter: ?ExplicitContentFilterLevels,
explicit_content_filter: ?ExplicitContentFilterLevels = null,
/// New guild roles (first role is the everyone role)
roles: ?[]Role,
roles: ?[]Role = null,
/// New guild's channels
channels: ?[]Partial(Channel),
channels: ?[]Partial(Channel) = null,
/// Id for afk channel
afk_channel_id: ?[]const u8,
afk_channel_id: ?[]const u8 = null,
/// Afk timeout in seconds
afk_timeout: ?isize,
afk_timeout: ?isize = null,
/// The id of the channel where guild notices such as welcome messages and boost events are posted
system_channel_id: ?[]const u8,
system_channel_id: ?[]const u8 = null,
/// System channel flags
system_channel_flags: ?SystemChannelFlags,
system_channel_flags: ?SystemChannelFlags = null,
};
/// https://discord.com/developers/docs/resources/guild#modify-guild
pub const ModifyGuild = struct {
/// Guild name
name: ?[]const u8,
name: ?[]const u8 = null,
/// Verification level
verification_level: ?VerificationLevels,
verification_level: ?VerificationLevels = null,
/// Default message notification filter level
default_message_notifications: ?DefaultMessageNotificationLevels,
default_message_notifications: ?DefaultMessageNotificationLevels = null,
/// Explicit content filter level
explicit_content_filter: ?ExplicitContentFilterLevels,
explicit_content_filter: ?ExplicitContentFilterLevels = null,
/// Id for afk channel
afk_channel_id: ?Snowflake,
afk_channel_id: ?Snowflake = null,
/// Afk timeout in seconds
afk_timeout: ?isize,
afk_timeout: ?isize = null,
/// Base64 1024x1024 png/jpeg/gif image for the guild icon (can be animated gif when the server has the `ANIMATED_ICON` feature)
icon: ?[]const u8,
icon: ?[]const u8 = null,
/// User id to transfer guild ownership to (must be owner)
owner_id: ?Snowflake,
owner_id: ?Snowflake = null,
/// Base64 16:9 png/jpeg image for the guild splash (when the server has `INVITE_SPLASH` fe
splash: ?[]const u8,
splash: ?[]const u8 = null,
/// Base64 16:9 png/jpeg image for the guild discovery spash (when the server has the `DISCOVERABLE` feature)
discovery_splash: ?[]const u8,
discovery_splash: ?[]const u8 = null,
/// Base64 16:9 png/jpeg image for the guild banner (when the server has BANNER feature)
banner: ?[]const u8,
banner: ?[]const u8 = null,
/// The id of the channel where guild notices such as welcome messages and boost events are posted
system_channel_id: ?Snowflake,
system_channel_id: ?Snowflake = null,
/// System channel flags
system_channel_flags: ?SystemChannelFlags,
system_channel_flags: ?SystemChannelFlags = null,
/// The id of the channel where Community guilds display rules and/or guidelines
rules_channel_id: ?Snowflake,
rules_channel_id: ?Snowflake = null,
/// The id of the channel where admins and moderators of Community guilds receive notices from Discord
public_updates_channel_id: ?Snowflake,
public_updates_channel_id: ?Snowflake = null,
/// The preferred locale of a Community guild used in server discovery and notices from Discord; defaults to "en-US"
preferred_locale: ?[]const u8,
preferred_locale: ?[]const u8 = null,
/// Enabled guild features
features: ?[]GuildFeatures,
features: ?[]GuildFeatures = null,
/// Whether the guild's boost progress bar should be enabled
premium_progress_bar_enabled: ?bool,
premium_progress_bar_enabled: ?bool = null,
};
pub const CreateGuildBan = struct {
/// list of user ids to ban (max 200)
user_ids: []Snowflake,
/// number of seconds to delete messages for, between 0 and 604800 (7 days)
delete_message_seconds: ?isize,
delete_message_seconds: ?isize = null,
};
/// https://discord.com/developers/docs/resources/guild#get-guild-prune-count
pub const GetGuildPruneCountQuery = struct {
/// Number of days to count prune for (1 or more), default: 7
days: ?isize,
days: ?isize = null,
/// Role(s) to include, default: none
include_roles: ?[]Snowflake,
include_roles: ?[]Snowflake = null,
};
/// https://discord.com/developers/docs/resources/guild#begin-guild-prune
pub const BeginGuildPrune = struct {
/// Number of days to prune (1 or more), default: 7
days: ?isize,
days: ?isize = null,
/// Whether 'pruned' is returned, discouraged for large guilds, default: true
compute_prune_count: ?bool,
compute_prune_count: ?bool = null,
/// Role(s) ro include, default: none
include_roles: ?[]Snowflake,
include_roles: ?[]Snowflake = null,
};
/// https://discord.com/developers/docs/resources/guild#modify-guild-onboarding-json-params
@ -365,15 +365,15 @@ pub const GuildOnboardingPromptOption = struct {
/// Emoji of the option
/// @remarks
/// When creating or updating a prompt option, the `emoji_id`, `emoji_name`, and `emoji_animated` fields must be used instead of the emoji object.
emoji: ?Emoji,
emoji: ?Emoji = null,
/// Emoji ID of the option
/// @remarks
/// When creating or updating a prompt option, the `emoji_id`, `emoji_name`, and `emoji_animated` fields must be used instead of the emoji object.
emoji_id: ?[]const u8,
emoji_id: ?[]const u8 = null,
/// Emoji name of the option
/// @remarks
/// When creating or updating a prompt option, the `emoji_id`, `emoji_name`, and `emoji_animated` fields must be used instead of the emoji object.
emoji_name: ?[]const u8,
emoji_name: ?[]const u8 = null,
/// Whether the emoji is animated
/// @remarks
/// When creating or updating a prompt option, the `emoji_id`, `emoji_name`, and `emoji_animated` fields must be used instead of the emoji object.
@ -381,7 +381,7 @@ pub const GuildOnboardingPromptOption = struct {
/// Title of the option
title: []const u8,
/// Description of the option
description: ?[]const u8,
description: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/resources/guild#guild-onboarding-object-prompt-types

50
src/structures/integration.zig
View File

@ -32,29 +32,29 @@ pub const Integration = struct {
discord,
},
/// Is this integration enabled
enabled: ?bool,
enabled: ?bool = null,
/// Is this integration syncing
syncing: ?bool,
syncing: ?bool = null,
/// Role Id that this integration uses for "subscribers"
role_id: ?Snowflake,
role_id: ?Snowflake = null,
/// Whether emoticons should be synced for this integration (twitch only currently)
enable_emoticons: ?bool,
enable_emoticons: ?bool = null,
/// The behavior of expiring subscribers
expire_behavior: ?IntegrationExpireBehaviors,
expire_behavior: ?IntegrationExpireBehaviors = null,
/// The grace period (in days) before expiring subscribers
expire_grace_period: ?isize,
expire_grace_period: ?isize = null,
/// When this integration was last synced
synced_at: ?[]const u8,
synced_at: ?[]const u8 = null,
/// How many subscribers this integration has
subscriber_count: ?isize,
subscriber_count: ?isize = null,
/// Has this integration been revoked
revoked: ?bool,
revoked: ?bool = null,
/// User for this integration
user: ?User,
user: ?User = null,
/// Integration account information
account: IntegrationAccount,
/// The bot/OAuth2 application for discord integrations
application: ?IntegrationApplication,
application: ?IntegrationApplication = null,
/// the scopes the application has been authorized for
scopes: []OAuth2Scope,
};
@ -74,11 +74,11 @@ pub const IntegrationApplication = struct {
/// The name of the app
name: []const u8,
/// the icon hash of the app
icon: ?[]const u8,
icon: ?[]const u8 = null,
/// The description of the app
description: []const u8,
/// The bot associated with this application
bot: ?User,
bot: ?User = null,
};
/// https://github.com/discord/discord-api-docs/blob/master/docs/topics/Gateway.md#integration-create-event-additional-fields
@ -94,29 +94,29 @@ pub const IntegrationCreateUpdate = struct {
discord,
},
/// Is this integration enabled
enabled: ?bool,
enabled: ?bool = null,
/// Is this integration syncing
syncing: ?bool,
syncing: ?bool = null,
/// Role Id that this integration uses for "subscribers"
role_id: ?Snowflake,
role_id: ?Snowflake = null,
/// Whether emoticons should be synced for this integration (twitch only currently)
enable_emoticons: ?bool,
enable_emoticons: ?bool = null,
/// The behavior of expiring subscribers
expire_behavior: ?IntegrationExpireBehaviors,
expire_behavior: ?IntegrationExpireBehaviors = null,
/// The grace period (in days) before expiring subscribers
expire_grace_period: ?isize,
expire_grace_period: ?isize = null,
/// When this integration was last synced
synced_at: ?[]const u8,
synced_at: ?[]const u8 = null,
/// How many subscribers this integration has
subscriber_count: ?isize,
subscriber_count: ?isize = null,
/// Has this integration been revoked
revoked: ?bool,
revoked: ?bool = null,
/// User for this integration
user: ?User,
user: ?User = null,
/// Integration account information
account: IntegrationAccount,
/// The bot/OAuth2 application for discord integrations
application: ?IntegrationApplication,
application: ?IntegrationApplication = null,
/// the scopes the application has been authorized for
scopes: []OAuth2Scope,
/// Id of the guild
@ -130,7 +130,7 @@ pub const IntegrationDelete = struct {
/// Id of the guild
guild_id: Snowflake,
/// Id of the bot/OAuth2 application for this discord integration
application_id: ?Snowflake,
application_id: ?Snowflake = null,
};
/// https://discord.com/developers/docs/topics/gateway#guild-integrations-update

82
src/structures/interaction.zig
View File

@ -42,9 +42,9 @@ pub const Interaction = struct {
/// The type of interaction
type: InteractionTypes,
/// Guild that the interaction was sent from
guild: ?Partial(Guild),
guild: ?Partial(Guild) = null,
/// The guild it was sent from
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// The channel it was sent from
channel: Partial(Channel),
///
@ -53,23 +53,23 @@ pub const Interaction = struct {
/// @remarks
/// It is recommended that you begin using this channel field to identify the source channel of the interaction as they may deprecate the existing channel_id field in the future.
///
channel_id: ?Snowflake,
channel_id: ?Snowflake = null,
/// Guild member data for the invoking user, including permissions
member: ?InteractionMember,
member: ?InteractionMember = null,
/// User object for the invoking user, if invoked in a DM
user: ?User,
user: ?User = null,
/// A continuation token for responding to the interaction
token: []const u8,
/// Read-only property, always `1`
version: 1,
/// For the message the button was attached to
message: ?Message,
message: ?Message = null,
/// the command data payload
data: ?InteractionData,
data: ?InteractionData = null,
/// The selected language of the invoking user
locale: ?[]const u8,
locale: ?[]const u8 = null,
/// The guild's preferred locale, if invoked in a guild
guild_locale: ?[]const u8,
guild_locale: ?[]const u8 = null,
/// The computed permissions for a bot or app in the context of a specific interaction (including channel overwrites)
app_permissions: []const u8,
/// For monetized apps, any entitlements for the invoking user, representing access to premium SKUs
@ -77,7 +77,7 @@ pub const Interaction = struct {
// Mapping of installation contexts that the interaction was authorized for to related user or guild IDs.
// authorizing_integration_owners: Partial(AutoArrayHashMap(ApplicationIntegrationType, []const u8)),
/// Context where the interaction was triggered from
context: ?InteractionContextType,
context: ?InteractionContextType = null,
};
/// https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-callback-interaction-callback-response-object
@ -85,7 +85,7 @@ pub const InteractionCallbackResponse = struct {
/// The interaction object associated with the interaction response
interaction: InteractionCallback,
/// The resource that was created by the interaction response.
resource: ?InteractionResource,
resource: ?InteractionResource = null,
};
/// https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-callback-interaction-callback-object
@ -95,13 +95,13 @@ pub const InteractionCallback = struct {
/// Interaction type
type: InteractionTypes,
/// Instance ID of the Activity if one was launched or joined
activity_instance_id: ?Snowflake,
activity_instance_id: ?Snowflake = null,
/// ID of the message that was created by the interaction
response_message_id: ?Snowflake,
response_message_id: ?Snowflake = null,
/// Whether or not the message is in a loading state
response_message_loading: ?bool,
response_message_loading: ?bool = null,
/// Whether or not the response message was ephemeral
response_message_ephemeral: ?bool,
response_message_ephemeral: ?bool = null,
};
/// https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-callback-interaction-callback-resource-object
@ -113,14 +113,14 @@ pub const InteractionResource = struct {
/// @remarks
/// Only present if type is `LAUNCH_ACTIVITY`.
///
activity_instance: ?ActivityInstanceResource,
activity_instance: ?ActivityInstanceResource = null,
///
/// Message created by the interaction.
///
/// @remarks
/// Only present if type is either `CHANNEL_MESSAGE_WITH_SOURCE` or `UPDATE_MESSAGE`.
///
message: ?Message,
message: ?Message = null,
};
/// https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-callback-interaction-callback-activity-instance-resource
@ -132,27 +132,27 @@ pub const ActivityInstanceResource = struct {
/// https://discord.com/developers/docs/resources/guild#guild-member-object
pub const InteractionMember = struct {
/// Whether the user is deafened in voice channels
deaf: ?bool,
deaf: ?bool = null,
/// Whether the user is muted in voice channels
mute: ?bool,
mute: ?bool = null,
/// Whether the user has not yet passed the guild's Membership Screening requirements
pending: ?bool,
pending: ?bool = null,
/// This users guild nickname
nick: ?[]const u8,
nick: ?[]const u8 = null,
/// The members custom avatar for this server.
avatar: ?[]const u8,
avatar: ?[]const u8 = null,
/// Array of role object ids
roles: [][]const u8,
/// When the user joined the guild
joined_at: []const u8,
/// When the user started boosting the guild
premium_since: ?[]const u8,
premium_since: ?[]const u8 = null,
/// when the user's timeout will expire and the user will be able to communicate in the guild again (set null to remove timeout), null or a time in the past if the user is not timed out
communication_disabled_until: ?[]const u8,
communication_disabled_until: ?[]const u8 = null,
/// Guild member flags
flags: isize,
/// data for the member's guild avatar decoration
avatar_decoration_data: ?AvatarDecorationData,
avatar_decoration_data: ?AvatarDecorationData = null,
/// The user object for this member
user: User,
/// Total permissions of the member in the channel, including overwrites, returned when in the interaction object
@ -161,13 +161,13 @@ pub const InteractionMember = struct {
pub const InteractionData = struct {
/// The type of component
component_type: ?MessageComponentTypes,
component_type: ?MessageComponentTypes = null,
/// The custom id provided for this component.
custom_id: ?Snowflake,
custom_id: ?Snowflake = null,
/// The components if its a Modal Submit interaction.
components: ?[]MessageComponent,
components: ?[]MessageComponent = null,
/// The values chosen by the user.
values: ?[][]const u8,
values: ?[][]const u8 = null,
/// The Id of the invoked command
id: Snowflake,
/// The name of the invoked command
@ -177,29 +177,29 @@ pub const InteractionData = struct {
/// Converted users + roles + channels + attachments
resolved: ?struct {
/// The Ids and Message objects
messages: ?Record(Message),
messages: ?Record(Message) = null,
/// The Ids and User objects
users: ?Record(User),
users: ?Record(User) = null,
// The Ids and partial Member objects
//members: ?Record(Omit(InteractionMember, .{ "user", "deaf", "mute" })),
// members: ?Record(Omit(InteractionMember, .{ "user", "deaf", "mute" })) = null,
/// The Ids and Role objects
roles: ?Record(Role),
roles: ?Record(Role) = null,
/// The Ids and partial Channel objects
channels: ?Record(struct {
id: Snowflake,
type: ChannelTypes,
name: ?[]const u8,
permissions: ?[]const u8,
name: ?[]const u8 = null,
permissions: ?[]const u8 = null,
}),
/// The ids and attachment objects
attachments: Record(Attachment),
},
/// The params + values from the user
options: ?[]InteractionDataOption,
options: ?[]InteractionDataOption = null,
/// The target id if this is a context menu command.
target_id: ?Snowflake,
target_id: ?Snowflake = null,
/// the id of the guild the command is registered to
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
};
pub const InteractionDataOption = struct {
@ -208,9 +208,9 @@ pub const InteractionDataOption = struct {
/// Value of application command option type
type: ApplicationCommandOptionTypes,
/// Value of the option resulting from user input
value: ?union { string: []const u8, bool: bool, integer: isize },
value: ?union { string: []const u8, bool: bool, integer: isize } = null,
/// Present if this option is a group or subcommand
options: ?[]InteractionDataOption,
options: ?[]InteractionDataOption = null,
/// `true` if this option is the currently focused option for autocomplete
focused: ?bool,
focused: ?bool = null,
};

44
src/structures/invite.zig
View File

@ -32,27 +32,27 @@ pub const InviteMetadata = struct {
/// The invite code (unique Id)
code: []const u8,
/// The guild this invite is for
guild: ?Partial(Guild),
guild: ?Partial(Guild) = null,
/// The channel this invite is for
channel: ?Partial(Channel),
channel: ?Partial(Channel) = null,
/// The user who created the invite
inviter: ?User,
inviter: ?User = null,
/// The type of target for this voice channel invite
target_type: ?TargetTypes,
target_type: ?TargetTypes = null,
/// The target user for this invite
target_user: ?User,
target_user: ?User = null,
/// The embedded application to open for this voice channel embedded application invite
target_application: ?Partial(Application),
target_application: ?Partial(Application) = null,
/// Approximate count of online members (only present when target_user is set)
approximate_presence_count: ?isize,
approximate_presence_count: ?isize = null,
/// Approximate count of total members
approximate_member_count: ?isize,
approximate_member_count: ?isize = null,
/// The expiration date of this invite, returned from the `GET /invites/<code>` endpoint when `with_expiration` is `true`
expires_at: ?[]const u8,
expires_at: ?[]const u8 = null,
/// Stage instance data if there is a public Stage instance in the Stage channel this invite is for
stage_instance: ?InviteStageInstance,
stage_instance: ?InviteStageInstance = null,
/// guild scheduled event data
guild_scheduled_event: ?ScheduledEvent,
guild_scheduled_event: ?ScheduledEvent = null,
/// isize of times this invite has been used
uses: isize,
/// Max isize of times this invite can be used
@ -72,27 +72,27 @@ pub const Invite = struct {
/// The invite code (unique Id)
code: []const u8,
/// The guild this invite is for
guild: ?Partial(Guild),
guild: ?Partial(Guild) = null,
/// The channel this invite is for
channel: ?Partial(Channel),
channel: ?Partial(Channel) = null,
/// The user who created the invite
inviter: ?User,
inviter: ?User = null,
/// The type of target for this voice channel invite
target_type: ?TargetTypes,
target_type: ?TargetTypes = null,
/// The target user for this invite
target_user: ?User,
target_user: ?User = null,
/// The embedded application to open for this voice channel embedded application invite
target_application: ?Partial(Application),
target_application: ?Partial(Application) = null,
/// Approximate count of online members (only present when target_user is set)
approximate_presence_count: ?isize,
approximate_presence_count: ?isize = null,
/// Approximate count of total members
approximate_member_count: ?isize,
approximate_member_count: ?isize = null,
/// The expiration date of this invite, returned from the `GET /invites/<code>` endpoint when `with_expiration` is `true`
expires_at: ?[]const u8,
expires_at: ?[]const u8 = null,
/// Stage instance data if there is a public Stage instance in the Stage channel this invite is for
stage_instance: ?InviteStageInstance,
stage_instance: ?InviteStageInstance = null,
/// guild scheduled event data
guild_scheduled_event: ?ScheduledEvent,
guild_scheduled_event: ?ScheduledEvent = null,
};
pub const InviteType = enum {

60
src/structures/member.zig
View File

@ -21,59 +21,59 @@ const AvatarDecorationData = @import("user.zig").AvatarDecorationData;
/// https://discord.com/developers/docs/resources/guild#guild-member-object
pub const Member = struct {
/// Whether the user is deafened in voice channels
deaf: ?bool,
deaf: ?bool = null,
/// Whether the user is muted in voice channels
mute: ?bool,
mute: ?bool = null,
/// Whether the user has not yet passed the guild's Membership Screening requirements
pending: ?bool,
pending: ?bool = null,
/// The user this guild member represents
user: ?User,
user: ?User = null,
/// This users guild nickname
nick: ?[]const u8,
nick: ?[]const u8 = null,
/// The members custom avatar for this server.
avatar: ?[]const u8,
avatar: ?[]const u8 = null,
/// Array of role object ids
roles: [][]const u8,
/// When the user joined the guild
joined_at: []const u8,
/// When the user started boosting the guild
premium_since: ?[]const u8,
premium_since: ?[]const u8 = null,
/// The permissions this member has in the guild. Only present on interaction events and OAuth2 current member fetch.
permissions: ?[]const u8,
permissions: ?[]const u8 = null,
/// when the user's timeout will expire and the user will be able to communicate in the guild again (set null to remove timeout), null or a time in the past if the user is not timed out
communication_disabled_until: ?[]const u8,
communication_disabled_until: ?[]const u8 = null,
/// Guild member flags
flags: isize,
/// data for the member's guild avatar decoration
avatar_decoration_data: ?AvatarDecorationData,
avatar_decoration_data: ?AvatarDecorationData = null,
};
/// inherits
pub const MemberWithUser = struct {
/// Whether the user is deafened in voice channels
deaf: ?bool,
deaf: ?bool = null,
/// Whether the user is muted in voice channels
mute: ?bool,
mute: ?bool = null,
/// Whether the user has not yet passed the guild's Membership Screening requirements
pending: ?bool,
pending: ?bool = null,
/// This users guild nickname
nick: ?[]const u8,
nick: ?[]const u8 = null,
/// The members custom avatar for this server.
avatar: ?[]const u8,
avatar: ?[]const u8 = null,
/// Array of role object ids
roles: [][]const u8,
/// When the user joined the guild
joined_at: []const u8,
/// When the user started boosting the guild
premium_since: ?[]const u8,
premium_since: ?[]const u8 = null,
/// The permissions this member has in the guild. Only present on interaction events and OAuth2 current member fetch.
permissions: ?[]const u8,
permissions: ?[]const u8 = null,
/// when the user's timeout will expire and the user will be able to communicate in the guild again (set null to remove timeout), null or a time in the past if the user is not timed out
communication_disabled_until: ?[]const u8,
communication_disabled_until: ?[]const u8 = null,
/// Guild member flags
flags: isize,
/// data for the member's guild avatar decoration
avatar_decoration_data: ?AvatarDecorationData,
avatar_decoration_data: ?AvatarDecorationData = null,
/// The user object for this member
user: User,
};
@ -83,29 +83,29 @@ pub const AddGuildMember = struct {
/// access token of a user that has granted your app the `guilds.join` scope
access_token: []const u8,
/// Value to set user's nickname to. Requires MANAGE_NICKNAMES permission on the bot
nick: ?[]const u8,
nick: ?[]const u8 = null,
/// Array of role ids the member is assigned. Requires MANAGE_ROLES permission on the bot
roles: ?[][]const u8,
roles: ?[][]const u8 = null,
/// Whether the user is muted in voice channels. Requires MUTE_MEMBERS permission on the bot
mute: ?bool,
mute: ?bool = null,
/// Whether the user is deafened in voice channels. Requires DEAFEN_MEMBERS permission on the bot
deaf: ?bool,
deaf: ?bool = null,
};
/// https://discord.com/developers/docs/resources/guild#modify-guild-member
pub const ModifyGuildMember = struct {
/// Value to set users nickname to. Requires the `MANAGE_NICKNAMES` permission
nick: ?[]const u8,
nick: ?[]const u8 = null,
/// Array of role ids the member is assigned. Requires the `MANAGE_ROLES` permission
roles: ?Snowflake,
roles: ?Snowflake = null,
/// Whether the user is muted in voice channels. Will throw a 400 if the user is not in a voice channel. Requires the `MUTE_MEMBERS` permission
mute: ?bool,
mute: ?bool = null,
/// Whether the user is deafened in voice channels. Will throw a 400 if the user is not in a voice channel. Requires the `MOVE_MEMBERS` permission
deaf: ?bool,
deaf: ?bool = null,
/// Id of channel to move user to (if they are connected to voice). Requires the `MOVE_MEMBERS` permission
channel_id: ?Snowflake,
channel_id: ?Snowflake = null,
/// When the user's timeout will expire and the user will be able to communicate in the guild again (up to 28 days in the future), set to null to remove timeout. Requires the `MODERATE_MEMBERS` permission. The date must be given in a ISO string form.
communication_disabled_until: ?[]const u8,
communication_disabled_until: ?[]const u8 = null,
/// Set the flags for the guild member. Requires the `MANAGE_GUILD` or `MANAGE_ROLES` or the combination of `MODERATE_MEMBERS` and `KICK_MEMBERS` and `BAN_MEMBERS`
flags: ?isize,
flags: ?isize = null,
};

122
src/structures/message.zig
View File

@ -45,7 +45,7 @@ pub const Message = struct {
/// id of the guild the message was sent in
/// Note: For MESSAGE_CREATE and MESSAGE_UPDATE events, the message object may not contain a guild_id or member field since the events are sent directly to the receiving user and the bot who sent the message, rather than being sent through the guild like non-ephemeral messages.,
///
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
///
/// The author of this message (not guaranteed to be a valid user)
/// Note: The author object follows the structure of the user object, but is only a valid user in the case where the message is generated by a user or bot user. If the message is generated by a webhook, the author object corresponds to the webhook's id, username, and avatar. You can tell if a message is generated by a webhook by checking for the webhook_id on the message object.,
@ -55,13 +55,13 @@ pub const Message = struct {
/// Member properties for this message's author
/// Note: The member object exists in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events from text-based guild channels. This allows bots to obtain real-time member data without requiring bots to store member state in memory.,
///
member: ?Member,
member: ?Member = null,
/// Contents of the message
content: ?[]const u8,
content: ?[]const u8 = null,
/// When this message was sent
timestamp: []const u8,
/// When this message was edited (or null if never)
edited_timestamp: ?[]const u8,
edited_timestamp: ?[]const u8 = null,
/// Whether this was a TTS message
tts: bool,
/// Whether this message mentions everyone
@ -72,68 +72,68 @@ pub const Message = struct {
///
mentions: []User,
/// Roles specifically mentioned in this message
mention_roles: ?[][]const u8,
mention_roles: ?[][]const u8 = null,
///
/// Channels specifically mentioned in this message
/// Note: Not all channel mentions in a message will appear in `mention_channels`. Only textual channels that are visible to everyone in a discoverable guild will ever be included. Only crossposted messages (via Channel Following) currently include `mention_channels` at all. If no mentions in the message meet these requirements, this field will not be sent.,
///
mention_channels: ?[]ChannelMention,
mention_channels: ?[]ChannelMention = null,
/// Any attached files
attachments: []Attachment,
/// Any embedded content
embeds: []Embed,
/// Reactions to the message
reactions: ?[]Reaction,
reactions: ?[]Reaction = null,
// Used for validating a message was sent
//nonce: ?union(enum) {int: isize,string: []const u8,},
// nonce: ?union(enum) {int: isize,string: []const u8,} = null,
/// Whether this message is pinned
pinned: bool,
/// If the message is generated by a webhook, this is the webhook's id
webhook_id: ?Snowflake,
webhook_id: ?Snowflake = null,
/// Type of message
type: MessageTypes,
/// Sent with Rich Presence-related chat embeds
activity: ?MessageActivity,
activity: ?MessageActivity = null,
/// Sent with Rich Presence-related chat embeds
application: ?Partial(Application),
application: ?Partial(Application) = null,
/// if the message is an Interaction or application-owned webhook, this is the id of the application
application_id: ?Snowflake,
application_id: ?Snowflake = null,
// Data showing the source of a crosspost, channel follow add, pin, or reply message
// message_reference: ?Omit(MessageReference, .{"failIfNotExists"}),
// message_reference: ?Omit(MessageReference, .{"failIfNotExists"}) = null,
/// Message flags combined as a bitfield
flags: ?MessageFlags,
flags: ?MessageFlags = null,
///
/// The stickers sent with the message (bots currently can only receive messages with stickers, not send)
/// @deprecated
///
stickers: ?[]Sticker,
stickers: ?[]Sticker = null,
///
/// The message associated with the `message_reference`
/// Note: This field is only returned for messages with a `type` of `19` (REPLY). If the message is a reply but the `referenced_message` field is not present, the backend did not attempt to fetch the message that was being replied to, so its state is unknown. If the field exists but is null, the referenced message was deleted.,
/// TAKES A POINTER
referenced_message: ?*Message,
referenced_message: ?*Message = null,
/// The message associated with the `message_reference`. This is a minimal subset of fields in a message (e.g. `author` is excluded.)
message_snapshots: ?[]MessageSnapshot,
message_snapshots: ?[]MessageSnapshot = null,
/// sent if the message is sent as a result of an interaction
interaction_metadata: ?MessageInteractionMetadata,
interaction_metadata: ?MessageInteractionMetadata = null,
///
/// Sent if the message is a response to an Interaction
///
/// @deprecated Deprecated in favor of {@link interaction_metadata};
///
interaction: ?MessageInteraction,
interaction: ?MessageInteraction = null,
// The thread that was started from this message, includes thread member object
// thread: ?Omit(Channel, .{"member"}), //& { member: ThreadMember };,
// thread: ?Omit(Channel, .{"member"}), //& { member: ThreadMember }; = null,
/// The components related to this message
components: ?[]MessageComponent,
components: ?[]MessageComponent = null,
/// Sent if the message contains stickers
sticker_items: ?[]StickerItem,
sticker_items: ?[]StickerItem = null,
/// A generally increasing integer (there may be gaps or duplicates) that represents the approximate position of the message in a thread, it can be used to estimate the relative position of the message in a thread in company with `total_message_sent` on parent thread
position: ?isize,
position: ?isize = null,
/// The poll object
poll: ?Poll,
poll: ?Poll = null,
/// The call associated with the message
call: ?MessageCall,
call: ?MessageCall = null,
};
/// https://discord.com/developers/docs/resources/channel#message-call-object
@ -191,22 +191,22 @@ pub const MessageActivity = struct {
/// Type of message activity
type: MessageActivityTypes,
/// `party_id` from a Rich Presence event
party_id: ?Snowflake,
party_id: ?Snowflake = null,
};
/// https://discord.com/developers/docs/resources/channel#message-object-message-reference-structure
pub const MessageReference = struct {
/// Type of reference
type: ?MessageReferenceType,
type: ?MessageReferenceType = null,
/// id of the originating message
message_id: ?Snowflake,
message_id: ?Snowflake = null,
///
/// id of the originating message's channel
/// Note: `channel_id` is optional when creating a reply, but will always be present when receiving an event/response that includes this data model.,
///
channel_id: ?Snowflake,
channel_id: ?Snowflake = null,
/// id of the originating message's guild
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// When sending, whether to error if the referenced message doesn't exist instead of sending as a normal (non-reply) message, default true
fail_if_not_exists: bool,
};
@ -238,35 +238,35 @@ pub const MessageSnapshot = struct {
/// https://discord.com/developers/docs/resources/channel#message-object
/// Minimal subset of fields in the forwarded message
message: struct {
content: ?[]const u8,
content: ?[]const u8 = null,
timestamp: []const u8,
edited_timestamp: ?[]const u8,
edited_timestamp: ?[]const u8 = null,
mentions: []struct {
username: []const u8,
global_name: ?[]const u8,
locale: ?[]const u8,
flags: ?isize,
premium_type: ?PremiumTypes,
public_flags: ?isize,
accent_color: ?isize,
global_name: ?[]const u8 = null,
locale: ?[]const u8 = null,
flags: ?isize = null,
premium_type: ?PremiumTypes = null,
public_flags: ?isize = null,
accent_color: ?isize = null,
id: Snowflake,
discriminator: []const u8,
avatar: ?[]const u8,
bot: ?bool,
system: ?bool,
mfa_enabled: ?bool,
verified: ?bool,
email: ?[]const u8,
banner: ?[]const u8,
avatar_decoration_data: ?AvatarDecorationData,
member: ?Partial(Member),
avatar: ?[]const u8 = null,
bot: ?bool = null,
system: ?bool = null,
mfa_enabled: ?bool = null,
verified: ?bool = null,
email: ?[]const u8 = null,
banner: ?[]const u8 = null,
avatar_decoration_data: ?AvatarDecorationData = null,
member: ?Partial(Member) = null,
},
mention_roles: ?[][]const u8,
mention_roles: ?[][]const u8 = null,
type: MessageTypes,
flags: ?MessageFlags,
stickers: ?[]Sticker,
components: ?[]MessageComponent,
sticker_items: ?[]StickerItem,
flags: ?MessageFlags = null,
stickers: ?[]Sticker = null,
components: ?[]MessageComponent = null,
sticker_items: ?[]StickerItem = null,
attachments: []Attachment,
embeds: []Embed,
},
@ -283,7 +283,7 @@ pub const MessageInteraction = struct {
/// The user who invoked the interaction
user: User,
/// The member who invoked the interaction in the guild
member: ?Partial(Member),
member: ?Partial(Member) = null,
};
/// https://discord.com/developers/docs/resources/channel#message-interaction-metadata-object-message-interaction-metadata-structure
@ -297,12 +297,12 @@ pub const MessageInteractionMetadata = struct {
// IDs for installation context(s) related to an interaction
// authorizing_integration_owners: Partial(AutoArrayHashMap(ApplicationIntegrationType, []const u8)),
/// ID of the original response message, present only on follow-up messages
original_response_message_id: ?Snowflake,
original_response_message_id: ?Snowflake = null,
/// ID of the message that contained interactive component, present only on messages created from component interactions
interacted_message_id: ?Snowflake,
interacted_message_id: ?Snowflake = null,
/// Metadata for the interaction that was used to open the modal, present only on modal submit interactions
/// TAKES A POINTER
triggering_interaction_metadata: ?*MessageInteractionMetadata,
triggering_interaction_metadata: ?*MessageInteractionMetadata = null,
};
pub const AllowedMentions = struct {
@ -313,16 +313,16 @@ pub const AllowedMentions = struct {
/// Array of user_ids to mention (Max size of 100)
users: []Snowflake,
/// For replies, whether to mention the author of the message being replied to (default false)
replied_user: ?bool,
replied_user: ?bool = null,
};
pub const GetMessagesQuery = struct {
/// Get messages around this message ID,
around: ?Snowflake,
around: ?Snowflake = null,
/// Get messages before this message ID
before: ?Snowflake,
before: ?Snowflake = null,
/// Get messages after this message ID
after: ?Snowflake,
after: ?Snowflake = null,
/// Max number of messages to return (1-100),
limit: ?usize = 50,
limit: ?usize = null,
};

10
src/structures/monetization.zig
View File

@ -24,9 +24,9 @@ pub const Entitlement = struct {
/// ID of the SKU
sku_id: Snowflake,
/// ID of the user that is granted access to the entitlement's sku
user_id: ?Snowflake,
user_id: ?Snowflake = null,
/// ID of the guild that is granted access to the entitlement's sku
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// ID of the parent application
application_id: Snowflake,
/// Type of entitlement
@ -34,11 +34,11 @@ pub const Entitlement = struct {
/// Entitlement was deleted
deleted: bool,
/// Start date at which the entitlement is valid. Not present when using test entitlements
starts_at: ?[]const u8,
starts_at: ?[]const u8 = null,
/// Date at which the entitlement is no longer valid. Not present when using test entitlements
ends_at: ?[]const u8,
ends_at: ?[]const u8 = null,
/// For consumable items, whether or not the entitlement has been consumed
consumed: ?bool,
consumed: ?bool = null,
};
/// https://discord.com/developers/docs/monetization/entitlements#entitlement-object-entitlement-types

4
src/structures/oauth.zig
View File

@ -57,7 +57,7 @@ pub const AccessTokenResponse = struct {
/// The scopes for the access token
scope: []const u8,
/// The webhook the user created for the application. Requires the `webhook.incoming` scope
webhook: ?IncomingWebhook,
webhook: ?IncomingWebhook = null,
/// The guild the bot has been added. Requires the `bot` scope
guild: ?Guild,
guild: ?Guild = null,
};

12
src/structures/poll.zig
View File

@ -31,7 +31,7 @@ pub const Poll = struct {
/// @remarks
/// `expiry` is marked as nullable to support non-expiring polls in the future, but all polls have an expiry currently.
///
expiry: ?[]const u8,
expiry: ?[]const u8 = null,
/// Whether a user can select multiple answers
allow_multiselect: bool,
/// The layout type of the poll
@ -43,7 +43,7 @@ pub const Poll = struct {
/// This value will not be sent by discord under specific conditions where they don't fetch them on their backend. When this value is missing it should be interpreted as "Unknown results" and not as "No results"
///The results may not be totally accurate while the poll has not ended. When it ends discord will re-calculate all the results and set {@link PollResult.is_finalized}; to true
///
results: ?PollResult,
results: ?PollResult = null,
};
/// https://discord.com/developers/docs/resources/poll#layout-type
@ -61,14 +61,14 @@ pub const PollMedia = struct {
/// `text` should always be non-null for both questions and answers, but this is subject to changes.
/// The maximum length of `text` is 300 for the question, and 55 for any answer.
///
text: ?[]const u8,
text: ?[]const u8 = null,
///
/// The emoji of the field
///
/// @remarks
/// When creating a poll answer with an emoji, one only needs to send either the `id` (custom emoji) or `name` (default emoji) as the only field.
///
emoji: ?Partial(Emoji),
emoji: ?Partial(Emoji) = null,
};
/// https://discord.com/developers/docs/resources/poll#poll-answer-object
@ -116,7 +116,7 @@ pub const PollVoteAdd = struct {
/// ID of the message. Usually a snowflake
message_id: Snowflake,
/// ID of the guild. Usually a snowflake
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// ID of the answer.
answer_id: isize,
};
@ -130,7 +130,7 @@ pub const PollVoteRemove = struct {
/// ID of the message. Usually a snowflake
message_id: Snowflake,
/// ID of the guild. Usually a snowflake
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// ID of the answer.
answer_id: isize,
};

46
src/structures/role.zig
View File

@ -30,9 +30,9 @@ pub const Role = struct {
/// Whether this role is mentionable
mentionable: bool,
/// The tags this role has
tags: ?RoleTags,
tags: ?RoleTags = null,
/// the role emoji hash
icon: ?[]const u8,
icon: ?[]const u8 = null,
/// Role name
name: []const u8,
/// Integer representation of hexadecimal color code
@ -40,7 +40,7 @@ pub const Role = struct {
/// Position of this role (roles with the same position are sorted by id)
position: isize,
/// role unicode emoji
unicode_emoji: ?[]const u8,
unicode_emoji: ?[]const u8 = null,
/// Role flags combined as a bitfield
flags: RoleFlags,
};
@ -48,54 +48,54 @@ pub const Role = struct {
/// https://discord.com/developers/docs/topics/permissions#role-object-role-tags-structure
pub const RoleTags = struct {
/// The id of the bot this role belongs to
bot_id: ?Snowflake,
bot_id: ?Snowflake = null,
/// The id of the integration this role belongs to
integration_id: ?Snowflake,
integration_id: ?Snowflake = null,
/// Whether this is the guild's premium subscriber role
/// Tags with type ?bool represent booleans. They will be present and set to null if they are "true", and will be not present if they are "false".
premium_subscriber: ?bool,
premium_subscriber: ?bool = null,
/// Id of this role's subscription sku and listing.
subscription_listing_id: ?Snowflake,
subscription_listing_id: ?Snowflake = null,
/// Whether this role is available for purchase.
/// Tags with type ?bool represent booleans. They will be present and set to null if they are "true", and will be not present if they are "false".
available_for_purchase: ?bool,
available_for_purchase: ?bool = null,
/// Whether this is a guild's linked role
/// Tags with type ?bool represent booleans. They will be present and set to null if they are "true", and will be not present if they are "false".
guild_connections: ?bool,
guild_connections: ?bool = null,
};
/// https://discord.com/developers/docs/resources/guild#create-guild-role
pub const CreateGuildRole = struct {
/// Name of the role, max 100 characters, default: "new role"
name: ?[]const u8,
name: ?[]const u8 = null,
/// Bitwise value of the enabled/disabled permissions, default: everyone permissions in guild
permissions: ?[][]const u8,
permissions: ?[][]const u8 = null,
/// RGB color value, default: 0
color: ?isize,
color: ?isize = null,
/// Whether the role should be displayed separately in the sidebar, default: false
hoist: ?bool,
hoist: ?bool = null,
/// Whether the role should be mentionable, default: false
mentionable: ?bool,
mentionable: ?bool = null,
/// The role's unicode emoji (if the guild has the `ROLE_ICONS` feature)
unicode_emoji: ?[]const u8,
unicode_emoji: ?[]const u8 = null,
/// the role's icon image (if the guild has the `ROLE_ICONS` feature)
icon: ?[]const u8,
icon: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/resources/guild#modify-guild-role
pub const ModifyGuildRole = struct {
/// Name of the role, max 100 characters, default: "new role"
name: ?[]const u8,
name: ?[]const u8 = null,
/// Bitwise value of the enabled/disabled permissions, default: everyone permissions in guild
permissions: ?[][]const u8,
permissions: ?[][]const u8 = null,
/// RGB color value, default: 0
color: ?isize,
color: ?isize = null,
/// Whether the role should be displayed separately in the sidebar, default: false
hoist: ?bool,
hoist: ?bool = null,
/// Whether the role should be mentionable, default: false
mentionable: ?bool,
mentionable: ?bool = null,
/// The role's unicode emoji (if the guild has the `ROLE_ICONS` feature)
unicodeEmoji: ?[]const u8,
unicodeEmoji: ?[]const u8 = null,
/// the role's icon image (if the guild has the `ROLE_ICONS` feature)
icon: ?[]const u8,
icon: ?[]const u8 = null,
};

36
src/structures/scheduled_event.zig
View File

@ -26,17 +26,17 @@ pub const ScheduledEvent = struct {
/// the guild id which the scheduled event belongs to
guild_id: Snowflake,
/// the channel id in which the scheduled event will be hosted if specified
channel_id: ?Snowflake,
channel_id: ?Snowflake = null,
/// the id of the user that created the scheduled event
creator_id: ?Snowflake,
creator_id: ?Snowflake = null,
/// the name of the scheduled event
name: []const u8,
/// the description of the scheduled event
description: ?[]const u8,
description: ?[]const u8 = null,
/// the time the scheduled event will start
scheduled_start_time: []const u8,
/// the time the scheduled event will end if it does end.
scheduled_end_time: ?[]const u8,
scheduled_end_time: ?[]const u8 = null,
/// the privacy level of the scheduled event
privacy_level: ScheduledEventPrivacyLevel,
/// the status of the scheduled event
@ -44,45 +44,45 @@ pub const ScheduledEvent = struct {
/// the type of hosting entity associated with a scheduled event
entity_type: ScheduledEventEntityType,
/// any additional id of the hosting entity associated with event
entity_id: ?Snowflake,
entity_id: ?Snowflake = null,
/// the entity metadata for the scheduled event
entity_metadata: ?ScheduledEventEntityMetadata,
entity_metadata: ?ScheduledEventEntityMetadata = null,
/// the user that created the scheduled event
creator: ?User,
creator: ?User = null,
/// the isize of users subscribed to the scheduled event
user_count: ?isize,
user_count: ?isize = null,
/// the cover image hash of the scheduled event
image: ?[]const u8,
image: ?[]const u8 = null,
/// the definition for how often this event should recur
recurrence_rule: ?ScheduledEventRecurrenceRule,
recurrence_rule: ?ScheduledEventRecurrenceRule = null,
};
pub const ScheduledEventEntityMetadata = struct {
/// location of the event
location: ?[]const u8,
location: ?[]const u8 = null,
};
pub const ScheduledEventRecurrenceRule = struct {
/// Starting time of the recurrence interval
start: []const u8,
/// Ending time of the recurrence interval
end: ?[]const u8,
end: ?[]const u8 = null,
/// How often the event occurs
frequency: ScheduledEventRecurrenceRuleFrequency,
/// The spacing between the events, defined by `frequency`. For example, `frequency` of `Weekly` and an `interval` of `2` would be "every-other week"
interval: isize,
/// Set of specific days within a week for the event to recur on
by_weekday: ?[]ScheduledEventRecurrenceRuleWeekday,
by_weekday: ?[]ScheduledEventRecurrenceRuleWeekday = null,
/// List of specific days within a specific week (1-5) to recur on
by_n_weekday: ?[]ScheduledEventRecurrenceRuleNWeekday,
by_n_weekday: ?[]ScheduledEventRecurrenceRuleNWeekday = null,
/// Set of specific months to recur on
by_month: ?[]ScheduledEventRecurrenceRuleMonth,
by_month: ?[]ScheduledEventRecurrenceRuleMonth = null,
/// Set of specific dates within a month to recur on
by_month_day: ?[]isize,
by_month_day: ?[]isize = null,
/// Set of days within a year to recur on (1-364)
by_year_day: ?[]isize,
by_year_day: ?[]isize = null,
/// The total amount of times that the event is allowed to recur before stopping
count: ?isize,
count: ?isize = null,
};
pub const ScheduledEventRecurrenceRuleFrequency = enum {

217
src/structures/shared.zig
View File

@ -42,6 +42,21 @@ pub const UserFlags = packed struct {
return @bitCast(raw);
}
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(value.integer));
}
pub fn jsonParseFromValue(_: std.mem.Allocator, src: std.json.Value, _: std.json.ParseOptions) @This() {
if (src != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(src.integer));
}
DiscordEmployee: bool = false,
PartneredServerOwner: bool = false,
HypeSquadEventsMember: bool = false,
@ -78,6 +93,21 @@ pub const PremiumUsageFlags = packed struct {
return @bitCast(raw);
}
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(value.integer));
}
pub fn jsonParseFromValue(_: std.mem.Allocator, src: std.json.Value, _: std.json.ParseOptions) @This() {
if (src != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(src.integer));
}
PremiumDiscriminator: bool = false,
AnimatedAvatar: bool = false,
ProfileBanner: bool = false,
@ -109,6 +139,20 @@ pub const MemberFlags = packed struct {
return @bitCast(raw);
}
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(value.integer));
}
pub fn jsonParseFromValue(_: std.mem.Allocator, src: std.json.Value, _: std.json.ParseOptions) @This() {
if (src != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(src.integer));
}
///
/// Member has left and rejoined the guild
///
@ -181,6 +225,21 @@ pub const ChannelFlags = packed struct {
return @bitCast(raw);
}
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(value.integer));
}
pub fn jsonParseFromValue(_: std.mem.Allocator, src: std.json.Value, _: std.json.ParseOptions) @This() {
if (src != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(src.integer));
}
None: bool = false,
/// this thread is pinned to the top of its parent `GUILD_FORUM` channel
Pinned: bool = false,
@ -203,6 +262,21 @@ pub const RoleFlags = packed struct {
return @bitCast(raw);
}
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(value.integer));
}
pub fn jsonParseFromValue(_: std.mem.Allocator, src: std.json.Value, _: std.json.ParseOptions) @This() {
if (src != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(src.integer));
}
None: bool = false,
/// Role can be selected by members in an onboarding prompt
InPrompt: bool = false,
@ -217,6 +291,21 @@ pub const AttachmentFlags = packed struct {
return @bitCast(raw);
}
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(value.integer));
}
pub fn jsonParseFromValue(_: std.mem.Allocator, src: std.json.Value, _: std.json.ParseOptions) @This() {
if (src != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(src.integer));
}
None: bool = false,
_pad: u1 = 0,
/// This attachment has been edited using the remix feature on mobile
@ -234,6 +323,21 @@ pub const SkuFlags = packed struct {
return @bitCast(raw);
}
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(value.integer));
}
pub fn jsonParseFromValue(_: std.mem.Allocator, src: std.json.Value, _: std.json.ParseOptions) @This() {
if (src != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(src.integer));
}
_pad: u2 = 0,
/// SKU is available for purchase
Available: bool = false,
@ -255,6 +359,21 @@ pub const MessageFlags = packed struct {
return @bitCast(raw);
}
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(value.integer));
}
pub fn jsonParseFromValue(_: std.mem.Allocator, src: std.json.Value, _: std.json.ParseOptions) @This() {
if (src != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(src.integer));
}
/// This message has been published to subscribed channels (via Channel Following)
Crossposted: bool = false,
/// This message originated from a message in another channel (via Channel Following)
@ -291,6 +410,21 @@ pub const ActivityFlags = packed struct {
return @bitCast(raw);
}
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(value.integer));
}
pub fn jsonParseFromValue(_: std.mem.Allocator, src: std.json.Value, _: std.json.ParseOptions) @This() {
if (src != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(src.integer));
}
Instance: bool = false,
Join: bool = false,
Spectate: bool = false,
@ -325,6 +459,25 @@ pub const ApplicationFlags = packed struct {
return @bitCast(raw);
}
// this should be the default behavior
// but unfortunately the zig std devs have nothing in their heads
// so we have to do this manually for each struct, what a fucking nightmare
// I have no clue what to do for bigger ints, I'll figure it out
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(value.integer));
}
pub fn jsonParseFromValue(_: std.mem.Allocator, src: std.json.Value, _: std.json.ParseOptions) @This() {
if (src != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(src.integer));
}
_pad: u5 = 0,
/// Indicates if an app uses the Auto Moderation API.
ApplicationAutoModerationRuleCreateBadge: bool = false,
@ -532,6 +685,22 @@ pub const SystemChannelFlags = packed struct {
return @bitCast(raw);
}
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(value.integer));
}
pub fn jsonParseFromValue(_: std.mem.Allocator, src: std.json.Value, _: std.json.ParseOptions) @This() {
if (src != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(src.integer));
}
/// Suppress member join notifications
SuppressJoinNotifications: bool = false,
/// Suppress server boost notifications
@ -573,6 +742,22 @@ pub const ChannelTypes = packed struct {
return @bitCast(raw);
}
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(value.integer));
}
pub fn jsonParseFromValue(_: std.mem.Allocator, src: std.json.Value, _: std.json.ParseOptions) @This() {
if (src != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(src.integer));
}
/// A text channel within a server
GuildText: bool = false,
/// A direct message between users
@ -896,6 +1081,22 @@ pub const BitwisePermissionFlags = packed struct {
return @bitCast(raw);
}
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(value.integer));
}
pub fn jsonParseFromValue(_: std.mem.Allocator, src: std.json.Value, _: std.json.ParseOptions) @This() {
if (src != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(src.integer));
}
/// Allows creation of instant invites
CREATE_INSTANT_INVITE: bool = false,
/// Allows kicking members
@ -1239,6 +1440,22 @@ pub const GatewayIntents = packed struct {
return @bitCast(raw);
}
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(value.integer));
}
pub fn jsonParseFromValue(_: std.mem.Allocator, src: std.json.Value, _: std.json.ParseOptions) @This() {
if (src != .integer) @panic("Invalid value for bitfield");
return fromRaw(@intCast(src.integer));
}
///
/// - GUILD_CREATE
/// - GUILD_UPDATE

5
src/structures/snowflake.zig
View File

@ -61,10 +61,11 @@ pub const Snowflake = enum(u64) {
/// std.json parse
pub fn jsonParse(allocator: std.mem.Allocator, src: anytype, _: std.json.ParseOptions) !@This() {
const value = try std.json.innerParse(std.json.Value, allocator, src, .{
.max_value_len = 0x100
.ignore_unknown_fields = true,
.max_value_len = 0x1000,
});
if (value != .string)
if (value == .string)
return Snowflake.fromRaw(value.string) catch
std.debug.panic("invalid snowflake: {s}\n", .{value.string});
unreachable;

20
src/structures/sticker.zig
View File

@ -8,7 +8,7 @@ pub const Sticker = struct {
/// [Id of the sticker](https://discord.com/developers/docs/reference#image-formatting)
id: Snowflake,
/// Id of the pack the sticker is from
pack_id: ?Snowflake,
pack_id: ?Snowflake = null,
/// Name of the sticker
name: []const u8,
/// Description of the sticker
@ -20,13 +20,13 @@ pub const Sticker = struct {
/// [Type of sticker format](https://discord.com/developers/docs/resources/sticker#sticker-object-sticker-format-types)
format_type: StickerFormatTypes,
/// Whether or not the sticker is available
available: ?bool,
available: ?bool = null,
/// Id of the guild that owns this sticker
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// The user that uploaded the sticker
user: ?User,
user: ?User = null,
/// A sticker's sort order within a pack
sort_value: ?isize,
sort_value: ?isize = null,
};
/// https://discord.com/developers/docs/resources/sticker#sticker-item-object-sticker-item-structure
@ -50,18 +50,18 @@ pub const StickerPack = struct {
/// id of the pack's SKU
sku_id: Snowflake,
/// id of a sticker in the pack which is shown as the pack's icon
cover_sticker_id: ?Snowflake,
cover_sticker_id: ?Snowflake = null,
/// description of the sticker pack
description: []const u8,
/// id of the sticker pack's [banner image](https://discord.com/developers/docs/reference#image-formatting)
banner_asset_id: ?Snowflake,
banner_asset_id: ?Snowflake = null,
};
pub const CreateModifyGuildSticker = struct {
/// name of the sticker (2-30 characters)
name: ?[]const u8,
name: ?[]const u8 = null,
/// description of the sticker (2-100 characters)
description: ?[]const u8,
description: ?[]const u8 = null,
/// autocomplete/suggestion tags for the sticker (max 200 characters)
tags: ?[]const u8,
tags: ?[]const u8 = null,
};

2
src/structures/team.zig
View File

@ -20,7 +20,7 @@ const TeamMembershipStates = @import("shared.zig").TeamMembershipStates;
/// https://discord.com/developers/docs/topics/teams#data-models-team-object
pub const Team = struct {
/// Hash of the image of the team's icon
icon: ?[]const u8,
icon: ?[]const u8 = null,
/// Unique ID of the team
id: Snowflake,
/// Members of the team

34
src/structures/thread.zig
View File

@ -32,11 +32,11 @@ pub const ThreadMetadata = struct {
/// When a thread is locked, only users with `MANAGE_THREADS` can unarchive it
locked: bool,
/// whether non-moderators can add other non-moderators to a thread; only available on private threads
invitable: ?bool,
invitable: ?bool = null,
/// Timestamp when the thread's archive status was last changed, used for calculating recent activity
archive_timestamp: []const u8,
/// Timestamp when the thread was created; only populated for threads created after 2022-01-09
create_timestamp: ?[]const u8,
create_timestamp: ?[]const u8 = null,
};
pub const ThreadMember = struct {
@ -70,7 +70,7 @@ pub const ThreadListSync = struct {
/// The id of the guild
guild_id: Snowflake,
/// The parent channel ids whose threads are being synced. If omitted, then threads were synced for the entire guild. This array may contain channelIds that have no active threads as well, so you know to clear that data
channel_ids: ?[][]const u8,
channel_ids: ?[][]const u8 = null,
/// All active threads in the given channels that the current user can access
threads: []Channel,
/// All thread member objects from the synced threads for the current user, indicating which threads the current user has been added to
@ -82,9 +82,9 @@ pub const StartThreadFromMessage = struct {
/// 1-100 character thread name
name: []const u8,
/// Duration in minutes to automatically archive the thread after recent activity
auto_archive_duration: ?isize,
auto_archive_duration: ?isize = null,
/// Amount of seconds a user has to wait before sending another message (0-21600)
rate_limit_per_user: ?isize,
rate_limit_per_user: ?isize = null,
};
/// https://discord.com/developers/docs/resources/channel#start-thread-without-message
@ -94,41 +94,41 @@ pub const StartThreadWithoutMessage = struct {
/// Duration in minutes to automatically archive the thread after recent activity,
auto_archive_duration: isize,
/// Amount of seconds a user has to wait before sending another message (0-21600),
rateLimitPerUser: ?isize,
rateLimitPerUser: ?isize = null,
/// the type of thread to create,
/// may only be AnnouncementThread, PublicThread, or PrivateThread
type: ChannelTypes,
/// whether non-moderators can add other non-moderators to a thread; only available when creating a private thread,
invitable: ?bool,
invitable: ?bool = null,
};
/// https://discord.com/developers/docs/resources/channel#start-thread-in-forum-or-media-channel-forum-and-media-thread-message-params-object
pub const CreateForumAndMediaThreadMessage = struct {
/// Message contents (up to 2000 characters)
content: ?[]const u8,
content: ?[]const u8 = null,
/// Up to 10 rich embeds (up to 6000 characters)
embeds: ?[]Embed,
embeds: ?[]Embed = null,
/// Allowed mentions for the message
allowed_mentions: ?AllowedMentions,
allowed_mentions: ?AllowedMentions = null,
/// Components to include with the message
components: ?[]MessageComponent,
components: ?[]MessageComponent = null,
/// IDs of up to 3 stickers in the server to send in the message
sticker_ids: ?[]Snowflake,
sticker_ids: ?[]Snowflake = null,
/// Attachment objects with filename and description. See Uploading Files
attachments: ?[]Partial(Attachment),
attachments: ?[]Partial(Attachment) = null,
/// Message flags combined as a bitfield (only SUPPRESS_EMBEDS and SUPPRESS_NOTIFICATIONS can be set)
flags: ?MessageFlags,
flags: ?MessageFlags = null,
};
pub const StartThreadInForumOrMediaChannel = struct {
/// 1-100 character channel name
name: []const u8,
/// Duration in minutes to automatically archive the thread after recent activity, can be set to: 60, 1440, 4320, 10080
auto_archive_duration: ?isize,
auto_archive_duration: ?isize = null,
/// Amount of seconds a user has to wait before sending another message (0-21600)
rate_limit_per_user: ?isize,
rate_limit_per_user: ?isize = null,
/// Contents of the first message in the forum/media thread
message: CreateForumAndMediaThreadMessage,
/// The IDs of the set of tags that have been applied to a thread in a GUILD_FORUM or a GUILD_MEDIA channel
applied_tags: ?[]Snowflake,
applied_tags: ?[]Snowflake = null,
};

9
src/structures/types.zig
View File

@ -336,16 +336,17 @@ pub const IncomingWebhook = @import("webhook.zig").IncomingWebhook;
pub const ApplicationWebhook = @import("webhook.zig").ApplicationWebhook;
/// https://discord.com/developers/docs/topics/gateway#payloads-gateway-payload-structure
pub fn GatewayPayload(comptime T: type) type {
return struct {
/// opcode for the payload
op: isize,
/// Event data
d: ?T,
d: ?T = null,
/// Sequence isize, used for resuming sessions and heartbeats
s: ?isize,
s: ?isize = null,
/// The event name for this payload
t: ?[]const u8,
// t: ?GatewayDispatchEventNames,
t: ?[]const u8 = null,
// t: ?GatewayDispatchEventNames = null,
};
}

48
src/structures/user.zig
View File

@ -27,38 +27,38 @@ pub const User = struct {
/// The user's username, not unique across the platform
username: []const u8,
/// The user's display name, if it is set. For bots, this is the application name
global_name: ?[]const u8,
global_name: ?[]const u8 = null,
/// The user's chosen language option
locale: ?[]const u8,
locale: ?[]const u8 = null,
/// The flags on a user's account
flags: ?isize,
flags: ?isize = null,
/// The type of Nitro subscription on a user's account
premium_type: ?PremiumTypes,
premium_type: ?PremiumTypes = null,
/// The public flags on a user's account
public_flags: ?isize,
public_flags: ?isize = null,
/// the user's banner color encoded as an integer representation of hexadecimal color code
accent_color: ?isize,
accent_color: ?isize = null,
/// The user's id
id: Snowflake,
/// The user's discord-tag
discriminator: []const u8,
/// The user's avatar hash
avatar: ?[]const u8,
avatar: ?[]const u8 = null,
/// Whether the user belongs to an OAuth2 application
bot: ?bool,
bot: ?bool = null,
///Whether the user is an Official System user (part of the urgent message system)
system: ?bool,
system: ?bool = null,
/// Whether the user has two factor enabled on their account
mfa_enabled: ?bool,
mfa_enabled: ?bool = null,
/// Whether the email on this account has been verified
verified: ?bool,
verified: ?bool = null,
/// The user's email
email: ?[]const u8,
email: ?[]const u8 = null,
/// the user's banner, or null if unset
banner: ?[]const u8,
banner: ?[]const u8 = null,
/// data for the user's avatar decoration
avatar_decoration_data: ?AvatarDecorationData,
clan: ?[]const u8,
avatar_decoration_data: ?AvatarDecorationData = null,
clan: ?[]const u8 = null,
};
/// https://discord.com/developers/docs/resources/user#avatar-decoration-data-object
@ -76,7 +76,7 @@ pub const TokenRevocation = struct {
/// The access token to revoke
token: []const u8,
/// Optional, the type of token you are using for the revocation
token_type_hint: ?"access_token' | 'refresh_token",
token_type_hint: ?"access_token' | 'refresh_token" = null,
};
/// https://discord.com/developers/docs/topics/oauth2#get-current-authorization-information-response-structure
@ -87,7 +87,7 @@ pub const CurrentAuthorization = struct {
/// when the access token expires
expires: []const u8,
/// the user who has authorized, if the user has authorized with the `identify` scope
user: ?User,
user: ?User = null,
};
/// https://discord.com/developers/docs/resources/user#connection-object-connection-structure
@ -99,9 +99,9 @@ pub const Connection = struct {
/// the service of this connection
type: ConnectionServiceType,
/// whether the connection is revoked
revoked: ?bool,
revoked: ?bool = null,
/// an array of partial server integrations
integrations: ?[]Partial(Integration),
integrations: ?[]Partial(Integration) = null,
/// whether the connection is verified
verified: bool,
/// whether friend sync is enabled for this connection
@ -152,18 +152,18 @@ pub const ConnectionVisibility = enum(u4) {
/// https://discord.com/developers/docs/resources/user#application-role-connection-object-application-role-connection-structure
pub const ApplicationRoleConnection = struct {
/// the vanity name of the platform a bot has connected (max 50 characters)
platform_name: ?[]const u8,
platform_name: ?[]const u8 = null,
/// the username on the platform a bot has connected (max 100 characters)
platform_username: ?[]const u8,
platform_username: ?[]const u8 = null,
/// object mapping application role connection metadata keys to their stringified value (max 100 characters) for the user on the platform a bot has connected
metadata: []Record([]const u8),
};
pub const ModifyCurrentUser = struct {
/// user's username, if changed may cause the user's discriminator to be randomized.
username: ?[]const u8,
username: ?[]const u8 = null,
/// if passed, modifies the user's avatar
avatar: ?[]const u8,
avatar: ?[]const u8 = null,
/// if passed, modifies the user's banner
banner: ?[]const u8,
banner: ?[]const u8 = null,
};

38
src/structures/webhook.zig
View File

@ -37,53 +37,53 @@ pub const IncomingWebhook = struct {
/// The type of the webhook
type: WebhookTypes,
/// The secure token of the webhook (returned for Incoming Webhooks)
token: ?[]const u8,
token: ?[]const u8 = null,
/// The url used for executing the webhook (returned by the webhooks OAuth2 flow)
url: ?[]const u8,
url: ?[]const u8 = null,
/// The id of the webhook
id: Snowflake,
/// The guild id this webhook is for
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// The channel id this webhook is for
channel_id: Snowflake,
/// The user this webhook was created by (not returned when getting a webhook with its token)
user: ?User,
user: ?User = null,
/// The default name of the webhook
name: ?[]const u8,
name: ?[]const u8 = null,
/// The default user avatar hash of the webhook
avatar: ?[]const u8,
avatar: ?[]const u8 = null,
/// The bot/OAuth2 application that created this webhook
application_id: ?Snowflake,
application_id: ?Snowflake = null,
/// The guild of the channel that this webhook is following (returned for Channel Follower Webhooks)
source_guild: ?Partial(Guild),
source_guild: ?Partial(Guild) = null,
/// The channel that this webhook is following (returned for Channel Follower Webhooks)
source_channel: ?Partial(Channel),
source_channel: ?Partial(Channel) = null,
};
pub const ApplicationWebhook = struct {
/// The type of the webhook
type: WebhookTypes.Application,
/// The secure token of the webhook (returned for Incoming Webhooks)
token: ?[]const u8,
token: ?[]const u8 = null,
/// The url used for executing the webhook (returned by the webhooks OAuth2 flow)
url: ?[]const u8,
url: ?[]const u8 = null,
/// The id of the webhook
id: Snowflake,
/// The guild id this webhook is for
guild_id: ?Snowflake,
guild_id: ?Snowflake = null,
/// The channel id this webhook is for
channel_id: ?Snowflake,
channel_id: ?Snowflake = null,
/// The user this webhook was created by (not returned when getting a webhook with its token)
user: ?User,
user: ?User = null,
/// The default name of the webhook
name: ?[]const u8,
name: ?[]const u8 = null,
/// The default user avatar hash of the webhook
avatar: ?[]const u8,
avatar: ?[]const u8 = null,
/// The bot/OAuth2 application that created this webhook
application_id: ?Snowflake,
application_id: ?Snowflake = null,
/// The guild of the channel that this webhook is following (returned for Channel Follower Webhooks), field will be absent if the webhook creator has since lost access to the guild where the followed channel resides
source_guild: ?Partial(Guild),
source_guild: ?Partial(Guild) = null,
/// The channel that this webhook is following (returned for Channel Follower Webhooks), field will be absent if the webhook creator has since lost access to the guild where the followed channel resides
source_channel: ?Partial(Channel),
source_channel: ?Partial(Channel) = null,
};