Micro-kernel plugin system for the @oxog ecosystem with typed events, lifecycle hooks, and dependency resolution.

@oxog/plugin is the heart of the @oxog ecosystem. It provides the core micro-kernel implementation that all other @oxog packages build upon.

• Plugin Lifecycle - install → init → destroy with full async support
• Typed Events - Type-safe event bus for inter-plugin communication
• Dependency Resolution - Automatic topological sorting of plugins
• Error Boundaries - Configurable strategies: isolate, fail-fast, collect
• Context Management - Shared state between plugins
• Dynamic Plugins - Add, remove, replace, and reload at runtime
• Fluent API - Chainable method calls
• Zero Dependencies - Only @oxog/types at runtime
• Universal - Works in Node.js >= 18 and modern browsers
• Tiny Bundle - < 4KB gzipped core, < 6KB total

npm install @oxog/plugin

import { createKernel } from '@oxog/plugin';

// Create a kernel
const kernel = createKernel();

// Define a plugin
const loggerPlugin = {
  name: 'logger',
  version: '1.0.0',
  install(kernel) {
    kernel.log = (...args) => console.log('[LOG]', ...args);
  }
};

// Register and initialize
kernel.use(loggerPlugin);
await kernel.init();

// Use the plugin
(kernel as any).log('Hello, World!');

// Cleanup
await kernel.destroy();

For full documentation, examples, and API reference, visit plugin.oxog.dev.

• 01 - Basic Kernel
• 02 - Plugin Registration
• 03 - Lifecycle Hooks
• 04 - Typed Events
• 05 - Wildcard Events
• 06 - Dependencies
• 07 - Error Handling
• 08 - Context Sharing
• 09 - Plugin Factories
• 10 - Dynamic Plugins
• 11 - Plugin Queries
• 12 - Kernel Events
• 13 - Error Strategies
• 14 - Replace & Reload
• 15 - Real-World App

Creates a new micro-kernel instance.

Options:

• context - Initial shared context
• errorStrategy - 'isolate' | 'fail-fast' | 'collect'
• onError - Global error handler
• onBeforeInit, onAfterInit - Init lifecycle hooks
• onBeforeDestroy, onAfterDestroy - Destroy lifecycle hooks

Returns: KernelInstance<TContext, TEvents>

interface Plugin<TContext> {
  name: string;
  version: string;
  dependencies?: string[];

  install(kernel: Kernel<TContext>): void;
  onInit?(context: TContext): MaybePromise<void>;
  onDestroy?(): MaybePromise<void>;
  onError?(error: Error): void;
}

MIT © Ersin Koç

• GitHub
• Website
• Documentation
• npm

Made with ❤️ by Ersin Koç