@bedolla/enriweb 0.1.0

package/dist/index.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+/**
+ * ENRIWEB - MCP ENTRYPOINT
+ *
+ * Starts the EnriWeb MCP server on stdio.
+ *
+ * @module index
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { EnriProxyClient } from "./client/EnriProxyClient.js";
+import { WebSearchTool } from "./tools/WebSearchTool.js";
+import { WebFetchTool } from "./tools/WebFetchTool.js";
+import { WebSearchRegistryVerifier } from "./tools/WebSearchRegistryVerifier.js";
+import { EnriWebServer } from "./server/EnriWebServer.js";
+import { packageInfoService } from "./package-info.js";
+/**
+ * Environment variable for EnriProxy base URL.
+ */
+const ENRIPROXY_URL_ENV = "ENRIPROXY_URL";
+/**
+ * Environment variable for EnriProxy API key.
+ */
+const ENRIPROXY_API_KEY_ENV = "ENRIPROXY_API_KEY";
+/**
+ * Environment variable for default request timeout in milliseconds.
+ */
+const ENRIWEB_TIMEOUT_MS_ENV = "ENRIWEB_TIMEOUT_MS";
+/**
+ * Environment variable for the default `web_fetch` max_chars limit.
+ */
+const ENRIWEB_WEB_FETCH_DEFAULT_MAX_CHARS_ENV = "ENRIWEB_WEB_FETCH_DEFAULT_MAX_CHARS";
+/**
+ * Environment variable for an optional GitHub token used by `web_search`
+ * enrichment to improve GitHub API rate limits.
+ */
+const ENRIWEB_GITHUB_TOKEN_ENV = "ENRIWEB_GITHUB_TOKEN";
+/**
+ * Default EnriProxy URL used when env is not set.
+ */
+const DEFAULT_ENRIPROXY_URL = "http://127.0.0.1:8787";
+/**
+ * Default request timeout in milliseconds.
+ */
+const DEFAULT_TIMEOUT_MS = 60 * 1000;
+/**
+ * Default maximum `web_fetch` content length.
+ *
+ * @remarks
+ * This aligns with EnriProxy's tool-preview defaults to reduce the risk of MCP
+ * tool-result truncation in clients that enforce output token limits.
+ *
+ * Note: Some MCP clients enforce tool-result token limits (for example Claude
+ * Code CLI limits like MAX_MCP_OUTPUT_TOKENS=32000). Large outputs may be
+ * truncated by the client or written to a tool-results file for paging.
+ */
+const DEFAULT_WEB_FETCH_MAX_CHARS = 200_000;
+/**
+ * Default timeout (ms) for registry enrichment requests.
+ */
+const DEFAULT_REGISTRY_TIMEOUT_MS = 15_000;
+/**
+ * Default cache TTL (ms) for registry enrichment.
+ */
+const DEFAULT_REGISTRY_CACHE_TTL_MS = 5 * 60 * 1000;
+/**
+ * Default maximum entities verified per `web_search` call.
+ */
+const DEFAULT_REGISTRY_MAX_ENTITIES_PER_CALL = 6;
+/**
+ * Entry point for the MCP server.
+ */
+async function main() {
+    const args = process.argv.slice(2);
+    if (args[0] === "--help" || args[0] === "-h" || args[0] === "help") {
+        console.log("EnriWeb");
+        console.log("");
+        console.log("This is an MCP server over stdio that provides web search and URL fetching via EnriProxy.");
+        console.log("");
+        console.log("Usage:");
+        console.log("  enriweb              (start MCP server over stdio)");
+        console.log("  enriweb --version");
+        console.log("  enriweb --help");
+        console.log("");
+        console.log("Environment variables:");
+        console.log("  ENRIPROXY_URL (optional, default: http://127.0.0.1:8787)");
+        console.log("  ENRIPROXY_API_KEY (required)");
+        console.log("  ENRIWEB_TIMEOUT_MS (optional, default: 60000)");
+        console.log("  ENRIWEB_WEB_FETCH_DEFAULT_MAX_CHARS (optional, default: 200000)");
+        console.log("  ENRIWEB_GITHUB_TOKEN (optional, improves GitHub API rate limits)");
+        process.exit(0);
+    }
+    if (args[0] === "--version" || args[0] === "-v" || args[0] === "version") {
+        console.log(packageInfoService.getVersion());
+        process.exit(0);
+    }
+    const serverUrl = (process.env[ENRIPROXY_URL_ENV] ?? DEFAULT_ENRIPROXY_URL).trim();
+    const apiKey = (process.env[ENRIPROXY_API_KEY_ENV] ?? "").trim();
+    const timeoutMsRaw = (process.env[ENRIWEB_TIMEOUT_MS_ENV] ?? "").trim();
+    const defaultWebFetchMaxCharsRaw = (process.env[ENRIWEB_WEB_FETCH_DEFAULT_MAX_CHARS_ENV] ?? "").trim();
+    const timeoutMs = timeoutMsRaw ? Number.parseInt(timeoutMsRaw, 10) : DEFAULT_TIMEOUT_MS;
+    const defaultWebFetchMaxChars = defaultWebFetchMaxCharsRaw
+        ? Number.parseInt(defaultWebFetchMaxCharsRaw, 10)
+        : DEFAULT_WEB_FETCH_MAX_CHARS;
+    const githubToken = (process.env[ENRIWEB_GITHUB_TOKEN_ENV] ?? "").trim();
+    const createClient = (baseUrl, key, timeout) => new EnriProxyClient({
+        baseUrl,
+        apiKey: key,
+        timeoutMs: timeout
+    });
+    const resolvedTimeoutMs = Number.isFinite(timeoutMs) && timeoutMs > 0 ? timeoutMs : DEFAULT_TIMEOUT_MS;
+    const resolvedDefaultWebFetchMaxChars = Number.isFinite(defaultWebFetchMaxChars) && defaultWebFetchMaxChars > 0
+        ? defaultWebFetchMaxChars
+        : DEFAULT_WEB_FETCH_MAX_CHARS;
+    const webSearchTool = new WebSearchTool({
+        createClient,
+        defaultServerUrl: serverUrl,
+        defaultApiKey: apiKey,
+        defaultTimeoutMs: resolvedTimeoutMs,
+        registryVerifier: new WebSearchRegistryVerifier({
+            fetchImpl: fetch,
+            timeoutMs: DEFAULT_REGISTRY_TIMEOUT_MS,
+            cacheTtlMs: DEFAULT_REGISTRY_CACHE_TTL_MS,
+            maxEntitiesPerCall: DEFAULT_REGISTRY_MAX_ENTITIES_PER_CALL,
+            githubToken: githubToken.length > 0 ? githubToken : undefined
+        })
+    });
+    const webFetchTool = new WebFetchTool({
+        createClient,
+        defaultServerUrl: serverUrl,
+        defaultApiKey: apiKey,
+        defaultTimeoutMs: resolvedTimeoutMs,
+        defaultMaxChars: resolvedDefaultWebFetchMaxChars
+    });
+    const server = new EnriWebServer({
+        name: "EnriWeb",
+        version: packageInfoService.getVersion(),
+        webSearchTool,
+        webFetchTool
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[EnriWeb] MCP server running on stdio");
+}
+void main().catch((error) => {
+    console.error("[EnriWeb] FATAL:", error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/package-info.d.ts

@@ -0,0 +1,8 @@
+export declare class PackageInfoService {
+    private readonly require;
+    private cachedVersion;
+    constructor();
+    getVersion(): string;
+}
+export declare const packageInfoService: PackageInfoService;
+//# sourceMappingURL=package-info.d.ts.map

package/dist/package-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-info.d.ts","sourceRoot":"","sources":["../src/package-info.ts"],"names":[],"mappings":"AAIA,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,aAAa,CAAuB;;IAMrC,UAAU,IAAI,MAAM;CAkB5B;AAED,eAAO,MAAM,kBAAkB,EAAE,kBAA6C,CAAC"}

package/dist/package-info.js

@@ -0,0 +1,28 @@
+import { createRequire } from "node:module";
+export class PackageInfoService {
+    require;
+    cachedVersion = null;
+    constructor() {
+        this.require = createRequire(import.meta.url);
+    }
+    getVersion() {
+        if (this.cachedVersion !== null)
+            return this.cachedVersion;
+        const fallback = "0.0.0";
+        try {
+            const pkg = this.require("../package.json");
+            const version = pkg.version;
+            if (typeof version === "string" && version.trim().length > 0) {
+                this.cachedVersion = version;
+                return version;
+            }
+        }
+        catch {
+            // ignore
+        }
+        this.cachedVersion = fallback;
+        return fallback;
+    }
+}
+export const packageInfoService = new PackageInfoService();
+//# sourceMappingURL=package-info.js.map

package/dist/package-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-info.js","sourceRoot":"","sources":["../src/package-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAAc;IAC9B,aAAa,GAAkB,IAAI,CAAC;IAE5C;QACE,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC;IAEM,UAAU;QACf,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,aAAa,CAAC;QAE3D,MAAM,QAAQ,GAAG,OAAO,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAqB,CAAC;YAChE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;YAC5B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7D,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;gBAC7B,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAuB,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/server/EnriWebServer.d.ts

@@ -0,0 +1,70 @@
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { WebSearchTool } from "../tools/WebSearchTool.js";
+import type { WebFetchTool } from "../tools/WebFetchTool.js";
+/**
+ * Configuration for {@link EnriWebServer}.
+ */
+export interface EnriWebServerConfig {
+    /**
+     * Server name reported via MCP.
+     */
+    readonly name: string;
+    /**
+     * Server version reported via MCP.
+     */
+    readonly version: string;
+    /**
+     * Web search tool implementation.
+     */
+    readonly webSearchTool: WebSearchTool;
+    /**
+     * Web fetch tool implementation.
+     */
+    readonly webFetchTool: WebFetchTool;
+}
+/**
+ * MCP server exposing EnriWeb tools.
+ */
+export declare class EnriWebServer {
+    /**
+     * Underlying MCP server implementation.
+     */
+    private readonly server;
+    /**
+     * Web search tool implementation.
+     */
+    private readonly webSearchTool;
+    /**
+     * Web fetch tool implementation.
+     */
+    private readonly webFetchTool;
+    /**
+     * Creates a new {@link EnriWebServer}.
+     *
+     * @param config - Server configuration
+     */
+    constructor(config: EnriWebServerConfig);
+    /**
+     * Connects the server to a transport and starts listening.
+     *
+     * @param transport - MCP transport (stdio)
+     */
+    connect(transport: Transport): Promise<void>;
+    /**
+     * Registers tool list and tool call handlers.
+     */
+    private registerToolHandlers;
+    /**
+     * Returns the JSON schema tool definition for `web_search`.
+     *
+     * @returns Tool definition
+     */
+    private getWebSearchToolDefinition;
+    /**
+     * Returns the JSON schema tool definition for `web_fetch`.
+     *
+     * @returns Tool definition
+     */
+    private getWebFetchToolDefinition;
+}
+//# sourceMappingURL=EnriWebServer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EnriWebServer.d.ts","sourceRoot":"","sources":["../../src/server/EnriWebServer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAQ/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;CACrC;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAE9C;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAE5C;;;;OAIG;gBACgB,MAAM,EAAE,mBAAmB;IAkB9C;;;;OAIG;IACU,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiD5B;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAyDlC;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;CAwDlC"}

package/dist/server/EnriWebServer.js

@@ -0,0 +1,218 @@
+/**
+ * ENRIWEB MCP SERVER
+ *
+ * Implements a minimal MCP server (stdio transport) exposing:
+ * - `web_search`
+ * - `web_fetch`
+ *
+ * @module server/EnriWebServer
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * MCP server exposing EnriWeb tools.
+ */
+export class EnriWebServer {
+    /**
+     * Underlying MCP server implementation.
+     */
+    server;
+    /**
+     * Web search tool implementation.
+     */
+    webSearchTool;
+    /**
+     * Web fetch tool implementation.
+     */
+    webFetchTool;
+    /**
+     * Creates a new {@link EnriWebServer}.
+     *
+     * @param config - Server configuration
+     */
+    constructor(config) {
+        this.webSearchTool = config.webSearchTool;
+        this.webFetchTool = config.webFetchTool;
+        this.server = new Server({ name: config.name, version: config.version }, {
+            capabilities: {
+                tools: {
+                    listChanged: false
+                }
+            }
+        });
+        this.registerToolHandlers();
+    }
+    /**
+     * Connects the server to a transport and starts listening.
+     *
+     * @param transport - MCP transport (stdio)
+     */
+    async connect(transport) {
+        await this.server.connect(transport);
+    }
+    /**
+     * Registers tool list and tool call handlers.
+     */
+    registerToolHandlers() {
+        const tools = [
+            this.getWebSearchToolDefinition(),
+            this.getWebFetchToolDefinition()
+        ];
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return { tools };
+        });
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const toolName = request.params.name;
+            const args = request.params.arguments ?? {};
+            try {
+                if (toolName === "web_search") {
+                    const params = this.webSearchTool.parseParams(args);
+                    const result = await this.webSearchTool.execute(params);
+                    return {
+                        isError: false,
+                        content: [{ type: "text", text: this.webSearchTool.formatOutput(result) }],
+                        structuredContent: result
+                    };
+                }
+                if (toolName === "web_fetch") {
+                    const params = this.webFetchTool.parseParams(args);
+                    const result = await this.webFetchTool.execute(params);
+                    return {
+                        isError: false,
+                        content: [{ type: "text", text: this.webFetchTool.formatOutput(result) }],
+                        structuredContent: result
+                    };
+                }
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Unknown tool: ${toolName}` }]
+                };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: message }]
+                };
+            }
+        });
+    }
+    /**
+     * Returns the JSON schema tool definition for `web_search`.
+     *
+     * @returns Tool definition
+     */
+    getWebSearchToolDefinition() {
+        return {
+            name: "web_search",
+            description: "Search the web via EnriProxy's multi-tier search service.\n" +
+                "\n" +
+                "When to use:\n" +
+                "- When you need to find current information, news, or documentation.\n" +
+                "- When searching for technical solutions, APIs, or code examples.\n" +
+                "- When you need to verify facts or find up-to-date sources.\n" +
+                "\n" +
+                "Features:\n" +
+                "- Automatic fallback across multiple search backends (details intentionally not exposed)\n" +
+                "- Automatic registry verification: enriches results with latest stable + prerelease versions when registry URLs are detected (npm, PyPI, crates.io, NuGet, GitHub)\n" +
+                "- Domain filtering (allowlist/blocklist)\n" +
+                "- Recency filtering (day/week/month/year)\n" +
+                "\n" +
+                "Notes:\n" +
+                "- Provide specific queries for best results.\n" +
+                "- Use recency filter for time-sensitive information.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "Search query. Be specific for better results."
+                    },
+                    max_results: {
+                        type: "integer",
+                        description: "Maximum results (>= 1). If omitted, EnriProxy uses its configured default. The upper limit is enforced server-side."
+                    },
+                    recency: {
+                        type: "string",
+                        enum: ["oneDay", "oneWeek", "oneMonth", "oneYear", "noLimit"],
+                        description: "Filter by recency (default: noLimit)."
+                    },
+                    allowed_domains: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Only return results from these domains."
+                    },
+                    blocked_domains: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Exclude results from these domains."
+                    },
+                    search_prompt: {
+                        type: "string",
+                        description: "Optional context to refine search intent."
+                    }
+                },
+                required: ["query"]
+            }
+        };
+    }
+    /**
+     * Returns the JSON schema tool definition for `web_fetch`.
+     *
+     * @returns Tool definition
+     */
+    getWebFetchToolDefinition() {
+        const defaultMaxChars = this.webFetchTool.getDefaultMaxChars();
+        return {
+            name: "web_fetch",
+            description: "Fetch and read content from a URL via EnriProxy's multi-tier fetch service.\n" +
+                "\n" +
+                "When to use:\n" +
+                "- When you need to read the full content of a webpage.\n" +
+                "- When you need to access documentation, articles, or code files.\n" +
+                "- When simpler fetch methods fail due to anti-bot protection.\n" +
+                "\n" +
+                "Features:\n" +
+                "- Package registry API detection (npm, PyPI)\n" +
+                "- Raw file fetch (GitHub raw, HuggingFace)\n" +
+                "- Robust fetching for static, dynamic, and bot-protected sites (best-effort)\n" +
+                "- Automatic fallback across multiple retrieval strategies (details intentionally not exposed)\n" +
+                "\n" +
+                "Notes:\n" +
+                "- Provide the full URL including protocol (https://).\n" +
+                `- Content is limited by the \`max_chars\` parameter (default: ${defaultMaxChars}).\n` +
+                "- If the result is truncated and includes a `cursor`, call `web_fetch` again with `cursor` + `offset` + `limit` to read more without re-fetching.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    url: {
+                        type: "string",
+                        description: "Full URL to fetch (http:// or https://)."
+                    },
+                    cursor: {
+                        type: "string",
+                        description: "Opaque cursor returned by a previous `web_fetch` call for pagination."
+                    },
+                    prompt: {
+                        type: "string",
+                        description: "Optional hint describing what you want to extract (the tool returns fetched content; it does not generate an AI summary)."
+                    },
+                    max_chars: {
+                        type: "integer",
+                        description: `Maximum content length (default: ${defaultMaxChars}).`
+                    },
+                    offset: {
+                        type: "integer",
+                        description: "Cursor read offset in characters (default: 0)."
+                    },
+                    limit: {
+                        type: "integer",
+                        description: "Cursor read limit in characters (default: max_chars)."
+                    }
+                },
+                anyOf: [{ required: ["url"] }, { required: ["cursor"] }]
+            }
+        };
+    }
+}
+//# sourceMappingURL=EnriWebServer.js.map

package/dist/server/EnriWebServer.js.map

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

package/dist/shared/validation.d.ts

@@ -0,0 +1,54 @@
+/**
+ * INPUT VALIDATION UTILITIES
+ *
+ * @module shared/validation
+ */
+/**
+ * Asserts that value is a non-null object.
+ *
+ * @param value - Value to check
+ * @param name - Parameter name for error messages
+ * @returns Value as Record
+ * @throws Error if not an object
+ */
+export declare function assertObject(value: unknown, name: string): Record<string, unknown>;
+/**
+ * Asserts that value is a non-empty string.
+ *
+ * @param value - Value to check
+ * @param name - Parameter name for error messages
+ * @returns Trimmed string
+ * @throws Error if not a non-empty string
+ */
+export declare function assertNonEmptyString(value: unknown, name: string): string;
+/**
+ * Asserts that value is a valid HTTP/HTTPS URL.
+ *
+ * @param value - Value to check
+ * @param name - Parameter name for error messages
+ * @returns URL string
+ * @throws Error if not a valid HTTP/HTTPS URL
+ */
+export declare function assertHttpUrl(value: unknown, name: string): string;
+/**
+ * Returns trimmed string or undefined.
+ *
+ * @param value - Value to check
+ * @returns Trimmed string or undefined
+ */
+export declare function optionalString(value: unknown): string | undefined;
+/**
+ * Returns integer or undefined.
+ *
+ * @param value - Value to check
+ * @returns Integer or undefined
+ */
+export declare function optionalInt(value: unknown): number | undefined;
+/**
+ * Returns a list of trimmed strings or undefined.
+ *
+ * @param value - Value to check
+ * @returns String array or undefined
+ */
+export declare function optionalStringArray(value: unknown): string[] | undefined;
+//# sourceMappingURL=validation.d.ts.map

package/dist/shared/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/shared/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKlF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CASzE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAWlE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMjE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAW9D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAexE"}

package/dist/shared/validation.js

@@ -0,0 +1,112 @@
+/**
+ * INPUT VALIDATION UTILITIES
+ *
+ * @module shared/validation
+ */
+/**
+ * Asserts that value is a non-null object.
+ *
+ * @param value - Value to check
+ * @param name - Parameter name for error messages
+ * @returns Value as Record
+ * @throws Error if not an object
+ */
+export function assertObject(value, name) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${name} must be an object.`);
+    }
+    return value;
+}
+/**
+ * Asserts that value is a non-empty string.
+ *
+ * @param value - Value to check
+ * @param name - Parameter name for error messages
+ * @returns Trimmed string
+ * @throws Error if not a non-empty string
+ */
+export function assertNonEmptyString(value, name) {
+    if (typeof value !== "string") {
+        throw new Error(`${name} must be a string.`);
+    }
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new Error(`${name} must be a non-empty string.`);
+    }
+    return trimmed;
+}
+/**
+ * Asserts that value is a valid HTTP/HTTPS URL.
+ *
+ * @param value - Value to check
+ * @param name - Parameter name for error messages
+ * @returns URL string
+ * @throws Error if not a valid HTTP/HTTPS URL
+ */
+export function assertHttpUrl(value, name) {
+    const url = assertNonEmptyString(value, name);
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+            throw new Error(`${name} must be an HTTP or HTTPS URL.`);
+        }
+        return parsed.toString();
+    }
+    catch {
+        throw new Error(`${name} must be a valid URL.`);
+    }
+}
+/**
+ * Returns trimmed string or undefined.
+ *
+ * @param value - Value to check
+ * @returns Trimmed string or undefined
+ */
+export function optionalString(value) {
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        return trimmed ? trimmed : undefined;
+    }
+    return undefined;
+}
+/**
+ * Returns integer or undefined.
+ *
+ * @param value - Value to check
+ * @returns Integer or undefined
+ */
+export function optionalInt(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return Math.floor(value);
+    }
+    if (typeof value === "string" && value.trim()) {
+        const parsed = Number.parseInt(value, 10);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+    }
+    return undefined;
+}
+/**
+ * Returns a list of trimmed strings or undefined.
+ *
+ * @param value - Value to check
+ * @returns String array or undefined
+ */
+export function optionalStringArray(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const collected = [];
+    for (const entry of value) {
+        if (typeof entry !== "string") {
+            continue;
+        }
+        const trimmed = entry.trim();
+        if (trimmed) {
+            collected.push(trimmed);
+        }
+    }
+    return collected.length > 0 ? collected : undefined;
+}
+//# sourceMappingURL=validation.js.map