@coderule/clients 1.2.0 → 1.5.0

package/dist/index.d.ts

@@ -23,6 +23,38 @@ interface JWTPayload {
 }
 declare function decodeJWT(jwtToken: string): JWTPayload | null;
 
+interface JWTProvider {
+    getJWT(forceRefresh?: boolean): Promise<string>;
+}
+interface TokenRefreshInfo {
+    token: string;
+    expiresAt: number;
+    serverUrl?: string;
+}
+interface JWTFactoryOptions {
+    minTtlMs?: number;
+    onTokenRefreshed?: (info: TokenRefreshInfo) => void;
+}
+declare class JWTFactory implements JWTProvider {
+    private readonly authClient;
+    private sourceToken;
+    private cache?;
+    private refreshPromise?;
+    private readonly minTtlMs;
+    private readonly onTokenRefreshed?;
+    private currentServerUrl?;
+    constructor(authClient: AuthHttpClient, sourceToken: string, options?: JWTFactoryOptions);
+    setSourceToken(token: string): void;
+    invalidate(): void;
+    getJWT(forceRefresh?: boolean): Promise<string>;
+    private refresh;
+    private fetchNewToken;
+    private resolveExpiryMs;
+    private extractServerUrl;
+    private emitTokenRefreshed;
+    getServerUrl(): string | undefined;
+}
+
 interface SnapshotStatus$1 {
     status: 'NOT_FOUND' | 'READY' | 'INDEXING' | 'PENDING' | 'FAILED' | 'MISSING_CONTENT';
     snapshot_hash?: string;
@@ -50,17 +82,25 @@ interface HealthResponse$1 {
     version?: string;
     [key: string]: any;
 }
+interface SyncClientConfig {
+    baseUrl?: string;
+    timeout?: number;
+    jwtProvider: JWTProvider;
+}
 declare class SyncHttpClient {
     private baseUrl;
     private timeout;
     private apiBase;
-    constructor(uri?: string, timeout?: number);
-    checkSnapshotStatus(snapshotHash: string, jwt: string): Promise<SnapshotStatus$1>;
-    createSnapshot(snapshotHash: string, files: FileInfo[], jwt: string): Promise<SnapshotStatus$1>;
+    private readonly jwtProvider;
+    constructor({ baseUrl, timeout, jwtProvider, }: SyncClientConfig);
+    updateBaseUrl(baseUrl: string): void;
+    private configureBase;
+    checkSnapshotStatus(snapshotHash: string): Promise<SnapshotStatus$1>;
+    createSnapshot(snapshotHash: string, files: FileInfo[]): Promise<SnapshotStatus$1>;
     uploadFileContent(filesContent: Map<string, {
         path: string;
         content: Buffer | string;
-    }>, jwt: string): Promise<UploadResult>;
+    }>): Promise<UploadResult>;
     static calculateFileHash(filePath: string, content: Buffer | string): string;
     static calculateSnapshotHash(fileHashes: string[]): string;
     health(): Promise<HealthResponse$1>;
@@ -101,17 +141,25 @@ interface CacheStats {
     ttl: number;
     snapshots: string[];
 }
+interface RetrievalClientConfig {
+    baseUrl?: string;
+    timeout?: number;
+    jwtProvider: JWTProvider;
+}
 declare class RetrievalHttpClient {
     private baseUrl;
     private timeout;
     private apiBase;
-    constructor(uri?: string, timeout?: number);
+    private readonly jwtProvider;
+    constructor({ baseUrl, timeout, jwtProvider, }: RetrievalClientConfig);
+    updateBaseUrl(baseUrl: string): void;
+    private configureBase;
     healthCheck(): Promise<HealthResponse>;
-    query(snapshotHash: string, queryText: string, budgetTokens: number | undefined, jwt: string, options?: RetrievalOptions): Promise<RetrievalResult>;
-    checkSnapshotStatus(snapshotHash: string, jwt: string): Promise<SnapshotStatus>;
-    clearCache(jwt: string): Promise<boolean>;
-    getCacheStats(jwt: string): Promise<CacheStats>;
-    queryWithOptions(snapshotHash: string, queryText: string, jwt: string, budgetTokens?: number, flowStrength?: number, blendAlpha?: number, hopDepth?: number, maxIterations?: number, split?: number, formatter?: 'standard' | 'compact'): Promise<RetrievalResult>;
+    query(snapshotHash: string, queryText: string, budgetTokens?: number, options?: RetrievalOptions): Promise<RetrievalResult>;
+    checkSnapshotStatus(snapshotHash: string): Promise<SnapshotStatus>;
+    clearCache(): Promise<boolean>;
+    getCacheStats(): Promise<CacheStats>;
+    queryWithOptions(snapshotHash: string, queryText: string, budgetTokens?: number, flowStrength?: number, blendAlpha?: number, hopDepth?: number, maxIterations?: number, split?: number, formatter?: 'standard' | 'compact'): Promise<RetrievalResult>;
     close(): void;
 }
 
@@ -127,22 +175,61 @@ interface HealthStatus {
     frontends_loaded: number;
     info: Record<string, string>;
 }
+interface ASTClientConfig {
+    baseUrl?: string;
+    timeout?: number;
+    jwtProvider: JWTProvider;
+}
 declare class ASTHttpClient {
     private baseUrl;
     private timeout;
     private apiBase;
-    constructor(uri?: string, timeout?: number);
-    getVisitorRulesV2(jwt: string): Promise<VisitorRulesV2>;
+    private readonly jwtProvider;
+    constructor({ baseUrl, timeout, jwtProvider, }: ASTClientConfig);
+    updateBaseUrl(baseUrl: string): void;
+    private configureBase;
+    getVisitorRulesV2(): Promise<VisitorRulesV2>;
     health(): Promise<HealthStatus>;
     static compileRulesV2(rules: VisitorRulesV2): {
         exts: Set<string>;
         names: Set<string>;
         dirRe: RegExp;
+        dirs: Set<string>;
     };
     static buildIgnoredPredicate(compiled: ReturnType<typeof ASTHttpClient.compileRulesV2>): (path: string, stats?: any) => boolean;
     close(): void;
 }
 
+type ServiceKey = 'auth' | 'ast' | 'retrieval' | 'sync';
+interface ServiceConfig {
+    baseUrl?: string;
+    timeout?: number;
+}
+interface CoderuleClientOptions {
+    token: string;
+    baseUrl?: string;
+    auth?: ServiceConfig;
+    ast?: ServiceConfig;
+    retrieval?: ServiceConfig;
+    sync?: ServiceConfig;
+    jwtFactory?: JWTFactoryOptions;
+}
+declare class CoderuleClients {
+    readonly auth: AuthHttpClient;
+    readonly ast: ASTHttpClient;
+    readonly retrieval: RetrievalHttpClient;
+    readonly sync: SyncHttpClient;
+    readonly jwtFactory: JWTFactory;
+    private readonly serviceBaseLocked;
+    private lastServerUrl?;
+    constructor(options: CoderuleClientOptions);
+    get jwt(): JWTProvider;
+    getJWT(forceRefresh?: boolean): Promise<string>;
+    setToken(token: string): void;
+    close(): void;
+    private applyServerUrl;
+}
+
 declare const fetch: typeof globalThis.fetch;
 
-export { ASTHttpClient, AuthHttpClient, type HealthStatus, RetrievalHttpClient, SyncHttpClient, type VisitorRulesV2, decodeJWT, 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 };