@scality/data-browser-library 1.0.0-preview.9 → 1.0.1

package/dist/hooks/__tests__/useIsBucketEmpty.test.js

@@ -1,24 +1,24 @@
-import { useIsBucketEmpty } from "../useIsBucketEmpty.js";
-import { useListObjects } from "../objectOperations.js";
 import { renderHookWithWrapper } from "../../test/testUtils.js";
-jest.mock("../objectOperations");
+import { useListObjects } from "../objectOperations.js";
+import { useIsBucketEmpty } from "../useIsBucketEmpty.js";
+jest.mock('../objectOperations');
 const mockUseListObjects = jest.mocked(useListObjects);
-describe("useIsBucketEmpty", ()=>{
+describe('useIsBucketEmpty', ()=>{
     beforeEach(()=>{
         jest.clearAllMocks();
     });
-    it("returns loading state when checking bucket", ()=>{
+    it('returns loading state when checking bucket', ()=>{
         mockUseListObjects.mockReturnValue({
             data: void 0,
-            status: "pending",
+            status: 'pending',
             error: null
         });
-        const { result } = renderHookWithWrapper(()=>useIsBucketEmpty("test-bucket"));
+        const { result } = renderHookWithWrapper(()=>useIsBucketEmpty('test-bucket'));
         expect(result.current.isEmpty).toBe(null);
         expect(result.current.isLoading).toBe(true);
         expect(result.current.error).toBe(null);
     });
-    it("returns true when bucket is empty", ()=>{
+    it('returns true when bucket is empty', ()=>{
         mockUseListObjects.mockReturnValue({
             data: {
                 pages: [
@@ -28,35 +28,35 @@ describe("useIsBucketEmpty", ()=>{
                     }
                 ]
             },
-            status: "success",
+            status: 'success',
             error: null
         });
-        const { result } = renderHookWithWrapper(()=>useIsBucketEmpty("test-bucket"));
+        const { result } = renderHookWithWrapper(()=>useIsBucketEmpty('test-bucket'));
         expect(result.current.isEmpty).toBe(true);
         expect(result.current.isLoading).toBe(false);
     });
-    it("returns false when bucket has objects", ()=>{
+    it('returns false when bucket has objects', ()=>{
         mockUseListObjects.mockReturnValue({
             data: {
                 pages: [
                     {
                         Contents: [
                             {
-                                Key: "file.txt"
+                                Key: 'file.txt'
                             }
                         ],
                         CommonPrefixes: []
                     }
                 ]
             },
-            status: "success",
+            status: 'success',
             error: null
         });
-        const { result } = renderHookWithWrapper(()=>useIsBucketEmpty("test-bucket"));
+        const { result } = renderHookWithWrapper(()=>useIsBucketEmpty('test-bucket'));
         expect(result.current.isEmpty).toBe(false);
         expect(result.current.isLoading).toBe(false);
     });
-    it("returns false when bucket has folders", ()=>{
+    it('returns false when bucket has folders', ()=>{
         mockUseListObjects.mockReturnValue({
             data: {
                 pages: [
@@ -64,32 +64,32 @@ describe("useIsBucketEmpty", ()=>{
                         Contents: [],
                         CommonPrefixes: [
                             {
-                                Prefix: "folder/"
+                                Prefix: 'folder/'
                             }
                         ]
                     }
                 ]
             },
-            status: "success",
+            status: 'success',
             error: null
         });
-        const { result } = renderHookWithWrapper(()=>useIsBucketEmpty("test-bucket"));
+        const { result } = renderHookWithWrapper(()=>useIsBucketEmpty('test-bucket'));
         expect(result.current.isEmpty).toBe(false);
         expect(result.current.isLoading).toBe(false);
     });
-    it("handles error state", ()=>{
-        const testError = new Error("Access denied");
+    it('handles error state', ()=>{
+        const testError = new Error('Access denied');
         mockUseListObjects.mockReturnValue({
             data: void 0,
-            status: "error",
+            status: 'error',
             error: testError
         });
-        const { result } = renderHookWithWrapper(()=>useIsBucketEmpty("test-bucket"));
+        const { result } = renderHookWithWrapper(()=>useIsBucketEmpty('test-bucket'));
         expect(result.current.isEmpty).toBe(null);
         expect(result.current.isLoading).toBe(false);
         expect(result.current.error).toBe(testError);
     });
-    it("ignores invalid objects and prefixes", ()=>{
+    it('ignores invalid objects and prefixes', ()=>{
         mockUseListObjects.mockReturnValue({
             data: {
                 pages: [
@@ -99,7 +99,7 @@ describe("useIsBucketEmpty", ()=>{
                                 Key: void 0
                             },
                             {
-                                Key: ""
+                                Key: ''
                             }
                         ],
                         CommonPrefixes: [
@@ -107,16 +107,16 @@ describe("useIsBucketEmpty", ()=>{
                                 Prefix: null
                             },
                             {
-                                Prefix: ""
+                                Prefix: ''
                             }
                         ]
                     }
                 ]
             },
-            status: "success",
+            status: 'success',
             error: null
         });
-        const { result } = renderHookWithWrapper(()=>useIsBucketEmpty("test-bucket"));
+        const { result } = renderHookWithWrapper(()=>useIsBucketEmpty('test-bucket'));
         expect(result.current.isEmpty).toBe(true);
     });
 });

package/dist/hooks/__tests__/useLoginMutation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/__tests__/useLoginMutation.test.js

@@ -0,0 +1,194 @@
+import { waitFor } from "@testing-library/react";
+import { mockS3Client, renderHookWithWrapper, setupCommonMocks } from "../../test/testUtils.js";
+import { useLoginMutation } from "../loginOperations.js";
+jest.mock('@aws-sdk/client-s3');
+describe('useLoginMutation', ()=>{
+    beforeEach(()=>{
+        setupCommonMocks();
+        jest.clearAllMocks();
+    });
+    it('calls onSuccess when login is successful', async ()=>{
+        const onSuccess = jest.fn();
+        mockS3Client.send.mockResolvedValue({
+            Buckets: []
+        });
+        const { result } = renderHookWithWrapper(()=>useLoginMutation({
+                onSuccess
+            }));
+        const config = {
+            endpoint: 'https://s3.amazonaws.com',
+            region: 'us-east-1',
+            forcePathStyle: true,
+            credentials: {
+                accessKeyId: 'test-key',
+                secretAccessKey: 'test-secret'
+            }
+        };
+        result.current.mutate(config);
+        await waitFor(()=>{
+            expect(result.current.isSuccess).toBe(true);
+        });
+        expect(onSuccess).toHaveBeenCalled();
+        expect(result.current.data).toEqual({
+            authenticated: true,
+            config
+        });
+    });
+    it('calls onError when user lacks ListBuckets permission', async ()=>{
+        const onError = jest.fn();
+        class AccessDeniedError extends Error {
+            constructor(message){
+                super(message);
+                this.name = 'AccessDenied';
+            }
+            $metadata = {
+                httpStatusCode: 403
+            };
+        }
+        const accessDeniedError = new AccessDeniedError('Access Denied');
+        mockS3Client.send.mockRejectedValue(accessDeniedError);
+        const { result } = renderHookWithWrapper(()=>useLoginMutation({
+                onError
+            }));
+        const config = {
+            endpoint: 'https://s3.amazonaws.com',
+            region: 'us-east-1',
+            forcePathStyle: true,
+            credentials: {
+                accessKeyId: 'test-key',
+                secretAccessKey: 'test-secret'
+            }
+        };
+        result.current.mutate(config);
+        await waitFor(()=>{
+            expect(result.current.isError).toBe(true);
+        });
+        expect(onError).toHaveBeenCalled();
+        expect(result.current.error?.name).toBe('AccessDenied');
+    });
+    it('calls onError for other errors', async ()=>{
+        const onError = jest.fn();
+        class InvalidAccessKeyIdError extends Error {
+            constructor(message){
+                super(message);
+                this.name = 'InvalidAccessKeyId';
+            }
+            $metadata = {
+                httpStatusCode: 403
+            };
+        }
+        const invalidCredentialsError = new InvalidAccessKeyIdError('The access key ID you provided does not exist');
+        mockS3Client.send.mockRejectedValue(invalidCredentialsError);
+        const { result } = renderHookWithWrapper(()=>useLoginMutation({
+                onError
+            }));
+        const config = {
+            endpoint: 'https://s3.amazonaws.com',
+            region: 'us-east-1',
+            forcePathStyle: true,
+            credentials: {
+                accessKeyId: 'invalid-key',
+                secretAccessKey: 'invalid-secret'
+            }
+        };
+        result.current.mutate(config);
+        await waitFor(()=>{
+            expect(result.current.isError).toBe(true);
+        });
+        expect(onError).toHaveBeenCalled();
+        expect(result.current.error?.name).toBe('InvalidAccessKeyId');
+    });
+    it('works without onError callback', async ()=>{
+        class AccessDeniedError extends Error {
+            constructor(message){
+                super(message);
+                this.name = 'AccessDenied';
+            }
+            $metadata = {
+                httpStatusCode: 403
+            };
+        }
+        const accessDeniedError = new AccessDeniedError('Access Denied');
+        mockS3Client.send.mockRejectedValue(accessDeniedError);
+        const { result } = renderHookWithWrapper(()=>useLoginMutation());
+        const config = {
+            endpoint: 'https://s3.amazonaws.com',
+            region: 'us-east-1',
+            forcePathStyle: true,
+            credentials: {
+                accessKeyId: 'test-key',
+                secretAccessKey: 'test-secret'
+            }
+        };
+        result.current.mutate(config);
+        await waitFor(()=>{
+            expect(result.current.isError).toBe(true);
+        });
+        expect(result.current.error?.name).toBe('AccessDenied');
+    });
+    it('returns authenticated config on successful login', async ()=>{
+        mockS3Client.send.mockResolvedValue({
+            Buckets: []
+        });
+        const { result } = renderHookWithWrapper(()=>useLoginMutation());
+        const config = {
+            endpoint: 'https://s3.amazonaws.com',
+            region: 'us-east-1',
+            forcePathStyle: true,
+            credentials: {
+                accessKeyId: 'test-key',
+                secretAccessKey: 'test-secret'
+            }
+        };
+        result.current.mutate(config);
+        await waitFor(()=>{
+            expect(result.current.isSuccess).toBe(true);
+        });
+        expect(result.current.data).toEqual({
+            authenticated: true,
+            config
+        });
+    });
+    it('handles network errors appropriately', async ()=>{
+        const onError = jest.fn();
+        const networkError = new Error('Network request failed');
+        mockS3Client.send.mockRejectedValue(networkError);
+        const { result } = renderHookWithWrapper(()=>useLoginMutation({
+                onError
+            }));
+        const config = {
+            endpoint: 'https://s3.amazonaws.com',
+            region: 'us-east-1',
+            forcePathStyle: true,
+            credentials: {
+                accessKeyId: 'test-key',
+                secretAccessKey: 'test-secret'
+            }
+        };
+        result.current.mutate(config);
+        await waitFor(()=>{
+            expect(result.current.isError).toBe(true);
+        });
+        expect(onError).toHaveBeenCalled();
+    });
+    it('validates credentials by calling ListBuckets command', async ()=>{
+        mockS3Client.send.mockResolvedValue({
+            Buckets: []
+        });
+        const { result } = renderHookWithWrapper(()=>useLoginMutation());
+        const config = {
+            endpoint: 'https://s3.amazonaws.com',
+            region: 'us-east-1',
+            forcePathStyle: true,
+            credentials: {
+                accessKeyId: 'test-key',
+                secretAccessKey: 'test-secret'
+            }
+        };
+        result.current.mutate(config);
+        await waitFor(()=>{
+            expect(result.current.isSuccess).toBe(true);
+        });
+        expect(mockS3Client.send).toHaveBeenCalled();
+    });
+});

package/dist/hooks/bucketConfiguration.d.ts

@@ -4,7 +4,7 @@
  * This file contains hooks for managing bucket configuration settings
  * like ACL, policies, versioning, CORS, lifecycle, etc.
  */
-import { GetBucketAclCommandInput, GetBucketAclCommandOutput, PutBucketAclCommandInput, PutBucketAclCommandOutput, GetBucketPolicyCommandInput, GetBucketPolicyCommandOutput, PutBucketPolicyCommandInput, PutBucketPolicyCommandOutput, DeleteBucketPolicyCommandInput, DeleteBucketPolicyCommandOutput, GetBucketVersioningCommandInput, GetBucketVersioningCommandOutput, PutBucketVersioningCommandInput, PutBucketVersioningCommandOutput, GetBucketCorsCommandInput, GetBucketCorsCommandOutput, PutBucketCorsCommandInput, PutBucketCorsCommandOutput, DeleteBucketCorsCommandInput, DeleteBucketCorsCommandOutput, GetBucketLifecycleConfigurationCommandInput, GetBucketLifecycleConfigurationCommandOutput, PutBucketLifecycleConfigurationCommandInput, PutBucketLifecycleConfigurationCommandOutput, DeleteBucketLifecycleCommandInput, DeleteBucketLifecycleCommandOutput, GetBucketNotificationConfigurationCommandInput, GetBucketNotificationConfigurationCommandOutput, PutBucketNotificationConfigurationCommandInput, PutBucketNotificationConfigurationCommandOutput, GetBucketEncryptionCommandInput, GetBucketEncryptionCommandOutput, PutBucketEncryptionCommandInput, PutBucketEncryptionCommandOutput, GetBucketTaggingCommandInput, GetBucketTaggingCommandOutput, PutBucketTaggingCommandInput, PutBucketTaggingCommandOutput, DeleteBucketTaggingCommandInput, DeleteBucketTaggingCommandOutput, GetObjectLockConfigurationCommandInput, GetObjectLockConfigurationCommandOutput, PutObjectLockConfigurationCommandInput, PutObjectLockConfigurationCommandOutput, GetBucketReplicationCommandInput, GetBucketReplicationCommandOutput, PutBucketReplicationCommandInput, PutBucketReplicationCommandOutput, DeleteBucketReplicationCommandInput, DeleteBucketReplicationCommandOutput } from "@aws-sdk/client-s3";
+import { type DeleteBucketCorsCommandInput, type DeleteBucketCorsCommandOutput, type DeleteBucketLifecycleCommandInput, type DeleteBucketLifecycleCommandOutput, type DeleteBucketPolicyCommandInput, type DeleteBucketPolicyCommandOutput, type DeleteBucketReplicationCommandInput, type DeleteBucketReplicationCommandOutput, type DeleteBucketTaggingCommandInput, type DeleteBucketTaggingCommandOutput, type GetBucketAclCommandInput, type GetBucketAclCommandOutput, type GetBucketCorsCommandInput, type GetBucketCorsCommandOutput, type GetBucketEncryptionCommandInput, type GetBucketEncryptionCommandOutput, type GetBucketLifecycleConfigurationCommandInput, type GetBucketLifecycleConfigurationCommandOutput, type GetBucketNotificationConfigurationCommandInput, type GetBucketNotificationConfigurationCommandOutput, type GetBucketPolicyCommandInput, type GetBucketPolicyCommandOutput, type GetBucketReplicationCommandInput, type GetBucketReplicationCommandOutput, type GetBucketTaggingCommandInput, type GetBucketTaggingCommandOutput, type GetBucketVersioningCommandInput, type GetBucketVersioningCommandOutput, type GetObjectLockConfigurationCommandInput, type GetObjectLockConfigurationCommandOutput, type GetPublicAccessBlockCommandInput, type GetPublicAccessBlockCommandOutput, type PutBucketAclCommandInput, type PutBucketAclCommandOutput, type PutBucketCorsCommandInput, type PutBucketCorsCommandOutput, type PutBucketEncryptionCommandInput, type PutBucketEncryptionCommandOutput, type PutBucketLifecycleConfigurationCommandInput, type PutBucketLifecycleConfigurationCommandOutput, type PutBucketNotificationConfigurationCommandInput, type PutBucketNotificationConfigurationCommandOutput, type PutBucketPolicyCommandInput, type PutBucketPolicyCommandOutput, type PutBucketReplicationCommandInput, type PutBucketReplicationCommandOutput, type PutBucketTaggingCommandInput, type PutBucketTaggingCommandOutput, type PutBucketVersioningCommandInput, type PutBucketVersioningCommandOutput, type PutObjectLockConfigurationCommandInput, type PutObjectLockConfigurationCommandOutput } from '@aws-sdk/client-s3';
 /**
  * Hook for retrieving S3 bucket access control list (ACL) settings
  *
@@ -166,3 +166,10 @@ export declare const useSetBucketReplication: (options?: Omit<import("@tanstack/
  * been replicated remain in the destination bucket.
  */
 export declare const useDeleteBucketReplication: (options?: Omit<import("@tanstack/react-query").UseMutationOptions<DeleteBucketReplicationCommandOutput, import("..").EnhancedS3Error, DeleteBucketReplicationCommandInput, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<DeleteBucketReplicationCommandOutput, import("..").EnhancedS3Error, DeleteBucketReplicationCommandInput>;
+/**
+ * Hook for retrieving S3 bucket public access block configuration
+ *
+ * Fetches the public access block configuration for an S3 bucket.
+ * This configuration determines whether public access is blocked at the bucket level.
+ */
+export declare const useGetPublicAccessBlock: (params?: GetPublicAccessBlockCommandInput | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<GetPublicAccessBlockCommandOutput, import("..").EnhancedS3Error, GetPublicAccessBlockCommandOutput, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<GetPublicAccessBlockCommandOutput, import("..").EnhancedS3Error>;

package/dist/hooks/bucketConfiguration.js

@@ -1,67 +1,68 @@
-import { DeleteBucketCorsCommand, DeleteBucketLifecycleCommand, DeleteBucketPolicyCommand, DeleteBucketReplicationCommand, DeleteBucketTaggingCommand, GetBucketAclCommand, GetBucketCorsCommand, GetBucketEncryptionCommand, GetBucketLifecycleConfigurationCommand, GetBucketNotificationConfigurationCommand, GetBucketPolicyCommand, GetBucketReplicationCommand, GetBucketTaggingCommand, GetBucketVersioningCommand, GetObjectLockConfigurationCommand, PutBucketAclCommand, PutBucketCorsCommand, PutBucketEncryptionCommand, PutBucketLifecycleConfigurationCommand, PutBucketNotificationConfigurationCommand, PutBucketPolicyCommand, PutBucketReplicationCommand, PutBucketTaggingCommand, PutBucketVersioningCommand, PutObjectLockConfigurationCommand } from "@aws-sdk/client-s3";
-import { useCreateS3QueryHook } from "./factories/useCreateS3QueryHook.js";
+import { DeleteBucketCorsCommand, DeleteBucketLifecycleCommand, DeleteBucketPolicyCommand, DeleteBucketReplicationCommand, DeleteBucketTaggingCommand, GetBucketAclCommand, GetBucketCorsCommand, GetBucketEncryptionCommand, GetBucketLifecycleConfigurationCommand, GetBucketNotificationConfigurationCommand, GetBucketPolicyCommand, GetBucketReplicationCommand, GetBucketTaggingCommand, GetBucketVersioningCommand, GetObjectLockConfigurationCommand, GetPublicAccessBlockCommand, PutBucketAclCommand, PutBucketCorsCommand, PutBucketEncryptionCommand, PutBucketLifecycleConfigurationCommand, PutBucketNotificationConfigurationCommand, PutBucketPolicyCommand, PutBucketReplicationCommand, PutBucketTaggingCommand, PutBucketVersioningCommand, PutObjectLockConfigurationCommand } from "@aws-sdk/client-s3";
 import { useCreateS3MutationHook } from "./factories/useCreateS3MutationHook.js";
-const useGetBucketAcl = useCreateS3QueryHook(GetBucketAclCommand, "GetBucketAcl");
-const useSetBucketAcl = useCreateS3MutationHook(PutBucketAclCommand, "PutBucketAcl", [
-    "GetBucketAcl",
-    "ListBuckets"
+import { useCreateS3QueryHook } from "./factories/useCreateS3QueryHook.js";
+const useGetBucketAcl = useCreateS3QueryHook(GetBucketAclCommand, 'GetBucketAcl');
+const useSetBucketAcl = useCreateS3MutationHook(PutBucketAclCommand, 'PutBucketAcl', [
+    'GetBucketAcl',
+    'ListBuckets'
 ]);
-const useGetBucketPolicy = useCreateS3QueryHook(GetBucketPolicyCommand, "GetBucketPolicy");
-const useSetBucketPolicy = useCreateS3MutationHook(PutBucketPolicyCommand, "PutBucketPolicy", [
-    "GetBucketPolicy",
-    "ListBuckets"
+const useGetBucketPolicy = useCreateS3QueryHook(GetBucketPolicyCommand, 'GetBucketPolicy');
+const useSetBucketPolicy = useCreateS3MutationHook(PutBucketPolicyCommand, 'PutBucketPolicy', [
+    'GetBucketPolicy',
+    'ListBuckets'
 ]);
-const useDeleteBucketPolicy = useCreateS3MutationHook(DeleteBucketPolicyCommand, "DeleteBucketPolicy", [
-    "GetBucketPolicy"
+const useDeleteBucketPolicy = useCreateS3MutationHook(DeleteBucketPolicyCommand, 'DeleteBucketPolicy', [
+    'GetBucketPolicy'
 ]);
-const useGetBucketVersioning = useCreateS3QueryHook(GetBucketVersioningCommand, "GetBucketVersioning");
-const useSetBucketVersioning = useCreateS3MutationHook(PutBucketVersioningCommand, "PutBucketVersioning", [
-    "GetBucketVersioning"
+const useGetBucketVersioning = useCreateS3QueryHook(GetBucketVersioningCommand, 'GetBucketVersioning');
+const useSetBucketVersioning = useCreateS3MutationHook(PutBucketVersioningCommand, 'PutBucketVersioning', [
+    'GetBucketVersioning'
 ]);
-const useGetBucketCors = useCreateS3QueryHook(GetBucketCorsCommand, "GetBucketCors");
-const useSetBucketCors = useCreateS3MutationHook(PutBucketCorsCommand, "PutBucketCors", [
-    "GetBucketCors",
-    "ListBuckets"
+const useGetBucketCors = useCreateS3QueryHook(GetBucketCorsCommand, 'GetBucketCors');
+const useSetBucketCors = useCreateS3MutationHook(PutBucketCorsCommand, 'PutBucketCors', [
+    'GetBucketCors',
+    'ListBuckets'
 ]);
-const useDeleteBucketCors = useCreateS3MutationHook(DeleteBucketCorsCommand, "DeleteBucketCors", [
-    "GetBucketCors"
+const useDeleteBucketCors = useCreateS3MutationHook(DeleteBucketCorsCommand, 'DeleteBucketCors', [
+    'GetBucketCors'
 ]);
-const useGetBucketLifecycle = useCreateS3QueryHook(GetBucketLifecycleConfigurationCommand, "GetBucketLifecycleConfiguration");
-const useSetBucketLifecycle = useCreateS3MutationHook(PutBucketLifecycleConfigurationCommand, "PutBucketLifecycleConfiguration", [
-    "GetBucketLifecycleConfiguration",
-    "ListBuckets"
+const useGetBucketLifecycle = useCreateS3QueryHook(GetBucketLifecycleConfigurationCommand, 'GetBucketLifecycleConfiguration');
+const useSetBucketLifecycle = useCreateS3MutationHook(PutBucketLifecycleConfigurationCommand, 'PutBucketLifecycleConfiguration', [
+    'GetBucketLifecycleConfiguration',
+    'ListBuckets'
 ]);
-const useDeleteBucketLifecycle = useCreateS3MutationHook(DeleteBucketLifecycleCommand, "DeleteBucketLifecycle", [
-    "GetBucketLifecycleConfiguration"
+const useDeleteBucketLifecycle = useCreateS3MutationHook(DeleteBucketLifecycleCommand, 'DeleteBucketLifecycle', [
+    'GetBucketLifecycleConfiguration'
 ]);
-const useGetBucketNotification = useCreateS3QueryHook(GetBucketNotificationConfigurationCommand, "GetBucketNotificationConfiguration");
-const useSetBucketNotification = useCreateS3MutationHook(PutBucketNotificationConfigurationCommand, "PutBucketNotificationConfiguration", [
-    "GetBucketNotificationConfiguration",
-    "ListBuckets"
+const useGetBucketNotification = useCreateS3QueryHook(GetBucketNotificationConfigurationCommand, 'GetBucketNotificationConfiguration');
+const useSetBucketNotification = useCreateS3MutationHook(PutBucketNotificationConfigurationCommand, 'PutBucketNotificationConfiguration', [
+    'GetBucketNotificationConfiguration',
+    'ListBuckets'
 ]);
-const useGetBucketEncryption = useCreateS3QueryHook(GetBucketEncryptionCommand, "GetBucketEncryption");
-const useSetBucketEncryption = useCreateS3MutationHook(PutBucketEncryptionCommand, "PutBucketEncryption", [
-    "GetBucketEncryption",
-    "ListBuckets"
+const useGetBucketEncryption = useCreateS3QueryHook(GetBucketEncryptionCommand, 'GetBucketEncryption');
+const useSetBucketEncryption = useCreateS3MutationHook(PutBucketEncryptionCommand, 'PutBucketEncryption', [
+    'GetBucketEncryption',
+    'ListBuckets'
 ]);
-const useGetBucketTagging = useCreateS3QueryHook(GetBucketTaggingCommand, "GetBucketTagging");
-const useSetBucketTagging = useCreateS3MutationHook(PutBucketTaggingCommand, "PutBucketTagging", [
-    "GetBucketTagging",
-    "ListBuckets"
+const useGetBucketTagging = useCreateS3QueryHook(GetBucketTaggingCommand, 'GetBucketTagging');
+const useSetBucketTagging = useCreateS3MutationHook(PutBucketTaggingCommand, 'PutBucketTagging', [
+    'GetBucketTagging',
+    'ListBuckets'
 ]);
-const useDeleteBucketTagging = useCreateS3MutationHook(DeleteBucketTaggingCommand, "DeleteBucketTagging", [
-    "GetBucketTagging"
+const useDeleteBucketTagging = useCreateS3MutationHook(DeleteBucketTaggingCommand, 'DeleteBucketTagging', [
+    'GetBucketTagging'
 ]);
-const useGetBucketObjectLockConfiguration = useCreateS3QueryHook(GetObjectLockConfigurationCommand, "GetObjectLockConfiguration");
-const useSetBucketObjectLockConfiguration = useCreateS3MutationHook(PutObjectLockConfigurationCommand, "PutObjectLockConfiguration", [
-    "GetObjectLockConfiguration"
+const useGetBucketObjectLockConfiguration = useCreateS3QueryHook(GetObjectLockConfigurationCommand, 'GetObjectLockConfiguration');
+const useSetBucketObjectLockConfiguration = useCreateS3MutationHook(PutObjectLockConfigurationCommand, 'PutObjectLockConfiguration', [
+    'GetObjectLockConfiguration'
 ]);
-const useGetBucketReplication = useCreateS3QueryHook(GetBucketReplicationCommand, "GetBucketReplication");
-const useSetBucketReplication = useCreateS3MutationHook(PutBucketReplicationCommand, "PutBucketReplication", [
-    "GetBucketReplication",
-    "ListBuckets"
+const useGetBucketReplication = useCreateS3QueryHook(GetBucketReplicationCommand, 'GetBucketReplication');
+const useSetBucketReplication = useCreateS3MutationHook(PutBucketReplicationCommand, 'PutBucketReplication', [
+    'GetBucketReplication',
+    'ListBuckets'
 ]);
-const useDeleteBucketReplication = useCreateS3MutationHook(DeleteBucketReplicationCommand, "DeleteBucketReplication", [
-    "GetBucketReplication"
+const useDeleteBucketReplication = useCreateS3MutationHook(DeleteBucketReplicationCommand, 'DeleteBucketReplication', [
+    'GetBucketReplication'
 ]);
-export { useDeleteBucketCors, useDeleteBucketLifecycle, useDeleteBucketPolicy, useDeleteBucketReplication, useDeleteBucketTagging, useGetBucketAcl, useGetBucketCors, useGetBucketEncryption, useGetBucketLifecycle, useGetBucketNotification, useGetBucketObjectLockConfiguration, useGetBucketPolicy, useGetBucketReplication, useGetBucketTagging, useGetBucketVersioning, useSetBucketAcl, useSetBucketCors, useSetBucketEncryption, useSetBucketLifecycle, useSetBucketNotification, useSetBucketObjectLockConfiguration, useSetBucketPolicy, useSetBucketReplication, useSetBucketTagging, useSetBucketVersioning };
+const useGetPublicAccessBlock = useCreateS3QueryHook(GetPublicAccessBlockCommand, 'GetPublicAccessBlock');
+export { useDeleteBucketCors, useDeleteBucketLifecycle, useDeleteBucketPolicy, useDeleteBucketReplication, useDeleteBucketTagging, useGetBucketAcl, useGetBucketCors, useGetBucketEncryption, useGetBucketLifecycle, useGetBucketNotification, useGetBucketObjectLockConfiguration, useGetBucketPolicy, useGetBucketReplication, useGetBucketTagging, useGetBucketVersioning, useGetPublicAccessBlock, useSetBucketAcl, useSetBucketCors, useSetBucketEncryption, useSetBucketLifecycle, useSetBucketNotification, useSetBucketObjectLockConfiguration, useSetBucketPolicy, useSetBucketReplication, useSetBucketTagging, useSetBucketVersioning };

package/dist/hooks/bucketOperations.d.ts

@@ -4,7 +4,7 @@
  * This file contains hooks for fundamental bucket operations like
  * listing, creating, and deleting buckets.
  */
-import { ListBucketsCommandInput, ListBucketsCommandOutput, CreateBucketCommandInput, CreateBucketCommandOutput, DeleteBucketCommandInput, DeleteBucketCommandOutput, GetBucketLocationCommandInput, GetBucketLocationCommandOutput } from "@aws-sdk/client-s3";
+import { type CreateBucketCommandInput, type CreateBucketCommandOutput, type DeleteBucketCommandInput, type DeleteBucketCommandOutput, type GetBucketLocationCommandInput, type GetBucketLocationCommandOutput, type ListBucketsCommandInput, type ListBucketsCommandOutput, type ListObjectsV2CommandInput, type ListObjectsV2CommandOutput } from '@aws-sdk/client-s3';
 /**
  * Hook for listing all S3 buckets
  *
@@ -34,3 +34,12 @@ export declare const useCreateBucket: (options?: Omit<import("@tanstack/react-qu
  * Automatically invalidates the buckets list after successful deletion.
  */
 export declare const useDeleteBucket: (options?: Omit<import("@tanstack/react-query").UseMutationOptions<DeleteBucketCommandOutput, import("..").EnhancedS3Error, DeleteBucketCommandInput, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<DeleteBucketCommandOutput, import("..").EnhancedS3Error, DeleteBucketCommandInput>;
+/**
+ * Hook for validating access to a specific S3 bucket.
+ *
+ * Attempts to list objects in a given bucket to verify user permissions.
+ * Used for users with limited permissions who cannot use ListBuckets.
+ *
+ * The hook is disabled by default and must be manually triggered via refetch().
+ */
+export declare const useValidateBucketAccess: (params?: ListObjectsV2CommandInput | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<ListObjectsV2CommandOutput, import("..").EnhancedS3Error, ListObjectsV2CommandOutput, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<ListObjectsV2CommandOutput, import("..").EnhancedS3Error>;

package/dist/hooks/bucketOperations.js

@@ -1,12 +1,13 @@
-import { CreateBucketCommand, DeleteBucketCommand, GetBucketLocationCommand, ListBucketsCommand } from "@aws-sdk/client-s3";
-import { useCreateS3QueryHook } from "./factories/useCreateS3QueryHook.js";
+import { CreateBucketCommand, DeleteBucketCommand, GetBucketLocationCommand, ListBucketsCommand, ListObjectsV2Command } from "@aws-sdk/client-s3";
 import { useCreateS3MutationHook } from "./factories/useCreateS3MutationHook.js";
-const useBuckets = useCreateS3QueryHook(ListBucketsCommand, "ListBuckets");
-const useGetBucketLocation = useCreateS3QueryHook(GetBucketLocationCommand, "GetBucketLocation");
-const useCreateBucket = useCreateS3MutationHook(CreateBucketCommand, "CreateBucket", [
-    "ListBuckets"
+import { useCreateS3QueryHook } from "./factories/useCreateS3QueryHook.js";
+const useBuckets = useCreateS3QueryHook(ListBucketsCommand, 'ListBuckets');
+const useGetBucketLocation = useCreateS3QueryHook(GetBucketLocationCommand, 'GetBucketLocation');
+const useCreateBucket = useCreateS3MutationHook(CreateBucketCommand, 'CreateBucket', [
+    'ListBuckets'
 ]);
-const useDeleteBucket = useCreateS3MutationHook(DeleteBucketCommand, "DeleteBucket", [
-    "ListBuckets"
+const useDeleteBucket = useCreateS3MutationHook(DeleteBucketCommand, 'DeleteBucket', [
+    'ListBuckets'
 ]);
-export { useBuckets, useCreateBucket, useDeleteBucket, useGetBucketLocation };
+const useValidateBucketAccess = useCreateS3QueryHook(ListObjectsV2Command, 'ValidateBucketAccess');
+export { useBuckets, useCreateBucket, useDeleteBucket, useGetBucketLocation, useValidateBucketAccess };