fa-mcp-sdk 0.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Michael Makarov
+
+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,283 @@
+# fa-mcp-sdk
+
+Production-ready core framework for building MCP (Model Context Protocol) servers with comprehensive 
+infrastructure support.
+
+## Overview
+
+This framework provides complete infrastructure for building enterprise-grade MCP servers with support for:
+
+- **Dual Transport**: STDIO (Claude Desktop) and HTTP/SSE (web clients)
+- **Database Integration**: PostgreSQL with pgvector for vector operations
+- **Service Discovery**: Consul integration for microservices
+- **Authentication**: Token-based security with configurable endpoints
+- **Rate Limiting**: Configurable rate limiting for all endpoints
+- **API Documentation**: Automatic Swagger generation
+- **Production Logging**: Structured logging with data masking
+- **Configuration Management**: YAML-based with environment overrides
+
+The framework uses dependency injection to keep the core completely agnostic of project-specific implementations.
+
+## Project Structure
+
+```
+fa-mcp-sdk/
+├── src/core/           # Core framework (published to npm)
+│   ├── bootstrap/      # Configuration and startup
+│   ├── mcp/            # MCP protocol implementation
+│   ├── web/            # HTTP server and endpoints
+│   ├── db/             # PostgreSQL integration
+│   ├── consul/         # Service discovery
+│   ├── token/          # Authentication
+│   ├── errors/         # Error handling
+│   ├── utils/          # Utilities
+│   └── index.ts        # Public API
+│
+└── src/template/       # Reference implementation
+    ├── tools/          # Example MCP tools
+    ├── prompts/        # Agent prompts
+    ├── api/            # Custom HTTP endpoints
+    └── start.ts        # Entry point
+```
+
+## Quick Start
+
+### 1. Install Dependencies
+
+```bash
+npm install
+```
+
+### 2. Configure
+
+Create configuration files in `config/`:
+
+See [config/default.yaml](config/default.yaml) for all available options.
+See [config/_local.yaml](config/_local.yaml) for template of local configuration.
+
+
+### 3. Basic Usage
+
+```typescript
+import { initMcpServer, isMainModule, McpServerData } from '../core/index.js';
+import { readFileSync } from 'fs';
+import { join } from 'path';
+
+export async function startProject(): Promise<void> {
+  // Read favicon from assets
+  const faviconPath = join(process.cwd(), 'src/template/asset/favicon.svg');
+  let favicon: string;
+
+  try {
+    favicon = readFileSync(faviconPath, 'utf-8');
+  } catch (_error) {
+    // Fallback if favicon not found
+    favicon = `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16">
+<rect width="16" height="16" fill="#007ACC"/>
+</svg>`;
+  }
+
+  // Assemble all data to pass to the core
+  const serverData: McpServerData = {
+    // Required: MCP components
+    tools: [
+      {
+        name: 'example_tool',
+        description: 'Example tool',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            query: { type: 'string', description: 'Query parameter' }
+          }
+        }
+      }
+    ],
+    toolHandler: async (params) => {
+      const { name, arguments: args } = params;
+      if (name === 'example_tool') {
+        return `Result: ${args.query}`;
+      }
+      throw new Error(`Unknown tool: ${name}`);
+    },
+
+    // Required: Agent identification
+    agentBrief: "My MCP Server - Brief description for agent selection",
+    agentPrompt: "Detailed system prompt for the agent",
+
+    // Optional: Custom prompts and resources
+    customPrompts: [],
+    customResources: [],
+
+    // Optional: HTTP components
+    httpComponents: {
+      apiRouter, // Express router for custom endpoints
+      endpointsOn404, // 404 handler
+      swagger: {
+        swaggerSpecs: swaggerSpecs, // OpenAPI specs
+        swaggerUi: swaggerUi, // Swagger UI configuration
+      },
+    },
+
+    // Optional: Assets
+    assets: { favicon },
+
+    // Optional: Function to get Consul UI address
+    getConsulUIAddress: (serviceId: string) =>
+      `https://consul.my.ui/ui/dc-dev/services/${serviceId}/instances`,
+  };
+
+  // Start MCP server with assembled data
+  await initMcpServer(serverData);
+}
+
+// Auto-start if this file is run directly
+if (isMainModule(import.meta.url)) {
+  startProject().catch(error => {
+    console.error('Failed to start project:', error);
+    process.exit(1);
+  });
+}
+```
+
+For NPM package usage:
+
+```typescript
+import { initMcpServer, McpServerData } from '@mcp-staff/server-core';
+// Rest of the code is similar, but with package imports
+```
+
+## Transport Modes
+
+### STDIO Mode (Claude Desktop)
+
+For integration with Claude Desktop:
+
+```bash
+# Set transport in config
+mcp.transportType: stdio
+
+# Or via command line
+npm start stdio
+```
+
+Communication happens via stdin/stdout using JSON-RPC protocol.
+
+### HTTP Mode (Web Integration)
+
+For web applications and API access:
+
+```bash
+# Default mode
+npm start
+```
+
+Provides endpoints:
+
+- `GET /` - About page with server info
+- `GET /health` - Health check
+- `GET /sse` - Server-Sent Events for MCP communication
+- `POST /mcp` - Direct MCP JSON-RPC endpoint
+- `GET /docs` - Swagger API documentation
+- `/api/*` - Custom API endpoints
+
+## Core Features
+
+### Database Integration
+
+Built-in PostgreSQL support with connection pooling:
+
+All available functions see [src/core/db/pg-db.ts](src/core/db/pg-db.ts)
+
+
+
+## Template Project
+
+The `src/template/` directory contains a complete reference implementation:
+
+### Running the Template
+
+```bash
+# Development mode (watch for changes)
+npm run template:dev
+
+# Production mode
+npm run template:start
+
+# STDIO mode for Claude Desktop
+npm run template:stdio
+```
+
+### Template Structure
+
+- **Tools**: `src/template/tools/tools.ts` - Define your MCP tools
+- **Handlers**: `src/template/tools/handle-tool-call.ts` - Implement tool logic
+- **Prompts**: `src/template/prompts/` - Agent system prompts
+- **API**: `src/template/api/router.ts` - Custom HTTP endpoints
+- **Config**: `config/` - Configuration files
+
+## Configuration
+
+### Environment Variables
+
+Set via `config/custom-environment-variables.yaml`:
+
+```bash
+DB_HOST=localhost # To exclude the use of the database, you need to set host = ''
+DB_NAME=mydb
+DB_USER=user
+DB_PASSWORD=password
+MCP_TRANSPORT_TYPE=http
+WS_PORT=9020
+WS_AUTH_ENABLED=false
+```
+
+### Configuration Priority
+
+1. Environment variables
+2. Environment-specific YAML (`development.yaml`, `production.yaml`)
+3. `config/default.yaml`
+4. Package.json metadata
+
+## Development
+
+### Building
+
+```bash
+npm run build     # Build TypeScript
+npm run clean     # Clean dist/
+npm run cb        # Clean + build
+```
+
+### Linting
+
+```bash
+npm run lint      # Check code style
+npm run lint:fix  # Fix automatically
+```
+
+### Type Checking
+
+```bash
+npm run typecheck
+```
+
+## API Reference
+
+### McpServerData Interface
+
+See: [src/core/_types_/types.ts](src/core/_types_/types.ts)
+
+### Core Exports
+
+See: [src/core/index.ts](src/core/index.ts)
+
+## Requirements
+
+- **Node.js**: >= 18.0.0
+- **TypeScript**: >= 5.0.0
+- **PostgreSQL**: >= 12 (optional)
+- **Consul**: Any version (optional)
+
+## License
+
+MIT

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

@@ -0,0 +1,67 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { Router } from 'express';
+export interface IPromptData {
+    name: string;
+    description: string;
+    arguments: [];
+    content: IPromptContent;
+}
+export interface IRequiredHttpHeader {
+    name: string;
+    description: string;
+}
+export interface IResourceData {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    content: string | IRequiredHttpHeader[];
+}
+export type IEndpointsOn404 = Record<string, string | string[]>;
+export interface ISwaggerData {
+    swaggerSpecs: any;
+    swaggerUi: any;
+}
+/**
+ * All data that needs to be passed to initialize the MCP server
+ */
+export interface McpServerData {
+    tools: Tool[];
+    toolHandler: (params: {
+        name: string;
+        arguments?: any;
+    }) => Promise<any>;
+    agentBrief: string;
+    agentPrompt: string;
+    customPrompts?: IPromptData[];
+    requiredHttpHeaders?: IRequiredHttpHeader[] | null;
+    customResources?: IResourceData[] | null;
+    httpComponents?: {
+        apiRouter?: Router | null;
+        endpointsOn404?: IEndpointsOn404;
+        swagger?: ISwaggerData | null;
+    };
+    assets?: {
+        favicon?: string;
+        maintainerHtml?: string;
+    };
+    getConsulUIAddress?: (serviceId: string) => string;
+}
+export interface IGetPromptRequest {
+    id?: string | number;
+    method: 'prompts/get' | 'prompts/content';
+    params: IGetPromptParams;
+}
+export type IPromptContent = string | ((request: IGetPromptRequest) => string | Promise<string>);
+export interface IGetPromptParams {
+    name: string;
+    arguments?: Record<string, string>;
+}
+export interface IReadResourceRequest {
+    method: 'resources/read';
+    params: {
+        uri: string;
+    };
+    id?: string | number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/_types_/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,EAAE,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAAC;CACzC;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;AAE/D,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,GAAG,CAAC;IAClB,SAAS,EAAE,GAAG,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAE5B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,WAAW,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,GAAG,CAAA;KAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAGzE,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAG9B,mBAAmB,CAAC,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAC;IACnD,eAAe,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAEzC,cAAc,CAAC,EAAE;QACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,cAAc,CAAC,EAAE,eAAe,CAAC;QACjC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;KAC/B,CAAC;IAEF,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IAGF,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CACpD;AAGD,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,MAAM,EAAE,aAAa,GAAG,iBAAiB,CAAC;IAC1C,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,iBAAiB,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAEjG,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB"}

package/dist/core/_types_/types.js

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

package/dist/core/_types_/types.js.map

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

package/dist/core/bootstrap/dotenv.d.ts

@@ -0,0 +1,3 @@
+import * as dotenv from 'dotenv';
+export declare const dotEnvResult: dotenv.DotenvConfigOutput;
+//# sourceMappingURL=dotenv.d.ts.map

package/dist/core/bootstrap/dotenv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dotenv.d.ts","sourceRoot":"","sources":["../../../src/core/bootstrap/dotenv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,eAAO,MAAM,YAAY,2BAAkB,CAAC"}

package/dist/core/bootstrap/dotenv.js

@@ -0,0 +1,3 @@
+import * as dotenv from 'dotenv';
+export const dotEnvResult = dotenv.config();
+//# sourceMappingURL=dotenv.js.map

package/dist/core/bootstrap/dotenv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dotenv.js","sourceRoot":"","sources":["../../../src/core/bootstrap/dotenv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC"}

package/dist/core/bootstrap/init-config.d.ts

@@ -0,0 +1,11 @@
+import './dotenv.js';
+import { AppConfig } from '../_types_/config.js';
+export declare const config: AppConfig;
+import { McpServerData } from '../_types_/types.js';
+export declare const appConfig: AppConfig;
+/**
+ * Returns configuration with sensitive data masked for safe display
+ */
+export declare function getSafeAppConfig(): any;
+export declare function getProjectData(): McpServerData;
+//# sourceMappingURL=init-config.d.ts.map

package/dist/core/bootstrap/init-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-config.d.ts","sourceRoot":"","sources":["../../../src/core/bootstrap/init-config.ts"],"names":[],"mappings":"AAEA,OAAO,aAAa,CAAC;AAErB,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,eAAO,MAAM,MAAM,EAAE,SAAwC,CAAC;AAK9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAiCpD,eAAO,MAAM,SAAS,EAAE,SAAyB,CAAC;AAElD;;GAEG;AACH,wBAAgB,gBAAgB,IAAK,GAAG,CASvC;AAED,wBAAgB,cAAc,IAAK,aAAa,CAE/C"}

package/dist/core/bootstrap/init-config.js

@@ -0,0 +1,52 @@
+// noinspection UnnecessaryLocalVariableJS
+import './dotenv.js'; // Load environment variables first
+import configModule from 'config';
+export const config = configModule.util.toObject();
+import { readFileSync } from 'fs';
+import * as path from 'path';
+import { trim } from '../utils/utils.js';
+const { name, productName, version, description, keywords, repository, homepage } = JSON.parse(readFileSync(path.join(process.cwd(), 'package.json'), 'utf-8'));
+/**
+ * Build application configuration from YAML and environment variables
+ * Priority: environment variables > config.yaml > defaults
+ */
+function buildConfig() {
+    const shortName = name.replace(/[\s\-]*\bmcp\b[\s\-]*/ig, '');
+    const cfg = {
+        ...config,
+        // Package metadata from package.json
+        name,
+        shortName,
+        productName,
+        version,
+        description,
+    };
+    cfg.consul.service = { ...cfg.consul.service, name, version, description };
+    cfg.consul.service.tags = keywords;
+    cfg.mcp.transportType = process.argv[2] === 'stdio' ? 'stdio' : config.mcp.transportType;
+    cfg.isMainDBUsed = !!config.db.postgres?.dbs.main?.host;
+    const urlRe = /\b(https?|ftp|file):\/\/[-A-Z0-9+&@#\/%?=~_|$!:,.;]*[A-Z0-9+&@#\/%=~_|$]/i;
+    if (urlRe.test(trim(repository?.url))) {
+        cfg.repo = urlRe.exec(repository.url)?.[0] || '';
+    }
+    else if (urlRe.test(trim(homepage))) {
+        cfg.repo = urlRe.exec(homepage)?.[0] || '';
+    }
+    return cfg;
+}
+export const appConfig = buildConfig();
+/**
+ * Returns configuration with sensitive data masked for safe display
+ */
+export function getSafeAppConfig() {
+    const config = JSON.parse(JSON.stringify(appConfig)); // Deep clone
+    // Mask database password
+    if (config.db?.postgres?.dbs?.main?.password) {
+        config.db.postgres.dbs.main.password = '[MASKED]';
+    }
+    return config;
+}
+export function getProjectData() {
+    return global.__MCP_PROJECT_DATA__;
+}
+//# sourceMappingURL=init-config.js.map

package/dist/core/bootstrap/init-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-config.js","sourceRoot":"","sources":["../../../src/core/bootstrap/init-config.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAE1C,OAAO,aAAa,CAAC,CAAE,mCAAmC;AAC1D,OAAO,YAAY,MAAM,QAAQ,CAAC;AAGlC,MAAM,CAAC,MAAM,MAAM,GAAc,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGzC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAEhK;;;GAGG;AACH,SAAS,WAAW;IAClB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAc;QACrB,GAAG,MAAM;QACT,qCAAqC;QACrC,IAAI;QACJ,SAAS;QACT,WAAW;QACX,OAAO;QACP,WAAW;KACZ,CAAC;IAEF,GAAG,CAAC,MAAM,CAAC,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAC3E,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC;IACnC,GAAG,CAAC,GAAG,CAAC,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;IACzF,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC;IACxD,MAAM,KAAK,GAAG,2EAA2E,CAAC;IAC1F,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QACtC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACtC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAc,WAAW,EAAE,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa;IAEnE,yBAAyB;IACzB,IAAI,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC7C,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC;IACpD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAQ,MAAc,CAAC,oBAAoB,CAAC;AAC9C,CAAC"}

package/dist/core/bootstrap/startup-info.d.ts

@@ -0,0 +1,6 @@
+import { AppConfig } from '../_types_/config.js';
+export declare const startupInfo: (args: {
+    dotEnvResult: any;
+    cfg: AppConfig;
+}) => Promise<void>;
+//# sourceMappingURL=startup-info.d.ts.map

package/dist/core/bootstrap/startup-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-info.d.ts","sourceRoot":"","sources":["../../../src/core/bootstrap/startup-info.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAWjD,eAAO,MAAM,WAAW,GAAU,MAAM;IAAE,YAAY,EAAE,GAAG,CAAC;IAAC,GAAG,EAAE,SAAS,CAAA;CAAE,kBAuC5E,CAAC"}

package/dist/core/bootstrap/startup-info.js

@@ -0,0 +1,43 @@
+/*
+Output of startup diagnostics to the console
+*/
+import { configInfo, consulInfo, databasesInfo, infoBlock, nodeConfigEnvInfo } from 'af-tools-ts';
+import { yellow } from 'af-color';
+import { fileLogger, useFileLogger, logger as lgr } from '../logger.js';
+import { getConsulAPI } from '../consul/get-consul-api.js';
+import chalk from 'chalk';
+import { appConfig } from './init-config.js';
+const logger = lgr.getSubLogger({ name: chalk.cyan('config') });
+export const startupInfo = async (args) => {
+    const { cfg, dotEnvResult } = args;
+    let consulInfoItem = '';
+    const s = cfg.consul.service;
+    if (!s.noRegOnStart) {
+        const consulApi = await getConsulAPI();
+        const r = consulApi.registerConfig;
+        s.meta = r.meta;
+        s.tags = r.tags;
+        s.id = r.id;
+        s.host = r.address || null;
+        s.port = r.port || null;
+        consulInfoItem = ['Consul serviceId', consulApi.serviceId];
+    }
+    configInfo({ dotEnvResult, cfg: JSON.parse(JSON.stringify(cfg)) }); // To display you must set ENV DEBUG=config-info
+    const dbInfo = appConfig.isMainDBUsed ? [...databasesInfo(cfg, ['main'])] : [['DB', 'not used']];
+    const info = [
+        `${yellow}${cfg.productName || cfg.name} (v ${cfg.version})`,
+        nodeConfigEnvInfo(),
+        ['NODE VERSION', process.version],
+        ['NODE_ENV', process.env.NODE_ENV],
+        ['Logging level', cfg.logger.level],
+        ['DEBUG', (process.env.DEBUG || '')],
+        useFileLogger ? ['Logs dir', fileLogger?.logDir] : '',
+        ...dbInfo,
+        consulInfoItem,
+    ].filter(Boolean);
+    const infoStr = infoBlock({ info });
+    logger.info(`\n${infoStr}`);
+    // Info about Access points
+    consulInfo(cfg);
+};
+//# sourceMappingURL=startup-info.js.map

package/dist/core/bootstrap/startup-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-info.js","sourceRoot":"","sources":["../../../src/core/bootstrap/startup-info.ts"],"names":[],"mappings":"AAAA;;EAEE;AACF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClG,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,IAAI,GAAG,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAGhE,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,IAA2C,EAAE,EAAE;IAC/E,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAEnC,IAAI,cAAc,GAA8B,EAAE,CAAC;IACnD,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,IAAI,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;QACpB,MAAM,SAAS,GAAG,MAAM,YAAY,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,SAAS,CAAC,cAAc,CAAC;QAEnC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAa,CAAC;QACzB,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAgB,CAAC;QAC5B,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QACZ,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC;QAC3B,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC;QACxB,cAAc,GAAG,CAAC,kBAAkB,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED,UAAU,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gDAAgD;IAEpH,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IAEjG,MAAM,IAAI,GAAG;QACX,GAAG,MAAM,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,OAAO,GAAG;QAC5D,iBAAiB,EAAE;QACnB,CAAC,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC;QACjC,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClC,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;QACnC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACpC,aAAa,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;QACrD,GAAG,MAAM;QACT,cAAc;KACf,CAAC,MAAM,CAAC,OAAO,CAAgB,CAAC;IAEjC,MAAM,OAAO,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpC,MAAM,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAE5B,2BAA2B;IAC3B,UAAU,CAAC,GAAG,CAAC,CAAC;AAClB,CAAC,CAAC"}

package/dist/core/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const ROOT_PROJECT_DIR: string;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,QAAgB,CAAC"}

package/dist/core/constants.js

@@ -0,0 +1,2 @@
+export const ROOT_PROJECT_DIR = process.cwd();
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC"}

package/dist/core/consul/access-points-updater.d.ts

@@ -0,0 +1,5 @@
+export declare const accessPointUpdater: {
+    start: () => number;
+    stop: () => void;
+};
+//# sourceMappingURL=access-points-updater.d.ts.map

package/dist/core/consul/access-points-updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-points-updater.d.ts","sourceRoot":"","sources":["../../../src/core/consul/access-points-updater.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,kBAAkB;;;CAG9B,CAAC"}

package/dist/core/consul/access-points-updater.js

@@ -0,0 +1,11 @@
+import { accessPointsUpdater } from 'af-consul-ts';
+import { logger as lgr } from '../logger.js';
+import { eventEmitter } from '../ee.js';
+import { appConfig } from '../bootstrap/init-config.js';
+import chalk from 'chalk';
+const logger = lgr.getSubLogger({ name: chalk.bgBlue('consul') });
+export const accessPointUpdater = {
+    start: () => accessPointsUpdater.start({ config: appConfig, logger, em: eventEmitter }, 10_000),
+    stop: () => accessPointsUpdater.stop(),
+};
+//# sourceMappingURL=access-points-updater.js.map

package/dist/core/consul/access-points-updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-points-updater.js","sourceRoot":"","sources":["../../../src/core/consul/access-points-updater.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,MAAM,IAAI,GAAG,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC;IAC/F,IAAI,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE;CACvC,CAAC"}

package/dist/core/consul/deregister.d.ts

@@ -0,0 +1,2 @@
+export declare const deregisterServiceFromConsul: () => Promise<void>;
+//# sourceMappingURL=deregister.d.ts.map

package/dist/core/consul/deregister.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deregister.d.ts","sourceRoot":"","sources":["../../../src/core/consul/deregister.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,2BAA2B,qBAcvC,CAAC"}

package/dist/core/consul/deregister.js

@@ -0,0 +1,21 @@
+import * as dotenv from 'dotenv';
+import { getConsulAPI } from './get-consul-api.js';
+import { isMainModule } from '../utils/utils.js';
+dotenv.config();
+export const deregisterServiceFromConsul = async () => {
+    const [, , svcId, agentHost, agentPort] = process.argv;
+    if (!svcId) {
+        throw new Error('Service ID (svcId) is required');
+    }
+    const { deregister } = await getConsulAPI();
+    try {
+        await deregister(svcId, agentHost, agentPort);
+    }
+    catch (err) {
+        console.error(err);
+    }
+};
+if (isMainModule(import.meta.url)) {
+    deregisterServiceFromConsul().then(() => 0);
+}
+//# sourceMappingURL=deregister.js.map

package/dist/core/consul/deregister.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deregister.js","sourceRoot":"","sources":["../../../src/core/consul/deregister.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,IAAI,EAAE;IACpD,MAAM,CAAC,EAAE,AAAD,EAAG,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAEvD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,YAAY,EAAE,CAAC;IAE5C,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC,CAAC;AAEF,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAClC,2BAA2B,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/core/consul/get-consul-api.d.ts

@@ -0,0 +1,2 @@
+export declare const getConsulAPI: () => Promise<import("af-consul-ts").IAFConsulAPI>;
+//# sourceMappingURL=get-consul-api.d.ts.map

package/dist/core/consul/get-consul-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-consul-api.d.ts","sourceRoot":"","sources":["../../../src/core/consul/get-consul-api.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,YAAY,oDAUxB,CAAC"}

package/dist/core/consul/get-consul-api.js

@@ -0,0 +1,18 @@
+import { getAPI } from 'af-consul-ts';
+import { logger as lgr } from '../logger.js';
+import { eventEmitter } from '../ee.js';
+import { appConfig, getProjectData } from '../bootstrap/init-config.js';
+import chalk from 'chalk';
+const isProd = (process.env.NODE_CONSUL_ENV || process.env.NODE_ENV) === 'production';
+const logger = lgr.getSubLogger({ name: chalk.bgBlue('consul') });
+export const getConsulAPI = async () => {
+    return getAPI({
+        config: appConfig,
+        logger,
+        em: eventEmitter,
+        envCode: isProd ? appConfig.consul.envCode.prod : appConfig.consul.envCode.dev,
+        getConsulUIAddress: getProjectData().getConsulUIAddress ||
+            ((serviceId) => `Consul service id: ${serviceId}. Can not construct UI url because custom getConsulUIAddress function was not provided`),
+    });
+};
+//# sourceMappingURL=get-consul-api.js.map

package/dist/core/consul/get-consul-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-consul-api.js","sourceRoot":"","sources":["../../../src/core/consul/get-consul-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,IAAI,GAAG,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,YAAY,CAAC;AACtF,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,IAAI,EAAE;IACrC,OAAO,MAAM,CAAC;QACZ,MAAM,EAAE,SAAS;QACjB,MAAM;QACN,EAAE,EAAE,YAAY;QAChB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG;QAC9E,kBAAkB,EAChB,cAAc,EAAE,CAAC,kBAAkB;YACnC,CAAC,CAAC,SAAiB,EAAE,EAAE,CAAC,sBAAsB,SAAS,wFAAwF,CAAC;KACnJ,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/core/consul/register.d.ts

@@ -0,0 +1,2 @@
+export declare const registerCyclic: () => Promise<import("af-consul-ts").IRegisterCyclic>;
+//# sourceMappingURL=register.d.ts.map

package/dist/core/consul/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/core/consul/register.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,uDAG1B,CAAC"}