Custom domain integration for partner integration APIs (#301)

* Custom domain integration for partner integration APIs

* prettier fix

* revert url change

* verbose docs

Author: adilansari

static/api/extensions/v1/api.yaml

@@ -225,6 +225,100 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/GenericError"
+  /v1/providers/{provider_id}/orgs/{org_id}/buckets/{bucket_name}/domain:
+    post:
+      tags:
+        - buckets
+      summary: Attach a custom domain to bucket
+      description: |
+        Sets a custom domain for a bucket. If the domain is already set, it will be replaced.
+
+        :::note
+        The custom domain must have a CNAME record that points to the bucket URL.
+        :::
+
+        ##### Example:
+        If your bucket is `my-bucket` and you want to use `images.example.com`,
+        create a CNAME record pointing `images.example.com` to `my-bucket.t3.storage.dev`.
+
+        After setting the custom domain, objects will be accessible via:
+        - `https://images.example.com/object.jpg`
+        - `https://my-bucket.t3.storage.dev/object.jpg` (original URL still works)
+
+      operationId: Tigris_SetCustomDomain
+      parameters:
+        - $ref: "#/components/parameters/provider_id"
+        - $ref: "#/components/parameters/org_id"
+        - $ref: "#/components/parameters/bucket_name"
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SetCustomDomainRequest"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/SetCustomDomainResponse"
+        default:
+          description: Unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GenericError"
+    delete:
+      tags:
+        - buckets
+      summary: Remove custom domain from bucket
+      description: |
+        Removes the custom domain from a bucket. After removal, the bucket will only be accessible via its default Tigris URL. 
+        The CNAME DNS record can be safely deleted after the custom domain is removed.
+      operationId: Tigris_DeleteCustomDomain
+      parameters:
+        - $ref: "#/components/parameters/provider_id"
+        - $ref: "#/components/parameters/org_id"
+        - $ref: "#/components/parameters/bucket_name"
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/DeleteCustomDomainResponse"
+        default:
+          description: Unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GenericError"
+    get:
+      tags:
+        - buckets
+      summary: Get custom domain settings for a bucket
+      description: |
+        Returns the currently configured custom domain for the bucket, or an empty
+        object if no custom domain is set.
+      operationId: Tigris_GetCustomDomain
+      parameters:
+        - $ref: "#/components/parameters/provider_id"
+        - $ref: "#/components/parameters/org_id"
+        - $ref: "#/components/parameters/bucket_name"
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GetCustomDomainResponse"
+        default:
+          description: Unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GenericError"
 
   /v1/providers/{provider_id}/orgs/{org_id}/key/rotate:
     post:
@@ -585,6 +679,36 @@ components:
       properties:
         data:
           $ref: "#/components/schemas/Invoice"
+    BucketWebsiteSettings:
+      type: object
+      additionalProperties: false
+      properties:
+        domain_name:
+          type: string
+          example: "images.example.com"
+          description: |
+            Custom domain name for the bucket. Must be a valid fully-qualified domain name (FQDN) and 
+            have a CNAME record pointing to the bucket URL.
+    SetCustomDomainRequest:
+      type: object
+      additionalProperties: false
+      required:
+        - website
+      properties:
+        website:
+          $ref: "#/components/schemas/BucketWebsiteSettings"
+    SetCustomDomainResponse:
+      type: object
+    DeleteCustomDomainResponse:
+      type: object
+    GetCustomDomainResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - website
+      properties:
+        website:
+          $ref: "#/components/schemas/BucketWebsiteSettings"
     Invoice:
       type: object
       properties:
@@ -740,6 +864,8 @@ components:
         object_acl_enabled:
           type: boolean
           description: If set to true, per object ACL is enabled
+        website:
+          $ref: "#/components/schemas/BucketWebsiteSettings"
     GetUsageResponse:
       type: object
       properties: