@onebun/core 0.2.13 → 0.2.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onebun/core",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "Core package for OneBun framework - decorators, DI, modules, controllers",
   "license": "LGPL-3.0",
   "author": "RemRyahirev",
@@ -46,7 +46,7 @@
     "effect": "^3.13.10",
     "arktype": "^2.0.0",
     "@onebun/logger": "^0.2.1",
-    "@onebun/envs": "^0.2.1",
+    "@onebun/envs": "^0.2.2",
     "@onebun/metrics": "^0.2.2",
     "@onebun/requests": "^0.2.1",
     "@onebun/trace": "^0.2.1"

package/src/application/application.ts

@@ -246,7 +246,8 @@ function resolvePathUnderRoot(rootDir: string, relativePath: string): string | n
 /**
  * OneBun Application
  */
-export class OneBunApplication {
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export class OneBunApplication<QA extends import('../queue/types').QueueAdapterConstructor<any> = import('../queue/types').QueueAdapterConstructor> {
   private rootModule: ModuleInstance | null = null;
   private server: ReturnType<typeof Bun.serve> | null = null;
   private options: ApplicationOptions;
@@ -272,7 +273,7 @@ export class OneBunApplication {
    */
   constructor(
     moduleClass: new (...args: unknown[]) => object,
-    options?: Partial<ApplicationOptions>,
+    options?: Partial<ApplicationOptions<QA>>,
   ) {
     this.moduleClass = moduleClass;
 

package/src/docs-examples.test.ts

@@ -37,6 +37,7 @@ import type {
   OnApplicationDestroy,
 } from './';
 import type { ExceptionFilter } from './exception-filters/exception-filters';
+import type { QueueAdapter, QueueAdapterConstructor } from './queue/types';
 import type {
   SseEvent,
   SseGenerator,
@@ -44,6 +45,7 @@ import type {
   OneBunResponse,
   MiddlewareClass,
   OnModuleConfigure,
+  QueueApplicationOptions,
 } from './types';
 import type { HttpExecutionContext } from './types';
 import type { ServerWebSocket } from 'bun';
@@ -5706,3 +5708,96 @@ describe('docs/api/security.md', () => {
     expect(res.headers.get('Strict-Transport-Security')).toBeNull();
   });
 });
+
+// ============================================================================
+// docs/api/queue.md — Type-safe queue adapter configuration
+// ============================================================================
+describe('docs/api/queue.md — type-safe adapter options', () => {
+  // Minimal custom adapter for type-checking purposes
+  interface CustomAdapterOptions {
+    servers: string;
+    streams?: Array<{ name: string; subjects: string[] }>;
+  }
+
+  class CustomAdapter implements QueueAdapter {
+    readonly name = 'custom';
+    readonly type = 'jetstream' as const;
+    constructor(private opts: CustomAdapterOptions) {}
+    async connect() { /* noop */ }
+    async disconnect() { /* noop */ }
+    isConnected() {
+      return true; 
+    }
+    async publish() {
+      return ''; 
+    }
+    async publishBatch() {
+      return []; 
+    }
+    async subscribe() {
+      return {
+        async unsubscribe() { /* noop */ },
+        pause() { /* noop */ },
+        resume() { /* noop */ },
+        pattern: '',
+        isActive: true,
+      };
+    }
+    supports() {
+      return false; 
+    }
+    on() { /* noop */ }
+    off() { /* noop */ }
+  }
+
+  it('QueueApplicationOptions infers options type from adapter constructor', () => {
+    // When adapter is a specific class, options should be typed as its constructor argument
+    const queueOpts: QueueApplicationOptions<typeof CustomAdapter> = {
+      adapter: CustomAdapter,
+      options: {
+        servers: 'nats://localhost:4222',
+        streams: [{ name: 'EVENTS', subjects: ['events.>'] }],
+      },
+    };
+
+    expect(queueOpts.adapter).toBe(CustomAdapter);
+    expect(queueOpts.options?.servers).toBe('nats://localhost:4222');
+  });
+
+  it('QueueApplicationOptions works with string adapter type (backward compatibility)', () => {
+    const queueOpts: QueueApplicationOptions = {
+      adapter: 'memory',
+      enabled: true,
+    };
+
+    expect(queueOpts.adapter).toBe('memory');
+  });
+
+  it('QueueAdapterConstructor is compatible with custom adapter classes', () => {
+    // Verify that a custom adapter class satisfies QueueAdapterConstructor
+    const ctor: QueueAdapterConstructor<CustomAdapterOptions> = CustomAdapter;
+    const instance = new ctor({ servers: 'nats://localhost:4222' });
+
+    expect(instance.name).toBe('custom');
+    expect(instance.type).toBe('jetstream');
+  });
+
+  it('OneBunApplication accepts typed adapter options without type assertion', () => {
+    // This is the main desired usage — no `as SomeOptions` needed
+    @Module({ controllers: [] })
+    class TestModule {}
+
+    const app = new OneBunApplication(TestModule, {
+      loggerLayer: makeMockLoggerLayer(),
+      queue: {
+        adapter: CustomAdapter,
+        options: {
+          servers: 'nats://localhost:4222',
+          streams: [{ name: 'EVENTS', subjects: ['events.>'] }],
+        },
+      },
+    });
+
+    expect(app).toBeDefined();
+  });
+});

package/src/index.ts

@@ -3,6 +3,7 @@ export {
   Env,
   type EnvSchema,
   EnvValidationError,
+  getConfig,
   type InferConfigType,
   type EnvVariableConfig,
 } from '@onebun/envs';

package/src/queue/types.ts

@@ -433,11 +433,12 @@ export interface QueueAdapter {
 export type BuiltInAdapterType = 'memory' | 'redis';
 
 /**
- * Queue adapter constructor
+ * Queue adapter constructor — generic over the options type.
+ * When used as a generic constraint (e.g. `QueueApplicationOptions<typeof MyAdapter>`),
+ * TypeScript infers the correct options type automatically.
  */
-export interface QueueAdapterConstructor {
-  new (options?: unknown): QueueAdapter;
-}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type QueueAdapterConstructor<TOptions = any> = new (options: TOptions) => QueueAdapter;
 
 /**
  * Queue configuration options

package/src/types.ts

@@ -198,7 +198,8 @@ export interface TypedEnvSchema {
 /**
  * Application options
  */
-export interface ApplicationOptions {
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export interface ApplicationOptions<QA extends QueueAdapterConstructor<any> = QueueAdapterConstructor> {
   /**
    * Application name (used for metrics and tracing labels)
    */
@@ -431,7 +432,7 @@ export interface ApplicationOptions {
   /**
    * Queue configuration
    */
-  queue?: QueueApplicationOptions;
+  queue?: QueueApplicationOptions<QA>;
 
   /**
    * Static file serving: serve files from a directory for requests not matched by API routes.
@@ -544,15 +545,18 @@ export interface ApplicationOptions {
 export type QueueAdapterType = 'memory' | 'redis';
 
 /**
- * Queue configuration for OneBunApplication
+ * Queue configuration for OneBunApplication.
+ * Generic parameter `A` infers the adapter constructor type, so `options`
+ * is automatically typed to match the adapter's constructor argument.
  */
-export interface QueueApplicationOptions {
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export interface QueueApplicationOptions<A extends QueueAdapterConstructor<any> = QueueAdapterConstructor> {
   /** Enable/disable queue (default: auto - enabled if handlers exist) */
   enabled?: boolean;
   /** Adapter type, or custom adapter constructor (e.g. for NATS JetStream) */
-  adapter?: QueueAdapterType | QueueAdapterConstructor;
+  adapter?: QueueAdapterType | A;
   /** Options passed to the custom adapter constructor when adapter is a class */
-  options?: unknown;
+  options?: A extends QueueAdapterConstructor<infer O> ? O : never;
   /** Redis-specific options (only used when adapter is 'redis') */
   redis?: {
     /** Use shared Redis provider instead of dedicated connection */