@sveltia/cms 0.144.5 → 0.145.0

package/types/public.d.ts

@@ -14,7 +14,7 @@ export type FieldKeyPath = string;
 /**
  * Cloud media storage name.
  */
-export type CloudMediaLibraryName = "cloudinary" | "uploadcare";
+export type CloudMediaLibraryName = "cloudinary" | "uploadcare" | "aws_s3" | "cloudflare_r2" | "digitalocean_spaces";
 /**
  * Supported media storage name.
  */
@@ -205,6 +205,53 @@ export type UploadcareMediaLibrary = {
      */
     settings?: UploadcareMediaLibrarySettings;
 };
+/**
+ * Options for S3-compatible media libraries (Amazon S3, Cloudflare R2, DigitalOcean Spaces).
+ */
+export type S3MediaLibrary = {
+    /**
+     * Media library name (used when configuring via legacy `media_library`).
+     */
+    name?: string;
+    /**
+     * AWS access key ID or equivalent (safe to store in config).
+     */
+    access_key_id: string;
+    /**
+     * Bucket name.
+     */
+    bucket: string;
+    /**
+     * AWS region (e.g., 'us-east-1'). Required for Amazon S3 and
+     * DigitalOcean Spaces.
+     */
+    region?: string;
+    /**
+     * Cloudflare account ID. Required for Cloudflare R2.
+     */
+    account_id?: string;
+    /**
+     * Custom endpoint URL for S3-compatible services.
+     */
+    endpoint?: string;
+    /**
+     * Path prefix within bucket.
+     */
+    prefix?: string;
+    /**
+     * Use path-style URLs instead of virtual-hosted-style.
+     */
+    force_path_style?: boolean;
+    /**
+     * Base URL for public asset access. When set, asset preview and
+     * download URLs are constructed as `{public_url}/{key}` instead of the S3 API endpoint URL.
+     * Required for Cloudflare R2 (S3 API endpoint always requires authentication); set to the `r2.dev`
+     * development URL (e.g. `https://pub-abcd1234.r2.dev`) or a custom domain. Optional for Amazon S3
+     * and DigitalOcean Spaces — use when serving assets through a CDN or custom domain (e.g. CloudFront
+     * or Route 53 for S3, CDN endpoint for Spaces).
+     */
+    public_url?: string;
+};
 /**
  * Name of supported stock photo/video provider.
  */
@@ -223,7 +270,7 @@ export type StockAssetMediaLibrary = {
 /**
  * Supported [media storage](https://sveltiacms.app/en/docs/media).
  */
-export type MediaLibrary = DefaultMediaLibrary | CloudinaryMediaLibrary | UploadcareMediaLibrary | StockAssetMediaLibrary;
+export type MediaLibrary = DefaultMediaLibrary | CloudinaryMediaLibrary | UploadcareMediaLibrary | S3MediaLibrary | StockAssetMediaLibrary;
 /**
  * Unified media storage option that supports multiple storage providers. See the
  * [documentation](https://sveltiacms.app/en/docs/media#configuration) for details.
@@ -241,6 +288,19 @@ export type MediaLibraries = {
      * Options for the Uploadcare media storage.
      */
     uploadcare?: UploadcareMediaLibrary;
+    /**
+     * Options for the Amazon S3 media storage.
+     */
+    aws_s3?: S3MediaLibrary;
+    /**
+     * Options for the Cloudflare R2 media storage.
+     */
+    cloudflare_r2?: S3MediaLibrary;
+    /**
+     * Options for the DigitalOcean Spaces media
+     * storage.
+     */
+    digitalocean_spaces?: S3MediaLibrary;
     /**
      * Options for the unified stock photo/video media
      * library.