@onebun/core 0.2.11 → 0.2.13

package/src/decorators/metadata.ts

@@ -286,6 +286,205 @@ export function getConstructorParamTypes(target: Function): Function[] | undefin
   return undefined;
 }
 
+/**
+ * Diagnostic: check whether Bun is emitting decorator metadata (design:paramtypes).
+ *
+ * Scans an array of decorated classes. If at least one class has constructor
+ * parameters (target.length > 0) but NONE of them have design:paramtypes,
+ * then emitDecoratorMetadata is not working — typically because the setting
+ * is missing from the root tsconfig.json that Bun actually reads.
+ *
+ * @param decoratedClasses - Classes registered via @Service / @Controller / @Middleware
+ * @returns Object with diagnostic result and details
+ */
+export function diagnoseDecoratorMetadata(decoratedClasses: Function[]): {
+  ok: boolean;
+  classesWithParams: number;
+  classesWithMetadata: number;
+} {
+  let classesWithParams = 0;
+  let classesWithMetadata = 0;
+
+  for (const cls of decoratedClasses) {
+    if (cls.length > 0) {
+      classesWithParams++;
+      const types = (globalThis as any).Reflect?.getMetadata?.('design:paramtypes', cls);
+      if (types && Array.isArray(types) && types.length > 0) {
+        classesWithMetadata++;
+      }
+    }
+  }
+
+  return {
+    ok: classesWithParams === 0 || classesWithMetadata > 0,
+    classesWithParams,
+    classesWithMetadata,
+  };
+}
+
+/**
+ * Build a detailed diagnostic message by inspecting the project's tsconfig files.
+ *
+ * Walks up from `process.cwd()` looking for tsconfig.json files, reads them,
+ * and tells the user exactly which file to edit and what to add.
+ */
+export function buildDecoratorMetadataDiagnosticMessage(
+  classesWithParams: number,
+): string {
+  const fs = require('node:fs');
+  const pathModule = require('node:path');
+
+  const header =
+    `[OneBun] Dependency injection is broken: none of the ${classesWithParams} ` +
+    'service(s) with constructor parameters have design:paramtypes metadata.\n' +
+    'Bun is NOT emitting decorator metadata.\n';
+
+  type TsconfigInfo = { path: string; content: any; hasEmit: boolean; hasExperimental: boolean };
+
+  const readTsconfig = (tsconfigPath: string): TsconfigInfo | null => {
+    try {
+      if (!fs.existsSync(tsconfigPath)) {
+        return null;
+      }
+      const raw = fs.readFileSync(tsconfigPath, 'utf-8');
+      // Strip comments (single-line // and multi-line /* */) for JSON.parse
+      const stripped = raw.replace(/\/\/.*$/gm, '').replace(/\/\*[\s\S]*?\*\//g, '');
+      const parsed = JSON.parse(stripped);
+      const compilerOptions = parsed.compilerOptions || {};
+
+      return {
+        path: tsconfigPath,
+        content: parsed,
+        hasEmit: compilerOptions.emitDecoratorMetadata === true,
+        hasExperimental: compilerOptions.experimentalDecorators === true,
+      };
+    } catch {
+      return null;
+    }
+  };
+
+  // 1. Find tsconfig.json files walking UP from cwd to filesystem root
+  const tsconfigFiles: TsconfigInfo[] = [];
+  let dir = process.cwd();
+  const root = pathModule.parse(dir).root;
+
+  while (dir !== root) {
+    const info = readTsconfig(pathModule.join(dir, 'tsconfig.json'));
+    if (info) {
+      tsconfigFiles.push(info);
+    }
+    dir = pathModule.dirname(dir);
+  }
+
+  // 2. Also scan immediate subdirectories of cwd for child tsconfig.json files
+  //    (e.g. packages/backend/tsconfig.json in a monorepo)
+  const childTsconfigFiles: TsconfigInfo[] = [];
+  try {
+    const scanDirs = [process.cwd()];
+    // Scan up to 2 levels deep to find packages/*/tsconfig.json and similar
+    for (const scanDir of scanDirs) {
+      const entries = fs.readdirSync(scanDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules') {
+          const subdir = pathModule.join(scanDir, entry.name);
+          const info = readTsconfig(pathModule.join(subdir, 'tsconfig.json'));
+          if (info) {
+            childTsconfigFiles.push(info);
+          }
+          // One level deeper (e.g. packages/backend/)
+          try {
+            const subEntries = fs.readdirSync(subdir, { withFileTypes: true });
+            for (const subEntry of subEntries) {
+              if (subEntry.isDirectory() && !subEntry.name.startsWith('.') && subEntry.name !== 'node_modules') {
+                const info2 = readTsconfig(pathModule.join(subdir, subEntry.name, 'tsconfig.json'));
+                if (info2) {
+                  childTsconfigFiles.push(info2);
+                }
+              }
+            }
+          } catch {
+            // Skip unreadable directories
+          }
+        }
+      }
+    }
+  } catch {
+    // Skip if directory scanning fails
+  }
+
+  if (tsconfigFiles.length === 0) {
+    return (
+      header +
+      '\nNo tsconfig.json found. Create one in your project root with:\n\n' +
+      '  {\n' +
+      '    "compilerOptions": {\n' +
+      '      "experimentalDecorators": true,\n' +
+      '      "emitDecoratorMetadata": true\n' +
+      '    }\n' +
+      '  }\n'
+    );
+  }
+
+  // The first (deepest / closest to cwd) tsconfig is what the user likely expects to work.
+  // The last (shallowest / closest to root) is what Bun actually reads.
+  const rootTsconfig = tsconfigFiles[tsconfigFiles.length - 1];
+
+  // Check if any child tsconfig has the settings but root does not
+  // Look in both parent chain and scanned subdirectories
+  const allConfigs = [...tsconfigFiles, ...childTsconfigFiles];
+  const childWithSettings = allConfigs.find(
+    (t) => t.path !== rootTsconfig.path && (t.hasEmit || t.hasExperimental),
+  );
+
+  const lines: string[] = [header];
+
+  if (rootTsconfig.hasEmit && rootTsconfig.hasExperimental) {
+    // Root has both settings — unusual, might be a different issue
+    lines.push(`\nRoot tsconfig (${rootTsconfig.path}) already has both settings.`);
+    lines.push('If DI is still broken, check that Bun is reading this file for your entry point.');
+
+    return lines.join('\n');
+  }
+
+  // Report what's missing from the root tsconfig
+  const missing: string[] = [];
+  if (!rootTsconfig.hasExperimental) {
+    missing.push('"experimentalDecorators": true');
+  }
+  if (!rootTsconfig.hasEmit) {
+    missing.push('"emitDecoratorMetadata": true');
+  }
+
+  lines.push(`\nRoot tsconfig: ${rootTsconfig.path}`);
+  lines.push(`Missing in "compilerOptions": ${missing.join(', ')}`);
+
+  if (childWithSettings) {
+    const childHas: string[] = [];
+    if (childWithSettings.hasExperimental) {
+      childHas.push('"experimentalDecorators": true');
+    }
+    if (childWithSettings.hasEmit) {
+      childHas.push('"emitDecoratorMetadata": true');
+    }
+    lines.push(
+      `\nNote: ${childWithSettings.path} has ${childHas.join(' and ')},` +
+      ' but Bun ignores these when they are only in a child tsconfig.',
+    );
+  }
+
+  lines.push(`\nFix: add the missing option(s) to ${rootTsconfig.path}:\n`);
+  lines.push('  "compilerOptions": {');
+  if (!rootTsconfig.hasExperimental) {
+    lines.push('    "experimentalDecorators": true,');
+  }
+  if (!rootTsconfig.hasEmit) {
+    lines.push('    "emitDecoratorMetadata": true');
+  }
+  lines.push('  }');
+
+  return lines.join('\n');
+}
+
 /**
  * Namespace for metadata functions to mimic Reflect API
  */

package/src/docs-examples.test.ts

@@ -48,6 +48,8 @@ import type {
 import type { HttpExecutionContext } from './types';
 import type { ServerWebSocket } from 'bun';
 
+import { makeMockLoggerLayer } from './testing';
+
 import {
   Controller,
   Get,
@@ -109,7 +111,6 @@ import {
   createWsClient,
   createNativeWsClient,
   matchPattern,
-  makeMockLoggerLayer,
   hasOnModuleInit,
   hasOnApplicationInit,
   hasOnModuleDestroy,

package/src/index.ts

@@ -130,8 +130,8 @@ export * from './queue';
 // Validation
 export * from './validation';
 
-// Testing Utilities
-export * from './testing';
+// Testing Utilities are available via '@onebun/core/testing' subpath import
+// to avoid requiring testcontainers as a mandatory dependency
 
 // HTTP Guards
 export * from './http-guards';

package/src/module/module.ts

@@ -22,6 +22,7 @@ import {
   isGlobalModule,
   registerControllerDependencies,
 } from '../decorators/decorators';
+import { buildDecoratorMetadataDiagnosticMessage, diagnoseDecoratorMetadata } from '../decorators/metadata';
 import { QueueService, QueueServiceTag } from '../queue';
 import { BaseWebSocketGateway } from '../websocket/ws-base-gateway';
 import { isWebSocketGateway } from '../websocket/ws-decorators';
@@ -70,6 +71,7 @@ const processedGlobalModules: Set<Function> = ((globalThis as any)[Symbol.for('o
 export function clearGlobalServicesRegistry(): void {
   globalServicesRegistry.clear();
   processedGlobalModules.clear();
+  OneBunModule.resetDecoratorMetadataDiagnosis();
 }
 
 /**
@@ -274,6 +276,20 @@ export class OneBunModule implements ModuleInstance {
    * Create services with automatic dependency injection
    * Services can depend on other services (including imported ones)
    */
+  /**
+   * Whether the decorator metadata diagnostic has already run (once per process).
+   * Prevents repeated checks across multiple module initializations.
+   */
+  private static decoratorMetadataDiagnosed = false;
+
+  /**
+   * Reset the diagnostic flag (for testing).
+   * @internal
+   */
+  static resetDecoratorMetadataDiagnosis(): void {
+    OneBunModule.decoratorMetadataDiagnosed = false;
+  }
+
   private createServicesWithDI(metadata: ReturnType<typeof getModuleMetadata>): void {
     if (!metadata?.providers) {
       return;
@@ -295,6 +311,26 @@ export class OneBunModule implements ModuleInstance {
       }
     }
 
+    // Run decorator metadata diagnostic once: check that Bun emits design:paramtypes.
+    // If emitDecoratorMetadata is missing from the root tsconfig.json, Bun silently
+    // skips metadata emission and ALL constructor-based DI breaks.
+    // Only mark as diagnosed when we actually found classes with constructor params
+    // (modules with only zero-arg services can't tell us anything).
+    if (!OneBunModule.decoratorMetadataDiagnosed) {
+      const providerClasses = metadata.providers.filter(
+        (p): p is Function => typeof p === 'function',
+      );
+      const diagnosis = diagnoseDecoratorMetadata(providerClasses);
+      if (diagnosis.classesWithParams > 0) {
+        OneBunModule.decoratorMetadataDiagnosed = true;
+        if (!diagnosis.ok) {
+          throw new Error(
+            buildDecoratorMetadataDiagnosticMessage(diagnosis.classesWithParams),
+          );
+        }
+      }
+    }
+
     // Create services in dependency order
     const pendingProviders = [...metadata.providers.filter((p) => typeof p === 'function')];
     const createdServices = new Set<string>();

package/src/queue/adapters/memory.adapter.test.ts

@@ -384,10 +384,6 @@ describe('InMemoryQueueAdapter', () => {
       expect(adapter.supports('priority')).toBe(true);
     });
 
-    it('should support scheduled-jobs', () => {
-      expect(adapter.supports('scheduled-jobs')).toBe(true);
-    });
-
     it('should not support consumer-groups', () => {
       expect(adapter.supports('consumer-groups')).toBe(false);
     });

package/src/queue/adapters/memory.adapter.ts

@@ -15,8 +15,6 @@ import type {
   PublishOptions,
   SubscribeOptions,
   Subscription,
-  ScheduledJobOptions,
-  ScheduledJobInfo,
   MessageHandler,
 } from '../types';
 
@@ -322,49 +320,6 @@ export class InMemoryQueueAdapter implements QueueAdapter {
     return subscription;
   }
 
-  // ============================================================================
-  // Scheduled Jobs
-  // ============================================================================
-
-  async addScheduledJob(name: string, options: ScheduledJobOptions): Promise<void> {
-    this.ensureConnected();
-
-    if (!this.scheduler) {
-      throw new Error('Scheduler not initialized');
-    }
-
-    if (options.schedule.cron) {
-      this.scheduler.addCronJob(name, options.schedule.cron, options.pattern, () => options.data, {
-        metadata: options.metadata,
-        overlapStrategy: options.overlapStrategy,
-      });
-    } else if (options.schedule.every) {
-      this.scheduler.addIntervalJob(name, options.schedule.every, options.pattern, () => options.data, {
-        metadata: options.metadata,
-      });
-    }
-  }
-
-  async removeScheduledJob(name: string): Promise<boolean> {
-    this.ensureConnected();
-
-    if (!this.scheduler) {
-      return false;
-    }
-
-    return this.scheduler.removeJob(name);
-  }
-
-  async getScheduledJobs(): Promise<ScheduledJobInfo[]> {
-    this.ensureConnected();
-
-    if (!this.scheduler) {
-      return [];
-    }
-
-    return this.scheduler.getJobs();
-  }
-
   // ============================================================================
   // Features
   // ============================================================================
@@ -373,7 +328,6 @@ export class InMemoryQueueAdapter implements QueueAdapter {
     switch (feature) {
       case 'delayed-messages':
       case 'priority':
-      case 'scheduled-jobs':
       case 'pattern-subscriptions':
         return true;
       case 'consumer-groups':

package/src/queue/adapters/redis.adapter.test.ts

@@ -158,76 +158,12 @@ describe('RedisQueueAdapter', () => {
   // current RedisClient.raw() implementation. These features need a proper
   // implementation using Bun's Redis client's sendCommand API.
 
-  describe('scheduled jobs', () => {
-    beforeEach(async () => {
-      await adapter.connect();
-    });
-
-    it('should add and get scheduled jobs', async () => {
-      await adapter.addScheduledJob('test-job', {
-        pattern: 'job:test',
-        data: { action: 'process' },
-        schedule: { every: 1000 },
-      });
-      
-      const jobs = await adapter.getScheduledJobs();
-      
-      expect(jobs.find((j) => j.name === 'test-job')).toBeDefined();
-    });
-
-    it('should add cron scheduled job', async () => {
-      await adapter.addScheduledJob('cron-job', {
-        pattern: 'job:cron',
-        data: { action: 'cron' },
-        schedule: { cron: '0 * * * *' },
-      });
-      
-      const jobs = await adapter.getScheduledJobs();
-      
-      expect(jobs.find((j) => j.name === 'cron-job')).toBeDefined();
-    });
-
-    it('should remove scheduled job', async () => {
-      await adapter.addScheduledJob('removable-job', {
-        pattern: 'job:remove',
-        data: {},
-        schedule: { every: 1000 },
-      });
-      
-      const removed = await adapter.removeScheduledJob('removable-job');
-      
-      expect(removed).toBe(true);
-      
-      const jobs = await adapter.getScheduledJobs();
-      expect(jobs.find((j) => j.name === 'removable-job')).toBeUndefined();
-    });
-
-    it('should return false when removing non-existent job', async () => {
-      const removed = await adapter.removeScheduledJob('non-existent');
-      
-      expect(removed).toBe(false);
-    });
-
-    it('should throw when adding job while disconnected', async () => {
-      await adapter.disconnect();
-      
-      await expect(
-        adapter.addScheduledJob('fail-job', {
-          pattern: 'job:fail',
-          data: {},
-          schedule: { every: 1000 },
-        }),
-      ).rejects.toThrow('not connected');
-    });
-  });
-
   describe('features', () => {
     it('should support all standard queue features', () => {
       expect(adapter.supports('delayed-messages')).toBe(true);
       expect(adapter.supports('priority')).toBe(true);
       expect(adapter.supports('dead-letter-queue')).toBe(true);
       expect(adapter.supports('retry')).toBe(true);
-      expect(adapter.supports('scheduled-jobs')).toBe(true);
       expect(adapter.supports('consumer-groups')).toBe(true);
       expect(adapter.supports('pattern-subscriptions')).toBe(true);
     });

package/src/queue/adapters/redis.adapter.ts

@@ -21,8 +21,6 @@ import type {
   PublishOptions,
   SubscribeOptions,
   Subscription,
-  ScheduledJobOptions,
-  ScheduledJobInfo,
   MessageHandler,
 } from '../types';
 
@@ -409,45 +407,6 @@ export class RedisQueueAdapter implements QueueAdapter {
     return subscription;
   }
 
-  // ============================================================================
-  // Scheduled Jobs
-  // ============================================================================
-
-  async addScheduledJob(name: string, options: ScheduledJobOptions): Promise<void> {
-    this.ensureConnected();
-
-    if (!this.scheduler) {
-      throw new Error('Scheduler not initialized');
-    }
-
-    if (options.schedule.cron) {
-      this.scheduler.addCronJob(name, options.schedule.cron, options.pattern, () => options.data, {
-        metadata: options.metadata,
-        overlapStrategy: options.overlapStrategy,
-      });
-    } else if (options.schedule.every) {
-      this.scheduler.addIntervalJob(name, options.schedule.every, options.pattern, () => options.data, {
-        metadata: options.metadata,
-      });
-    }
-  }
-
-  async removeScheduledJob(name: string): Promise<boolean> {
-    if (!this.scheduler) {
-      return false;
-    }
-
-    return this.scheduler.removeJob(name);
-  }
-
-  async getScheduledJobs(): Promise<ScheduledJobInfo[]> {
-    if (!this.scheduler) {
-      return [];
-    }
-
-    return this.scheduler.getJobs();
-  }
-
   // ============================================================================
   // Features
   // ============================================================================