@webpieces/http-client 0.2.51 → 0.2.55

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/http-client",
-  "version": "0.2.51",
+  "version": "0.2.55",
   "description": "HTTP client for WebPieces framework",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -21,6 +21,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@webpieces/http-api": "0.2.51"
+    "@webpieces/http-api": "0.2.55"
   }
 }

package/src/ClientFactory.d.ts

@@ -53,6 +53,10 @@ export declare class ProxyClient {
     private contextMgr?;
     private routeMap;
     constructor(config: ClientConfig, logApiCall: LogApiCall, headerMethods: HeaderMethods, routes: RouteMetadata[], contextMgr?: ContextMgr | undefined);
+    /**
+     * Check if a route exists for the given method name.
+     */
+    hasRoute(methodName: string): boolean;
     /**
      * Get route metadata for a method name.
      * @throws Error if no route found

package/src/ClientFactory.js

@@ -58,9 +58,14 @@ function createClient(apiPrototype, config, contextMgr) {
         get(target, prop) {
             // Only handle string properties (method names)
             if (typeof prop !== 'string') {
-                return undefined;
+                throw new Error(`Method names must be strings, not ${typeof prop}`);
+            }
+            // Check if this property is actually a route method BEFORE calling getRoute()
+            if (!proxyClient.hasRoute(prop)) {
+                // For unknown properties (likely typos), throw a helpful error
+                throw new Error(`No route found for method '${prop}'. ` +
+                    `Check for typos or ensure the method has @Post() decorator.`);
             }
-            // Get the route metadata for this method
             const route = proxyClient.getRoute(prop);
             // Return a function that makes the HTTP request
             return async (...args) => {
@@ -92,6 +97,12 @@ class ProxyClient {
             this.routeMap.set(route.methodName, route);
         }
     }
+    /**
+     * Check if a route exists for the given method name.
+     */
+    hasRoute(methodName) {
+        return this.routeMap.has(methodName);
+    }
     /**
      * Get route metadata for a method name.
      * @throws Error if no route found

package/src/ClientFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"ClientFactory.js","sourceRoot":"","sources":["../../../../../packages/http/http-client/src/ClientFactory.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    getRoutes,\n    isApiInterface,\n    RouteMetadata,\n    ProtocolError,\n    HeaderMethods,\n    LogApiCall,\n} from '@webpieces/http-api';\nimport { ClientErrorTranslator } from './ClientErrorTranslator';\nimport { ContextMgr } from './ContextMgr';\n\n/**\n * Configuration options for HTTP client.\n */\nexport class ClientConfig {\n    /** Base URL for all requests (e.g., 'http://localhost:3000') */\n    baseUrl: string;\n\n    /**\n     * Optional context manager for automatic header propagation.\n     * When provided, headers will be read from the ContextReader and added to requests.\n     */\n    contextMgr?: ContextMgr;\n\n    constructor(baseUrl: string, contextMgr?: ContextMgr) {\n        this.baseUrl = baseUrl;\n        this.contextMgr = contextMgr;\n    }\n}\n\n/**\n * Creates a type-safe HTTP client from an API interface prototype.\n *\n * This is the client-side equivalent of RESTApiRoutes.\n * - Server: RESTApiRoutes reads decorators → routes HTTP requests to controllers\n * - Client: createClient reads decorators → generates HTTP requests from method calls\n *\n * Usage:\n * ```typescript\n * const config = new ClientConfig('http://localhost:3000');\n * const client = createClient(SaveApiPrototype, config);\n * const response = await client.save({ query: 'test' }); // Type-safe!\n * ```\n *\n * @param apiPrototype - The API prototype class with decorators (e.g., SaveApiPrototype)\n * @param config - Client configuration with baseUrl\n * @param logApiCall - Optional LogApiCall instance (creates new one if not provided)\n * @returns A proxy object that implements the API interface\n */\nexport function createClient<T extends object>(\n    apiPrototype: Function & { prototype: T },\n    config: ClientConfig,\n    contextMgr?: ContextMgr\n): T {\n    // Validate that the API prototype is marked with @ApiInterface\n    if (!isApiInterface(apiPrototype)) {\n        const className = apiPrototype.name || 'Unknown';\n        throw new Error(`Class ${className} must be decorated with @ApiInterface()`);\n    }\n\n    // Get all routes from the API prototype\n    const routes = getRoutes(apiPrototype);\n\n    // Validate that all methods use @Post() - we only support POST for now\n    for (const route of routes) {\n        if (route.httpMethod !== 'POST') {\n            throw new Error(\n                `Method '${route.methodName}' uses @${route.httpMethod.charAt(0) + route.httpMethod.slice(1).toLowerCase()}() but we only support @Post() on methods right now. ` +\n                `This is how gRPC, thrift, etc. all work - @Get is not needed but we may add later. ` +\n                `Currently, no app has 'truly' needed it and only wanted to conform to ideals when in practice, ` +\n                `there are no issues with @Post() and in fact @Post is more flexible as it can evolve to returning stuff later which happens frequently.`\n            );\n        }\n    }\n\n    // Create ProxyClient with injected LogApiCall (or create new one)\n    //CRAP our own little DI going on here as angular and nodejs are using 2 different DI systems!!! fuck!!\n    const proxyClient = new ProxyClient(\n        config, new LogApiCall(), new HeaderMethods(), routes, contextMgr);\n\n    // Create a proxy that intercepts method calls and makes HTTP requests\n    return new Proxy({} as T, {\n        get(target, prop: string | symbol) {\n            // Only handle string properties (method names)\n            if (typeof prop !== 'string') {\n                return undefined;\n            }\n\n            // Get the route metadata for this method\n            const route = proxyClient.getRoute(prop);\n\n            // Return a function that makes the HTTP request\n            return async (...args: any[]) => {\n                return proxyClient.makeRequest(route, args);\n            };\n        },\n    });\n}\n\n/**\n * ProxyClient - HTTP client implementation with logging.\n *\n * This class handles:\n * - Making HTTP requests based on route metadata\n * - Header propagation via ContextMgr\n * - Logging via LogApiCall\n * - Error translation via ClientErrorTranslator\n *\n * LogApiCall is injected for consistent logging across the framework.\n */\nexport class ProxyClient {\n    private routeMap: Map<string, RouteMetadata>;\n\n    constructor(\n        private config: ClientConfig,\n        private logApiCall: LogApiCall,\n        private headerMethods: HeaderMethods,\n        routes: RouteMetadata[],\n        private contextMgr?: ContextMgr,\n    ) {\n        // Create a map of method name -> route metadata for fast lookup\n        this.routeMap = new Map<string, RouteMetadata>();\n        for (const route of routes) {\n            this.routeMap.set(route.methodName, route);\n        }\n    }\n\n    /**\n     * Get route metadata for a method name.\n     * @throws Error if no route found\n     */\n    getRoute(methodName: string): RouteMetadata {\n        const route = this.routeMap.get(methodName);\n        if (!route) {\n            throw new Error(`No route found for method ${methodName}`);\n        }\n        return route;\n    }\n\n    /**\n     * Make an HTTP request based on route metadata and arguments.\n     *\n     * Uses plain JSON.stringify/parse - no serialization library needed!\n     *\n     * Error handling:\n     * - Server: Throws HttpError → translates to ProtocolError JSON\n     * - Client: Receives ProtocolError JSON → reconstructs HttpError\n     *\n     * Automatic header propagation via ContextMgr:\n     * - If config.contextMgr is provided, reads headers from ContextReader\n     * - Adds headers to request before fetch()\n     *\n     * Logging via LogApiCall.execute():\n     * - [API-CLIENT-req] logs outgoing requests with headers (secure ones masked)\n     * - [API-CLIENT-resp-SUCCESS] logs successful responses\n     * - [API-CLIENT-resp-FAIL] logs failed responses\n     */\n    async makeRequest(route: RouteMetadata, args: any[]): Promise<any> {\n        const { httpMethod, path } = route;\n\n        // Build the full URL\n        const url = `${this.config.baseUrl}${path}`;\n\n\n        // Build base headers for the HTTP request\n        const httpHeaders: Record<string, string> = {\n            'Content-Type': 'application/json',\n        };\n\n        // Add context headers to httpHeaders (unmasked, for actual HTTP request)\n        if (this.contextMgr) {\n            for (const header of this.contextMgr.headerSet) {\n                const value = this.contextMgr.contextReader.read(header);\n                if (value) {\n                    httpHeaders[header.headerName] = value;\n                }\n            }\n        }\n\n        // Build masked headers map for logging\n        const headersForLogging = this.contextMgr\n            ? this.headerMethods.buildSecureMapForLogs(this.contextMgr.headerSet, this.contextMgr.contextReader)\n            : new Map<string, any>();\n\n        // Build request options\n        const options: RequestInit = {\n            method: httpMethod,\n            headers: httpHeaders,\n        };\n\n        // For POST/PUT/PATCH, include the body (first argument) as JSON\n        let requestDto: unknown;\n        if (['POST', 'PUT', 'PATCH'].includes(httpMethod) && args.length > 0) {\n            requestDto = args[0];\n            // Plain JSON stringify - works with plain objects and our DateTimeDto classes\n            options.body = JSON.stringify(requestDto);\n        }\n\n        // Wrap fetch in a method for LogApiCall.execute\n        const method = async (): Promise<unknown> => {\n            return this.executeFetch(url, options);\n        };\n\n        return await this.logApiCall.execute(\"CLIENT\", route, requestDto, headersForLogging, method);\n    }\n\n    /**\n     * Execute the fetch request and handle response.\n     */\n    private async executeFetch(url: string, options: RequestInit): Promise<unknown> {\n        const response = await fetch(url, options);\n\n        if (response.ok) {\n            return await response.json();\n        }\n\n        // Handle errors (non-2xx responses)\n        // Try to parse ProtocolError from response body\n        const protocolError = (await response.json()) as ProtocolError;\n\n        // Reconstruct appropriate HttpError subclass and throw\n        throw ClientErrorTranslator.translateError(response, protocolError);\n    }\n}\n"]}
+{"version":3,"file":"ClientFactory.js","sourceRoot":"","sources":["../../../../../packages/http/http-client/src/ClientFactory.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    getRoutes,\n    isApiInterface,\n    RouteMetadata,\n    ProtocolError,\n    HeaderMethods,\n    LogApiCall,\n} from '@webpieces/http-api';\nimport { ClientErrorTranslator } from './ClientErrorTranslator';\nimport { ContextMgr } from './ContextMgr';\n\n/**\n * Configuration options for HTTP client.\n */\nexport class ClientConfig {\n    /** Base URL for all requests (e.g., 'http://localhost:3000') */\n    baseUrl: string;\n\n    /**\n     * Optional context manager for automatic header propagation.\n     * When provided, headers will be read from the ContextReader and added to requests.\n     */\n    contextMgr?: ContextMgr;\n\n    constructor(baseUrl: string, contextMgr?: ContextMgr) {\n        this.baseUrl = baseUrl;\n        this.contextMgr = contextMgr;\n    }\n}\n\n/**\n * Creates a type-safe HTTP client from an API interface prototype.\n *\n * This is the client-side equivalent of RESTApiRoutes.\n * - Server: RESTApiRoutes reads decorators → routes HTTP requests to controllers\n * - Client: createClient reads decorators → generates HTTP requests from method calls\n *\n * Usage:\n * ```typescript\n * const config = new ClientConfig('http://localhost:3000');\n * const client = createClient(SaveApiPrototype, config);\n * const response = await client.save({ query: 'test' }); // Type-safe!\n * ```\n *\n * @param apiPrototype - The API prototype class with decorators (e.g., SaveApiPrototype)\n * @param config - Client configuration with baseUrl\n * @param logApiCall - Optional LogApiCall instance (creates new one if not provided)\n * @returns A proxy object that implements the API interface\n */\nexport function createClient<T extends object>(\n    apiPrototype: Function & { prototype: T },\n    config: ClientConfig,\n    contextMgr?: ContextMgr\n): T {\n    // Validate that the API prototype is marked with @ApiInterface\n    if (!isApiInterface(apiPrototype)) {\n        const className = apiPrototype.name || 'Unknown';\n        throw new Error(`Class ${className} must be decorated with @ApiInterface()`);\n    }\n\n    // Get all routes from the API prototype\n    const routes = getRoutes(apiPrototype);\n\n    // Validate that all methods use @Post() - we only support POST for now\n    for (const route of routes) {\n        if (route.httpMethod !== 'POST') {\n            throw new Error(\n                `Method '${route.methodName}' uses @${route.httpMethod.charAt(0) + route.httpMethod.slice(1).toLowerCase()}() but we only support @Post() on methods right now. ` +\n                `This is how gRPC, thrift, etc. all work - @Get is not needed but we may add later. ` +\n                `Currently, no app has 'truly' needed it and only wanted to conform to ideals when in practice, ` +\n                `there are no issues with @Post() and in fact @Post is more flexible as it can evolve to returning stuff later which happens frequently.`\n            );\n        }\n    }\n\n    // Create ProxyClient with injected LogApiCall (or create new one)\n    //CRAP our own little DI going on here as angular and nodejs are using 2 different DI systems!!! fuck!!\n    const proxyClient = new ProxyClient(\n        config, new LogApiCall(), new HeaderMethods(), routes, contextMgr);\n\n    // Create a proxy that intercepts method calls and makes HTTP requests\n    return new Proxy({} as T, {\n        get(target, prop: string | symbol) {\n            // Only handle string properties (method names)\n            if (typeof prop !== 'string') {\n                throw new Error(`Method names must be strings, not ${typeof prop}`);\n            }\n\n            // Check if this property is actually a route method BEFORE calling getRoute()\n            if (!proxyClient.hasRoute(prop)) {\n                // For unknown properties (likely typos), throw a helpful error\n                throw new Error(\n                    `No route found for method '${prop}'. ` +\n                    `Check for typos or ensure the method has @Post() decorator.`\n                );\n            }\n\n            const route = proxyClient.getRoute(prop);\n\n            // Return a function that makes the HTTP request\n            return async (...args: any[]) => {\n                return proxyClient.makeRequest(route, args);\n            };\n        },\n    });\n}\n\n/**\n * ProxyClient - HTTP client implementation with logging.\n *\n * This class handles:\n * - Making HTTP requests based on route metadata\n * - Header propagation via ContextMgr\n * - Logging via LogApiCall\n * - Error translation via ClientErrorTranslator\n *\n * LogApiCall is injected for consistent logging across the framework.\n */\nexport class ProxyClient {\n    private routeMap: Map<string, RouteMetadata>;\n\n    constructor(\n        private config: ClientConfig,\n        private logApiCall: LogApiCall,\n        private headerMethods: HeaderMethods,\n        routes: RouteMetadata[],\n        private contextMgr?: ContextMgr,\n    ) {\n        // Create a map of method name -> route metadata for fast lookup\n        this.routeMap = new Map<string, RouteMetadata>();\n        for (const route of routes) {\n            this.routeMap.set(route.methodName, route);\n        }\n    }\n\n    /**\n     * Check if a route exists for the given method name.\n     */\n    hasRoute(methodName: string): boolean {\n        return this.routeMap.has(methodName);\n    }\n\n    /**\n     * Get route metadata for a method name.\n     * @throws Error if no route found\n     */\n    getRoute(methodName: string): RouteMetadata {\n        const route = this.routeMap.get(methodName);\n        if (!route) {\n            throw new Error(`No route found for method ${methodName}`);\n        }\n        return route;\n    }\n\n    /**\n     * Make an HTTP request based on route metadata and arguments.\n     *\n     * Uses plain JSON.stringify/parse - no serialization library needed!\n     *\n     * Error handling:\n     * - Server: Throws HttpError → translates to ProtocolError JSON\n     * - Client: Receives ProtocolError JSON → reconstructs HttpError\n     *\n     * Automatic header propagation via ContextMgr:\n     * - If config.contextMgr is provided, reads headers from ContextReader\n     * - Adds headers to request before fetch()\n     *\n     * Logging via LogApiCall.execute():\n     * - [API-CLIENT-req] logs outgoing requests with headers (secure ones masked)\n     * - [API-CLIENT-resp-SUCCESS] logs successful responses\n     * - [API-CLIENT-resp-FAIL] logs failed responses\n     */\n    async makeRequest(route: RouteMetadata, args: any[]): Promise<any> {\n        const { httpMethod, path } = route;\n\n        // Build the full URL\n        const url = `${this.config.baseUrl}${path}`;\n\n\n        // Build base headers for the HTTP request\n        const httpHeaders: Record<string, string> = {\n            'Content-Type': 'application/json',\n        };\n\n        // Add context headers to httpHeaders (unmasked, for actual HTTP request)\n        if (this.contextMgr) {\n            for (const header of this.contextMgr.headerSet) {\n                const value = this.contextMgr.contextReader.read(header);\n                if (value) {\n                    httpHeaders[header.headerName] = value;\n                }\n            }\n        }\n\n        // Build masked headers map for logging\n        const headersForLogging = this.contextMgr\n            ? this.headerMethods.buildSecureMapForLogs(this.contextMgr.headerSet, this.contextMgr.contextReader)\n            : new Map<string, any>();\n\n        // Build request options\n        const options: RequestInit = {\n            method: httpMethod,\n            headers: httpHeaders,\n        };\n\n        // For POST/PUT/PATCH, include the body (first argument) as JSON\n        let requestDto: unknown;\n        if (['POST', 'PUT', 'PATCH'].includes(httpMethod) && args.length > 0) {\n            requestDto = args[0];\n            // Plain JSON stringify - works with plain objects and our DateTimeDto classes\n            options.body = JSON.stringify(requestDto);\n        }\n\n        // Wrap fetch in a method for LogApiCall.execute\n        const method = async (): Promise<unknown> => {\n            return this.executeFetch(url, options);\n        };\n\n        return await this.logApiCall.execute(\"CLIENT\", route, requestDto, headersForLogging, method);\n    }\n\n    /**\n     * Execute the fetch request and handle response.\n     */\n    private async executeFetch(url: string, options: RequestInit): Promise<unknown> {\n        const response = await fetch(url, options);\n\n        if (response.ok) {\n            return await response.json();\n        }\n\n        // Handle errors (non-2xx responses)\n        // Try to parse ProtocolError from response body\n        const protocolError = (await response.json()) as ProtocolError;\n\n        // Reconstruct appropriate HttpError subclass and throw\n        throw ClientErrorTranslator.translateError(response, protocolError);\n    }\n}\n"]}