@coderule/clients 1.5.0 → 1.6.1

package/dist/index.d.ts

@@ -1,3 +1,12 @@
+interface Logger {
+    error(message: string, ...meta: unknown[]): void;
+    warn(message: string, ...meta: unknown[]): void;
+    info(message: string, ...meta: unknown[]): void;
+    debug(message: string, ...meta: unknown[]): void;
+}
+declare const nullLogger: Logger;
+declare const consoleLogger: Logger;
+
 interface AuthResponse {
     jwt: string;
     expires_at: string;
@@ -10,7 +19,8 @@ interface HealthResponse$2 {
 declare class AuthHttpClient {
     private baseUrl;
     private timeout;
-    constructor(baseUrl: string, timeout?: number);
+    private readonly logger;
+    constructor(baseUrl: string, timeout?: number, logger?: Logger);
     authenticate(token: string): Promise<AuthResponse>;
     health(): Promise<HealthResponse$2>;
     close(): void;
@@ -21,7 +31,7 @@ interface JWTPayload {
     iat?: number;
     nbf?: number;
 }
-declare function decodeJWT(jwtToken: string): JWTPayload | null;
+declare function decodeJWT(jwtToken: string, logger?: Logger): JWTPayload | null;
 
 interface JWTProvider {
     getJWT(forceRefresh?: boolean): Promise<string>;
@@ -34,6 +44,7 @@ interface TokenRefreshInfo {
 interface JWTFactoryOptions {
     minTtlMs?: number;
     onTokenRefreshed?: (info: TokenRefreshInfo) => void;
+    logger?: Logger;
 }
 declare class JWTFactory implements JWTProvider {
     private readonly authClient;
@@ -43,6 +54,7 @@ declare class JWTFactory implements JWTProvider {
     private readonly minTtlMs;
     private readonly onTokenRefreshed?;
     private currentServerUrl?;
+    private readonly logger;
     constructor(authClient: AuthHttpClient, sourceToken: string, options?: JWTFactoryOptions);
     setSourceToken(token: string): void;
     invalidate(): void;
@@ -55,16 +67,27 @@ declare class JWTFactory implements JWTProvider {
     getServerUrl(): string | undefined;
 }
 
+interface SnapshotTimingMetrics {
+    pass1?: number;
+    pass2?: number;
+    gap?: number;
+    pass2db?: number;
+    total_files?: number;
+    total_chunks?: number;
+    total_classes?: number;
+    total_methods?: number;
+}
 interface SnapshotStatus$1 {
     status: 'NOT_FOUND' | 'READY' | 'INDEXING' | 'PENDING' | 'FAILED' | 'MISSING_CONTENT';
     snapshot_hash?: string;
     created_at?: string;
-    indexed_at?: string;
-    total_files?: number;
+    updated_at?: string;
+    timing?: SnapshotTimingMetrics;
     missing_files?: Array<{
         file_path: string;
         file_hash: string;
     }>;
+    message?: string;
     [key: string]: any;
 }
 interface FileInfo {
@@ -86,13 +109,15 @@ interface SyncClientConfig {
     baseUrl?: string;
     timeout?: number;
     jwtProvider: JWTProvider;
+    logger?: Logger;
 }
 declare class SyncHttpClient {
     private baseUrl;
     private timeout;
     private apiBase;
     private readonly jwtProvider;
-    constructor({ baseUrl, timeout, jwtProvider, }: SyncClientConfig);
+    private readonly logger;
+    constructor({ baseUrl, timeout, jwtProvider, logger, }: SyncClientConfig);
     updateBaseUrl(baseUrl: string): void;
     private configureBase;
     checkSnapshotStatus(snapshotHash: string): Promise<SnapshotStatus$1>;
@@ -145,13 +170,15 @@ interface RetrievalClientConfig {
     baseUrl?: string;
     timeout?: number;
     jwtProvider: JWTProvider;
+    logger?: Logger;
 }
 declare class RetrievalHttpClient {
     private baseUrl;
     private timeout;
     private apiBase;
     private readonly jwtProvider;
-    constructor({ baseUrl, timeout, jwtProvider, }: RetrievalClientConfig);
+    private readonly logger;
+    constructor({ baseUrl, timeout, jwtProvider, logger, }: RetrievalClientConfig);
     updateBaseUrl(baseUrl: string): void;
     private configureBase;
     healthCheck(): Promise<HealthResponse>;
@@ -179,13 +206,15 @@ interface ASTClientConfig {
     baseUrl?: string;
     timeout?: number;
     jwtProvider: JWTProvider;
+    logger?: Logger;
 }
 declare class ASTHttpClient {
     private baseUrl;
     private timeout;
     private apiBase;
     private readonly jwtProvider;
-    constructor({ baseUrl, timeout, jwtProvider, }: ASTClientConfig);
+    private readonly logger;
+    constructor({ baseUrl, timeout, jwtProvider, logger, }: ASTClientConfig);
     updateBaseUrl(baseUrl: string): void;
     private configureBase;
     getVisitorRulesV2(): Promise<VisitorRulesV2>;
@@ -213,6 +242,7 @@ interface CoderuleClientOptions {
     retrieval?: ServiceConfig;
     sync?: ServiceConfig;
     jwtFactory?: JWTFactoryOptions;
+    logger?: Logger;
 }
 declare class CoderuleClients {
     readonly auth: AuthHttpClient;
@@ -222,6 +252,7 @@ declare class CoderuleClients {
     readonly jwtFactory: JWTFactory;
     private readonly serviceBaseLocked;
     private lastServerUrl?;
+    private readonly logger;
     constructor(options: CoderuleClientOptions);
     get jwt(): JWTProvider;
     getJWT(forceRefresh?: boolean): Promise<string>;
@@ -232,4 +263,4 @@ declare class CoderuleClients {
 
 declare const fetch: typeof globalThis.fetch;
 
-export { type ASTClientConfig, ASTHttpClient, AuthHttpClient, type CoderuleClientOptions, CoderuleClients, type HealthStatus, JWTFactory, type JWTFactoryOptions, type JWTProvider, type RetrievalClientConfig, RetrievalHttpClient, type ServiceConfig, type ServiceKey, type SyncClientConfig, SyncHttpClient, type TokenRefreshInfo, type VisitorRulesV2, decodeJWT, fetch };
+export { type ASTClientConfig, ASTHttpClient, AuthHttpClient, type CoderuleClientOptions, CoderuleClients, type HealthStatus, JWTFactory, type JWTFactoryOptions, type JWTProvider, type Logger, type RetrievalClientConfig, RetrievalHttpClient, type ServiceConfig, type ServiceKey, type SnapshotStatus$1 as SnapshotStatus, type SnapshotTimingMetrics, type SyncClientConfig, SyncHttpClient, type TokenRefreshInfo, type VisitorRulesV2, consoleLogger, decodeJWT, fetch, nullLogger };

package/dist/index.js

@@ -119,16 +119,37 @@ var FormData2 = fetchModule.FormData;
 var AbortController2 = fetchModule.AbortController;
 var fetch_wrapper_default = fetch2;
 
+// src/utils/logger.ts
+init_esm_shims();
+var nullLogger = {
+  error: () => {
+  },
+  warn: () => {
+  },
+  info: () => {
+  },
+  debug: () => {
+  }
+};
+var consoleLogger = {
+  error: (message, ...meta) => console.error(message, ...meta),
+  warn: (message, ...meta) => console.warn(message, ...meta),
+  info: (message, ...meta) => console.info(message, ...meta),
+  debug: (message, ...meta) => console.debug(message, ...meta)
+};
+
 // src/clients/auth-client.ts
 var AuthHttpClient = class {
   /**
    * Initialize the Auth HTTP client
    * @param baseUrl - Base URL of the Auth service (e.g., "http://localhost:8001")
    * @param timeout - Request timeout in milliseconds (default: 30000)
+   * @param logger - Optional logger instance (defaults to nullLogger)
    */
-  constructor(baseUrl, timeout = 3e4) {
+  constructor(baseUrl, timeout = 3e4, logger) {
     this.baseUrl = baseUrl.replace(/\/$/, "");
     this.timeout = timeout;
+    this.logger = logger ?? nullLogger;
   }
   /**
    * Authenticate a token and receive a JWT
@@ -157,7 +178,7 @@ var AuthHttpClient = class {
         );
       }
       const data = await response.json();
-      console.debug(
+      this.logger.debug(
         `Authentication successful, JWT expires at ${data.expires_at}`
       );
       return data;
@@ -165,7 +186,7 @@ var AuthHttpClient = class {
       if (error.name === "AbortError") {
         throw new Error(`Request timeout after ${this.timeout}ms`);
       }
-      console.error(`Authentication request failed: ${error.message}`);
+      this.logger.error(`Authentication request failed: ${error.message}`);
       throw error;
     }
   }
@@ -191,13 +212,13 @@ var AuthHttpClient = class {
         );
       }
       const data = await response.json();
-      console.debug(`Health check: ${data.status}`);
+      this.logger.debug(`Health check: ${data.status}`);
       return data;
     } catch (error) {
       if (error.name === "AbortError") {
         throw new Error(`Request timeout after ${this.timeout}ms`);
       }
-      console.error(`Health check request failed: ${error.message}`);
+      this.logger.error(`Health check request failed: ${error.message}`);
       throw error;
     }
   }
@@ -207,7 +228,7 @@ var AuthHttpClient = class {
   close() {
   }
 };
-function decodeJWT(jwtToken) {
+function decodeJWT(jwtToken, logger) {
   try {
     const parts = jwtToken.split(".");
     if (parts.length !== 3) {
@@ -221,13 +242,13 @@ function decodeJWT(jwtToken) {
     if (payloadObj.exp) {
       const now = Math.floor(Date.now() / 1e3);
       if (payloadObj.exp < now) {
-        console.debug("JWT token is expired");
+        if (logger) logger.debug("JWT token is expired");
         return null;
       }
     }
     return payloadObj;
   } catch (error) {
-    console.error("Failed to decode JWT:", error);
+    if (logger) logger.error("Failed to decode JWT:", error);
     return null;
   }
 }
@@ -240,17 +261,20 @@ var SyncHttpClient = class {
    * @param config.baseUrl - URI/URL for connecting to the HTTP server (e.g., "http://localhost:8002")
    * @param config.timeout - Request timeout in milliseconds (default: 60000)
    * @param config.jwtProvider - Provider for obtaining JWT tokens
+   * @param config.logger - Optional logger instance (defaults to nullLogger)
    */
   constructor({
     baseUrl = "http://localhost:8002",
     timeout = 6e4,
-    jwtProvider
+    jwtProvider,
+    logger
   }) {
     if (!jwtProvider) {
       throw new Error("SyncHttpClient requires a JWT provider");
     }
     this.timeout = timeout;
     this.jwtProvider = jwtProvider;
+    this.logger = logger ?? nullLogger;
     this.configureBase(baseUrl);
   }
   updateBaseUrl(baseUrl) {
@@ -313,7 +337,7 @@ var SyncHttpClient = class {
       if (error.name === "AbortError") {
         throw new Error(`Request timeout after ${this.timeout}ms`);
       }
-      console.error(`Request failed: ${error.message}`);
+      this.logger.error(`Request failed: ${error.message}`);
       throw error;
     }
   }
@@ -348,7 +372,7 @@ var SyncHttpClient = class {
       clearTimeout(timeoutId);
       if (response.status === 422) {
         const data2 = await response.json();
-        console.info(
+        this.logger.info(
           `Snapshot ${snapshotHash.substring(0, 8)}... missing ${data2.missing_files?.length || 0} files`
         );
         return data2;
@@ -360,7 +384,7 @@ var SyncHttpClient = class {
         );
       }
       const data = await response.json();
-      console.info(
+      this.logger.info(
         `Snapshot ${snapshotHash.substring(0, 8)}... status: ${data.status}`
       );
       return data;
@@ -368,7 +392,7 @@ var SyncHttpClient = class {
       if (error.name === "AbortError") {
         throw new Error(`Request timeout after ${this.timeout}ms`);
       }
-      console.error(`Request failed: ${error.message}`);
+      this.logger.error(`Request failed: ${error.message}`);
       throw error;
     }
   }
@@ -407,7 +431,7 @@ var SyncHttpClient = class {
         );
       }
       const data = await response.json();
-      console.info(
+      this.logger.info(
         `Uploaded ${data.uploaded_count || 0} files, ${data.failed_count || 0} failed`
       );
       return data;
@@ -415,7 +439,7 @@ var SyncHttpClient = class {
       if (error.name === "AbortError") {
         throw new Error(`Request timeout after ${this.timeout}ms`);
       }
-      console.error(`Request failed: ${error.message}`);
+      this.logger.error(`Request failed: ${error.message}`);
       throw error;
     }
   }
@@ -471,7 +495,7 @@ var SyncHttpClient = class {
       if (error.name === "AbortError") {
         throw new Error(`Request timeout after ${this.timeout}ms`);
       }
-      console.error(`Request failed: ${error.message}`);
+      this.logger.error(`Request failed: ${error.message}`);
       throw error;
     }
   }
@@ -490,20 +514,23 @@ var RetrievalHttpClient = class {
    * @param config.baseUrl - URI/URL for connecting to the HTTP server (e.g., "http://localhost:8004")
    * @param config.timeout - Request timeout in milliseconds (default: 60000)
    * @param config.jwtProvider - Provider for obtaining JWT tokens
+   * @param config.logger - Optional logger instance (defaults to nullLogger)
    */
   constructor({
     baseUrl = "http://localhost:8004",
     timeout = 6e4,
-    jwtProvider
+    jwtProvider,
+    logger
   }) {
     if (!jwtProvider) {
       throw new Error("RetrievalHttpClient requires a JWT provider");
     }
     this.timeout = timeout;
     this.jwtProvider = jwtProvider;
+    this.logger = logger ?? nullLogger;
     this.configureBase(baseUrl);
-    console.debug(`Initialized HTTP client for ${this.baseUrl}`);
-    console.debug(`API base: ${this.apiBase}`);
+    this.logger.debug(`Initialized HTTP client for ${this.baseUrl}`);
+    this.logger.debug(`API base: ${this.apiBase}`);
   }
   updateBaseUrl(baseUrl) {
     this.configureBase(baseUrl);
@@ -532,7 +559,7 @@ var RetrievalHttpClient = class {
    */
   async healthCheck() {
     const healthEndpoint = `${this.apiBase}health`;
-    console.debug(`Checking server health: ${healthEndpoint}`);
+    this.logger.debug(`Checking server health: ${healthEndpoint}`);
     try {
       const controller = new AbortController2();
       const timeoutId = setTimeout(() => controller.abort(), this.timeout);
@@ -548,7 +575,7 @@ var RetrievalHttpClient = class {
         );
       }
       const healthInfo = await response.json();
-      console.debug(`HTTP retrieval server status:`, healthInfo);
+      this.logger.debug(`HTTP retrieval server status:`, healthInfo);
       return {
         status: healthInfo.status || "UNKNOWN",
         database: healthInfo.database || "UNKNOWN",
@@ -561,7 +588,7 @@ var RetrievalHttpClient = class {
       if (error.name === "AbortError") {
         throw new Error(`Request timeout after ${this.timeout}ms`);
       }
-      console.error(`Error checking HTTP server health: ${error.message}`);
+      this.logger.error(`Error checking HTTP server health: ${error.message}`);
       throw new Error(
         `Unable to connect to HTTP server ${this.baseUrl}: ${error.message}`
       );
@@ -625,7 +652,7 @@ var RetrievalHttpClient = class {
       const result = await response.json();
       const elapsedTime = (Date.now() - startTime) / 1e3;
       const formatter = options?.formatter || "standard";
-      console.debug(
+      this.logger.debug(
         `Retrieval query completed for snapshot ${snapshotHash.substring(0, 8)}... Formatter: ${formatter}. Total time: ${elapsedTime.toFixed(2)}s`
       );
       return result;
@@ -633,7 +660,7 @@ var RetrievalHttpClient = class {
       if (error.name === "AbortError") {
         throw new Error(`Request timeout after ${this.timeout}ms`);
       }
-      console.error(`Error executing retrieval query: ${error.message}`);
+      this.logger.error(`Error executing retrieval query: ${error.message}`);
       throw new Error(`Failed to execute retrieval query: ${error.message}`);
     }
   }
@@ -675,7 +702,7 @@ var RetrievalHttpClient = class {
         );
       }
       const statusInfo = await response.json();
-      console.debug(
+      this.logger.debug(
         `Snapshot ${snapshotHash.substring(0, 8)}... status: ${statusInfo.status}`
       );
       return statusInfo;
@@ -683,7 +710,7 @@ var RetrievalHttpClient = class {
       if (error.name === "AbortError") {
         throw new Error(`Request timeout after ${this.timeout}ms`);
       }
-      console.error(`Error checking snapshot status: ${error.message}`);
+      this.logger.error(`Error checking snapshot status: ${error.message}`);
       throw new Error(`Failed to check snapshot status: ${error.message}`);
     }
   }
@@ -713,13 +740,13 @@ var RetrievalHttpClient = class {
           `Cache clear failed with status ${response.status}: ${errorText}`
         );
       }
-      console.info("Graph cache cleared successfully");
+      this.logger.info("Graph cache cleared successfully");
       return true;
     } catch (error) {
       if (error.name === "AbortError") {
         throw new Error(`Request timeout after ${this.timeout}ms`);
       }
-      console.error(`Error clearing cache: ${error.message}`);
+      this.logger.error(`Error clearing cache: ${error.message}`);
       throw new Error(`Failed to clear cache: ${error.message}`);
     }
   }
@@ -750,7 +777,7 @@ var RetrievalHttpClient = class {
         );
       }
       const stats = await response.json();
-      console.debug(
+      this.logger.debug(
         `Cache stats: ${stats.cached_snapshots || 0} snapshots cached`
       );
       return stats;
@@ -758,7 +785,7 @@ var RetrievalHttpClient = class {
       if (error.name === "AbortError") {
         throw new Error(`Request timeout after ${this.timeout}ms`);
       }
-      console.error(`Error getting cache stats: ${error.message}`);
+      this.logger.error(`Error getting cache stats: ${error.message}`);
       throw new Error(`Failed to get cache stats: ${error.message}`);
     }
   }
@@ -802,17 +829,20 @@ var ASTHttpClient = class {
    * @param config.baseUrl - URI/URL for connecting to the HTTP server (e.g., "http://localhost:8003")
    * @param config.timeout - Request timeout in milliseconds (default: 60000)
    * @param config.jwtProvider - Provider for obtaining JWT tokens
+   * @param config.logger - Optional logger instance (defaults to nullLogger)
    */
   constructor({
     baseUrl = "http://localhost:8003",
     timeout = 6e4,
-    jwtProvider
+    jwtProvider,
+    logger
   }) {
     if (!jwtProvider) {
       throw new Error("ASTHttpClient requires a JWT provider");
     }
     this.timeout = timeout;
     this.jwtProvider = jwtProvider;
+    this.logger = logger ?? nullLogger;
     this.configureBase(baseUrl);
   }
   updateBaseUrl(baseUrl) {
@@ -869,7 +899,7 @@ var ASTHttpClient = class {
       if (error.name === "AbortError") {
         throw new Error(`Request timeout after ${this.timeout}ms`);
       }
-      console.error(`Failed to get visitor rules v2: ${error.message}`);
+      this.logger.error(`Failed to get visitor rules v2: ${error.message}`);
       throw error;
     }
   }
@@ -901,7 +931,7 @@ var ASTHttpClient = class {
       if (error.name === "AbortError") {
         throw new Error(`Request timeout after ${this.timeout}ms`);
       }
-      console.error(`Health check failed: ${error.message}`);
+      this.logger.error(`Health check failed: ${error.message}`);
       throw error;
     }
   }
@@ -974,6 +1004,7 @@ var JWTFactory = class {
     }
     this.minTtlMs = options.minTtlMs ?? DEFAULT_MIN_TTL_MS;
     this.onTokenRefreshed = options.onTokenRefreshed;
+    this.logger = options.logger ?? nullLogger;
   }
   setSourceToken(token) {
     if (!token) {
@@ -1012,7 +1043,7 @@ var JWTFactory = class {
       return await this.refreshPromise;
     } catch (error) {
       if (!forceRefresh && this.cache && now < this.cache.expiresAt) {
-        console.warn(
+        this.logger.warn(
           "Failed to refresh JWT, using cached token until expiry. Reason:",
           error
         );
@@ -1055,7 +1086,7 @@ var JWTFactory = class {
         return parsed;
       }
     }
-    const decoded = decodeJWT(jwt);
+    const decoded = decodeJWT(jwt, this.logger);
     if (decoded?.exp) {
       const expMs = decoded.exp * 1e3;
       if (expMs > referenceTime + this.minTtlMs) {
@@ -1076,7 +1107,7 @@ var JWTFactory = class {
       try {
         this.onTokenRefreshed(info);
       } catch (error) {
-        console.warn("JWTFactory onTokenRefreshed callback failed:", error);
+        this.logger.warn("JWTFactory onTokenRefreshed callback failed:", error);
       }
     }
   }
@@ -1111,14 +1142,16 @@ var CoderuleClients = class {
     if (!options?.token) {
       throw new Error("CoderuleClients requires a non-empty token");
     }
+    this.logger = options.logger ?? nullLogger;
     const overrides = resolveOverrides(options);
     const baseUrl = options.baseUrl;
     const authBase = overrides.auth?.baseUrl ?? baseUrl ?? DEFAULT_AUTH_BASE_URL;
     const authTimeout = resolveTimeout("auth", overrides);
-    this.auth = new AuthHttpClient(authBase, authTimeout);
+    this.auth = new AuthHttpClient(authBase, authTimeout, this.logger);
     const userTokenCallback = options.jwtFactory?.onTokenRefreshed;
     const jwtOptions = {
       ...options.jwtFactory,
+      logger: this.logger,
       onTokenRefreshed: (info) => {
         userTokenCallback?.(info);
         if (info.serverUrl) {
@@ -1136,17 +1169,20 @@ var CoderuleClients = class {
     this.ast = new ASTHttpClient({
       baseUrl: overrides.ast?.baseUrl ?? defaultServiceBase,
       timeout: resolveTimeout("ast", overrides),
-      jwtProvider: this.jwtFactory
+      jwtProvider: this.jwtFactory,
+      logger: this.logger
     });
     this.retrieval = new RetrievalHttpClient({
       baseUrl: overrides.retrieval?.baseUrl ?? defaultServiceBase,
       timeout: resolveTimeout("retrieval", overrides),
-      jwtProvider: this.jwtFactory
+      jwtProvider: this.jwtFactory,
+      logger: this.logger
     });
     this.sync = new SyncHttpClient({
       baseUrl: overrides.sync?.baseUrl ?? defaultServiceBase,
       timeout: resolveTimeout("sync", overrides),
-      jwtProvider: this.jwtFactory
+      jwtProvider: this.jwtFactory,
+      logger: this.logger
     });
     const initialServerUrl = this.jwtFactory.getServerUrl();
     if (initialServerUrl) {
@@ -1179,25 +1215,25 @@ var CoderuleClients = class {
         this.ast.updateBaseUrl(trimmed);
       }
     } catch (error) {
-      console.warn("Failed to update AST client base URL:", error);
+      this.logger.warn("Failed to update AST client base URL:", error);
     }
     try {
       if (!this.serviceBaseLocked.retrieval) {
         this.retrieval.updateBaseUrl(trimmed);
       }
     } catch (error) {
-      console.warn("Failed to update Retrieval client base URL:", error);
+      this.logger.warn("Failed to update Retrieval client base URL:", error);
     }
     try {
       if (!this.serviceBaseLocked.sync) {
         this.sync.updateBaseUrl(trimmed);
       }
     } catch (error) {
-      console.warn("Failed to update Sync client base URL:", error);
+      this.logger.warn("Failed to update Sync client base URL:", error);
     }
   }
 };
 
-export { ASTHttpClient, AuthHttpClient, CoderuleClients, JWTFactory, RetrievalHttpClient, SyncHttpClient, decodeJWT, fetch_wrapper_default as fetch };
+export { ASTHttpClient, AuthHttpClient, CoderuleClients, JWTFactory, RetrievalHttpClient, SyncHttpClient, consoleLogger, decodeJWT, fetch_wrapper_default as fetch, nullLogger };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map