@google-cloud/apikeys 0.2.2 → 1.0.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.
@@ -122,9 +122,8 @@ export declare class ApiKeysClient {
122
122
  * @param {object} [options]
123
123
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
124
124
  * @returns {Promise} - The promise which resolves to an array.
125
- * The first element of the array is an object representing {@link google.api.apikeys.v2.Key | Key}.
126
- * Please see the
127
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
125
+ * The first element of the array is an object representing {@link protos.google.api.apikeys.v2.Key|Key}.
126
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
128
127
  * for more details and examples.
129
128
  * @example <caption>include:samples/generated/v2/api_keys.get_key.js</caption>
130
129
  * region_tag:apikeys_v2_generated_ApiKeys_GetKey_async
@@ -149,9 +148,8 @@ export declare class ApiKeysClient {
149
148
  * @param {object} [options]
150
149
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
151
150
  * @returns {Promise} - The promise which resolves to an array.
152
- * The first element of the array is an object representing {@link google.api.apikeys.v2.GetKeyStringResponse | GetKeyStringResponse}.
153
- * Please see the
154
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
151
+ * The first element of the array is an object representing {@link protos.google.api.apikeys.v2.GetKeyStringResponse|GetKeyStringResponse}.
152
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
155
153
  * for more details and examples.
156
154
  * @example <caption>include:samples/generated/v2/api_keys.get_key_string.js</caption>
157
155
  * region_tag:apikeys_v2_generated_ApiKeys_GetKeyString_async
@@ -177,9 +175,8 @@ export declare class ApiKeysClient {
177
175
  * @param {object} [options]
178
176
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
179
177
  * @returns {Promise} - The promise which resolves to an array.
180
- * The first element of the array is an object representing {@link google.api.apikeys.v2.LookupKeyResponse | LookupKeyResponse}.
181
- * Please see the
182
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
178
+ * The first element of the array is an object representing {@link protos.google.api.apikeys.v2.LookupKeyResponse|LookupKeyResponse}.
179
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
183
180
  * for more details and examples.
184
181
  * @example <caption>include:samples/generated/v2/api_keys.lookup_key.js</caption>
185
182
  * region_tag:apikeys_v2_generated_ApiKeys_LookupKey_async
@@ -221,8 +218,7 @@ export declare class ApiKeysClient {
221
218
  * The first element of the array is an object representing
222
219
  * a long running operation. Its `promise()` method returns a promise
223
220
  * you can `await` for.
224
- * Please see the
225
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
221
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
226
222
  * for more details and examples.
227
223
  * @example <caption>include:samples/generated/v2/api_keys.create_key.js</caption>
228
224
  * region_tag:apikeys_v2_generated_ApiKeys_CreateKey_async
@@ -240,8 +236,7 @@ export declare class ApiKeysClient {
240
236
  * The operation name that will be passed.
241
237
  * @returns {Promise} - The promise which resolves to an object.
242
238
  * The decoded operation object has result and metadata field to get information from.
243
- * Please see the
244
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
239
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
245
240
  * for more details and examples.
246
241
  * @example <caption>include:samples/generated/v2/api_keys.create_key.js</caption>
247
242
  * region_tag:apikeys_v2_generated_ApiKeys_CreateKey_async
@@ -274,8 +269,7 @@ export declare class ApiKeysClient {
274
269
  * The first element of the array is an object representing
275
270
  * a long running operation. Its `promise()` method returns a promise
276
271
  * you can `await` for.
277
- * Please see the
278
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
272
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
279
273
  * for more details and examples.
280
274
  * @example <caption>include:samples/generated/v2/api_keys.update_key.js</caption>
281
275
  * region_tag:apikeys_v2_generated_ApiKeys_UpdateKey_async
@@ -293,8 +287,7 @@ export declare class ApiKeysClient {
293
287
  * The operation name that will be passed.
294
288
  * @returns {Promise} - The promise which resolves to an object.
295
289
  * The decoded operation object has result and metadata field to get information from.
296
- * Please see the
297
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
290
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
298
291
  * for more details and examples.
299
292
  * @example <caption>include:samples/generated/v2/api_keys.update_key.js</caption>
300
293
  * region_tag:apikeys_v2_generated_ApiKeys_UpdateKey_async
@@ -320,8 +313,7 @@ export declare class ApiKeysClient {
320
313
  * The first element of the array is an object representing
321
314
  * a long running operation. Its `promise()` method returns a promise
322
315
  * you can `await` for.
323
- * Please see the
324
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
316
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
325
317
  * for more details and examples.
326
318
  * @example <caption>include:samples/generated/v2/api_keys.delete_key.js</caption>
327
319
  * region_tag:apikeys_v2_generated_ApiKeys_DeleteKey_async
@@ -339,8 +331,7 @@ export declare class ApiKeysClient {
339
331
  * The operation name that will be passed.
340
332
  * @returns {Promise} - The promise which resolves to an object.
341
333
  * The decoded operation object has result and metadata field to get information from.
342
- * Please see the
343
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
334
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
344
335
  * for more details and examples.
345
336
  * @example <caption>include:samples/generated/v2/api_keys.delete_key.js</caption>
346
337
  * region_tag:apikeys_v2_generated_ApiKeys_DeleteKey_async
@@ -362,8 +353,7 @@ export declare class ApiKeysClient {
362
353
  * The first element of the array is an object representing
363
354
  * a long running operation. Its `promise()` method returns a promise
364
355
  * you can `await` for.
365
- * Please see the
366
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
356
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
367
357
  * for more details and examples.
368
358
  * @example <caption>include:samples/generated/v2/api_keys.undelete_key.js</caption>
369
359
  * region_tag:apikeys_v2_generated_ApiKeys_UndeleteKey_async
@@ -381,8 +371,7 @@ export declare class ApiKeysClient {
381
371
  * The operation name that will be passed.
382
372
  * @returns {Promise} - The promise which resolves to an object.
383
373
  * The decoded operation object has result and metadata field to get information from.
384
- * Please see the
385
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
374
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
386
375
  * for more details and examples.
387
376
  * @example <caption>include:samples/generated/v2/api_keys.undelete_key.js</caption>
388
377
  * region_tag:apikeys_v2_generated_ApiKeys_UndeleteKey_async
@@ -409,14 +398,13 @@ export declare class ApiKeysClient {
409
398
  * @param {object} [options]
410
399
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
411
400
  * @returns {Promise} - The promise which resolves to an array.
412
- * The first element of the array is Array of {@link google.api.apikeys.v2.Key | Key}.
401
+ * The first element of the array is Array of {@link protos.google.api.apikeys.v2.Key|Key}.
413
402
  * The client library will perform auto-pagination by default: it will call the API as many
414
403
  * times as needed and will merge results from all the pages into this array.
415
404
  * Note that it can affect your quota.
416
405
  * We recommend using `listKeysAsync()`
417
406
  * method described below for async iteration which you can stop as needed.
418
- * Please see the
419
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
407
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
420
408
  * for more details and examples.
421
409
  */
422
410
  listKeys(request?: protos.google.api.apikeys.v2.IListKeysRequest, options?: CallOptions): Promise<[
@@ -442,13 +430,12 @@ export declare class ApiKeysClient {
442
430
  * @param {object} [options]
443
431
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
444
432
  * @returns {Stream}
445
- * An object stream which emits an object representing {@link google.api.apikeys.v2.Key | Key} on 'data' event.
433
+ * An object stream which emits an object representing {@link protos.google.api.apikeys.v2.Key|Key} on 'data' event.
446
434
  * The client library will perform auto-pagination by default: it will call the API as many
447
435
  * times as needed. Note that it can affect your quota.
448
436
  * We recommend using `listKeysAsync()`
449
437
  * method described below for async iteration which you can stop as needed.
450
- * Please see the
451
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
438
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
452
439
  * for more details and examples.
453
440
  */
454
441
  listKeysStream(request?: protos.google.api.apikeys.v2.IListKeysRequest, options?: CallOptions): Transform;
@@ -470,12 +457,11 @@ export declare class ApiKeysClient {
470
457
  * @param {object} [options]
471
458
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
472
459
  * @returns {Object}
473
- * An iterable Object that allows [async iteration](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols).
460
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
474
461
  * When you iterate the returned iterable, each element will be an object representing
475
- * {@link google.api.apikeys.v2.Key | Key}. The API will be called under the hood as needed, once per the page,
462
+ * {@link protos.google.api.apikeys.v2.Key|Key}. The API will be called under the hood as needed, once per the page,
476
463
  * so you can stop the iteration when you don't need more results.
477
- * Please see the
478
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
464
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
479
465
  * for more details and examples.
480
466
  * @example <caption>include:samples/generated/v2/api_keys.list_keys.js</caption>
481
467
  * region_tag:apikeys_v2_generated_ApiKeys_ListKeys_async
@@ -372,8 +372,7 @@ class ApiKeysClient {
372
372
  * The operation name that will be passed.
373
373
  * @returns {Promise} - The promise which resolves to an object.
374
374
  * The decoded operation object has result and metadata field to get information from.
375
- * Please see the
376
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
375
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
377
376
  * for more details and examples.
378
377
  * @example <caption>include:samples/generated/v2/api_keys.create_key.js</caption>
379
378
  * region_tag:apikeys_v2_generated_ApiKeys_CreateKey_async
@@ -411,8 +410,7 @@ class ApiKeysClient {
411
410
  * The operation name that will be passed.
412
411
  * @returns {Promise} - The promise which resolves to an object.
413
412
  * The decoded operation object has result and metadata field to get information from.
414
- * Please see the
415
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
413
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
416
414
  * for more details and examples.
417
415
  * @example <caption>include:samples/generated/v2/api_keys.update_key.js</caption>
418
416
  * region_tag:apikeys_v2_generated_ApiKeys_UpdateKey_async
@@ -450,8 +448,7 @@ class ApiKeysClient {
450
448
  * The operation name that will be passed.
451
449
  * @returns {Promise} - The promise which resolves to an object.
452
450
  * The decoded operation object has result and metadata field to get information from.
453
- * Please see the
454
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
451
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
455
452
  * for more details and examples.
456
453
  * @example <caption>include:samples/generated/v2/api_keys.delete_key.js</caption>
457
454
  * region_tag:apikeys_v2_generated_ApiKeys_DeleteKey_async
@@ -489,8 +486,7 @@ class ApiKeysClient {
489
486
  * The operation name that will be passed.
490
487
  * @returns {Promise} - The promise which resolves to an object.
491
488
  * The decoded operation object has result and metadata field to get information from.
492
- * Please see the
493
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
489
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
494
490
  * for more details and examples.
495
491
  * @example <caption>include:samples/generated/v2/api_keys.undelete_key.js</caption>
496
492
  * region_tag:apikeys_v2_generated_ApiKeys_UndeleteKey_async
@@ -538,13 +534,12 @@ class ApiKeysClient {
538
534
  * @param {object} [options]
539
535
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
540
536
  * @returns {Stream}
541
- * An object stream which emits an object representing {@link google.api.apikeys.v2.Key | Key} on 'data' event.
537
+ * An object stream which emits an object representing {@link protos.google.api.apikeys.v2.Key|Key} on 'data' event.
542
538
  * The client library will perform auto-pagination by default: it will call the API as many
543
539
  * times as needed. Note that it can affect your quota.
544
540
  * We recommend using `listKeysAsync()`
545
541
  * method described below for async iteration which you can stop as needed.
546
- * Please see the
547
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
542
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
548
543
  * for more details and examples.
549
544
  */
550
545
  listKeysStream(request, options) {
@@ -580,12 +575,11 @@ class ApiKeysClient {
580
575
  * @param {object} [options]
581
576
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
582
577
  * @returns {Object}
583
- * An iterable Object that allows [async iteration](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols).
578
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
584
579
  * When you iterate the returned iterable, each element will be an object representing
585
- * {@link google.api.apikeys.v2.Key | Key}. The API will be called under the hood as needed, once per the page,
580
+ * {@link protos.google.api.apikeys.v2.Key|Key}. The API will be called under the hood as needed, once per the page,
586
581
  * so you can stop the iteration when you don't need more results.
587
- * Please see the
588
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
582
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
589
583
  * for more details and examples.
590
584
  * @example <caption>include:samples/generated/v2/api_keys.list_keys.js</caption>
591
585
  * region_tag:apikeys_v2_generated_ApiKeys_ListKeys_async
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@google-cloud/apikeys",
3
- "version": "0.2.2",
3
+ "version": "1.0.0",
4
4
  "description": "API Keys API client for Node.js",
5
5
  "repository": {
6
6
  "type": "git",
@@ -31,7 +31,7 @@
31
31
  ],
32
32
  "scripts": {
33
33
  "clean": "gts clean",
34
- "compile": "tsc -p . && cp -r protos build/ && minifyProtoJson",
34
+ "compile": "tsc -p . && cp -r protos build/",
35
35
  "compile-protos": "compileProtos src",
36
36
  "docs": "jsdoc -c .jsdoc.js",
37
37
  "predocs-test": "npm run docs",
@@ -39,34 +39,33 @@
39
39
  "fix": "gts fix",
40
40
  "lint": "gts check",
41
41
  "prepare": "npm run compile-protos && npm run compile",
42
- "system-test": "npm run compile && c8 mocha build/system-test",
43
- "test": "c8 mocha build/test",
44
- "samples-test": "npm run compile && cd samples/ && npm link ../ && npm i && npm test",
45
- "prelint": "cd samples; npm link ../; npm i"
42
+ "prelint": "cd samples; npm link ../; npm i",
43
+ "postpack": "minifyProtoJson",
44
+ "samples-test": "cd samples/ && npm link ../ && npm i && npm test",
45
+ "system-test": "c8 mocha build/system-test",
46
+ "test": "c8 mocha build/test"
46
47
  },
47
48
  "dependencies": {
48
- "google-gax": "^3.5.8"
49
+ "google-gax": "^4.0.3"
49
50
  },
50
51
  "devDependencies": {
51
52
  "@types/mocha": "^9.0.0",
52
- "@types/node": "^18.0.0",
53
+ "@types/node": "^20.4.5",
53
54
  "@types/sinon": "^10.0.0",
54
- "c8": "^7.3.5",
55
- "gts": "^3.1.0",
55
+ "c8": "^8.0.1",
56
+ "gapic-tools": "^0.1.8",
57
+ "gts": "^5.0.0",
56
58
  "jsdoc": "^4.0.0",
57
59
  "jsdoc-fresh": "^2.0.0",
58
60
  "jsdoc-region-tag": "^2.0.0",
59
- "linkinator": "^4.0.0",
61
+ "linkinator": "4.1.2",
62
+ "long": "^5.2.3",
60
63
  "mocha": "^9.2.2",
61
- "null-loader": "^4.0.1",
62
64
  "pack-n-play": "^1.0.0-2",
63
65
  "sinon": "^15.0.0",
64
- "ts-loader": "^9.0.0",
65
- "typescript": "^4.6.4",
66
- "webpack": "^5.9.0",
67
- "webpack-cli": "^5.0.0"
66
+ "typescript": "^5.1.6"
68
67
  },
69
68
  "engines": {
70
- "node": ">=12.0.0"
69
+ "node": ">=14.0.0"
71
70
  }
72
71
  }