district.js 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 koya (District)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -42,8 +42,31 @@ await msg.edit("hello, world!");
 await msg.react("👍");
 await msg.delete();
 
-// Read history
+// Read history (returns a Collection)
 const recent = await client.channel(channelId).fetchMessages(50);
+const commands = recent.filter((m) => m.content?.startsWith("!"));
+```
+
+## Users, spaces & permissions
+
+```js
+const user = await message.fetchAuthor();       // User
+const space = await client.spaces.fetch(spaceId); // Space (app must be installed)
+
+const members = await space.members();           // Collection<SpaceMember>
+const roles = await space.roles();               // Collection<Role>
+const named = members.filter((m) => m.nickname !== null);
+const canBan = roles.some((r) => r.permissions.has("BanMembers"));
+
+// Permissions
+import { PermissionsBitField } from "district.js";
+const perms = new PermissionsBitField(["SendMessages", "AddReactions"]);
+perms.has(PermissionsBitField.Flags.SendMessages); // true
+perms.toString(); // "32770" — use as the install-link permissions integer
+
+// Markdown
+import { Formatters } from "district.js";
+channel.send(Formatters.bold("Heads up!") + " " + Formatters.code("v0.2.0"));
 ```
 
 ## Slash commands

package/dist/client.d.ts

@@ -1,7 +1,7 @@
 import { EventEmitter } from "node:events";
 import http from "node:http";
 import { REST } from "./rest.js";
-import { ClientUser, Message, TextChannel, Interaction, type ClientContext } from "./structures.js";
+import { ClientUser, Message, TextChannel, Interaction, User, Space, type ClientContext } from "./structures.js";
 import { type EventHeaders } from "./webhook.js";
 import type { ClientOptions, ReactionEvent, DeletedMessage } from "./types.js";
 /** The events a Client emits, and their argument tuples. */
@@ -28,8 +28,18 @@ export declare class Client extends EventEmitter implements ClientContext {
     /** A handle to a channel, for `.send()` / `.fetchMessages()`. */
     channel(id: string): TextChannel;
     readonly channels: {
+        /** Fetch a channel's info (kind, name, space). */
+        fetch: (id: string) => Promise<TextChannel>;
+        /** Send a message to a channel. */
         send: (channelId: string, content: string) => Promise<Message>;
-        fetch: (channelId: string, limit?: number) => Promise<Message[]>;
+    };
+    /** Fetch users by id. */
+    readonly users: {
+        fetch: (id: string) => Promise<User>;
+    };
+    /** Fetch spaces by id. */
+    readonly spaces: {
+        fetch: (id: string) => Promise<Space>;
     };
     /** Validate the token, load the bot's identity, and emit `ready`. */
     login(): Promise<ClientUser>;

package/dist/client.js

@@ -3,7 +3,7 @@
 import { EventEmitter } from "node:events";
 import http from "node:http";
 import { REST } from "./rest.js";
-import { ClientUser, Message, TextChannel, Interaction } from "./structures.js";
+import { ClientUser, Message, TextChannel, Interaction, User, Space } from "./structures.js";
 import { verifyAndParse } from "./webhook.js";
 export class Client extends EventEmitter {
     rest;
@@ -36,8 +36,18 @@ export class Client extends EventEmitter {
         return new TextChannel(this, id);
     }
     channels = {
+        /** Fetch a channel's info (kind, name, space). */
+        fetch: (id) => new TextChannel(this, id).fetch(),
+        /** Send a message to a channel. */
         send: (channelId, content) => new TextChannel(this, channelId).send(content),
-        fetch: (channelId, limit) => new TextChannel(this, channelId).fetchMessages(limit),
+    };
+    /** Fetch users by id. */
+    users = {
+        fetch: (id) => this.rest.get(`/users/${id}`).then((r) => new User(r.user)),
+    };
+    /** Fetch spaces by id. */
+    spaces = {
+        fetch: (id) => this.rest.get(`/spaces/${id}`).then((r) => new Space(this, r.space)),
     };
     /** Validate the token, load the bot's identity, and emit `ready`. */
     async login() {

package/dist/collection.d.ts

@@ -0,0 +1,23 @@
+export declare class Collection<K, V> extends Map<K, V> {
+    /** The first value (or first N as an array). */
+    first(): V | undefined;
+    first(n: number): V[];
+    /** The last value. */
+    last(): V | undefined;
+    /** The first value matching a predicate. */
+    find(fn: (value: V, key: K) => boolean): V | undefined;
+    /** A new Collection of the values matching a predicate. */
+    filter(fn: (value: V, key: K) => boolean): Collection<K, V>;
+    /** Map each value to a new array. */
+    map<T>(fn: (value: V, key: K) => T): T[];
+    /** True if any value matches. */
+    some(fn: (value: V, key: K) => boolean): boolean;
+    /** True if every value matches. */
+    every(fn: (value: V, key: K) => boolean): boolean;
+    /** Reduce over the values. */
+    reduce<T>(fn: (acc: T, value: V, key: K) => T, initial: T): T;
+    /** All values as an array. */
+    toArray(): V[];
+    /** A random value. */
+    random(): V | undefined;
+}

package/dist/collection.js

@@ -0,0 +1,65 @@
+// A Map with array-style helpers — district.js's workhorse return type, modelled
+// on discord.js's Collection.
+export class Collection extends Map {
+    first(n) {
+        if (n === undefined)
+            return this.values().next().value;
+        return [...this.values()].slice(0, n);
+    }
+    /** The last value. */
+    last() {
+        return [...this.values()].at(-1);
+    }
+    /** The first value matching a predicate. */
+    find(fn) {
+        for (const [k, v] of this)
+            if (fn(v, k))
+                return v;
+        return undefined;
+    }
+    /** A new Collection of the values matching a predicate. */
+    filter(fn) {
+        const out = new Collection();
+        for (const [k, v] of this)
+            if (fn(v, k))
+                out.set(k, v);
+        return out;
+    }
+    /** Map each value to a new array. */
+    map(fn) {
+        const out = [];
+        for (const [k, v] of this)
+            out.push(fn(v, k));
+        return out;
+    }
+    /** True if any value matches. */
+    some(fn) {
+        for (const [k, v] of this)
+            if (fn(v, k))
+                return true;
+        return false;
+    }
+    /** True if every value matches. */
+    every(fn) {
+        for (const [k, v] of this)
+            if (!fn(v, k))
+                return false;
+        return true;
+    }
+    /** Reduce over the values. */
+    reduce(fn, initial) {
+        let acc = initial;
+        for (const [k, v] of this)
+            acc = fn(acc, v, k);
+        return acc;
+    }
+    /** All values as an array. */
+    toArray() {
+        return [...this.values()];
+    }
+    /** A random value. */
+    random() {
+        const arr = this.toArray();
+        return arr[Math.floor(Math.random() * arr.length)];
+    }
+}

package/dist/formatters.d.ts

@@ -0,0 +1,9 @@
+export declare const Formatters: {
+    readonly bold: (text: string) => string;
+    readonly italic: (text: string) => string;
+    readonly strikethrough: (text: string) => string;
+    readonly code: (text: string) => string;
+    readonly codeBlock: (text: string, lang?: string) => string;
+    readonly blockQuote: (text: string) => string;
+    readonly link: (label: string, url: string) => string;
+};

package/dist/formatters.js

@@ -0,0 +1,11 @@
+// Markdown helpers for message content. District renders standard markdown, so
+// these produce text that renders as formatted in the app.
+export const Formatters = {
+    bold: (text) => `**${text}**`,
+    italic: (text) => `*${text}*`,
+    strikethrough: (text) => `~~${text}~~`,
+    code: (text) => `\`${text}\``,
+    codeBlock: (text, lang = "") => `\`\`\`${lang}\n${text}\n\`\`\``,
+    blockQuote: (text) => text.split("\n").map((l) => `> ${l}`).join("\n"),
+    link: (label, url) => `[${label}](${url})`,
+};

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 export { Client, type ClientEvents } from "./client.js";
 export { REST, DistrictAPIError, DEFAULT_API_BASE } from "./rest.js";
-export { ClientUser, Message, TextChannel, Interaction, type ClientContext } from "./structures.js";
+export { ClientUser, Message, TextChannel, Interaction, User, Space, SpaceMember, Role, type ClientContext, } from "./structures.js";
+export { Collection } from "./collection.js";
+export { PermissionsBitField, type PermissionResolvable, type PermissionFlagName } from "./permissions.js";
+export { Formatters } from "./formatters.js";
 export { verifySignature, parseEvent, verifyAndParse, type EventHeaders } from "./webhook.js";
-export type { ClientOptions, RawMessage, RawSelfUser, DistrictEvent, ReactionEvent, DeletedMessage, } from "./types.js";
+export type { ClientOptions, RawMessage, RawSelfUser, RawUser, RawSpace, RawChannel, RawRole, RawMember, DistrictEvent, ReactionEvent, DeletedMessage, } from "./types.js";

package/dist/index.js

@@ -6,5 +6,8 @@
 //   client.listen(3000);
 export { Client } from "./client.js";
 export { REST, DistrictAPIError, DEFAULT_API_BASE } from "./rest.js";
-export { ClientUser, Message, TextChannel, Interaction } from "./structures.js";
+export { ClientUser, Message, TextChannel, Interaction, User, Space, SpaceMember, Role, } from "./structures.js";
+export { Collection } from "./collection.js";
+export { PermissionsBitField } from "./permissions.js";
+export { Formatters } from "./formatters.js";
 export { verifySignature, parseEvent, verifyAndParse } from "./webhook.js";

package/dist/permissions.d.ts

@@ -0,0 +1,71 @@
+export type PermissionResolvable = bigint | number | string | PermissionFlagName | Array<bigint | number | string>;
+declare const FLAGS: {
+    readonly ViewChannel: bigint;
+    readonly SendMessages: bigint;
+    readonly ManageMessages: bigint;
+    readonly ManageChannels: bigint;
+    readonly ManageRoles: bigint;
+    readonly ManageSpace: bigint;
+    readonly KickMembers: bigint;
+    readonly BanMembers: bigint;
+    readonly ManageNicknames: bigint;
+    readonly MentionEveryone: bigint;
+    readonly Connect: bigint;
+    readonly Speak: bigint;
+    readonly MuteMembers: bigint;
+    readonly MoveMembers: bigint;
+    readonly PrioritySpeaker: bigint;
+    readonly AddReactions: bigint;
+    readonly EmbedLinks: bigint;
+    readonly AttachFiles: bigint;
+    readonly PinMessages: bigint;
+    readonly CreateInvites: bigint;
+    readonly Administrator: bigint;
+    readonly ManageThreads: bigint;
+    readonly ManageWebhooks: bigint;
+};
+export type PermissionFlagName = keyof typeof FLAGS;
+export declare class PermissionsBitField {
+    /** All permission flags, by name. */
+    static readonly Flags: {
+        readonly ViewChannel: bigint;
+        readonly SendMessages: bigint;
+        readonly ManageMessages: bigint;
+        readonly ManageChannels: bigint;
+        readonly ManageRoles: bigint;
+        readonly ManageSpace: bigint;
+        readonly KickMembers: bigint;
+        readonly BanMembers: bigint;
+        readonly ManageNicknames: bigint;
+        readonly MentionEveryone: bigint;
+        readonly Connect: bigint;
+        readonly Speak: bigint;
+        readonly MuteMembers: bigint;
+        readonly MoveMembers: bigint;
+        readonly PrioritySpeaker: bigint;
+        readonly AddReactions: bigint;
+        readonly EmbedLinks: bigint;
+        readonly AttachFiles: bigint;
+        readonly PinMessages: bigint;
+        readonly CreateInvites: bigint;
+        readonly Administrator: bigint;
+        readonly ManageThreads: bigint;
+        readonly ManageWebhooks: bigint;
+    };
+    bitfield: bigint;
+    constructor(permissions?: PermissionResolvable);
+    /** Resolve any permission input to a single bigint. */
+    static resolve(perm: PermissionResolvable): bigint;
+    /** True if the bitfield includes a permission (Administrator grants all). */
+    has(perm: PermissionResolvable): boolean;
+    /** Add permissions (returns this). */
+    add(...perms: PermissionResolvable[]): this;
+    /** Remove permissions (returns this). */
+    remove(...perms: PermissionResolvable[]): this;
+    /** The flag names contained in this bitfield. */
+    toArray(): PermissionFlagName[];
+    /** The integer value, as a string (safe for large bitfields). */
+    toString(): string;
+    valueOf(): bigint;
+}
+export {};

package/dist/permissions.js

@@ -0,0 +1,80 @@
+// A wrapper over District's permission bitfield (mirrors permission_flags), for
+// building and checking the permissions integer used by install links and roles.
+const FLAGS = {
+    ViewChannel: 1n << 0n,
+    SendMessages: 1n << 1n,
+    ManageMessages: 1n << 2n,
+    ManageChannels: 1n << 3n,
+    ManageRoles: 1n << 4n,
+    ManageSpace: 1n << 5n,
+    KickMembers: 1n << 6n,
+    BanMembers: 1n << 7n,
+    ManageNicknames: 1n << 8n,
+    MentionEveryone: 1n << 9n,
+    Connect: 1n << 10n,
+    Speak: 1n << 11n,
+    MuteMembers: 1n << 12n,
+    MoveMembers: 1n << 13n,
+    PrioritySpeaker: 1n << 14n,
+    AddReactions: 1n << 15n,
+    EmbedLinks: 1n << 16n,
+    AttachFiles: 1n << 17n,
+    PinMessages: 1n << 18n,
+    CreateInvites: 1n << 19n,
+    Administrator: 1n << 20n,
+    ManageThreads: 1n << 21n,
+    ManageWebhooks: 1n << 22n,
+};
+export class PermissionsBitField {
+    /** All permission flags, by name. */
+    static Flags = FLAGS;
+    bitfield;
+    constructor(permissions = 0n) {
+        this.bitfield = PermissionsBitField.resolve(permissions);
+    }
+    /** Resolve any permission input to a single bigint. */
+    static resolve(perm) {
+        if (typeof perm === "bigint")
+            return perm;
+        if (typeof perm === "number")
+            return BigInt(perm);
+        if (typeof perm === "string")
+            return perm in FLAGS ? FLAGS[perm] : BigInt(perm);
+        if (Array.isArray(perm))
+            return perm.reduce((acc, p) => acc | PermissionsBitField.resolve(p), 0n);
+        return 0n;
+    }
+    /** True if the bitfield includes a permission (Administrator grants all). */
+    has(perm) {
+        if ((this.bitfield & FLAGS.Administrator) === FLAGS.Administrator && perm !== "Administrator")
+            return true;
+        const bit = PermissionsBitField.resolve(perm);
+        return (this.bitfield & bit) === bit;
+    }
+    /** Add permissions (returns this). */
+    add(...perms) {
+        for (const p of perms)
+            this.bitfield |= PermissionsBitField.resolve(p);
+        return this;
+    }
+    /** Remove permissions (returns this). */
+    remove(...perms) {
+        for (const p of perms)
+            this.bitfield &= ~PermissionsBitField.resolve(p);
+        return this;
+    }
+    /** The flag names contained in this bitfield. */
+    toArray() {
+        return Object.keys(FLAGS).filter((name) => {
+            const bit = FLAGS[name];
+            return (this.bitfield & bit) === bit;
+        });
+    }
+    /** The integer value, as a string (safe for large bitfields). */
+    toString() {
+        return this.bitfield.toString();
+    }
+    valueOf() {
+        return this.bitfield;
+    }
+}

package/dist/structures.d.ts

@@ -1,5 +1,7 @@
 import type { REST } from "./rest.js";
-import type { RawMessage, RawSelfUser } from "./types.js";
+import type { RawMessage, RawSelfUser, RawUser, RawSpace, RawChannel, RawRole, RawMember } from "./types.js";
+import { Collection } from "./collection.js";
+import { PermissionsBitField } from "./permissions.js";
 /** Minimal client surface the structures need (avoids a circular import). */
 export interface ClientContext {
     rest: REST;
@@ -36,15 +38,82 @@ export declare class Message {
     react(emoji: string): Promise<void>;
     /** Remove the bot's reaction. */
     removeReaction(emoji: string): Promise<void>;
+    /** Fetch the author's full public profile. */
+    fetchAuthor(): Promise<User>;
+    /** A handle to the channel this message is in. */
+    get channel(): TextChannel;
 }
 export declare class TextChannel {
     private client;
     id: string;
+    /** Channel kind (text, voice, announcement, …) — populated after fetch(). */
+    kind: string | null;
+    name: string | null;
+    spaceId: string | null;
+    topic: string | null;
+    position: number | null;
     constructor(client: ClientContext, id: string);
+    /** Load this channel's info (kind, name, space). Returns itself. */
+    fetch(): Promise<this>;
+    /** @internal populate info fields from a raw channel row. */
+    applyInfo(raw: RawChannel): this;
     /** Send a message to this channel. */
     send(content: string): Promise<Message>;
     /** Fetch recent messages (oldest → newest), up to 100. */
-    fetchMessages(limit?: number): Promise<Message[]>;
+    fetchMessages(limit?: number): Promise<Collection<string, Message>>;
+}
+/** A District user's public profile. */
+export declare class User {
+    id: string;
+    handle: string;
+    displayName: string;
+    avatarUrl: string | null;
+    bannerUrl: string | null;
+    status: string | null;
+    bot: boolean;
+    constructor(raw: RawUser);
+    get username(): string;
+}
+/** A space (District's "server"/guild). Fetch related resources from it. */
+export declare class Space {
+    private client;
+    id: string;
+    short: string;
+    name: string;
+    tagline: string | null;
+    description: string | null;
+    ownerId: string;
+    boostLevel: number;
+    memberCount: number | null;
+    constructor(client: ClientContext, raw: RawSpace);
+    /** The space's channels (must have the app installed). */
+    channels(): Promise<Collection<string, TextChannel>>;
+    /** The space's members. */
+    members(limit?: number): Promise<Collection<string, SpaceMember>>;
+    /** The space's roles. */
+    roles(): Promise<Collection<string, Role>>;
+    /** The space owner's profile. */
+    fetchOwner(): Promise<User>;
+}
+/** A user's membership in a space. */
+export declare class SpaceMember {
+    private client;
+    spaceId: string;
+    userId: string;
+    nickname: string | null;
+    constructor(client: ClientContext, spaceId: string, raw: RawMember);
+    /** Fetch this member's full profile. */
+    user(): Promise<User>;
+}
+/** A space role, with a parsed permissions bitfield. */
+export declare class Role {
+    id: string;
+    name: string;
+    color: string;
+    position: number;
+    hoist: boolean;
+    permissions: PermissionsBitField;
+    constructor(raw: RawRole);
 }
 export declare class Interaction {
     private client;

package/dist/structures.js

@@ -1,5 +1,7 @@
 // Rich objects returned by the client — each carries a back-reference so you can
 // act on it directly: message.reply(), channel.send(), interaction.reply().
+import { Collection } from "./collection.js";
+import { PermissionsBitField } from "./permissions.js";
 export class ClientUser {
     id;
     handle;
@@ -58,14 +60,43 @@ export class Message {
     async removeReaction(emoji) {
         await this.client.rest.delete(`/channels/${this.channelId}/messages/${this.id}/reactions/${encodeURIComponent(emoji)}`);
     }
+    /** Fetch the author's full public profile. */
+    async fetchAuthor() {
+        const { user } = await this.client.rest.get(`/users/${this.authorId}`);
+        return new User(user);
+    }
+    /** A handle to the channel this message is in. */
+    get channel() {
+        return new TextChannel(this.client, this.channelId);
+    }
 }
 export class TextChannel {
     client;
     id;
+    /** Channel kind (text, voice, announcement, …) — populated after fetch(). */
+    kind = null;
+    name = null;
+    spaceId = null;
+    topic = null;
+    position = null;
     constructor(client, id) {
         this.client = client;
         this.id = id;
     }
+    /** Load this channel's info (kind, name, space). Returns itself. */
+    async fetch() {
+        const { channel } = await this.client.rest.get(`/channels/${this.id}`);
+        return this.applyInfo(channel);
+    }
+    /** @internal populate info fields from a raw channel row. */
+    applyInfo(raw) {
+        this.kind = raw.kind ?? null;
+        this.name = raw.name ?? null;
+        this.spaceId = raw.space_id ?? null;
+        this.topic = raw.topic ?? null;
+        this.position = raw.position ?? null;
+        return this;
+    }
     /** Send a message to this channel. */
     async send(content) {
         const { message } = await this.client.rest.post(`/channels/${this.id}/messages`, { content });
@@ -74,7 +105,117 @@ export class TextChannel {
     /** Fetch recent messages (oldest → newest), up to 100. */
     async fetchMessages(limit = 50) {
         const { messages } = await this.client.rest.get(`/channels/${this.id}/messages?limit=${limit}`);
-        return (messages ?? []).map((m) => new Message(this.client, m));
+        const out = new Collection();
+        for (const m of (messages ?? []))
+            out.set(m.id, new Message(this.client, m));
+        return out;
+    }
+}
+/** A District user's public profile. */
+export class User {
+    id;
+    handle;
+    displayName;
+    avatarUrl;
+    bannerUrl;
+    status;
+    bot;
+    constructor(raw) {
+        this.id = raw.id;
+        this.handle = raw.handle;
+        this.displayName = raw.display_name;
+        this.avatarUrl = raw.avatar_url;
+        this.bannerUrl = raw.banner_url ?? null;
+        this.status = raw.status ?? null;
+        this.bot = raw.is_bot;
+    }
+    get username() { return this.handle; }
+}
+/** A space (District's "server"/guild). Fetch related resources from it. */
+export class Space {
+    client;
+    id;
+    short;
+    name;
+    tagline;
+    description;
+    ownerId;
+    boostLevel;
+    memberCount;
+    constructor(client, raw) {
+        this.client = client;
+        this.id = raw.id;
+        this.short = raw.short;
+        this.name = raw.name;
+        this.tagline = raw.tagline;
+        this.description = raw.description;
+        this.ownerId = raw.owner_id;
+        this.boostLevel = raw.boost_level;
+        this.memberCount = raw.member_count ?? null;
+    }
+    /** The space's channels (must have the app installed). */
+    async channels() {
+        const { channels } = await this.client.rest.get(`/spaces/${this.id}/channels`);
+        const out = new Collection();
+        for (const c of (channels ?? []))
+            out.set(c.id, new TextChannel(this.client, c.id).applyInfo(c));
+        return out;
+    }
+    /** The space's members. */
+    async members(limit = 100) {
+        const { members } = await this.client.rest.get(`/spaces/${this.id}/members?limit=${limit}`);
+        const out = new Collection();
+        for (const m of (members ?? []))
+            out.set(m.user_id, new SpaceMember(this.client, this.id, m));
+        return out;
+    }
+    /** The space's roles. */
+    async roles() {
+        const { roles } = await this.client.rest.get(`/spaces/${this.id}/roles`);
+        const out = new Collection();
+        for (const r of (roles ?? []))
+            out.set(r.id, new Role(r));
+        return out;
+    }
+    /** The space owner's profile. */
+    async fetchOwner() {
+        const { user } = await this.client.rest.get(`/users/${this.ownerId}`);
+        return new User(user);
+    }
+}
+/** A user's membership in a space. */
+export class SpaceMember {
+    client;
+    spaceId;
+    userId;
+    nickname;
+    constructor(client, spaceId, raw) {
+        this.client = client;
+        this.spaceId = spaceId;
+        this.userId = raw.user_id;
+        this.nickname = raw.nickname;
+    }
+    /** Fetch this member's full profile. */
+    async user() {
+        const { user } = await this.client.rest.get(`/users/${this.userId}`);
+        return new User(user);
+    }
+}
+/** A space role, with a parsed permissions bitfield. */
+export class Role {
+    id;
+    name;
+    color;
+    position;
+    hoist;
+    permissions;
+    constructor(raw) {
+        this.id = raw.id;
+        this.name = raw.name;
+        this.color = raw.color;
+        this.position = raw.position;
+        this.hoist = raw.hoist;
+        this.permissions = new PermissionsBitField(raw.permissions);
     }
 }
 export class Interaction {

package/dist/types.d.ts

@@ -28,6 +28,50 @@ export interface RawSelfUser {
     avatar_url: string | null;
     is_bot: boolean;
 }
+/** A public user profile (`GET /users/:id`). */
+export interface RawUser {
+    id: string;
+    handle: string;
+    display_name: string;
+    avatar_url: string | null;
+    banner_url?: string | null;
+    status?: string | null;
+    is_bot: boolean;
+}
+/** A space (`GET /spaces/:id`). */
+export interface RawSpace {
+    id: string;
+    short: string;
+    name: string;
+    tagline: string | null;
+    description: string | null;
+    owner_id: string;
+    boost_level: number;
+    member_count?: number;
+}
+/** A channel (`GET /channels/:id`, `GET /spaces/:id/channels`). */
+export interface RawChannel {
+    id: string;
+    kind: string;
+    space_id: string | null;
+    name: string | null;
+    topic?: string | null;
+    position?: number;
+}
+/** A space role (`GET /spaces/:id/roles`). */
+export interface RawRole {
+    id: string;
+    name: string;
+    color: string;
+    permissions: string;
+    position: number;
+    hoist: boolean;
+}
+/** A space membership (`GET /spaces/:id/members`). */
+export interface RawMember {
+    user_id: string;
+    nickname: string | null;
+}
 export type DistrictEvent = {
     event: "message.create";
     space_id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "district.js",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A powerful Node.js module for building District bots — post, react, run slash commands, and receive events.",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,13 +11,23 @@
       "import": "./dist/index.js"
     }
   },
-  "files": ["dist"],
-  "engines": { "node": ">=18" },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
-  "keywords": ["district", "bot", "api", "chat", "sdk"],
+  "keywords": [
+    "district",
+    "bot",
+    "api",
+    "chat",
+    "sdk"
+  ],
   "license": "MIT",
   "devDependencies": {
     "@types/node": "^20.14.0",