@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/guilds.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Guild, member, role and voice-state operations and their gateway projections.
+ * Invariant: Operations validate requests and convert REST and gateway data without storing guild state, use separate rate-limit
+ * groups for guild and message routes, and never enter the message cache or synthesize gateway events after HTTP responses.
+ * Multi-step resource workflows are not transactions, and uncertain writes are never replayed as reads. Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import type { Guild, GuildMember, MemberProfileEdit, GuildRole, RoleCreate, RoleEdit, MemberQuery, MemberReference, RolePosition, RoleHoistPosition, RoleReference } from "#sdk/guilds";
+import type { VoiceState, VoiceStateSnapshot } from "#sdk/events";
+import { InputValidationFailure } from "#sdk/input-validation";
+import type { ResourceRequest } from "./guild-cache.js";
+import type { ChannelCacheRequest } from "./channel-cache.js";
+import type { InstanceEndpointContext } from "./instance.js";
+/** Validated request description. The shared REST owner retains admission, cleanup and rate state */
+export interface GuildRequest<A> {
+    readonly guildId: string;
+    readonly bucket: string;
+    readonly path: string;
+    readonly method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+    readonly status: 200 | 202 | 204;
+    readonly json?: string;
+    /** Allows the shared REST owner to validate and send an operation audit reason */
+    readonly audited?: true;
+    readonly moderation?: true;
+    readonly auditReason?: string;
+    /** Permits timeoutReason only on timeout and clear-timeout operation options */
+    readonly timeoutReason?: true;
+    readonly deleteAuthorId?: string;
+    readonly invalidateMessages?: true;
+    /** Private client capabilities required for one explicit provider-gated replacement */
+    readonly features?: readonly string[];
+    /** REST supplies the immutable endpoint snapshot after request admission. One-argument decoders ignore it */
+    readonly decode: (value: unknown, instance?: InstanceEndpointContext) => A | undefined;
+    readonly cache?: ResourceRequest;
+    readonly channelCache?: ChannelCacheRequest;
+}
+type GuildValidationResult<A> = GuildRequest<A> | InputValidationFailure;
+export declare const guildEvents: {
+    readonly GUILD_MEMBER_ADD: "guildMemberAdd";
+    readonly GUILD_MEMBER_UPDATE: "guildMemberUpdate";
+    readonly GUILD_MEMBER_REMOVE: "guildMemberRemove";
+    readonly GUILD_BAN_ADD: "guildBanAdd";
+    readonly GUILD_BAN_REMOVE: "guildBanRemove";
+    readonly GUILD_ROLE_DELETE: "guildRoleDelete";
+    readonly GUILD_ROLE_CREATE: "guildRoleCreate";
+    readonly GUILD_ROLE_UPDATE: "guildRoleUpdate";
+    readonly GUILD_ROLE_UPDATE_BULK: "guildRoleUpdateBulk";
+};
+export declare const guildLifecycleEvents: {
+    readonly GUILD_CREATE: "guildCreate";
+    readonly GUILD_UPDATE: "guildUpdate";
+    readonly GUILD_DELETE: "guildDelete";
+};
+export declare function decodeGuildEvent(event: keyof typeof guildEvents, value: unknown): Readonly<{
+    guildId: string;
+    roles: readonly GuildRole[];
+}> | Readonly<{
+    guildId: string;
+    id: string;
+}> | Readonly<{
+    guildId: string;
+    userId: string;
+}> | undefined;
+/** Decodes the documented complete snapshot/update forms without retaining gateway collections */
+export declare function decodeGuildLifecycleEvent(event: keyof typeof guildLifecycleEvents, value: unknown): Guild | Readonly<{
+    id: string;
+    unavailable: boolean;
+    unavailableHidden: boolean;
+}> | undefined;
+/** Decodes a complete nested GUILD_CREATE snapshot while leaving its collections unretained */
+export declare function decodeGuildSnapshot(value: unknown): Guild | undefined;
+export declare function decodeVoiceState(value: unknown, expectedGuildId?: string): VoiceState | undefined;
+export declare function decodeVoiceStateSnapshot(value: unknown): VoiceStateSnapshot | undefined;
+export declare function decodeGuild(value: unknown): Guild | undefined;
+export declare function decodeMember(value: unknown, guildId: string): GuildMember | undefined;
+export declare function guildFetch(guildId: string): GuildValidationResult<Guild>;
+export declare function memberFetch(target: MemberReference): GuildValidationResult<GuildMember>;
+export declare function memberSelf(guildId: string): GuildValidationResult<GuildMember>;
+export declare function memberEditSelf(guildId: string, input: MemberProfileEdit): GuildValidationResult<GuildMember>;
+/** Build the one-field member PATCH used for a moderator-controlled nickname change */
+export declare function memberNicknameEdit(target: MemberReference, nickname: string | null): GuildValidationResult<GuildMember>;
+/** Build the complete role-set PATCH for one member without reading or merging an existing role set */
+export declare function memberRolesSet(target: MemberReference, roleIds: readonly string[]): GuildValidationResult<GuildMember>;
+export declare function memberPage(guildId: string, query?: MemberQuery): GuildValidationResult<readonly GuildMember[]>;
+export declare function memberRole(target: MemberReference, roleId: string, add: boolean): GuildValidationResult<void>;
+export declare function decodeRoles(value: unknown, guildId: string): readonly GuildRole[] | undefined;
+export declare function roleList(guildId: string): GuildValidationResult<readonly GuildRole[]>;
+export declare function roleCreate(guildId: string, input: RoleCreate): GuildValidationResult<GuildRole>;
+export declare function roleEdit(target: RoleReference, input: RoleEdit): GuildValidationResult<GuildRole>;
+export declare function roleDelete(target: RoleReference): GuildValidationResult<void>;
+export declare function roleReorder(guildId: string, positions: readonly RolePosition[]): GuildValidationResult<void>;
+export declare function roleSetHoistPositions(guildId: string, positions: readonly RoleHoistPosition[]): GuildValidationResult<void>;
+export declare function roleResetHoistPositions(guildId: string): GuildValidationResult<void>;
+export {};
+//# sourceMappingURL=guilds.d.ts.map

package/dist/internal/guilds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guilds.d.ts","sourceRoot":"","sources":["../../src/internal/guilds.ts"],"names":[],"mappings":"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"}