fix(mirrors): honor R2_FORCE_PATH_STYLE against LocalStack

apps/api-axum/src/storage.rs

@@ -34,7 +34,12 @@ impl StorageClient {
             loader = loader.endpoint_url(endpoint);
         }
         let conf = loader.load().await;
-        let s3 = Client::new(&conf);
+        // LocalStack/S3 dev servers only resolve the bucket via path; R2 uses virtual-host style.
+        let force_path_style = std::env::var("R2_FORCE_PATH_STYLE").as_deref() == Ok("true");
+        let s3_conf = aws_sdk_s3::config::Builder::from(&conf)
+            .force_path_style(force_path_style)
+            .build();
+        let s3 = Client::from_conf(s3_conf);
         Self {
             s3,
             bucket: bucket.into(),

apps/api-effect/.env.example

@@ -45,6 +45,8 @@ R2_SECRET_ACCESS_KEY=your_secret_key
 R2_BUCKET_NAME=webdevstudios-storage
 R2_PUBLIC_URL=https://pub-xxxxx.r2.dev
 R2_ENDPOINT=https://xxxxx.r2.cloudflarestorage.com
+# LocalStack dev: R2_ENDPOINT=http://127.0.0.1:4566, R2_FORCE_PATH_STYLE=true, any dummy keys
+R2_FORCE_PATH_STYLE=false
 
 # Redis
 REDIS_HOST="localhost"

apps/api-effect/src/lib/storage.ts

@@ -33,6 +33,8 @@ function getClient(): ClientOptions | null {
         client: new S3Client({
           region: 'auto',
           endpoint: process.env.R2_ENDPOINT,
+          // LocalStack/S3 dev servers only resolve the bucket via path; R2 uses virtual-host style.
+          forcePathStyle: process.env.R2_FORCE_PATH_STYLE === 'true',
           credentials: {
             accessKeyId: key,
             secretAccessKey: process.env.R2_SECRET_ACCESS_KEY ?? '',

apps/api-elysia/.env.example

@@ -45,6 +45,8 @@ R2_SECRET_ACCESS_KEY=your_secret_key
 R2_BUCKET_NAME=webdevstudios-storage
 R2_PUBLIC_URL=https://pub-xxxxx.r2.dev
 R2_ENDPOINT=https://xxxxx.r2.cloudflarestorage.com
+# LocalStack dev: R2_ENDPOINT=http://127.0.0.1:4566, R2_FORCE_PATH_STYLE=true, any dummy keys
+R2_FORCE_PATH_STYLE=false
 
 # Redis
 REDIS_HOST="localhost"

apps/api-elysia/src/lib/storage.ts

@@ -33,6 +33,8 @@ function getClient(): ClientOptions | null {
         client: new S3Client({
           region: 'auto',
           endpoint: process.env.R2_ENDPOINT,
+          // LocalStack/S3 dev servers only resolve the bucket via path; R2 uses virtual-host style.
+          forcePathStyle: process.env.R2_FORCE_PATH_STYLE === 'true',
           credentials: {
             accessKeyId: key,
             secretAccessKey: process.env.R2_SECRET_ACCESS_KEY ?? '',

apps/api-go/internal/storage/storage.go

@@ -48,7 +48,8 @@ func New() *Service {
 	endpoint := os.Getenv("R2_ENDPOINT")
 	client := s3.NewFromConfig(cfg, func(o *s3.Options) {
 		o.BaseEndpoint = &endpoint
-		o.UsePathStyle = false
+		// LocalStack/S3 dev servers only resolve the bucket via path; R2 uses virtual-host style.
+		o.UsePathStyle = os.Getenv("R2_FORCE_PATH_STYLE") == "true"
 	})
 	return &Service{client: client, bucket: os.Getenv("R2_BUCKET_NAME"), publicURL: strings.TrimSuffix(os.Getenv("R2_PUBLIC_URL"), "/")}
 }