@simpleapps-com/augur-api 2026.4.5 → 2026.4.6

package/dist/types/core/base-client.d.ts

@@ -1,453 +0,0 @@
-import { HTTPClient } from './client';
-import * as v from 'valibot';
-/**
- * Interface for discovery metadata that AI agents can use to navigate services
- */
-export interface DiscoveryEndpoint {
-    /** Complete API path (e.g., api.joomla.users.list) */
-    fullPath: string;
-    /** Service name (e.g., joomla, nexus, items) */
-    service: string;
-    /** Business domain (e.g., user-management, content-management) */
-    domain: string;
-    /** HTTP method (GET, POST, PUT, DELETE) */
-    method: string;
-    /** Endpoint URL path */
-    path: string;
-    /** Description of what this endpoint does */
-    description: string;
-    /** Array of search terms for AI navigation */
-    searchTerms: string[];
-    /** Related endpoints across services */
-    relatedEndpoints: string[];
-    /** Common usage patterns in natural language */
-    commonPatterns: string[];
-    /** Reference to data-only method alternative */
-    dataMethod?: string;
-    /** Whether this endpoint is discoverable by AI agents */
-    discoverable: boolean;
-}
-/**
- * Interface for service discovery metadata
- */
-export interface ServiceDiscoveryMetadata {
-    /** Service name */
-    serviceName: string;
-    /** Service description */
-    description: string;
-    /** Base URL for the service */
-    baseUrl: string;
-    /** Array of discoverable endpoints */
-    endpoints: DiscoveryEndpoint[];
-}
-/**
- * HTTP method types for API operations
- */
-export type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
-/**
- * Configuration for API endpoint operations
- */
-export interface EndpointConfig {
-    /** HTTP method for the request */
-    method: HTTPMethod;
-    /** Endpoint path (will be prefixed with baseUrl) */
-    path: string;
-    /** Valibot schema for validating request parameters */
-    paramsSchema?: v.GenericSchema;
-    /** Valibot schema for validating response data */
-    responseSchema: v.GenericSchema;
-    /** Whether this endpoint requires authentication (default: true) */
-    requiresAuth?: boolean;
-}
-/**
- * Standard pagination parameters with better type constraints
- */
-export interface PaginationParams {
-    /** Number of items to return (1-1000) */
-    limit?: number;
-    /** Starting offset for pagination (>= 0) */
-    offset?: number;
-    /** Sort ordering in format: 'field|ASC' or 'field|DESC' */
-    orderBy?: string;
-}
-/**
- * Standard search parameters extending pagination
- */
-export interface SearchParams extends PaginationParams {
-    /** Search query string */
-    q?: string;
-}
-/**
- * Edge caching parameters for Cloudflare integration
- */
-export interface CacheParams {
-    /**
-     * Cache duration - accepts sub-hour or hourly values:
-     * - Sub-hour: '30s' (30 seconds), '1m' (1 minute), '5m' (5 minutes)
-     * - Hourly: 1, 2, 3, 4, 5, 8 (or string equivalents for HTTP compatibility)
-     */
-    edgeCache?: '30s' | '1m' | '5m' | 1 | 2 | 3 | 4 | 5 | 8 | '1' | '2' | '3' | '4' | '5' | '8';
-}
-/**
- * Standard GET request parameters combining pagination, search, and caching
- */
-export interface StandardGetParams extends SearchParams, CacheParams {
-}
-/**
- * Standard API response structure - REQUIRED for all services (8-field format)
- * This is the ONLY acceptable response format for all APIs
- */
-export interface BaseResponse<T> {
-    /** Number of items in current response */
-    count: number;
-    /** Response data of type T */
-    data: T;
-    /** Response message */
-    message: string;
-    /** Additional options for the response */
-    options: unknown[] | Record<string, unknown>;
-    /** Parameters used in the request */
-    params: unknown[] | Record<string, unknown>;
-    /** HTTP status code */
-    status: number;
-    /** Total items in dataset */
-    total: number;
-    /** Total results available */
-    totalResults: number;
-}
-/**
- * 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);
- *   }
- * }
- * ```
- */
-export declare abstract class BaseServiceClient {
-    protected readonly serviceName: string;
-    protected readonly http: HTTPClient;
-    protected readonly baseUrl: string;
-    /**
-     * 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: string, http: HTTPClient, baseUrl: string);
-    /**
-     * Execute a standardized API request with automatic validation and error handling
-     *
-     * This method handles all the common patterns:
-     * - Parameter validation with Valibot 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)
-     */
-    protected executeRequest<TParams = unknown, TResponse = unknown>(config: EndpointConfig, params?: TParams, pathParams?: Record<string, string | number>): Promise<TResponse>;
-    /**
-     * Validate request parameters using the provided schema
-     */
-    private validateParameters;
-    /**
-     * Execute HTTP request based on the configured method
-     */
-    private executeHttpRequest;
-    /**
-     * Create a detailed validation error with context information
-     */
-    private createValidationError;
-    /**
-     * 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 Valibot schema for validating query parameters
-     * @param responseSchema Valibot schema for validating the response
-     * @returns A function that executes the list operation
-     */
-    protected createListMethod<TParams = StandardGetParams, TItem = unknown, TResponse extends BaseResponse<TItem[]> = BaseResponse<TItem[]>>(endpoint: string, paramsSchema: v.GenericSchema, responseSchema: v.GenericSchema): (params?: TParams) => Promise<TResponse>;
-    /**
-     * 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 parameter placeholders
-     * @param responseSchema Valibot schema for validating the response
-     * @param paramsSchema Optional Valibot schema for query parameters
-     * @returns A function that executes the get operation
-     */
-    protected createGetMethod<TParams = CacheParams, TItem = unknown, TResponse extends BaseResponse<TItem> = BaseResponse<TItem>>(endpointTemplate: string, responseSchema: v.GenericSchema, paramsSchema?: v.GenericSchema): (id: string | number, params?: TParams) => Promise<TResponse>;
-    /**
-     * 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 Valibot schema for validating request data
-     * @param responseSchema Valibot schema for validating the response
-     * @returns A function that executes the create operation
-     */
-    protected createCreateMethod<TRequest, TResponse>(endpoint: string, requestSchema: v.GenericSchema, responseSchema: v.GenericSchema): (data: TRequest) => Promise<TResponse>;
-    /**
-     * Create a standardized update method factory
-     *
-     * Generates a function that updates an existing resource via PUT request.
-     *
-     * @param endpointTemplate The API endpoint template with parameter placeholders
-     * @param requestSchema Valibot schema for validating request data
-     * @param responseSchema Valibot schema for validating the response
-     * @returns A function that executes the update operation
-     */
-    protected createUpdateMethod<TRequest, TResponse>(endpointTemplate: string, requestSchema: v.GenericSchema, responseSchema: v.GenericSchema): (id: string | number, data: TRequest) => Promise<TResponse>;
-    /**
-     * Create a standardized delete method factory
-     *
-     * Generates a function that deletes a resource via DELETE request.
-     *
-     * @param endpointTemplate The API endpoint template with parameter placeholders
-     * @param responseSchema Valibot schema for validating the response
-     * @returns A function that executes the delete operation
-     */
-    protected createDeleteMethod<TResponse>(endpointTemplate: string, responseSchema: v.GenericSchema): (id: string | number) => Promise<TResponse>;
-    /**
-     * Create a health check method that follows the standard pattern
-     *
-     * @param responseSchema Valibot schema for the health check response
-     * @returns A function that executes the health check
-     */
-    protected createHealthCheckMethod<TResponse>(responseSchema: v.GenericSchema): () => Promise<TResponse>;
-    /**
-     * 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 parameter placeholders
-     * @returns A function that executes the delete operation and returns true on success
-     */
-    protected createDeleteBooleanMethod(endpointTemplate: string): (id: string | number) => Promise<boolean>;
-    /**
-     * 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 Valibot schema for validating search parameters (must include 'q')
-     * @param responseSchema Valibot schema for validating the response
-     * @returns A function that executes the search operation
-     */
-    protected createSearchMethod<TParams extends SearchParams, TResponse>(endpoint: string, paramsSchema: v.GenericSchema, responseSchema: v.GenericSchema): (params: TParams) => Promise<TResponse>;
-    /**
-     * 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 Valibot schema for validating request parameters
-     * @param itemSchema Valibot schema for validating individual items in the array
-     * @returns A function that executes the request and returns the first item or undefined
-     */
-    protected createSingleItemMethod<TParams, TItem>(endpoint: string, paramsSchema: v.GenericSchema, itemSchema: v.GenericSchema): (params: TParams) => Promise<TItem | undefined>;
-    /**
-     * 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 Valibot schema for validating the response
-     * @param pathParams Additional path parameters beyond the id
-     * @returns A function that executes the action
-     */
-    protected createActionMethod<TResponse>(endpointTemplate: string, method: 'POST' | 'PUT', responseSchema: v.GenericSchema, pathParams?: Record<string, string>): (id: string | number) => Promise<TResponse>;
-    /**
-     * 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
-     */
-    protected createVoidMethod(endpointTemplate: string, method: HTTPMethod): (id?: string | number) => Promise<void>;
-    /**
-     * Helper to create a standard array response schema
-     */
-    private createArrayResponseSchema;
-    /**
-     * 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 parameter placeholders
-     * @param responseSchema Valibot schema for validating the document response
-     * @param paramsSchema Optional Valibot schema for query parameters
-     * @returns A function that executes the document retrieval operation
-     */
-    protected createDocMethod<TParams, TResponse>(endpointTemplate: string, responseSchema: v.GenericSchema, paramsSchema?: v.GenericSchema): (id: string | number, params?: TParams) => Promise<TResponse>;
-    /**
-     * Create a standardized ping method for service availability testing
-     *
-     * @param responseSchema Valibot schema for the ping response (typically string or literal)
-     * @returns A function that executes the ping operation
-     */
-    protected createPingMethod<TResponse>(responseSchema: v.GenericSchema): () => Promise<TResponse>;
-    /**
-     * 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'
-     * ```
-     */
-    private buildEndpointPath;
-    /**
-     * Create a debugging helper for troubleshooting validation errors
-     *
-     * @param config Endpoint configuration
-     * @param params Parameters being validated
-     * @returns Debug information object
-     */
-    protected createDebugInfo<TParams>(config: EndpointConfig, params?: TParams): {
-        endpoint: string;
-        method: string;
-        hasParamSchema: boolean;
-        providedParams: TParams | undefined;
-        expectedSchema?: string;
-    };
-    /**
-     * Validate parameters and provide detailed error information for debugging
-     *
-     * @param schema Valibot schema to validate against
-     * @param params Parameters to validate
-     * @param context Context information for error messages
-     * @returns Validation result with detailed error information
-     */
-    protected validateWithDebugInfo<T>(schema: v.GenericSchema, params: unknown, context: string): {
-        success: true;
-        data: T;
-    } | {
-        success: false;
-        errors: string[];
-        rawErrors: v.ValiError<any>;
-    };
-    /**
-     * Extract parameter name from endpoint template
-     *
-     * @param endpointTemplate The endpoint template (e.g., '/bin-transfer/{binTransferHdrUid}')
-     * @returns The parameter name (e.g., 'binTransferHdrUid') or null if no parameter found
-     *
-     * @example
-     * ```typescript
-     * extractParameterName('/bin-transfer/{binTransferHdrUid}') // returns 'binTransferHdrUid'
-     * extractParameterName('/users/{id}') // returns 'id'
-     * extractParameterName('/health-check') // returns null
-     * ```
-     */
-    private extractParameterName;
-    /**
-     * Get discovery metadata for this service client
-     *
-     * This method extracts semantic JSDoc metadata from all methods in the service client
-     * to enable AI agents to understand the service topology and navigate endpoints.
-     *
-     * @returns ServiceDiscoveryMetadata containing service info and endpoint metadata
-     */
-    getDiscoveryMetadata(): ServiceDiscoveryMetadata;
-    /**
-     * Get all method names from the service client instance
-     */
-    private getAllMethods;
-    /**
-     * Recursively walk prototype chain to collect methods
-     */
-    private walkPrototypeChain;
-    /**
-     * Check if a property is a valid method to include in discovery
-     */
-    private isValidMethod;
-    /**
-     * Extract semantic metadata from a method's JSDoc comments
-     *
-     * This method parses JSDoc comments to extract the semantic tags required
-     * for AI agent discovery and navigation.
-     */
-    private extractMethodMetadata;
-    /**
-     * Get method function from instance
-     */
-    private getMethodFunction;
-    /**
-     * Extract JSDoc content from method source
-     */
-    private extractJSDocContent;
-    /**
-     * Parse all semantic tags from JSDoc content
-     */
-    private parseSemanticTags;
-    /**
-     * Check if required semantic tags are present
-     */
-    private hasRequiredTags;
-    /**
-     * Extract description from JSDoc content
-     */
-    private extractDescription;
-    /**
-     * Extract a single JSDoc tag value
-     */
-    private extractJSDocTag;
-    /**
-     * Extract an array JSDoc tag value (e.g., @searchTerms ["term1", "term2"])
-     */
-    private extractJSDocArrayTag;
-    /**
-     * Infer HTTP method and path from method implementation
-     */
-    private inferMethodDetails;
-    /**
-     * Get service description - can be overridden by subclasses
-     */
-    protected getServiceDescription(): string;
-}
-//# sourceMappingURL=base-client.d.ts.map

package/dist/types/core/base-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-client.d.ts","sourceRoot":"","sources":["../../../src/core/base-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,wCAAwC;IACxC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gDAAgD;IAChD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,MAAM,EAAE,UAAU,CAAC;IACnB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,YAAY,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC;IAC/B,kDAAkD;IAClD,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC;IAChC,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,0BAA0B;IAC1B,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CAC7F;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,YAAY,EAAE,WAAW;CAAG;AAEvE;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,IAAI,EAAE,CAAC,CAAC;IACR,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,qCAAqC;IACrC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,8BAAsB,iBAAiB;IACrC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACvC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEnC;;;;;OAKG;gBACS,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM;IAMlE;;;;;;;;;;;;;;;OAeG;cACa,cAAc,CAAC,OAAO,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO,EACnE,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,OAAO,EAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAC3C,OAAO,CAAC,SAAS,CAAC;IAiBrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;YACW,kBAAkB;IAqBhC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkD7B;;;;;;;;;;OAUG;IACH,SAAS,CAAC,gBAAgB,CACxB,OAAO,GAAG,iBAAiB,EAC3B,KAAK,GAAG,OAAO,EACf,SAAS,SAAS,YAAY,CAAC,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,EAC/D,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,aAAa,EAAE,cAAc,EAAE,CAAC,CAAC,aAAa,IAClE,SAAS,OAAO,KAAG,OAAO,CAAC,SAAS,CAAC;IAarD;;;;;;;;;OASG;IACH,SAAS,CAAC,eAAe,CACvB,OAAO,GAAG,WAAW,EACrB,KAAK,GAAG,OAAO,EACf,SAAS,SAAS,YAAY,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,EAC3D,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,aAAa,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC,aAAa,IAC3E,IAAI,MAAM,GAAG,MAAM,EAAE,SAAS,OAAO,KAAG,OAAO,CAAC,SAAS,CAAC;IAkB1E;;;;;;;;;OASG;IACH,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,SAAS,EAC9C,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,CAAC,CAAC,aAAa,EAC9B,cAAc,EAAE,CAAC,CAAC,aAAa,IAEjB,MAAM,QAAQ,KAAG,OAAO,CAAC,SAAS,CAAC;IAanD;;;;;;;;;OASG;IACH,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,SAAS,EAC9C,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,CAAC,CAAC,aAAa,EAC9B,cAAc,EAAE,CAAC,CAAC,aAAa,IAEjB,IAAI,MAAM,GAAG,MAAM,EAAE,MAAM,QAAQ,KAAG,OAAO,CAAC,SAAS,CAAC;IAkBxE;;;;;;;;OAQG;IACH,SAAS,CAAC,kBAAkB,CAAC,SAAS,EACpC,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,CAAC,CAAC,aAAa,IAEjB,IAAI,MAAM,GAAG,MAAM,KAAG,OAAO,CAAC,SAAS,CAAC;IAiBxD;;;;;OAKG;IACH,SAAS,CAAC,uBAAuB,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC,aAAa,SACzD,OAAO,CAAC,SAAS,CAAC;IAWrC;;;;;;;;OAQG;IACH,SAAS,CAAC,yBAAyB,CAAC,gBAAgB,EAAE,MAAM,IAC5C,IAAI,MAAM,GAAG,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;IAkBtD;;;;;;;;;OASG;IACH,SAAS,CAAC,kBAAkB,CAAC,OAAO,SAAS,YAAY,EAAE,SAAS,EAClE,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,CAAC,CAAC,aAAa,EAC7B,cAAc,EAAE,CAAC,CAAC,aAAa,IAEjB,QAAQ,OAAO,KAAG,OAAO,CAAC,SAAS,CAAC;IA2BpD;;;;;;;;;OASG;IACH,SAAS,CAAC,sBAAsB,CAAC,OAAO,EAAE,KAAK,EAC7C,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,CAAC,CAAC,aAAa,EAC7B,UAAU,EAAE,CAAC,CAAC,aAAa,IAEb,QAAQ,OAAO,KAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAc5D;;;;;;;;;;OAUG;IACH,SAAS,CAAC,kBAAkB,CAAC,SAAS,EACpC,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,MAAM,GAAG,KAAK,EACtB,cAAc,EAAE,CAAC,CAAC,aAAa,EAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAErB,IAAI,MAAM,GAAG,MAAM,KAAG,OAAO,CAAC,SAAS,CAAC;IAiBxD;;;;;;;;OAQG;IACH,SAAS,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,IACvD,KAAK,MAAM,GAAG,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;IAoBpD;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAIjC;;;;;;;;;OASG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,EAC1C,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,CAAC,CAAC,aAAa,EAC/B,YAAY,CAAC,EAAE,CAAC,CAAC,aAAa,IAEhB,IAAI,MAAM,GAAG,MAAM,EAAE,SAAS,OAAO,KAAG,OAAO,CAAC,SAAS,CAAC;IAkB1E;;;;;OAKG;IACH,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC,aAAa,SAClD,OAAO,CAAC,SAAS,CAAC;IAUrC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAC/B,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,OAAO,GACf;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,OAAO,CAAC;QACxB,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC;QACpC,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB;IAUD;;;;;;;OAOG;IACH,SAAS,CAAC,qBAAqB,CAAC,CAAC,EAC/B,MAAM,EAAE,CAAC,CAAC,aAAa,EACvB,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,MAAM,GAEb;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,GAE1B;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;KAAE;IAyBrE;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;;;;;;OAOG;IACH,oBAAoB,IAAI,wBAAwB;IAqBhD;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAmC7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkC1B;;OAEG;IACH,SAAS,CAAC,qBAAqB,IAAI,MAAM;CAG1C"}

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

@@ -1,66 +0,0 @@
-import { AugurAPIConfig, RequestConfig } from './config';
-export declare class HTTPClient {
-    private config;
-    private serviceName;
-    private inflightRequests;
-    constructor(serviceName: string, config: AugurAPIConfig);
-    /**
-     * Build request headers with auth
-     */
-    private buildRequestHeaders;
-    /**
-     * Handle non-ok fetch response: parse error, call hook, throw
-     */
-    private handleFetchError;
-    /**
-     * Handle successful fetch response: parse, call hook, return data
-     */
-    private handleFetchSuccess;
-    /**
-     * Core request method using native fetch
-     */
-    private request;
-    /**
-     * Merge two AbortSignals — aborts when either fires
-     */
-    private mergeSignals;
-    private handleHttpError;
-    /**
-     * Re-throw known error types or wrap as network error
-     */
-    private rethrowOrWrapError;
-    private handleNetworkError;
-    /**
-     * Executes a single request attempt
-     */
-    private executeAttempt;
-    /**
-     * Executes a request with retry logic
-     */
-    private executeWithRetry;
-    /**
-     * Transform edgeCache parameter to Cloudflare's cacheSiteId format
-     *
-     * Cloudflare expects cacheSiteId{suffix}=<siteId> where suffix indicates duration:
-     * - '30s', '1m', '5m' for sub-hour caches
-     * - 1, 2, 3, 4, 5, 8 for hourly caches
-     *
-     * Examples:
-     * - edgeCache: '30s' → cacheSiteId30s: <siteId>
-     * - edgeCache: '1m' → cacheSiteId1m: <siteId>
-     * - edgeCache: '5m' → cacheSiteId5m: <siteId>
-     * - edgeCache: 1 → cacheSiteId1: <siteId>
-     * - edgeCache: 8 → cacheSiteId8: <siteId>
-     *
-     * @param params Original request parameters
-     * @returns Parameters with edgeCache transformed to cacheSiteId{suffix}
-     */
-    private transformEdgeCacheParams;
-    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/types/core/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAKd,aAAa,EACd,MAAM,UAAU,CAAC;AA2FlB,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAA4C;gBAExD,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc;IAKvD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;YACW,gBAAgB;IA6B9B;;OAEG;YACW,kBAAkB;IAsBhC;;OAEG;YACW,OAAO;IAyDrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,eAAe;IAqCvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;YACW,cAAc;IAuB5B;;OAEG;YACW,gBAAgB;IAO9B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,wBAAwB;IA6C1B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAyBzE,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAIxE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAIvE,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhE,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAGhC"}

package/dist/types/core/common-schemas.d.ts

@@ -1,93 +0,0 @@
-import * as v from 'valibot';
-import { EdgeCacheParamsSchema } from './schemas';
-/**
- * Common schemas shared across all microservices
- *
- * This module contains frequently used schemas to reduce duplication
- * and ensure consistency across all API clients.
- */
-export declare const CommonHealthCheckResponseSchema: v.SchemaWithPipe<readonly [v.LooseObjectSchema<{
-    readonly count: v.NumberSchema<undefined>;
-    readonly data: v.ObjectSchema<{
-        readonly siteHash: v.StringSchema<undefined>;
-        readonly siteId: v.StringSchema<undefined>;
-    }, undefined>;
-    readonly message: v.StringSchema<undefined>;
-    readonly options: v.UnionSchema<[v.ArraySchema<v.UnknownSchema, undefined>, v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>], undefined>;
-    readonly params: v.UnionSchema<[v.ArraySchema<v.UnknownSchema, undefined>, v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>], undefined>;
-    readonly status: v.NumberSchema<undefined>;
-    readonly total: v.NumberSchema<undefined>;
-    readonly totalResults: v.NumberSchema<undefined>;
-}, undefined>, v.TransformAction<any, any>]>;
-export declare const CommonPingResponseSchema: v.SchemaWithPipe<readonly [v.LooseObjectSchema<{
-    readonly count: v.NumberSchema<undefined>;
-    readonly data: v.LiteralSchema<"pong", undefined>;
-    readonly message: v.StringSchema<undefined>;
-    readonly options: v.UnionSchema<[v.ArraySchema<v.UnknownSchema, undefined>, v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>], undefined>;
-    readonly params: v.UnionSchema<[v.ArraySchema<v.UnknownSchema, undefined>, v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>], undefined>;
-    readonly status: v.NumberSchema<undefined>;
-    readonly total: v.NumberSchema<undefined>;
-    readonly totalResults: v.NumberSchema<undefined>;
-}, undefined>, v.TransformAction<any, any>]>;
-export declare const StandardPaginationParamsSchema: v.LooseObjectSchema<{
-    readonly edgeCache: v.OptionalSchema<v.UnionSchema<[v.LiteralSchema<"30s", undefined>, v.LiteralSchema<"1m", undefined>, v.LiteralSchema<"5m", undefined>, v.LiteralSchema<1, undefined>, v.LiteralSchema<2, undefined>, v.LiteralSchema<3, undefined>, v.LiteralSchema<4, undefined>, v.LiteralSchema<5, undefined>, v.LiteralSchema<8, undefined>, v.LiteralSchema<"1", undefined>, v.LiteralSchema<"2", undefined>, v.LiteralSchema<"3", undefined>, v.LiteralSchema<"4", undefined>, v.LiteralSchema<"5", undefined>, v.LiteralSchema<"8", undefined>], undefined>, undefined>;
-    readonly limit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.UnknownSchema, v.TransformAction<any, number>, v.MinValueAction<number, 1, undefined>]>, 10>;
-    readonly offset: v.OptionalSchema<v.SchemaWithPipe<readonly [v.UnknownSchema, v.TransformAction<any, number>, v.MinValueAction<number, 0, undefined>]>, 0>;
-    readonly orderBy: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-}, undefined>;
-export declare const SearchablePaginationParamsSchema: v.LooseObjectSchema<{
-    readonly q: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly edgeCache: v.OptionalSchema<v.UnionSchema<[v.LiteralSchema<"30s", undefined>, v.LiteralSchema<"1m", undefined>, v.LiteralSchema<"5m", undefined>, v.LiteralSchema<1, undefined>, v.LiteralSchema<2, undefined>, v.LiteralSchema<3, undefined>, v.LiteralSchema<4, undefined>, v.LiteralSchema<5, undefined>, v.LiteralSchema<8, undefined>, v.LiteralSchema<"1", undefined>, v.LiteralSchema<"2", undefined>, v.LiteralSchema<"3", undefined>, v.LiteralSchema<"4", undefined>, v.LiteralSchema<"5", undefined>, v.LiteralSchema<"8", undefined>], undefined>, undefined>;
-    readonly limit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.UnknownSchema, v.TransformAction<any, number>, v.MinValueAction<number, 1, undefined>]>, 10>;
-    readonly offset: v.OptionalSchema<v.SchemaWithPipe<readonly [v.UnknownSchema, v.TransformAction<any, number>, v.MinValueAction<number, 0, undefined>]>, 0>;
-    readonly orderBy: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-}, undefined>;
-export { EdgeCacheParamsSchema };
-export declare const BooleanResponseSchema: v.SchemaWithPipe<readonly [v.LooseObjectSchema<{
-    readonly count: v.NumberSchema<undefined>;
-    readonly data: v.BooleanSchema<undefined>;
-    readonly message: v.StringSchema<undefined>;
-    readonly options: v.UnionSchema<[v.ArraySchema<v.UnknownSchema, undefined>, v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>], undefined>;
-    readonly params: v.UnionSchema<[v.ArraySchema<v.UnknownSchema, undefined>, v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>], undefined>;
-    readonly status: v.NumberSchema<undefined>;
-    readonly total: v.NumberSchema<undefined>;
-    readonly totalResults: v.NumberSchema<undefined>;
-}, undefined>, v.TransformAction<any, any>]>;
-export declare const StringResponseSchema: v.SchemaWithPipe<readonly [v.LooseObjectSchema<{
-    readonly count: v.NumberSchema<undefined>;
-    readonly data: v.StringSchema<undefined>;
-    readonly message: v.StringSchema<undefined>;
-    readonly options: v.UnionSchema<[v.ArraySchema<v.UnknownSchema, undefined>, v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>], undefined>;
-    readonly params: v.UnionSchema<[v.ArraySchema<v.UnknownSchema, undefined>, v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>], undefined>;
-    readonly status: v.NumberSchema<undefined>;
-    readonly total: v.NumberSchema<undefined>;
-    readonly totalResults: v.NumberSchema<undefined>;
-}, undefined>, v.TransformAction<any, any>]>;
-export declare const NumberResponseSchema: v.SchemaWithPipe<readonly [v.LooseObjectSchema<{
-    readonly count: v.NumberSchema<undefined>;
-    readonly data: v.NumberSchema<undefined>;
-    readonly message: v.StringSchema<undefined>;
-    readonly options: v.UnionSchema<[v.ArraySchema<v.UnknownSchema, undefined>, v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>], undefined>;
-    readonly params: v.UnionSchema<[v.ArraySchema<v.UnknownSchema, undefined>, v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>], undefined>;
-    readonly status: v.NumberSchema<undefined>;
-    readonly total: v.NumberSchema<undefined>;
-    readonly totalResults: v.NumberSchema<undefined>;
-}, undefined>, v.TransformAction<any, any>]>;
-export declare const TimestampFieldsSchema: v.ObjectSchema<{
-    readonly dateCreated: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "Invalid MySQL datetime format. Expected: YYYY-MM-DD HH:mm:ss">]>, undefined>;
-    readonly dateLastModified: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "Invalid MySQL datetime format. Expected: YYYY-MM-DD HH:mm:ss">]>, undefined>;
-}, undefined>;
-export declare const StatusFieldsSchema: v.ObjectSchema<{
-    readonly statusCd: v.NumberSchema<undefined>;
-    readonly createCd: v.StringSchema<undefined>;
-    readonly updateCd: v.StringSchema<undefined>;
-}, undefined>;
-export declare const NumericIdSchema: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>]>;
-export declare const StringIdSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
-export declare const UuidSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.UuidAction<string, undefined>]>;
-export type StandardPaginationParams = v.InferInput<typeof StandardPaginationParamsSchema>;
-export type SearchablePaginationParams = v.InferInput<typeof SearchablePaginationParamsSchema>;
-export type EdgeCacheParams = v.InferOutput<typeof EdgeCacheParamsSchema>;
-export type TimestampFields = v.InferOutput<typeof TimestampFieldsSchema>;
-export type StatusFields = v.InferOutput<typeof StatusFieldsSchema>;
-//# sourceMappingURL=common-schemas.d.ts.map

package/dist/types/core/common-schemas.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"common-schemas.d.ts","sourceRoot":"","sources":["../../../src/core/common-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAC7B,OAAO,EAEL,qBAAqB,EAGtB,MAAM,WAAW,CAAC;AAGnB;;;;;GAKG;AAGH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;4CAA4C,CAAC;AAEzF,eAAO,MAAM,wBAAwB;;;;;;;;;4CAAqC,CAAC;AAK3E,eAAO,MAAM,8BAA8B;;;;;aAKzC,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;aAG3C,CAAC;AAOH,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAGjC,eAAO,MAAM,qBAAqB;;;;;;;;;4CAAkC,CAAC;AAErE,eAAO,MAAM,oBAAoB;;;;;;;;;4CAAiC,CAAC;AAEnE,eAAO,MAAM,oBAAoB;;;;;;;;;4CAAiC,CAAC;AAGnE,eAAO,MAAM,qBAAqB;;;aAGhC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;aAI7B,CAAC;AAGH,eAAO,MAAM,eAAe,gGAAoC,CAAC;AACjE,eAAO,MAAM,cAAc,iGAAqC,CAAC;AACjE,eAAO,MAAM,UAAU,yFAA+B,CAAC;AAGvD,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAC3F,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC/F,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC1E,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC"}