@google-cloud/storage-control 0.8.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.
@@ -3163,4 +3163,4 @@ message ContentRange {
 
   // The complete length of the object data.
   int64 complete_length = 3;
-}
+}

package/build/protos/protos.d.ts

@@ -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 {