@spraxium/core

@spraxium/core

@spraxium/core is the runtime engine of every Spraxium application. It contains the application factory (SpraxiumFactory), the dependency injection container (SpraxiumContainer), the module loader, lifecycle hooks, and the full slash command and prefix command pipelines. When you call SpraxiumFactory.create, the core package resolves the entire module graph, instantiates all providers in dependency order, registers slash commands with the Discord API, and attaches the event listeners that drive the bot.

The package also provides the guard pipeline for authorizing incoming interactions, a structured logger (SpraxiumLogger) with configurable transports, a typed exception system with built-in fallback error handlers, and internal utility helpers shared across the framework. Application code typically interacts with the decorators from @spraxium/common rather than calling @spraxium/core directly, but the core package is the right place to look when extending the framework or building advanced integrations.

Installation

npm install @spraxium/core

Usage

import { IntentPreset, SpraxiumFactory } from '@spraxium/core';
import { EnvValidator } from '@spraxium/env';
import { AppEnv } from './app.env';
import { AppModule } from './app.module';

async function main(): Promise<void> {
  const environment = EnvValidator.validate(AppEnv);

  const app = await SpraxiumFactory.create({ token: environment.token });

  app.useModule(AppModule);
  app.provide(AppEnv, environment);
  app.intents(IntentPreset.Standard);

  await app.listen();
}

main();

import { Module } from '@spraxium/common';
import { PingModule } from './ping/ping.module';

@Module({
  imports: [PingModule],
})
export class AppModule {}

Links

npm · GitHub · Documentation

License

Apache 2.0