easy-mcp-nest 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Nir Arazi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,417 @@
+# EasyMCP Framework
+
+A NestJS-based framework for building standard Model Context Protocol (MCP) servers with tool execution via JSON-RPC 2.0.
+
+## Description
+
+EasyMCP simplifies the creation of MCP (Model Context Protocol) servers by providing a clean, type-safe framework that:
+
+- **Standard MCP Protocol**: Implements the Model Context Protocol specification with JSON-RPC 2.0 over stdio
+- **Tool Execution**: Register and execute tools that external LLM agents can discover and call
+- **Type Safety**: Full TypeScript support with comprehensive type definitions
+- **Simple Configuration**: Minimal setup required - just define your tools and run
+
+## Installation
+
+```bash
+npm install easy-mcp-framework
+# or
+pnpm add easy-mcp-framework
+# or
+yarn add easy-mcp-framework
+```
+
+### Peer Dependencies
+
+EasyMCP requires the following peer dependencies to be installed:
+
+- `@nestjs/common` ^11.0.1
+- `@nestjs/core` ^11.0.1
+- `@nestjs/platform-express` ^11.0.1
+
+Install them with:
+
+```bash
+npm install @nestjs/common@^11.0.1 @nestjs/core@^11.0.1 @nestjs/platform-express@^11.0.1
+```
+
+## Quick Start
+
+```typescript
+import { EasyMCP, McpConfig } from 'easy-mcp-framework';
+
+// Define your tools
+async function getUser(args: { userId: string }): Promise<string> {
+  // Your tool logic here
+  const user = await fetchUser(args.userId);
+  return JSON.stringify(user);
+}
+
+// Configure EasyMCP
+const config: McpConfig = {
+  tools: [
+    {
+      name: 'getUser',
+      description: 'Retrieves user details by ID',
+      function: getUser,
+      inputSchema: {
+        type: 'OBJECT',
+        properties: {
+          userId: {
+            type: 'STRING',
+            description: 'The unique ID of the user',
+          },
+        },
+        required: ['userId'],
+      },
+    },
+  ],
+};
+
+// Initialize and run
+async function bootstrap() {
+  await EasyMCP.initialize(config);
+  await EasyMCP.run();
+}
+
+bootstrap();
+```
+
+## Configuration
+
+### McpConfig
+
+The main configuration object passed to `EasyMCP.initialize()`:
+
+```typescript
+interface McpConfig {
+  tools: ToolRegistrationInput[];
+  serverInfo?: ServerInfo;
+}
+```
+
+### ToolRegistrationInput
+
+Each tool must implement:
+
+```typescript
+interface ToolRegistrationInput {
+  name: string;
+  description: string;
+  function: (args: Record<string, any>) => Promise<any>;
+  inputSchema: {
+    type: 'OBJECT';
+    properties: Record<string, {
+      type: 'STRING' | 'NUMBER' | 'INTEGER' | 'BOOLEAN' | 'ARRAY' | 'OBJECT';
+      description: string;
+      enum?: string[];
+    }>;
+    required?: string[];
+  };
+}
+```
+
+### ServerInfo (Optional)
+
+Optional server information for MCP initialize response:
+
+```typescript
+interface ServerInfo {
+  name: string;
+  version: string;
+}
+```
+
+### Example Tool
+
+```typescript
+async function searchDatabase(args: { query: string; limit?: number }): Promise<string> {
+  const results = await db.search(args.query, args.limit || 10);
+  return JSON.stringify(results);
+}
+
+const searchTool: ToolRegistrationInput = {
+  name: 'searchDatabase',
+  description: 'Searches the database for matching records',
+  function: searchDatabase,
+  inputSchema: {
+    type: 'OBJECT',
+    properties: {
+      query: {
+        type: 'STRING',
+        description: 'The search query',
+      },
+      limit: {
+        type: 'INTEGER',
+        description: 'Maximum number of results to return',
+      },
+    },
+    required: ['query'],
+  },
+};
+```
+
+## API Reference
+
+### EasyMCP Class
+
+#### `static initialize(config: McpConfig): Promise<void>`
+
+Initializes the EasyMCP framework with the provided configuration. Must be called before `run()`.
+
+#### `static run(): Promise<void>`
+
+Starts the EasyMCP server and begins listening for JSON-RPC requests via stdio.
+
+#### `static getService<T>(token: string | symbol): T`
+
+Retrieves a service from the NestJS application context. Useful for advanced use cases.
+
+#### `static shutdown(): Promise<void>`
+
+Gracefully shuts down the EasyMCP framework, closing the NestJS application context and cleaning up resources. Should be called when the application is terminating (e.g., on SIGTERM, SIGINT signals).
+
+```typescript
+// Example: Handle graceful shutdown
+process.on('SIGTERM', async () => {
+  await EasyMCP.shutdown();
+  process.exit(0);
+});
+
+process.on('SIGINT', async () => {
+  await EasyMCP.shutdown();
+  process.exit(0);
+});
+```
+
+### Types
+
+- `McpConfig` - Main configuration interface
+- `ToolRegistrationInput` - Tool definition interface
+- `ServerInfo` - Optional server information
+- `JsonRpcRequest`, `JsonRpcResponse` - JSON-RPC 2.0 types
+- `InitializeParams`, `InitializeResult` - MCP initialize types
+- `ListToolsResult`, `McpTool` - MCP tools types
+- `CallToolParams`, `CallToolResult` - MCP tool call types
+- `ToolDefinition`, `ToolParameter`, `ToolFunction` - Tool interfaces
+- `IInterfaceLayer` - Interface layer interface
+
+## Architecture
+
+EasyMCP uses a simplified architecture for standard MCP servers:
+
+1. **Interface Layer**: Handles JSON-RPC 2.0 communication over stdio
+2. **Core Layer**: Implements MCP protocol methods (initialize, tools/list, tools/call)
+3. **Tool Registry**: Manages tool registration and execution
+
+### Architecture Diagram
+
+```mermaid
+graph TB
+    MCPClient[MCP Client<br/>Claude Desktop, Cline, etc.] -->|stdio JSON-RPC| Interface[Interface Layer<br/>StdioGatewayService]
+    Interface -->|JsonRpcRequest| Core[McpServerService<br/>Core Orchestrator]
+    Core -->|getTools| Registry[ToolRegistryService]
+    Core -->|executeTool| Tools[User Tools]
+    Core -->|JsonRpcResponse| Interface
+    Interface -->|Response| MCPClient
+```
+
+## MCP Protocol Compliance
+
+EasyMCP implements the standard Model Context Protocol (MCP) specification version **2024-11-05**.
+
+### Protocol Version
+
+- **Supported Version**: `2024-11-05`
+- **Validation**: The framework validates that clients use the supported protocol version during initialization
+- **Error Handling**: Unsupported protocol versions are rejected with a clear error message
+
+### Supported Methods
+
+EasyMCP implements the following MCP protocol methods:
+
+- **`initialize`** - Server/client handshake, returns server capabilities and protocol version
+  - Validates client protocol version
+  - Returns server capabilities (currently supports tools)
+  - Returns server information (name and version)
+  
+- **`tools/list`** - Returns all registered tools with their JSON Schema definitions
+  - Returns array of tool definitions in MCP format
+  - Each tool includes name, description, and inputSchema
+  
+- **`tools/call`** - Executes a tool with provided arguments and returns the result
+  - Validates tool arguments against schema
+  - Executes tool function
+  - Returns result in MCP content format
+  - Handles errors according to MCP error code specification
+
+### Error Codes
+
+EasyMCP uses standard JSON-RPC 2.0 and MCP error codes:
+
+- `-32700` - Parse error
+- `-32600` - Invalid request
+- `-32601` - Method not found
+- `-32602` - Invalid params
+- `-32603` - Internal error
+- `-32001` - Tool not found (MCP-specific)
+- `-32002` - Tool execution error (MCP-specific)
+
+### Transport
+
+The server communicates via JSON-RPC 2.0 over stdio (standard input/output), which is the standard transport for MCP servers. This allows the server to be used with MCP clients like Claude Desktop, Cursor, Cline, and other MCP-compatible tools.
+
+**Default Mode: Newline-Delimited JSON**
+
+By default, the server uses newline-delimited JSON (one JSON-RPC message per line) for maximum compatibility with MCP clients. This mode works seamlessly with Cursor, Claude Desktop, and other popular MCP clients.
+
+**Content-Length Framing Mode (Optional)**
+
+For strict MCP protocol compliance with Content-Length framing, set the environment variable:
+```bash
+MCP_USE_CONTENT_LENGTH=1
+```
+
+This enables the MCP-specified Content-Length header format, which some clients may not parse correctly.
+
+### Limitations
+
+- **Transport**: Currently only stdio transport is supported. WebSocket and HTTP transports are not available.
+- **Capabilities**: Only tools capability is implemented. Resources and prompts capabilities are not yet supported.
+- **Protocol Version**: Only protocol version 2024-11-05 is supported. Older or newer versions will be rejected.
+
+For more information on testing EasyMCP with real MCP clients, see [Integration Testing Guide](docs/INTEGRATION_TESTING.md).
+
+## Error Handling
+
+EasyMCP provides comprehensive error handling with custom error classes and clear error messages.
+
+### Error Classes
+
+- **`EasyMcpError`** - Base error class for all framework errors
+- **`ConfigurationError`** - Configuration validation errors (thrown during `initialize()`)
+- **`ToolExecutionError`** - Tool execution failures (wrapped and returned as MCP error)
+- **`ToolNotFoundError`** - Tool not found in registry (returned as MCP error code -32001)
+
+### Error Handling Examples
+
+```typescript
+import { 
+  EasyMCP, 
+  ConfigurationError, 
+  ToolExecutionError, 
+  ToolNotFoundError
+} from 'easy-mcp-framework';
+
+// Configuration errors - caught during initialization
+try {
+  await EasyMCP.initialize(config);
+} catch (error) {
+  if (error instanceof ConfigurationError) {
+    console.error('Configuration error:', error.message);
+    // Example: "Tool 'myTool': name must be a non-empty string"
+  }
+}
+
+// Tool execution errors - handled automatically by MCP protocol
+// When a tool throws an error, it's automatically converted to an MCP error response
+// The error is logged to stderr and returned to the client with error code -32002
+```
+
+### Common Error Scenarios
+
+**Configuration Errors:**
+- Missing required fields (tools array, tool name, description, etc.)
+- Invalid tool schemas (unsupported types, missing properties)
+- Invalid serverInfo format
+
+**Tool Execution Errors:**
+- Tool function throws an exception → Returns MCP error code -32002
+- Tool not found → Returns MCP error code -32001
+- Invalid tool arguments → Returns JSON-RPC error code -32602 (Invalid Params)
+
+**Protocol Errors:**
+- Unsupported protocol version → Returns error code -32602 with clear message
+- Invalid JSON-RPC request → Returns error code -32600 (Invalid Request)
+- Unknown method → Returns error code -32601 (Method Not Found)
+
+### Error Message Format
+
+All error messages are designed to be helpful for debugging:
+- Include the context (tool name, parameter name, etc.)
+- Provide suggestions when possible
+- Never expose internal implementation details to clients
+
+Example error messages:
+- `"Tool 'getUser': property 'userId' must have a description"`
+- `"Unsupported protocol version: 2024-10-01. Supported version: 2024-11-05"`
+- `"Missing required parameter: userId"`
+
+## Troubleshooting
+
+### Tools Not Executing
+
+If tools are registered but not being called:
+
+1. **Check Tool Registration**: Verify tools appear in console log during initialization
+2. **Tool Schema**: Ensure `inputSchema` matches JSON Schema format
+3. **Tool Description**: Make tool descriptions clear so LLM agents know when to use them
+4. **MCP Client**: Verify your MCP client (Claude Desktop, etc.) is properly configured
+5. **Enable Debug Logging**: Set `DEBUG=1` environment variable to see detailed protocol messages
+
+### Build/Import Issues
+
+If you encounter TypeScript or import errors:
+
+1. **Peer Dependencies**: Ensure all peer dependencies are installed (see Installation section)
+2. **Type Exports**: Verify you're importing from the main package: `import { EasyMCP } from 'easy-mcp-framework'`
+3. **Build Output**: Check that `dist/index.js` and `dist/index.d.ts` exist after building
+4. **Module Resolution**: Ensure your `tsconfig.json` has proper module resolution settings
+
+### Protocol Version Errors
+
+If you see "Unsupported protocol version" errors:
+
+1. **Check Client Version**: Ensure your MCP client uses protocol version `2024-11-05`
+2. **Update Client**: Update your MCP client to the latest version
+3. **Debug Mode**: Set `DEBUG=1` to see detailed protocol version information
+
+### Integration Issues
+
+If your server doesn't work with MCP clients:
+
+1. **Check Configuration**: Verify your MCP client configuration is correct
+2. **Test Server**: Run your server script directly to verify it starts correctly
+3. **Review Logs**: Check stderr output for initialization and error messages
+4. **Integration Guide**: See [Integration Testing Guide](docs/INTEGRATION_TESTING.md) for detailed setup instructions
+5. **Examples**: Check [examples/claude-desktop-integration](examples/claude-desktop-integration) and [examples/cursor-integration](examples/cursor-integration) for client-specific setup
+
+### Debug Mode
+
+Enable debug logging to troubleshoot issues:
+
+```bash
+DEBUG=1 node your-server.js
+```
+
+Debug mode provides detailed information about:
+- Protocol message flow
+- Tool execution details
+- Protocol version validation
+- Argument validation
+
+## Examples
+
+See the `examples/` directory for complete working examples.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Support
+
+For issues and questions, please open an issue on [GitHub](https://github.com/nirarazi/easy-mcp).

package/dist/EasyMCP.d.ts

@@ -0,0 +1,8 @@
+import { McpConfig } from "./config/mcp-config.interface";
+export declare class EasyMCP {
+    private static app;
+    static initialize(config: McpConfig): Promise<void>;
+    static run(): Promise<void>;
+    static getService<T>(token: string | symbol): T;
+    static shutdown(): Promise<void>;
+}

package/dist/EasyMCP.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EasyMCP = void 0;
+const core_1 = require("@nestjs/core");
+const app_module_1 = require("./app.module");
+const constants_1 = require("./config/constants");
+const mcp_server_service_1 = require("./core/mcp-server/mcp-server.service");
+const config_validator_1 = require("./config/config-validator");
+const tool_registry_service_1 = require("./tooling/tool-registry/tool-registry.service");
+const logger_util_1 = require("./core/utils/logger.util");
+const sanitize_util_1 = require("./core/utils/sanitize.util");
+const nestjs_stderr_logger_1 = require("./core/utils/nestjs-stderr-logger");
+class EasyMCP {
+    static app;
+    static async initialize(config) {
+        if (this.app) {
+            logger_util_1.logger.warn("EasyMCP", "EasyMCP is already initialized", {
+                component: "EasyMCP",
+            });
+            return;
+        }
+        config_validator_1.ConfigValidator.validate(config);
+        const moduleRef = await core_1.NestFactory.createApplicationContext(app_module_1.AppModule, {
+            logger: new nestjs_stderr_logger_1.NestjsStderrLogger(),
+        });
+        this.app = moduleRef;
+        const configHolder = moduleRef.get(constants_1.CONFIG_TOKEN);
+        configHolder.setConfig(config);
+        if (config.tools && config.tools.length > 0) {
+            const toolRegistry = moduleRef.get(tool_registry_service_1.ToolRegistryService);
+            for (const tool of config.tools) {
+                try {
+                    toolRegistry.registerToolFromConfig(tool);
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    throw new Error(`Failed to register tool '${tool.name}': ${errorMessage}`);
+                }
+            }
+            logger_util_1.logger.info("EasyMCP", `Registered ${config.tools.length} tool(s) from configuration`, {
+                component: "EasyMCP",
+                toolCount: config.tools.length,
+            });
+        }
+        logger_util_1.logger.info("EasyMCP", "EasyMCP Framework initialized successfully", {
+            component: "EasyMCP",
+        });
+    }
+    static async run() {
+        if (!this.app) {
+            throw new Error("EasyMCP is not initialized. Call EasyMCP.initialize() first.");
+        }
+        logger_util_1.logger.info("EasyMCP", "Starting EasyMCP core services", {
+            component: "EasyMCP",
+        });
+        try {
+            const mcpServer = this.app.get(mcp_server_service_1.McpServerService);
+            await mcpServer.startListening();
+            logger_util_1.logger.info("EasyMCP", "EasyMCP core services are now running and listening for JSON-RPC requests via stdio", {
+                component: "EasyMCP",
+            });
+        }
+        catch (error) {
+            logger_util_1.logger.error("EasyMCP", "Failed to start EasyMCP core services", {
+                component: "EasyMCP",
+                error: (0, sanitize_util_1.sanitizeErrorMessage)(error),
+            });
+            await this.app.close();
+            throw error;
+        }
+    }
+    static getService(token) {
+        if (!this.app) {
+            throw new Error("EasyMCP is not initialized.");
+        }
+        return this.app.get(token);
+    }
+    static async shutdown() {
+        if (!this.app) {
+            logger_util_1.logger.warn("EasyMCP", "EasyMCP is not initialized. Nothing to shutdown", {
+                component: "EasyMCP",
+            });
+            return;
+        }
+        logger_util_1.logger.info("EasyMCP", "Shutting down EasyMCP framework", {
+            component: "EasyMCP",
+        });
+        try {
+            await this.app.close();
+            this.app = null;
+            logger_util_1.logger.info("EasyMCP", "EasyMCP framework shut down successfully", {
+                component: "EasyMCP",
+            });
+        }
+        catch (error) {
+            logger_util_1.logger.error("EasyMCP", "Error during EasyMCP shutdown", {
+                component: "EasyMCP",
+                error: (0, sanitize_util_1.sanitizeErrorMessage)(error),
+            });
+            throw error;
+        }
+    }
+}
+exports.EasyMCP = EasyMCP;
+//# sourceMappingURL=EasyMCP.js.map

package/dist/EasyMCP.js.map

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

package/dist/app.controller.d.ts

@@ -0,0 +1,6 @@
+import { AppService } from "./app.service";
+export declare class AppController {
+    private readonly appService;
+    constructor(appService: AppService);
+    getHello(): string;
+}

package/dist/app.controller.js

@@ -0,0 +1,35 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppController = void 0;
+const common_1 = require("@nestjs/common");
+const app_service_1 = require("./app.service");
+let AppController = class AppController {
+    appService;
+    constructor(appService) {
+        this.appService = appService;
+    }
+    getHello() {
+        return this.appService.getHello();
+    }
+};
+exports.AppController = AppController;
+__decorate([
+    (0, common_1.Get)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", String)
+], AppController.prototype, "getHello", null);
+exports.AppController = AppController = __decorate([
+    (0, common_1.Controller)(),
+    __metadata("design:paramtypes", [app_service_1.AppService])
+], AppController);
+//# sourceMappingURL=app.controller.js.map

package/dist/app.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.controller.js","sourceRoot":"","sources":["../src/app.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAiD;AACjD,+CAA2C;AAGpC,IAAM,aAAa,GAAnB,MAAM,aAAa;IACK;IAA7B,YAA6B,UAAsB;QAAtB,eAAU,GAAV,UAAU,CAAY;IAAG,CAAC;IAGvD,QAAQ;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC;CACF,CAAA;AAPY,sCAAa;AAIxB;IADC,IAAA,YAAG,GAAE;;;;6CAGL;wBANU,aAAa;IADzB,IAAA,mBAAU,GAAE;qCAE8B,wBAAU;GADxC,aAAa,CAOzB"}

package/dist/app.module.d.ts

@@ -0,0 +1,2 @@
+export declare class AppModule {
+}

package/dist/app.module.js

@@ -0,0 +1,34 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppModule = void 0;
+const common_1 = require("@nestjs/common");
+const mcp_server_service_1 = require("./core/mcp-server/mcp-server.service");
+const tool_registry_service_1 = require("./tooling/tool-registry/tool-registry.service");
+const config_holder_service_1 = require("./config/config-holder.service");
+const constants_1 = require("./config/constants");
+const interface_module_1 = require("./interface/interface.module");
+let AppModule = class AppModule {
+};
+exports.AppModule = AppModule;
+exports.AppModule = AppModule = __decorate([
+    (0, common_1.Module)({
+        imports: [interface_module_1.InterfaceModule],
+        providers: [
+            mcp_server_service_1.McpServerService,
+            tool_registry_service_1.ToolRegistryService,
+            config_holder_service_1.ConfigHolderService,
+            {
+                provide: constants_1.CONFIG_TOKEN,
+                useExisting: config_holder_service_1.ConfigHolderService,
+            },
+        ],
+        exports: [mcp_server_service_1.McpServerService],
+    })
+], AppModule);
+//# sourceMappingURL=app.module.js.map

package/dist/app.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../src/app.module.ts"],"names":[],"mappings":";;;;;;;;;AAEA,2CAAwC;AACxC,6EAAwE;AACxE,yFAAoF;AACpF,0EAAqE;AACrE,kDAAkD;AAClD,mEAA+D;AAsBxD,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,8BAAS;oBAAT,SAAS;IAhBrB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,kCAAe,CAAC;QAC1B,SAAS,EAAE;YAET,qCAAgB;YAEhB,2CAAmB;YACnB,2CAAmB;YAEnB;gBACE,OAAO,EAAE,wBAAY;gBACrB,WAAW,EAAE,2CAAmB;aACjC;SACF;QACD,OAAO,EAAE,CAAC,qCAAgB,CAAC;KAC5B,CAAC;GACW,SAAS,CAAG"}

package/dist/app.service.d.ts

@@ -0,0 +1,3 @@
+export declare class AppService {
+    getHello(): string;
+}

package/dist/app.service.js

@@ -0,0 +1,20 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppService = void 0;
+const common_1 = require("@nestjs/common");
+let AppService = class AppService {
+    getHello() {
+        return "Hello World!";
+    }
+};
+exports.AppService = AppService;
+exports.AppService = AppService = __decorate([
+    (0, common_1.Injectable)()
+], AppService);
+//# sourceMappingURL=app.service.js.map

package/dist/app.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.service.js","sourceRoot":"","sources":["../src/app.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAGrC,IAAM,UAAU,GAAhB,MAAM,UAAU;IACrB,QAAQ;QACN,OAAO,cAAc,CAAC;IACxB,CAAC;CACF,CAAA;AAJY,gCAAU;qBAAV,UAAU;IADtB,IAAA,mBAAU,GAAE;GACA,UAAU,CAItB"}