reciple 9.9.0 → 10.0.0

package/assets/config/reciple.config.js

@@ -0,0 +1,87 @@
+// @ts-check
+import { Client, CommandType, CooldownAdapter, CooldownCommandPrecondition, MessageCommandFlagValidatePrecondition, MessageCommandOptionValidatePrecondition } from 'reciple';
+
+export const client = new Client({
+    token: process.env.TOKEN,
+    intents: [
+        'Guilds',
+        'GuildMessages',
+        'MessageContent'
+    ],
+    preconditions: [
+        new CooldownCommandPrecondition({
+            scope: [CommandType.Message, CommandType.Slash, CommandType.ContextMenu],
+            matchWithin: 'global',
+            deleteWhenExpired: true
+        }),
+        new MessageCommandOptionValidatePrecondition(),
+        new MessageCommandFlagValidatePrecondition()
+    ],
+    postconditions: [],
+    commands: [],
+    cooldownAdapter: CooldownAdapter,
+});
+
+/**
+ * @type {import('reciple').Config}
+ */
+export const config = {
+    token: process.env.DISCORD_TOKEN,
+    commands: {
+        message: {
+            prefix: context => '!',
+            separator: context => ' ',
+            splitOptions: {},
+            throwOnExecuteError: true
+        },
+        slash: {
+            acceptRepliedInteraction: true,
+            throwOnExecuteError: true
+        },
+        contextMenu: {
+            acceptRepliedInteraction: true,
+            throwOnExecuteError: true
+        },
+    },
+    applicationCommandsRegister: {
+        slashCommands: {
+            registerToGuilds: false,
+            registerGlobally: true
+        },
+        contextMenuCommands: {
+            registerToGuilds: false,
+            registerGlobally: true
+        },
+        registerToGuilds: false,
+        registerGlobally: true,
+        allowEmptyCommands: true
+    },
+    cooldowns: {
+        sweeperOptions: {
+            interval: 1000 * 60 * 60,
+            fetchAll: false
+        }
+    },
+    preconditions: {
+        returnOnFailure: false
+    },
+    postconditions: {
+        returnOnFailure: false
+    },
+    modules: {
+        directories: ["./modules/**"],
+        ignore: ["_*"],
+        filter: undefined
+    }
+};
+
+/**
+ * @type {import('reciple').BuildConfig}
+ */
+export const build = {
+    entry: ['./src/**/*.{js,jsx,ts,tsx}'],
+    tsconfig: './jsconfig.json',
+    outDir: './modules',
+    external: [],
+    noExternal: [],
+};

package/assets/config/reciple.config.ts

@@ -0,0 +1,80 @@
+import { Client, CommandType, CooldownAdapter, CooldownCommandPrecondition, MessageCommandFlagValidatePrecondition, MessageCommandOptionValidatePrecondition, type BuildConfig, type Config } from 'reciple';
+
+export const client = new Client({
+    token: process.env.TOKEN,
+    intents: [
+        'Guilds',
+        'GuildMessages',
+        'MessageContent'
+    ],
+    preconditions: [
+        new CooldownCommandPrecondition({
+            scope: [CommandType.Message, CommandType.Slash, CommandType.ContextMenu],
+            matchWithin: 'global',
+            deleteWhenExpired: true
+        }),
+        new MessageCommandOptionValidatePrecondition(),
+        new MessageCommandFlagValidatePrecondition()
+    ],
+    postconditions: [],
+    commands: [],
+    cooldownAdapter: CooldownAdapter,
+});
+
+export const config: Config = {
+    token: process.env.DISCORD_TOKEN,
+    commands: {
+        message: {
+            prefix: context => '!',
+            separator: context => ' ',
+            splitOptions: {},
+            throwOnExecuteError: true
+        },
+        slash: {
+            acceptRepliedInteraction: true,
+            throwOnExecuteError: true
+        },
+        contextMenu: {
+            acceptRepliedInteraction: true,
+            throwOnExecuteError: true
+        },
+    },
+    applicationCommandsRegister: {
+        slashCommands: {
+            registerToGuilds: false,
+            registerGlobally: true
+        },
+        contextMenuCommands: {
+            registerToGuilds: false,
+            registerGlobally: true
+        },
+        registerToGuilds: false,
+        registerGlobally: true,
+        allowEmptyCommands: true
+    },
+    cooldowns: {
+        sweeperOptions: {
+            interval: 1000 * 60 * 60,
+            fetchAll: false
+        }
+    },
+    preconditions: {
+        returnOnFailure: false
+    },
+    postconditions: {
+        returnOnFailure: false
+    },
+    modules: {
+        directories: ["./modules/**"],
+        ignore: ["_*"],
+        filter: undefined
+    }
+};
+
+export const build: BuildConfig = {
+    entry: ['./src/**/*.{js,jsx,ts,tsx}'],
+    tsconfig: './jsconfig.json',
+    outDir: './modules',
+    external: [],
+    noExternal: [],
+};

package/assets/global/README.md

@@ -0,0 +1 @@
+# reciple

package/assets/global/gitignore

@@ -0,0 +1,121 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+.env.test
+.env.production
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# Modules
+modules

package/assets/global/nodemon.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://raw.githubusercontent.com/SchemaStore/schemastore/master/src/schemas/json/nodemon.json",
+  "restartable": "r",
+  "ext": "js,jsx,ts,tsx,json",
+  "signal": "SIGHUP",
+  "watch": [
+    "src",
+    "reciple.config.js",
+    "reciple.config.ts",
+    ".env"
+  ],
+  "exec": "reciple start --build"
+}

package/assets/modules/javascript/Base.js

@@ -0,0 +1,21 @@
+// @ts-check
+import { BaseModule } from 'reciple';
+
+export class $MODULE_NAME$ extends BaseModule {
+    /** @param {BaseModule.EventData<false>} param0 */
+    async onEnable({ client }) {
+        // Write your code here
+    }
+
+    /** @param {BaseModule.EventData<true>} param0 */
+    async onReady({ client }) {
+        // Write your code here
+    }
+
+    /** @param {BaseModule.EventData<boolean>} param0 */
+    async onDisable({ client }) {
+        // Write your code here
+    }
+}
+
+export default new $MODULE_NAME$();

package/assets/modules/javascript/ClientEvent.js

@@ -0,0 +1,14 @@
+// @ts-check
+import { ClientEventModule } from "reciple";
+
+export class $MODULE_NAME$ extends ClientEventModule {
+    event = '$EVENT_NAME$';
+    // @ts-expect-error
+    once = $EVENT_ONCE$;
+
+    onEvent(...args) {
+        // Write your code here
+    }
+}
+
+export default new $MODULE_NAME$();

package/assets/modules/javascript/ContextMenuCommand.js

@@ -0,0 +1,17 @@
+// @ts-check
+import { ContextMenuCommandBuilder, ContextMenuCommandModule } from "reciple";
+
+export class $MODULE_NAME$ extends ContextMenuCommandModule {
+    data = new ContextMenuCommandBuilder()
+        .setName('$COMMAND_NAME$')
+        // @ts-expect-error
+        .setType($COMMAND_CONTEXT_MENU_TYPE$)
+        .toJSON();
+
+    /** @param {import('reciple').ContextMenuCommand.ExecuteData} param0 */
+    async execute({ interaction }) {
+        // Write your code here
+    }
+}
+
+export default new $MODULE_NAME$();

package/assets/modules/javascript/Event.js

@@ -0,0 +1,17 @@
+// @ts-check
+import { EventModule } from "reciple";
+
+export class $MODULE_NAME$ extends EventModule {
+    // @ts-expect-error
+    emitter = $EVENT_EMITTER$;
+    event = '$EVENT_NAME$';
+    // @ts-expect-error
+    once = $EVENT_ONCE$;
+
+    // @ts-expect-error
+    onEvent(...args) {
+        // Write your code here
+    }
+}
+
+export default new $MODULE_NAME$();

package/assets/modules/javascript/MessageCommand.js

@@ -0,0 +1,16 @@
+// @ts-check
+import { MessageCommandBuilder, MessageCommandModule } from "reciple";
+
+export class $MODULE_NAME$ extends MessageCommandModule {
+    data = new MessageCommandBuilder()
+        .setName('$COMMAND_NAME$')
+        .setDescription('$COMMAND_DESCRIPTION$')
+        .toJSON();
+
+    /** @param {import('reciple').MessageCommand.ExecuteData} param0 */
+    async execute({ message }) {
+        // Write your code here
+    }
+}
+
+export default new $MODULE_NAME$();

package/assets/modules/javascript/RESTEvent.js

@@ -0,0 +1,14 @@
+// @ts-check
+import { RESTEventModule } from "reciple";
+
+export class $MODULE_NAME$ extends RESTEventModule {
+    event = '$EVENT_NAME$';
+    // @ts-expect-error
+    once = $EVENT_ONCE$;
+
+    onEvent(...args) {
+        // Write your code here
+    }
+}
+
+export default new $MODULE_NAME$();

package/assets/modules/javascript/SlashCommand.js

@@ -0,0 +1,16 @@
+// @ts-check
+import { SlashCommandBuilder, SlashCommandModule } from "reciple";
+
+export class $MODULE_NAME$ extends SlashCommandModule {
+    data = new SlashCommandBuilder()
+        .setName('$COMMAND_NAME$')
+        .setDescription('$COMMAND_DESCRIPTION$')
+        .toJSON();
+
+    /** @param {import('reciple').SlashCommand.ExecuteData} param0 */
+    async execute({ interaction }) {
+        // Write your code here
+    }
+}
+
+export default new $MODULE_NAME$();

package/assets/modules/typescript/Base.ts

@@ -0,0 +1,17 @@
+import { BaseModule } from 'reciple';
+
+export class $MODULE_NAME$ extends BaseModule {
+    async onEnable({ client }: BaseModule.EventData<false>) {
+        // Write your code here
+    }
+
+    async onReady({ client }: BaseModule.EventData<true>) {
+        // Write your code here
+    }
+
+    async onDisable({ client }: BaseModule.EventData<true>) {
+        // Write your code here
+    }
+}
+
+export default new $MODULE_NAME$();

package/assets/modules/typescript/ClientEvent.ts

@@ -0,0 +1,15 @@
+import { ClientEventModule } from "reciple";
+
+// @ts-expect-error
+export class $MODULE_NAME$ extends ClientEventModule<'$EVENT_NAME$'> {
+    // @ts-expect-error
+    event = '$EVENT_NAME$';
+    // @ts-expect-error
+    once = $EVENT_ONCE$;
+
+    onEvent(...args) {
+        // Write your code here
+    }
+}
+
+export default new $MODULE_NAME$();

package/assets/modules/typescript/ContextMenuCommand.ts

@@ -0,0 +1,15 @@
+import { ContextMenuCommandBuilder, ContextMenuCommandModule, type ContextMenuCommand } from "reciple";
+
+export class $MODULE_NAME$ extends ContextMenuCommandModule {
+    data = new ContextMenuCommandBuilder()
+        .setName('$COMMAND_NAME$')
+        // @ts-expect-error
+        .setType($COMMAND_CONTEXT_MENU_TYPE$)
+        .toJSON();
+
+    async execute({ interaction }: ContextMenuCommand.ExecuteData) {
+        // Write your code here
+    }
+}
+
+export default new $MODULE_NAME$();

package/assets/modules/typescript/Event.ts

@@ -0,0 +1,16 @@
+import { EventModule } from "reciple";
+
+export class $MODULE_NAME$ extends EventModule {
+    // @ts-expect-error
+    emitter = $EVENT_EMITTER$;
+    event = '$EVENT_NAME$';
+    // @ts-expect-error
+    once = $EVENT_ONCE$;
+
+    // @ts-expect-error
+    onEvent(...args) {
+        // Write your code here
+    }
+}
+
+export default new $MODULE_NAME$();

package/assets/modules/typescript/MessageCommand.ts

@@ -0,0 +1,14 @@
+import { MessageCommandBuilder, MessageCommandModule, type MessageCommand } from "reciple";
+
+export class $MODULE_NAME$ extends MessageCommandModule {
+    data = new MessageCommandBuilder()
+        .setName('$COMMAND_NAME$')
+        .setDescription('$COMMAND_DESCRIPTION$')
+        .toJSON();
+
+    async execute({ message }: MessageCommand.ExecuteData) {
+        // Write your code here
+    }
+}
+
+export default new $MODULE_NAME$();

package/assets/modules/typescript/RESTEvent.ts

@@ -0,0 +1,15 @@
+import { RESTEventModule } from "reciple";
+
+// @ts-expect-error
+export class $MODULE_NAME$ extends RESTEventModule<'$EVENT_NAME$'> {
+    // @ts-expect-error
+    event = '$EVENT_NAME$';
+    // @ts-expect-error
+    once = $EVENT_ONCE$;
+
+    onEvent(...args) {
+        // Write your code here
+    }
+}
+
+export default new $MODULE_NAME$();

package/assets/modules/typescript/SlashCommand.ts

@@ -0,0 +1,14 @@
+import { SlashCommandBuilder, SlashCommandModule, type SlashCommand } from "reciple";
+
+export class $MODULE_NAME$ extends SlashCommandModule {
+    data = new SlashCommandBuilder()
+        .setName('$COMMAND_NAME$')
+        .setDescription('$COMMAND_DESCRIPTION$')
+        .toJSON();
+
+    async execute({ interaction }: SlashCommand.ExecuteData) {
+        // Write your code here
+    }
+}
+
+export default new $MODULE_NAME$();

package/assets/templates/javascript/jsconfig.json

@@ -0,0 +1,17 @@
+{
+  "extends": "@reciple/utils/tsconfig.json",
+  "include": [
+    "./src/**/*"
+  ],
+  "compilerOptions": {
+    "baseUrl": "./",
+    "rootDir": "./src",
+    "outDir": "./modules",
+    "allowJs": true,
+    "jsx": "react-jsx",
+    "jsxImportSource": "@reciple/jsx",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  }
+}

package/assets/templates/typescript/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "extends": "@reciple/utils/tsconfig.json",
+  "include": [
+    "./src/**/*"
+  ],
+  "compilerOptions": {
+    "baseUrl": "./",
+    "rootDir": "./src",
+    "outDir": "./modules",
+    "allowJs": true,
+    "jsx": "react-jsx",
+    "jsxImportSource": "@reciple/jsx",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  }
+}

package/dist/_virtual/_@oxc-project_runtime@0.99.0/helpers/decorate.mjs

@@ -0,0 +1,10 @@
+//#region \0@oxc-project+runtime@0.99.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+//#endregion
+export { __decorate };

package/dist/bin/commands/build.d.mts

@@ -0,0 +1,16 @@
+import { CLISubcommand } from "../../classes/cli/CLISubcommand.mjs";
+import { Command } from "commander";
+
+//#region src/bin/commands/build.d.ts
+declare class BuildSubcommand extends CLISubcommand {
+  subcommand: Command;
+  execute(): Promise<void>;
+}
+declare namespace BuildSubcommand {
+  interface Flags {
+    config?: string;
+  }
+}
+//#endregion
+export { BuildSubcommand, BuildSubcommand as default };
+//# sourceMappingURL=build.d.mts.map

package/dist/bin/commands/build.mjs

@@ -0,0 +1,24 @@
+import { CLISubcommand } from "../../classes/cli/CLISubcommand.mjs";
+import { CLI } from "../../classes/cli/CLI.mjs";
+import { ConfigReader } from "../../classes/cli/ConfigReader.mjs";
+import { Command } from "commander";
+import { build } from "tsdown";
+
+//#region src/bin/commands/build.ts
+var BuildSubcommand = class extends CLISubcommand {
+	subcommand = new Command("build").description("Build the reciple modules defined in config file").option("-c, --config <path>", "Path to the configuration file");
+	async execute() {
+		const { build: buildConfig } = await new ConfigReader(this.subcommand.opts().config ?? await ConfigReader.findConfig(process.cwd()) ?? ConfigReader.createConfigFilename("js")).read({ createIfNotExists: false });
+		let plugins = buildConfig.plugins ? Array.isArray(buildConfig.plugins) ? buildConfig.plugins : [buildConfig.plugins] : [];
+		plugins.push(CLI.createTsdownLogger(this.cli.logger));
+		await build({
+			...buildConfig,
+			logLevel: "silent",
+			plugins
+		});
+	}
+};
+
+//#endregion
+export { BuildSubcommand as default };
+//# sourceMappingURL=build.mjs.map

package/dist/bin/commands/build.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.mjs","names":[],"sources":["../../../src/bin/commands/build.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { CLISubcommand } from '../../classes/cli/CLISubcommand.js';\nimport { ConfigReader } from '../../classes/cli/ConfigReader.js';\nimport { build } from 'tsdown';\nimport { CLI } from '../../classes/cli/CLI.js';\n\nexport default class BuildSubcommand extends CLISubcommand {\n    public subcommand: Command = new Command('build')\n        .description('Build the reciple modules defined in config file')\n        .option('-c, --config <path>', 'Path to the configuration file');\n\n    public async execute(): Promise<void> {\n        const flags = this.subcommand.opts<BuildSubcommand.Flags>();\n\n        const configReader = new ConfigReader(\n            flags.config\n            ?? await ConfigReader.findConfig(process.cwd())\n            ?? ConfigReader.createConfigFilename('js')\n        );\n\n        const { build: buildConfig } = await configReader.read({\n            createIfNotExists: false\n        });\n\n        let plugins = buildConfig.plugins\n            ? Array.isArray(buildConfig.plugins)\n                ? buildConfig.plugins\n                : [buildConfig.plugins]\n            : [];\n\n        plugins.push(CLI.createTsdownLogger(this.cli.logger));\n\n        await build({\n            ...buildConfig,\n            logLevel: 'silent',\n            plugins,\n        });\n    }\n}\n\nexport namespace BuildSubcommand {\n    export interface Flags {\n        config?: string;\n    }\n}\n"],"mappings":";;;;;;;AAMA,IAAqB,kBAArB,cAA6C,cAAc;CACvD,AAAO,aAAsB,IAAI,QAAQ,QAAQ,CAC5C,YAAY,mDAAmD,CAC/D,OAAO,uBAAuB,iCAAiC;CAEpE,MAAa,UAAyB;EASlC,MAAM,EAAE,OAAO,gBAAgB,MANV,IAAI,aAFX,KAAK,WAAW,MAA6B,CAGjD,UACH,MAAM,aAAa,WAAW,QAAQ,KAAK,CAAC,IAC5C,aAAa,qBAAqB,KAAK,CAC7C,CAEiD,KAAK,EACnD,mBAAmB,OACtB,CAAC;EAEF,IAAI,UAAU,YAAY,UACpB,MAAM,QAAQ,YAAY,QAAQ,GAC9B,YAAY,UACZ,CAAC,YAAY,QAAQ,GACzB,EAAE;AAER,UAAQ,KAAK,IAAI,mBAAmB,KAAK,IAAI,OAAO,CAAC;AAErD,QAAM,MAAM;GACR,GAAG;GACH,UAAU;GACV;GACH,CAAC"}

package/dist/bin/commands/create.d.mts

@@ -0,0 +1,23 @@
+import { CLISubcommand } from "../../classes/cli/CLISubcommand.mjs";
+import { Command } from "commander";
+import { PackageManagerName } from "nypm";
+
+//#region src/bin/commands/create.d.ts
+declare class CreateSubcommand extends CLISubcommand {
+  subcommand: Command;
+  execute(): Promise<void>;
+}
+declare namespace CreateSubcommand {
+  interface Flags {
+    config?: string;
+    token?: string;
+    default?: boolean;
+    typescript?: boolean;
+    packageManager?: PackageManagerName;
+    install: boolean;
+    build: boolean;
+  }
+}
+//#endregion
+export { CreateSubcommand, CreateSubcommand as default };
+//# sourceMappingURL=create.d.mts.map