nubis 0.0.0-stage → 0.1.0-next.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EYTAK LIMITED
+
+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

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# nubis
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The Discord bot framework that feels like building a modern web app: file-based commands, types inferred from your definitions, typed components and modals, guards, and testing without Discord.
+
+```ts
+import { command, option } from "nubis";
+
+export default command({
+	description: "Say hi",
+	options: { who: option.user({ required: true }) },
+	run: ({ options, reply }) => reply(`Hi ${options.who.username}!`),
+});
+```
+
+- `nubis`: commands, components, modals, guards, and the HTTP interactions handler
+- `nubis/node`: load a bot from its folders, serve it with `node:http`
+- `nubis/testing`: run commands and components as Discord would, in tests
+
+Docs: https://eytak.com/nubis/docs. Source: https://github.com/Eytak-Technologies/nubis
+
+MIT. Built by [Eytak](https://eytak.com).

package/dist/api.d.ts

@@ -0,0 +1,12 @@
+import type { API } from "@discordjs/core/http-only";
+/**
+ * Handlers' `api` is @discordjs/core's typed client: `api.channels.createMessage`,
+ * `api.guilds.banUser`, and the rest of Discord's REST API, rate limits handled.
+ * Core declares NubisApi empty so it doesn't depend on an HTTP library; this
+ * fills it in for everyone who imports `nubis`.
+ */
+declare module "@nubisjs/core" {
+    interface NubisApi extends API {
+    }
+}
+export type { API } from "@discordjs/core/http-only";

package/dist/bot.d.ts

@@ -0,0 +1,45 @@
+import { type ErrorHandler, type NubisApi } from "@nubisjs/core";
+import { type GatewayDispatchPayload, type GatewayPresenceUpdateData } from "discord-api-types/v10";
+import type { Project } from "./loader";
+import { type RestLike } from "./rest-transport";
+import { type RouteOptions } from "./route";
+/** What the bot needs from a gateway connection; @discordjs/ws by default. */
+export interface GatewayLike {
+    on(event: "dispatch", listener: (payload: GatewayDispatchPayload, shardId: number) => void): unknown;
+    connect(): Promise<void>;
+    destroy(): Promise<void> | void;
+}
+export interface BotOptions {
+    readonly token: string;
+    readonly project: Project;
+    /** Intents beyond what the project's events need, e.g. MessageContent. */
+    readonly intents?: number;
+    /** The status and activity shown when the bot connects. */
+    readonly presence?: GatewayPresenceUpdateData;
+    /** Guards, middleware and timing for every interaction. */
+    readonly dispatch?: RouteOptions;
+    /** Every handler error, from interactions and events. */
+    readonly onError?: ErrorHandler;
+    /** Swappable in tests. */
+    readonly rest?: RestLike;
+    readonly gateway?: (options: {
+        intents: number;
+        rest: RestLike;
+        presence: GatewayPresenceUpdateData | null;
+    }) => GatewayLike;
+}
+export interface Bot {
+    /** Discord's REST API, authenticated as the bot. */
+    readonly rest: RestLike;
+    /** The typed API client handlers get as `api`. */
+    readonly api: NubisApi;
+    /** The intents the bot connects with. */
+    readonly intents: number;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+/**
+ * Connects a project to Discord's gateway: interactions go to their
+ * dispatchers, every other event to the project's event handlers.
+ */
+export declare function createBot(options: BotOptions): Bot;

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};