@zilliz/milvus2-sdk-node 2.6.9 → 2.6.11-beta.0

package/dist/milvus/types/Search.d.ts

@@ -24,13 +24,14 @@ export interface SearchReq extends collectionNameReq {
     expr?: string;
     exprValues?: keyValueObj;
     search_params: SearchParam;
-    vectors: SearchData | SearchData[];
+    vectors?: SearchData | SearchData[];
     output_fields?: string[];
     travel_timestamp?: string;
     vector_type: DataType.BinaryVector | DataType.FloatVector;
     nq?: number;
     consistency_level?: ConsistencyLevelEnum;
     transformers?: OutputTransformers;
+    ids?: number[] | string[];
 }
 export interface FunctionScore {
     functions: FunctionObject[];
@@ -39,7 +40,7 @@ export interface FunctionScore {
 export interface SearchSimpleReq extends collectionNameReq {
     partition_names?: string[];
     anns_field?: string;
-    data: SearchData | SearchData[];
+    data?: SearchData | SearchData[];
     vector?: SearchData | SearchData[];
     output_fields?: string[];
     limit?: number;
@@ -60,6 +61,7 @@ export interface SearchSimpleReq extends collectionNameReq {
     transformers?: OutputTransformers;
     rerank?: RerankerObj | FunctionObject | FunctionScore;
     nq?: number;
+    ids?: number[] | string[];
 }
 export type HybridSearchSingleReq = Pick<SearchParam, 'anns_field' | 'ignore_growing' | 'group_by_field'> & {
     data: SearchData;

package/dist/milvus/types/Segments.d.ts

@@ -1,7 +1,10 @@
 import { SegmentState, SegmentLevel } from '../const';
 import { resStatusResponse, collectionNameReq, GrpcTimeOut } from './Common';
 export interface GetFlushStateReq extends GrpcTimeOut {
-    segmentIDs: number[];
+    segmentIDs?: number[];
+    flush_ts?: number;
+    db_name?: string;
+    collection_name?: string;
 }
 export interface FlushReq extends GrpcTimeOut {
     collection_names: string[];
@@ -25,6 +28,8 @@ export interface QuerySegmentInfo {
     state: SegmentState;
     nodeIds: number[];
     level: SegmentLevel;
+    is_sorted: boolean;
+    storage_version: number;
 }
 export interface GetQuerySegmentInfoResponse extends resStatusResponse {
     infos: QuerySegmentInfo[];
@@ -35,6 +40,9 @@ export interface PersistentSegmentInfo {
     partitionID: number;
     num_rows: number;
     state: SegmentState;
+    level: SegmentLevel;
+    is_sorted: boolean;
+    storage_version: number;
 }
 export interface GePersistentSegmentInfoResponse extends resStatusResponse {
     infos: PersistentSegmentInfo[];
@@ -53,6 +61,28 @@ export interface DescribeSegmentIndexDataResponse extends resStatusResponse {
     index_params: any;
     index_data: any;
 }
+export interface FlushAllReq extends GrpcTimeOut {
+    db_name?: string;
+}
+export interface FlushClusterInfo {
+    cluster_id: string;
+    cchannel: string;
+    pchannels: string[];
+}
+export interface FlushAllResponse extends resStatusResponse {
+    flush_all_ts: number;
+    flush_all_tss: Record<string, number>;
+    flush_all_msgs: Record<string, any>;
+    cluster_info: FlushClusterInfo;
+}
+export interface GetFlushAllStateReq extends GrpcTimeOut {
+    flush_all_ts?: number;
+    db_name?: string;
+    flush_all_tss?: Record<string, number>;
+}
+export interface GetFlushAllStateResponse extends resStatusResponse {
+    flushed: boolean;
+}
 export interface GetQuerySegmentInfoReq extends GrpcTimeOut {
     collectionName: string;
     dbName?: string;
@@ -65,4 +95,6 @@ export interface LoadBalanceReq extends GrpcTimeOut {
     src_nodeID: number;
     dst_nodeIDs?: number[];
     sealed_segmentIDs?: number[];
+    collectionName?: string;
+    db_name?: string;
 }

package/dist/milvus/types/index.d.ts

@@ -15,3 +15,4 @@ export * from './Segments';
 export * from './Insert';
 export * from './Search';
 export * from './DataTypes';
+export * from './GlobalCluster';

package/dist/milvus/types/index.js

@@ -32,4 +32,5 @@ __exportStar(require("./Segments"), exports);
 __exportStar(require("./Insert"), exports);
 __exportStar(require("./Search"), exports);
 __exportStar(require("./DataTypes"), exports);
+__exportStar(require("./GlobalCluster"), exports);
 //# sourceMappingURL=index.js.map

package/dist/milvus/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../milvus/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,eAAe;AACf,6CAA2B;AAC3B,+CAA6B;AAC7B,yCAAuB;AACvB,2CAAyB;AACzB,gDAA8B;AAC9B,8CAA4B;AAC5B,6CAA2B;AAC3B,yCAAuB;AACvB,6CAA2B;AAC3B,2CAAyB;AACzB,gDAA8B;AAC9B,8CAA4B;AAC5B,yCAAuB;AACvB,6CAA2B;AAC3B,2CAAyB;AACzB,2CAAyB;AACzB,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../milvus/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,eAAe;AACf,6CAA2B;AAC3B,+CAA6B;AAC7B,yCAAuB;AACvB,2CAAyB;AACzB,gDAA8B;AAC9B,8CAA4B;AAC5B,6CAA2B;AAC3B,yCAAuB;AACvB,6CAA2B;AAC3B,2CAAyB;AACzB,gDAA8B;AAC9B,8CAA4B;AAC5B,yCAAuB;AACvB,6CAA2B;AAC3B,2CAAyB;AACzB,2CAAyB;AACzB,8CAA4B;AAC5B,kDAAgC"}

package/dist/milvus/utils/Function.d.ts

@@ -1,14 +1,31 @@
 import { KeyValuePair, FieldSchema, SparseFloatVector, FieldData } from '../';
 import { Pool } from 'generic-pool';
 /**
- * Promisify a function call with optional timeout
- * @param obj - The object containing the target function
+ * Failover handler type for global cluster support.
+ * When attached to a pool, promisify will call this on UNAVAILABLE errors
+ * after all interceptor retries are exhausted.
+ * Should return a new pool to retry with, or null if no failover occurred.
+ */
+export type FailoverHandler = (error: any) => Promise<Pool<any> | null>;
+/** Well-known property key for attaching a failover handler to a pool. */
+export declare const FAILOVER_HANDLER_KEY = "__failoverHandler";
+/**
+ * Attach a failover handler to a pool for global cluster support.
+ */
+export declare function setPoolFailoverHandler(pool: Pool<any>, handler: FailoverHandler): void;
+/**
+ * Promisify a function call with optional timeout, metadata, and global cluster failover.
+ * @param pool - The pool of gRPC clients
  * @param target - The name of the target function to call
- * @param params - The parameters to pass to the target function
+ * @param params - The parameters to pass to the target function (may contain client_request_id or client-request-id)
  * @param timeout - Optional timeout in milliseconds
+ * @param requestMetadata - Optional metadata to include in the request (e.g., client-request-id). If not provided, will be extracted from params automatically.
  * @returns A Promise that resolves with the result of the target function call
  */
-export declare function promisify(pool: Pool<any>, target: string, params: any, timeout: number): Promise<any>;
+export declare function promisify(pool: Pool<any>, target: string, params: any, timeout: number, requestMetadata?: {
+    'client-request-id'?: string;
+    client_request_id?: string;
+}): Promise<any>;
 export declare const findKeyValue: (obj: KeyValuePair[], key: string) => string | number | undefined;
 export declare const sleep: (time: number) => Promise<unknown>;
 /**
@@ -34,3 +51,13 @@ export declare const getPKFieldExpr: (data: {
 }) => string;
 export declare const getSparseDim: (data: SparseFloatVector[]) => number;
 export declare const getValidDataArray: (data: FieldData[], length: number) => boolean[];
+/**
+ * Extracts request metadata (traceid) from request data.
+ * Supports both client_request_id and client-request-id formats.
+ * Priority: client_request_id > client-request-id (JavaScript/TypeScript convention)
+ * @param data - Request data that may contain traceid
+ * @returns Request metadata object or undefined if no traceid provided
+ */
+export declare const extractRequestMetadata: (data: any) => {
+    'client-request-id': string;
+} | undefined;

package/dist/milvus/utils/Function.js

@@ -9,33 +9,54 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getValidDataArray = exports.getSparseDim = exports.getPKFieldExpr = exports.getQueryIteratorExpr = exports.sleep = exports.findKeyValue = exports.promisify = void 0;
+exports.extractRequestMetadata = exports.getValidDataArray = exports.getSparseDim = exports.getPKFieldExpr = exports.getQueryIteratorExpr = exports.sleep = exports.findKeyValue = exports.promisify = exports.setPoolFailoverHandler = exports.FAILOVER_HANDLER_KEY = void 0;
 const __1 = require("../");
+const logger_1 = require("./logger");
+const grpc_js_1 = require("@grpc/grpc-js");
+/** Well-known property key for attaching a failover handler to a pool. */
+exports.FAILOVER_HANDLER_KEY = '__failoverHandler';
 /**
- * Promisify a function call with optional timeout
- * @param obj - The object containing the target function
- * @param target - The name of the target function to call
- * @param params - The parameters to pass to the target function
- * @param timeout - Optional timeout in milliseconds
- * @returns A Promise that resolves with the result of the target function call
+ * Attach a failover handler to a pool for global cluster support.
  */
-function promisify(pool, target, params, timeout) {
-    return __awaiter(this, void 0, void 0, function* () {
-        // Calculate the deadline for the function call
-        const t = timeout === 0 ? 1000 * 60 * 60 * 24 : timeout;
-        // get client
+function setPoolFailoverHandler(pool, handler) {
+    pool[exports.FAILOVER_HANDLER_KEY] = handler;
+}
+exports.setPoolFailoverHandler = setPoolFailoverHandler;
+/**
+ * Check if an error is a gRPC UNAVAILABLE error.
+ */
+function isUnavailableError(err) {
+    return err && err.code === grpc_js_1.status.UNAVAILABLE;
+}
+/**
+ * Execute a single gRPC call via the pool.
+ */
+function executeCall(pool, target, params, timeout, requestMetadata) {
+    const t = timeout === 0 ? 1000 * 60 * 60 * 24 : timeout;
+    return (() => __awaiter(this, void 0, void 0, function* () {
         const client = yield pool.acquire();
-        // Create a new Promise that wraps the target function call
+        let finalRequestMetadata = requestMetadata;
+        if (!finalRequestMetadata && params) {
+            finalRequestMetadata = (0, exports.extractRequestMetadata)(params);
+        }
+        const metadata = finalRequestMetadata ? new grpc_js_1.Metadata() : undefined;
+        if (metadata && finalRequestMetadata) {
+            const clientRequestId = getClientRequestId(finalRequestMetadata);
+            if (clientRequestId) {
+                metadata.add(__1.METADATA.CLIENT_REQUEST_ID, String(clientRequestId));
+            }
+        }
         return new Promise((resolve, reject) => {
             try {
-                // Call the target function with the provided parameters and deadline
-                client[target](params, { deadline: new Date(Date.now() + t) }, (err, result) => {
+                const callOptions = { deadline: new Date(Date.now() + t) };
+                if (metadata) {
+                    callOptions.metadata = metadata;
+                }
+                client[target](params, callOptions, (err, result) => {
                     if (err) {
-                        // If there was an error, reject the Promise with the error
                         reject(err);
                     }
                     else {
-                        // Otherwise, resolve the Promise with the result
                         resolve(result);
                     }
                     if (client) {
@@ -50,6 +71,36 @@ function promisify(pool, target, params, timeout) {
                 }
             }
         });
+    }))();
+}
+/**
+ * Promisify a function call with optional timeout, metadata, and global cluster failover.
+ * @param pool - The pool of gRPC clients
+ * @param target - The name of the target function to call
+ * @param params - The parameters to pass to the target function (may contain client_request_id or client-request-id)
+ * @param timeout - Optional timeout in milliseconds
+ * @param requestMetadata - Optional metadata to include in the request (e.g., client-request-id). If not provided, will be extracted from params automatically.
+ * @returns A Promise that resolves with the result of the target function call
+ */
+function promisify(pool, target, params, timeout, requestMetadata) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            return yield executeCall(pool, target, params, timeout, requestMetadata);
+        }
+        catch (error) {
+            // Check for global cluster failover handler
+            const handler = pool[exports.FAILOVER_HANDLER_KEY];
+            if (handler && isUnavailableError(error)) {
+                logger_1.logger.debug(`\x1b[36m[Global]\x1b[0m UNAVAILABLE error on \x1b[1m${target}\x1b[0m, triggering failover handler`);
+                const newPool = yield handler(error);
+                if (newPool) {
+                    logger_1.logger.debug(`\x1b[36m[Global]\x1b[0m Failover complete, retrying \x1b[1m${target}\x1b[0m with new pool`);
+                    // Retry once with the new pool (after failover)
+                    return yield executeCall(newPool, target, params, timeout, requestMetadata);
+                }
+            }
+            throw error;
+        }
     });
 }
 exports.promisify = promisify;
@@ -122,4 +173,31 @@ const getValidDataArray = (data, length) => {
     });
 };
 exports.getValidDataArray = getValidDataArray;
+/**
+ * Extracts client request ID from metadata object with priority handling.
+ * Priority: client_request_id > client-request-id (JavaScript/TypeScript convention)
+ * @param metadata - Metadata object that may contain traceid
+ * @returns Client request ID as string or undefined if not found
+ */
+const getClientRequestId = (metadata) => {
+    if (!metadata) {
+        return undefined;
+    }
+    // Priority: client_request_id > client-request-id (JavaScript/TypeScript convention)
+    return metadata.client_request_id || metadata['client-request-id'];
+};
+/**
+ * Extracts request metadata (traceid) from request data.
+ * Supports both client_request_id and client-request-id formats.
+ * Priority: client_request_id > client-request-id (JavaScript/TypeScript convention)
+ * @param data - Request data that may contain traceid
+ * @returns Request metadata object or undefined if no traceid provided
+ */
+const extractRequestMetadata = (data) => {
+    const clientRequestId = getClientRequestId(data);
+    return clientRequestId
+        ? { 'client-request-id': String(clientRequestId) }
+        : undefined;
+};
+exports.extractRequestMetadata = extractRequestMetadata;
 //# sourceMappingURL=Function.js.map

package/dist/milvus/utils/Function.js.map

@@ -1 +1 @@
-{"version":3,"file":"Function.js","sourceRoot":"","sources":["../../../milvus/utils/Function.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Function.js","sourceRoot":"","sources":["../../../milvus/utils/Function.ts"],"names":[],"mappings":"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"}

package/dist/milvus/utils/GlobalTopology.d.ts

@@ -0,0 +1,56 @@
+import { ClusterCapability, ClusterInfo, GlobalTopology } from '../types/GlobalCluster';
+export { ClusterCapability, ClusterInfo, GlobalTopology };
+export declare const GLOBAL_CLUSTER_IDENTIFIER = "global-cluster";
+export declare const DEFAULT_REFRESH_INTERVAL = 300000;
+/**
+ * Check if a ClusterInfo is the primary (writable) cluster.
+ */
+export declare function isPrimaryCluster(cluster: ClusterInfo): boolean;
+/**
+ * Get the primary cluster from a topology.
+ * @throws Error if no primary cluster is found.
+ */
+export declare function getPrimaryCluster(topology: GlobalTopology): ClusterInfo;
+/**
+ * Check if the URI points to a global cluster endpoint.
+ */
+export declare function isGlobalEndpoint(uri: string): boolean;
+/**
+ * Fetch the global cluster topology from the REST API.
+ *
+ * @param globalEndpoint - The global cluster endpoint URL
+ * @param token - Authentication token
+ * @returns GlobalTopology object containing cluster information
+ * @throws Error if topology cannot be fetched after retries
+ */
+export declare function fetchTopology(globalEndpoint: string, token: string): Promise<GlobalTopology>;
+/**
+ * Background refresher that periodically fetches the global cluster topology.
+ */
+export declare class TopologyRefresher {
+    private globalEndpoint;
+    private token;
+    private topology;
+    private refreshInterval;
+    private onTopologyChange?;
+    private intervalId;
+    private refreshing;
+    constructor(options: {
+        globalEndpoint: string;
+        token: string;
+        topology: GlobalTopology;
+        refreshInterval?: number;
+        onTopologyChange?: (topology: GlobalTopology) => void;
+    });
+    /** Start the background refresh interval. */
+    start(): void;
+    /** Stop the background refresh interval. */
+    stop(): void;
+    /** Check if the refresher is running. */
+    isRunning(): boolean;
+    /** Get the current topology. */
+    getTopology(): GlobalTopology;
+    /** Trigger an immediate topology refresh (debounced). */
+    triggerRefresh(): void;
+    private tryRefresh;
+}

package/dist/milvus/utils/GlobalTopology.js

@@ -0,0 +1,215 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopologyRefresher = exports.fetchTopology = exports.isGlobalEndpoint = exports.getPrimaryCluster = exports.isPrimaryCluster = exports.DEFAULT_REFRESH_INTERVAL = exports.GLOBAL_CLUSTER_IDENTIFIER = exports.ClusterCapability = void 0;
+const logger_1 = require("./logger");
+const GlobalCluster_1 = require("../types/GlobalCluster");
+Object.defineProperty(exports, "ClusterCapability", { enumerable: true, get: function () { return GlobalCluster_1.ClusterCapability; } });
+// Identifier used in URIs to detect global cluster endpoints
+exports.GLOBAL_CLUSTER_IDENTIFIER = 'global-cluster';
+// Retry constants for topology fetch
+const MAX_RETRIES = 3;
+const BASE_DELAY = 1000; // ms
+const MAX_DELAY = 10000; // ms
+const REQUEST_TIMEOUT = 10000; // ms
+// Default refresh interval for topology refresher
+exports.DEFAULT_REFRESH_INTERVAL = 300000; // 5 minutes in ms
+/**
+ * Check if a ClusterInfo is the primary (writable) cluster.
+ */
+function isPrimaryCluster(cluster) {
+    return (cluster.capability & GlobalCluster_1.ClusterCapability.WRITABLE) !== 0;
+}
+exports.isPrimaryCluster = isPrimaryCluster;
+/**
+ * Get the primary cluster from a topology.
+ * @throws Error if no primary cluster is found.
+ */
+function getPrimaryCluster(topology) {
+    const primary = topology.clusters.find(isPrimaryCluster);
+    if (!primary) {
+        throw new Error('No primary cluster found in topology');
+    }
+    return primary;
+}
+exports.getPrimaryCluster = getPrimaryCluster;
+/**
+ * Check if the URI points to a global cluster endpoint.
+ */
+function isGlobalEndpoint(uri) {
+    if (!uri)
+        return false;
+    return uri.toLowerCase().includes(exports.GLOBAL_CLUSTER_IDENTIFIER);
+}
+exports.isGlobalEndpoint = isGlobalEndpoint;
+/**
+ * Parse the topology response from the REST API.
+ */
+function parseTopologyResponse(data) {
+    return {
+        version: parseInt(data.version, 10),
+        clusters: data.clusters.map(c => ({
+            clusterId: c.clusterId,
+            endpoint: c.endpoint,
+            capability: c.capability,
+        })),
+    };
+}
+/**
+ * Fetch the global cluster topology from the REST API.
+ *
+ * @param globalEndpoint - The global cluster endpoint URL
+ * @param token - Authentication token
+ * @returns GlobalTopology object containing cluster information
+ * @throws Error if topology cannot be fetched after retries
+ */
+function fetchTopology(globalEndpoint, token) {
+    var _a, _b;
+    return __awaiter(this, void 0, void 0, function* () {
+        // Build the topology URL
+        let endpoint = globalEndpoint.replace(/\/+$/, '');
+        if (!endpoint.startsWith('http://') && !endpoint.startsWith('https://')) {
+            endpoint = `https://${endpoint}`;
+        }
+        const url = `${endpoint}/${exports.GLOBAL_CLUSTER_IDENTIFIER}/topology`;
+        const headers = {
+            Authorization: `Bearer ${token}`,
+        };
+        logger_1.logger.debug(`\x1b[36m[Global]\x1b[0m Fetching topology from ${url}`);
+        let lastError = null;
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT);
+                const response = yield fetch(url, {
+                    headers,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (!response.ok) {
+                    const text = yield response.text();
+                    const err = new Error(`Topology request failed with status ${response.status}: ${text}`);
+                    // Only retry on 5xx server errors; 4xx are permanent (auth, bad request, etc.)
+                    if (response.status >= 400 && response.status < 500) {
+                        logger_1.logger.debug(`\x1b[36m[Global]\x1b[0m Topology fetch failed with ${response.status} (not retryable)`);
+                        throw err;
+                    }
+                    throw Object.assign(err, { retryable: true });
+                }
+                const result = yield response.json();
+                if (result.code !== undefined && result.code !== 0) {
+                    // API-level error, don't retry
+                    logger_1.logger.debug(`\x1b[36m[Global]\x1b[0m Topology API error code=${result.code}: ${result.message}`);
+                    throw new Error(result.message || 'Unknown API error');
+                }
+                const topology = parseTopologyResponse(result.data);
+                logger_1.logger.debug(`\x1b[36m[Global]\x1b[0m Topology fetched: version=${topology.version}, clusters=${topology.clusters.length}, primary=${((_a = topology.clusters.find(c => isPrimaryCluster(c))) === null || _a === void 0 ? void 0 : _a.endpoint) || 'none'}`);
+                return topology;
+            }
+            catch (e) {
+                // Only retry network errors, timeouts, and 5xx errors
+                if (!e.retryable && e.name !== 'AbortError' && !((_b = e.message) === null || _b === void 0 ? void 0 : _b.includes('fetch failed'))) {
+                    throw e;
+                }
+                lastError = e;
+                if (attempt < MAX_RETRIES - 1) {
+                    const delay = Math.min(BASE_DELAY * Math.pow(2, attempt), MAX_DELAY);
+                    const jitter = delay * 0.1 * Math.random();
+                    logger_1.logger.warn(`Topology fetch attempt ${attempt + 1} failed: ${e.message}. Retrying in ${(delay + jitter).toFixed(0)}ms`);
+                    yield new Promise(resolve => setTimeout(resolve, delay + jitter));
+                }
+            }
+        }
+        throw new Error(`Failed to fetch global topology after ${MAX_RETRIES} attempts: ${lastError === null || lastError === void 0 ? void 0 : lastError.message}`);
+    });
+}
+exports.fetchTopology = fetchTopology;
+/**
+ * Background refresher that periodically fetches the global cluster topology.
+ */
+class TopologyRefresher {
+    constructor(options) {
+        var _a;
+        this.intervalId = null;
+        this.refreshing = false;
+        this.globalEndpoint = options.globalEndpoint;
+        this.token = options.token;
+        this.topology = options.topology;
+        this.refreshInterval =
+            (_a = options.refreshInterval) !== null && _a !== void 0 ? _a : exports.DEFAULT_REFRESH_INTERVAL;
+        this.onTopologyChange = options.onTopologyChange;
+    }
+    /** Start the background refresh interval. */
+    start() {
+        if (this.intervalId !== null)
+            return;
+        logger_1.logger.debug(`\x1b[36m[Global]\x1b[0m TopologyRefresher started, interval=${this.refreshInterval}ms`);
+        this.intervalId = setInterval(() => this.tryRefresh(), this.refreshInterval);
+        // Allow the Node.js process to exit even if the interval is still running
+        if (this.intervalId && typeof this.intervalId === 'object' && 'unref' in this.intervalId) {
+            this.intervalId.unref();
+        }
+    }
+    /** Stop the background refresh interval. */
+    stop() {
+        if (this.intervalId !== null) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+            logger_1.logger.debug(`\x1b[36m[Global]\x1b[0m TopologyRefresher stopped`);
+        }
+    }
+    /** Check if the refresher is running. */
+    isRunning() {
+        return this.intervalId !== null;
+    }
+    /** Get the current topology. */
+    getTopology() {
+        return this.topology;
+    }
+    /** Trigger an immediate topology refresh (debounced). */
+    triggerRefresh() {
+        if (this.refreshing) {
+            logger_1.logger.debug(`\x1b[36m[Global]\x1b[0m Topology refresh already in progress, skipping`);
+            return;
+        }
+        logger_1.logger.debug(`\x1b[36m[Global]\x1b[0m Triggering immediate topology refresh`);
+        this.refreshing = true;
+        this.tryRefresh().finally(() => {
+            this.refreshing = false;
+        });
+    }
+    tryRefresh() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const newTopology = yield fetchTopology(this.globalEndpoint, this.token);
+                if (newTopology.version > this.topology.version) {
+                    const oldVersion = this.topology.version;
+                    this.topology = newTopology;
+                    logger_1.logger.info(`Topology updated: version ${oldVersion} -> ${newTopology.version}`);
+                    if (this.onTopologyChange) {
+                        try {
+                            this.onTopologyChange(newTopology);
+                        }
+                        catch (_a) {
+                            logger_1.logger.warn('Topology change callback failed');
+                        }
+                    }
+                }
+            }
+            catch (_b) {
+                logger_1.logger.warn('Topology refresh failed');
+                // Keep using cached topology, will retry next interval
+            }
+        });
+    }
+}
+exports.TopologyRefresher = TopologyRefresher;
+//# sourceMappingURL=GlobalTopology.js.map

package/dist/milvus/utils/GlobalTopology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalTopology.js","sourceRoot":"","sources":["../../../milvus/utils/GlobalTopology.ts"],"names":[],"mappings":"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"}

package/dist/milvus/utils/Grpc.d.ts

@@ -32,6 +32,12 @@ export declare const getRetryInterceptor: ({ maxRetries, retryDelay, clientId, }
     retryDelay: number;
     clientId: string;
 }) => (options: any, nextCall: any) => InterceptingCall;
+/**
+ * Returns a gRPC interceptor function that adds request-level metadata to outgoing requests.
+ * This interceptor automatically adds client-request-unixmsec timestamp to every request.
+ * The client-request-id should be passed via promisify's requestMetadata parameter.
+ */
+export declare const getRequestMetadataInterceptor: () => (options: any, nextCall: any) => InterceptingCall;
 /**
  * Returns a gRPC interceptor function that adds trace context to outgoing requests.
  */