@google-cloud/pubsub 2.16.6 → 2.18.2

package/build/src/publisher/message-batch.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-batch.js","sourceRoot":"","sources":["../../../src/publisher/message-batch.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,yBAAgE;AAQhE;;;;;;;;GAQG;AACH;;;;;;GAMG;AACH,MAAa,YAAY;IAMvB,YAAY,OAA4B;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,OAA4B;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,OAAsB,EAAE,QAAyB;QACnD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,IAAK,CAAC,MAAM,CAAC;IACrC,CAAC;IACD;;;;;OAKG;IACH,MAAM,CAAC,EAAC,IAAI,EAAgB;QAC1B,MAAM,EAAC,WAAW,EAAE,QAAQ,EAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7C,OAAO,CACL,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,WAAY;YACnC,IAAI,CAAC,KAAK,GAAG,IAAK,CAAC,MAAM,IAAI,QAAS,CACvC,CAAC;IACJ,CAAC;IACD;;;;;;OAMG;IACH,OAAO;QACL,MAAM,EAAC,WAAW,EAAE,QAAQ,EAAC,GAAG,eAAY,CAAC;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,WAAY,IAAI,IAAI,CAAC,KAAK,IAAI,QAAS,CAAC;IACzE,CAAC;IACD;;;;OAIG;IACH,MAAM;QACJ,MAAM,EAAC,WAAW,EAAE,QAAQ,EAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,WAAY,IAAI,IAAI,CAAC,KAAK,IAAI,QAAS,CAAC;IACzE,CAAC;CACF;AAnED,oCAmEC"}
+{"version":3,"file":"message-batch.js","sourceRoot":"","sources":["../../../src/publisher/message-batch.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,yBAAgE;AAChE,qDAAsD;AAQtD;;;;;;;;GAQG;AACH;;;;;;GAMG;AACH,MAAa,YAAY;IAMvB,YAAY,OAA4B;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,OAA4B;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,OAAsB,EAAE,QAAyB;QACnD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,IAAI,qCAAoB,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IACD;;;;;OAKG;IACH,MAAM,CAAC,OAAsB;QAC3B,MAAM,EAAC,WAAW,EAAE,QAAQ,EAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7C,OAAO,CACL,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,WAAY;YACnC,IAAI,CAAC,KAAK,GAAG,qCAAoB,CAAC,OAAO,CAAC,IAAI,QAAS,CACxD,CAAC;IACJ,CAAC;IACD;;;;;;OAMG;IACH,OAAO;QACL,MAAM,EAAC,WAAW,EAAE,QAAQ,EAAC,GAAG,eAAY,CAAC;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,WAAY,IAAI,IAAI,CAAC,KAAK,IAAI,QAAS,CAAC;IACzE,CAAC;IACD;;;;OAIG;IACH,MAAM;QACJ,MAAM,EAAC,WAAW,EAAE,QAAQ,EAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,WAAY,IAAI,IAAI,CAAC,KAAK,IAAI,QAAS,CAAC;IACzE,CAAC;CACF;AAnED,oCAmEC"}

package/build/src/publisher/message-queues.js.map

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

package/build/src/publisher/pubsub-message.d.ts

@@ -0,0 +1,52 @@
+/*!
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { google } from '../../protos/protos';
+/**
+ * Strings are the only allowed values for keys and values in message attributes.
+ */
+export declare type Attributes = Record<string, string>;
+/**
+ * The basic {data, attributes} for a message to be published.
+ */
+export interface PubsubMessage extends google.pubsub.v1.IPubsubMessage {
+    /**
+     * If we've calculated the size of this message, it will be cached here.
+     * This is done to avoid having to build up the attribute size over and over.
+     *
+     * This field should not be used outside of this library. Its implementation
+     * may change, and it may disappear later.
+     *
+     * @private
+     */
+    calculatedSize?: number;
+}
+/**
+ * Precisely calculates the size of a message with optional `data` and
+ * `attributes` fields. If a `data` field is present, its {@link Buffer#length}
+ * member will be used. If `attributes` are present, each attribute's
+ * key and value will be calculated for byte length.
+ *
+ * When the calculation is complete, the result will be stored in
+ * `calculatedSize`. Since this calculation is generally only done
+ * after the message has been handed off to this library, there shouldn't
+ * be an issue with it being updated after the fact.
+ *
+ * This should not be used outside of this library. Its implementation
+ * may change.
+ *
+ * @private
+ */
+export declare function calculateMessageSize(message: PubsubMessage | google.pubsub.v1.IPubsubMessage): number;

package/build/src/publisher/pubsub-message.js

@@ -0,0 +1,56 @@
+"use strict";
+/*!
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateMessageSize = void 0;
+/**
+ * Precisely calculates the size of a message with optional `data` and
+ * `attributes` fields. If a `data` field is present, its {@link Buffer#length}
+ * member will be used. If `attributes` are present, each attribute's
+ * key and value will be calculated for byte length.
+ *
+ * When the calculation is complete, the result will be stored in
+ * `calculatedSize`. Since this calculation is generally only done
+ * after the message has been handed off to this library, there shouldn't
+ * be an issue with it being updated after the fact.
+ *
+ * This should not be used outside of this library. Its implementation
+ * may change.
+ *
+ * @private
+ */
+function calculateMessageSize(message) {
+    // If it's not a PubsubMessage, we'll augment it into one.
+    const msg = message;
+    if (msg.calculatedSize !== undefined) {
+        return msg.calculatedSize;
+    }
+    let size = 0;
+    if (msg.data) {
+        size += msg.data.length;
+    }
+    if (msg.attributes) {
+        const attrs = msg.attributes;
+        for (const key of Object.getOwnPropertyNames(attrs)) {
+            const val = attrs[key] || '';
+            size += Buffer.byteLength(key + val);
+        }
+    }
+    msg.calculatedSize = size;
+    return size;
+}
+exports.calculateMessageSize = calculateMessageSize;
+//# sourceMappingURL=pubsub-message.js.map

package/build/src/publisher/pubsub-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub-message.js","sourceRoot":"","sources":["../../../src/publisher/pubsub-message.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAyBH;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,oBAAoB,CAClC,OAAwD;IAExD,0DAA0D;IAC1D,MAAM,GAAG,GAAG,OAAmC,CAAC;IAEhD,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS,EAAE;QACpC,OAAO,GAAG,CAAC,cAAc,CAAC;KAC3B;IAED,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,IAAI,GAAG,CAAC,IAAI,EAAE;QACZ,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;KACzB;IACD,IAAI,GAAG,CAAC,UAAU,EAAE;QAClB,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE;YACnD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;SACtC;KACF;IAED,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAzBD,oDAyBC"}

package/build/src/pubsub.d.ts

@@ -126,18 +126,24 @@ interface GetClientCallback {
  *
  * @param {ClientConfig} [options] Configuration options.
  *
- * @example <caption>Import the client library</caption>
+ * @example Import the client library
+ * ```
  * const {PubSub} = require('@google-cloud/pubsub');
  *
- * @example <caption>Create a client that uses <a href="https://cloud.google.com/docs/authentication/production#providing_credentials_to_your_application">Application Default Credentials (ADC)</a>:</caption>
+ * ```
+ * @example Create a client that uses <a href="https://cloud.google.com/docs/authentication/production#providing_credentials_to_your_application">Application Default Credentials (ADC)</a>:
+ * ```
  * const pubsub = new PubSub();
  *
- * @example <caption>Create a client with <a href="https://cloud.google.com/docs/authentication/production#obtaining_and_providing_service_account_credentials_manually">explicit credentials</a>:</caption>
+ * ```
+ * @example Create a client with <a href="https://cloud.google.com/docs/authentication/production#obtaining_and_providing_service_account_credentials_manually">explicit credentials</a>:
+ * ```
  * const pubsub = new PubSub({
  *   projectId: 'your-project-id',
  *   keyFilename: '/path/to/keyfile.json'
  * });
  *
+ * ```
  * @example <caption>include:samples/quickstart.js</caption>
  * region_tag:pubsub_quickstart_create_topic
  * Full quickstart example:
@@ -164,6 +170,17 @@ export declare class PubSub {
      * @returns {boolean} true if the name is resolved.
      */
     get isIdResolved(): boolean;
+    /**
+     * Closes out this object, releasing any server connections. Note that once
+     * you close a PubSub object, it may not be used again. Any pending operations
+     * (e.g. queued publish messages) will fail. If you have topic or subscription
+     * objects that may have pending operations, you should call close() on those
+     * first if you want any pending messages to be delivered correctly. The
+     * PubSub class doesn't track those.
+     *
+     * @callback EmptyCallback
+     * @returns {Promise<void>}
+     */
     close(): Promise<void>;
     close(callback: EmptyCallback): void;
     /**
@@ -183,7 +200,8 @@ export declare class PubSub {
      *   here: https://googleapis.github.io/gax-nodejs/interfaces/CallOptions.html.
      * @returns {Promise<Schema>}
      *
-     * @example <caption>Create a schema.</caption>
+     * @example Create a schema.
+     * ```
      * const {PubSub} = require('@google-cloud/pubsub');
      * const pubsub = new PubSub();
      *
@@ -192,14 +210,171 @@ export declare class PubSub {
      *   SchemaTypes.Avro,
      *   '{...avro definition...}'
      * );
+     * ```
      */
     createSchema(schemaId: string, type: SchemaType, definition: string, gaxOpts?: CallOptions): Promise<Schema>;
+    /**
+     * @typedef {array} CreateSubscriptionResponse
+     * @property {Subscription} 0 The new {@link Subscription}.
+     * @property {object} 1 The full API response.
+     */
+    /**
+     * @callback CreateSubscriptionCallback
+     * @param {?Error} err Request error, if any.
+     * @param {Subscription} Subscription
+     * @param {object} apiResponse The full API response.
+     */
+    /**
+     * Options for creating a subscription.
+     *
+     * See a [Subscription
+     * resource](https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.subscriptions).
+     *
+     * @typedef {object} CreateSubscriptionRequest
+     * @property {DeadLetterPolicy} [deadLetterPolicy] A policy that specifies the
+     *     conditions for dead lettering messages in this subscription.
+     * @property {object} [flowControl] Flow control configurations for
+     *     receiving messages. Note that these options do not persist across
+     *     subscription instances.
+     * @property {number} [flowControl.maxBytes] The maximum number of bytes
+     *     in un-acked messages to allow before the subscription pauses incoming
+     *     messages. Defaults to 20% of free memory.
+     * @property {number} [flowControl.maxMessages=Infinity] The maximum number
+     *     of un-acked messages to allow before the subscription pauses incoming
+     *     messages.
+     * @property {object} [gaxOpts] Request configuration options, outlined
+     *     here: https://googleapis.github.io/gax-nodejs/interfaces/CallOptions.html.
+     * @property {number|google.protobuf.Duration} [messageRetentionDuration] Set
+     *     this to override the default duration of 7 days. This value is expected
+     *     in seconds. Acceptable values are in the range of 10 minutes and 7
+     *     days.
+     * @property {string} [pushEndpoint] A URL to a custom endpoint that
+     *     messages should be pushed to.
+     * @property {object} [oidcToken] If specified, Pub/Sub will generate and
+     *     attach an OIDC JWT token as an `Authorization` header in the HTTP
+     *     request for every pushed message. This object should have the same
+     *     structure as [OidcToken]{@link google.pubsub.v1.OidcToken}
+     * @property {boolean} [retainAckedMessages=false] If set, acked messages
+     *     are retained in the subscription's backlog for the length of time
+     *     specified by `options.messageRetentionDuration`.
+     * @property {ExpirationPolicy} [expirationPolicy] A policy that specifies
+     *     the conditions for this subscription's expiration.
+     */
+    /**
+     * Create a subscription to a topic.
+     *
+     * @see [Subscriptions: create API Documentation]{@link https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.subscriptions/create}
+     * @see {@link Topic#createSubscription}
+     *
+     * @throws {Error} If a Topic instance or topic name is not provided.
+     * @throws {Error} If a subscription name is not provided.
+     *
+     * @param {Topic|string} topic The Topic to create a subscription to.
+     * @param {string} name The name of the subscription.
+     * @param {CreateSubscriptionRequest} [options] See a [Subscription resource](https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.subscriptions).
+     * @param {CreateSubscriptionCallback} [callback] Callback function.
+     * @returns {Promise<CreateSubscriptionResponse>}
+     *
+     * @example Subscribe to a topic.
+     * ```
+     * const {PubSub} = require('@google-cloud/pubsub');
+     * const pubsub = new PubSub();
+     *
+     * const topic = 'messageCenter';
+     * const name = 'newMessages';
+     *
+     * const callback = function(err, subscription, apiResponse) {};
+     *
+     * pubsub.createSubscription(topic, name, callback);
+     *
+     * ```
+     * @example If the callback is omitted, we'll return a Promise.
+     * ```
+     * pubsub.createSubscription(topic, name)
+     *   .then(function(data) {
+     *     const subscription = data[0];
+     *     const apiResponse = data[1];
+     *   });
+     * ```
+     */
     createSubscription(topic: Topic | string, name: string, options?: CreateSubscriptionOptions): Promise<CreateSubscriptionResponse>;
     createSubscription(topic: Topic | string, name: string, callback: CreateSubscriptionCallback): void;
     createSubscription(topic: Topic | string, name: string, options: CreateSubscriptionOptions, callback: CreateSubscriptionCallback): void;
+    /**
+     * @typedef {array} CreateTopicResponse
+     * @property {Topic} 0 The new {@link Topic}.
+     * @property {object} 1 The full API response.
+     */
+    /**
+     * @callback CreateTopicCallback
+     * @param {?Error} err Request error, if any.
+     * @param {Topic} topic The new {@link Topic}.
+     * @param {object} apiResponse The full API response.
+     */
+    /**
+     * Create a topic with the given name.
+     *
+     * @see [Topics: create API Documentation]{@link https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.topics/create}
+     *
+     * @param {string} name Name of the topic.
+     * @param {object} [gaxOpts] Request configuration options, outlined
+     *     here: https://googleapis.github.io/gax-nodejs/interfaces/CallOptions.html.
+     * @param {CreateTopicCallback} [callback] Callback function.
+     * @returns {Promise<CreateTopicResponse>}
+     *
+     * @example
+     * ```
+     * const {PubSub} = require('@google-cloud/pubsub');
+     * const pubsub = new PubSub();
+     *
+     * pubsub.createTopic('my-new-topic', function(err, topic, apiResponse) {
+     *   if (!err) {
+     *     // The topic was created successfully.
+     *   }
+     * });
+     *
+     * //-
+     * // If the callback is omitted, we'll return a Promise.
+     * //-
+     * pubsub.createTopic('my-new-topic').then(function(data) {
+     *   const topic = data[0];
+     *   const apiResponse = data[1];
+     * });
+     * ```
+     */
     createTopic(name: string | TopicMetadata, gaxOpts?: CallOptions): Promise<CreateTopicResponse>;
     createTopic(name: string | TopicMetadata, callback: CreateTopicCallback): void;
     createTopic(name: string | TopicMetadata, gaxOpts: CallOptions, callback: CreateTopicCallback): void;
+    /**
+     * Detach a subscription with the given name.
+     *
+     * @see [Admin: Pub/Sub administration API Documentation]{@link https://cloud.google.com/pubsub/docs/admin}
+     *
+     * @param {string} name Name of the subscription.
+     * @param {object} [gaxOpts] Request configuration options, outlined
+     *     here: https://googleapis.github.io/gax-nodejs/interfaces/CallOptions.html.
+     * @param {DetachSubscriptionCallback} [callback] Callback function.
+     * @returns {Promise<DetachSubscriptionResponse>}
+     *
+     * @example
+     * ```
+     * const {PubSub} = require('@google-cloud/pubsub');
+     * const pubsub = new PubSub();
+     *
+     * pubsub.detachSubscription('my-sub', (err, topic, apiResponse) => {
+     *   if (!err) {
+     *     // The topic was created successfully.
+     *   }
+     * });
+     *
+     * //-
+     * // If the callback is omitted, we'll return a Promise.
+     * //-
+     * pubsub.detachSubscription('my-sub').then(data => {
+     *   const apiResponse = data[0];
+     * });
+     * ```
+     */
     detachSubscription(name: string, gaxOpts?: CallOptions): Promise<DetachSubscriptionResponse>;
     detachSubscription(name: string, callback: DetachSubscriptionCallback): void;
     detachSubscription(name: string, gaxOpts: CallOptions, callback: DetachSubscriptionCallback): void;
@@ -237,17 +412,184 @@ export declare class PubSub {
      * @returns {AsyncIterable<ISchema>}
      *
      * @example
+     * ```
      * for await (const s of pubsub.listSchemas()) {
      *   const moreInfo = await s.get();
      * }
+     * ```
      */
     listSchemas(view?: SchemaView, options?: CallOptions): AsyncIterable<google.pubsub.v1.ISchema>;
+    /**
+     * Query object for listing snapshots.
+     *
+     * @typedef {object} GetSnapshotsRequest
+     * @property {boolean} [autoPaginate=true] Have pagination handled
+     *     automatically.
+     * @property {object} [options.gaxOpts] Request configuration options, outlined
+     *     here: https://googleapis.github.io/gax-nodejs/interfaces/CallOptions.html.
+     * @property {number} [options.pageSize] Maximum number of results to return.
+     * @property {string} [options.pageToken] Page token.
+     */
+    /**
+     * @typedef {array} GetSnapshotsResponse
+     * @property {Snapshot[]} 0 Array of {@link Snapshot} instances.
+     * @property {object} 1 The full API response.
+     */
+    /**
+     * @callback GetSnapshotsCallback
+     * @param {?Error} err Request error, if any.
+     * @param {Snapshot[]} snapshots Array of {@link Snapshot} instances.
+     * @param {object} apiResponse The full API response.
+     */
+    /**
+     * Get a list of snapshots.
+     *
+     * @param {GetSnapshotsRequest} [query] Query object for listing snapshots.
+     * @param {GetSnapshotsCallback} [callback] Callback function.
+     * @returns {Promise<GetSnapshotsResponse>}
+     *
+     * @example
+     * ```
+     * const {PubSub} = require('@google-cloud/pubsub');
+     * const pubsub = new PubSub();
+     *
+     * pubsub.getSnapshots(function(err, snapshots) {
+     *   if (!err) {
+     *     // snapshots is an array of Snapshot objects.
+     *   }
+     * });
+     *
+     * //-
+     * // If the callback is omitted, we'll return a Promise.
+     * //-
+     * pubsub.getSnapshots().then(function(data) {
+     *   const snapshots = data[0];
+     * });
+     * ```
+     */
     getSnapshots(options?: PageOptions): Promise<GetSnapshotsResponse>;
     getSnapshots(callback: GetSnapshotsCallback): void;
     getSnapshots(options: PageOptions, callback: GetSnapshotsCallback): void;
+    /**
+     * Query object for listing subscriptions.
+     *
+     * @typedef {object} GetSubscriptionsRequest
+     * @property {boolean} [autoPaginate=true] Have pagination handled
+     *     automatically.
+     * @property {object} [options.gaxOpts] Request configuration options, outlined
+     *     here: https://googleapis.github.io/gax-nodejs/interfaces/CallOptions.html.
+     * @property {number} [options.pageSize] Maximum number of results to return.
+     * @property {string} [options.pageToken] Page token.
+     * @param {string|Topic} options.topic - The name of the topic to
+     *     list subscriptions from.
+     */
+    /**
+     * @typedef {array} GetSubscriptionsResponse
+     * @property {Subscription[]} 0 Array of {@link Subscription} instances.
+     * @property {object} 1 The full API response.
+     */
+    /**
+     * @callback GetSubscriptionsCallback
+     * @param {?Error} err Request error, if any.
+     * @param {Subscription[]} subscriptions Array of {@link Subscription} instances.
+     * @param {object} apiResponse The full API response.
+     */
+    /**
+     * Get a list of the subscriptions registered to all of your project's topics.
+     * You may optionally provide a query object as the first argument to
+     * customize the response.
+     *
+     * Your provided callback will be invoked with an error object if an API error
+     * occurred or an array of {@link Subscription} objects.
+     *
+     * To get subscriptions for a topic, see {@link Topic}.
+     *
+     * @see [Subscriptions: list API Documentation]{@link https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.subscriptions/list}
+     *
+     * @param {GetSubscriptionsRequest} [query] Query object for listing subscriptions.
+     * @param {GetSubscriptionsCallback} [callback] Callback function.
+     * @returns {Promise<GetSubscriptionsResponse>}
+     *
+     * @example
+     * ```
+     * const {PubSub} = require('@google-cloud/pubsub');
+     * const pubsub = new PubSub();
+     *
+     * pubsub.getSubscriptions(function(err, subscriptions) {
+     *   if (!err) {
+     *     // subscriptions is an array of Subscription objects.
+     *   }
+     * });
+     *
+     * //-
+     * // If the callback is omitted, we'll return a Promise.
+     * //-
+     * pubsub.getSubscriptions().then(function(data) {
+     *   const subscriptions = data[0];
+     * });
+     * ```
+     */
     getSubscriptions(options?: GetSubscriptionsOptions): Promise<GetSubscriptionsResponse>;
     getSubscriptions(callback: GetSubscriptionsCallback): void;
     getSubscriptions(options: GetSubscriptionsOptions, callback: GetSubscriptionsCallback): void;
+    /**
+     * Query object for listing topics.
+     *
+     * @typedef {object} GetTopicsRequest
+     * @property {boolean} [autoPaginate=true] Have pagination handled
+     *     automatically.
+     * @property {object} [options.gaxOpts] Request configuration options, outlined
+     *     here: https://googleapis.github.io/gax-nodejs/interfaces/CallOptions.html.
+     * @property {number} [options.pageSize] Maximum number of results to return.
+     * @property {string} [options.pageToken] Page token.
+     */
+    /**
+     * @typedef {array} GetTopicsResponse
+     * @property {Topic[]} 0 Array of {@link Topic} instances.
+     * @property {object} 1 The full API response.
+     */
+    /**
+     * @callback GetTopicsCallback
+     * @param {?Error} err Request error, if any.
+     * @param {Topic[]} topics Array of {@link Topic} instances.
+     * @param {object} apiResponse The full API response.
+     */
+    /**
+     * Get a list of the topics registered to your project. You may optionally
+     * provide a query object as the first argument to customize the response.
+     *
+     * @see [Topics: list API Documentation]{@link https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.topics/list}
+     *
+     * @param {GetTopicsRequest} [query] Query object for listing topics.
+     * @param {GetTopicsCallback} [callback] Callback function.
+     * @returns {Promise<GetTopicsResponse>}
+     *
+     * @example
+     * ```
+     * const {PubSub} = require('@google-cloud/pubsub');
+     * const pubsub = new PubSub();
+     *
+     * pubsub.getTopics(function(err, topics) {
+     *   if (!err) {
+     *     // topics is an array of Topic objects.
+     *   }
+     * });
+     *
+     * //-
+     * // Customize the query.
+     * //-
+     * pubsub.getTopics({
+     *   pageSize: 3
+     * }, function(err, topics) {});
+     *
+     * //-
+     * // If the callback is omitted, we'll return a Promise.
+     * //-
+     * pubsub.getTopics().then(function(data) {
+     *   const topics = data[0];
+     * });
+     * ```
+     */
     getTopics(options?: PageOptions): Promise<GetTopicsResponse>;
     getTopics(callback: GetTopicsCallback): void;
     getTopics(options: PageOptions, callback: GetTopicsCallback): void;
@@ -327,10 +669,12 @@ export declare class PubSub {
      * @returns {Schema} A {@link Schema} instance.
      *
      * @example
+     * ```
      * const {PubSub} = require('@google-cloud/pubsub');
      * const pubsub = new PubSub();
      *
      * const schema = pubsub.schema('my-schema');
+     * ```
      */
     schema(idOrName: string): Schema;
     /**
@@ -343,10 +687,12 @@ export declare class PubSub {
      * @returns {Snapshot} A {@link Snapshot} instance.
      *
      * @example
+     * ```
      * const {PubSub} = require('@google-cloud/pubsub');
      * const pubsub = new PubSub();
      *
      * const snapshot = pubsub.snapshot('my-snapshot');
+     * ```
      */
     snapshot(name: string): Snapshot;
     /**
@@ -361,6 +707,7 @@ export declare class PubSub {
      * @returns {Subscription} A {@link Subscription} instance.
      *
      * @example
+     * ```
      * const {PubSub} = require('@google-cloud/pubsub');
      * const pubsub = new PubSub();
      *
@@ -375,6 +722,7 @@ export declare class PubSub {
      *   // message.attributes = Attributes of the message.
      *   // message.publishTime = Date when Pub/Sub received the message.
      * });
+     * ```
      */
     subscription(name: string, options?: SubscriptionOptions): Subscription;
     /**
@@ -387,10 +735,12 @@ export declare class PubSub {
      * @returns {Topic} A {@link Topic} instance.
      *
      * @example
+     * ```
      * const {PubSub} = require('@google-cloud/pubsub');
      * const pubsub = new PubSub();
      *
      * const topic = pubsub.topic('my-topic');
+     * ```
      */
     topic(name: string, options?: PublishOptions): Topic;
     /**