@constructive-io/s3-utils 2.31.0 → 2.33.0

package/README.md

@@ -16,7 +16,7 @@ Unified S3 utilities for the Constructive ecosystem — client factory, file ope
 
 ## Features
 
-- **Multi-provider support** — AWS S3, MinIO, Cloudflare R2, Google Cloud Storage, DigitalOcean Spaces
+- **Multi-provider support** — AWS S3, MinIO, RustFS, Cloudflare R2, Google Cloud Storage, DigitalOcean Spaces
 - **Presigned URLs** — generate secure PUT and GET URLs with configurable expiry
 - **File operations** — streaming upload, download, existence checks, and metadata retrieval
 - **Bucket management** — create buckets with provider-appropriate policies and CORS
@@ -88,14 +88,14 @@ const client = createS3Client({
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `provider` | `'s3' \| 'minio' \| 'r2' \| 'gcs' \| 'spaces'` | yes | Storage provider |
+| `provider` | `'s3' \| 'minio' \| 'rustfs' \| 'r2' \| 'gcs' \| 'spaces'` | yes | Storage provider |
 | `region` | `string` | yes | S3 region (e.g. `"us-east-1"`) |
 | `endpoint` | `string` | non-AWS | Endpoint URL (required for all providers except `s3`) |
 | `accessKeyId` | `string` | yes | Access key ID |
 | `secretAccessKey` | `string` | yes | Secret access key |
 | `forcePathStyle` | `boolean` | no | Override path-style URL behavior |
 
-Path-style URLs are enabled automatically for `minio`, `r2`, and `gcs`. Virtual-hosted style is used for `s3` and `spaces`.
+Path-style URLs are enabled automatically for `minio`, `rustfs`, `r2`, and `gcs`. Virtual-hosted style is used for `s3` and `spaces`.
 
 Throws `S3ConfigError` on invalid configuration.
 
@@ -199,7 +199,7 @@ someReadable.pipe(pass);
 Creates a bucket with provider-appropriate policies and CORS configuration.
 
 - **MinIO**: read-only public access policy (list + get)
-- **S3/GCS**: full-access policy with CORS rules for browser uploads
+- **RustFS/S3/GCS**: full-access policy with CORS rules for browser uploads
 
 ```typescript
 const { success } = await createS3Bucket(client, 'my-bucket', {

package/client.d.ts

@@ -7,6 +7,7 @@
  *
  * Handles provider-specific defaults:
  * - minio: forces path-style URLs, requires endpoint
+ * - rustfs: forces path-style URLs, requires endpoint
  * - r2: forces path-style URLs, requires endpoint
  * - gcs: forces path-style URLs, requires endpoint
  * - s3: virtual-hosted style (AWS default)
@@ -32,13 +33,13 @@ import { S3Client } from '@aws-sdk/client-s3';
  * Used to select provider-specific behavior (e.g., path-style URLs for MinIO,
  * jurisdiction headers for R2).
  */
-export type StorageProvider = 's3' | 'minio' | 'r2' | 'gcs' | 'spaces';
+export type StorageProvider = 's3' | 'minio' | 'rustfs' | 'r2' | 'gcs' | 'spaces';
 /**
  * Connection configuration for an S3-compatible storage backend.
  *
  * This is the input you provide to connect to your storage provider.
  * For AWS S3, only `region` and credentials are needed.
- * For MinIO/R2/etc., also provide `endpoint`.
+ * For MinIO/RustFS/R2/etc., also provide `endpoint`.
  */
 export interface StorageConnectionConfig {
     /** Storage provider type */
@@ -66,6 +67,7 @@ export declare class S3ConfigError extends Error {
  *
  * Provider-specific defaults:
  * - `minio`: forces path-style URLs (required by MinIO)
+ * - `rustfs`: forces path-style URLs
  * - `r2`: forces path-style URLs (required by Cloudflare R2)
  * - `s3`: uses virtual-hosted style (AWS default)
  * - `gcs`: forces path-style URLs (GCS S3-compatible API)

package/client.js

@@ -8,6 +8,7 @@
  *
  * Handles provider-specific defaults:
  * - minio: forces path-style URLs, requires endpoint
+ * - rustfs: forces path-style URLs, requires endpoint
  * - r2: forces path-style URLs, requires endpoint
  * - gcs: forces path-style URLs, requires endpoint
  * - s3: virtual-hosted style (AWS default)
@@ -49,6 +50,7 @@ exports.S3ConfigError = S3ConfigError;
  *
  * Provider-specific defaults:
  * - `minio`: forces path-style URLs (required by MinIO)
+ * - `rustfs`: forces path-style URLs
  * - `r2`: forces path-style URLs (required by Cloudflare R2)
  * - `s3`: uses virtual-hosted style (AWS default)
  * - `gcs`: forces path-style URLs (GCS S3-compatible API)
@@ -62,7 +64,7 @@ function createS3Client(config) {
         throw new S3ConfigError('INVALID_CONFIG', 'region is required');
     }
     // Providers that require path-style URLs
-    const pathStyleProviders = new Set(['minio', 'r2', 'gcs']);
+    const pathStyleProviders = new Set(['minio', 'rustfs', 'r2', 'gcs']);
     const forcePathStyle = config.forcePathStyle ?? pathStyleProviders.has(config.provider);
     // Non-AWS providers require an endpoint
     if (config.provider !== 's3' && !config.endpoint) {

package/esm/client.js

@@ -7,6 +7,7 @@
  *
  * Handles provider-specific defaults:
  * - minio: forces path-style URLs, requires endpoint
+ * - rustfs: forces path-style URLs, requires endpoint
  * - r2: forces path-style URLs, requires endpoint
  * - gcs: forces path-style URLs, requires endpoint
  * - s3: virtual-hosted style (AWS default)
@@ -44,6 +45,7 @@ export class S3ConfigError extends Error {
  *
  * Provider-specific defaults:
  * - `minio`: forces path-style URLs (required by MinIO)
+ * - `rustfs`: forces path-style URLs
  * - `r2`: forces path-style URLs (required by Cloudflare R2)
  * - `s3`: uses virtual-hosted style (AWS default)
  * - `gcs`: forces path-style URLs (GCS S3-compatible API)
@@ -57,7 +59,7 @@ export function createS3Client(config) {
         throw new S3ConfigError('INVALID_CONFIG', 'region is required');
     }
     // Providers that require path-style URLs
-    const pathStyleProviders = new Set(['minio', 'r2', 'gcs']);
+    const pathStyleProviders = new Set(['minio', 'rustfs', 'r2', 'gcs']);
     const forcePathStyle = config.forcePathStyle ?? pathStyleProviders.has(config.provider);
     // Non-AWS providers require an endpoint
     if (config.provider !== 's3' && !config.endpoint) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/s3-utils",
-  "version": "2.31.0",
+  "version": "2.33.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "Unified S3 utilities — client factory, file operations, presigned URLs",
   "main": "index.js",
@@ -36,7 +36,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.19.11",
-    "makage": "^0.3.0"
+    "makage": "^0.8.0"
   },
-  "gitHead": "10ee73e43c2277405c0e19423e2075baef6c2755"
+  "gitHead": "5e0bfead2856d1a062b495d343a43e543343f9b8"
 }

package/policies.d.ts

@@ -1,6 +1,6 @@
 import { S3Client } from '@aws-sdk/client-s3';
 export interface CreateS3BucketOptions {
-    provider: 'minio' | 's3' | 'gcs';
+    provider: 'minio' | 'rustfs' | 's3' | 'gcs';
 }
 export declare function createS3Bucket(client: S3Client, Bucket: string, options: CreateS3BucketOptions): Promise<{
     success: boolean;