@google-cloud/vectorsearch 0.1.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 (34) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +134 -0
  3. package/build/protos/google/cloud/vectorsearch/v1beta/common.proto +34 -0
  4. package/build/protos/google/cloud/vectorsearch/v1beta/data_object.proto +92 -0
  5. package/build/protos/google/cloud/vectorsearch/v1beta/data_object_search_service.proto +428 -0
  6. package/build/protos/google/cloud/vectorsearch/v1beta/data_object_service.proto +233 -0
  7. package/build/protos/google/cloud/vectorsearch/v1beta/embedding_config.proto +71 -0
  8. package/build/protos/google/cloud/vectorsearch/v1beta/vectorsearch_service.proto +631 -0
  9. package/build/protos/protos.d.ts +15049 -0
  10. package/build/protos/protos.js +39060 -0
  11. package/build/protos/protos.json +4174 -0
  12. package/build/src/index.d.ts +17 -0
  13. package/build/src/index.js +32 -0
  14. package/build/src/index.js.map +1 -0
  15. package/build/src/v1beta/data_object_search_service_client.d.ts +574 -0
  16. package/build/src/v1beta/data_object_search_service_client.js +849 -0
  17. package/build/src/v1beta/data_object_search_service_client.js.map +1 -0
  18. package/build/src/v1beta/data_object_search_service_client_config.json +58 -0
  19. package/build/src/v1beta/data_object_search_service_proto_list.json +8 -0
  20. package/build/src/v1beta/data_object_service_client.d.ts +486 -0
  21. package/build/src/v1beta/data_object_service_client.js +767 -0
  22. package/build/src/v1beta/data_object_service_client.js.map +1 -0
  23. package/build/src/v1beta/data_object_service_client_config.json +73 -0
  24. package/build/src/v1beta/data_object_service_proto_list.json +8 -0
  25. package/build/src/v1beta/gapic_metadata.json +277 -0
  26. package/build/src/v1beta/index.d.ts +3 -0
  27. package/build/src/v1beta/index.js +27 -0
  28. package/build/src/v1beta/index.js.map +1 -0
  29. package/build/src/v1beta/vector_search_service_client.d.ts +1020 -0
  30. package/build/src/v1beta/vector_search_service_client.js +1387 -0
  31. package/build/src/v1beta/vector_search_service_client.js.map +1 -0
  32. package/build/src/v1beta/vector_search_service_client_config.json +88 -0
  33. package/build/src/v1beta/vector_search_service_proto_list.json +8 -0
  34. package/package.json +70 -0
@@ -0,0 +1,17 @@
1
+ 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 };
9
+ declare const _default: {
10
+ v1beta: typeof v1beta;
11
+ DataObjectSearchServiceClient: typeof v1beta.DataObjectSearchServiceClient;
12
+ DataObjectServiceClient: typeof v1beta.DataObjectServiceClient;
13
+ VectorSearchServiceClient: typeof v1beta.VectorSearchServiceClient;
14
+ };
15
+ export default _default;
16
+ import * as protos from '../protos/protos';
17
+ export { protos };
@@ -0,0 +1,32 @@
1
+ "use strict";
2
+ // Copyright 2025 Google LLC
3
+ //
4
+ // Licensed under the Apache License, Version 2.0 (the "License");
5
+ // you may not use this file except in compliance with the License.
6
+ // You may obtain a copy of the License at
7
+ //
8
+ // https://www.apache.org/licenses/LICENSE-2.0
9
+ //
10
+ // Unless required by applicable law or agreed to in writing, software
11
+ // distributed under the License is distributed on an "AS IS" BASIS,
12
+ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ // See the License for the specific language governing permissions and
14
+ // limitations under the License.
15
+ //
16
+ // ** This file is automatically generated by synthtool. **
17
+ // ** https://github.com/googleapis/synthtool **
18
+ // ** All changes to this file may be overwritten. **
19
+ Object.defineProperty(exports, "__esModule", { value: true });
20
+ exports.protos = exports.VectorSearchServiceClient = exports.DataObjectServiceClient = exports.DataObjectSearchServiceClient = exports.v1beta = void 0;
21
+ const v1beta = require("./v1beta");
22
+ exports.v1beta = v1beta;
23
+ const DataObjectSearchServiceClient = v1beta.DataObjectSearchServiceClient;
24
+ exports.DataObjectSearchServiceClient = DataObjectSearchServiceClient;
25
+ const DataObjectServiceClient = v1beta.DataObjectServiceClient;
26
+ exports.DataObjectServiceClient = DataObjectServiceClient;
27
+ const VectorSearchServiceClient = v1beta.VectorSearchServiceClient;
28
+ exports.VectorSearchServiceClient = VectorSearchServiceClient;
29
+ exports.default = { v1beta, DataObjectSearchServiceClient, DataObjectServiceClient, VectorSearchServiceClient };
30
+ const protos = require("../protos/protos");
31
+ exports.protos = protos;
32
+ //# sourceMappingURL=index.js.map
@@ -0,0 +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"}
@@ -0,0 +1,574 @@
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 v1beta
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.v1beta.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.v1beta.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/v1beta/data_object_search_service.aggregate_data_objects.js</caption>
139
+ * region_tag:vectorsearch_v1beta_generated_DataObjectSearchService_AggregateDataObjects_async
140
+ */
141
+ aggregateDataObjects(request?: protos.google.cloud.vectorsearch.v1beta.IAggregateDataObjectsRequest, options?: CallOptions): Promise<[
142
+ protos.google.cloud.vectorsearch.v1beta.IAggregateDataObjectsResponse,
143
+ protos.google.cloud.vectorsearch.v1beta.IAggregateDataObjectsRequest | undefined,
144
+ {} | undefined
145
+ ]>;
146
+ aggregateDataObjects(request: protos.google.cloud.vectorsearch.v1beta.IAggregateDataObjectsRequest, options: CallOptions, callback: Callback<protos.google.cloud.vectorsearch.v1beta.IAggregateDataObjectsResponse, protos.google.cloud.vectorsearch.v1beta.IAggregateDataObjectsRequest | null | undefined, {} | null | undefined>): void;
147
+ aggregateDataObjects(request: protos.google.cloud.vectorsearch.v1beta.IAggregateDataObjectsRequest, callback: Callback<protos.google.cloud.vectorsearch.v1beta.IAggregateDataObjectsResponse, protos.google.cloud.vectorsearch.v1beta.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.v1beta.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.v1beta.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/v1beta/data_object_search_service.batch_search_data_objects.js</caption>
167
+ * region_tag:vectorsearch_v1beta_generated_DataObjectSearchService_BatchSearchDataObjects_async
168
+ */
169
+ batchSearchDataObjects(request?: protos.google.cloud.vectorsearch.v1beta.IBatchSearchDataObjectsRequest, options?: CallOptions): Promise<[
170
+ protos.google.cloud.vectorsearch.v1beta.IBatchSearchDataObjectsResponse,
171
+ protos.google.cloud.vectorsearch.v1beta.IBatchSearchDataObjectsRequest | undefined,
172
+ {} | undefined
173
+ ]>;
174
+ batchSearchDataObjects(request: protos.google.cloud.vectorsearch.v1beta.IBatchSearchDataObjectsRequest, options: CallOptions, callback: Callback<protos.google.cloud.vectorsearch.v1beta.IBatchSearchDataObjectsResponse, protos.google.cloud.vectorsearch.v1beta.IBatchSearchDataObjectsRequest | null | undefined, {} | null | undefined>): void;
175
+ batchSearchDataObjects(request: protos.google.cloud.vectorsearch.v1beta.IBatchSearchDataObjectsRequest, callback: Callback<protos.google.cloud.vectorsearch.v1beta.IBatchSearchDataObjectsResponse, protos.google.cloud.vectorsearch.v1beta.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.v1beta.VectorSearch} request.vectorSearch
182
+ * A vector search operation.
183
+ * @param {google.cloud.vectorsearch.v1beta.SemanticSearch} request.semanticSearch
184
+ * A semantic search operation.
185
+ * @param {google.cloud.vectorsearch.v1beta.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.
192
+ * @param {string} [request.pageToken]
193
+ * Optional. The standard list page token.
194
+ * Typically obtained via
195
+ * {@link protos.google.cloud.vectorsearch.v1beta.SearchDataObjectsResponse.next_page_token|SearchDataObjectsResponse.next_page_token}
196
+ * of the previous
197
+ * {@link protos.google.cloud.vectorsearch.v1beta.DataObjectSearchService.SearchDataObjects|DataObjectSearchService.SearchDataObjects}
198
+ * call.
199
+ * @param {object} [options]
200
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
201
+ * @returns {Promise} - The promise which resolves to an array.
202
+ * The first element of the array is Array of {@link protos.google.cloud.vectorsearch.v1beta.SearchResult|SearchResult}.
203
+ * The client library will perform auto-pagination by default: it will call the API as many
204
+ * times as needed and will merge results from all the pages into this array.
205
+ * Note that it can affect your quota.
206
+ * We recommend using `searchDataObjectsAsync()`
207
+ * method described below for async iteration which you can stop as needed.
208
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
209
+ * for more details and examples.
210
+ */
211
+ searchDataObjects(request?: protos.google.cloud.vectorsearch.v1beta.ISearchDataObjectsRequest, options?: CallOptions): Promise<[
212
+ protos.google.cloud.vectorsearch.v1beta.ISearchResult[],
213
+ protos.google.cloud.vectorsearch.v1beta.ISearchDataObjectsRequest | null,
214
+ protos.google.cloud.vectorsearch.v1beta.ISearchDataObjectsResponse
215
+ ]>;
216
+ searchDataObjects(request: protos.google.cloud.vectorsearch.v1beta.ISearchDataObjectsRequest, options: CallOptions, callback: PaginationCallback<protos.google.cloud.vectorsearch.v1beta.ISearchDataObjectsRequest, protos.google.cloud.vectorsearch.v1beta.ISearchDataObjectsResponse | null | undefined, protos.google.cloud.vectorsearch.v1beta.ISearchResult>): void;
217
+ searchDataObjects(request: protos.google.cloud.vectorsearch.v1beta.ISearchDataObjectsRequest, callback: PaginationCallback<protos.google.cloud.vectorsearch.v1beta.ISearchDataObjectsRequest, protos.google.cloud.vectorsearch.v1beta.ISearchDataObjectsResponse | null | undefined, protos.google.cloud.vectorsearch.v1beta.ISearchResult>): void;
218
+ /**
219
+ * Equivalent to `searchDataObjects`, but returns a NodeJS Stream object.
220
+ * @param {Object} request
221
+ * The request object that will be sent.
222
+ * @param {google.cloud.vectorsearch.v1beta.VectorSearch} request.vectorSearch
223
+ * A vector search operation.
224
+ * @param {google.cloud.vectorsearch.v1beta.SemanticSearch} request.semanticSearch
225
+ * A semantic search operation.
226
+ * @param {google.cloud.vectorsearch.v1beta.TextSearch} [request.textSearch]
227
+ * Optional. A text search operation.
228
+ * @param {string} request.parent
229
+ * Required. The resource name of the Collection for which to search.
230
+ * Format: `projects/{project}/locations/{location}/collections/{collection}`
231
+ * @param {number} [request.pageSize]
232
+ * Optional. The standard list page size.
233
+ * @param {string} [request.pageToken]
234
+ * Optional. The standard list page token.
235
+ * Typically obtained via
236
+ * {@link protos.google.cloud.vectorsearch.v1beta.SearchDataObjectsResponse.next_page_token|SearchDataObjectsResponse.next_page_token}
237
+ * of the previous
238
+ * {@link protos.google.cloud.vectorsearch.v1beta.DataObjectSearchService.SearchDataObjects|DataObjectSearchService.SearchDataObjects}
239
+ * call.
240
+ * @param {object} [options]
241
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
242
+ * @returns {Stream}
243
+ * An object stream which emits an object representing {@link protos.google.cloud.vectorsearch.v1beta.SearchResult|SearchResult} on 'data' event.
244
+ * The client library will perform auto-pagination by default: it will call the API as many
245
+ * times as needed. Note that it can affect your quota.
246
+ * We recommend using `searchDataObjectsAsync()`
247
+ * method described below for async iteration which you can stop as needed.
248
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
249
+ * for more details and examples.
250
+ */
251
+ searchDataObjectsStream(request?: protos.google.cloud.vectorsearch.v1beta.ISearchDataObjectsRequest, options?: CallOptions): Transform;
252
+ /**
253
+ * Equivalent to `searchDataObjects`, but returns an iterable object.
254
+ *
255
+ * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
256
+ * @param {Object} request
257
+ * The request object that will be sent.
258
+ * @param {google.cloud.vectorsearch.v1beta.VectorSearch} request.vectorSearch
259
+ * A vector search operation.
260
+ * @param {google.cloud.vectorsearch.v1beta.SemanticSearch} request.semanticSearch
261
+ * A semantic search operation.
262
+ * @param {google.cloud.vectorsearch.v1beta.TextSearch} [request.textSearch]
263
+ * Optional. A text search operation.
264
+ * @param {string} request.parent
265
+ * Required. The resource name of the Collection for which to search.
266
+ * Format: `projects/{project}/locations/{location}/collections/{collection}`
267
+ * @param {number} [request.pageSize]
268
+ * Optional. The standard list page size.
269
+ * @param {string} [request.pageToken]
270
+ * Optional. The standard list page token.
271
+ * Typically obtained via
272
+ * {@link protos.google.cloud.vectorsearch.v1beta.SearchDataObjectsResponse.next_page_token|SearchDataObjectsResponse.next_page_token}
273
+ * of the previous
274
+ * {@link protos.google.cloud.vectorsearch.v1beta.DataObjectSearchService.SearchDataObjects|DataObjectSearchService.SearchDataObjects}
275
+ * call.
276
+ * @param {object} [options]
277
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
278
+ * @returns {Object}
279
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
280
+ * When you iterate the returned iterable, each element will be an object representing
281
+ * {@link protos.google.cloud.vectorsearch.v1beta.SearchResult|SearchResult}. The API will be called under the hood as needed, once per the page,
282
+ * so you can stop the iteration when you don't need more results.
283
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
284
+ * for more details and examples.
285
+ * @example <caption>include:samples/generated/v1beta/data_object_search_service.search_data_objects.js</caption>
286
+ * region_tag:vectorsearch_v1beta_generated_DataObjectSearchService_SearchDataObjects_async
287
+ */
288
+ searchDataObjectsAsync(request?: protos.google.cloud.vectorsearch.v1beta.ISearchDataObjectsRequest, options?: CallOptions): AsyncIterable<protos.google.cloud.vectorsearch.v1beta.ISearchResult>;
289
+ /**
290
+ * Queries data objects.
291
+ *
292
+ * @param {Object} request
293
+ * The request object that will be sent.
294
+ * @param {string} request.parent
295
+ * Required. The resource name of the Collection for which to query.
296
+ * Format: `projects/{project}/locations/{location}/collections/{collection}`
297
+ * @param {google.protobuf.Struct} [request.filter]
298
+ * Optional. A JSON filter expression, e.g. {"genre": {"$eq": "sci-fi"}},
299
+ * represented as a google.protobuf.Struct.
300
+ * @param {google.cloud.vectorsearch.v1beta.OutputFields} [request.outputFields]
301
+ * Optional. Mask specifying which fields to return.
302
+ * @param {number} [request.pageSize]
303
+ * Optional. The standard list page size.
304
+ * @param {string} [request.pageToken]
305
+ * Optional. The standard list page token.
306
+ * Typically obtained via
307
+ * {@link protos.google.cloud.vectorsearch.v1beta.QueryDataObjectsResponse.next_page_token|QueryDataObjectsResponse.next_page_token}
308
+ * of the previous
309
+ * {@link protos.google.cloud.vectorsearch.v1beta.DataObjectSearchService.QueryDataObjects|DataObjectSearchService.QueryDataObjects}
310
+ * call.
311
+ * @param {object} [options]
312
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
313
+ * @returns {Promise} - The promise which resolves to an array.
314
+ * The first element of the array is Array of {@link protos.google.cloud.vectorsearch.v1beta.DataObject|DataObject}.
315
+ * The client library will perform auto-pagination by default: it will call the API as many
316
+ * times as needed and will merge results from all the pages into this array.
317
+ * Note that it can affect your quota.
318
+ * We recommend using `queryDataObjectsAsync()`
319
+ * method described below for async iteration which you can stop as needed.
320
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
321
+ * for more details and examples.
322
+ */
323
+ queryDataObjects(request?: protos.google.cloud.vectorsearch.v1beta.IQueryDataObjectsRequest, options?: CallOptions): Promise<[
324
+ protos.google.cloud.vectorsearch.v1beta.IDataObject[],
325
+ protos.google.cloud.vectorsearch.v1beta.IQueryDataObjectsRequest | null,
326
+ protos.google.cloud.vectorsearch.v1beta.IQueryDataObjectsResponse
327
+ ]>;
328
+ queryDataObjects(request: protos.google.cloud.vectorsearch.v1beta.IQueryDataObjectsRequest, options: CallOptions, callback: PaginationCallback<protos.google.cloud.vectorsearch.v1beta.IQueryDataObjectsRequest, protos.google.cloud.vectorsearch.v1beta.IQueryDataObjectsResponse | null | undefined, protos.google.cloud.vectorsearch.v1beta.IDataObject>): void;
329
+ queryDataObjects(request: protos.google.cloud.vectorsearch.v1beta.IQueryDataObjectsRequest, callback: PaginationCallback<protos.google.cloud.vectorsearch.v1beta.IQueryDataObjectsRequest, protos.google.cloud.vectorsearch.v1beta.IQueryDataObjectsResponse | null | undefined, protos.google.cloud.vectorsearch.v1beta.IDataObject>): void;
330
+ /**
331
+ * Equivalent to `queryDataObjects`, but returns a NodeJS Stream object.
332
+ * @param {Object} request
333
+ * The request object that will be sent.
334
+ * @param {string} request.parent
335
+ * Required. The resource name of the Collection for which to query.
336
+ * Format: `projects/{project}/locations/{location}/collections/{collection}`
337
+ * @param {google.protobuf.Struct} [request.filter]
338
+ * Optional. A JSON filter expression, e.g. {"genre": {"$eq": "sci-fi"}},
339
+ * represented as a google.protobuf.Struct.
340
+ * @param {google.cloud.vectorsearch.v1beta.OutputFields} [request.outputFields]
341
+ * Optional. Mask specifying which fields to return.
342
+ * @param {number} [request.pageSize]
343
+ * Optional. The standard list page size.
344
+ * @param {string} [request.pageToken]
345
+ * Optional. The standard list page token.
346
+ * Typically obtained via
347
+ * {@link protos.google.cloud.vectorsearch.v1beta.QueryDataObjectsResponse.next_page_token|QueryDataObjectsResponse.next_page_token}
348
+ * of the previous
349
+ * {@link protos.google.cloud.vectorsearch.v1beta.DataObjectSearchService.QueryDataObjects|DataObjectSearchService.QueryDataObjects}
350
+ * call.
351
+ * @param {object} [options]
352
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
353
+ * @returns {Stream}
354
+ * An object stream which emits an object representing {@link protos.google.cloud.vectorsearch.v1beta.DataObject|DataObject} on 'data' event.
355
+ * The client library will perform auto-pagination by default: it will call the API as many
356
+ * times as needed. Note that it can affect your quota.
357
+ * We recommend using `queryDataObjectsAsync()`
358
+ * method described below for async iteration which you can stop as needed.
359
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
360
+ * for more details and examples.
361
+ */
362
+ queryDataObjectsStream(request?: protos.google.cloud.vectorsearch.v1beta.IQueryDataObjectsRequest, options?: CallOptions): Transform;
363
+ /**
364
+ * Equivalent to `queryDataObjects`, but returns an iterable object.
365
+ *
366
+ * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
367
+ * @param {Object} request
368
+ * The request object that will be sent.
369
+ * @param {string} request.parent
370
+ * Required. The resource name of the Collection for which to query.
371
+ * Format: `projects/{project}/locations/{location}/collections/{collection}`
372
+ * @param {google.protobuf.Struct} [request.filter]
373
+ * Optional. A JSON filter expression, e.g. {"genre": {"$eq": "sci-fi"}},
374
+ * represented as a google.protobuf.Struct.
375
+ * @param {google.cloud.vectorsearch.v1beta.OutputFields} [request.outputFields]
376
+ * Optional. Mask specifying which fields to return.
377
+ * @param {number} [request.pageSize]
378
+ * Optional. The standard list page size.
379
+ * @param {string} [request.pageToken]
380
+ * Optional. The standard list page token.
381
+ * Typically obtained via
382
+ * {@link protos.google.cloud.vectorsearch.v1beta.QueryDataObjectsResponse.next_page_token|QueryDataObjectsResponse.next_page_token}
383
+ * of the previous
384
+ * {@link protos.google.cloud.vectorsearch.v1beta.DataObjectSearchService.QueryDataObjects|DataObjectSearchService.QueryDataObjects}
385
+ * call.
386
+ * @param {object} [options]
387
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
388
+ * @returns {Object}
389
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
390
+ * When you iterate the returned iterable, each element will be an object representing
391
+ * {@link protos.google.cloud.vectorsearch.v1beta.DataObject|DataObject}. The API will be called under the hood as needed, once per the page,
392
+ * so you can stop the iteration when you don't need more results.
393
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
394
+ * for more details and examples.
395
+ * @example <caption>include:samples/generated/v1beta/data_object_search_service.query_data_objects.js</caption>
396
+ * region_tag:vectorsearch_v1beta_generated_DataObjectSearchService_QueryDataObjects_async
397
+ */
398
+ queryDataObjectsAsync(request?: protos.google.cloud.vectorsearch.v1beta.IQueryDataObjectsRequest, options?: CallOptions): AsyncIterable<protos.google.cloud.vectorsearch.v1beta.IDataObject>;
399
+ /**
400
+ * Gets information about a location.
401
+ *
402
+ * @param {Object} request
403
+ * The request object that will be sent.
404
+ * @param {string} request.name
405
+ * Resource name for the location.
406
+ * @param {object} [options]
407
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html | CallOptions} for more details.
408
+ * @returns {Promise} - The promise which resolves to an array.
409
+ * The first element of the array is an object representing {@link google.cloud.location.Location | Location}.
410
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
411
+ * for more details and examples.
412
+ * @example
413
+ * ```
414
+ * const [response] = await client.getLocation(request);
415
+ * ```
416
+ */
417
+ 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>;
418
+ /**
419
+ * Lists information about the supported locations for this service. Returns an iterable object.
420
+ *
421
+ * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
422
+ * @param {Object} request
423
+ * The request object that will be sent.
424
+ * @param {string} request.name
425
+ * The resource that owns the locations collection, if applicable.
426
+ * @param {string} request.filter
427
+ * The standard list filter.
428
+ * @param {number} request.pageSize
429
+ * The standard list page size.
430
+ * @param {string} request.pageToken
431
+ * The standard list page token.
432
+ * @param {object} [options]
433
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
434
+ * @returns {Object}
435
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
436
+ * When you iterate the returned iterable, each element will be an object representing
437
+ * {@link google.cloud.location.Location | Location}. The API will be called under the hood as needed, once per the page,
438
+ * so you can stop the iteration when you don't need more results.
439
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
440
+ * for more details and examples.
441
+ * @example
442
+ * ```
443
+ * const iterable = client.listLocationsAsync(request);
444
+ * for await (const response of iterable) {
445
+ * // process response
446
+ * }
447
+ * ```
448
+ */
449
+ listLocationsAsync(request: LocationProtos.google.cloud.location.IListLocationsRequest, options?: CallOptions): AsyncIterable<LocationProtos.google.cloud.location.ILocation>;
450
+ /**
451
+ * Return a fully-qualified collection resource name string.
452
+ *
453
+ * @param {string} project
454
+ * @param {string} location
455
+ * @param {string} collection
456
+ * @returns {string} Resource name string.
457
+ */
458
+ collectionPath(project: string, location: string, collection: string): string;
459
+ /**
460
+ * Parse the project from Collection resource.
461
+ *
462
+ * @param {string} collectionName
463
+ * A fully-qualified path representing Collection resource.
464
+ * @returns {string} A string representing the project.
465
+ */
466
+ matchProjectFromCollectionName(collectionName: string): string | number;
467
+ /**
468
+ * Parse the location from Collection resource.
469
+ *
470
+ * @param {string} collectionName
471
+ * A fully-qualified path representing Collection resource.
472
+ * @returns {string} A string representing the location.
473
+ */
474
+ matchLocationFromCollectionName(collectionName: string): string | number;
475
+ /**
476
+ * Parse the collection from Collection resource.
477
+ *
478
+ * @param {string} collectionName
479
+ * A fully-qualified path representing Collection resource.
480
+ * @returns {string} A string representing the collection.
481
+ */
482
+ matchCollectionFromCollectionName(collectionName: string): string | number;
483
+ /**
484
+ * Return a fully-qualified dataObject resource name string.
485
+ *
486
+ * @param {string} project
487
+ * @param {string} location
488
+ * @param {string} collection
489
+ * @param {string} dataObject
490
+ * @returns {string} Resource name string.
491
+ */
492
+ dataObjectPath(project: string, location: string, collection: string, dataObject: string): string;
493
+ /**
494
+ * Parse the project from DataObject resource.
495
+ *
496
+ * @param {string} dataObjectName
497
+ * A fully-qualified path representing DataObject resource.
498
+ * @returns {string} A string representing the project.
499
+ */
500
+ matchProjectFromDataObjectName(dataObjectName: string): string | number;
501
+ /**
502
+ * Parse the location from DataObject resource.
503
+ *
504
+ * @param {string} dataObjectName
505
+ * A fully-qualified path representing DataObject resource.
506
+ * @returns {string} A string representing the location.
507
+ */
508
+ matchLocationFromDataObjectName(dataObjectName: string): string | number;
509
+ /**
510
+ * Parse the collection from DataObject resource.
511
+ *
512
+ * @param {string} dataObjectName
513
+ * A fully-qualified path representing DataObject resource.
514
+ * @returns {string} A string representing the collection.
515
+ */
516
+ matchCollectionFromDataObjectName(dataObjectName: string): string | number;
517
+ /**
518
+ * Parse the dataObject from DataObject resource.
519
+ *
520
+ * @param {string} dataObjectName
521
+ * A fully-qualified path representing DataObject resource.
522
+ * @returns {string} A string representing the dataObject.
523
+ */
524
+ matchDataObjectFromDataObjectName(dataObjectName: string): string | number;
525
+ /**
526
+ * Return a fully-qualified index resource name string.
527
+ *
528
+ * @param {string} project
529
+ * @param {string} location
530
+ * @param {string} collection
531
+ * @param {string} index
532
+ * @returns {string} Resource name string.
533
+ */
534
+ indexPath(project: string, location: string, collection: string, index: string): string;
535
+ /**
536
+ * Parse the project from Index resource.
537
+ *
538
+ * @param {string} indexName
539
+ * A fully-qualified path representing Index resource.
540
+ * @returns {string} A string representing the project.
541
+ */
542
+ matchProjectFromIndexName(indexName: string): string | number;
543
+ /**
544
+ * Parse the location from Index resource.
545
+ *
546
+ * @param {string} indexName
547
+ * A fully-qualified path representing Index resource.
548
+ * @returns {string} A string representing the location.
549
+ */
550
+ matchLocationFromIndexName(indexName: string): string | number;
551
+ /**
552
+ * Parse the collection from Index resource.
553
+ *
554
+ * @param {string} indexName
555
+ * A fully-qualified path representing Index resource.
556
+ * @returns {string} A string representing the collection.
557
+ */
558
+ matchCollectionFromIndexName(indexName: string): string | number;
559
+ /**
560
+ * Parse the index from Index resource.
561
+ *
562
+ * @param {string} indexName
563
+ * A fully-qualified path representing Index resource.
564
+ * @returns {string} A string representing the index.
565
+ */
566
+ matchIndexFromIndexName(indexName: string): string | number;
567
+ /**
568
+ * Terminate the gRPC channel and close the client.
569
+ *
570
+ * The client will no longer be usable and all future behavior is undefined.
571
+ * @returns {Promise} A promise that resolves when the client is closed.
572
+ */
573
+ close(): Promise<void>;
574
+ }