Release

.changeset/five-wolves-destroy.md

@@ -0,0 +1,5 @@
+---
+"reacord": minor
+---
+
+breaking: more descriptive component event types

.changeset/many-pets-melt.md

@@ -0,0 +1,33 @@
+---
+"reacord": minor
+---
+
+add new descriptive adapter methods
+
+The reacord instance names have been updated, and the old names are now deprecated.
+
+- `send` -> `createChannelMessage`
+- `reply` -> `createInteractionReply`
+
+These new methods also accept discord JS options. Usage example:
+
+```ts
+// can accept either a channel object or a channel ID
+reacord.createChannelMessage(channel)
+reacord.createChannelMessage(channel, {
+	tts: true,
+})
+reacord.createChannelMessage(channel, {
+	reply: {
+		messageReference: "123456789012345678",
+		failIfNotExists: false,
+	},
+})
+
+reacord.createInteractionReply(interaction)
+reacord.createInteractionReply(interaction, {
+	ephemeral: true,
+})
+```
+
+These new methods replace the old ones, which are now deprecated.

package.json

@@ -4,12 +4,9 @@
   "scripts": {
     "lint": "run-s --continue-on-error lint:*",
     "lint:eslint": "eslint . --fix --cache --cache-file=node_modules/.cache/.eslintcache --report-unused-disable-directives",
-    "lint:prettier": "prettier . --write --cache --list-different",
+    "lint:prettier": "prettier . \"**/*.astro\" --write --cache --list-different",
     "lint:types": "tsc -b & pnpm -r --parallel run typecheck",
     "astro-sync": "pnpm --filter website exec astro sync",
-    "format": "run-s --continue-on-error format:*",
-    "format:eslint": "eslint . --report-unused-disable-directives --fix",
-    "format:prettier": "prettier --cache --write . \"**/*.astro\"",
     "test": "vitest",
     "build": "pnpm -r run build",
     "build:website": "pnpm --filter website... run build",

packages/reacord/library/core/component-event.ts

@@ -9,41 +9,52 @@ export interface ComponentEvent {
 	 *
 	 * @see https://discord.com/developers/docs/resources/channel#message-object
 	 */
-	message: MessageInfo
+	message: ComponentEventMessage
 
 	/**
 	 * The channel that this event occurred in.
 	 *
 	 * @see https://discord.com/developers/docs/resources/channel#channel-object
 	 */
-	channel: ChannelInfo
+	channel: ComponentEventChannel
 
 	/**
 	 * The user that triggered this event.
 	 *
 	 * @see https://discord.com/developers/docs/resources/user#user-object
 	 */
-	user: UserInfo
+	user: ComponentEventUser
 
 	/**
 	 * The guild that this event occurred in.
 	 *
 	 * @see https://discord.com/developers/docs/resources/guild#guild-object
 	 */
-	guild?: GuildInfo
+	guild?: ComponentEventGuild
 
 	/** Create a new reply to this event. */
-	reply(content?: ReactNode): ReacordInstance
+	reply(
+		content?: ReactNode,
+		options?: ComponentEventReplyOptions,
+	): ReacordInstance
 
 	/**
 	 * Create an ephemeral reply to this event, shown only to the user who
 	 * triggered it.
+	 *
+	 * @deprecated Use event.reply(content, { ephemeral: true })
 	 */
 	ephemeralReply(content?: ReactNode): ReacordInstance
 }
 
 /** @category Component Event */
-export interface ChannelInfo {
+export interface ComponentEventReplyOptions {
+	ephemeral?: boolean
+	tts?: boolean
+}
+
+/** @category Component Event */
+export interface ComponentEventChannel {
 	id: string
 	name?: string
 	topic?: string
@@ -55,11 +66,11 @@ export interface ChannelInfo {
 }
 
 /** @category Component Event */
-export interface MessageInfo {
+export interface ComponentEventMessage {
 	id: string
 	channelId: string
 	authorId: string
-	member?: GuildMemberInfo
+	member?: ComponentEventGuildMember
 	content: string
 	timestamp: string
 	editedTimestamp?: string
@@ -70,14 +81,14 @@ export interface MessageInfo {
 }
 
 /** @category Component Event */
-export interface GuildInfo {
+export interface ComponentEventGuild {
 	id: string
 	name: string
-	member: GuildMemberInfo
+	member: ComponentEventGuildMember
 }
 
 /** @category Component Event */
-export interface GuildMemberInfo {
+export interface ComponentEventGuildMember {
 	id: string
 	nick?: string
 	displayName: string
@@ -92,7 +103,7 @@ export interface GuildMemberInfo {
 }
 
 /** @category Component Event */
-export interface UserInfo {
+export interface ComponentEventUser {
 	id: string
 	username: string
 	discriminator: string

packages/reacord/library/core/instance.ts

@@ -7,7 +7,7 @@ import type { ReactNode } from "react"
  */
 export interface ReacordInstance {
 	/** Render some JSX to this instance (edits the message) */
-	render: (content: ReactNode) => void
+	render: (content: ReactNode) => ReacordInstance
 
 	/** Remove this message */
 	destroy: () => void