@kanian77/choux 0.1.5 → 0.1.7

package/src/core/PluginManager.spec.ts

@@ -1,57 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from 'bun:test';
-import { PluginManager } from './PluginManager';
-import { resolve } from 'path';
-import { inject } from '@kanian77/simple-di';
-import { PLUGIN_MANAGER_TOKEN } from '../lib/types/tokens';
-
-describe('PluginManager', () => {
-  let manager: PluginManager;
-  const pluginsDir = resolve('src/lib/test-related/plugins');
-
-  beforeEach(() => {
-    manager = inject<PluginManager>(PLUGIN_MANAGER_TOKEN);
-  });
-
-  afterEach(async () => {
-    // No cleanup needed for static test plugins
-  });
-
-  it('initialize loads plugins and prints info', async () => {
-    let logOutput = '';
-    const origLog = console.log;
-    console.log = (msg: string) => {
-      logOutput += msg + '\n';
-    };
-    await manager.initialize(pluginsDir);
-    expect(logOutput).toContain('Loaded 2 plugins:');
-    expect(logOutput).toContain('plugin-a');
-    expect(logOutput).toContain('plugin-b');
-    console.log = origLog;
-  });
-
-  it('getPlugin returns correct plugin', async () => {
-    await manager.initialize(pluginsDir);
-    const pluginA = manager.getPlugin('pluginA');
-    expect(pluginA).toBeDefined();
-    expect(pluginA?.metadata.name).toBe('pluginA');
-    const pluginB = manager.getPlugin('pluginB');
-    expect(pluginB).toBeDefined();
-    expect(pluginB?.metadata.name).toBe('pluginB');
-  });
-
-  it('getAllPlugins returns all loaded plugins', async () => {
-    await manager.initialize(pluginsDir);
-    const all = manager.getAllPlugins();
-    expect(all.length).toBe(2);
-    expect(all.map((p) => p.metadata.name).sort()).toEqual([
-      'pluginA',
-      'pluginB',
-    ]);
-  });
-
-  it('shutdown unloads all plugins and clears registry', async () => {
-    await manager.initialize(pluginsDir);
-    await manager.shutdown();
-    expect(manager.getAllPlugins()).toEqual([]);
-  });
-});

package/src/core/PluginManager.ts

@@ -1,47 +0,0 @@
-import { Module, Service, Inject, inject } from '@kanian77/simple-di';
-import { LIFECYCLE_HOOKS } from './HookRegistry';
-import { PLUGIN_MANAGER_TOKEN, HOOK_REGISTRY_TOKEN } from '../lib/types/tokens';
-import type { IHookRegistry, IPluginManager, LoadedPlugin } from '../lib/types';
-import { PluginLoader } from './PluginLoader';
-
-// Removed local interface IPluginManager, now imported from lib/types
-
-@Service({ token: PLUGIN_MANAGER_TOKEN })
-export class PluginManager implements IPluginManager {
-  constructor(
-    @Inject(HOOK_REGISTRY_TOKEN) private hookRegistry: IHookRegistry,
-    @Inject(PluginLoader) private loader: PluginLoader
-  ) {}
-
-  async initialize(pluginsDir: string): Promise<void> {
-    await this.hookRegistry.trigger(LIFECYCLE_HOOKS.APPLICATION_START);
-
-    const plugins = await this.loader.loadPlugins(pluginsDir);
-
-    console.log(`Loaded ${plugins.length} plugins:`);
-    plugins.forEach((p) => {
-      console.log(`  - ${p.metadata.name} v${p.metadata.version}`);
-    });
-  }
-
-  async shutdown(): Promise<void> {
-    await this.hookRegistry.trigger(LIFECYCLE_HOOKS.APPLICATION_SHUTDOWN);
-
-    const plugins = this.loader.getAllPlugins();
-
-    // Unload in reverse dependency order
-    for (const plugin of plugins.reverse()) {
-      await this.loader.unloadPlugin(plugin.metadata.name);
-    }
-
-    this.hookRegistry.clear();
-  }
-
-  getPlugin(name: string): LoadedPlugin | undefined {
-    return this.loader.getPlugin(name);
-  }
-
-  getAllPlugins(): LoadedPlugin[] {
-    return this.loader.getAllPlugins();
-  }
-}

package/src/decorators/hookDecorator.ts

@@ -1,30 +0,0 @@
-import { inject } from '@kanian77/simple-di';
-import { HOOK_METADATA_KEY, HOOK_REGISTRY_TOKEN } from '../lib/types/tokens';
-import type { IHookRegistry } from '../lib/types';
-
-/**
- * Decorator to register a method as a hook handler.
- * This allows the method to be called when the specified hook is triggered.
- * @param hookName The name of the hook to register this method for.
- * @returns
- */
-export function Hook(hookName: string) {
-  return function <T extends (...args: any[]) => any>(
-    target: any,
-    propertyKey: string | symbol,
-    descriptor: TypedPropertyDescriptor<T>
-  ): TypedPropertyDescriptor<T> | void {
-    // Store hook metadata on the class prototype
-    if (!target.constructor[HOOK_METADATA_KEY]) {
-      target.constructor[HOOK_METADATA_KEY] = [];
-    }
-
-    target.constructor[HOOK_METADATA_KEY].push({
-      hookName,
-      methodName: propertyKey.toString(),
-    });
-
-    // Return the descriptor (or void, both are valid)
-    return descriptor;
-  };
-}

package/src/example-plugin/module.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["module.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAI/C,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,MAAM;IAC/C,QAAQ,CAAC,QAAQ;;;;;MAKf;;IAgBa,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAOvB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;cAItB,mBAAmB,IAAI,IAAI;YAQhC,kBAAkB;YAKlB,kBAAkB;YAKlB,kBAAkB;IAKhC,OAAO,CAAC,uBAAuB;YAOjB,iBAAiB;CAGhC"}

package/src/example-plugin/module.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"module.js","sourceRoot":"","sources":["module.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,MAAM;IAQ/C;QACE,2DAA2D;QAC3D,KAAK,CAAC;YACJ,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,qBAAqB;oBAC9B,QAAQ,EAAE,cAAc;iBACzB;aACF;YACD,0CAA0C;YAC1C,8BAA8B;SAC/B,CAAC,CAAC;QAlBI,aAAQ,GAAG;YAClB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,mBAAmB;YAChC,YAAY,EAAE,EAAE,EAAE,qCAAqC;SACxD,CAAC;IAcF,CAAC;IAEQ,KAAK,CAAC,MAAM;QACnB,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAC1C,CAAC;IAEQ,KAAK,CAAC,MAAM;QACnB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAE1C,gDAAgD;QAChD,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACjC,CAAC;IAEQ,KAAK,CAAC,SAAS;QACtB,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAC1C,CAAC;IAEkB,mBAAmB;QACpC,gDAAgD;QAChD,0CAA0C;QAC1C,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;IAED,kEAAkE;IAEpD,AAAN,KAAK,CAAC,kBAAkB,CAAC,IAAS;QACxC,OAAO,CAAC,GAAG,CAAC,uCAAuC,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;IAGa,AAAN,KAAK,CAAC,kBAAkB;QAC9B,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;IAC7E,CAAC;IAGa,AAAN,KAAK,CAAC,kBAAkB,CAAC,UAAkB;QACjD,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,UAAU,CAAC,CAAC;IAC9D,CAAC;IAED,iDAAiD;IACzC,uBAAuB;QAC7B,MAAM,YAAY,GAAG,MAAM,CAAgB,mBAAmB,CAAC,CAAC;QAEhE,+CAA+C;QAC/C,YAAY,CAAC,QAAQ,CAAC,qBAAqB,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAClF,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,IAAS;QACvC,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;CACF;AAzBe;IADb,IAAI,CAAC,sBAAsB,CAAC;;;;uDAG5B;AAGa;IADb,IAAI,CAAC,wBAAwB,CAAC;;;;uDAG9B;AAGa;IADb,IAAI,CAAC,yBAAyB,CAAC;;;;uDAG/B"}

package/src/example-plugin/module.ts

@@ -1,80 +0,0 @@
-import { Module } from '@kanian77/simple-di';
-import { ExampleService } from './services';
-import { EXAMPLE_SERVICE_TOKEN } from './tokens';
-import { Hook } from '../decorators/hookDecorator';
-import { inject } from '@kanian77/simple-di';
-import { Plugin } from '../core/Plugin';
-import type { IHookRegistry } from '../../src/lib/types';
-import { HOOK_REGISTRY_TOKEN } from '../lib/types/tokens';
-
-export default class ExamplePlugin extends Plugin {
-  readonly metadata = {
-    name: 'example-plugin',
-    version: '1.0.0',
-    description: 'An example plugin',
-    dependencies: [], // other plugin names this depends on
-  };
-
-  constructor() {
-    // Call parent Module constructor with plugin configuration
-    super({
-      providers: [
-        {
-          provide: EXAMPLE_SERVICE_TOKEN,
-          useClass: ExampleService,
-        },
-      ],
-      // Can also import other modules if needed
-      // imports: [SomeOtherModule],
-    });
-  }
-
-  override async onLoad(): Promise<void> {
-    console.log('ExamplePlugin loading...');
-  }
-
-  override async onInit(): Promise<void> {
-    console.log('ExamplePlugin initialized!');
-
-    // Additional manual hook registration if needed
-    this.registerAdditionalHooks();
-  }
-
-  override async onDestroy(): Promise<void> {
-    console.log('ExamplePlugin destroyed!');
-  }
-
-  protected override registerCustomHooks(): void {
-    // Define custom hooks that this plugin provides
-    // Other plugins can listen to these hooks
-    console.log('Registering custom hooks for ExamplePlugin');
-  }
-
-  // These methods will be automatically registered as hook handlers
-  @Hook('custom:example-event')
-  private async handleExampleEvent(data: any): Promise<void> {
-    console.log('Handling example event via decorator:', data);
-  }
-
-  @Hook('core:application-start')
-  private async onApplicationStart(): Promise<void> {
-    console.log('ExamplePlugin responding to application start via decorator');
-  }
-
-  @Hook('core:before-plugin-load')
-  private async onBeforePluginLoad(pluginPath: string): Promise<void> {
-    console.log('Another plugin is about to load:', pluginPath);
-  }
-
-  // Manual hook registration for dynamic scenarios
-  private registerAdditionalHooks(): void {
-    const hookRegistry = inject<IHookRegistry>(HOOK_REGISTRY_TOKEN);
-
-    // Register additional hooks manually if needed
-    hookRegistry.register('dynamic:custom-hook', this.handleDynamicHook.bind(this));
-  }
-
-  private async handleDynamicHook(data: any): Promise<void> {
-    console.log('Handling dynamic hook:', data);
-  }
-}

package/src/example-plugin/services.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["services.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,WAAW,IAAI,IAAI,CAAC;CACrB;AAED,qBACa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,YAAY,CAAgB;;IAKpC,WAAW,IAAI,IAAI;CAKpB"}

package/src/example-plugin/services.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"services.js","sourceRoot":"","sources":["services.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAQ1D,IAAM,cAAc,GAApB,MAAM,cAAc;IAEzB;QACE,IAAI,CAAC,YAAY,GAAG,MAAM,CAAgB,mBAAmB,CAAC,CAAC;IACjE,CAAC;IAED,WAAW;QACT,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,2BAA2B;QAC3B,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3E,CAAC;CACF,CAAA;AAXY,cAAc;IAD1B,OAAO,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;;GAC7B,cAAc,CAW1B"}

package/src/example-plugin/services.ts

@@ -1,22 +0,0 @@
-import { Service, Inject, inject } from '@kanian77/simple-di';
-import { EXAMPLE_SERVICE_TOKEN } from './tokens';
-import { HOOK_REGISTRY_TOKEN } from '../lib/types/tokens';
-import type { IHookRegistry } from '../../src/lib/types';
-
-export interface IExampleService {
-  doSomething(): void;
-}
-
-@Service({ token: EXAMPLE_SERVICE_TOKEN })
-export class ExampleService implements IExampleService {
-  private hookRegistry: IHookRegistry;
-  constructor() {
-    this.hookRegistry = inject<IHookRegistry>(HOOK_REGISTRY_TOKEN);
-  }
-
-  doSomething(): void {
-    console.log('ExampleService doing something...');
-    // Can trigger custom hooks
-    this.hookRegistry.trigger('example:something-done', { data: 'example' });
-  }
-}

package/src/example-plugin/tokens.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["tokens.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,eAA2B,CAAC"}

package/src/example-plugin/tokens.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tokens.js","sourceRoot":"","sources":["tokens.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC"}

package/src/example-plugin/tokens.ts

@@ -1 +0,0 @@
-export const EXAMPLE_SERVICE_TOKEN = Symbol('ExampleService');

package/src/lib/functions/registerHookHandler.ts

@@ -1,11 +0,0 @@
-import { inject } from "@kanian77/simple-di";
-import type { IHookRegistry } from "../types";
-import { HOOK_REGISTRY_TOKEN } from "../types/tokens";
-
-export function registerHookHandler(
-  hookName: string,
-  handler: (...args: any[]) => void | Promise<void>
-) {
-  const hookRegistry = inject<IHookRegistry>(HOOK_REGISTRY_TOKEN);
-  hookRegistry.register(hookName, handler);
-}

package/src/lib/functions/registerHooksForInstance.ts

@@ -1,26 +0,0 @@
-import { inject } from "@kanian77/simple-di";
-import type { IHookRegistry } from "../types";
-import type { HookMetadata } from "../types/HookMetadata";
-import { HOOK_METADATA_KEY, HOOK_REGISTRY_TOKEN } from "../types/tokens";
-
-export function registerHooksForInstance(instance: any): void {
-  const constructor = instance.constructor;
-  const hookMetadata: HookMetadata[] = constructor[HOOK_METADATA_KEY] || [];
-
-  if (hookMetadata.length === 0) {
-    return;
-  }
-
-  try {
-    const hookRegistry = inject<IHookRegistry>(HOOK_REGISTRY_TOKEN);
-
-    for (const { hookName, methodName } of hookMetadata) {
-      const method = instance[methodName];
-      if (typeof method === 'function') {
-        hookRegistry.register(hookName, method.bind(instance));
-      }
-    }
-  } catch (error) {
-    console.warn('Failed to register hooks - HookRegistry may not be available yet:', error);
-  }
-}

package/src/lib/test-related/plugins/plugin-a/module.ts

@@ -1,74 +0,0 @@
-import { inject } from '@kanian77/simple-di';
-import { ExampleService } from '../../../../example-plugin/services';
-import { Plugin } from '../../../../core';
-import { Hook } from '../../../../decorators';
-import type { IHookRegistry } from '../../../types';
-import { HOOK_REGISTRY_TOKEN } from '../../../types/tokens';
-
-export const PLUGIN_A_TOKEN = 'PLUGIN_A_TOKEN';
-export default class PluginA extends Plugin {
-  readonly metadata = {
-    name: 'pluginA',
-    version: '1.0.0',
-    description: 'An example plugin',
-    dependencies: [], // other plugin names this depends on
-  };
-
-  constructor() {
-    // Call parent Module constructor with plugin configuration
-    super({
-      providers: [
-        {
-          provide: PLUGIN_A_TOKEN,
-          useClass: ExampleService,
-        },
-      ],
-    });
-  }
-
-  override async onLoad(): Promise<void> {
-    console.log('PluginA loading...');
-  }
-
-  override async onInit(): Promise<void> {
-    console.log('PluginA initialized!');
-
-    // Additional manual hook registration if needed
-    this.registerAdditionalHooks();
-  }
-
-  override async onDestroy(): Promise<void> {
-    console.log('PluginA destroyed!');
-  }
-
-  protected override registerCustomHooks(): void {
-    console.log('Registering custom hooks for PluginA');
-  }
-
-  // These methods will be automatically registered as hook handlers
-  @Hook('custom:example-event')
-  private async handleExampleEvent(data: any): Promise<void> {
-    console.log('Handling example event via decorator:', data);
-  }
-
-  @Hook('core:application-start')
-  private async onApplicationStart(): Promise<void> {
-    console.log('PluginA responding to application start via decorator');
-  }
-
-  @Hook('core:before-plugin-load')
-  private async onBeforePluginLoad(pluginPath: string): Promise<void> {
-    console.log('Another plugin is about to load:', pluginPath);
-  }
-
-  private registerAdditionalHooks(): void {
-    const hookRegistry = inject<IHookRegistry>(HOOK_REGISTRY_TOKEN);
-    hookRegistry.register(
-      'dynamic:custom-hook',
-      this.handleDynamicHook.bind(this)
-    );
-  }
-  private async handleDynamicHook(data: any): Promise<void> {
-    console.log('Handling dynamic hook:', data);
-  }
-}

package/src/lib/test-related/plugins/plugin-b/module.ts

@@ -1,74 +0,0 @@
-import { inject } from '@kanian77/simple-di';
-import { ExampleService } from '../../../../example-plugin/services';
-import { Plugin } from '../../../../core';
-import { Hook } from '../../../../decorators';
-import type { IHookRegistry } from '../../../types';
-import { HOOK_REGISTRY_TOKEN } from '../../../types/tokens';
-
-export const PLUGIN_B_TOKEN = 'PLUGIN_B_TOKEN';
-export default class PluginB extends Plugin {
-  readonly metadata = {
-    name: 'pluginB',
-    version: '1.0.0',
-    description: 'An example plugin',
-    dependencies: [], // other plugin names this depends on
-  };
-
-  constructor() {
-    // Call parent Module constructor with plugin configuration
-    super({
-      providers: [
-        {
-          provide: PLUGIN_B_TOKEN,
-          useClass: ExampleService,
-        },
-      ],
-    });
-  }
-
-  override async onLoad(): Promise<void> {
-    console.log('PluginB loading...');
-  }
-
-  override async onInit(): Promise<void> {
-    console.log('PluginB initialized!');
-
-    // Additional manual hook registration if needed
-    this.registerAdditionalHooks();
-  }
-
-  override async onDestroy(): Promise<void> {
-    console.log('PluginB destroyed!');
-  }
-
-  protected override registerCustomHooks(): void {
-    console.log('Registering custom hooks for PluginB');
-  }
-
-  // These methods will be automatically registered as hook handlers
-  @Hook('custom:example-event')
-  private async handleExampleEvent(data: any): Promise<void> {
-    console.log('Handling example event via decorator:', data);
-  }
-
-  @Hook('core:application-start')
-  private async onApplicationStart(): Promise<void> {
-    console.log('PluginB responding to application start via decorator');
-  }
-
-  @Hook('core:before-plugin-load')
-  private async onBeforePluginLoad(pluginPath: string): Promise<void> {
-    console.log('Another plugin is about to load:', pluginPath);
-  }
-
-  private registerAdditionalHooks(): void {
-    const hookRegistry = inject<IHookRegistry>(HOOK_REGISTRY_TOKEN);
-    hookRegistry.register(
-      'dynamic:custom-hook',
-      this.handleDynamicHook.bind(this)
-    );
-  }
-  private async handleDynamicHook(data: any): Promise<void> {
-    console.log('Handling dynamic hook:', data);
-  }
-}

package/src/lib/types/HookMetadata.ts

@@ -1,4 +0,0 @@
-export interface HookMetadata {
-  hookName: string;
-  methodName: string;
-}

package/src/lib/types/IHookRegistry.ts

@@ -1,10 +0,0 @@
-export type HookFn = (...args: any[]) => void | Promise<void>;
-export type HookMap = Map<string, HookFn[]>;
-
-export interface IHookRegistry {
-  register(name: string, fn: HookFn): void;
-  trigger(name: string, ...args: any[]): Promise<void>;
-  unregister(name: string, fn?: HookFn): void;
-  getHooks(name: string): HookFn[];
-  clear(): void;
-}

package/src/lib/types/IPluginManager.ts

@@ -1,8 +0,0 @@
-import type { LoadedPlugin } from './LoadedPlugin';
-
-export interface IPluginManager {
-  initialize(pluginsDir: string): Promise<void>;
-  shutdown(): Promise<void>;
-  getPlugin(name: string): LoadedPlugin | undefined;
-  getAllPlugins(): LoadedPlugin[];
-}

package/src/lib/types/PluginMetadata.ts

@@ -1,9 +0,0 @@
-import type { Module } from '@kanian77/simple-di';
-
-export interface PluginMetadata {
-  name: string;
-  version: string;
-  description?: string;
-  dependencies?: string[];
-}
-

package/src/lib/types/README.md

@@ -1,3 +0,0 @@
-# Types Exports
-
-This folder contains all shared interfaces and types for the plugin system. Use `import { ... } from 'src/lib/types'` for type-safe imports.