virello 0.1.0 → 0.1.1

package/src/events/events.ts

@@ -26,7 +26,7 @@ import type { Option } from "../utilities/result/index";
 import type { InteractionHandler } from "./interactions/interactionHandler";
 import type { Listener } from "./listener";
 
-/** Discord and Rilo event names. ClientEvents supplies each event’s argument tuple. */
+/** Discord and Virello event names. ClientEvents supplies each event’s argument tuple. */
 export const Events = {
 	// #region Discord.js base events
 	/** Alias of the discord.js ApplicationCommandPermissionsUpdate event. Its payload follows discord.js ClientEvents. */
@@ -184,7 +184,7 @@ export const Events = {
 	WebhooksUpdate: DJSEvents.WebhooksUpdate as const,
 	// #endregion Discord.js base events
 
-	// #region Rilo events
+	// #region Virello events
 	// Message commands chain
 	/** A non-bot message enters prefix parsing. */
 	PreMessageParsed: "preMessageParsed" as const,
@@ -329,7 +329,7 @@ export const Events = {
 	/** A context-menu command attempt finished, with success state and duration. */
 	ContextMenuCommandFinish: "contextMenuCommandFinish" as const,
 
-	// #endregion Rilo events
+	// #endregion Virello events
 } as const;
 
 /** Module metadata attached to an error event. */
@@ -604,192 +604,207 @@ export interface AutocompleteInteractionPayload {
  * Local key alias for the typed event augmentation.
  * @internal
  */
-declare const RiloEvents: typeof Events;
+declare const VirelloEvents: typeof Events;
 
-/** Add Rilo events to the discord.js event map. */
+/** Add Virello events to the discord.js event map. */
 declare module "discord.js" {
 	/** Framework event argument tuples. Listen using Events constants. */
 	interface ClientEvents {
-		// #region Rilo load cycle events
+		// #region Virello load cycle events
 		/** A module was removed after successful cleanup. */
-		[RiloEvents.ModuleUnloaded]: [store: ModuleStore<Module>, module: Module];
+		[VirelloEvents.ModuleUnloaded]: [
+			store: ModuleStore<Module>,
+			module: Module,
+		];
 		/** A module finished activation and entered its store. */
-		[RiloEvents.ModuleLoaded]: [store: ModuleStore<Module>, module: Module];
+		[VirelloEvents.ModuleLoaded]: [store: ModuleStore<Module>, module: Module];
 
 		/** A listener’s run method threw or rejected. */
-		[RiloEvents.ListenerError]: [error: unknown, payload: ListenerErrorPayload];
+		[VirelloEvents.ListenerError]: [
+			error: unknown,
+			payload: ListenerErrorPayload,
+		];
 		/** A command’s application-registration hook failed. */
-		[RiloEvents.CommandApplicationCommandRegistryError]: [
+		[VirelloEvents.CommandApplicationCommandRegistryError]: [
 			error: unknown,
 			command: Command,
 		];
 		/** Application command registration is starting. */
-		[RiloEvents.ApplicationCommandRegistriesInitialising]: [];
+		[VirelloEvents.ApplicationCommandRegistriesInitialising]: [];
 		/** The registration pass completed, with the registry map and elapsed milliseconds. */
-		[RiloEvents.ApplicationCommandRegistriesRegistered]: [
+		[VirelloEvents.ApplicationCommandRegistriesRegistered]: [
 			registries: Map<string, ApplicationCommandRegistry>,
 			timeTaken: number,
 		];
 		/** One global or guild command list was replaced; a null guild ID means global. */
-		[RiloEvents.ApplicationCommandRegistriesBulkOverwrite]: [
+		[VirelloEvents.ApplicationCommandRegistriesBulkOverwrite]: [
 			result: Collection<Snowflake, ApplicationCommand>,
 			guildId: string | null,
 		];
 		/** A global or guild bulk overwrite failed; a null guild ID means global. */
-		[RiloEvents.ApplicationCommandRegistriesBulkOverwriteError]: [
+		[VirelloEvents.ApplicationCommandRegistriesBulkOverwriteError]: [
 			error: unknown,
 			guildId: string | null,
 		];
 
 		/** A non-bot message enters prefix parsing. */
-		[RiloEvents.PreMessageParsed]: [message: Message];
+		[VirelloEvents.PreMessageParsed]: [message: Message];
 		/** A message contains only the bot mention prefix. */
-		[RiloEvents.MentionPrefixOnly]: [message: Message];
+		[VirelloEvents.MentionPrefixOnly]: [message: Message];
 		/** No configured or mention prefix matched the message. */
-		[RiloEvents.NonPrefixedMessage]: [message: Message];
+		[VirelloEvents.NonPrefixedMessage]: [message: Message];
 		/** A message prefix matched, before command-name parsing. */
-		[RiloEvents.PrefixedMessage]: [message: Message, prefix: string | RegExp];
+		[VirelloEvents.PrefixedMessage]: [
+			message: Message,
+			prefix: string | RegExp,
+		];
 
 		/** No command name followed the matched prefix. */
-		[RiloEvents.UnknownMessageCommandName]: [
+		[VirelloEvents.UnknownMessageCommandName]: [
 			payload: UnknownMessageCommandNamePayload,
 		];
 		/** The parsed message command name was not found. */
-		[RiloEvents.UnknownMessageCommand]: [payload: UnknownMessageCommandPayload];
+		[VirelloEvents.UnknownMessageCommand]: [
+			payload: UnknownMessageCommandPayload,
+		];
 		/** A matched command has no messageRun handler. */
-		[RiloEvents.CommandDoesNotHaveMessageCommandHandler]: [
+		[VirelloEvents.CommandDoesNotHaveMessageCommandHandler]: [
 			payload: CommandDoesNotHaveMessageCommandHandler,
 		];
 		/** A message command is ready for precondition checks. */
-		[RiloEvents.PreMessageCommandRun]: [payload: PreMessageCommandRunPayload];
+		[VirelloEvents.PreMessageCommandRun]: [
+			payload: PreMessageCommandRunPayload,
+		];
 
 		/** Message command preconditions returned a denial. */
-		[RiloEvents.MessageCommandDenied]: [
+		[VirelloEvents.MessageCommandDenied]: [
 			error: UserError,
 			payload: MessageCommandDeniedPayload,
 		];
 		/** Message command preconditions passed; argument preparation and execution follow. */
-		[RiloEvents.MessageCommandAccepted]: [
+		[VirelloEvents.MessageCommandAccepted]: [
 			payload: MessageCommandAcceptedPayload,
 		];
 
 		/** A prepared message command is about to run. */
-		[RiloEvents.MessageCommandRun]: [
+		[VirelloEvents.MessageCommandRun]: [
 			message: Message,
 			command: Command,
 			payload: MessageCommandRunPayload,
 		];
 		/** A message command resolved successfully; the payload includes its result and duration. */
-		[RiloEvents.MessageCommandSuccess]: [payload: MessageCommandSuccessPayload];
+		[VirelloEvents.MessageCommandSuccess]: [
+			payload: MessageCommandSuccessPayload,
+		];
 		/** The message-command run phase threw or rejected. Argument preparation failures are reported through ListenerError. */
-		[RiloEvents.MessageCommandError]: [
+		[VirelloEvents.MessageCommandError]: [
 			error: unknown,
 			payload: MessageCommandErrorPayload,
 		];
 		/** A message command attempt finished, with success state and duration. */
-		[RiloEvents.MessageCommandFinish]: [
+		[VirelloEvents.MessageCommandFinish]: [
 			message: Message,
 			command: Command,
 			payload: MessageCommandFinishPayload,
 		];
 
 		/** Sending the message command’s typing indicator failed. */
-		[RiloEvents.MessageCommandTypingError]: [
+		[VirelloEvents.MessageCommandTypingError]: [
 			error: Error,
 			payload: MessageCommandTypingErrorPayload,
 		];
 
 		/** One extension lifecycle hook completed successfully. */
-		[RiloEvents.ExtensionLoaded]: [
+		[VirelloEvents.ExtensionLoaded]: [
 			hook: "setup" | "beforeLogin" | "afterLogin",
 			name: string | undefined,
 		];
 
 		/** An interaction handler’s parse method returned an Option without throwing. */
-		[RiloEvents.InteractionHandlerParseSuccess]: [
+		[VirelloEvents.InteractionHandlerParseSuccess]: [
 			option: Option<unknown>,
 			payload: InteractionHandlerParseSuccess,
 		];
 		/** A handler accepted an interaction with Some; its parsed value is included. */
-		[RiloEvents.InteractionHandlerParseSome]: [
+		[VirelloEvents.InteractionHandlerParseSome]: [
 			option: Option.Some<unknown>,
 			payload: InteractionHandlerParseSome,
 		];
 		/** A handler skipped an interaction with None. */
-		[RiloEvents.InteractionHandlerParseNone]: [
+		[VirelloEvents.InteractionHandlerParseNone]: [
 			option: Option.None,
 			payload: InteractionHandlerParseNone,
 		];
 		/** A handler’s parse method threw or rejected. */
-		[RiloEvents.InteractionHandlerParseError]: [
+		[VirelloEvents.InteractionHandlerParseError]: [
 			error: unknown,
 			payload: InteractionHandlerParseError,
 		];
 		/** An accepted interaction handler’s run method threw or rejected. */
-		[RiloEvents.InteractionHandlerError]: [
+		[VirelloEvents.InteractionHandlerError]: [
 			error: unknown,
 			payload: InteractionHandlerError,
 		];
 
 		/** An autocomplete interaction enters command lookup. */
-		[RiloEvents.PossibleAutocompleteInteraction]: [
+		[VirelloEvents.PossibleAutocompleteInteraction]: [
 			interaction: AutocompleteInteraction,
 		];
 		/** A command’s autocomplete handler threw or rejected. */
-		[RiloEvents.CommandAutocompleteInteractionError]: [
+		[VirelloEvents.CommandAutocompleteInteractionError]: [
 			error: unknown,
 			payload: AutocompleteInteractionPayload,
 		];
 		/** A command’s autocomplete handler completed successfully. */
-		[RiloEvents.CommandAutocompleteInteractionSuccess]: [
+		[VirelloEvents.CommandAutocompleteInteractionSuccess]: [
 			payload: AutocompleteInteractionPayload,
 		];
 
 		// Chat input command chain
 		/** A slash interaction enters command lookup. */
-		[RiloEvents.PossibleChatInputCommand]: [
+		[VirelloEvents.PossibleChatInputCommand]: [
 			interaction: ChatInputCommandInteraction,
 		];
 		/** No local command matched the slash interaction. */
-		[RiloEvents.UnknownChatInputCommand]: [
+		[VirelloEvents.UnknownChatInputCommand]: [
 			payload: UnknownChatInputCommandPayload,
 		];
 		/** The matched command has no slash handler. */
-		[RiloEvents.CommandDoesNotHaveChatInputCommandHandler]: [
+		[VirelloEvents.CommandDoesNotHaveChatInputCommandHandler]: [
 			payload: CommandDoesNotHaveChatInputCommandHandlerPayload,
 		];
 		/** A slash command is ready for precondition checks. */
-		[RiloEvents.PreChatInputCommandRun]: [
+		[VirelloEvents.PreChatInputCommandRun]: [
 			payload: PreChatInputCommandRunPayload,
 		];
 
 		/** The slash command’s preconditions denied the invocation. */
-		[RiloEvents.ChatInputCommandDenied]: [
+		[VirelloEvents.ChatInputCommandDenied]: [
 			error: UserError,
 			payload: ChatInputCommandDeniedPayload,
 		];
 		/** The slash command’s preconditions passed. */
-		[RiloEvents.ChatInputCommandAccepted]: [
+		[VirelloEvents.ChatInputCommandAccepted]: [
 			payload: ChatInputCommandAcceptedPayload,
 		];
 
 		/** An accepted slash handler is about to run. */
-		[RiloEvents.ChatInputCommandRun]: [
+		[VirelloEvents.ChatInputCommandRun]: [
 			interaction: ChatInputCommandInteraction,
 			command: ChatInputCommand,
 			payload: ChatInputCommandRunPayload,
 		];
 		/** A slash handler completed, with its return value and duration. */
-		[RiloEvents.ChatInputCommandSuccess]: [
+		[VirelloEvents.ChatInputCommandSuccess]: [
 			payload: ChatInputCommandSuccessPayload,
 		];
 		/** A slash command attempt threw or rejected. */
-		[RiloEvents.ChatInputCommandError]: [
+		[VirelloEvents.ChatInputCommandError]: [
 			error: unknown,
 			payload: ChatInputCommandErrorPayload,
 		];
 		/** A slash command attempt finished, with success state and duration. */
-		[RiloEvents.ChatInputCommandFinish]: [
+		[VirelloEvents.ChatInputCommandFinish]: [
 			interaction: ChatInputCommandInteraction,
 			command: ChatInputCommand,
 			payload: ChatInputCommandFinishPayload,
@@ -797,55 +812,55 @@ declare module "discord.js" {
 
 		// Context menu command chain
 		/** A context-menu interaction enters command lookup. */
-		[RiloEvents.PossibleContextMenuCommand]: [
+		[VirelloEvents.PossibleContextMenuCommand]: [
 			interaction: ContextMenuCommandInteraction,
 		];
 		/** No local command matched the context-menu interaction. */
-		[RiloEvents.UnknownContextMenuCommand]: [
+		[VirelloEvents.UnknownContextMenuCommand]: [
 			payload: UnknownContextMenuCommandPayload,
 		];
 		/** The matched command has no context-menu handler. */
-		[RiloEvents.CommandDoesNotHaveContextMenuCommandHandler]: [
+		[VirelloEvents.CommandDoesNotHaveContextMenuCommandHandler]: [
 			payload: CommandDoesNotHaveContextMenuCommandHandlerPayload,
 		];
 		/** A context-menu command is ready for precondition checks. */
-		[RiloEvents.PreContextMenuCommandRun]: [
+		[VirelloEvents.PreContextMenuCommandRun]: [
 			payload: PreContextMenuCommandRunPayload,
 		];
 
 		/** The context-menu command’s preconditions denied the invocation. */
-		[RiloEvents.ContextMenuCommandDenied]: [
+		[VirelloEvents.ContextMenuCommandDenied]: [
 			error: UserError,
 			payload: ContextMenuCommandDeniedPayload,
 		];
 		/** The context-menu command’s preconditions passed. */
-		[RiloEvents.ContextMenuCommandAccepted]: [
+		[VirelloEvents.ContextMenuCommandAccepted]: [
 			payload: ContextMenuCommandAcceptedPayload,
 		];
 
 		/** An accepted context-menu handler is about to run. */
-		[RiloEvents.ContextMenuCommandRun]: [
+		[VirelloEvents.ContextMenuCommandRun]: [
 			interaction: ContextMenuCommandInteraction,
 			command: ContextMenuCommand,
 			payload: ContextMenuCommandRunPayload,
 		];
 		/** A context-menu handler completed, with its return value and duration. */
-		[RiloEvents.ContextMenuCommandSuccess]: [
+		[VirelloEvents.ContextMenuCommandSuccess]: [
 			payload: ContextMenuCommandSuccessPayload,
 		];
 		/** A context-menu command attempt threw or rejected. */
-		[RiloEvents.ContextMenuCommandError]: [
+		[VirelloEvents.ContextMenuCommandError]: [
 			error: unknown,
 			payload: ContextMenuCommandErrorPayload,
 		];
 		/** A context-menu command attempt finished, with success state and duration. */
-		[RiloEvents.ContextMenuCommandFinish]: [
+		[VirelloEvents.ContextMenuCommandFinish]: [
 			interaction: ContextMenuCommandInteraction,
 			command: ContextMenuCommand,
 			payload: ContextMenuCommandFinishPayload,
 		];
 
-		// #endregion Rilo load cycle events
+		// #endregion Virello load cycle events
 
 		// #region Termination
 		/** Additional event names may supply arbitrary arguments. */

package/src/extensions/localisation/extension.ts

@@ -1,4 +1,4 @@
-import type { RiloClient } from "../../core/client/RiloClient";
+import type { VirelloClient } from "../../core/client/VirelloClient";
 import { Extension } from "../../core/lifecycle/Extension";
 import { container } from "../../core/modules/index";
 import { LocaleManager } from "./index";
@@ -9,7 +9,7 @@ export class LocaleExtension extends Extension {
 	 * Register translation resources and helpers during client construction.
 	 * @param client - Client being configured.
 	 */
-	static override setup(client: RiloClient): void {
+	static override setup(client: VirelloClient): void {
 		container.i18n = new LocaleManager(
 			client.options.extensions?.localisation || undefined,
 		);

package/src/extensions/patternCommands/extension.ts

@@ -1,4 +1,4 @@
-import type { RiloClient } from "../../core/client/RiloClient";
+import type { VirelloClient } from "../../core/client/VirelloClient";
 import { Extension } from "../../core/lifecycle/Extension";
 import { loadListeners, PatternCommandStore } from "./index";
 /** Built-in extension for regex message commands. Configure it through client.options.extensions. */
@@ -7,7 +7,7 @@ export class PatternExtension extends Extension {
 	 * Register regex message commands during client construction.
 	 * @param client - Client being configured.
 	 */
-	static override setup(client: RiloClient): void {
+	static override setup(client: VirelloClient): void {
 		client.modules.register(new PatternCommandStore());
 		loadListeners();
 	}

package/src/extensions/scheduledTasks/backends/RedisBackend.ts

@@ -32,7 +32,7 @@ export class RedisBackend implements TaskBackend {
 	constructor(
 		private readonly options: TaskSchedulerOptions & { redis_url: string },
 	) {
-		const prefix = `rilo:tasks:v1:{${encodeURIComponent(options.queue ?? "scheduled-tasks")}}`;
+		const prefix = `virello:tasks:v1:{${encodeURIComponent(options.queue ?? "scheduled-tasks")}}`;
 		this.keys = [`${prefix}:jobs`, `${prefix}:due`, `${prefix}:leases`];
 	}
 	async connect(): Promise<void> {

package/src/extensions/scheduledTasks/extension.ts

@@ -1,4 +1,4 @@
-import type { RiloClient } from "../../core/client/RiloClient";
+import type { VirelloClient } from "../../core/client/VirelloClient";
 import { Extension } from "../../core/lifecycle/Extension";
 import { container } from "../../core/modules/index";
 import { loadListeners, TaskScheduler, TaskStore } from "./index";
@@ -10,7 +10,7 @@ export class TasksExtension extends Extension {
 	 * Register scheduled task execution during client construction.
 	 * @param client - Client being configured.
 	 */
-	static override setup(client: RiloClient): void {
+	static override setup(client: VirelloClient): void {
 		const options = client.options.extensions?.scheduledtasks || {};
 		const tasks = new TaskScheduler(options);
 		container.tasks = tasks;

package/src/extensions/scheduledTasks/types/TaskTypes.ts

@@ -157,7 +157,7 @@ export interface RepeatedTask {
 	options: TaskOptions;
 }
 
-/** Augment rilo with your task names and payloads. */
+/** Augment virello with your task names and payloads. */
 export interface Tasks {}
 /** Task names declared in the augmentable Tasks interface. */
 export type TaskName = keyof Tasks;

package/src/extensions/services/extension.ts

@@ -1,4 +1,4 @@
-import type { RiloClient } from "../../core/client/RiloClient";
+import type { VirelloClient } from "../../core/client/VirelloClient";
 import { Extension } from "../../core/lifecycle/Extension";
 import { Services } from "./index";
 /** Built-in extension for shared service modules. Configure it through client.options.extensions. */
@@ -7,7 +7,7 @@ export class ServicesExtension extends Extension {
 	 * Register shared service modules during client construction.
 	 * @param client - Client being configured.
 	 */
-	static override setup(client: RiloClient): void {
+	static override setup(client: VirelloClient): void {
 		client.services = new Services();
 		client.modules.register(client.services.store);
 	}

package/src/extensions/subcommands/extension.ts

@@ -1,4 +1,4 @@
-import type { RiloClient } from "../../core/client/RiloClient";
+import type { VirelloClient } from "../../core/client/VirelloClient";
 import { Extension } from "../../core/lifecycle/Extension";
 import { loadListeners, loadPreconditions } from "./index";
 /** Built-in extension for subcommand dispatch and checks. Configure it through client.options.extensions. */
@@ -7,7 +7,7 @@ export class SubcommandsExtension extends Extension {
 	 * Register subcommand dispatch and checks during client construction.
 	 * @param client - Client being configured.
 	 */
-	static override setup(client: RiloClient): void {
+	static override setup(client: VirelloClient): void {
 		loadPreconditions();
 		const options = client.options.extensions?.subcommands;
 		if (options !== false && options?.logErrors !== false) loadListeners();

package/src/index.ts

@@ -1,5 +1,5 @@
 /**
- * Rilo client, modules, commands, events, extensions, and shared helpers. The separate engine API is available from rilo/engine.
+ * Virello client, modules, commands, events, extensions, and shared helpers. The separate engine API is available from virello/engine.
  * @packageDocumentation
  */
 import "./core/runtime";

package/src/public/client.ts

@@ -1,10 +1,10 @@
 /**
- * Create the Rilo Discord client, access shared services, and configure framework logging.
+ * Create the Virello Discord client, access shared services, and configure framework logging.
  * @packageDocumentation
  */
 import "../core/runtime";
 
 export { type Container, container } from "../core/Container";
-export * from "../core/client/RiloClient";
+export * from "../core/client/VirelloClient";
 export * from "../core/logging/index";
 export { version } from "../version";

package/src/sharding/client/Link.ts

@@ -36,14 +36,14 @@ export interface ShardConfig {
 	assignmentPollIntervalMs?: number;
 	maxDisconnectedLifetimeMs?: number;
 }
-/** Called only by RiloClient; ordinary clients never read transport credentials or open connections. */
+/** Called only by VirelloClient; ordinary clients never read transport credentials or open connections. */
 export function shardConfig(): ShardConfig | undefined {
-	const input = process.env.RILO_SHARD;
+	const input = process.env.VIRELLO_SHARD;
 	if (input === undefined) return undefined;
 	if (!process.send || !process.connected)
 		throw new ShardError(
 			"CONFIG",
-			"RILO_SHARD is reserved for ShardManager-owned Bun IPC children.",
+			"VIRELLO_SHARD is reserved for ShardManager-owned Bun IPC children.",
 		);
 	if (Buffer.byteLength(input) > 8192)
 		throw new ShardError("CONFIG", "Invalid managed shard configuration.");
@@ -83,7 +83,7 @@ interface Lifecycle {
 	logger: LoggerLike;
 }
 
-/** Typed messaging on one managed RiloClient. Handlers run local registered code only. */
+/** Typed messaging on one managed VirelloClient. Handlers run local registered code only. */
 export class ShardLink extends ShardMessenger {
 	private readonly handlers = new Map<string, Handler>();
 	private readonly active = new Map<string, Active>();
@@ -111,7 +111,7 @@ export class ShardLink extends ShardMessenger {
 	};
 	private dormantReason?: string;
 	/**
-	 * Created by RiloClient. Use client.sharding to register handlers and send requests.
+	 * Created by VirelloClient. Use client.sharding to register handlers and send requests.
 	 * @internal
 	 */
 	public constructor(

package/src/sharding/client/gateway.ts

@@ -2,7 +2,7 @@ import { type Client, WebSocketManager } from "discord.js";
 import { ShardError } from "../types";
 
 /** discord.js 14 adapter: retire its whole gateway manager to discard cached shard count/session resume data.
- * Keep the RiloClient, modules, REST client and application listeners alive across dormant assignments.
+ * Keep the VirelloClient, modules, REST client and application listeners alive across dormant assignments.
  * The exported WebSocketManager's lifecycle methods are private in its TypeScript declarations.
  */
 export class ManagedGateway {

package/src/sharding/coordinator/Coordinator.ts

@@ -424,7 +424,7 @@ export class ShardCoordinator {
 		if (this.transition)
 			return new Response("Coordinator draining shards", { status: 503 });
 		const connectionId = crypto.randomUUID();
-		const host = this.hosts.get(request.headers.get("x-rilo-worker") ?? "");
+		const host = this.hosts.get(request.headers.get("x-virello-worker") ?? "");
 		if (
 			!host ||
 			!tokenMatches(request.headers.get("authorization"), host.token)
@@ -443,7 +443,7 @@ export class ShardCoordinator {
 			return new Response("Unauthorized", { status: 401 });
 		}
 		if (request.method === "HEAD") {
-			const instance = request.headers.get("x-rilo-instance");
+			const instance = request.headers.get("x-virello-instance");
 			if (!identifier.allows(instance))
 				return new Response(null, { status: 400 });
 			const reason = this.sessions.has(`${host.id}/${instance}`)
@@ -451,7 +451,7 @@ export class ShardCoordinator {
 				: "";
 			return new Response(null, {
 				status: reason ? 409 : 204,
-				headers: { "x-rilo-reason": reason },
+				headers: { "x-virello-reason": reason },
 			});
 		}
 		const reject = (status: number, reason: string, text: string) => {
@@ -493,7 +493,7 @@ export class ShardCoordinator {
 				"native_upgrade_required",
 				"Native WebSocket upgrade required",
 			);
-		const instance = request.headers.get("x-rilo-instance");
+		const instance = request.headers.get("x-virello-instance");
 		if (!identifier.allows(instance))
 			return reject(400, "invalid_identity", "Invalid identity");
 		if (this.sessions.has(`${host.id}/${instance}`))

package/src/sharding/manager/Manager.ts

@@ -354,8 +354,8 @@ export class ShardManager extends ShardMessenger {
 				method: "HEAD",
 				headers: {
 					authorization: `Bearer ${this.options.token}`,
-					"x-rilo-worker": this.options.id,
-					"x-rilo-instance": this.instance,
+					"x-virello-worker": this.options.id,
+					"x-virello-instance": this.instance,
 				},
 				redirect: "error",
 				signal: AbortSignal.any([
@@ -380,7 +380,7 @@ export class ShardManager extends ShardMessenger {
 				"CONFIG",
 				"Coordinator admission endpoint is unavailable; check the URL and framework versions.",
 			);
-		const reason = response.headers.get("x-rilo-reason");
+		const reason = response.headers.get("x-virello-reason");
 		return reason === "host_already_connected"
 			? reason
 			: "coordinator_unavailable";
@@ -391,8 +391,8 @@ export class ShardManager extends ShardMessenger {
 				perMessageDeflate: false,
 				headers: {
 					authorization: `Bearer ${this.options.token}`,
-					"x-rilo-worker": this.options.id,
-					"x-rilo-instance": this.instance,
+					"x-virello-worker": this.options.id,
+					"x-virello-instance": this.instance,
 				},
 			});
 			this.socket = socket;
@@ -641,7 +641,7 @@ export class ShardManager extends ShardMessenger {
 					env: {
 						...process.env,
 						...this.options.env,
-						RILO_SHARD: encode(
+						VIRELLO_SHARD: encode(
 							{
 								shard: null,
 								count: this.count,

package/src/sharding/stats.ts

@@ -3,7 +3,7 @@ import type { Client } from "discord.js";
 import { ShardError, type ShardStats, type ShardStatsResult } from "./types";
 
 // Internal RPC uses the usual coordinator routing, ownership checks and request limits.
-export const statsRequest = "rilo:stats";
+export const statsRequest = "virello:stats";
 const nonnegative = type("number >= 0");
 const count = type("number.integer >= 0");
 const schema = type({

package/src/sharding/types.ts

@@ -1,6 +1,6 @@
 import type { LoggerLike } from "../core/logging/LoggerLike";
 
-/** Add named { input, output } request contracts by augmenting rilo. Inputs and outputs must be plain JSON values. */
+/** Add named { input, output } request contracts by augmenting virello. Inputs and outputs must be plain JSON values. */
 export interface ShardRequests {}
 /** Names declared in ShardRequests. */
 export type ShardRequestName = keyof ShardRequests & string;
@@ -211,7 +211,7 @@ export interface ShardCoordinatorOptions {
 	sessionStartLimit?: ShardSessionLimit;
 	/** Message, buffer, concurrency, and deadline limits. Omitted fields use ShardLimits defaults. */
 	limits?: ShardLimits;
-	/** Logger to reuse without taking ownership. Defaults to an owned Rilo console logger. */
+	/** Logger to reuse without taking ownership. Defaults to an owned Virello console logger. */
 	logger?: LoggerLike;
 }
 /** Child crash recovery settings. Delays use exponential backoff with jitter. */
@@ -267,7 +267,7 @@ export interface ShardManagerOptions {
 	maxDisconnectedLifetimeMs?: number;
 	/** Optional minimum local process pool, including standby capacity. Must fit the host's configured maxShards. */
 	processCount?: number;
-	/** Logger to reuse without taking ownership. Defaults to an owned Rilo console logger. */
+	/** Logger to reuse without taking ownership. Defaults to an owned Virello console logger. */
 	logger?: LoggerLike;
 }
 /** Copy of one local process slot’s latest supervisor state. */

package/src/utilities/collections/bitfield/BitField.ts

@@ -1,4 +1,4 @@
-const FlagEntriesSymbol = Symbol("rilo/bitfield.flags.entries");
+const FlagEntriesSymbol = Symbol("virello/bitfield.flags.entries");
 
 /** Resolve and combine named positive bit masks using either 32-bit numbers or bigints. */
 export class BitField<

package/src/utilities/decorators/module-decorators.ts

@@ -26,7 +26,7 @@ const originalApplicationCommandToProxy = new WeakMap<
 	CommandTarget<Command>
 >();
 
-/** Decorator function that applies given options to any Rilo module */
+/** Decorator function that applies given options to any Virello module */
 export function ApplyOptions<T extends Module.Options>(
 	optionsOrFn: T | ((parameters: ApplyOptionsCallbackParameters) => T),
 ): ClassDecorator {