@coderule/clients 1.1.0 → 1.4.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,12 +82,19 @@ interface HealthResponse$1 {
     version?: string;
     [key: string]: any;
 }
+interface SyncClientConfig {
+    baseUrl?: string;
+    timeout?: number;
+    jwtProvider: JWTProvider;
+}
 declare class SyncHttpClient {
     private baseUrl;
-    private jwtToken;
     private timeout;
-    private headers;
-    constructor(baseUrl: string, jwtToken: string, timeout?: number);
+    private apiBase;
+    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, {
@@ -102,20 +141,94 @@ 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;
+}
+
+interface VisitorRulesV2 {
+    format: 'segments+exts@v2';
+    include_extensions: string[];
+    include_filenames: string[];
+    exclude_dirnames: string[];
+}
+interface HealthStatus {
+    status: 'OK' | 'NOT_READY';
+    message: string;
+    frontends_loaded: number;
+    info: Record<string, string>;
+}
+interface ASTClientConfig {
+    baseUrl?: string;
+    timeout?: number;
+    jwtProvider: JWTProvider;
+}
+declare class ASTHttpClient {
+    private baseUrl;
+    private timeout;
+    private apiBase;
+    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;
+    };
+    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 { AuthHttpClient, RetrievalHttpClient, SyncHttpClient, 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 };