@nitrostack/core 1.0.0

package/dist/core/decorators.d.ts

@@ -0,0 +1,190 @@
+import 'reflect-metadata';
+import { z } from 'zod';
+import type { JsonValue, ClassConstructor } from './types.js';
+/**
+ * Metadata keys for decorators
+ */
+export declare const TOOL_METADATA: unique symbol;
+export declare const WIDGET_METADATA: unique symbol;
+export declare const RESOURCE_METADATA: unique symbol;
+export declare const PROMPT_METADATA: unique symbol;
+export declare const GUARDS_METADATA: unique symbol;
+/**
+ * Example data for tools/resources
+ */
+export interface ExampleData {
+    request?: JsonValue;
+    response?: JsonValue;
+}
+/**
+ * Tool decorator options
+ */
+export interface ToolOptions {
+    name: string;
+    description: string;
+    inputSchema: z.ZodSchema;
+    examples?: ExampleData;
+    metadata?: {
+        category?: string;
+        tags?: string[];
+        rateLimit?: {
+            maxCalls: number;
+            windowMs: number;
+        };
+    };
+}
+/**
+ * Resource decorator options
+ */
+export interface ResourceOptions {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType?: string;
+    examples?: {
+        response?: JsonValue;
+    };
+    metadata?: {
+        cacheable?: boolean;
+        cacheMaxAge?: number;
+    };
+}
+/**
+ * Prompt decorator options
+ */
+export interface PromptOptions {
+    name: string;
+    description: string;
+    arguments?: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+    }>;
+}
+/**
+ * Tool metadata stored on class
+ */
+interface ToolMetadataEntry {
+    methodName: string;
+    options: ToolOptions;
+}
+/**
+ * Tool decorator - Marks a method as an MCP tool
+ *
+ * @example
+ * ```typescript
+ * @Tool({
+ *   name: 'login',
+ *   description: 'Login with email and password',
+ *   inputSchema: z.object({
+ *     email: z.string().email(),
+ *     password: z.string(),
+ *   }),
+ * })
+ * async login(input: LoginInput, context: ExecutionContext) {
+ *   // Implementation
+ * }
+ * ```
+ */
+export declare function Tool(options: ToolOptions): MethodDecorator;
+/**
+ * Widget decorator - Links a tool to a Next.js widget route
+ *
+ * @example
+ * ```typescript
+ * @Tool({ name: 'login', ... })
+ * @Widget('login-result')
+ * async login(input: LoginInput, context: ExecutionContext) {
+ *   // Implementation
+ * }
+ * ```
+ */
+export declare function Widget(routePath: string): MethodDecorator;
+/**
+ * Resource metadata stored on class
+ */
+interface ResourceMetadataEntry {
+    methodName: string;
+    options: ResourceOptions;
+}
+/**
+ * Resource decorator - Marks a method as an MCP resource
+ *
+ * @example
+ * ```typescript
+ * @Resource({
+ *   uri: 'db://users/schema',
+ *   name: 'User Schema',
+ *   description: 'Database schema for users',
+ * })
+ * async getUserSchema(context: ExecutionContext) {
+ *   // Return schema
+ * }
+ * ```
+ */
+export declare function Resource(options: ResourceOptions): MethodDecorator;
+/**
+ * Prompt metadata stored on class
+ */
+interface PromptMetadataEntry {
+    methodName: string;
+    options: PromptOptions;
+}
+/**
+ * Prompt decorator - Marks a method as an MCP prompt
+ *
+ * @example
+ * ```typescript
+ * @Prompt({
+ *   name: 'authentication-help',
+ *   description: 'Help with authentication',
+ * })
+ * async authHelp(args: PromptArgs, context: ExecutionContext) {
+ *   // Return prompt messages
+ * }
+ * ```
+ */
+export declare function Prompt(options: PromptOptions): MethodDecorator;
+/**
+ * Extract tool definitions from a decorated class
+ */
+export declare function extractTools(target: ClassConstructor): ToolMetadataEntry[];
+/**
+ * Extract resource definitions from a decorated class
+ */
+export declare function extractResources(target: ClassConstructor): ResourceMetadataEntry[];
+/**
+ * Extract prompt definitions from a decorated class
+ */
+export declare function extractPrompts(target: ClassConstructor): PromptMetadataEntry[];
+/**
+ * Get widget metadata for a specific method
+ */
+export declare function getWidgetMetadata(target: object, methodName: string): string | undefined;
+/**
+ * Get guards metadata for a specific method
+ */
+export declare function getGuardsMetadata(target: object, methodName: string): ClassConstructor[];
+/**
+ * Initial tool decorator metadata key
+ */
+export declare const INITIAL_TOOL_METADATA: unique symbol;
+/**
+ * InitialTool decorator - Marks a tool to be automatically called when the client starts
+ *
+ * @example
+ * ```typescript
+ * @Tool({ ... })
+ * @InitialTool()
+ * async init(input: InitInput, context: ExecutionContext) {
+ *   // Implementation
+ * }
+ * ```
+ */
+export declare function InitialTool(): MethodDecorator;
+/**
+ * Get initial tool metadata for a specific method
+ */
+export declare function getInitialToolMetadata(target: object, methodName: string): boolean;
+export {};
+//# sourceMappingURL=decorators.d.ts.map

package/dist/core/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/core/decorators.ts"],"names":[],"mappings":"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"}

package/dist/core/decorators.js

@@ -0,0 +1,170 @@
+import 'reflect-metadata';
+/**
+ * Metadata keys for decorators
+ */
+export const TOOL_METADATA = Symbol('tool:metadata');
+export const WIDGET_METADATA = Symbol('widget:metadata');
+export const RESOURCE_METADATA = Symbol('resource:metadata');
+export const PROMPT_METADATA = Symbol('prompt:metadata');
+export const GUARDS_METADATA = Symbol('guards:metadata');
+/**
+ * Tool decorator - Marks a method as an MCP tool
+ *
+ * @example
+ * ```typescript
+ * @Tool({
+ *   name: 'login',
+ *   description: 'Login with email and password',
+ *   inputSchema: z.object({
+ *     email: z.string().email(),
+ *     password: z.string(),
+ *   }),
+ * })
+ * async login(input: LoginInput, context: ExecutionContext) {
+ *   // Implementation
+ * }
+ * ```
+ */
+export function Tool(options) {
+    return function (target, propertyKey, descriptor) {
+        // Get existing tools or create new array
+        const existingTools = Reflect.getMetadata(TOOL_METADATA, target.constructor) || [];
+        // Add this tool
+        existingTools.push({
+            methodName: String(propertyKey),
+            options,
+        });
+        // Store metadata on the class constructor
+        Reflect.defineMetadata(TOOL_METADATA, existingTools, target.constructor);
+        return descriptor;
+    };
+}
+/**
+ * Widget decorator - Links a tool to a Next.js widget route
+ *
+ * @example
+ * ```typescript
+ * @Tool({ name: 'login', ... })
+ * @Widget('login-result')
+ * async login(input: LoginInput, context: ExecutionContext) {
+ *   // Implementation
+ * }
+ * ```
+ */
+export function Widget(routePath) {
+    return function (target, propertyKey, descriptor) {
+        // Store widget metadata
+        Reflect.defineMetadata(WIDGET_METADATA, routePath, target, String(propertyKey));
+        return descriptor;
+    };
+}
+/**
+ * Resource decorator - Marks a method as an MCP resource
+ *
+ * @example
+ * ```typescript
+ * @Resource({
+ *   uri: 'db://users/schema',
+ *   name: 'User Schema',
+ *   description: 'Database schema for users',
+ * })
+ * async getUserSchema(context: ExecutionContext) {
+ *   // Return schema
+ * }
+ * ```
+ */
+export function Resource(options) {
+    return function (target, propertyKey, descriptor) {
+        const existingResources = Reflect.getMetadata(RESOURCE_METADATA, target.constructor) || [];
+        existingResources.push({
+            methodName: String(propertyKey),
+            options,
+        });
+        Reflect.defineMetadata(RESOURCE_METADATA, existingResources, target.constructor);
+        return descriptor;
+    };
+}
+/**
+ * Prompt decorator - Marks a method as an MCP prompt
+ *
+ * @example
+ * ```typescript
+ * @Prompt({
+ *   name: 'authentication-help',
+ *   description: 'Help with authentication',
+ * })
+ * async authHelp(args: PromptArgs, context: ExecutionContext) {
+ *   // Return prompt messages
+ * }
+ * ```
+ */
+export function Prompt(options) {
+    return function (target, propertyKey, descriptor) {
+        const existingPrompts = Reflect.getMetadata(PROMPT_METADATA, target.constructor) || [];
+        existingPrompts.push({
+            methodName: String(propertyKey),
+            options,
+        });
+        Reflect.defineMetadata(PROMPT_METADATA, existingPrompts, target.constructor);
+        return descriptor;
+    };
+}
+/**
+ * Extract tool definitions from a decorated class
+ */
+export function extractTools(target) {
+    return Reflect.getMetadata(TOOL_METADATA, target) || [];
+}
+/**
+ * Extract resource definitions from a decorated class
+ */
+export function extractResources(target) {
+    return Reflect.getMetadata(RESOURCE_METADATA, target) || [];
+}
+/**
+ * Extract prompt definitions from a decorated class
+ */
+export function extractPrompts(target) {
+    return Reflect.getMetadata(PROMPT_METADATA, target) || [];
+}
+/**
+ * Get widget metadata for a specific method
+ */
+export function getWidgetMetadata(target, methodName) {
+    return Reflect.getMetadata(WIDGET_METADATA, target, methodName);
+}
+/**
+ * Get guards metadata for a specific method
+ */
+export function getGuardsMetadata(target, methodName) {
+    return Reflect.getMetadata(GUARDS_METADATA, target, methodName) || [];
+}
+/**
+ * Initial tool decorator metadata key
+ */
+export const INITIAL_TOOL_METADATA = Symbol('initial_tool:metadata');
+/**
+ * InitialTool decorator - Marks a tool to be automatically called when the client starts
+ *
+ * @example
+ * ```typescript
+ * @Tool({ ... })
+ * @InitialTool()
+ * async init(input: InitInput, context: ExecutionContext) {
+ *   // Implementation
+ * }
+ * ```
+ */
+export function InitialTool() {
+    return function (target, propertyKey, descriptor) {
+        Reflect.defineMetadata(INITIAL_TOOL_METADATA, true, target, String(propertyKey));
+        return descriptor;
+    };
+}
+/**
+ * Get initial tool metadata for a specific method
+ */
+export function getInitialToolMetadata(target, methodName) {
+    return Reflect.getMetadata(INITIAL_TOOL_METADATA, target, methodName) === true;
+}
+//# sourceMappingURL=decorators.js.map

package/dist/core/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/core/decorators.ts"],"names":[],"mappings":"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"}

package/dist/core/di/container.d.ts

@@ -0,0 +1,64 @@
+import 'reflect-metadata';
+/**
+ * Token type for DI registration
+ * Can be a class constructor, string, or symbol
+ */
+export type InjectionToken<T = unknown> = (new (...args: any[]) => T) | string | symbol;
+/**
+ * Provider type - a class constructor (using any[] for compatibility)
+ */
+type Provider<T = unknown> = new (...args: any[]) => T;
+/**
+ * Dependency Injection Container
+ *
+ * Simple DI container for managing service instances and dependencies.
+ * Supports constructor injection and singleton pattern.
+ */
+export declare class DIContainer {
+    private static instance;
+    private providers;
+    private instances;
+    private constructor();
+    /**
+     * Get the singleton container instance
+     */
+    static getInstance(): DIContainer;
+    /**
+     * Register a provider (class)
+     * @param token - The token to register (usually the class itself)
+     * @param provider - Optional provider class (defaults to token if it's a class)
+     */
+    register<T>(token: InjectionToken<T>, provider?: Provider<T>): void;
+    /**
+     * Register a value directly
+     * @param token - The token to register
+     * @param value - The value to associate with the token
+     */
+    registerValue<T>(token: InjectionToken<T>, value: T): void;
+    /**
+     * Resolve a dependency (get or create instance)
+     * @param token - The token to resolve
+     * @returns The resolved instance
+     */
+    resolve<T>(token: InjectionToken<T>): T;
+    /**
+     * Get constructor dependencies from metadata
+     *
+     * Priority:
+     * 1. Explicit deps in @Injectable({ deps: [...] }) - works in ESM
+     * 2. @Inject() parameter decorators
+     * 3. design:paramtypes from TypeScript (may not work in ESM)
+     */
+    private getDependencies;
+    /**
+     * Clear all registrations (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Check if a token is registered
+     * @param token - The token to check
+     */
+    has(token: InjectionToken): boolean;
+}
+export {};
+//# sourceMappingURL=container.d.ts.map

package/dist/core/di/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../src/core/di/container.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B;;;GAGG;AAEH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAClC,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,GAC3B,MAAM,GACN,MAAM,CAAC;AAEX;;GAEG;AAEH,KAAK,QAAQ,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAEvD;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IACrC,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,SAAS,CAA2C;IAE5D,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,WAAW;IAOjC;;;;OAIG;IACH,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAInE;;;;OAIG;IACH,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAI1D;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC;IA8BvC;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;CAGpC"}

package/dist/core/di/container.js

@@ -0,0 +1,105 @@
+import 'reflect-metadata';
+/**
+ * Dependency Injection Container
+ *
+ * Simple DI container for managing service instances and dependencies.
+ * Supports constructor injection and singleton pattern.
+ */
+export class DIContainer {
+    static instance;
+    providers = new Map();
+    instances = new Map();
+    constructor() { }
+    /**
+     * Get the singleton container instance
+     */
+    static getInstance() {
+        if (!DIContainer.instance) {
+            DIContainer.instance = new DIContainer();
+        }
+        return DIContainer.instance;
+    }
+    /**
+     * Register a provider (class)
+     * @param token - The token to register (usually the class itself)
+     * @param provider - Optional provider class (defaults to token if it's a class)
+     */
+    register(token, provider) {
+        this.providers.set(token, (provider || token));
+    }
+    /**
+     * Register a value directly
+     * @param token - The token to register
+     * @param value - The value to associate with the token
+     */
+    registerValue(token, value) {
+        this.instances.set(token, value);
+    }
+    /**
+     * Resolve a dependency (get or create instance)
+     * @param token - The token to resolve
+     * @returns The resolved instance
+     */
+    resolve(token) {
+        // Check if already instantiated
+        if (this.instances.has(token)) {
+            return this.instances.get(token);
+        }
+        // Get the provider
+        const provider = this.providers.get(token) || token;
+        // If provider is not a constructor function, throw error
+        if (typeof provider !== 'function') {
+            throw new Error(`Cannot resolve token "${String(token)}". No value or provider registered.`);
+        }
+        // Get constructor dependencies
+        const dependencies = this.getDependencies(provider);
+        // Resolve dependencies recursively
+        const resolvedDependencies = dependencies.map((dep) => this.resolve(dep));
+        // Create instance
+        const ProviderClass = provider;
+        const instance = new ProviderClass(...resolvedDependencies);
+        // Cache instance
+        this.instances.set(token, instance);
+        return instance;
+    }
+    /**
+     * Get constructor dependencies from metadata
+     *
+     * Priority:
+     * 1. Explicit deps in @Injectable({ deps: [...] }) - works in ESM
+     * 2. @Inject() parameter decorators
+     * 3. design:paramtypes from TypeScript (may not work in ESM)
+     */
+    getDependencies(target) {
+        // FIRST: Check for explicit deps in @Injectable({ deps: [...] })
+        // This is the most reliable method for ESM compatibility
+        const explicitDeps = Reflect.getMetadata('nitrostack:deps', target);
+        if (explicitDeps && explicitDeps.length > 0) {
+            return explicitDeps;
+        }
+        // SECOND: Get design:paramtypes metadata set by TypeScript
+        // This may be empty in ESM if reflect-metadata wasn't loaded early enough
+        const params = Reflect.getMetadata('design:paramtypes', target) || [];
+        // Check for @Inject tokens which override the types
+        const injectTokens = Reflect.getMetadata('nitrostack:inject', target) || [];
+        // Merge: use inject tokens where specified, otherwise use the param type
+        return params.map((param, index) => {
+            return injectTokens[index] || param;
+        });
+    }
+    /**
+     * Clear all registrations (useful for testing)
+     */
+    clear() {
+        this.providers.clear();
+        this.instances.clear();
+    }
+    /**
+     * Check if a token is registered
+     * @param token - The token to check
+     */
+    has(token) {
+        return this.providers.has(token) || this.instances.has(token);
+    }
+}
+//# sourceMappingURL=container.js.map

package/dist/core/di/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../../src/core/di/container.ts"],"names":[],"mappings":"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"}

package/dist/core/di/injectable.decorator.d.ts

@@ -0,0 +1,62 @@
+import 'reflect-metadata';
+import { InjectionToken } from './container.js';
+import type { ClassConstructor } from '../types.js';
+/**
+ * Options for @Injectable decorator
+ */
+export interface InjectableOptions {
+    /**
+     * Explicit dependencies for ESM compatibility.
+     *
+     * In ESM environments, TypeScript's emitDecoratorMetadata may not work
+     * reliably due to module loading order. Use this to explicitly declare
+     * constructor dependencies.
+     *
+     * @example
+     * ```typescript
+     * @Injectable({ deps: [DatabaseService, LoggerService] })
+     * export class UserService {
+     *   constructor(private db: DatabaseService, private logger: LoggerService) {}
+     * }
+     * ```
+     */
+    deps?: InjectionToken[];
+}
+/**
+ * Marks a class as injectable (can be used with DI)
+ *
+ * @example Basic usage (relies on TypeScript's emitDecoratorMetadata):
+ * ```typescript
+ * @Injectable()
+ * export class UserService {
+ *   constructor(private db: DatabaseService) {}
+ * }
+ * ```
+ *
+ * @example With explicit deps (recommended for ESM compatibility):
+ * ```typescript
+ * @Injectable({ deps: [DatabaseService] })
+ * export class UserService {
+ *   constructor(private db: DatabaseService) {}
+ * }
+ * ```
+ */
+export declare function Injectable(options?: InjectableOptions): ClassDecorator;
+/**
+ * Inject a specific token (optional - for custom injection)
+ *
+ * @example
+ * ```typescript
+ * constructor(@Inject('DATABASE_CONFIG') private config: DatabaseConfig) {}
+ * ```
+ */
+export declare function Inject(token: InjectionToken): ParameterDecorator;
+/**
+ * Check if a class is injectable
+ */
+export declare function isInjectable(target: ClassConstructor): boolean;
+/**
+ * Get inject tokens for constructor parameters
+ */
+export declare function getInjectTokens(target: ClassConstructor): InjectionToken[];
+//# sourceMappingURL=injectable.decorator.d.ts.map

package/dist/core/di/injectable.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectable.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/di/injectable.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAe,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMpD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,cAAc,CAetE;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,kBAAkB,CAMhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAE1E"}

package/dist/core/di/injectable.decorator.js

@@ -0,0 +1,66 @@
+import 'reflect-metadata';
+import { DIContainer } from './container.js';
+const INJECTABLE_KEY = 'nitrostack:injectable';
+const INJECT_KEY = 'nitrostack:inject';
+const DEPS_KEY = 'nitrostack:deps';
+/**
+ * Marks a class as injectable (can be used with DI)
+ *
+ * @example Basic usage (relies on TypeScript's emitDecoratorMetadata):
+ * ```typescript
+ * @Injectable()
+ * export class UserService {
+ *   constructor(private db: DatabaseService) {}
+ * }
+ * ```
+ *
+ * @example With explicit deps (recommended for ESM compatibility):
+ * ```typescript
+ * @Injectable({ deps: [DatabaseService] })
+ * export class UserService {
+ *   constructor(private db: DatabaseService) {}
+ * }
+ * ```
+ */
+export function Injectable(options) {
+    return (target) => {
+        Reflect.defineMetadata(INJECTABLE_KEY, true, target);
+        // Store explicit deps if provided (for ESM compatibility)
+        if (options?.deps && options.deps.length > 0) {
+            Reflect.defineMetadata(DEPS_KEY, options.deps, target);
+        }
+        // Auto-register in DI container
+        const container = DIContainer.getInstance();
+        if (!container.has(target)) {
+            container.register(target);
+        }
+    };
+}
+/**
+ * Inject a specific token (optional - for custom injection)
+ *
+ * @example
+ * ```typescript
+ * constructor(@Inject('DATABASE_CONFIG') private config: DatabaseConfig) {}
+ * ```
+ */
+export function Inject(token) {
+    return (target, propertyKey, parameterIndex) => {
+        const existingTokens = Reflect.getMetadata(INJECT_KEY, target) || [];
+        existingTokens[parameterIndex] = token;
+        Reflect.defineMetadata(INJECT_KEY, existingTokens, target);
+    };
+}
+/**
+ * Check if a class is injectable
+ */
+export function isInjectable(target) {
+    return Reflect.getMetadata(INJECTABLE_KEY, target) === true;
+}
+/**
+ * Get inject tokens for constructor parameters
+ */
+export function getInjectTokens(target) {
+    return Reflect.getMetadata(INJECT_KEY, target) || [];
+}
+//# sourceMappingURL=injectable.decorator.js.map