@google-cloud/storage-control 0.7.0 → 0.8.1

package/README.md

@@ -17,7 +17,7 @@ Storage Control API client for Node.js
 A comprehensive list of changes in each version may be found in
 [the CHANGELOG][homepage_changelog].
 
-* [Storage Control API Nodejs Client API Reference](https://cloud.google.com/nodejs/docs/reference/control/latest)
+* [Storage Control API Nodejs Client API Reference](https://cloud.google.com/nodejs/docs/reference/storage-control/latest)
 * [Storage Control API Documentation](https://cloud.google.com/storage/docs/overview)
 
 Read more about the client libraries for Cloud APIs, including the older
@@ -69,6 +69,7 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
 | create folder | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-storage-control/samples/generated/v2/storage_control.create_folder.js) |
 | create managed folder | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-storage-control/samples/generated/v2/storage_control.create_managed_folder.js) |
 | delete folder | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-storage-control/samples/generated/v2/storage_control.delete_folder.js) |
+| delete folder recursive | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-storage-control/samples/generated/v2/storage_control.delete_folder_recursive.js) |
 | delete managed folder | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-storage-control/samples/generated/v2/storage_control.delete_managed_folder.js) |
 | disable anywhere cache | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-storage-control/samples/generated/v2/storage_control.disable_anywhere_cache.js) |
 | get anywhere cache | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-storage-control/samples/generated/v2/storage_control.get_anywhere_cache.js) |

package/build/protos/google/storage/control/v2/storage_control.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -112,6 +112,23 @@ service StorageControl {
     };
   }
 
+  // Deletes a folder recursively. This operation is only applicable to a
+  // hierarchical namespace enabled bucket.
+  rpc DeleteFolderRecursive(DeleteFolderRecursiveRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.routing) = {
+      routing_parameters {
+        field: "name"
+        path_template: "{bucket=projects/*/buckets/*}/**"
+      }
+    };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "DeleteFolderRecursiveMetadata"
+    };
+  }
+
   // Returns the storage layout configuration for a given bucket.
   rpc GetStorageLayout(GetStorageLayoutRequest) returns (StorageLayout) {
     option (google.api.routing) = {
@@ -586,6 +603,34 @@ message RenameFolderRequest {
   ];
 }
 
+// Request message for DeleteFolderRecursive.
+message DeleteFolderRecursiveRequest {
+  // Required. Name of the folder being deleted, however all of its contents
+  // will be deleted too. Format:
+  // `projects/{project}/buckets/{bucket}/folders/{folder}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "storage.googleapis.com/Folder" }
+  ];
+
+  // Optional. Makes the operation only succeed conditional on whether the root
+  // folder's current metageneration matches the given value.
+  optional int64 if_metageneration_match = 2
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Makes the operation only succeed conditional on whether the root
+  // folder's current metageneration does not match the given value.
+  optional int64 if_metageneration_not_match = 3
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A unique identifier for this request. UUID is the recommended
+  // format, but other formats are still accepted.
+  string request_id = 4 [
+    (google.api.field_info).format = UUID4,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+}
+
 // The message contains metadata that is common to all Storage Control
 // long-running operations, present in its `google.longrunning.Operation`
 // messages, and accessible via `metadata.common_metadata`.
@@ -626,6 +671,16 @@ message RenameFolderMetadata {
   string destination_folder_id = 3;
 }
 
+// Message returned in the metadata field of the Operation resource for
+// DeleteFolderRecursive operations.
+message DeleteFolderRecursiveMetadata {
+  // Generic metadata for the long running operation.
+  CommonLongRunningOperationMetadata common_metadata = 1;
+
+  // The path of the folder recursively deleted.
+  string folder_id = 2;
+}
+
 // The storage layout configuration of a bucket.
 message StorageLayout {
   option (google.api.resource) = {

package/build/protos/google/storage/v2/storage.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -410,13 +410,12 @@ service Storage {
 
   // Reads an object's data.
   //
-  // This bi-directional API reads data from an object, allowing you to
-  // request multiple data ranges within a single stream, even across
-  // several messages. If an error occurs with any request, the stream
-  // closes with a relevant error code. Since you can have multiple
-  // outstanding requests, the error response includes a
-  // `BidiReadObjectRangesError` field detailing the specific error for
-  // each pending `read_id`.
+  // This bi-directional API reads data from an object, allowing you to request
+  // multiple data ranges within a single stream, even across several messages.
+  // If an error occurs with any request, the stream closes with a relevant
+  // error code. Since you can have multiple outstanding requests, the error
+  // response includes a `BidiReadObjectError` proto in its `details` field,
+  // reporting the specific error, if any, for each pending `read_id`.
   //
   // **IAM Permissions**:
   //
@@ -883,6 +882,9 @@ message ComposeObjectRequest {
   // the combined checksums of the component objects.
   ObjectChecksums object_checksums = 10
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Whether the source objects should be deleted in the compose request.
+  optional bool delete_source_objects = 11;
 }
 
 // Request message for deleting an object.
@@ -1296,16 +1298,16 @@ message ReadRange {
   // length is 15 bytes, a `ReadObjectRequest` with `read_offset` = -5 and
   // `read_length` = 3 would return bytes 10 through 12 of the object.
   // Requesting a negative offset with magnitude larger than the size of the
-  // object returns the entire object. A `read_offset` larger than the size
-  // of the object results in an `OutOfRange` error.
+  // object is equivalent to `read_offset` = 0. A `read_offset` larger than the
+  // size of the object results in an `OutOfRange` error.
   int64 read_offset = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. The maximum number of data bytes the server is allowed to return
   // across all response messages with the same `read_id`. A `read_length` of
   // zero indicates to read until the resource end, and a negative `read_length`
-  // causes an error. If the stream returns fewer bytes than allowed by the
-  // `read_length` and no error occurred, the stream includes all data from the
-  // `read_offset` to the resource end.
+  // causes an `OutOfRange` error. If the stream returns fewer bytes than
+  // allowed by the `read_length` and no error occurred, the stream includes all
+  // data from the `read_offset` to the resource end.
   int64 read_length = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Required. Read identifier provided by the client. When the client issues
@@ -2825,6 +2827,9 @@ message ObjectCustomContextPayload {
 // All contexts of an object grouped by type.
 message ObjectContexts {
   // Optional. User-defined object contexts.
+  // The maximum key or value size is `256` characters.
+  // The maximum number of entries is `50`.
+  // The maximum total serialized size of all entries is `25KiB`.
   map<string, ObjectCustomContextPayload> custom = 1
       [(google.api.field_behavior) = OPTIONAL];
 }

package/build/protos/protos.d.ts

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -116,6 +116,20 @@ export namespace google {
                      */
                     public renameFolder(request: google.storage.control.v2.IRenameFolderRequest): Promise<google.longrunning.Operation>;
 
+                    /**
+                     * Calls DeleteFolderRecursive.
+                     * @param request DeleteFolderRecursiveRequest message or plain object
+                     * @param callback Node-style callback called with the error, if any, and Operation
+                     */
+                    public deleteFolderRecursive(request: google.storage.control.v2.IDeleteFolderRecursiveRequest, callback: google.storage.control.v2.StorageControl.DeleteFolderRecursiveCallback): void;
+
+                    /**
+                     * Calls DeleteFolderRecursive.
+                     * @param request DeleteFolderRecursiveRequest message or plain object
+                     * @returns Promise
+                     */
+                    public deleteFolderRecursive(request: google.storage.control.v2.IDeleteFolderRecursiveRequest): Promise<google.longrunning.Operation>;
+
                     /**
                      * Calls GetStorageLayout.
                      * @param request GetStorageLayoutRequest message or plain object
@@ -448,6 +462,13 @@ export namespace google {
                      */
                     type RenameFolderCallback = (error: (Error|null), response?: google.longrunning.Operation) => void;
 
+                    /**
+                     * Callback as used by {@link google.storage.control.v2.StorageControl|deleteFolderRecursive}.
+                     * @param error Error, if any
+                     * @param [response] Operation
+                     */
+                    type DeleteFolderRecursiveCallback = (error: (Error|null), response?: google.longrunning.Operation) => void;
+
                     /**
                      * Callback as used by {@link google.storage.control.v2.StorageControl|getStorageLayout}.
                      * @param error Error, if any
@@ -1528,6 +1549,121 @@ export namespace google {
                     public static getTypeUrl(typeUrlPrefix?: string): string;
                 }
 
+                /** Properties of a DeleteFolderRecursiveRequest. */
+                interface IDeleteFolderRecursiveRequest {
+
+                    /** DeleteFolderRecursiveRequest name */
+                    name?: (string|null);
+
+                    /** DeleteFolderRecursiveRequest ifMetagenerationMatch */
+                    ifMetagenerationMatch?: (number|Long|string|null);
+
+                    /** DeleteFolderRecursiveRequest ifMetagenerationNotMatch */
+                    ifMetagenerationNotMatch?: (number|Long|string|null);
+
+                    /** DeleteFolderRecursiveRequest requestId */
+                    requestId?: (string|null);
+                }
+
+                /** Represents a DeleteFolderRecursiveRequest. */
+                class DeleteFolderRecursiveRequest implements IDeleteFolderRecursiveRequest {
+
+                    /**
+                     * Constructs a new DeleteFolderRecursiveRequest.
+                     * @param [properties] Properties to set
+                     */
+                    constructor(properties?: google.storage.control.v2.IDeleteFolderRecursiveRequest);
+
+                    /** DeleteFolderRecursiveRequest name. */
+                    public name: string;
+
+                    /** DeleteFolderRecursiveRequest ifMetagenerationMatch. */
+                    public ifMetagenerationMatch?: (number|Long|string|null);
+
+                    /** DeleteFolderRecursiveRequest ifMetagenerationNotMatch. */
+                    public ifMetagenerationNotMatch?: (number|Long|string|null);
+
+                    /** DeleteFolderRecursiveRequest requestId. */
+                    public requestId: string;
+
+                    /**
+                     * Creates a new DeleteFolderRecursiveRequest instance using the specified properties.
+                     * @param [properties] Properties to set
+                     * @returns DeleteFolderRecursiveRequest instance
+                     */
+                    public static create(properties?: google.storage.control.v2.IDeleteFolderRecursiveRequest): google.storage.control.v2.DeleteFolderRecursiveRequest;
+
+                    /**
+                     * Encodes the specified DeleteFolderRecursiveRequest message. Does not implicitly {@link google.storage.control.v2.DeleteFolderRecursiveRequest.verify|verify} messages.
+                     * @param message DeleteFolderRecursiveRequest message or plain object to encode
+                     * @param [writer] Writer to encode to
+                     * @returns Writer
+                     */
+                    public static encode(message: google.storage.control.v2.IDeleteFolderRecursiveRequest, writer?: $protobuf.Writer): $protobuf.Writer;
+
+                    /**
+                     * Encodes the specified DeleteFolderRecursiveRequest message, length delimited. Does not implicitly {@link google.storage.control.v2.DeleteFolderRecursiveRequest.verify|verify} messages.
+                     * @param message DeleteFolderRecursiveRequest message or plain object to encode
+                     * @param [writer] Writer to encode to
+                     * @returns Writer
+                     */
+                    public static encodeDelimited(message: google.storage.control.v2.IDeleteFolderRecursiveRequest, writer?: $protobuf.Writer): $protobuf.Writer;
+
+                    /**
+                     * Decodes a DeleteFolderRecursiveRequest message from the specified reader or buffer.
+                     * @param reader Reader or buffer to decode from
+                     * @param [length] Message length if known beforehand
+                     * @returns DeleteFolderRecursiveRequest
+                     * @throws {Error} If the payload is not a reader or valid buffer
+                     * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                     */
+                    public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): google.storage.control.v2.DeleteFolderRecursiveRequest;
+
+                    /**
+                     * Decodes a DeleteFolderRecursiveRequest message from the specified reader or buffer, length delimited.
+                     * @param reader Reader or buffer to decode from
+                     * @returns DeleteFolderRecursiveRequest
+                     * @throws {Error} If the payload is not a reader or valid buffer
+                     * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                     */
+                    public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): google.storage.control.v2.DeleteFolderRecursiveRequest;
+
+                    /**
+                     * Verifies a DeleteFolderRecursiveRequest message.
+                     * @param message Plain object to verify
+                     * @returns `null` if valid, otherwise the reason why it is not
+                     */
+                    public static verify(message: { [k: string]: any }): (string|null);
+
+                    /**
+                     * Creates a DeleteFolderRecursiveRequest message from a plain object. Also converts values to their respective internal types.
+                     * @param object Plain object
+                     * @returns DeleteFolderRecursiveRequest
+                     */
+                    public static fromObject(object: { [k: string]: any }): google.storage.control.v2.DeleteFolderRecursiveRequest;
+
+                    /**
+                     * Creates a plain object from a DeleteFolderRecursiveRequest message. Also converts values to other types if specified.
+                     * @param message DeleteFolderRecursiveRequest
+                     * @param [options] Conversion options
+                     * @returns Plain object
+                     */
+                    public static toObject(message: google.storage.control.v2.DeleteFolderRecursiveRequest, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+                    /**
+                     * Converts this DeleteFolderRecursiveRequest to JSON.
+                     * @returns JSON object
+                     */
+                    public toJSON(): { [k: string]: any };
+
+                    /**
+                     * Gets the default type url for DeleteFolderRecursiveRequest
+                     * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+                     * @returns The default type url
+                     */
+                    public static getTypeUrl(typeUrlPrefix?: string): string;
+                }
+
                 /** Properties of a CommonLongRunningOperationMetadata. */
                 interface ICommonLongRunningOperationMetadata {
 
@@ -1764,6 +1900,109 @@ export namespace google {
                     public static getTypeUrl(typeUrlPrefix?: string): string;
                 }
 
+                /** Properties of a DeleteFolderRecursiveMetadata. */
+                interface IDeleteFolderRecursiveMetadata {
+
+                    /** DeleteFolderRecursiveMetadata commonMetadata */
+                    commonMetadata?: (google.storage.control.v2.ICommonLongRunningOperationMetadata|null);
+
+                    /** DeleteFolderRecursiveMetadata folderId */
+                    folderId?: (string|null);
+                }
+
+                /** Represents a DeleteFolderRecursiveMetadata. */
+                class DeleteFolderRecursiveMetadata implements IDeleteFolderRecursiveMetadata {
+
+                    /**
+                     * Constructs a new DeleteFolderRecursiveMetadata.
+                     * @param [properties] Properties to set
+                     */
+                    constructor(properties?: google.storage.control.v2.IDeleteFolderRecursiveMetadata);
+
+                    /** DeleteFolderRecursiveMetadata commonMetadata. */
+                    public commonMetadata?: (google.storage.control.v2.ICommonLongRunningOperationMetadata|null);
+
+                    /** DeleteFolderRecursiveMetadata folderId. */
+                    public folderId: string;
+
+                    /**
+                     * Creates a new DeleteFolderRecursiveMetadata instance using the specified properties.
+                     * @param [properties] Properties to set
+                     * @returns DeleteFolderRecursiveMetadata instance
+                     */
+                    public static create(properties?: google.storage.control.v2.IDeleteFolderRecursiveMetadata): google.storage.control.v2.DeleteFolderRecursiveMetadata;
+
+                    /**
+                     * Encodes the specified DeleteFolderRecursiveMetadata message. Does not implicitly {@link google.storage.control.v2.DeleteFolderRecursiveMetadata.verify|verify} messages.
+                     * @param message DeleteFolderRecursiveMetadata message or plain object to encode
+                     * @param [writer] Writer to encode to
+                     * @returns Writer
+                     */
+                    public static encode(message: google.storage.control.v2.IDeleteFolderRecursiveMetadata, writer?: $protobuf.Writer): $protobuf.Writer;
+
+                    /**
+                     * Encodes the specified DeleteFolderRecursiveMetadata message, length delimited. Does not implicitly {@link google.storage.control.v2.DeleteFolderRecursiveMetadata.verify|verify} messages.
+                     * @param message DeleteFolderRecursiveMetadata message or plain object to encode
+                     * @param [writer] Writer to encode to
+                     * @returns Writer
+                     */
+                    public static encodeDelimited(message: google.storage.control.v2.IDeleteFolderRecursiveMetadata, writer?: $protobuf.Writer): $protobuf.Writer;
+
+                    /**
+                     * Decodes a DeleteFolderRecursiveMetadata message from the specified reader or buffer.
+                     * @param reader Reader or buffer to decode from
+                     * @param [length] Message length if known beforehand
+                     * @returns DeleteFolderRecursiveMetadata
+                     * @throws {Error} If the payload is not a reader or valid buffer
+                     * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                     */
+                    public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): google.storage.control.v2.DeleteFolderRecursiveMetadata;
+
+                    /**
+                     * Decodes a DeleteFolderRecursiveMetadata message from the specified reader or buffer, length delimited.
+                     * @param reader Reader or buffer to decode from
+                     * @returns DeleteFolderRecursiveMetadata
+                     * @throws {Error} If the payload is not a reader or valid buffer
+                     * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                     */
+                    public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): google.storage.control.v2.DeleteFolderRecursiveMetadata;
+
+                    /**
+                     * Verifies a DeleteFolderRecursiveMetadata message.
+                     * @param message Plain object to verify
+                     * @returns `null` if valid, otherwise the reason why it is not
+                     */
+                    public static verify(message: { [k: string]: any }): (string|null);
+
+                    /**
+                     * Creates a DeleteFolderRecursiveMetadata message from a plain object. Also converts values to their respective internal types.
+                     * @param object Plain object
+                     * @returns DeleteFolderRecursiveMetadata
+                     */
+                    public static fromObject(object: { [k: string]: any }): google.storage.control.v2.DeleteFolderRecursiveMetadata;
+
+                    /**
+                     * Creates a plain object from a DeleteFolderRecursiveMetadata message. Also converts values to other types if specified.
+                     * @param message DeleteFolderRecursiveMetadata
+                     * @param [options] Conversion options
+                     * @returns Plain object
+                     */
+                    public static toObject(message: google.storage.control.v2.DeleteFolderRecursiveMetadata, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+                    /**
+                     * Converts this DeleteFolderRecursiveMetadata to JSON.
+                     * @returns JSON object
+                     */
+                    public toJSON(): { [k: string]: any };
+
+                    /**
+                     * Gets the default type url for DeleteFolderRecursiveMetadata
+                     * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+                     * @returns The default type url
+                     */
+                    public static getTypeUrl(typeUrlPrefix?: string): string;
+                }
+
                 /** Properties of a StorageLayout. */
                 interface IStorageLayout {
 
@@ -6771,6 +7010,9 @@ export namespace google {
 
                 /** ComposeObjectRequest objectChecksums */
                 objectChecksums?: (google.storage.v2.IObjectChecksums|null);
+
+                /** ComposeObjectRequest deleteSourceObjects */
+                deleteSourceObjects?: (boolean|null);
             }
 
             /** Represents a ComposeObjectRequest. */
@@ -6806,6 +7048,9 @@ export namespace google {
                 /** ComposeObjectRequest objectChecksums. */
                 public objectChecksums?: (google.storage.v2.IObjectChecksums|null);
 
+                /** ComposeObjectRequest deleteSourceObjects. */
+                public deleteSourceObjects?: (boolean|null);
+
                 /**
                  * Creates a new ComposeObjectRequest instance using the specified properties.
                  * @param [properties] Properties to set