virello 0.1.0 → 0.1.1

package/src/commands/checks/containers/Entry.ts

@@ -22,7 +22,7 @@ import type { IPreconditionContainer } from "./Container";
 
 /** Defines the simple options for the {@link PreconditionContainerSingle}, where only the name of the precondition can be defined. */
 export interface SimplePreconditionSingleResolvableDetails {
-	/** The name of the precondition to retrieve from {@link RiloClient.preconditions}. */
+	/** The name of the precondition to retrieve from {@link VirelloClient.preconditions}. */
 	name: SimplePreconditionKeys;
 }
 
@@ -30,7 +30,7 @@ export interface SimplePreconditionSingleResolvableDetails {
 export interface PreconditionSingleResolvableDetails<
 	K extends PreconditionKeys = PreconditionKeys,
 > {
-	/** The name of the precondition to retrieve from {@link RiloClient.preconditions}. */
+	/** The name of the precondition to retrieve from {@link VirelloClient.preconditions}. */
 	name: K;
 
 	/** The context to be set at {@link PreconditionContainerSingle.context}. */
@@ -43,7 +43,7 @@ export type PreconditionSingleResolvable =
 	| SimplePreconditionSingleResolvableDetails
 	| PreconditionSingleResolvableDetails;
 
-/** An {@link IPreconditionContainer} which runs a single precondition from {@link RiloClient.preconditions}. */
+/** An {@link IPreconditionContainer} which runs a single precondition from {@link VirelloClient.preconditions}. */
 export class PreconditionContainerSingle implements IPreconditionContainer {
 	/** Context passed to the precondition. String entries get an empty object. */
 	public readonly context: Record<PropertyKey, unknown>;

package/src/commands/registration/computeDifferences/option/channelTypes.ts

@@ -26,7 +26,7 @@ const channelTypeToPrettyName: Record<
 };
 
 const unknownChannelType = (type: number): string =>
-	`unknown channel type (${type}); please contact Rilo developers about this!`;
+	`unknown channel type (${type}); please contact Virello developers about this!`;
 
 function getChannelTypePrettyName(
 	type: keyof typeof channelTypeToPrettyName,

package/src/commands/registration/computeDifferences/option/type.ts

@@ -12,14 +12,14 @@ export function* checkOptionType({
 }): Generator<CommandDifference> {
 	const expectedTypeString =
 		optionTypeToPrettyName.get(expectedType) ??
-		`unknown (${expectedType}); please contact Rilo developers about this!`;
+		`unknown (${expectedType}); please contact Virello developers about this!`;
 
 	if (originalType !== expectedType) {
 		yield {
 			key,
 			original:
 				optionTypeToPrettyName.get(originalType) ??
-				`unknown (${originalType}); please contact Rilo developers about this!`,
+				`unknown (${originalType}); please contact Virello developers about this!`,
 			expected: expectedTypeString,
 		};
 	}

package/src/commands/registration/computeDifferences/options.ts

@@ -62,7 +62,7 @@ export function* checkOptions(
 			while ((option = existingOptions![index]) !== undefined) {
 				const expectedType =
 					optionTypeToPrettyName.get(option.type) ??
-					`unknown (${option.type}); please contact Rilo developers about this!`;
+					`unknown (${option.type}); please contact Virello developers about this!`;
 
 				yield {
 					key: `existing command option at index ${index}`,
@@ -91,7 +91,7 @@ function* reportOptionDifferences({
 	if (!existingOption) {
 		const expectedType =
 			optionTypeToPrettyName.get(option.type) ??
-			`unknown (${option.type}); please contact Rilo developers about this!`;
+			`unknown (${option.type}); please contact Virello developers about this!`;
 
 		yield {
 			key: keyPath(currentIndex),
@@ -295,7 +295,7 @@ function* handleSubcommandOptions({
 			while ((option = existingOptions![processedIndex]) !== undefined) {
 				const expectedType =
 					optionTypeToPrettyName.get(option.type) ??
-					`unknown (${option.type}); please contact Rilo developers about this!`;
+					`unknown (${option.type}); please contact Virello developers about this!`;
 
 				yield {
 					key: `existing command option at path ${keyPath(currentIndex)}.options[${processedIndex}]`,

package/src/commands/types.ts

@@ -18,7 +18,7 @@ import type { ApplicationCommandRegistry } from "./registration/Registry";
 export type DetailedDescriptionCommand =
 	string | DetailedDescriptionCommandObject;
 
-/** Augmentable shape for application-specific command help data. Rilo stores it without interpreting its fields. */
+/** Augmentable shape for application-specific command help data. Virello stores it without interpreting its fields. */
 export interface DetailedDescriptionCommandObject {}
 
 /** The allowed values for {@link CommandOptions.runIn}. */

package/src/core/Container.ts

@@ -3,16 +3,16 @@ import type { LocaleManager } from "../extensions/localisation/LocaleManager";
 import type { TaskScheduler } from "../extensions/scheduledTasks/TaskScheduler";
 import type { Services } from "../extensions/services/Services";
 import type { ShardLink } from "../sharding/client/Link";
-import type { RiloClient } from "./client/RiloClient";
+import type { VirelloClient } from "./client/VirelloClient";
 import type { LoggerLike } from "./logging/LoggerLike";
 import { ModuleRegistry } from "./modules/ModuleRegistry";
 
-/** Shared client services. Add your own properties by augmenting rilo. */
+/** Shared client services. Add your own properties by augmenting virello. */
 export interface Container {
 	/** The current module registry; initialized even before a client is created. */
 	modules: ModuleRegistry;
-	/** The active RiloClient. Available after construction and removed on shutdown. */
-	client: RiloClient;
+	/** The active VirelloClient. Available after construction and removed on shutdown. */
+	client: VirelloClient;
 	/** The active client's shard messaging and live stats API. */
 	readonly sharding: ShardLink;
 	/** The active client’s logger. Assigned during client construction. */
@@ -30,7 +30,7 @@ export interface Container {
 	services: Services;
 }
 
-/** Shared framework services. Client-specific entries are populated by RiloClient and enabled extensions. */
+/** Shared framework services. Client-specific entries are populated by VirelloClient and enabled extensions. */
 export const container = {
 	/** Initial shared registry, replaced by the active client’s module registry. */
 	modules: new ModuleRegistry(),

package/src/core/client/{RiloClient.ts → VirelloClient.ts}

@@ -50,8 +50,8 @@ export type Prefix = string | readonly string[] | null;
  */
 export type PrefixHook = (message: Message) => Awaitable<Prefix>;
 
-/** Rilo options added to discord.js ClientOptions. */
-export interface RiloClientOptions {
+/** Virello options added to discord.js ClientOptions. */
+export interface VirelloClientOptions {
 	/** Configure built-in features and custom extensions. Built-ins run first, in the documented extension order. */
 	extensions?: ExtensionOptions;
 	/** Base directory for module patterns. Defaults to cwd. */
@@ -73,7 +73,7 @@ export interface RiloClientOptions {
 	/** The regex prefix, an alternative to a mention or regular prefix to allow creating natural language command messages */
 	regexPrefix?: RegExp;
 
-	/** The prefix hook, by default it is a callback function that returns {@link RiloClientOptions.defaultPrefix}.
+	/** The prefix hook, by default it is a callback function that returns {@link VirelloClientOptions.defaultPrefix}.
 	 * @default () => client.options.defaultPrefix */
 	fetchPrefix?: PrefixHook;
 
@@ -82,7 +82,7 @@ export interface RiloClientOptions {
 
 	/** Supply your logger instance directly. Its identity and settings are preserved. */
 	logger?: LoggerLike;
-	/** Used only when Rilo creates its own logger. */
+	/** Used only when Virello creates its own logger. */
 	loggerOptions?: Partial<LoggerOptions>;
 	/** Formatting for the framework-created console logger. Supplied loggers are untouched. */
 	logging?: ConsoleLogOptions;
@@ -125,10 +125,12 @@ interface FeatureState {
 	restoreProperties: () => void;
 	active: boolean;
 }
-const clientState: { active?: RiloClient } = {};
+const clientState: { active?: VirelloClient } = {};
 
 /** One active Discord client owns the shared services. */
-export class RiloClient<Ready extends boolean = boolean> extends Client<Ready> {
+export class VirelloClient<
+	Ready extends boolean = boolean,
+> extends Client<Ready> {
 	/** Bot user ID used for mention prefixes, or null before it is known. */
 	public override id: Snowflake | null = null;
 	/** Resolve prefixes for each message. Defaults to returning options.defaultPrefix or null. */
@@ -161,8 +163,8 @@ export class RiloClient<Ready extends boolean = boolean> extends Client<Ready> {
 
 	/**
 	 * Create the shared client, register stores, and run synchronous extension setup. Discord connects at login.
-	 * @param options - Discord client options, including intents and Rilo settings.
-	 * @throws If options are invalid, another RiloClient is active, or required setup fails. Managed children reject
+	 * @param options - Discord client options, including intents and Virello settings.
+	 * @throws If options are invalid, another VirelloClient is active, or required setup fails. Managed children reject
 	 * conflicting shard options.
 	 */
 	public constructor(options: ClientOptions) {
@@ -197,7 +199,7 @@ export class RiloClient<Ready extends boolean = boolean> extends Client<Ready> {
 		])
 			if (key in options)
 				throw new TypeError(
-					`Rilo no longer supports "${key}". See BREAKING_CHANGES.md.`,
+					`Virello no longer supports "${key}". See BREAKING_CHANGES.md.`,
 				);
 		const extensions = resolveExtensions(options.extensions);
 		if (options.extensions?.scheduledtasks)
@@ -236,14 +238,14 @@ export class RiloClient<Ready extends boolean = boolean> extends Client<Ready> {
 			);
 		if (clientState.active)
 			throw new Error(
-				"Only one RiloClient can be active. Await client.destroy() before creating another.",
+				"Only one VirelloClient can be active. Await client.destroy() before creating another.",
 			);
 		super(options);
 		this.extensions = extensions;
 		this.logger =
 			options.logger ??
 			(this.ownedLogger = createConsoleLogger(
-				"Rilo",
+				"Virello",
 				options.loggerOptions,
 				options.logging,
 			));
@@ -350,7 +352,7 @@ export class RiloClient<Ready extends boolean = boolean> extends Client<Ready> {
 	 */
 	public load(): Promise<void> {
 		if (this.closed)
-			return Promise.reject(new Error("This RiloClient is closed."));
+			return Promise.reject(new Error("This VirelloClient is closed."));
 		return this.modules.load();
 	}
 
@@ -362,7 +364,7 @@ export class RiloClient<Ready extends boolean = boolean> extends Client<Ready> {
 	 */
 	public override login(token?: string): Promise<string> {
 		if (this.closed)
-			return Promise.reject(new Error("This RiloClient is closed."));
+			return Promise.reject(new Error("This VirelloClient is closed."));
 		this.loginPromise ??= this.connect(token);
 		return this.loginPromise;
 	}
@@ -592,11 +594,14 @@ export class RiloClient<Ready extends boolean = boolean> extends Client<Ready> {
 		}
 		if (clientState.active === this) clientState.active = undefined;
 		if (errors.length)
-			throw new AggregateError(errors, "Some Rilo features could not close.");
+			throw new AggregateError(
+				errors,
+				"Some Virello features could not close.",
+			);
 	}
 
 	private assertOpen(): void {
-		if (this.closed) throw new Error("This RiloClient is closed.");
+		if (this.closed) throw new Error("This VirelloClient is closed.");
 	}
 }
 
@@ -614,9 +619,9 @@ export interface CooldownOptions {
 	filteredCommands?: string[];
 }
 
-/** Add Rilo client properties and options to discord.js types. */
+/** Add Virello client properties and options to discord.js types. */
 declare module "discord.js" {
-	/** Framework services available on a RiloClient. */
+	/** Framework services available on a VirelloClient. */
 	interface Client {
 		/** Bot user ID used for mention prefixes, or null before it is known. */
 		id: Snowflake | null;
@@ -628,8 +633,8 @@ declare module "discord.js" {
 		fetchPrefix: PrefixHook;
 	}
 
-	/** Discord client options with Rilo configuration. */
-	interface ClientOptions extends RiloClientOptions {
+	/** Discord client options with Virello configuration. */
+	interface ClientOptions extends VirelloClientOptions {
 		/** Configure built-in features and custom extensions. */
 		extensions?: ExtensionOptions;
 	}

package/src/core/config/extensions.ts

@@ -5,7 +5,7 @@ import { TasksExtension } from "../../extensions/scheduledTasks/extension";
 import type { TaskSchedulerOptions } from "../../extensions/scheduledTasks/types/TaskTypes";
 import { ServicesExtension } from "../../extensions/services/extension";
 import { SubcommandsExtension } from "../../extensions/subcommands/extension";
-import type { CooldownOptions } from "../client/RiloClient";
+import type { CooldownOptions } from "../client/VirelloClient";
 import { Extension } from "../lifecycle/Extension";
 
 /** Settings for subcommand handling. */

package/src/core/index.ts

@@ -38,7 +38,7 @@ export * from "../events/listenerModuleLoader";
 export * from "../events/listenerStore";
 export type { Awaitable } from "../utilities/index";
 export * from "../utilities/result/index";
-export * from "./client/RiloClient";
+export * from "./client/VirelloClient";
 export * from "./lifecycle/Extension";
 export * from "./logging/index";
 export * from "./logging/LoggerLike";

package/src/core/lifecycle/Extension.ts

@@ -1,7 +1,7 @@
 import type { Awaitable } from "../../utilities/index";
-import type { RiloClient } from "../client/RiloClient";
+import type { VirelloClient } from "../client/VirelloClient";
 
-/** Base class for client features. Override static hooks; Rilo uses the class without constructing it. */
+/** Base class for client features. Override static hooks; Virello uses the class without constructing it. */
 export abstract class Extension {
 	/** Fail client startup when a hook fails if true. Otherwise disable this feature and clean up its registrations. Defaults to false. */
 	static readonly critical: boolean = false;
@@ -9,17 +9,17 @@ export abstract class Extension {
 	 * Register stores, modules, and resources synchronously during client construction.
 	 * @param _client - Client being configured. Use addDisposer for owned resources.
 	 */
-	static setup(_client: RiloClient): void {}
+	static setup(_client: VirelloClient): void {}
 	/**
 	 * Prepare services after modules and managed sharding load, before Discord login. Hooks run in extension order.
 	 * @param _client - Client being started.
 	 * @returns Completion of this phase.
 	 */
-	static beforeLogin(_client: RiloClient): Awaitable<void> {}
+	static beforeLogin(_client: VirelloClient): Awaitable<void> {}
 	/**
 	 * Start work after Discord login finishes. Hooks run in extension order.
 	 * @param _client - Connected client.
 	 * @returns Completion of this phase.
 	 */
-	static afterLogin(_client: RiloClient): Awaitable<void> {}
+	static afterLogin(_client: VirelloClient): Awaitable<void> {}
 }

package/src/core/loading/constants.ts

@@ -1,2 +1,2 @@
 export const VirtualPath = "::virtual::";
-export const RegisteredModules = Symbol("rilo:registeredModules");
+export const RegisteredModules = Symbol("virello:registeredModules");

package/src/core/logging/LoggerLike.ts

@@ -1,27 +1,27 @@
-/** The four methods Rilo uses. Existing logger instances stay untouched. */
+/** The four methods Virello uses. Existing logger instances stay untouched. */
 export interface LoggerLike {
 	/**
 	 * Write diagnostic detail.
 	 * @param value - Log value.
-	 * @returns The logger’s own result; Rilo ignores it.
+	 * @returns The logger’s own result; Virello ignores it.
 	 */
 	debug(value: unknown): unknown;
 	/**
 	 * Write an informational notice.
 	 * @param value - Log value.
-	 * @returns The logger’s own result; Rilo ignores it.
+	 * @returns The logger’s own result; Virello ignores it.
 	 */
 	notif(value: unknown): unknown;
 	/**
 	 * Write a warning.
 	 * @param value - Log value.
-	 * @returns The logger’s own result; Rilo ignores it.
+	 * @returns The logger’s own result; Virello ignores it.
 	 */
 	alert(value: unknown): unknown;
 	/**
 	 * Write a failure.
 	 * @param value - Log value, usually an Error.
-	 * @returns The logger’s own result; Rilo ignores it.
+	 * @returns The logger’s own result; Virello ignores it.
 	 */
 	error(value: unknown): unknown;
 }

package/src/core/logging/console.ts

@@ -59,7 +59,7 @@ function widthFor(settings: Settings, level: LogLevel): number {
 	return textWidth(
 		settings.output.width ??
 			settings.options.box?.width ??
-			Number(process.env.RILO_LOG_WIDTH),
+			Number(process.env.VIRELLO_LOG_WIDTH),
 		detected,
 	);
 }
@@ -138,18 +138,18 @@ function serialize(
 }
 
 /**
- * Create a logger with Rilo console formatting and the native logger’s streams, filters, and file lifecycle.
- * @param name - Logger name; defaults to Rilo.
+ * Create a logger with Virello console formatting and the native logger’s streams, filters, and file lifecycle.
+ * @param name - Logger name; defaults to Virello.
  * @param options - Native logger settings.
  * @param output - Console formatting and redaction settings.
  * @returns A new logger. Await close() when its resources are no longer needed.
  */
 export function createConsoleLogger(
-	name = "Rilo",
+	name = "Virello",
 	options: Partial<LoggerOptions> = {},
 	output: ConsoleLogOptions = {},
 ): Logger {
-	const requestedLevel = process.env.RILO_LOG_LEVEL?.toLowerCase() ?? "info";
+	const requestedLevel = process.env.VIRELLO_LOG_LEVEL?.toLowerCase() ?? "info";
 	const level =
 		options.level ??
 		(Object.hasOwn(levels, requestedLevel) ? levels[requestedLevel] : "NOTIF");
@@ -161,15 +161,15 @@ export function createConsoleLogger(
 		options.relativePaths !== undefined
 	)
 		return new Logger({ name, level, ...options });
-	const layout = options.layout ?? process.env.RILO_LOG_LAYOUT;
-	const detail = output.detail ?? process.env.RILO_LOG_DETAIL;
-	const stackSetting = output.stacks ?? process.env.RILO_LOG_STACKS;
+	const layout = options.layout ?? process.env.VIRELLO_LOG_LAYOUT;
+	const detail = output.detail ?? process.env.VIRELLO_LOG_DETAIL;
+	const stackSetting = output.stacks ?? process.env.VIRELLO_LOG_STACKS;
 	const settings: Settings = {
 		options,
 		output,
 		format:
 			output.format ??
-			(process.env.RILO_LOG_FORMAT === "json" ? "json" : "text"),
+			(process.env.VIRELLO_LOG_FORMAT === "json" ? "json" : "text"),
 		stacks:
 			stackSetting === "off" || stackSetting === "full"
 				? stackSetting

package/src/core/logging/format.ts

@@ -1,11 +1,11 @@
 import type { LogLevel } from "@lilsnibbi/logger";
 import { dataProperty, safeContext, safeText } from "./redact";
 
-/** Console output settings used when Rilo creates a logger. */
+/** Console output settings used when Virello creates a logger. */
 export interface ConsoleLogOptions {
-	/** Overrides RILO_LOG_FORMAT. Default: text. */
+	/** Overrides VIRELLO_LOG_FORMAT. Default: text. */
 	format?: "text" | "json";
-	/** Overrides RILO_LOG_STACKS. Default: short (three source locations). */
+	/** Overrides VIRELLO_LOG_STACKS. Default: short (three source locations). */
 	stacks?: "off" | "short" | "full";
 	/** Additional credential values to scrub. Values shorter than six characters are ignored. */
 	redact?: readonly string[];

package/src/core/runtime.ts

@@ -1,2 +1,2 @@
 if (typeof Bun === "undefined")
-	throw new Error("Rilo runs on Bun. Start your bot with bun.");
+	throw new Error("Virello runs on Bun. Start your bot with bun.");

package/src/engine/gateway/GatewayShard.ts

@@ -291,8 +291,8 @@ export class GatewayShard {
 						shard: this.shard,
 						properties: {
 							os: process.platform,
-							browser: "rilo-engine",
-							device: "rilo-engine",
+							browser: "virello-engine",
+							device: "virello-engine",
 						},
 					},
 				});

package/src/engine/rest/RestClient.ts

@@ -273,7 +273,8 @@ export class RestClient {
 		);
 		try {
 			const headers = new Headers({
-				"User-Agent": "RiloEngine (https://discord.com/developers/docs, 0.1.0)",
+				"User-Agent":
+					"VirelloEngine (https://discord.com/developers/docs, 0.1.0)",
 			});
 			if (request.auth !== false)
 				headers.set("Authorization", `Bot ${this.#token}`);