nitrostack 1.0.0

package/dist/core/types.d.ts

@@ -0,0 +1,123 @@
+import { z } from 'zod';
+/**
+ * Base configuration for MCP server
+ */
+export interface McpServerConfig {
+    name: string;
+    version: string;
+    description?: string;
+    capabilities?: {
+        tools?: boolean;
+        resources?: boolean;
+        prompts?: boolean;
+    };
+    logging?: {
+        level: 'debug' | 'info' | 'warn' | 'error';
+        file?: string;
+    };
+    rateLimit?: {
+        maxRequests: number;
+        windowMs: number;
+    };
+}
+/**
+ * Tool definition with schema validation
+ */
+export interface ToolDefinition<TInput = any, TOutput = any> {
+    name: string;
+    description: string;
+    inputSchema: z.ZodSchema<TInput>;
+    handler: (input: TInput, context: ExecutionContext) => Promise<TOutput>;
+    metadata?: {
+        category?: string;
+        tags?: string[];
+        rateLimit?: {
+            maxCalls: number;
+            windowMs: number;
+        };
+    };
+}
+/**
+ * Resource definition
+ */
+export interface ResourceDefinition {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType?: string;
+    handler: (context: ExecutionContext) => Promise<ResourceContent>;
+    metadata?: {
+        cacheable?: boolean;
+        cacheMaxAge?: number;
+    };
+}
+/**
+ * Resource content types
+ */
+export type ResourceContent = {
+    type: 'text';
+    data: string;
+} | {
+    type: 'binary';
+    data: Buffer;
+} | {
+    type: 'json';
+    data: any;
+};
+/**
+ * Prompt definition
+ */
+export interface PromptDefinition {
+    name: string;
+    description: string;
+    arguments?: PromptArgument[];
+    handler: (args: Record<string, any>, context: ExecutionContext) => Promise<PromptMessage[]>;
+}
+/**
+ * Prompt argument
+ */
+export interface PromptArgument {
+    name: string;
+    description: string;
+    required?: boolean;
+}
+/**
+ * Prompt message
+ */
+export interface PromptMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+/**
+ * Execution context passed to handlers
+ */
+export interface ExecutionContext {
+    requestId: string;
+    toolName?: string;
+    logger: Logger;
+    metadata?: Record<string, any>;
+    auth?: {
+        subject?: string;
+        scopes?: string[];
+        [key: string]: any;
+    };
+}
+/**
+ * Logger interface
+ */
+export interface Logger {
+    debug(message: string, meta?: any): void;
+    info(message: string, meta?: any): void;
+    warn(message: string, meta?: any): void;
+    error(message: string, meta?: any): void;
+}
+/**
+ * Server statistics
+ */
+export interface ServerStats {
+    toolCalls: number;
+    resourceReads: number;
+    promptExecutions: number;
+    errors: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/core/widgets/widget-examples.resource.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Widget Examples Resource
+ *
+ * Exposes widget metadata and examples via MCP protocol
+ */
+/**
+ * Build widget examples resource
+ * Returns resource definition for widget://examples
+ */
+export declare function buildWidgetExamplesResource(): Promise<{
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    read: () => Promise<string>;
+}>;
+//# sourceMappingURL=widget-examples.resource.d.ts.map

package/dist/core/widgets/widget-examples.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-examples.resource.d.ts","sourceRoot":"","sources":["../../../src/core/widgets/widget-examples.resource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7B,CAAC,CAiBD"}

package/dist/core/widgets/widget-examples.resource.js

@@ -0,0 +1,28 @@
+/**
+ * Widget Examples Resource
+ *
+ * Exposes widget metadata and examples via MCP protocol
+ */
+import { getWidgetRegistry } from './widget-registry.js';
+/**
+ * Build widget examples resource
+ * Returns resource definition for widget://examples
+ */
+export async function buildWidgetExamplesResource() {
+    return {
+        uri: 'widget://examples',
+        name: 'Widget Examples',
+        description: 'Provides metadata and examples for all registered UI widgets',
+        mimeType: 'application/json',
+        read: async () => {
+            const registry = getWidgetRegistry();
+            const widgets = registry.getAllWidgets();
+            return JSON.stringify({
+                widgets,
+                count: widgets.length,
+                loaded: registry.isLoaded(),
+            }, null, 2);
+        },
+    };
+}
+//# sourceMappingURL=widget-examples.resource.js.map

package/dist/core/widgets/widget-examples.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-examples.resource.js","sourceRoot":"","sources":["../../../src/core/widgets/widget-examples.resource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B;IAO/C,OAAO;QACL,GAAG,EAAE,mBAAmB;QACxB,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,8DAA8D;QAC3E,QAAQ,EAAE,kBAAkB;QAC5B,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;YAEzC,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO;gBACP,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE;aAC5B,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/widgets/widget-registry.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Widget Registry
+ *
+ * Manages widget metadata and example resolution
+ */
+export interface WidgetExample {
+    name: string;
+    description: string;
+    data: Record<string, any>;
+}
+export interface WidgetMetadata {
+    uri: string;
+    name: string;
+    description: string;
+    examples: WidgetExample[];
+    tags?: string[];
+}
+export interface WidgetManifest {
+    version: string;
+    widgets: WidgetMetadata[];
+    generatedAt: string;
+}
+/**
+ * Widget Registry
+ * Loads and manages widget metadata from manifest
+ */
+export declare class WidgetRegistry {
+    private widgets;
+    private loaded;
+    /**
+     * Load widget manifest from file
+     */
+    loadManifest(manifestPath: string): void;
+    /**
+     * Get all widgets
+     */
+    getAllWidgets(): WidgetMetadata[];
+    /**
+     * Get widget by URI
+     */
+    getWidget(uri: string): WidgetMetadata | undefined;
+    /**
+     * Get widget example data
+     * Returns the first example's data, or undefined if no examples
+     */
+    getWidgetExampleData(uri: string): Record<string, any> | undefined;
+    /**
+     * Check if manifest is loaded
+     */
+    isLoaded(): boolean;
+}
+/**
+ * Get the global widget registry instance
+ */
+export declare function getWidgetRegistry(): WidgetRegistry;
+//# sourceMappingURL=widget-registry.d.ts.map

package/dist/core/widgets/widget-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-registry.d.ts","sourceRoot":"","sources":["../../../src/core/widgets/widget-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,MAAM,CAAkB;IAEhC;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAuBxC;;OAEG;IACH,aAAa,IAAI,cAAc,EAAE;IAIjC;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIlD;;;OAGG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;IAKlE;;OAEG;IACH,QAAQ,IAAI,OAAO;CAGpB;AAKD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD"}

package/dist/core/widgets/widget-registry.js

@@ -0,0 +1,75 @@
+/**
+ * Widget Registry
+ *
+ * Manages widget metadata and example resolution
+ */
+import { readFileSync, existsSync } from 'fs';
+/**
+ * Widget Registry
+ * Loads and manages widget metadata from manifest
+ */
+export class WidgetRegistry {
+    widgets = new Map();
+    loaded = false;
+    /**
+     * Load widget manifest from file
+     */
+    loadManifest(manifestPath) {
+        if (!existsSync(manifestPath)) {
+            // Use stderr to avoid corrupting MCP stdio protocol
+            console.error(`[Widget Registry] Manifest not found at ${manifestPath}, skipping widget examples`);
+            return;
+        }
+        try {
+            const manifestContent = readFileSync(manifestPath, 'utf-8');
+            const manifest = JSON.parse(manifestContent);
+            for (const widget of manifest.widgets) {
+                this.widgets.set(widget.uri, widget);
+            }
+            this.loaded = true;
+            // Use stderr to avoid corrupting MCP stdio protocol
+            console.error(`[Widget Registry] Loaded ${this.widgets.size} widget(s) from manifest`);
+        }
+        catch (error) {
+            console.error(`[Widget Registry] Failed to load widget manifest:`, error.message);
+        }
+    }
+    /**
+     * Get all widgets
+     */
+    getAllWidgets() {
+        return Array.from(this.widgets.values());
+    }
+    /**
+     * Get widget by URI
+     */
+    getWidget(uri) {
+        return this.widgets.get(uri);
+    }
+    /**
+     * Get widget example data
+     * Returns the first example's data, or undefined if no examples
+     */
+    getWidgetExampleData(uri) {
+        const widget = this.widgets.get(uri);
+        return widget?.examples[0]?.data;
+    }
+    /**
+     * Check if manifest is loaded
+     */
+    isLoaded() {
+        return this.loaded;
+    }
+}
+// Global registry instance
+let registryInstance = null;
+/**
+ * Get the global widget registry instance
+ */
+export function getWidgetRegistry() {
+    if (!registryInstance) {
+        registryInstance = new WidgetRegistry();
+    }
+    return registryInstance;
+}
+//# sourceMappingURL=widget-registry.js.map

package/dist/core/widgets/widget-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-registry.js","sourceRoot":"","sources":["../../../src/core/widgets/widget-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAuB9C;;;GAGG;AACH,MAAM,OAAO,cAAc;IACjB,OAAO,GAAgC,IAAI,GAAG,EAAE,CAAC;IACjD,MAAM,GAAY,KAAK,CAAC;IAEhC;;OAEG;IACH,YAAY,CAAC,YAAoB;QAC/B,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,oDAAoD;YACpD,OAAO,CAAC,KAAK,CAAC,2CAA2C,YAAY,4BAA4B,CAAC,CAAC;YACnG,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAC5D,MAAM,QAAQ,GAAmB,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YAE7D,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACvC,CAAC;YAED,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,oDAAoD;YACpD,OAAO,CAAC,KAAK,CAAC,4BAA4B,IAAI,CAAC,OAAO,CAAC,IAAI,0BAA0B,CAAC,CAAC;QACzF,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,mDAAmD,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,oBAAoB,CAAC,GAAW;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAED,2BAA2B;AAC3B,IAAI,gBAAgB,GAA0B,IAAI,CAAC;AAEnD;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,gBAAgB,GAAG,IAAI,cAAc,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,82 @@
+import 'reflect-metadata';
+import { DIContainer } from '../core/di/container.js';
+import { ExecutionContext, Logger } from '../core/types.js';
+declare global {
+    var jest: any | undefined;
+}
+/**
+ * Testing utilities for NitroStack
+ */
+/**
+ * Mock logger for testing
+ */
+export declare class MockLogger implements Logger {
+    logs: {
+        level: string;
+        message: string;
+        meta?: any;
+    }[];
+    debug(message: string, meta?: any): void;
+    info(message: string, meta?: any): void;
+    warn(message: string, meta?: any): void;
+    error(message: string, meta?: any): void;
+    clear(): void;
+    hasLog(level: string, message: string): boolean;
+}
+/**
+ * Create a mock execution context for testing
+ */
+export declare function createMockContext(overrides?: Partial<ExecutionContext>): ExecutionContext;
+/**
+ * Testing module builder
+ */
+export declare class TestingModule {
+    private container;
+    private providers;
+    private mocks;
+    private constructor();
+    /**
+     * Create a testing module
+     */
+    static create(): TestingModule;
+    /**
+     * Add a provider to the module
+     */
+    addProvider(token: any, provider?: any): this;
+    /**
+     * Add a mock to the module
+     */
+    addMock<T = any>(token: any, mock: T): this;
+    /**
+     * Compile the testing module
+     */
+    compile(): CompiledTestingModule;
+}
+/**
+ * Compiled testing module
+ */
+export declare class CompiledTestingModule {
+    private container;
+    constructor(container: DIContainer);
+    /**
+     * Get an instance from the container
+     */
+    get<T>(token: any): T;
+    /**
+     * Cleanup the module
+     */
+    cleanup(): void;
+}
+/**
+ * Create a mock function (compatible with Jest)
+ */
+export declare function createMockFn<T extends (...args: any[]) => any>(): any;
+/**
+ * Wait for async operations to complete
+ */
+export declare function flushPromises(): Promise<void>;
+/**
+ * Spy on a method
+ */
+export declare function spyOn<T extends object, K extends keyof T>(obj: T, method: K): any;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,IAAI,EAAE,GAAG,GAAG,SAAS,CAAC;CAC3B;AAED;;GAEG;AAEH;;GAEG;AACH,qBAAa,UAAW,YAAW,MAAM;IACvC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,GAAG,CAAA;KAAE,EAAE,CAAM;IAE5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIxC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIxC,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;CAGhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAUzF;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,KAAK,CAA4B;IAEzC,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,aAAa;IAI9B;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI;IAK7C;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAK3C;;OAEG;IACH,OAAO,IAAI,qBAAqB;CAkBjC;AAED;;GAEG;AACH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,WAAW;IAE1C;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;IAIrB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK,GAAG,CAwBrE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EACvD,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,CAAC,GACR,GAAG,CAmBL"}

package/dist/testing/index.js

@@ -0,0 +1,164 @@
+import 'reflect-metadata';
+import { DIContainer } from '../core/di/container.js';
+/**
+ * Testing utilities for NitroStack
+ */
+/**
+ * Mock logger for testing
+ */
+export class MockLogger {
+    logs = [];
+    debug(message, meta) {
+        this.logs.push({ level: 'debug', message, meta });
+    }
+    info(message, meta) {
+        this.logs.push({ level: 'info', message, meta });
+    }
+    warn(message, meta) {
+        this.logs.push({ level: 'warn', message, meta });
+    }
+    error(message, meta) {
+        this.logs.push({ level: 'error', message, meta });
+    }
+    clear() {
+        this.logs = [];
+    }
+    hasLog(level, message) {
+        return this.logs.some(log => log.level === level && log.message.includes(message));
+    }
+}
+/**
+ * Create a mock execution context for testing
+ */
+export function createMockContext(overrides) {
+    const mockLogger = new MockLogger();
+    return {
+        requestId: 'test-request-id',
+        logger: mockLogger,
+        metadata: {},
+        auth: undefined,
+        ...overrides,
+    };
+}
+/**
+ * Testing module builder
+ */
+export class TestingModule {
+    container;
+    providers = new Map();
+    mocks = new Map();
+    constructor() {
+        this.container = DIContainer.getInstance();
+    }
+    /**
+     * Create a testing module
+     */
+    static create() {
+        return new TestingModule();
+    }
+    /**
+     * Add a provider to the module
+     */
+    addProvider(token, provider) {
+        this.providers.set(token, provider || token);
+        return this;
+    }
+    /**
+     * Add a mock to the module
+     */
+    addMock(token, mock) {
+        this.mocks.set(token, mock);
+        return this;
+    }
+    /**
+     * Compile the testing module
+     */
+    compile() {
+        // Clear existing container
+        this.container.clear();
+        // Register mocks first (they take precedence)
+        for (const [token, mock] of this.mocks.entries()) {
+            this.container.registerValue(token, mock);
+        }
+        // Register providers
+        for (const [token, provider] of this.providers.entries()) {
+            if (!this.mocks.has(token)) {
+                this.container.register(token, provider);
+            }
+        }
+        return new CompiledTestingModule(this.container);
+    }
+}
+/**
+ * Compiled testing module
+ */
+export class CompiledTestingModule {
+    container;
+    constructor(container) {
+        this.container = container;
+    }
+    /**
+     * Get an instance from the container
+     */
+    get(token) {
+        return this.container.resolve(token);
+    }
+    /**
+     * Cleanup the module
+     */
+    cleanup() {
+        this.container.clear();
+    }
+}
+/**
+ * Create a mock function (compatible with Jest)
+ */
+export function createMockFn() {
+    // If jest is available, use it
+    if (typeof jest !== 'undefined' && jest?.fn) {
+        return jest.fn();
+    }
+    // Otherwise, create a simple mock
+    const fn = (...args) => {
+        fn.calls.push(args);
+        return fn.mockReturnValue;
+    };
+    fn.calls = [];
+    fn.mockReturnValue = undefined;
+    fn.mockResolvedValue = (value) => {
+        fn.mockReturnValue = Promise.resolve(value);
+        return fn;
+    };
+    fn.mockRejectedValue = (error) => {
+        fn.mockReturnValue = Promise.reject(error);
+        return fn;
+    };
+    return fn;
+}
+/**
+ * Wait for async operations to complete
+ */
+export async function flushPromises() {
+    return new Promise(resolve => setImmediate(resolve));
+}
+/**
+ * Spy on a method
+ */
+export function spyOn(obj, method) {
+    if (typeof jest !== 'undefined' && jest?.spyOn) {
+        return jest.spyOn(obj, method);
+    }
+    // Simple spy implementation
+    const original = obj[method];
+    const spy = (...args) => {
+        spy.calls.push(args);
+        return original.apply(obj, args);
+    };
+    spy.calls = [];
+    spy.restore = () => {
+        obj[method] = original;
+    };
+    obj[method] = spy;
+    return spy;
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

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

package/dist/ui-next/index.d.ts

@@ -0,0 +1,31 @@
+import { Component } from '../core/component.js';
+import { ExecutionContext } from '../core/types.js';
+export interface CreateNextComponentOptions {
+    id: string;
+    name: string;
+    projectDir: string;
+    entryHtml?: string;
+    description?: string;
+    prefersBorder?: boolean;
+    csp?: {
+        connectDomains?: string[];
+        resourceDomains?: string[];
+    };
+    transformer?: (data: any, context: ExecutionContext) => any;
+    build?: boolean;
+    buildScript?: string;
+}
+/**
+ * Build a Next.js widget and create a NitroStack Component from the exported HTML.
+ * Produces a single-file HTML bundle compatible with OpenAI Apps SDK widgets.
+ */
+export declare function createComponentFromNext(opts: CreateNextComponentOptions): Component;
+export declare const uiNext: {
+    createComponentFromNext: typeof createComponentFromNext;
+};
+export interface CreateNextRouteOptions extends Omit<CreateNextComponentOptions, 'entryHtml'> {
+    routePath: string;
+}
+export declare function createComponentFromNextRoute(routePath: string, options?: Partial<CreateNextRouteOptions>): Component;
+export declare function createComponentFromNextRoute(opts: CreateNextRouteOptions): Component;
+//# sourceMappingURL=index.d.ts.map

package/dist/ui-next/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui-next/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA8DpD,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,GAAG,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAChE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB,KAAK,GAAG,CAAC;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,0BAA0B,GAAG,SAAS,CAwCnF;AAED,eAAO,MAAM,MAAM;;CAA8B,CAAC;AAMlD,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,0BAA0B,EAAE,WAAW,CAAC;IAC3F,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,SAAS,CAAC;AACtH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,sBAAsB,GAAG,SAAS,CAAC"}