@coderule/clients 1.5.0 → 1.6.0

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;
@@ -86,13 +98,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 +159,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 +195,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 +231,7 @@ interface CoderuleClientOptions {
     retrieval?: ServiceConfig;
     sync?: ServiceConfig;
     jwtFactory?: JWTFactoryOptions;
+    logger?: Logger;
 }
 declare class CoderuleClients {
     readonly auth: AuthHttpClient;
@@ -222,6 +241,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 +252,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 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