@qwickapps/server 1.6.0 → 1.7.0

package/dist/ui/src/api/clientBuilder.js

@@ -0,0 +1,157 @@
+/**
+ * Client Builder - Auto-generate typed API client from server manifest
+ *
+ * Fetches route manifest from server and builds dynamic API client with proper
+ * HTTP method handling, query parameters, and error handling.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+/**
+ * Build typed API client from server manifest
+ *
+ * Fetches the manifest from /api/client-manifest and generates a nested
+ * client object with methods for each route.
+ *
+ * @param baseUrl - Base URL of the server (e.g., 'http://localhost:3000')
+ * @returns Promise resolving to the generated client
+ *
+ * @example
+ * ```typescript
+ * const client = await buildClientFromManifest<APIClient>('http://localhost:3000');
+ * const logs = await client.logs.query({ limit: 10 });
+ * ```
+ */
+export async function buildClientFromManifest(baseUrl) {
+    // Fetch manifest from server
+    const manifestUrl = `${baseUrl}/api/client-manifest`;
+    const response = await fetch(manifestUrl);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch client manifest: ${response.status} ${response.statusText}`);
+    }
+    const manifest = await response.json();
+    // Build nested client object
+    const client = {};
+    for (const [key, route] of Object.entries(manifest.routes)) {
+        const [namespace, method] = key.split('.');
+        if (!namespace || !method) {
+            console.warn(`Invalid route key: ${key}, skipping`);
+            continue;
+        }
+        // Convert hyphenated namespace to camelCase for JavaScript object access
+        // e.g., "rate-limit" -> "rateLimit", "api-keys" -> "apiKeys"
+        const camelNamespace = namespace.replace(/-./g, x => x[1].toUpperCase());
+        // Create namespace if it doesn't exist
+        if (!client[camelNamespace]) {
+            client[camelNamespace] = {};
+        }
+        // Create method function
+        client[camelNamespace][method] = createMethodFunction(baseUrl, route.method, route.path);
+    }
+    return client;
+}
+/**
+ * Create a method function for a specific route
+ *
+ * @param baseUrl - Base URL of the server
+ * @param method - HTTP method
+ * @param path - Route path (may contain :params)
+ * @returns Function that makes the API request
+ */
+function createMethodFunction(baseUrl, method, path) {
+    return async (params) => {
+        // Build URL with path parameters and query string
+        const url = buildUrl(baseUrl, path, params, method);
+        // Prepare request options
+        const options = {
+            method,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            credentials: 'same-origin', // Required for Basic Auth support
+        };
+        // Add body for non-GET requests
+        if (method !== 'GET' && params) {
+            // For POST/PUT/PATCH, send params as JSON body
+            // (unless params were used for path parameters)
+            const hasPathParams = path.includes(':');
+            if (!hasPathParams) {
+                options.body = JSON.stringify(params);
+            }
+            else {
+                // If we have path params, filter them out from body
+                const pathParamNames = extractPathParams(path);
+                const bodyParams = Object.keys(params)
+                    .filter((key) => !pathParamNames.includes(key))
+                    .reduce((obj, key) => {
+                    obj[key] = params[key];
+                    return obj;
+                }, {});
+                if (Object.keys(bodyParams).length > 0) {
+                    options.body = JSON.stringify(bodyParams);
+                }
+            }
+        }
+        // Make the request
+        const response = await fetch(url, options);
+        if (!response.ok) {
+            throw new Error(`API request failed: ${response.status} ${response.statusText}`);
+        }
+        // Return JSON response
+        return response.json();
+    };
+}
+/**
+ * Build URL with path parameters and query string
+ *
+ * @param baseUrl - Base URL
+ * @param path - Route path (may contain :params)
+ * @param params - Parameters object
+ * @param method - HTTP method
+ * @returns Complete URL
+ */
+function buildUrl(baseUrl, path, params, method) {
+    let url = path;
+    // Replace path parameters (e.g., /users/:id -> /users/123)
+    if (params && path.includes(':')) {
+        const pathParamNames = extractPathParams(path);
+        for (const paramName of pathParamNames) {
+            if (params[paramName] !== undefined) {
+                url = url.replace(`:${paramName}`, encodeURIComponent(params[paramName]));
+            }
+        }
+    }
+    // Add query string for GET requests
+    if (method === 'GET' && params) {
+        const pathParamNames = path.includes(':') ? extractPathParams(path) : [];
+        const queryParams = Object.keys(params)
+            .filter((key) => !pathParamNames.includes(key))
+            .reduce((obj, key) => {
+            obj[key] = params[key];
+            return obj;
+        }, {});
+        if (Object.keys(queryParams).length > 0) {
+            const searchParams = new URLSearchParams();
+            for (const [key, value] of Object.entries(queryParams)) {
+                if (value !== undefined && value !== null) {
+                    searchParams.append(key, String(value));
+                }
+            }
+            url += `?${searchParams.toString()}`;
+        }
+    }
+    return `${baseUrl}${url}`;
+}
+/**
+ * Extract path parameter names from a route path
+ *
+ * @param path - Route path (e.g., /users/:id/posts/:postId)
+ * @returns Array of parameter names (e.g., ['id', 'postId'])
+ */
+function extractPathParams(path) {
+    const matches = path.match(/:([a-zA-Z0-9_]+)/g);
+    if (!matches) {
+        return [];
+    }
+    return matches.map((match) => match.slice(1)); // Remove leading ':'
+}
+//# sourceMappingURL=clientBuilder.js.map

package/dist/ui/src/api/clientBuilder.js.map

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