@seedcord/cli 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,207 @@
+import { ILogger } from '@seedcord/types';
+import { Command } from 'commander';
+
+interface ModuleLoader {
+    importModule<TModule = unknown>(entryPath: string): Promise<TModule>;
+}
+
+type MaybePromise<TValue> = TValue | Promise<TValue>;
+interface SeedcordLike {
+    start: () => MaybePromise<unknown>;
+}
+declare class SeedcordInstanceLoader {
+    private readonly modules;
+    private readonly logger;
+    constructor(modules: ModuleLoader, logger: ILogger);
+    load(instancePath: string): Promise<SeedcordLike>;
+    private isSeedcordLike;
+}
+
+interface SeedcordBuildConfig {
+    /**
+     * Directory where build artifacts should be emitted. Defaults to ./dist relative to the config directory.
+     */
+    outDir?: string;
+    /**
+     * Optional tsconfig path to use for builds. Defaults to the nearest tsconfig.build.json or tsconfig.json.
+     */
+    tsconfig?: string;
+    /**
+     * File name (or relative path) for the bootstrap file emitted inside the build output.
+     */
+    bootstrap?: string;
+}
+/**
+ * Configuration used by the Seedcord CLI when running `seedcord dev` or `seedcord build`.
+ */
+interface SeedcordDevConfig {
+    /**
+     * Root directory used for resolving relative paths. Defaults to the config directory.
+     */
+    root?: string;
+    /**
+     * Path to the module whose default export is a configured Seedcord instance.
+     */
+    instance: string;
+    /**
+     * Entry file that should be executed when starting the bot (and copied into the build output).
+     */
+    entry: string;
+    /**
+     * Optional build configuration overrides.
+     */
+    build?: SeedcordBuildConfig;
+}
+interface ResolvedSeedcordBuildConfig {
+    outDir: string;
+    bootstrap: string;
+    tsconfig?: string;
+}
+/**
+ * Fully resolved configuration with absolute file system paths.
+ */
+interface ResolvedSeedcordDevConfig extends Required<Omit<SeedcordDevConfig, 'build'>> {
+    /**
+     * Absolute path to the config file that produced this resolution.
+     */
+    configFile: string;
+    /**
+     * Resolved build options with absolute paths.
+     */
+    build: ResolvedSeedcordBuildConfig;
+}
+/**
+ * Supported configuration filenames discovered by the CLI.
+ */
+declare const SEEDCORD_CONFIG_FILENAMES: readonly ["seedcord.config.ts", "seedcord.config.mts"];
+/**
+ * Helper so config files receive proper type inference.
+ */
+declare function defineConfig(config: SeedcordDevConfig): SeedcordDevConfig;
+
+declare class ConfigLoader {
+    private readonly modules;
+    private readonly logger;
+    constructor(modules: ModuleLoader, logger: ILogger);
+    load(configPath: string): Promise<ResolvedSeedcordDevConfig>;
+    private unwrapConfig;
+    private resolveWithinRoot;
+    private assertEntryWithinRoot;
+    private resolveBuildOptions;
+    private resolveBootstrap;
+}
+
+declare class ConfigLocator {
+    private readonly logger;
+    constructor(logger: ILogger);
+    locate(baseDir?: string): string;
+}
+
+/**
+ * Coordinates config discovery, loading, and starting a Seedcord instance.
+ */
+declare class SeedcordDevRunner {
+    private readonly locator;
+    private readonly configLoader;
+    private readonly instanceLoader;
+    private readonly logger;
+    constructor(locator: ConfigLocator, configLoader: ConfigLoader, instanceLoader: SeedcordInstanceLoader, logger: ILogger);
+    static create(logger: ILogger): SeedcordDevRunner;
+    run(): Promise<void>;
+    private loadConfig;
+}
+
+declare class DevCommand {
+    private readonly runner;
+    private readonly logger;
+    constructor(runner: SeedcordDevRunner, logger: ILogger);
+    register(program: Command): void;
+    static create(logger: ILogger): DevCommand;
+}
+
+declare class BootstrapWriter {
+    private readonly logger;
+    constructor(logger: ILogger);
+    write(config: ResolvedSeedcordDevConfig, emittedEntry: string): Promise<void>;
+    private formatImportPath;
+}
+
+interface EntryPointCollection {
+    entryMap: Record<string, string>;
+    primaryKey: string;
+}
+declare class EntryPointCollector {
+    collect(config: ResolvedSeedcordDevConfig, tsconfigPath: string): EntryPointCollection;
+    private parseTsconfig;
+    private shouldEmitFile;
+    private isWithinRoot;
+    private createEntryKey;
+    private createEntryFallback;
+    private formatDiagnostics;
+}
+
+declare class RelativeSpecifierTransformer {
+    transform(outDir: string): Promise<void>;
+    private collectJavaScriptFiles;
+    private rewriteFile;
+    private extractSpecifierReplacements;
+    private scheduleReplacement;
+    private appendJsExtension;
+}
+
+interface BuildResult {
+    emittedEntry: string;
+}
+declare class TypeScriptProjectBuilder {
+    private readonly logger;
+    private readonly entries;
+    private readonly specifierTransformer;
+    constructor(logger: ILogger, entries?: EntryPointCollector, specifierTransformer?: RelativeSpecifierTransformer);
+    build(config: ResolvedSeedcordDevConfig): Promise<BuildResult>;
+    private resolveTsconfig;
+    private resolveEmittedEntry;
+}
+
+declare class SeedcordBuildRunner {
+    private readonly locator;
+    private readonly configLoader;
+    private readonly builder;
+    private readonly bootstrapWriter;
+    private readonly logger;
+    constructor(locator: ConfigLocator, configLoader: ConfigLoader, builder: TypeScriptProjectBuilder, bootstrapWriter: BootstrapWriter, logger: ILogger);
+    static create(logger: ILogger): SeedcordBuildRunner;
+    run(): Promise<void>;
+    private loadConfig;
+    private assertEntryExists;
+}
+
+declare class BuildCommand {
+    private readonly runner;
+    private readonly logger;
+    constructor(runner: SeedcordBuildRunner, logger: ILogger);
+    register(program: Command): void;
+    static create(logger: ILogger): BuildCommand;
+}
+
+type TsconfigOption = string | false;
+interface RuntimeModuleLoaderOptions {
+    tsconfig?: TsconfigOption;
+    forceTsx?: boolean;
+}
+declare class RuntimeModuleLoader implements ModuleLoader {
+    private readonly options;
+    private readonly jiti;
+    constructor(options?: RuntimeModuleLoaderOptions);
+    importModule<TModule = unknown>(entryPath: string): Promise<TModule>;
+    private shouldUseTsx;
+    private importWithTsx;
+    private importWithNode;
+    private resolveTsconfig;
+    private findNearestTsconfig;
+}
+
+declare function resolveDefaultExport<TValue>(moduleExport: TValue): unknown;
+
+declare const version: string;
+
+export { BootstrapWriter, BuildCommand, ConfigLoader, ConfigLocator, DevCommand, type ModuleLoader, type ResolvedSeedcordDevConfig, RuntimeModuleLoader, SEEDCORD_CONFIG_FILENAMES, SeedcordBuildRunner, type SeedcordDevConfig, SeedcordDevRunner, SeedcordInstanceLoader, TypeScriptProjectBuilder, defineConfig, resolveDefaultExport, version };