@dangao/bun-server 1.12.0 → 2.0.0

package/dist/mcp/decorators.d.ts

@@ -0,0 +1,42 @@
+import type { McpToolDefinition, McpResourceDefinition } from './types';
+/**
+ * Mark a method as an MCP tool.
+ *
+ * @example
+ * ```typescript
+ * \@McpTool({
+ *   name: 'get_weather',
+ *   description: 'Get current weather for a city',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: { city: { type: 'string' } },
+ *     required: ['city'],
+ *   },
+ * })
+ * public async getWeather({ city }: { city: string }) {
+ *   return { temperature: 22, city };
+ * }
+ * ```
+ */
+export declare function McpTool(definition: McpToolDefinition): MethodDecorator;
+/**
+ * Mark a method as an MCP resource provider.
+ *
+ * @example
+ * ```typescript
+ * \@McpResource({
+ *   uri: 'user://{id}',
+ *   name: 'User Profile',
+ *   mimeType: 'application/json',
+ * })
+ * public async getUserResource(\@McpParam('id') id: string) {
+ *   return this.userService.find(id);
+ * }
+ * ```
+ */
+export declare function McpResource(definition: McpResourceDefinition): MethodDecorator;
+/**
+ * Extract a named parameter from MCP tool input arguments.
+ */
+export declare function McpParam(name: string): ParameterDecorator;
+//# sourceMappingURL=decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/mcp/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGxE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CAAC,UAAU,EAAE,iBAAiB,GAAG,eAAe,CAItE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,qBAAqB,GAAG,eAAe,CAI9E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAOzD"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types';
+export * from './decorators';
+export * from './registry';
+export * from './server';
+export * from './mcp-module';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC"}

package/dist/mcp/mcp-module.d.ts

@@ -0,0 +1,22 @@
+import { type McpModuleOptions } from './types';
+export declare class McpModule {
+    /**
+     * Configure the MCP module.
+     *
+     * @example
+     * ```typescript
+     * McpModule.forRoot({
+     *   transport: 'sse',
+     *   path: '/mcp',
+     *   serverInfo: { name: 'my-api', version: '1.0.0' },
+     * });
+     *
+     * // Register tools by scanning instances:
+     * const registry = container.resolve<McpRegistry>(MCP_SERVER_TOKEN);
+     * registry.scan(myServiceInstance);
+     * ```
+     */
+    static forRoot(options: McpModuleOptions): typeof McpModule;
+    static reset(): void;
+}
+//# sourceMappingURL=mcp-module.d.ts.map

package/dist/mcp/mcp-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-module.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-module.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuC,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAErF,qBACa,SAAS;IACpB;;;;;;;;;;;;;;;OAeG;WACW,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,SAAS;WA8BpD,KAAK,IAAI,IAAI;CAG5B"}

package/dist/mcp/registry.d.ts

@@ -0,0 +1,23 @@
+import type { McpToolDefinition, McpResourceDefinition } from './types';
+export interface RegisteredMcpTool extends McpToolDefinition {
+    execute(args: Record<string, unknown>): Promise<unknown>;
+}
+export interface RegisteredMcpResource extends McpResourceDefinition {
+    read(uriParams: Record<string, string>): Promise<unknown>;
+}
+/**
+ * Registry for MCP tools and resources discovered via decorators.
+ */
+export declare class McpRegistry {
+    private readonly tools;
+    private readonly resources;
+    /**
+     * Scan an object instance for @McpTool() and @McpResource() decorated methods
+     */
+    scan(instance: object): void;
+    getTools(): RegisteredMcpTool[];
+    getResources(): RegisteredMcpResource[];
+    getTool(name: string): RegisteredMcpTool | undefined;
+    getResource(uri: string): RegisteredMcpResource | undefined;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/mcp/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/mcp/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGxE,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IAEtE;;OAEG;IACI,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAmC5B,QAAQ,IAAI,iBAAiB,EAAE;IAI/B,YAAY,IAAI,qBAAqB,EAAE;IAIvC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIpD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;CAGnE"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,29 @@
+import type { McpServerInfo, JsonRpcRequest, JsonRpcResponse } from './types';
+import type { McpRegistry } from './registry';
+/**
+ * MCP protocol server — handles JSON-RPC 2.0 requests from MCP clients.
+ * Supports SSE transport (HTTP) and stdio transport.
+ *
+ * Implements MCP specification 2024-11-05.
+ */
+export declare class McpServer {
+    private readonly registry;
+    private readonly serverInfo;
+    constructor(registry: McpRegistry, serverInfo: McpServerInfo);
+    /**
+     * Handle an incoming JSON-RPC request and return a response
+     */
+    handle(request: JsonRpcRequest): Promise<JsonRpcResponse>;
+    /**
+     * Handle a raw HTTP request body (JSON-RPC over HTTP)
+     * Returns a Response suitable for Bun's serve()
+     */
+    handleHttp(req: Request): Promise<Response>;
+    /**
+     * Create an SSE response that keeps the connection open for streaming
+     * This is the SSE transport endpoint
+     */
+    createSseResponse(): Response;
+    private dispatch;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;gBAExB,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa;IAKnE;;OAEG;IACU,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBtE;;;OAGG;IACU,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQxD;;;OAGG;IACI,iBAAiB,IAAI,QAAQ;YAmCtB,QAAQ;CAkEvB"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * MCP tool definition
+ */
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+/**
+ * MCP resource definition
+ */
+export interface McpResourceDefinition {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+/**
+ * MCP server info
+ */
+export interface McpServerInfo {
+    name: string;
+    version: string;
+    description?: string;
+}
+/**
+ * MCP transport type
+ */
+export type McpTransport = 'sse' | 'stdio';
+export interface McpModuleOptions {
+    transport?: McpTransport;
+    /** Path for SSE endpoint (default: '/mcp') */
+    path?: string;
+    serverInfo: McpServerInfo;
+}
+export declare const MCP_SERVER_TOKEN: unique symbol;
+export declare const MCP_OPTIONS_TOKEN: unique symbol;
+/** Metadata key for @McpTool() */
+export declare const MCP_TOOL_METADATA_KEY = "@dangao/bun-server:mcp:tool";
+/** Metadata key for @McpResource() */
+export declare const MCP_RESOURCE_METADATA_KEY = "@dangao/bun-server:mcp:resource";
+/** JSON-RPC 2.0 Request */
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    method: string;
+    params?: unknown;
+}
+/** JSON-RPC 2.0 Response */
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,aAAa,CAAC;CAC3B;AAED,eAAO,MAAM,gBAAgB,eAA0C,CAAC;AACxE,eAAO,MAAM,iBAAiB,eAA2C,CAAC;AAE1E,kCAAkC;AAClC,eAAO,MAAM,qBAAqB,gCAAgC,CAAC;AACnE,sCAAsC;AACtC,eAAO,MAAM,yBAAyB,oCAAoC,CAAC;AAE3E,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,4BAA4B;AAC5B,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D"}

package/dist/prompt/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types';
+export * from './service';
+export * from './prompt-module';
+export * from './stores/memory-store';
+export * from './stores/file-store';
+//# sourceMappingURL=index.d.ts.map

package/dist/prompt/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC"}

package/dist/prompt/prompt-module.d.ts

@@ -0,0 +1,23 @@
+import { type PromptModuleOptions } from './types';
+export declare class PromptModule {
+    /**
+     * Configure the prompt module.
+     *
+     * @example
+     * ```typescript
+     * // With in-memory store (default):
+     * PromptModule.forRoot({});
+     *
+     * // With file store:
+     * PromptModule.forRoot({
+     *   store: new FilePromptStore({ promptsDir: './.prompts' }),
+     * });
+     * ```
+     */
+    static forRoot(options?: PromptModuleOptions): typeof PromptModule;
+    /**
+     * Reset module state (for testing)
+     */
+    static reset(): void;
+}
+//# sourceMappingURL=prompt-module.d.ts.map

package/dist/prompt/prompt-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-module.d.ts","sourceRoot":"","sources":["../../src/prompt/prompt-module.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,SAAS,CAAC;AAGjB,qBACa,YAAY;IACvB;;;;;;;;;;;;;OAaG;WACW,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,YAAY;IA4B7E;;OAEG;WACW,KAAK,IAAI,IAAI;CAG5B"}

package/dist/prompt/service.d.ts

@@ -0,0 +1,47 @@
+import type { PromptTemplate, CreatePromptTemplateInput, UpdatePromptTemplateInput, PromptModuleOptions } from './types';
+/**
+ * Manages prompt templates: CRUD operations, versioning, and variable rendering.
+ */
+export declare class PromptService {
+    private readonly store;
+    constructor(options: PromptModuleOptions);
+    /**
+     * Get a template by ID
+     */
+    get(id: string): Promise<PromptTemplate>;
+    /**
+     * Get a specific version of a template
+     */
+    getVersion(id: string, version: number): Promise<PromptTemplate>;
+    /**
+     * List all templates
+     */
+    list(): Promise<PromptTemplate[]>;
+    /**
+     * Create a new template
+     */
+    create(input: CreatePromptTemplateInput): Promise<PromptTemplate>;
+    /**
+     * Update a template (creates a new version)
+     */
+    update(id: string, input: UpdatePromptTemplateInput): Promise<PromptTemplate>;
+    /**
+     * Delete a template
+     */
+    delete(id: string): Promise<boolean>;
+    /**
+     * Render a template by replacing {{varName}} with provided values
+     *
+     * @example
+     * ```typescript
+     * const rendered = await promptService.render('greet-user', { name: 'Alice', app: 'MyApp' });
+     * // "Hello, Alice! Welcome to MyApp."
+     * ```
+     */
+    render(id: string, vars: Record<string, string>): Promise<string>;
+    /**
+     * Render a specific version of a template
+     */
+    renderVersion(id: string, version: number, vars: Record<string, string>): Promise<string>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/prompt/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/prompt/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,qBACa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAGJ,OAAO,EAAE,mBAAmB;IAK5D;;OAEG;IACU,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAMrD;;OAEG;IACU,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAM7E;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI9C;;OAEG;IACU,MAAM,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC;IAI9E;;OAEG;IACU,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC;IAI1F;;OAEG;IACU,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjD;;;;;;;;OAQG;IACU,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAK9E;;OAEG;IACU,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAIvG"}

package/dist/prompt/stores/file-store.d.ts

@@ -0,0 +1,36 @@
+import type { PromptStore, PromptTemplate, CreatePromptTemplateInput, UpdatePromptTemplateInput } from '../types';
+export interface FilePromptStoreConfig {
+    /** Directory containing JSON prompt files (default: './.prompts') */
+    promptsDir?: string;
+}
+/**
+ * File-backed prompt store — loads templates from JSON files at startup
+ * and persists changes back to disk.
+ *
+ * Each template is stored as a separate JSON file: `{promptsDir}/{id}.json`
+ *
+ * File format:
+ * ```json
+ * {
+ *   "id": "greet-user",
+ *   "name": "Greet User",
+ *   "content": "Hello, {{name}}! Welcome to {{app}}.",
+ *   "description": "Greeting template"
+ * }
+ * ```
+ */
+export declare class FilePromptStore implements PromptStore {
+    private readonly promptsDir;
+    private readonly memory;
+    private loaded;
+    constructor(config?: FilePromptStoreConfig);
+    get(id: string): Promise<PromptTemplate | null>;
+    getVersion(id: string, version: number): Promise<PromptTemplate | null>;
+    list(): Promise<PromptTemplate[]>;
+    create(input: CreatePromptTemplateInput): Promise<PromptTemplate>;
+    update(id: string, input: UpdatePromptTemplateInput): Promise<PromptTemplate>;
+    delete(id: string): Promise<boolean>;
+    private ensureLoaded;
+    private writeFile;
+}
+//# sourceMappingURL=file-store.d.ts.map

package/dist/prompt/stores/file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../../../src/prompt/stores/file-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EAC1B,MAAM,UAAU,CAAC;AAIlB,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,MAAM,CAAS;gBAEJ,MAAM,GAAE,qBAA0B;IAKxC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK/C,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAKvE,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAKjC,MAAM,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC;IAOjE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC;IAO7E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAcnC,YAAY;YAiCZ,SAAS;CAkBxB"}

package/dist/prompt/stores/memory-store.d.ts

@@ -0,0 +1,17 @@
+import type { PromptStore, PromptTemplate, CreatePromptTemplateInput, UpdatePromptTemplateInput } from '../types';
+/**
+ * In-memory prompt store. Supports versioning via a separate history map.
+ */
+export declare class InMemoryPromptStore implements PromptStore {
+    private readonly templates;
+    /** id → version → template snapshot */
+    private readonly history;
+    get(id: string): Promise<PromptTemplate | null>;
+    getVersion(id: string, version: number): Promise<PromptTemplate | null>;
+    list(): Promise<PromptTemplate[]>;
+    create(input: CreatePromptTemplateInput): Promise<PromptTemplate>;
+    update(id: string, input: UpdatePromptTemplateInput): Promise<PromptTemplate>;
+    delete(id: string): Promise<boolean>;
+    private saveVersion;
+}
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/prompt/stores/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../../src/prompt/stores/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EAC1B,MAAM,UAAU,CAAC;AAGlB;;GAEG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkD;IAE7D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI/C,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAIvE,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIjC,MAAM,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC;IAqBjE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC;IAoB7E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMjD,OAAO,CAAC,WAAW;CAMpB"}

package/dist/prompt/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * A versioned prompt template with variable interpolation
+ */
+export interface PromptTemplate {
+    id: string;
+    name: string;
+    /** Template content with {{variable}} placeholders */
+    content: string;
+    /** Current version number (starts at 1, increments on each update) */
+    version: number;
+    /** Declared variable names (auto-extracted from content) */
+    variables: string[];
+    /** Optional description */
+    description?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Input for creating a prompt template
+ */
+export interface CreatePromptTemplateInput {
+    id?: string;
+    name: string;
+    content: string;
+    description?: string;
+}
+/**
+ * Input for updating a prompt template (creates new version)
+ */
+export interface UpdatePromptTemplateInput {
+    name?: string;
+    content?: string;
+    description?: string;
+}
+/**
+ * Abstract prompt store interface
+ */
+export interface PromptStore {
+    get(id: string): Promise<PromptTemplate | null>;
+    getVersion(id: string, version: number): Promise<PromptTemplate | null>;
+    list(): Promise<PromptTemplate[]>;
+    create(input: CreatePromptTemplateInput): Promise<PromptTemplate>;
+    update(id: string, input: UpdatePromptTemplateInput): Promise<PromptTemplate>;
+    delete(id: string): Promise<boolean>;
+}
+/**
+ * PromptModule configuration
+ */
+export interface PromptModuleOptions {
+    store?: PromptStore;
+    /**
+     * Preload templates on module init
+     * (only used by FilePromptStore, which loads from promptsDir)
+     */
+    promptsDir?: string;
+}
+export declare const PROMPT_SERVICE_TOKEN: unique symbol;
+export declare const PROMPT_OPTIONS_TOKEN: unique symbol;
+/**
+ * Extract variable names from template content
+ * Matches {{varName}} patterns
+ */
+export declare function extractVariables(content: string): string[];
+/**
+ * Render a template by replacing {{varName}} with provided values
+ */
+export declare function renderTemplate(content: string, vars: Record<string, string>): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/prompt/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/prompt/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAChD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACxE,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAClC,MAAM,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,oBAAoB,eAA8C,CAAC;AAChF,eAAO,MAAM,oBAAoB,eAA8C,CAAC;AAEhF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAEpF"}

package/dist/rag/chunkers/markdown-chunker.d.ts

@@ -0,0 +1,11 @@
+import type { DocumentChunker, DocumentChunk } from '../types';
+/**
+ * Splits Markdown text into semantic chunks by heading boundaries.
+ * Falls back to text chunking for sections that are too large.
+ */
+export declare class MarkdownChunker implements DocumentChunker {
+    private readonly maxChunkSize;
+    constructor(maxChunkSize?: number);
+    chunk(text: string): DocumentChunk[];
+}
+//# sourceMappingURL=markdown-chunker.d.ts.map

package/dist/rag/chunkers/markdown-chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-chunker.d.ts","sourceRoot":"","sources":["../../../src/rag/chunkers/markdown-chunker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE/D;;;GAGG;AACH,qBAAa,eAAgB,YAAW,eAAe;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAEnB,YAAY,SAAO;IAI/B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE;CA0B5C"}

package/dist/rag/chunkers/text-chunker.d.ts

@@ -0,0 +1,11 @@
+import type { DocumentChunker, DocumentChunk } from '../types';
+/**
+ * Splits plain text into overlapping chunks of fixed character size.
+ */
+export declare class TextChunker implements DocumentChunker {
+    private readonly chunkSize;
+    private readonly chunkOverlap;
+    constructor(chunkSize?: number, chunkOverlap?: number);
+    chunk(text: string): DocumentChunk[];
+}
+//# sourceMappingURL=text-chunker.d.ts.map

package/dist/rag/chunkers/text-chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-chunker.d.ts","sourceRoot":"","sources":["../../../src/rag/chunkers/text-chunker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE/D;;GAEG;AACH,qBAAa,WAAY,YAAW,eAAe;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAEnB,SAAS,SAAM,EAAE,YAAY,SAAK;IAK9C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE;CAe5C"}

package/dist/rag/decorators.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Metadata key for @Rag() decorator
+ */
+export declare const RAG_METADATA_KEY = "@dangao/bun-server:rag:collection";
+/**
+ * Mark a controller method to auto-retrieve RAG context before execution.
+ * The retrieved context is available via `@Inject(RAG_SERVICE_TOKEN)` in the service layer.
+ *
+ * @param collection - VectorStore collection to search (uses default if omitted)
+ *
+ * @example
+ * ```typescript
+ * \@POST('/ask')
+ * \@Rag({ collection: 'product-docs' })
+ * public async ask(\@Body() body: { question: string }) {
+ *   // RAG context is automatically fetched before this method
+ *   // Access via RagService.retrieve() in your service
+ * }
+ * ```
+ */
+export declare function Rag(options?: {
+    collection?: string;
+}): MethodDecorator;
+//# sourceMappingURL=decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/rag/decorators.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,gBAAgB,sCAAsC,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,GAAG,CAAC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,eAAe,CAI1E"}

package/dist/rag/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types';
+export * from './service';
+export * from './decorators';
+export * from './rag-module';
+export * from './chunkers/text-chunker';
+export * from './chunkers/markdown-chunker';
+//# sourceMappingURL=index.d.ts.map

package/dist/rag/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC"}

package/dist/rag/rag-module.d.ts

@@ -0,0 +1,23 @@
+import { type RagModuleOptions } from './types';
+export declare class RagModule {
+    /**
+     * Configure the RAG module.
+     *
+     * **Requires** `EmbeddingModule` and `VectorStoreModule` to be imported first.
+     *
+     * @example
+     * ```typescript
+     * EmbeddingModule.forRoot({ provider: { ... } });
+     * VectorStoreModule.forRoot({});
+     * RagModule.forRoot({ collection: 'docs', chunkSize: 512, topK: 5 });
+     *
+     * \@Module({
+     *   imports: [EmbeddingModule, VectorStoreModule, RagModule],
+     * })
+     * class AppModule {}
+     * ```
+     */
+    static forRoot(options?: RagModuleOptions): typeof RagModule;
+    static reset(): void;
+}
+//# sourceMappingURL=rag-module.d.ts.map

package/dist/rag/rag-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-module.d.ts","sourceRoot":"","sources":["../../src/rag/rag-module.ts"],"names":[],"mappings":"AAIA,OAAO,EAAwC,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAMtF,qBAIa,SAAS;IACpB;;;;;;;;;;;;;;;;OAgBG;WACW,OAAO,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,SAAS;WA0CzD,KAAK,IAAI,IAAI;CAG5B"}

package/dist/rag/service.d.ts

@@ -0,0 +1,36 @@
+import type { EmbeddingService } from '../embedding/service';
+import type { VectorStore } from '../vector-store/types';
+import type { IngestSource, RagContext, RagModuleOptions } from './types';
+/**
+ * RAG service — document ingestion pipeline and context retrieval.
+ *
+ * Ingestion: source → load text → chunk → embed → store in VectorStore
+ * Retrieval: query → embed → search VectorStore → format context
+ */
+export declare class RagService {
+    private readonly options;
+    private readonly embeddingService;
+    private readonly vectorStore;
+    private readonly textChunker;
+    private readonly markdownChunker;
+    constructor(options: RagModuleOptions, embeddingService: EmbeddingService, vectorStore: VectorStore);
+    /**
+     * Ingest a document source into the vector store
+     * @param source - text, file path, or URL
+     * @param collection - override default collection
+     * @returns Number of chunks stored
+     */
+    ingest(source: IngestSource, collection?: string): Promise<number>;
+    /**
+     * Retrieve relevant context for a query
+     * @param query - User query text
+     * @param collection - override default collection
+     */
+    retrieve(query: string, collection?: string): Promise<RagContext>;
+    /**
+     * Build a system prompt with retrieved context
+     */
+    buildContextPrompt(query: string, collection?: string): Promise<string>;
+    private loadText;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/rag/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/rag/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAmB,MAAM,SAAS,CAAC;AAK3F;;;;;GAKG;AACH,qBACa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAGrB,OAAO,EAAE,gBAAgB,EACnB,gBAAgB,EAAE,gBAAgB,EACvC,WAAW,EAAE,WAAW;IAStD;;;;;OAKG;IACU,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoC/E;;;;OAIG;IACU,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAuB9E;;OAEG;IACU,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAMtE,QAAQ;CAiBvB"}

package/dist/rag/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * A chunk of text produced by a document chunker
+ */
+export interface DocumentChunk {
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Source for document ingestion
+ */
+export type IngestSource = {
+    type: 'text';
+    content: string;
+    metadata?: Record<string, unknown>;
+} | {
+    type: 'file';
+    path: string;
+    metadata?: Record<string, unknown>;
+} | {
+    type: 'url';
+    url: string;
+    metadata?: Record<string, unknown>;
+};
+/**
+ * Abstract document chunker
+ */
+export interface DocumentChunker {
+    chunk(text: string): DocumentChunk[];
+}
+/**
+ * Retrieved context for RAG
+ */
+export interface RagContext {
+    chunks: Array<{
+        content: string;
+        score: number;
+        metadata?: Record<string, unknown>;
+    }>;
+    /** Formatted context string for inclusion in prompts */
+    formatted: string;
+}
+export interface RagModuleOptions {
+    /** Collection name in VectorStore (default: 'rag') */
+    collection?: string;
+    /** Number of chunks per ingested document (default: 512) */
+    chunkSize?: number;
+    /** Overlap between consecutive chunks (default: 50) */
+    chunkOverlap?: number;
+    /** Number of top results to retrieve (default: 5) */
+    topK?: number;
+    /** Minimum similarity score to include (default: 0.5) */
+    minScore?: number;
+}
+export declare const RAG_SERVICE_TOKEN: unique symbol;
+export declare const RAG_OPTIONS_TOKEN: unique symbol;
+//# sourceMappingURL=types.d.ts.map

package/dist/rag/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rag/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACtF,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,iBAAiB,eAA2C,CAAC;AAC1E,eAAO,MAAM,iBAAiB,eAA2C,CAAC"}