feat(pubsub): update the API

#### pubsub:v1

The following keys were added:
- schemas.JavaScriptUDF.description
- schemas.JavaScriptUDF.id
- schemas.JavaScriptUDF.properties.code.description
- schemas.JavaScriptUDF.properties.code.type
- schemas.JavaScriptUDF.properties.functionName.description
- schemas.JavaScriptUDF.properties.functionName.type
- schemas.JavaScriptUDF.type
- schemas.MessageTransform.description
- schemas.MessageTransform.id
- schemas.MessageTransform.properties.enabled.description
- schemas.MessageTransform.properties.enabled.type
- schemas.MessageTransform.properties.javascriptUdf.$ref
- schemas.MessageTransform.properties.javascriptUdf.description
- schemas.MessageTransform.type
- schemas.Subscription.properties.messageTransforms.description
- schemas.Subscription.properties.messageTransforms.items.$ref
- schemas.Subscription.properties.messageTransforms.type
- schemas.Topic.properties.messageTransforms.description
- schemas.Topic.properties.messageTransforms.items.$ref
- schemas.Topic.properties.messageTransforms.type

The following keys were changed:
- schemas.CloudStorageConfig.properties.maxDuration.description
- schemas.DeadLetterPolicy.properties.maxDeliveryAttempts.description
- schemas.RetryPolicy.description
- schemas.Subscription.properties.enableExactlyOnceDelivery.description
- schemas.Subscription.properties.retryPolicy.description

Author: yoshi-automation

discovery/pubsub-v1.json

@@ -1638,7 +1638,7 @@
       }
     }
   },
-  "revision": "20241231",
+  "revision": "20250218",
   "rootUrl": "https://pubsub.googleapis.com/",
   "schemas": {
     "AcknowledgeRequest": {
@@ -1996,7 +1996,7 @@
           "type": "string"
         },
         "maxDuration": {
-          "description": "Optional. The maximum duration that can elapse before a new Cloud Storage file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed the subscription's acknowledgement deadline.",
+          "description": "Optional. The maximum duration that can elapse before a new Cloud Storage file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed the subscription's acknowledgment deadline.",
           "format": "google-duration",
           "type": "string"
         },
@@ -2125,7 +2125,7 @@
           "type": "string"
         },
         "maxDeliveryAttempts": {
-          "description": "Optional. The maximum number of delivery attempts for any message. The value must be between 5 and 100. The number of delivery attempts is defined as 1 + (the sum of number of NACKs and number of times the acknowledgement deadline has been exceeded for the message). A NACK is any call to ModifyAckDeadline with a 0 deadline. Note that client libraries may automatically extend ack_deadlines. This field will be honored on a best effort basis. If this parameter is 0, a default value of 5 is used.",
+          "description": "Optional. The maximum number of delivery attempts for any message. The value must be between 5 and 100. The number of delivery attempts is defined as 1 + (the sum of number of NACKs and number of times the acknowledgment deadline has been exceeded for the message). A NACK is any call to ModifyAckDeadline with a 0 deadline. Note that client libraries may automatically extend ack_deadlines. This field will be honored on a best effort basis. If this parameter is 0, a default value of 5 is used.",
           "format": "int32",
           "type": "integer"
         }
@@ -2210,6 +2210,21 @@
       },
       "type": "object"
     },
+    "JavaScriptUDF": {
+      "description": "User-defined JavaScript function that can transform or filter a Pub/Sub message.",
+      "id": "JavaScriptUDF",
+      "properties": {
+        "code": {
+          "description": "Required. JavaScript code that contains a function `function_name` with the below signature: ``` /** * Transforms a Pub/Sub message. * @return {(Object)>|null)} - To * filter a message, return `null`. To transform a message return a map * with the following keys: * - (required) 'data' : {string} * - (optional) 'attributes' : {Object} * Returning empty `attributes` will remove all attributes from the * message. * * @param {(Object)>} Pub/Sub * message. Keys: * - (required) 'data' : {string} * - (required) 'attributes' : {Object} * * @param {Object} metadata - Pub/Sub message metadata. * Keys: * - (required) 'message_id' : {string} * - (optional) 'publish_time': {string} YYYY-MM-DDTHH:MM:SSZ format * - (optional) 'ordering_key': {string} */ function (message, metadata) { } ```",
+          "type": "string"
+        },
+        "functionName": {
+          "description": "Required. Name of the JavasScript function that should applied to Pub/Sub messages.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "ListSchemaRevisionsResponse": {
       "description": "Response for the `ListSchemaRevisions` method.",
       "id": "ListSchemaRevisionsResponse",
@@ -2354,6 +2369,21 @@
       },
       "type": "object"
     },
+    "MessageTransform": {
+      "description": "All supported message transforms types.",
+      "id": "MessageTransform",
+      "properties": {
+        "enabled": {
+          "description": "Optional. If set to true, the transform is enabled. If false, the transform is disabled and will not be applied to messages. Defaults to `true`.",
+          "type": "boolean"
+        },
+        "javascriptUdf": {
+          "$ref": "JavaScriptUDF",
+          "description": "Optional. JavaScript User Defined Function. If multiple JavaScriptUDF's are specified on a resource, each must have a unique `function_name`."
+        }
+      },
+      "type": "object"
+    },
     "ModifyAckDeadlineRequest": {
       "description": "Request for the ModifyAckDeadline method.",
       "id": "ModifyAckDeadlineRequest",
@@ -2615,7 +2645,7 @@
       "type": "object"
     },
     "RetryPolicy": {
-      "description": "A policy that specifies how Pub/Sub retries message delivery. Retry delay will be exponential based on provided minimum and maximum backoffs. https://en.wikipedia.org/wiki/Exponential_backoff. RetryPolicy will be triggered on NACKs or acknowledgement deadline exceeded events for a given message. Retry Policy is implemented on a best effort basis. At times, the delay between consecutive deliveries may not match the configuration. That is, delay can be more or less than configured backoff.",
+      "description": "A policy that specifies how Pub/Sub retries message delivery. Retry delay will be exponential based on provided minimum and maximum backoffs. https://en.wikipedia.org/wiki/Exponential_backoff. RetryPolicy will be triggered on NACKs or acknowledgment deadline exceeded events for a given message. Retry Policy is implemented on a best effort basis. At times, the delay between consecutive deliveries may not match the configuration. That is, delay can be more or less than configured backoff.",
       "id": "RetryPolicy",
       "properties": {
         "maximumBackoff": {
@@ -2806,7 +2836,7 @@
           "type": "boolean"
         },
         "enableExactlyOnceDelivery": {
-          "description": "Optional. If true, Pub/Sub provides the following guarantees for the delivery of a message with a given value of `message_id` on this subscription: * The message sent to a subscriber is guaranteed not to be resent before the message's acknowledgement deadline expires. * An acknowledged message will not be resent to a subscriber. Note that subscribers may still receive multiple copies of a message when `enable_exactly_once_delivery` is true if the message was published multiple times by a publisher client. These copies are considered distinct by Pub/Sub and have distinct `message_id` values.",
+          "description": "Optional. If true, Pub/Sub provides the following guarantees for the delivery of a message with a given value of `message_id` on this subscription: * The message sent to a subscriber is guaranteed not to be resent before the message's acknowledgment deadline expires. * An acknowledged message will not be resent to a subscriber. Note that subscribers may still receive multiple copies of a message when `enable_exactly_once_delivery` is true if the message was published multiple times by a publisher client. These copies are considered distinct by Pub/Sub and have distinct `message_id` values.",
           "type": "boolean"
         },
         "enableMessageOrdering": {
@@ -2833,6 +2863,13 @@
           "format": "google-duration",
           "type": "string"
         },
+        "messageTransforms": {
+          "description": "Optional. Transforms to be applied to messages before they are delivered to subscribers. Transforms are applied in the order specified.",
+          "items": {
+            "$ref": "MessageTransform"
+          },
+          "type": "array"
+        },
         "name": {
           "description": "Required. The name of the subscription. It must have the format `\"projects/{project}/subscriptions/{subscription}\"`. `{subscription}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `\"goog\"`.",
           "type": "string"
@@ -2847,7 +2884,7 @@
         },
         "retryPolicy": {
           "$ref": "RetryPolicy",
-          "description": "Optional. A policy that specifies how Pub/Sub retries message delivery for this subscription. If not set, the default retry policy is applied. This generally implies that messages will be retried as soon as possible for healthy subscribers. RetryPolicy will be triggered on NACKs or acknowledgement deadline exceeded events for a given message."
+          "description": "Optional. A policy that specifies how Pub/Sub retries message delivery for this subscription. If not set, the default retry policy is applied. This generally implies that messages will be retried as soon as possible for healthy subscribers. RetryPolicy will be triggered on NACKs or acknowledgment deadline exceeded events for a given message."
         },
         "state": {
           "description": "Output only. An output-only field indicating whether or not the subscription can receive messages.",
@@ -2950,6 +2987,13 @@
           "$ref": "MessageStoragePolicy",
           "description": "Optional. Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored. If not present, then no constraints are in effect."
         },
+        "messageTransforms": {
+          "description": "Optional. Transforms to be applied to messages published to the topic. Transforms are applied in the order specified.",
+          "items": {
+            "$ref": "MessageTransform"
+          },
+          "type": "array"
+        },
         "name": {
           "description": "Required. The name of the topic. It must have the format `\"projects/{project}/topics/{topic}\"`. `{topic}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `\"goog\"`.",
           "type": "string"

src/apis/pubsub/v1.ts

@@ -362,7 +362,7 @@ export namespace pubsub_v1 {
      */
     maxBytes?: string | null;
     /**
-     * Optional. The maximum duration that can elapse before a new Cloud Storage file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed the subscription's acknowledgement deadline.
+     * Optional. The maximum duration that can elapse before a new Cloud Storage file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed the subscription's acknowledgment deadline.
      */
     maxDuration?: string | null;
     /**
@@ -442,7 +442,7 @@ export namespace pubsub_v1 {
      */
     deadLetterTopic?: string | null;
     /**
-     * Optional. The maximum number of delivery attempts for any message. The value must be between 5 and 100. The number of delivery attempts is defined as 1 + (the sum of number of NACKs and number of times the acknowledgement deadline has been exceeded for the message). A NACK is any call to ModifyAckDeadline with a 0 deadline. Note that client libraries may automatically extend ack_deadlines. This field will be honored on a best effort basis. If this parameter is 0, a default value of 5 is used.
+     * Optional. The maximum number of delivery attempts for any message. The value must be between 5 and 100. The number of delivery attempts is defined as 1 + (the sum of number of NACKs and number of times the acknowledgment deadline has been exceeded for the message). A NACK is any call to ModifyAckDeadline with a 0 deadline. Note that client libraries may automatically extend ack_deadlines. This field will be honored on a best effort basis. If this parameter is 0, a default value of 5 is used.
      */
     maxDeliveryAttempts?: number | null;
   }
@@ -513,6 +513,19 @@ export namespace pubsub_v1 {
      */
     platformLogsSettings?: Schema$PlatformLogsSettings;
   }
+  /**
+   * User-defined JavaScript function that can transform or filter a Pub/Sub message.
+   */
+  export interface Schema$JavaScriptUDF {
+    /**
+     * Required. JavaScript code that contains a function `function_name` with the below signature: ``` /x* * Transforms a Pub/Sub message. * @return {(Object)\>|null)\} - To * filter a message, return `null`. To transform a message return a map * with the following keys: * - (required) 'data' : {string\} * - (optional) 'attributes' : {Object\} * Returning empty `attributes` will remove all attributes from the * message. * * @param {(Object)\>\} Pub/Sub * message. Keys: * - (required) 'data' : {string\} * - (required) 'attributes' : {Object\} * * @param {Object\} metadata - Pub/Sub message metadata. * Keys: * - (required) 'message_id' : {string\} * - (optional) 'publish_time': {string\} YYYY-MM-DDTHH:MM:SSZ format * - (optional) 'ordering_key': {string\} x/ function (message, metadata) { \} ```
+     */
+    code?: string | null;
+    /**
+     * Required. Name of the JavasScript function that should applied to Pub/Sub messages.
+     */
+    functionName?: string | null;
+  }
   /**
    * Response for the `ListSchemaRevisions` method.
    */
@@ -617,6 +630,19 @@ export namespace pubsub_v1 {
      */
     enforceInTransit?: boolean | null;
   }
+  /**
+   * All supported message transforms types.
+   */
+  export interface Schema$MessageTransform {
+    /**
+     * Optional. If set to true, the transform is enabled. If false, the transform is disabled and will not be applied to messages. Defaults to `true`.
+     */
+    enabled?: boolean | null;
+    /**
+     * Optional. JavaScript User Defined Function. If multiple JavaScriptUDF's are specified on a resource, each must have a unique `function_name`.
+     */
+    javascriptUdf?: Schema$JavaScriptUDF;
+  }
   /**
    * Request for the ModifyAckDeadline method.
    */
@@ -803,7 +829,7 @@ export namespace pubsub_v1 {
     message?: Schema$PubsubMessage;
   }
   /**
-   * A policy that specifies how Pub/Sub retries message delivery. Retry delay will be exponential based on provided minimum and maximum backoffs. https://en.wikipedia.org/wiki/Exponential_backoff. RetryPolicy will be triggered on NACKs or acknowledgement deadline exceeded events for a given message. Retry Policy is implemented on a best effort basis. At times, the delay between consecutive deliveries may not match the configuration. That is, delay can be more or less than configured backoff.
+   * A policy that specifies how Pub/Sub retries message delivery. Retry delay will be exponential based on provided minimum and maximum backoffs. https://en.wikipedia.org/wiki/Exponential_backoff. RetryPolicy will be triggered on NACKs or acknowledgment deadline exceeded events for a given message. Retry Policy is implemented on a best effort basis. At times, the delay between consecutive deliveries may not match the configuration. That is, delay can be more or less than configured backoff.
    */
   export interface Schema$RetryPolicy {
     /**
@@ -946,7 +972,7 @@ export namespace pubsub_v1 {
      */
     detached?: boolean | null;
     /**
-     * Optional. If true, Pub/Sub provides the following guarantees for the delivery of a message with a given value of `message_id` on this subscription: * The message sent to a subscriber is guaranteed not to be resent before the message's acknowledgement deadline expires. * An acknowledged message will not be resent to a subscriber. Note that subscribers may still receive multiple copies of a message when `enable_exactly_once_delivery` is true if the message was published multiple times by a publisher client. These copies are considered distinct by Pub/Sub and have distinct `message_id` values.
+     * Optional. If true, Pub/Sub provides the following guarantees for the delivery of a message with a given value of `message_id` on this subscription: * The message sent to a subscriber is guaranteed not to be resent before the message's acknowledgment deadline expires. * An acknowledged message will not be resent to a subscriber. Note that subscribers may still receive multiple copies of a message when `enable_exactly_once_delivery` is true if the message was published multiple times by a publisher client. These copies are considered distinct by Pub/Sub and have distinct `message_id` values.
      */
     enableExactlyOnceDelivery?: boolean | null;
     /**
@@ -969,6 +995,10 @@ export namespace pubsub_v1 {
      * Optional. How long to retain unacknowledged messages in the subscription's backlog, from the moment a message is published. If `retain_acked_messages` is true, then this also configures the retention of acknowledged messages, and thus configures how far back in time a `Seek` can be done. Defaults to 7 days. Cannot be more than 31 days or less than 10 minutes.
      */
     messageRetentionDuration?: string | null;
+    /**
+     * Optional. Transforms to be applied to messages before they are delivered to subscribers. Transforms are applied in the order specified.
+     */
+    messageTransforms?: Schema$MessageTransform[];
     /**
      * Required. The name of the subscription. It must have the format `"projects/{project\}/subscriptions/{subscription\}"`. `{subscription\}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
      */
@@ -982,7 +1012,7 @@ export namespace pubsub_v1 {
      */
     retainAckedMessages?: boolean | null;
     /**
-     * Optional. A policy that specifies how Pub/Sub retries message delivery for this subscription. If not set, the default retry policy is applied. This generally implies that messages will be retried as soon as possible for healthy subscribers. RetryPolicy will be triggered on NACKs or acknowledgement deadline exceeded events for a given message.
+     * Optional. A policy that specifies how Pub/Sub retries message delivery for this subscription. If not set, the default retry policy is applied. This generally implies that messages will be retried as soon as possible for healthy subscribers. RetryPolicy will be triggered on NACKs or acknowledgment deadline exceeded events for a given message.
      */
     retryPolicy?: Schema$RetryPolicy;
     /**
@@ -1053,6 +1083,10 @@ export namespace pubsub_v1 {
      * Optional. Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored. If not present, then no constraints are in effect.
      */
     messageStoragePolicy?: Schema$MessageStoragePolicy;
+    /**
+     * Optional. Transforms to be applied to messages published to the topic. Transforms are applied in the order specified.
+     */
+    messageTransforms?: Schema$MessageTransform[];
     /**
      * Required. The name of the topic. It must have the format `"projects/{project\}/topics/{topic\}"`. `{topic\}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`.
      */