CapsKit 💊

The Universal Capability Kernel — Break free from controllers. Package your business logic into pure, swappable capsules that run identically via HTTP, Event Bus, CLI, or internal routines.

🚀 Why CapsKit?

Traditional architectures tightly couple business logic to the transport layer (Controllers/Request objects). This makes it hard to reuse logic in CRON jobs, background workers, or CLIs.

CapsKit implements the Capability Architecture pattern:

• Zero Boundary Logic: Capsules don't know about HTTP or Frameworks.
• Declarative Manifests: Routing, Traits, and Events are defined in simple metadata.
• Universal Pipelines: Global Interceptors and Action-level Hooks for tracing, auth, and more.

📦 Installation

npm install @mobtakronio/capskit elysia
# or
bun add @mobtakronio/capskit elysia

🛠️ Quick Start

1. Define a Capsule

// capsules/calculator/manifest.ts
import { CapsuleManifest } from '@mobtakronio/capskit';

export const service: CapsuleManifest = {
  name: 'calculator',
  actions: {
    sum: {
      handler: async (payload) => ({ result: payload.a + payload.b }),
      description: 'Adds two numbers'
    }
  },
  routes: [
    { method: 'POST', path: '/sum', action: 'sum' }
  ]
};

2. Boot the Kernel

import { createCapsKit } from '@mobtakronio/capskit';
import { Elysia } from 'elysia';
import * as path from 'path';

// Simplified initialization: starts, auto-loads built-ins, and builds router in one call!
const { router, capskit } = await createCapsKit({
  capsuleDirs: [path.resolve('./custom-capsules')],
  boot: { 
    action: 'http.buildRouter',
    payload: { adapter: 'elysia' }
  },
  dependencies: { db: myDatabase }
});

new Elysia()
  .use(router)
  .listen(3000);

3. Native Invocation (Proxy Client)

const calculator = capskit.use('calculator');
const { result } = await calculator.sum({ a: 10, b: 20 });

📖 Documentation

Visit capskit.io (Coming Soon!) or check the /docs folder for the full guide.

📄 License

MIT © 2026 CapsKit Team / MobtakronIO