@google-cloud/vectorsearch 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/README.md +22 -0
  2. package/build/protos/google/cloud/vectorsearch/v1/common.proto +37 -0
  3. package/build/protos/google/cloud/vectorsearch/v1/data_object.proto +95 -0
  4. package/build/protos/google/cloud/vectorsearch/v1/data_object_search_service.proto +449 -0
  5. package/build/protos/google/cloud/vectorsearch/v1/data_object_service.proto +242 -0
  6. package/build/protos/google/cloud/vectorsearch/v1/embedding_config.proto +74 -0
  7. package/build/protos/google/cloud/vectorsearch/v1/vectorsearch_service.proto +707 -0
  8. package/build/protos/protos.d.ts +7118 -0
  9. package/build/protos/protos.js +17345 -0
  10. package/build/protos/protos.json +2110 -0
  11. package/build/src/index.d.ts +12 -10
  12. package/build/src/index.js +7 -5
  13. package/build/src/index.js.map +1 -1
  14. package/build/src/v1/data_object_search_service_client.d.ts +583 -0
  15. package/build/src/v1/data_object_search_service_client.js +855 -0
  16. package/build/src/v1/data_object_search_service_client.js.map +1 -0
  17. package/build/src/v1/data_object_search_service_client_config.json +58 -0
  18. package/build/src/v1/data_object_search_service_proto_list.json +8 -0
  19. package/build/src/v1/data_object_service_client.d.ts +490 -0
  20. package/build/src/v1/data_object_service_client.js +767 -0
  21. package/build/src/v1/data_object_service_client.js.map +1 -0
  22. package/build/src/v1/data_object_service_client_config.json +73 -0
  23. package/build/src/v1/data_object_service_proto_list.json +8 -0
  24. package/build/src/v1/gapic_metadata.json +277 -0
  25. package/build/src/v1/index.d.ts +3 -0
  26. package/build/src/v1/index.js +27 -0
  27. package/build/src/v1/index.js.map +1 -0
  28. package/build/src/v1/vector_search_service_client.d.ts +1021 -0
  29. package/build/src/v1/vector_search_service_client.js +1387 -0
  30. package/build/src/v1/vector_search_service_client.js.map +1 -0
  31. package/build/src/v1/vector_search_service_client_config.json +88 -0
  32. package/build/src/v1/vector_search_service_proto_list.json +8 -0
  33. package/package.json +1 -1
@@ -1,16 +1,18 @@
1
+ import * as v1 from './v1';
1
2
  import * as v1beta from './v1beta';
2
- declare const DataObjectSearchServiceClient: typeof v1beta.DataObjectSearchServiceClient;
3
- type DataObjectSearchServiceClient = v1beta.DataObjectSearchServiceClient;
4
- declare const DataObjectServiceClient: typeof v1beta.DataObjectServiceClient;
5
- type DataObjectServiceClient = v1beta.DataObjectServiceClient;
6
- declare const VectorSearchServiceClient: typeof v1beta.VectorSearchServiceClient;
7
- type VectorSearchServiceClient = v1beta.VectorSearchServiceClient;
8
- export { v1beta, DataObjectSearchServiceClient, DataObjectServiceClient, VectorSearchServiceClient };
3
+ declare const DataObjectSearchServiceClient: typeof v1.DataObjectSearchServiceClient;
4
+ type DataObjectSearchServiceClient = v1.DataObjectSearchServiceClient;
5
+ declare const DataObjectServiceClient: typeof v1.DataObjectServiceClient;
6
+ type DataObjectServiceClient = v1.DataObjectServiceClient;
7
+ declare const VectorSearchServiceClient: typeof v1.VectorSearchServiceClient;
8
+ type VectorSearchServiceClient = v1.VectorSearchServiceClient;
9
+ export { v1, v1beta, DataObjectSearchServiceClient, DataObjectServiceClient, VectorSearchServiceClient };
9
10
  declare const _default: {
11
+ v1: typeof v1;
10
12
  v1beta: typeof v1beta;
11
- DataObjectSearchServiceClient: typeof v1beta.DataObjectSearchServiceClient;
12
- DataObjectServiceClient: typeof v1beta.DataObjectServiceClient;
13
- VectorSearchServiceClient: typeof v1beta.VectorSearchServiceClient;
13
+ DataObjectSearchServiceClient: typeof v1.DataObjectSearchServiceClient;
14
+ DataObjectServiceClient: typeof v1.DataObjectServiceClient;
15
+ VectorSearchServiceClient: typeof v1.VectorSearchServiceClient;
14
16
  };
15
17
  export default _default;
16
18
  import * as protos from '../protos/protos';
@@ -17,16 +17,18 @@
17
17
  // ** https://github.com/googleapis/synthtool **
18
18
  // ** All changes to this file may be overwritten. **
19
19
  Object.defineProperty(exports, "__esModule", { value: true });
20
- exports.protos = exports.VectorSearchServiceClient = exports.DataObjectServiceClient = exports.DataObjectSearchServiceClient = exports.v1beta = void 0;
20
+ exports.protos = exports.VectorSearchServiceClient = exports.DataObjectServiceClient = exports.DataObjectSearchServiceClient = exports.v1beta = exports.v1 = void 0;
21
+ const v1 = require("./v1");
22
+ exports.v1 = v1;
21
23
  const v1beta = require("./v1beta");
22
24
  exports.v1beta = v1beta;
23
- const DataObjectSearchServiceClient = v1beta.DataObjectSearchServiceClient;
25
+ const DataObjectSearchServiceClient = v1.DataObjectSearchServiceClient;
24
26
  exports.DataObjectSearchServiceClient = DataObjectSearchServiceClient;
25
- const DataObjectServiceClient = v1beta.DataObjectServiceClient;
27
+ const DataObjectServiceClient = v1.DataObjectServiceClient;
26
28
  exports.DataObjectServiceClient = DataObjectServiceClient;
27
- const VectorSearchServiceClient = v1beta.VectorSearchServiceClient;
29
+ const VectorSearchServiceClient = v1.VectorSearchServiceClient;
28
30
  exports.VectorSearchServiceClient = VectorSearchServiceClient;
29
- exports.default = { v1beta, DataObjectSearchServiceClient, DataObjectServiceClient, VectorSearchServiceClient };
31
+ exports.default = { v1, v1beta, DataObjectSearchServiceClient, DataObjectServiceClient, VectorSearchServiceClient };
30
32
  const protos = require("../protos/protos");
31
33
  exports.protos = protos;
32
34
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,4BAA4B;AAC5B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,EAAE;AACF,2DAA2D;AAC3D,gDAAgD;AAChD,qDAAqD;;;AAErD,mCAAmC;AAS3B,wBAAM;AAPd,MAAM,6BAA6B,GAAG,MAAM,CAAC,6BAA6B,CAAC;AAO3D,sEAA6B;AAL7C,MAAM,uBAAuB,GAAG,MAAM,CAAC,uBAAuB,CAAC;AAKhB,0DAAuB;AAHtE,MAAM,yBAAyB,GAAG,MAAM,CAAC,yBAAyB,CAAC;AAGK,8DAAyB;AACjG,kBAAe,EAAC,MAAM,EAAE,6BAA6B,EAAE,uBAAuB,EAAE,yBAAyB,EAAC,CAAC;AAC3G,2CAA2C;AACnC,wBAAM"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,4BAA4B;AAC5B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,EAAE;AACF,2DAA2D;AAC3D,gDAAgD;AAChD,qDAAqD;;;AAErD,2BAA2B;AAUnB,gBAAE;AATV,mCAAmC;AASvB,wBAAM;AAPlB,MAAM,6BAA6B,GAAG,EAAE,CAAC,6BAA6B,CAAC;AAOnD,sEAA6B;AALjD,MAAM,uBAAuB,GAAG,EAAE,CAAC,uBAAuB,CAAC;AAKR,0DAAuB;AAH1E,MAAM,yBAAyB,GAAG,EAAE,CAAC,yBAAyB,CAAC;AAGa,8DAAyB;AACrG,kBAAe,EAAC,EAAE,EAAE,MAAM,EAAE,6BAA6B,EAAE,uBAAuB,EAAE,yBAAyB,EAAC,CAAC;AAC/G,2CAA2C;AACnC,wBAAM"}
@@ -0,0 +1,583 @@
1
+ import type * as gax from 'google-gax';
2
+ import type { Callback, CallOptions, Descriptors, ClientOptions, PaginationCallback, LocationsClient, LocationProtos } from 'google-gax';
3
+ import { Transform } from 'stream';
4
+ import * as protos from '../../protos/protos';
5
+ /**
6
+ * Service for searching data objects.
7
+ * @class
8
+ * @memberof v1
9
+ */
10
+ export declare class DataObjectSearchServiceClient {
11
+ private _terminated;
12
+ private _opts;
13
+ private _providedCustomServicePath;
14
+ private _gaxModule;
15
+ private _gaxGrpc;
16
+ private _protos;
17
+ private _defaults;
18
+ private _universeDomain;
19
+ private _servicePath;
20
+ private _log;
21
+ auth: gax.GoogleAuth;
22
+ descriptors: Descriptors;
23
+ warn: (code: string, message: string, warnType?: string) => void;
24
+ innerApiCalls: {
25
+ [name: string]: Function;
26
+ };
27
+ locationsClient: LocationsClient;
28
+ pathTemplates: {
29
+ [name: string]: gax.PathTemplate;
30
+ };
31
+ dataObjectSearchServiceStub?: Promise<{
32
+ [name: string]: Function;
33
+ }>;
34
+ /**
35
+ * Construct an instance of DataObjectSearchServiceClient.
36
+ *
37
+ * @param {object} [options] - The configuration object.
38
+ * The options accepted by the constructor are described in detail
39
+ * in [this document](https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#creating-the-client-instance).
40
+ * The common options are:
41
+ * @param {object} [options.credentials] - Credentials object.
42
+ * @param {string} [options.credentials.client_email]
43
+ * @param {string} [options.credentials.private_key]
44
+ * @param {string} [options.email] - Account email address. Required when
45
+ * using a .pem or .p12 keyFilename.
46
+ * @param {string} [options.keyFilename] - Full path to the a .json, .pem, or
47
+ * .p12 key downloaded from the Google Developers Console. If you provide
48
+ * a path to a JSON file, the projectId option below is not necessary.
49
+ * NOTE: .pem and .p12 require you to specify options.email as well.
50
+ * @param {number} [options.port] - The port on which to connect to
51
+ * the remote host.
52
+ * @param {string} [options.projectId] - The project ID from the Google
53
+ * Developer's Console, e.g. 'grape-spaceship-123'. We will also check
54
+ * the environment variable GCLOUD_PROJECT for your project ID. If your
55
+ * app is running in an environment which supports
56
+ * {@link https://cloud.google.com/docs/authentication/application-default-credentials Application Default Credentials},
57
+ * your project ID will be detected automatically.
58
+ * @param {string} [options.apiEndpoint] - The domain name of the
59
+ * API remote host.
60
+ * @param {gax.ClientConfig} [options.clientConfig] - Client configuration override.
61
+ * Follows the structure of {@link gapicConfig}.
62
+ * @param {boolean} [options.fallback] - Use HTTP/1.1 REST mode.
63
+ * For more information, please check the
64
+ * {@link https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#http11-rest-api-mode documentation}.
65
+ * @param {gax} [gaxInstance]: loaded instance of `google-gax`. Useful if you
66
+ * need to avoid loading the default gRPC version and want to use the fallback
67
+ * HTTP implementation. Load only fallback version and pass it to the constructor:
68
+ * ```
69
+ * const gax = require('google-gax/build/src/fallback'); // avoids loading google-gax with gRPC
70
+ * const client = new DataObjectSearchServiceClient({fallback: true}, gax);
71
+ * ```
72
+ */
73
+ constructor(opts?: ClientOptions, gaxInstance?: typeof gax | typeof gax.fallback);
74
+ /**
75
+ * Initialize the client.
76
+ * Performs asynchronous operations (such as authentication) and prepares the client.
77
+ * This function will be called automatically when any class method is called for the
78
+ * first time, but if you need to initialize it before calling an actual method,
79
+ * feel free to call initialize() directly.
80
+ *
81
+ * You can await on this method if you want to make sure the client is initialized.
82
+ *
83
+ * @returns {Promise} A promise that resolves to an authenticated service stub.
84
+ */
85
+ initialize(): Promise<{
86
+ [name: string]: Function;
87
+ }>;
88
+ /**
89
+ * The DNS address for this API service.
90
+ * @deprecated Use the apiEndpoint method of the client instance.
91
+ * @returns {string} The DNS address for this service.
92
+ */
93
+ static get servicePath(): string;
94
+ /**
95
+ * The DNS address for this API service - same as servicePath.
96
+ * @deprecated Use the apiEndpoint method of the client instance.
97
+ * @returns {string} The DNS address for this service.
98
+ */
99
+ static get apiEndpoint(): string;
100
+ /**
101
+ * The DNS address for this API service.
102
+ * @returns {string} The DNS address for this service.
103
+ */
104
+ get apiEndpoint(): string;
105
+ get universeDomain(): string;
106
+ /**
107
+ * The port for this API service.
108
+ * @returns {number} The default port for this service.
109
+ */
110
+ static get port(): number;
111
+ /**
112
+ * The scopes needed to make gRPC calls for every method defined
113
+ * in this service.
114
+ * @returns {string[]} List of default scopes.
115
+ */
116
+ static get scopes(): string[];
117
+ getProjectId(): Promise<string>;
118
+ getProjectId(callback: Callback<string, undefined, undefined>): void;
119
+ /**
120
+ * Aggregates data objects.
121
+ *
122
+ * @param {Object} request
123
+ * The request object that will be sent.
124
+ * @param {string} request.parent
125
+ * Required. The resource name of the Collection for which to query.
126
+ * Format: `projects/{project}/locations/{location}/collections/{collection}`
127
+ * @param {google.protobuf.Struct} [request.filter]
128
+ * Optional. A JSON filter expression, e.g. {"genre": {"$eq": "sci-fi"}},
129
+ * represented as a google.protobuf.Struct.
130
+ * @param {google.cloud.vectorsearch.v1.AggregationMethod} request.aggregate
131
+ * Required. The aggregation method to apply to the query.
132
+ * @param {object} [options]
133
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
134
+ * @returns {Promise} - The promise which resolves to an array.
135
+ * The first element of the array is an object representing {@link protos.google.cloud.vectorsearch.v1.AggregateDataObjectsResponse|AggregateDataObjectsResponse}.
136
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
137
+ * for more details and examples.
138
+ * @example <caption>include:samples/generated/v1/data_object_search_service.aggregate_data_objects.js</caption>
139
+ * region_tag:vectorsearch_v1_generated_DataObjectSearchService_AggregateDataObjects_async
140
+ */
141
+ aggregateDataObjects(request?: protos.google.cloud.vectorsearch.v1.IAggregateDataObjectsRequest, options?: CallOptions): Promise<[
142
+ protos.google.cloud.vectorsearch.v1.IAggregateDataObjectsResponse,
143
+ protos.google.cloud.vectorsearch.v1.IAggregateDataObjectsRequest | undefined,
144
+ {} | undefined
145
+ ]>;
146
+ aggregateDataObjects(request: protos.google.cloud.vectorsearch.v1.IAggregateDataObjectsRequest, options: CallOptions, callback: Callback<protos.google.cloud.vectorsearch.v1.IAggregateDataObjectsResponse, protos.google.cloud.vectorsearch.v1.IAggregateDataObjectsRequest | null | undefined, {} | null | undefined>): void;
147
+ aggregateDataObjects(request: protos.google.cloud.vectorsearch.v1.IAggregateDataObjectsRequest, callback: Callback<protos.google.cloud.vectorsearch.v1.IAggregateDataObjectsResponse, protos.google.cloud.vectorsearch.v1.IAggregateDataObjectsRequest | null | undefined, {} | null | undefined>): void;
148
+ /**
149
+ * Batch searches data objects.
150
+ *
151
+ * @param {Object} request
152
+ * The request object that will be sent.
153
+ * @param {string} request.parent
154
+ * Required. The resource name of the Collection for which to search.
155
+ * Format: `projects/{project}/locations/{location}/collections/{collection}`
156
+ * @param {number[]} request.searches
157
+ * Required. A list of search requests to execute in parallel.
158
+ * @param {google.cloud.vectorsearch.v1.BatchSearchDataObjectsRequest.CombineResultsOptions} [request.combine]
159
+ * Optional. Options for combining the results of the batch search operations.
160
+ * @param {object} [options]
161
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
162
+ * @returns {Promise} - The promise which resolves to an array.
163
+ * The first element of the array is an object representing {@link protos.google.cloud.vectorsearch.v1.BatchSearchDataObjectsResponse|BatchSearchDataObjectsResponse}.
164
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
165
+ * for more details and examples.
166
+ * @example <caption>include:samples/generated/v1/data_object_search_service.batch_search_data_objects.js</caption>
167
+ * region_tag:vectorsearch_v1_generated_DataObjectSearchService_BatchSearchDataObjects_async
168
+ */
169
+ batchSearchDataObjects(request?: protos.google.cloud.vectorsearch.v1.IBatchSearchDataObjectsRequest, options?: CallOptions): Promise<[
170
+ protos.google.cloud.vectorsearch.v1.IBatchSearchDataObjectsResponse,
171
+ protos.google.cloud.vectorsearch.v1.IBatchSearchDataObjectsRequest | undefined,
172
+ {} | undefined
173
+ ]>;
174
+ batchSearchDataObjects(request: protos.google.cloud.vectorsearch.v1.IBatchSearchDataObjectsRequest, options: CallOptions, callback: Callback<protos.google.cloud.vectorsearch.v1.IBatchSearchDataObjectsResponse, protos.google.cloud.vectorsearch.v1.IBatchSearchDataObjectsRequest | null | undefined, {} | null | undefined>): void;
175
+ batchSearchDataObjects(request: protos.google.cloud.vectorsearch.v1.IBatchSearchDataObjectsRequest, callback: Callback<protos.google.cloud.vectorsearch.v1.IBatchSearchDataObjectsResponse, protos.google.cloud.vectorsearch.v1.IBatchSearchDataObjectsRequest | null | undefined, {} | null | undefined>): void;
176
+ /**
177
+ * Searches data objects.
178
+ *
179
+ * @param {Object} request
180
+ * The request object that will be sent.
181
+ * @param {google.cloud.vectorsearch.v1.VectorSearch} request.vectorSearch
182
+ * A vector search operation.
183
+ * @param {google.cloud.vectorsearch.v1.SemanticSearch} request.semanticSearch
184
+ * A semantic search operation.
185
+ * @param {google.cloud.vectorsearch.v1.TextSearch} [request.textSearch]
186
+ * Optional. A text search operation.
187
+ * @param {string} request.parent
188
+ * Required. The resource name of the Collection for which to search.
189
+ * Format: `projects/{project}/locations/{location}/collections/{collection}`
190
+ * @param {number} [request.pageSize]
191
+ * Optional. The standard list page size. Only supported for KNN. If not set,
192
+ * up to search_type.top_k results will be returned. The maximum value is
193
+ * 1000; values above 1000 will be coerced to 1000.
194
+ * @param {string} [request.pageToken]
195
+ * Optional. The standard list page token.
196
+ * Typically obtained via
197
+ * {@link protos.google.cloud.vectorsearch.v1.SearchDataObjectsResponse.next_page_token|SearchDataObjectsResponse.next_page_token}
198
+ * of the previous
199
+ * {@link protos.google.cloud.vectorsearch.v1.DataObjectSearchService.SearchDataObjects|DataObjectSearchService.SearchDataObjects}
200
+ * call.
201
+ * @param {object} [options]
202
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
203
+ * @returns {Promise} - The promise which resolves to an array.
204
+ * The first element of the array is Array of {@link protos.google.cloud.vectorsearch.v1.SearchResult|SearchResult}.
205
+ * The client library will perform auto-pagination by default: it will call the API as many
206
+ * times as needed and will merge results from all the pages into this array.
207
+ * Note that it can affect your quota.
208
+ * We recommend using `searchDataObjectsAsync()`
209
+ * method described below for async iteration which you can stop as needed.
210
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
211
+ * for more details and examples.
212
+ */
213
+ searchDataObjects(request?: protos.google.cloud.vectorsearch.v1.ISearchDataObjectsRequest, options?: CallOptions): Promise<[
214
+ protos.google.cloud.vectorsearch.v1.ISearchResult[],
215
+ protos.google.cloud.vectorsearch.v1.ISearchDataObjectsRequest | null,
216
+ protos.google.cloud.vectorsearch.v1.ISearchDataObjectsResponse
217
+ ]>;
218
+ searchDataObjects(request: protos.google.cloud.vectorsearch.v1.ISearchDataObjectsRequest, options: CallOptions, callback: PaginationCallback<protos.google.cloud.vectorsearch.v1.ISearchDataObjectsRequest, protos.google.cloud.vectorsearch.v1.ISearchDataObjectsResponse | null | undefined, protos.google.cloud.vectorsearch.v1.ISearchResult>): void;
219
+ searchDataObjects(request: protos.google.cloud.vectorsearch.v1.ISearchDataObjectsRequest, callback: PaginationCallback<protos.google.cloud.vectorsearch.v1.ISearchDataObjectsRequest, protos.google.cloud.vectorsearch.v1.ISearchDataObjectsResponse | null | undefined, protos.google.cloud.vectorsearch.v1.ISearchResult>): void;
220
+ /**
221
+ * Equivalent to `searchDataObjects`, but returns a NodeJS Stream object.
222
+ * @param {Object} request
223
+ * The request object that will be sent.
224
+ * @param {google.cloud.vectorsearch.v1.VectorSearch} request.vectorSearch
225
+ * A vector search operation.
226
+ * @param {google.cloud.vectorsearch.v1.SemanticSearch} request.semanticSearch
227
+ * A semantic search operation.
228
+ * @param {google.cloud.vectorsearch.v1.TextSearch} [request.textSearch]
229
+ * Optional. A text search operation.
230
+ * @param {string} request.parent
231
+ * Required. The resource name of the Collection for which to search.
232
+ * Format: `projects/{project}/locations/{location}/collections/{collection}`
233
+ * @param {number} [request.pageSize]
234
+ * Optional. The standard list page size. Only supported for KNN. If not set,
235
+ * up to search_type.top_k results will be returned. The maximum value is
236
+ * 1000; values above 1000 will be coerced to 1000.
237
+ * @param {string} [request.pageToken]
238
+ * Optional. The standard list page token.
239
+ * Typically obtained via
240
+ * {@link protos.google.cloud.vectorsearch.v1.SearchDataObjectsResponse.next_page_token|SearchDataObjectsResponse.next_page_token}
241
+ * of the previous
242
+ * {@link protos.google.cloud.vectorsearch.v1.DataObjectSearchService.SearchDataObjects|DataObjectSearchService.SearchDataObjects}
243
+ * call.
244
+ * @param {object} [options]
245
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
246
+ * @returns {Stream}
247
+ * An object stream which emits an object representing {@link protos.google.cloud.vectorsearch.v1.SearchResult|SearchResult} on 'data' event.
248
+ * The client library will perform auto-pagination by default: it will call the API as many
249
+ * times as needed. Note that it can affect your quota.
250
+ * We recommend using `searchDataObjectsAsync()`
251
+ * method described below for async iteration which you can stop as needed.
252
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
253
+ * for more details and examples.
254
+ */
255
+ searchDataObjectsStream(request?: protos.google.cloud.vectorsearch.v1.ISearchDataObjectsRequest, options?: CallOptions): Transform;
256
+ /**
257
+ * Equivalent to `searchDataObjects`, but returns an iterable object.
258
+ *
259
+ * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
260
+ * @param {Object} request
261
+ * The request object that will be sent.
262
+ * @param {google.cloud.vectorsearch.v1.VectorSearch} request.vectorSearch
263
+ * A vector search operation.
264
+ * @param {google.cloud.vectorsearch.v1.SemanticSearch} request.semanticSearch
265
+ * A semantic search operation.
266
+ * @param {google.cloud.vectorsearch.v1.TextSearch} [request.textSearch]
267
+ * Optional. A text search operation.
268
+ * @param {string} request.parent
269
+ * Required. The resource name of the Collection for which to search.
270
+ * Format: `projects/{project}/locations/{location}/collections/{collection}`
271
+ * @param {number} [request.pageSize]
272
+ * Optional. The standard list page size. Only supported for KNN. If not set,
273
+ * up to search_type.top_k results will be returned. The maximum value is
274
+ * 1000; values above 1000 will be coerced to 1000.
275
+ * @param {string} [request.pageToken]
276
+ * Optional. The standard list page token.
277
+ * Typically obtained via
278
+ * {@link protos.google.cloud.vectorsearch.v1.SearchDataObjectsResponse.next_page_token|SearchDataObjectsResponse.next_page_token}
279
+ * of the previous
280
+ * {@link protos.google.cloud.vectorsearch.v1.DataObjectSearchService.SearchDataObjects|DataObjectSearchService.SearchDataObjects}
281
+ * call.
282
+ * @param {object} [options]
283
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
284
+ * @returns {Object}
285
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
286
+ * When you iterate the returned iterable, each element will be an object representing
287
+ * {@link protos.google.cloud.vectorsearch.v1.SearchResult|SearchResult}. The API will be called under the hood as needed, once per the page,
288
+ * so you can stop the iteration when you don't need more results.
289
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
290
+ * for more details and examples.
291
+ * @example <caption>include:samples/generated/v1/data_object_search_service.search_data_objects.js</caption>
292
+ * region_tag:vectorsearch_v1_generated_DataObjectSearchService_SearchDataObjects_async
293
+ */
294
+ searchDataObjectsAsync(request?: protos.google.cloud.vectorsearch.v1.ISearchDataObjectsRequest, options?: CallOptions): AsyncIterable<protos.google.cloud.vectorsearch.v1.ISearchResult>;
295
+ /**
296
+ * Queries data objects.
297
+ *
298
+ * @param {Object} request
299
+ * The request object that will be sent.
300
+ * @param {string} request.parent
301
+ * Required. The resource name of the Collection for which to query.
302
+ * Format: `projects/{project}/locations/{location}/collections/{collection}`
303
+ * @param {google.protobuf.Struct} [request.filter]
304
+ * Optional. A JSON filter expression, e.g. {"genre": {"$eq": "sci-fi"}},
305
+ * represented as a google.protobuf.Struct.
306
+ * @param {google.cloud.vectorsearch.v1.OutputFields} [request.outputFields]
307
+ * Optional. Mask specifying which fields to return.
308
+ * @param {number} [request.pageSize]
309
+ * Optional. The standard list page size. Default is 100.
310
+ * The maximum value is 1000; values above 1000 will be coerced to 1000.
311
+ * @param {string} [request.pageToken]
312
+ * Optional. The standard list page token.
313
+ * Typically obtained via
314
+ * {@link protos.google.cloud.vectorsearch.v1.QueryDataObjectsResponse.next_page_token|QueryDataObjectsResponse.next_page_token}
315
+ * of the previous
316
+ * {@link protos.google.cloud.vectorsearch.v1.DataObjectSearchService.QueryDataObjects|DataObjectSearchService.QueryDataObjects}
317
+ * call.
318
+ * @param {object} [options]
319
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
320
+ * @returns {Promise} - The promise which resolves to an array.
321
+ * The first element of the array is Array of {@link protos.google.cloud.vectorsearch.v1.DataObject|DataObject}.
322
+ * The client library will perform auto-pagination by default: it will call the API as many
323
+ * times as needed and will merge results from all the pages into this array.
324
+ * Note that it can affect your quota.
325
+ * We recommend using `queryDataObjectsAsync()`
326
+ * method described below for async iteration which you can stop as needed.
327
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
328
+ * for more details and examples.
329
+ */
330
+ queryDataObjects(request?: protos.google.cloud.vectorsearch.v1.IQueryDataObjectsRequest, options?: CallOptions): Promise<[
331
+ protos.google.cloud.vectorsearch.v1.IDataObject[],
332
+ protos.google.cloud.vectorsearch.v1.IQueryDataObjectsRequest | null,
333
+ protos.google.cloud.vectorsearch.v1.IQueryDataObjectsResponse
334
+ ]>;
335
+ queryDataObjects(request: protos.google.cloud.vectorsearch.v1.IQueryDataObjectsRequest, options: CallOptions, callback: PaginationCallback<protos.google.cloud.vectorsearch.v1.IQueryDataObjectsRequest, protos.google.cloud.vectorsearch.v1.IQueryDataObjectsResponse | null | undefined, protos.google.cloud.vectorsearch.v1.IDataObject>): void;
336
+ queryDataObjects(request: protos.google.cloud.vectorsearch.v1.IQueryDataObjectsRequest, callback: PaginationCallback<protos.google.cloud.vectorsearch.v1.IQueryDataObjectsRequest, protos.google.cloud.vectorsearch.v1.IQueryDataObjectsResponse | null | undefined, protos.google.cloud.vectorsearch.v1.IDataObject>): void;
337
+ /**
338
+ * Equivalent to `queryDataObjects`, but returns a NodeJS Stream object.
339
+ * @param {Object} request
340
+ * The request object that will be sent.
341
+ * @param {string} request.parent
342
+ * Required. The resource name of the Collection for which to query.
343
+ * Format: `projects/{project}/locations/{location}/collections/{collection}`
344
+ * @param {google.protobuf.Struct} [request.filter]
345
+ * Optional. A JSON filter expression, e.g. {"genre": {"$eq": "sci-fi"}},
346
+ * represented as a google.protobuf.Struct.
347
+ * @param {google.cloud.vectorsearch.v1.OutputFields} [request.outputFields]
348
+ * Optional. Mask specifying which fields to return.
349
+ * @param {number} [request.pageSize]
350
+ * Optional. The standard list page size. Default is 100.
351
+ * The maximum value is 1000; values above 1000 will be coerced to 1000.
352
+ * @param {string} [request.pageToken]
353
+ * Optional. The standard list page token.
354
+ * Typically obtained via
355
+ * {@link protos.google.cloud.vectorsearch.v1.QueryDataObjectsResponse.next_page_token|QueryDataObjectsResponse.next_page_token}
356
+ * of the previous
357
+ * {@link protos.google.cloud.vectorsearch.v1.DataObjectSearchService.QueryDataObjects|DataObjectSearchService.QueryDataObjects}
358
+ * call.
359
+ * @param {object} [options]
360
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
361
+ * @returns {Stream}
362
+ * An object stream which emits an object representing {@link protos.google.cloud.vectorsearch.v1.DataObject|DataObject} on 'data' event.
363
+ * The client library will perform auto-pagination by default: it will call the API as many
364
+ * times as needed. Note that it can affect your quota.
365
+ * We recommend using `queryDataObjectsAsync()`
366
+ * method described below for async iteration which you can stop as needed.
367
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
368
+ * for more details and examples.
369
+ */
370
+ queryDataObjectsStream(request?: protos.google.cloud.vectorsearch.v1.IQueryDataObjectsRequest, options?: CallOptions): Transform;
371
+ /**
372
+ * Equivalent to `queryDataObjects`, but returns an iterable object.
373
+ *
374
+ * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
375
+ * @param {Object} request
376
+ * The request object that will be sent.
377
+ * @param {string} request.parent
378
+ * Required. The resource name of the Collection for which to query.
379
+ * Format: `projects/{project}/locations/{location}/collections/{collection}`
380
+ * @param {google.protobuf.Struct} [request.filter]
381
+ * Optional. A JSON filter expression, e.g. {"genre": {"$eq": "sci-fi"}},
382
+ * represented as a google.protobuf.Struct.
383
+ * @param {google.cloud.vectorsearch.v1.OutputFields} [request.outputFields]
384
+ * Optional. Mask specifying which fields to return.
385
+ * @param {number} [request.pageSize]
386
+ * Optional. The standard list page size. Default is 100.
387
+ * The maximum value is 1000; values above 1000 will be coerced to 1000.
388
+ * @param {string} [request.pageToken]
389
+ * Optional. The standard list page token.
390
+ * Typically obtained via
391
+ * {@link protos.google.cloud.vectorsearch.v1.QueryDataObjectsResponse.next_page_token|QueryDataObjectsResponse.next_page_token}
392
+ * of the previous
393
+ * {@link protos.google.cloud.vectorsearch.v1.DataObjectSearchService.QueryDataObjects|DataObjectSearchService.QueryDataObjects}
394
+ * call.
395
+ * @param {object} [options]
396
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
397
+ * @returns {Object}
398
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
399
+ * When you iterate the returned iterable, each element will be an object representing
400
+ * {@link protos.google.cloud.vectorsearch.v1.DataObject|DataObject}. The API will be called under the hood as needed, once per the page,
401
+ * so you can stop the iteration when you don't need more results.
402
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
403
+ * for more details and examples.
404
+ * @example <caption>include:samples/generated/v1/data_object_search_service.query_data_objects.js</caption>
405
+ * region_tag:vectorsearch_v1_generated_DataObjectSearchService_QueryDataObjects_async
406
+ */
407
+ queryDataObjectsAsync(request?: protos.google.cloud.vectorsearch.v1.IQueryDataObjectsRequest, options?: CallOptions): AsyncIterable<protos.google.cloud.vectorsearch.v1.IDataObject>;
408
+ /**
409
+ * Gets information about a location.
410
+ *
411
+ * @param {Object} request
412
+ * The request object that will be sent.
413
+ * @param {string} request.name
414
+ * Resource name for the location.
415
+ * @param {object} [options]
416
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html | CallOptions} for more details.
417
+ * @returns {Promise} - The promise which resolves to an array.
418
+ * The first element of the array is an object representing {@link google.cloud.location.Location | Location}.
419
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
420
+ * for more details and examples.
421
+ * @example
422
+ * ```
423
+ * const [response] = await client.getLocation(request);
424
+ * ```
425
+ */
426
+ getLocation(request: LocationProtos.google.cloud.location.IGetLocationRequest, options?: gax.CallOptions | Callback<LocationProtos.google.cloud.location.ILocation, LocationProtos.google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>, callback?: Callback<LocationProtos.google.cloud.location.ILocation, LocationProtos.google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>): Promise<LocationProtos.google.cloud.location.ILocation>;
427
+ /**
428
+ * Lists information about the supported locations for this service. Returns an iterable object.
429
+ *
430
+ * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
431
+ * @param {Object} request
432
+ * The request object that will be sent.
433
+ * @param {string} request.name
434
+ * The resource that owns the locations collection, if applicable.
435
+ * @param {string} request.filter
436
+ * The standard list filter.
437
+ * @param {number} request.pageSize
438
+ * The standard list page size.
439
+ * @param {string} request.pageToken
440
+ * The standard list page token.
441
+ * @param {object} [options]
442
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
443
+ * @returns {Object}
444
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
445
+ * When you iterate the returned iterable, each element will be an object representing
446
+ * {@link google.cloud.location.Location | Location}. The API will be called under the hood as needed, once per the page,
447
+ * so you can stop the iteration when you don't need more results.
448
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
449
+ * for more details and examples.
450
+ * @example
451
+ * ```
452
+ * const iterable = client.listLocationsAsync(request);
453
+ * for await (const response of iterable) {
454
+ * // process response
455
+ * }
456
+ * ```
457
+ */
458
+ listLocationsAsync(request: LocationProtos.google.cloud.location.IListLocationsRequest, options?: CallOptions): AsyncIterable<LocationProtos.google.cloud.location.ILocation>;
459
+ /**
460
+ * Return a fully-qualified collection resource name string.
461
+ *
462
+ * @param {string} project
463
+ * @param {string} location
464
+ * @param {string} collection
465
+ * @returns {string} Resource name string.
466
+ */
467
+ collectionPath(project: string, location: string, collection: string): string;
468
+ /**
469
+ * Parse the project from Collection resource.
470
+ *
471
+ * @param {string} collectionName
472
+ * A fully-qualified path representing Collection resource.
473
+ * @returns {string} A string representing the project.
474
+ */
475
+ matchProjectFromCollectionName(collectionName: string): string | number;
476
+ /**
477
+ * Parse the location from Collection resource.
478
+ *
479
+ * @param {string} collectionName
480
+ * A fully-qualified path representing Collection resource.
481
+ * @returns {string} A string representing the location.
482
+ */
483
+ matchLocationFromCollectionName(collectionName: string): string | number;
484
+ /**
485
+ * Parse the collection from Collection resource.
486
+ *
487
+ * @param {string} collectionName
488
+ * A fully-qualified path representing Collection resource.
489
+ * @returns {string} A string representing the collection.
490
+ */
491
+ matchCollectionFromCollectionName(collectionName: string): string | number;
492
+ /**
493
+ * Return a fully-qualified dataObject resource name string.
494
+ *
495
+ * @param {string} project
496
+ * @param {string} location
497
+ * @param {string} collection
498
+ * @param {string} dataObject
499
+ * @returns {string} Resource name string.
500
+ */
501
+ dataObjectPath(project: string, location: string, collection: string, dataObject: string): string;
502
+ /**
503
+ * Parse the project from DataObject resource.
504
+ *
505
+ * @param {string} dataObjectName
506
+ * A fully-qualified path representing DataObject resource.
507
+ * @returns {string} A string representing the project.
508
+ */
509
+ matchProjectFromDataObjectName(dataObjectName: string): string | number;
510
+ /**
511
+ * Parse the location from DataObject resource.
512
+ *
513
+ * @param {string} dataObjectName
514
+ * A fully-qualified path representing DataObject resource.
515
+ * @returns {string} A string representing the location.
516
+ */
517
+ matchLocationFromDataObjectName(dataObjectName: string): string | number;
518
+ /**
519
+ * Parse the collection from DataObject resource.
520
+ *
521
+ * @param {string} dataObjectName
522
+ * A fully-qualified path representing DataObject resource.
523
+ * @returns {string} A string representing the collection.
524
+ */
525
+ matchCollectionFromDataObjectName(dataObjectName: string): string | number;
526
+ /**
527
+ * Parse the dataObject from DataObject resource.
528
+ *
529
+ * @param {string} dataObjectName
530
+ * A fully-qualified path representing DataObject resource.
531
+ * @returns {string} A string representing the dataObject.
532
+ */
533
+ matchDataObjectFromDataObjectName(dataObjectName: string): string | number;
534
+ /**
535
+ * Return a fully-qualified index resource name string.
536
+ *
537
+ * @param {string} project
538
+ * @param {string} location
539
+ * @param {string} collection
540
+ * @param {string} index
541
+ * @returns {string} Resource name string.
542
+ */
543
+ indexPath(project: string, location: string, collection: string, index: string): string;
544
+ /**
545
+ * Parse the project from Index resource.
546
+ *
547
+ * @param {string} indexName
548
+ * A fully-qualified path representing Index resource.
549
+ * @returns {string} A string representing the project.
550
+ */
551
+ matchProjectFromIndexName(indexName: string): string | number;
552
+ /**
553
+ * Parse the location from Index resource.
554
+ *
555
+ * @param {string} indexName
556
+ * A fully-qualified path representing Index resource.
557
+ * @returns {string} A string representing the location.
558
+ */
559
+ matchLocationFromIndexName(indexName: string): string | number;
560
+ /**
561
+ * Parse the collection from Index resource.
562
+ *
563
+ * @param {string} indexName
564
+ * A fully-qualified path representing Index resource.
565
+ * @returns {string} A string representing the collection.
566
+ */
567
+ matchCollectionFromIndexName(indexName: string): string | number;
568
+ /**
569
+ * Parse the index from Index resource.
570
+ *
571
+ * @param {string} indexName
572
+ * A fully-qualified path representing Index resource.
573
+ * @returns {string} A string representing the index.
574
+ */
575
+ matchIndexFromIndexName(indexName: string): string | number;
576
+ /**
577
+ * Terminate the gRPC channel and close the client.
578
+ *
579
+ * The client will no longer be usable and all future behavior is undefined.
580
+ * @returns {Promise} A promise that resolves when the client is closed.
581
+ */
582
+ close(): Promise<void>;
583
+ }