@zilliz/milvus2-sdk-node 2.3.5 → 2.4.0

package/README.md

@@ -1,8 +1,8 @@
 # Milvus2-sdk-node
 
 [![typescript](https://badges.aleen42.com/src/typescript.svg)](https://badges.aleen42.com/src/typescript.svg)
-[![version](https://img.shields.io/npm/v/@zilliz/milvus2-sdk-node?color=bright-green)](https://img.shields.io/npm/v/@zilliz/milvus2-sdk-node)
-[![downloads](https://img.shields.io/npm/dw/@zilliz/milvus2-sdk-node?color=bright-green)](https://img.shields.io/npm/dw/@zilliz/milvus2-sdk-node)
+[![version](https://img.shields.io/npm/v/@zilliz/milvus2-sdk-node?color=bright-green)](https://github.com/zilliztech/attu/releases)
+[![downloads](https://img.shields.io/npm/dw/@zilliz/milvus2-sdk-node?color=bright-green)](https://www.npmjs.com/package/@zilliz/milvus2-sdk-node)
 [![codecov](https://codecov.io/gh/milvus-io/milvus-sdk-node/branch/main/graph/badge.svg?token=Zu5FwWstwI)](https://codecov.io/gh/milvus-io/milvus-sdk-node)
 
 The official [Milvus](https://github.com/milvus-io/milvus) client for Node.js.
@@ -11,9 +11,11 @@ The official [Milvus](https://github.com/milvus-io/milvus) client for Node.js.
 
 The following table shows the recommended `@zilliz/milvus2-sdk-node` versions for different Milvus versions:
 
-| Milvus version | Node sdk version | Installation                        |
-| :------------: | :--------------: | :---------------------------------- |
-|    v2.2.0+     |    **latest**    | `yarn add @zilliz/milvus2-sdk-node` |
+| Milvus version | Node sdk version | Installation                               |
+| :------------: | :--------------: | :----------------------------------------- |
+|    v2.4.0+     |    **latest**    | `yarn add @zilliz/milvus2-sdk-node@latest` |
+|    v2.3.0+     |      v2.3.5      | `yarn add @zilliz/milvus2-sdk-node@2.3.5`  |
+|    v2.2.0+     |      v2.3.5      | `yarn add @zilliz/milvus2-sdk-node@2.3.5`  |
 
 ## Dependencies
 
@@ -31,21 +33,137 @@ npm install @zilliz/milvus2-sdk-node
 yarn add @zilliz/milvus2-sdk-node
 ```
 
-This will download the Milvus Node.js client and add a dependency entry in your package.json file.
+## What's new in v2.4.0
+
+### New vector data types: float16 and bfloat16
+
+Machine learning and neural networks often use half-precision data types, such as Float16 and BFloat16, [Milvus 2.4](https://milvus.io/docs/release_notes.md#Float16-and-BFloat16-Vector-DataType) supports inserting vectors in the BF16 and FP16 formats as bytes.
+
+> However, these data types are not natively available in the Node.js environment, To enable users to utilize these formats, the Node SDK provides support for transformers during insert, query, and search operations.
+>
+> There are four default transformers for performing a float32 to bytes transformation for BF16 and Float16 types: f32ArrayToF16Bytes, f16BytesToF32Array, f32ArrayToBf16Bytes, and bf16BytesToF32Array. If you wish to use your own transformers for Float16 and BFloat16, you can specify them.
+>
+> ```javascript
+> import {
+>   f32ArrayToF16Bytes,
+>   f16BytesToF32Array,
+>   f32ArrayToBf16Bytes,
+>   bf16BytesToF32Array,
+> } from '@zilliz/milvus2-sdk-node';
+>
+> //Insert float32 array for the float16 field. Node SDK will transform it to bytes using `f32ArrayToF16Bytes`. You can use your own transformer.
+> const insert = await milvusClient.insert({
+>   collection_name: COLLECTION_NAME,
+>   data: data,
+>   // transformers: {
+>   //  [DataType.BFloat16Vector]: f32ArrayToF16Bytes, // use your own transformer
+>   // },
+> });
+> // query: output float32 array other than bytes,
+> const query = await milvusClient.query({
+>   collection_name: COLLECTION_NAME,
+>   filter: 'id > 0',
+>   output_fields: ['vector', 'id'],
+>   // transformers: {
+>   // [DataType.BFloat16Vector]: bf16BytesToF32Array, // use your own transformer
+>   // },
+> });
+> // search: use bytes to search, output float32 array
+> const search = await milvusClient.search({
+>   vector: data[0].vector, // if you pass bytes, no transform will performed
+>   collection_name: COLLECTION_NAME,
+>   output_fields: ['id', 'vector'],
+>   limit: 5,
+>   // transformers: {
+>   //   [DataType.BFloat16Vector]: bf16BytesToF32Array, // use your own transformer
+>   // },
+> });
+> ```
+
+### New vector data types: sparse vector(beta)
+
+Sparse vectors in the Node SDK support four formats: `dict`, `coo`, `csr`, and `array`, However, query and search operations currently only output in the dict format.
 
-## Code Examples
+```javascript
+// dict
+const sparseObject = {
+  3: 1.5,
+  6: 2.0,
+  9: -3.5,
+};
+// coo
+const sparseCOO = [
+  { index: 2, value: 5 },
+  { index: 5, value: 3 },
+  { index: 8, value: 7 },
+];
+// csr
+const sparseCSR = {
+  indices: [2, 5, 8],
+  values: [5, 3, 7],
+};
+// array
+const sparseArray = [undefined, 0.0, 0.5, 0.3, undefined, 0.2];
+```
 
-### Milvus examples
+### Multi-vector and Hybrid Search
 
-You can find code examples in the [examples/milvus](./examples/milvus) directory. These examples cover various aspects of working with Milvus, such as connecting to Milvus, vector search, data query, dynamic schema, partition key, and database operations.
+Starting from Milvus 2.4, it supports [Multi-Vector Search](https://milvus.io/docs/multi-vector-search.md#API-overview), you can continue to utilize the search API with similar parameters to perform multi-vector searches, and the format of the results remains unchanged.
 
-### Langchain.js example
+```javascript
+// single-vector search on a collection with multiple vector fields
+const search = await milvusClient.search({
+  collection_name: collection_name,
+  data: [1, 2, 3, 4, 5, 6, 7, 8],
+  anns_field: 'vector', // required if you have multiple vector fields in the collection
+  params: { nprobe: 2 },
+  filter: 'id > 100',
+  limit: 5,
+});
 
-You can find a basic langchain.js example in the [examples/langchain](./examples/LangChain) directory.
+// multi-vector search on a collection with multiple vector fields
+const search = await milvusClient.search({
+  collection_name: collection_name,
+  data: [
+    {
+      data: [1, 2, 3, 4, 5, 6, 7, 8],
+      anns_field: 'vector',
+      params: { nprobe: 2 },
+    },
+    {
+      data: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16],
+      anns_field: 'vector1',
+    },
+  ],
+  limit: 5,
+  filter: 'id > 100',
+});
+```
+
+### New Typescript client
+
+Starting from v2.4.0, we introduced a TypeScript client to provide better support for the [Milvus RESTful API V2](https://milvus.io/api-reference/restful/v2.3.x/About.md), take a look at our [test file](https://github.com/milvus-io/milvus-sdk-node/blob/main/test/http/test.ts).
 
-### next.js example
+```javascript
+import { HttpClient } from '@zilliz/milvus2-sdk-node';
+const client = new HttpClient(config);
+await client.createCollection(params);
+await client.describeCollection(params);
+await client.listCollections(params);
+await client.insert(params);
+await client.upsert(params);
+await client.query(params);
+await client.search(params);
+```
 
-You can find nextjs app example in the [examples/nextjs](./examples/nextjs) directory.
+## Code Examples
+
+This table organizes the examples by technology, providing a brief description and the directory where each example can be found.
+| Technology | Example | Directory |
+|------------------|--------------------------------------------|-----------------------------------|
+| Next.js | Next.js app example | [examples/nextjs](./examples/nextjs) |
+| Node.js | Basic Node.js examples for Milvus | [examples/milvus](./examples/milvus) |
+| Langchain.js | Basic Langchain.js example | [examples/langchain](./examples/LangChain) |
 
 ## Basic usages
 
@@ -54,16 +172,14 @@ This guide will show you how to set up a simple application using Node.js and Mi
 ### Start a Milvus server
 
 ```shell
-# Download the milvus standalone yaml file
-$ wget https://github.com/milvus-io/milvus/releases/latest/download/milvus-standalone-docker-compose.yml -O docker-compose.yml
-
-# start the milvus server
-sudo docker-compose up -d
+# Start Milvus with script
+wget https://raw.githubusercontent.com/milvus-io/milvus/master/scripts/standalone_embed.sh
+bash standalone_embed.sh start
 ```
 
 ### Connect to Milvus
 
-Create a new app.js file and add the following code to try out some basic vector operations using the Milvus node.js client. More details on the [API reference](https://milvus.io/api-reference/node/v2.2.x/Client/MilvusClient.md).
+Create a new app.js file and add the following code to try out some basic vector operations using the Milvus node.js client. More details on the [API reference](https://milvus.io/api-reference/node/v2.3.x/Client/MilvusClient.md).
 
 ```javascript
 import { MilvusClient, DataType } from '@zilliz/milvus2-sdk-node';
@@ -82,7 +198,7 @@ In Milvus, the concept of the collection is like the table in traditional RDBMS,
 
 #### Define schema for collection
 
-A schema defines the fields of a collection, such as the names and data types of the fields that make up the vectors. More details of how to define schema and advanced usage can be found in [API reference](https://milvus.io/api-reference/node/v2.2.x/Collection/createCollection.md).
+A schema defines the fields of a collection, such as the names and data types of the fields that make up the vectors. More details of how to define schema and advanced usage can be found in [API reference](https://milvus.io/api-reference/node/v2.3.x/Collection/createCollection.md).
 
 ```javascript
 // define schema
@@ -128,31 +244,31 @@ The data format utilized by the Milvus Node SDK comprises an array of objects. I
 ```javascript
 const fields_data = [
   {
+    name: 'zlnmh',
     vector: [
       0.11878310581111173, 0.9694947902934701, 0.16443679307243175,
       0.5484226189097237, 0.9839246709011924, 0.5178387104937776,
       0.8716926129208069, 0.5616972243831446,
     ],
     height: 20405,
-    name: 'zlnmh',
   },
   {
+    name: '5lr9y',
     vector: [
       0.9992090731236536, 0.8248790611809487, 0.8660083940881405,
       0.09946359318481224, 0.6790698063908669, 0.5013786801063624,
       0.795311915725105, 0.9183033261617566,
     ],
     height: 93773,
-    name: '5lr9y',
   },
   {
+    name: 'nes0j',
     vector: [
       0.8761291569818763, 0.07127366044153227, 0.775648976160332,
       0.5619757601304878, 0.6076543120476996, 0.8373907516027586,
       0.8556140171597648, 0.4043893119391049,
     ],
     height: 85122,
-    name: 'nes0j',
   },
 ];
 ```
@@ -164,19 +280,18 @@ Once we have the data, you can insert data into the collection by calling the `i
 ```javascript
 await client.insert({
   collection_name,
-  fields_data,
+  data,
 });
 ```
 
-### Ceate index
+### Create index
 
 By creating an index and loading the collection into memory, you can improve the performance of search and retrieval operations in Milvus, making it faster and more efficient to work with large-scale datasets.
 
 ```javascript
 // create index
 await client.createIndex({
-  // required
-  collection_name,
+  collection_name, // required
   field_name: 'vector', // optional if you are using milvus v2.2.9+
   index_name: 'myindex', // optional
   index_type: 'HNSW', // optional if you are using milvus v2.2.9+
@@ -185,7 +300,7 @@ await client.createIndex({
 });
 ```
 
-Milvus supports [several different types of indexes](https://milvus.io/docs/index.md), each of which is optimized for different use cases and data distributions. Some of the most commonly used index types in Milvus include IVF_FLAT, IVF_SQ8, IVF_PQ, and HNSW. When creating an index in Milvus, you must choose an appropriate index type based on your specific use case and data distribution.
+Milvus supports [several different types of indexes](https://milvus.io/docs/index.md), each of which is optimized for different use cases and data distributions. Some of the most commonly used index types in Milvus include HNSW, IVF_FLAT, IVF_SQ8, IVF_PQ. When creating an index in Milvus, you must choose an appropriate index type based on your specific use case and data distribution.
 
 ### Load collection
 
@@ -210,22 +325,26 @@ const searchVector = fields_data[0].vector;
 const res = await client.search({
   // required
   collection_name, // required, the collection name
-  vector: searchVector, // required, vector used to compare other vectors in milvus
+  data: searchVector, // required, vector used to compare other vectors in milvus
   // optionals
-  filter: 'height > 0', // optional, filter
+  filter: 'height > 0', // optional, filter expression
   params: { nprobe: 64 }, // optional, specify the search parameters
   limit: 10, // optional, specify the number of nearest neighbors to return
-  metric_type: 'L2', // optional, metric to calculate similarity of two vectors
-  output_fields: ['height', 'name'], // optional, specify the fields to return in the search results
+  output_fields: ['height', 'name'], // optional, specify the fields to return in the search results,
 });
 ```
 
 ## Next Steps
 
+- [Attu, Using GUI to manage Milvus](https://github.com/zilliztech/attu)
+  ![<img src="[./.github/images/screenshot.png](https://github.com/zilliztech/attu/raw/main/.github/images/screenshot.png)" width="800" alt="attu home view" />
+](https://github.com/zilliztech/attu/raw/main/.github/images/screenshot.png)
+
+## other useful links
+
 - [What is Milvus](https://milvus.io/)
-- [Milvus Node SDK API reference](https://milvus.io/api-reference/node/v2.2.x/About.md)
-- [Attu, Milvus GUI tool, based on Milvus node.js SDK](https://github.com/zilliztech/attu)
-- [Feder, anns index visuliazation tool](https://github.com/zilliztech/feder)
+- [Milvus Node SDK API reference](https://milvus.io/api-reference/node/v2.3.x/About.md)
+- [Feder, anns index visualization tool](https://github.com/zilliztech/feder)
 
 ## How to contribute
 

package/dist/milvus/HttpClient.d.ts

@@ -30,6 +30,7 @@ export declare class HttpBaseClient {
         Authorization: string;
         Accept: string;
         ContentType: string;
+        'Accept-Type-Allow-Int64': string;
     };
     get fetch(): ((input: any, init?: any) => Promise<any>) | typeof fetch;
     POST<T>(url: string, data?: Record<string, any>, options?: FetchOptions): Promise<T>;
@@ -37,10 +38,157 @@ export declare class HttpBaseClient {
 }
 declare const HttpClient_base: {
     new (...args: any[]): {
+        readonly userPrefix: string;
+        createUser(params: import("./types").HttpUserCreateReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        updateUserPassword(params: import("./types").HttpUserUpdatePasswordReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        dropUser(param: import("./types").HttpUserBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        describeUser(param: import("./types").HttpUserBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<string[]>>;
+        listUsers(options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<string[]>>;
+        grantRoleToUser(params: import("./types").HttpUserRoleReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        revokeRoleFromUser(params: import("./types").HttpUserRoleReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        config: HttpClientConfig;
+        readonly baseURL: string;
+        readonly authorization: string;
+        readonly database: string;
+        readonly timeout: number;
+        readonly headers: {
+            Authorization: string;
+            Accept: string;
+            ContentType: string;
+            'Accept-Type-Allow-Int64': string;
+        };
+        readonly fetch: ((input: any, init?: any) => Promise<any>) | typeof fetch;
+        POST<T>(url: string, data?: Record<string, any>, options?: FetchOptions | undefined): Promise<T>;
+        GET<T_1>(url: string, params?: Record<string, any>, options?: FetchOptions | undefined): Promise<T_1>;
+    };
+} & {
+    new (...args: any[]): {
+        readonly rolePrefix: string;
+        listRoles(options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<string[]>>;
+        describeRole(params: import("./types").HttpRoleBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpRoleDescribeResponse>;
+        createRole(params: import("./types").HttpRoleBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        dropRole(params: import("./types").HttpRoleBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        grantPrivilegeToRole(params: import("./types").HttpRolePrivilegeReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        revokePrivilegeFromRole(params: import("./types").HttpRolePrivilegeReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        config: HttpClientConfig;
+        readonly baseURL: string;
+        readonly authorization: string;
+        readonly database: string;
+        readonly timeout: number;
+        readonly headers: {
+            Authorization: string;
+            Accept: string;
+            ContentType: string;
+            'Accept-Type-Allow-Int64': string;
+        };
+        readonly fetch: ((input: any, init?: any) => Promise<any>) | typeof fetch;
+        POST<T>(url: string, data?: Record<string, any>, options?: FetchOptions | undefined): Promise<T>;
+        GET<T_1>(url: string, params?: Record<string, any>, options?: FetchOptions | undefined): Promise<T_1>;
+    };
+} & {
+    new (...args: any[]): {
+        readonly indexPrefix: string;
+        createIndex(params: import("./types").HttpIndexCreateReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        dropIndex(params: import("./types").HttpIndexBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        describeIndex(params: import("./types").HttpIndexBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpIndexDescribeResponse>;
+        listIndexes(params: import("./types").HttpBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<string[]>>;
+        config: HttpClientConfig;
+        readonly baseURL: string;
+        readonly authorization: string;
+        readonly database: string;
+        readonly timeout: number;
+        readonly headers: {
+            Authorization: string;
+            Accept: string;
+            ContentType: string;
+            'Accept-Type-Allow-Int64': string;
+        };
+        readonly fetch: ((input: any, init?: any) => Promise<any>) | typeof fetch;
+        POST<T>(url: string, data?: Record<string, any>, options?: FetchOptions | undefined): Promise<T>;
+        GET<T_1>(url: string, params?: Record<string, any>, options?: FetchOptions | undefined): Promise<T_1>;
+    };
+} & {
+    new (...args: any[]): {
+        readonly importPrefix: string;
+        listImportJobs(params: import("./types").HttpBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpImportListResponse>;
+        createImportJobs(params: import("./types").HttpImportCreateReq, options?: FetchOptions | undefined): Promise<import("./types").HttpImportCreateResponse>;
+        getImportJobProgress(params: import("./types").HttpImportProgressReq, options?: FetchOptions | undefined): Promise<import("./types").HttpImportCreateResponse>;
+        config: HttpClientConfig;
+        readonly baseURL: string;
+        readonly authorization: string;
+        readonly database: string;
+        readonly timeout: number;
+        readonly headers: {
+            Authorization: string;
+            Accept: string;
+            ContentType: string;
+            'Accept-Type-Allow-Int64': string;
+        };
+        readonly fetch: ((input: any, init?: any) => Promise<any>) | typeof fetch;
+        POST<T>(url: string, data?: Record<string, any>, options?: FetchOptions | undefined): Promise<T>;
+        GET<T_1>(url: string, params?: Record<string, any>, options?: FetchOptions | undefined): Promise<T_1>;
+    };
+} & {
+    new (...args: any[]): {
+        readonly aliasPrefix: string;
+        listAliases(params: import("./types").HttpAliasBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<string[]>>;
+        createAlias(params: import("./types").HttpAliasCreateReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        describeAlias(params: import("./types").HttpAliasDescribeReq, options?: FetchOptions | undefined): Promise<import("./types").HttpAliasDescribeResponse>;
+        dropAlias(params: import("./types").HttpAliasDropReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        alterAlias(params: import("./types").HttpAliasCreateReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        config: HttpClientConfig;
+        readonly baseURL: string;
+        readonly authorization: string;
+        readonly database: string;
+        readonly timeout: number;
+        readonly headers: {
+            Authorization: string;
+            Accept: string;
+            ContentType: string;
+            'Accept-Type-Allow-Int64': string;
+        };
+        readonly fetch: ((input: any, init?: any) => Promise<any>) | typeof fetch;
+        POST<T>(url: string, data?: Record<string, any>, options?: FetchOptions | undefined): Promise<T>;
+        GET<T_1>(url: string, params?: Record<string, any>, options?: FetchOptions | undefined): Promise<T_1>;
+    };
+} & {
+    new (...args: any[]): {
+        readonly partitionPrefix: string;
+        listPartitions(params: import("./types").HttpBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<string[]>>;
+        createPartition(params: import("./types").HttpPartitionBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        dropPartition(params: import("./types").HttpPartitionBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        loadPartitions(params: import("./types").HttpPartitionListReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        releasePartitions(params: import("./types").HttpPartitionListReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        hasPartition(params: import("./types").HttpPartitionBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpPartitionHasResponse>;
+        getPartitionStatistics(params: import("./types").HttpPartitionBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpPartitionStatisticsResponse>;
+        config: HttpClientConfig;
+        readonly baseURL: string;
+        readonly authorization: string;
+        readonly database: string;
+        readonly timeout: number;
+        readonly headers: {
+            Authorization: string;
+            Accept: string;
+            ContentType: string;
+            'Accept-Type-Allow-Int64': string;
+        };
+        readonly fetch: ((input: any, init?: any) => Promise<any>) | typeof fetch;
+        POST<T>(url: string, data?: Record<string, any>, options?: FetchOptions | undefined): Promise<T>;
+        GET<T_1>(url: string, params?: Record<string, any>, options?: FetchOptions | undefined): Promise<T_1>;
+    };
+} & {
+    new (...args: any[]): {
+        readonly collectionPrefix: string;
         createCollection(data: import("./types").HttpCollectionCreateReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
         describeCollection(params: import("./types").HttpBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpCollectionDescribeResponse>;
         dropCollection(data: import("./types").HttpBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
         listCollections(params?: import("./types").HttpCollectionListReq, options?: FetchOptions | undefined): Promise<import("./types").HttpCollectionListResponse>;
+        hasCollection(params: Required<import("./types").HttpBaseReq>, options?: FetchOptions | undefined): Promise<import("./types").HttpCollectionHasResponse>;
+        renameCollection(params: import("./types").HttpCollectionRenameReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        getCollectionStatistics(params: import("./types").HttpBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpCollectionStatisticsResponse>;
+        loadCollection(params: import("./types").HttpBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        releaseCollection(params: import("./types").HttpBaseReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        getCollectionLoadState(params: import("./types").HttpCollectionLoadStateReq, options?: FetchOptions | undefined): Promise<import("./types").HttpCollectionLoadStateResponse>;
         config: HttpClientConfig;
         readonly baseURL: string;
         readonly authorization: string;
@@ -50,6 +198,7 @@ declare const HttpClient_base: {
             Authorization: string;
             Accept: string;
             ContentType: string;
+            'Accept-Type-Allow-Int64': string;
         };
         readonly fetch: ((input: any, init?: any) => Promise<any>) | typeof fetch;
         POST<T>(url: string, data?: Record<string, any>, options?: FetchOptions | undefined): Promise<T>;
@@ -57,9 +206,10 @@ declare const HttpClient_base: {
     };
 } & {
     new (...args: any[]): {
-        get(params: import("./types").HttpVectorGetReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
+        readonly vectorPrefix: string;
+        get(params: import("./types").HttpVectorGetReq, options?: FetchOptions | undefined): Promise<import("./types").HttpVectorQueryResponse>;
         insert(data: import("./types").HttpVectorInsertReq, options?: FetchOptions | undefined): Promise<import("./types").HttpVectorInsertResponse>;
-        upsert(data: import("./types").HttpVectorInsertReq, options?: FetchOptions | undefined): Promise<import("./types").HttpVectorInsertResponse>;
+        upsert(data: import("./types").HttpVectorInsertReq, options?: FetchOptions | undefined): Promise<import("./types").HttpVectorUpsertResponse>;
         query(data: import("./types").HttpVectorQueryReq, options?: FetchOptions | undefined): Promise<import("./types").HttpVectorQueryResponse>;
         search(data: import("./types").HttpVectorSearchReq, options?: FetchOptions | undefined): Promise<import("./types").HttpVectorSearchResponse>;
         delete(data: import("./types").HttpVectorDeleteReq, options?: FetchOptions | undefined): Promise<import("./types").HttpBaseResponse<{}>>;
@@ -72,12 +222,25 @@ declare const HttpClient_base: {
             Authorization: string;
             Accept: string;
             ContentType: string;
+            'Accept-Type-Allow-Int64': string;
         };
         readonly fetch: ((input: any, init?: any) => Promise<any>) | typeof fetch;
         POST<T>(url: string, data?: Record<string, any>, options?: FetchOptions | undefined): Promise<T>;
         GET<T_1>(url: string, params?: Record<string, any>, options?: FetchOptions | undefined): Promise<T_1>;
     };
 } & typeof HttpBaseClient;
+/**
+ * The HttpClient class extends the functionality
+ * of the HttpBaseClient class by mixing in the
+ * - Collection
+ * - Vector
+ * - Alias
+ * - Partition
+ * - MilvusIndex
+ * - Import
+ * - Role
+ * - User APIs.
+ */
 export declare class HttpClient extends HttpClient_base {
 }
 export {};

package/dist/milvus/HttpClient.js

@@ -46,7 +46,7 @@ class HttpBaseClient {
     // baseURL
     get baseURL() {
         return (this.config.baseURL ||
-            `${this.config.endpoint}/${this.config.version || const_1.DEFAULT_HTTP_ENDPOINT_VERSION}`);
+            `${this.config.endpoint}/${const_1.DEFAULT_HTTP_ENDPOINT_VERSION}`);
     }
     // authorization
     get authorization() {
@@ -72,6 +72,9 @@ class HttpBaseClient {
             Authorization: this.authorization,
             Accept: 'application/json',
             ContentType: 'application/json',
+            'Accept-Type-Allow-Int64': typeof this.config.acceptInt64 !== 'undefined'
+                ? this.config.acceptInt64.toString()
+                : 'false',
         };
     }
     // fetch
@@ -141,8 +144,19 @@ class HttpBaseClient {
     }
 }
 exports.HttpBaseClient = HttpBaseClient;
-// The HttpClient class extends the functionality of the HttpBaseClient class by mixing in the Collection and Vector APIs.
-class HttpClient extends (0, http_1.Collection)((0, http_1.Vector)(HttpBaseClient)) {
+/**
+ * The HttpClient class extends the functionality
+ * of the HttpBaseClient class by mixing in the
+ * - Collection
+ * - Vector
+ * - Alias
+ * - Partition
+ * - MilvusIndex
+ * - Import
+ * - Role
+ * - User APIs.
+ */
+class HttpClient extends (0, http_1.User)((0, http_1.Role)((0, http_1.MilvusIndex)((0, http_1.Import)((0, http_1.Alias)((0, http_1.Partition)((0, http_1.Collection)((0, http_1.Vector)(HttpBaseClient)))))))) {
 }
 exports.HttpClient = HttpClient;
 //# sourceMappingURL=HttpClient.js.map

package/dist/milvus/HttpClient.js.map

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

package/dist/milvus/MilvusClient.d.ts

@@ -1,5 +1,5 @@
 import { ChannelOptions } from '@grpc/grpc-js';
-import { GRPCClient, ClientConfig, CreateColReq, ResStatus, CreateCollectionReq } from '.';
+import { GRPCClient, ClientConfig, CreateColReq, ResStatus, CreateCollectionReq, CreateColWithSchemaAndIndexParamsReq } from '.';
 /**
  * Milvus Client class that extends GRPCClient and handles communication with Milvus server.
  */
@@ -25,8 +25,8 @@ export declare class MilvusClient extends GRPCClient {
     /**
      * Creates a new collection with the given parameters.
      * @function create_collection
-     * @param {CreateColReq} data - The data required to create the collection.
+     * @param {CreateColReq | CreateColWithSchemaAndIndexParamsReq | CreateCollectionReq} data - The data required to create the collection.
      * @returns {Promise<ResStatus>} - The result of the operation.
      */
-    createCollection(data: CreateColReq | CreateCollectionReq): Promise<ResStatus>;
+    createCollection(data: CreateColReq | CreateColWithSchemaAndIndexParamsReq | CreateCollectionReq): Promise<ResStatus>;
 }