@simpleapps-com/augur-api 0.1.0

package/dist/cjs/core/base-client.js

@@ -0,0 +1,411 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseServiceClient = void 0;
+const errors_1 = require("./errors");
+const schemas_1 = require("./schemas");
+const zod_1 = require("zod");
+/**
+ * Abstract base class for all service clients
+ *
+ * Provides standardized error handling, validation, and request processing
+ * to eliminate boilerplate code across service implementations.
+ *
+ * @example
+ * ```typescript
+ * class MyServiceClient extends BaseServiceClient {
+ *   constructor(http: HTTPClient, baseUrl?: string) {
+ *     super('myservice', http, baseUrl || 'https://myservice.augur-api.com');
+ *   }
+ *
+ *   // Simple method using executeRequest
+ *   async getUser(id: number) {
+ *     return this.executeRequest({
+ *       method: 'GET',
+ *       path: `/users/${id}`,
+ *       responseSchema: UserResponseSchema
+ *     });
+ *   }
+ *
+ *   // Method with parameters
+ *   async listUsers(params?: UserListParams) {
+ *     return this.executeRequest({
+ *       method: 'GET',
+ *       path: '/users',
+ *       paramsSchema: UserListParamsSchema,
+ *       responseSchema: UserListResponseSchema
+ *     }, params);
+ *   }
+ * }
+ * ```
+ */
+class BaseServiceClient {
+    /**
+     * Create a new service client instance
+     * @param serviceName Name of the service (used for error reporting)
+     * @param http Configured HTTPClient instance
+     * @param baseUrl Base URL for the service API
+     */
+    constructor(serviceName, http, baseUrl) {
+        this.serviceName = serviceName;
+        this.http = http;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Execute a standardized API request with automatic validation and error handling
+     *
+     * This method handles all the common patterns:
+     * - Parameter validation with Zod schemas
+     * - HTTP request execution
+     * - Response validation
+     * - Consistent error handling and reporting
+     *
+     * @param config Endpoint configuration including method, path, and schemas
+     * @param params Optional request parameters (query params for GET, body for POST/PUT)
+     * @param pathParams Optional path parameters for URL substitution
+     * @returns Promise resolving to the validated response data
+     * @throws ValidationError When parameters or response validation fails
+     * @throws AugurError For HTTP errors (handled by HTTPClient interceptors)
+     */
+    async executeRequest(config, params, pathParams) {
+        const endpoint = this.buildEndpointPath(config.path, pathParams);
+        try {
+            // Validate request parameters if schema provided
+            let validatedParams;
+            if (params !== undefined && config.paramsSchema) {
+                validatedParams = config.paramsSchema.parse(params);
+            }
+            else {
+                validatedParams = params;
+            }
+            // Execute HTTP request based on method
+            let response;
+            switch (config.method) {
+                case 'GET':
+                    response = await this.http.get(`${this.baseUrl}${endpoint}`, validatedParams);
+                    break;
+                case 'POST':
+                    response = await this.http.post(`${this.baseUrl}${endpoint}`, validatedParams);
+                    break;
+                case 'PUT':
+                    response = await this.http.put(`${this.baseUrl}${endpoint}`, validatedParams);
+                    break;
+                case 'DELETE':
+                    response = await this.http.delete(`${this.baseUrl}${endpoint}`);
+                    break;
+                default:
+                    throw new Error(`Unsupported HTTP method: ${config.method}`);
+            }
+            // Validate response structure and return exactly as received
+            const validatedResponse = config.responseSchema.parse(response);
+            // Return the complete response without transformation
+            // The client should return data exactly as received from the API
+            return validatedResponse;
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                throw new errors_1.ValidationError({
+                    message: 'Invalid parameters or response',
+                    service: this.serviceName,
+                    endpoint,
+                    validationErrors: error.errors,
+                });
+            }
+            throw error;
+        }
+    }
+    /**
+     * Create a standardized list method factory
+     *
+     * Generates a function that follows the standard list pattern with optional parameters,
+     * pagination support, and consistent error handling.
+     *
+     * @param endpoint The API endpoint path
+     * @param paramsSchema Zod schema for validating query parameters
+     * @param responseSchema Zod schema for validating the response
+     * @returns A function that executes the list operation
+     */
+    createListMethod(endpoint, paramsSchema, responseSchema) {
+        return async (params) => {
+            return this.executeRequest({
+                method: 'GET',
+                path: endpoint,
+                paramsSchema,
+                responseSchema,
+            }, params);
+        };
+    }
+    /**
+     * Create a standardized get method factory
+     *
+     * Generates a function that retrieves a single item by ID with optional parameters.
+     *
+     * @param endpointTemplate The API endpoint template with {id} placeholder
+     * @param responseSchema Zod schema for validating the response
+     * @param paramsSchema Optional Zod schema for query parameters
+     * @returns A function that executes the get operation
+     */
+    createGetMethod(endpointTemplate, responseSchema, paramsSchema) {
+        return async (id, params) => {
+            return this.executeRequest({
+                method: 'GET',
+                path: endpointTemplate,
+                paramsSchema,
+                responseSchema,
+            }, params, { id: String(id) });
+        };
+    }
+    /**
+     * Create a standardized create method factory
+     *
+     * Generates a function that creates a new resource via POST request.
+     *
+     * @param endpoint The API endpoint path
+     * @param requestSchema Zod schema for validating request data
+     * @param responseSchema Zod schema for validating the response
+     * @returns A function that executes the create operation
+     */
+    createCreateMethod(endpoint, requestSchema, responseSchema) {
+        return async (data) => {
+            return this.executeRequest({
+                method: 'POST',
+                path: endpoint,
+                paramsSchema: requestSchema,
+                responseSchema,
+            }, data);
+        };
+    }
+    /**
+     * Create a standardized update method factory
+     *
+     * Generates a function that updates an existing resource via PUT request.
+     *
+     * @param endpointTemplate The API endpoint template with {id} placeholder
+     * @param requestSchema Zod schema for validating request data
+     * @param responseSchema Zod schema for validating the response
+     * @returns A function that executes the update operation
+     */
+    createUpdateMethod(endpointTemplate, requestSchema, responseSchema) {
+        return async (id, data) => {
+            return this.executeRequest({
+                method: 'PUT',
+                path: endpointTemplate,
+                paramsSchema: requestSchema,
+                responseSchema,
+            }, data, { id: String(id) });
+        };
+    }
+    /**
+     * Create a standardized delete method factory
+     *
+     * Generates a function that deletes a resource via DELETE request.
+     *
+     * @param endpointTemplate The API endpoint template with {id} placeholder
+     * @param responseSchema Zod schema for validating the response
+     * @returns A function that executes the delete operation
+     */
+    createDeleteMethod(endpointTemplate, responseSchema) {
+        return async (id) => {
+            return this.executeRequest({
+                method: 'DELETE',
+                path: endpointTemplate,
+                responseSchema,
+            }, undefined, { id: String(id) });
+        };
+    }
+    /**
+     * Create a health check method that follows the standard pattern
+     *
+     * @param responseSchema Zod schema for the health check response
+     * @returns A function that executes the health check
+     */
+    createHealthCheckMethod(responseSchema) {
+        return async () => {
+            // Health check returns the full response object
+            return this.executeRequest({
+                method: 'GET',
+                path: '/health-check',
+                responseSchema,
+                requiresAuth: false,
+            });
+        };
+    }
+    /**
+     * Create a delete method that returns a boolean success indicator
+     *
+     * Common pattern for delete operations that don't return the deleted entity.
+     * The method always returns true if the request succeeds (no error thrown).
+     *
+     * @param endpointTemplate The API endpoint template with {id} placeholder
+     * @returns A function that executes the delete operation and returns true on success
+     */
+    createDeleteBooleanMethod(endpointTemplate) {
+        return async (id) => {
+            await this.executeRequest({
+                method: 'DELETE',
+                path: endpointTemplate,
+                responseSchema: zod_1.z.any(), // Accept any response as we only care about success
+            }, undefined, { id: String(id) });
+            return true;
+        };
+    }
+    /**
+     * Create a search method with required query parameter
+     *
+     * Enforces that a search query is provided and handles the common search pattern.
+     *
+     * @param endpoint The API endpoint path
+     * @param paramsSchema Zod schema for validating search parameters (must include 'q')
+     * @param responseSchema Zod schema for validating the response
+     * @returns A function that executes the search operation
+     */
+    createSearchMethod(endpoint, paramsSchema, responseSchema) {
+        return async (params) => {
+            if (!params.q || params.q.trim() === '') {
+                throw new errors_1.ValidationError({
+                    message: 'Search query is required',
+                    service: this.serviceName,
+                    endpoint,
+                    validationErrors: [
+                        {
+                            path: ['q'],
+                            message: 'Search query cannot be empty',
+                            code: 'custom',
+                        },
+                    ],
+                });
+            }
+            return this.executeRequest({
+                method: 'GET',
+                path: endpoint,
+                paramsSchema,
+                responseSchema,
+            }, params);
+        };
+    }
+    /**
+     * Create a method that returns the first item from an array response
+     *
+     * Common pattern for endpoints that return an array but we only need the first item.
+     *
+     * @param endpoint The API endpoint path
+     * @param paramsSchema Zod schema for validating request parameters
+     * @param itemSchema Zod schema for validating individual items in the array
+     * @returns A function that executes the request and returns the first item or undefined
+     */
+    createSingleItemMethod(endpoint, paramsSchema, itemSchema) {
+        return async (params) => {
+            const response = await this.executeRequest({
+                method: 'GET',
+                path: endpoint,
+                paramsSchema,
+                responseSchema: this.createArrayResponseSchema(itemSchema),
+            }, params);
+            return response.data[0];
+        };
+    }
+    /**
+     * Create an action method for operations like enable/disable
+     *
+     * Common pattern for POST/PUT endpoints that perform actions on resources.
+     *
+     * @param endpointTemplate The API endpoint template with placeholders
+     * @param method HTTP method (POST or PUT)
+     * @param responseSchema Zod schema for validating the response
+     * @param pathParams Additional path parameters beyond the id
+     * @returns A function that executes the action
+     */
+    createActionMethod(endpointTemplate, method, responseSchema, pathParams) {
+        return async (id) => {
+            return this.executeRequest({
+                method,
+                path: endpointTemplate,
+                responseSchema,
+            }, undefined, { id: String(id), ...pathParams });
+        };
+    }
+    /**
+     * Create a void method that doesn't return meaningful data
+     *
+     * Common pattern for operations that succeed with empty or undefined responses.
+     *
+     * @param endpointTemplate The API endpoint template
+     * @param method HTTP method
+     * @returns A function that executes the operation
+     */
+    createVoidMethod(endpointTemplate, method) {
+        return async (id) => {
+            await this.executeRequest({
+                method,
+                path: endpointTemplate,
+                responseSchema: zod_1.z.any(),
+            }, undefined, id ? { id: String(id) } : undefined);
+        };
+    }
+    /**
+     * Helper to create a standard array response schema
+     */
+    createArrayResponseSchema(itemSchema) {
+        return (0, schemas_1.BaseResponseSchema)(zod_1.z.array(itemSchema));
+    }
+    /**
+     * Create a standardized document method for endpoints that return enhanced documentation
+     *
+     * Common pattern across services for endpoints like /content/{id}/doc, /users/{id}/doc, etc.
+     *
+     * @param endpointTemplate The API endpoint template with {id} placeholder
+     * @param responseSchema Zod schema for validating the document response
+     * @param paramsSchema Optional Zod schema for query parameters
+     * @returns A function that executes the document retrieval operation
+     */
+    createDocMethod(endpointTemplate, responseSchema, paramsSchema) {
+        return async (id, params) => {
+            return this.executeRequest({
+                method: 'GET',
+                path: endpointTemplate,
+                paramsSchema,
+                responseSchema,
+            }, params, { id: String(id) });
+        };
+    }
+    /**
+     * Create a standardized ping method for service availability testing
+     *
+     * @param responseSchema Zod schema for the ping response (typically string or literal)
+     * @returns A function that executes the ping operation
+     */
+    createPingMethod(responseSchema) {
+        return async () => {
+            return this.executeRequest({
+                method: 'GET',
+                path: '/ping',
+                responseSchema,
+                requiresAuth: false,
+            });
+        };
+    }
+    /**
+     * Build endpoint path with optional path parameter substitution
+     *
+     * @param pathTemplate Path template with {param} placeholders
+     * @param pathParams Object containing parameter values
+     * @returns Processed endpoint path
+     *
+     * @example
+     * ```typescript
+     * buildEndpointPath('/users/{id}', { id: '123' }) // returns '/users/123'
+     * buildEndpointPath('/health-check') // returns '/health-check'
+     * ```
+     */
+    buildEndpointPath(pathTemplate, pathParams) {
+        if (!pathParams) {
+            return pathTemplate;
+        }
+        let path = pathTemplate;
+        for (const [key, value] of Object.entries(pathParams)) {
+            path = path.replace(`{${key}}`, String(value));
+        }
+        return path;
+    }
+}
+exports.BaseServiceClient = BaseServiceClient;
+//# sourceMappingURL=base-client.js.map

package/dist/cjs/core/base-client.js.map

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

package/dist/cjs/core/client.d.ts

@@ -0,0 +1,17 @@
+import { AugurAPIConfig, RequestConfig } from './config';
+export declare class HTTPClient {
+    private axios;
+    private config;
+    private serviceName;
+    constructor(serviceName: string, config: AugurAPIConfig);
+    private setupInterceptors;
+    private handleHttpError;
+    private handleNetworkError;
+    get<T>(url: string, params?: unknown, config?: RequestConfig): Promise<T>;
+    post<T>(url: string, data?: unknown, config?: RequestConfig): Promise<T>;
+    put<T>(url: string, data?: unknown, config?: RequestConfig): Promise<T>;
+    delete<T>(url: string, config?: RequestConfig): Promise<T>;
+    setBearerToken(token: string): void;
+    setSiteId(siteId: string): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/cjs/core/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAkB,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzE,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc;IAWvD,OAAO,CAAC,iBAAiB;IA8CzB,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,kBAAkB;IAUpB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAsBzE,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAKxE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAKvE,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAKhE,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAGhC"}

package/dist/cjs/core/client.js

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HTTPClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const config_1 = require("./config");
+const errors_1 = require("./errors");
+class HTTPClient {
+    constructor(serviceName, config) {
+        this.serviceName = serviceName;
+        this.config = { ...config_1.DEFAULT_CONFIG, ...config };
+        this.axios = axios_1.default.create({
+            timeout: this.config.timeout,
+        });
+        this.setupInterceptors();
+    }
+    setupInterceptors() {
+        // Request interceptor
+        this.axios.interceptors.request.use(async (config) => {
+            // Always add x-site-id header
+            config.headers['x-site-id'] = this.config.siteId;
+            // Add bearer token for non-health-check endpoints
+            const isHealthCheck = config.url?.includes('/health-check');
+            if (!isHealthCheck && this.config.bearerToken) {
+                config.headers['Authorization'] = `Bearer ${this.config.bearerToken}`;
+            }
+            // User-defined request interceptor
+            if (this.config.onRequest) {
+                const modifiedConfig = await this.config.onRequest(config);
+                // Ensure we return the internal config format
+                return modifiedConfig;
+            }
+            return config;
+        }, error => Promise.reject(error));
+        // Response interceptor
+        this.axios.interceptors.response.use(response => {
+            if (this.config.onResponse) {
+                return this.config.onResponse(response);
+            }
+            return response;
+        }, async (error) => {
+            const originalRequest = error.config;
+            const endpoint = originalRequest?.url || 'unknown';
+            if (error.response) {
+                this.handleHttpError(error.response, endpoint);
+            }
+            this.handleNetworkError(error, endpoint);
+        });
+    }
+    handleHttpError(response, endpoint) {
+        const { status, data } = response;
+        switch (status) {
+            case 401:
+                throw new errors_1.AuthenticationError({
+                    message: data?.message || 'Authentication failed',
+                    service: this.serviceName,
+                    endpoint,
+                });
+            case 404:
+                throw new errors_1.NotFoundError({
+                    message: data?.message || 'Resource not found',
+                    service: this.serviceName,
+                    endpoint,
+                });
+            case 429:
+                throw new errors_1.RateLimitError({
+                    message: data?.message || 'Rate limit exceeded',
+                    service: this.serviceName,
+                    endpoint,
+                });
+            default:
+                throw new errors_1.AugurError({
+                    message: data?.message || `Request failed with status ${status}`,
+                    code: data?.code || 'API_ERROR',
+                    statusCode: status,
+                    service: this.serviceName,
+                    endpoint,
+                    requestId: data?.requestId,
+                });
+        }
+    }
+    handleNetworkError(error, endpoint) {
+        throw new errors_1.AugurError({
+            message: error.message || 'Network error',
+            code: 'NETWORK_ERROR',
+            statusCode: 0,
+            service: this.serviceName,
+            endpoint,
+        });
+    }
+    async get(url, params, config) {
+        const baseParams = params && typeof params === 'object' ? params : {};
+        // Auto-inject cacheSiteId parameter based on edgeCache value
+        const enhancedParams = { ...baseParams };
+        // If edgeCache is specified, map it to the correct cacheSiteId parameter
+        if (baseParams.edgeCache && typeof baseParams.edgeCache === 'number') {
+            const cacheHours = baseParams.edgeCache;
+            enhancedParams[`cacheSiteId${cacheHours}`] = this.config.siteId;
+            // Remove the edgeCache parameter as it's only used for mapping
+            delete enhancedParams.edgeCache;
+        }
+        const response = await this.axios.get(url, {
+            params: enhancedParams,
+            ...config,
+        });
+        return response.data;
+    }
+    async post(url, data, config) {
+        const response = await this.axios.post(url, data, config);
+        return response.data;
+    }
+    async put(url, data, config) {
+        const response = await this.axios.put(url, data, config);
+        return response.data;
+    }
+    async delete(url, config) {
+        const response = await this.axios.delete(url, config);
+        return response.data;
+    }
+    setBearerToken(token) {
+        this.config.bearerToken = token;
+    }
+    setSiteId(siteId) {
+        this.config.siteId = siteId;
+    }
+}
+exports.HTTPClient = HTTPClient;
+//# sourceMappingURL=client.js.map

package/dist/cjs/core/client.js.map

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