mudbase 1.0.0 → 1.1.4

data/spec/api/authentication_api_spec.rb

@@ -0,0 +1,228 @@
+=begin
+#MUDBASESDK
+
+#MUDBASE is a scalable, real-time, and secure Backend-as-a-Service (BaaS) platform  designed for modern applications. Built with custom logic, it offers fine-grained  control, extensibility, and enterprise-grade security.  ## Features - 🔐 Multi-provider authentication (30+ OAuth providers) - 📊 Real-time database with collections - 📁 File storage and management - 🔑 API key management with permissions - 🔗 Webhook system with retry logic - ⚡ Serverless functions - 💬 Multi-channel messaging (Push, Email, SMS) - 📈 Usage analytics and monitoring - 🌐 Real-time WebSocket events - 🔍 Full-text search capabilities - 💳 Billing: Flutterwave only for fiat (platform subscriptions + org payment processing with 7% + $0.50 split); crypto payment processor for multi-chain checkout - 📡 Block-based multi-chain wallet monitoring (ETH/UTXO scanners, GetBlock, scanner metrics API)  ## Testing Configurations Below are example configurations for testing in different environments:  ### Production ```json {   \"scheme\": \"http\",   \"base_path\": \"\",   \"host\": \"cloud.mudbase.dev\",   \"xApiKey\": \"xApiKey\",   \"bearerToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4NWFjYmUwZTEyOTkzMmZiYjdhMGZjMiIsImVtYWlsIjoibXVkaGF4a3NlcnZpY2VzQGdtYWlsLmNvbSIsImlhdCI6MTc1MDc4MDg5OCwiZXhwIjoxNzUwODY3Mjk4fQ.sfoqzEbCuz5Y8qHkLItzrZZYC823SPT4RbO7Kucqvuc\",   \"userId\": \"685acbe0e129932fbb7a0fc2\",   \"projectId\": \"685ad30be129932fbb7a1047\",   \"collectionId\": \"685ada8fd9416ac02f171abf\",   \"documentId\": \"685ae1210136e73fa1dcaf36\",   \"apikeyId\": \"685ae8a785426b6a4190d5fc\",   \"webhookId\": \"685af3992f9c4c96514247e9\",   \"functionId\": \"685af8b85d73a104065b6a77\",   \"fileId\": \"685af8b85d73a104065b6a77\" } 
+
+The version of the OpenAPI document: 1.1.4
+Contact: support@mudbase.dev
+Generated by: https://openapi-generator.tech
+Generator version: 7.20.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for Mudbase::AuthenticationApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'AuthenticationApi' do
+  before do
+    # run before each test
+    @api_instance = Mudbase::AuthenticationApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of AuthenticationApi' do
+    it 'should create an instance of AuthenticationApi' do
+      expect(@api_instance).to be_instance_of(Mudbase::AuthenticationApi)
+    end
+  end
+
+  # unit tests for confirm_local_password_reset_with_otp
+  # Confirm password reset with OTP (project-based)
+  # Set new password using the OTP sent to the user's email. Call after POST /api/auth/local/password-reset with projectId. Rate limited (OTP limit). If the user's email was not yet verified, it is marked as verified upon successful reset. 
+  # @param confirm_local_password_reset_with_otp_request Email, projectId, OTP code, and new password.
+  # @param [Hash] opts the optional parameters
+  # @return [MessageResponse]
+  describe 'confirm_local_password_reset_with_otp test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for convert_anonymous_account
+  # Convert anonymous account to full account
+  # Convert an anonymous user session to a full authenticated account. Preserves user data. Requires JWT Bearer token (ProjectBearerAuth). API keys are not supported for this endpoint. 
+  # @param convert_anonymous_account_request Email, password, and optional firstName, lastName for the new full account.
+  # @param [Hash] opts the optional parameters
+  # @return [ConvertAnonymousAccount200Response]
+  describe 'convert_anonymous_account test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for create_anonymous_session
+  # Create anonymous session
+  # Create an anonymous user session for guest access. Users can later convert to full accounts.
+  # @param [Hash] opts the optional parameters
+  # @option opts [CreateAnonymousSessionRequest] :create_anonymous_session_request Optional projectId and deviceId for the anonymous session.
+  # @return [CreateAnonymousSession200Response]
+  describe 'create_anonymous_session test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for get_available_o_auth_providers
+  # Get all available OAuth providers
+  # Returns a list of all supported OAuth providers with their configuration details
+  # @param [Hash] opts the optional parameters
+  # @return [GetAvailableOAuthProviders200Response]
+  describe 'get_available_o_auth_providers test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for get_local_session
+  # Get current session (project-based)
+  # Get the current authenticated user session (project-based). Requires JWT Bearer token (ProjectBearerAuth). API keys are not supported for this endpoint. 
+  # @param project_id Project ID to get session for.
+  # @param [Hash] opts the optional parameters
+  # @return [GetLocalSession200Response]
+  describe 'get_local_session test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for initiate_o_auth
+  # Initiate OAuth authentication
+  # Initiates OAuth authentication flow for a specified provider and project. The OAuth provider must be configured and enabled for the project first. After user authentication, redirects to the OAuth provider's consent screen. 
+  # @param provider OAuth provider identifier (e.g. google, github).
+  # @param project_id Project ID for which OAuth is configured.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :redirect_url The URL to redirect to after authentication. Must be pre-registered in project settings.
+  # @return [InitiateOAuth200Response]
+  describe 'initiate_o_auth test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for login_local_user
+  # Login user (project-based)
+  # When the project has **requireEmailVerification** enabled and the user has not verified their email, returns 403 with code **EMAIL_VERIFICATION_REQUIRED** (user must verify email first, then login again). 
+  # @param login_local_user_request Login credentials (email, password) and project ID.
+  # @param [Hash] opts the optional parameters
+  # @return [LoginLocalUser200Response]
+  describe 'login_local_user test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for logout_local_user
+  # Logout user (project-based)
+  # Logout the current authenticated user session (project-based). Requires JWT Bearer token (ProjectBearerAuth). API keys are not supported for this endpoint. 
+  # @param [Hash] opts the optional parameters
+  # @return [MessageResponse]
+  describe 'logout_local_user test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for oauth_callback
+  # OAuth callback handler
+  # OAuth provider redirects the user here after consent. The server exchanges the code for tokens, creates or finds the user, and redirects to the client with token (or error) in query or fragment. 
+  # @param provider OAuth provider identifier (e.g. google, github).
+  # @param [Hash] opts the optional parameters
+  # @return [OauthCallback200Response]
+  describe 'oauth_callback test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for register_local_user
+  # Register new user (project-based)
+  # When the project has **requireEmailVerification** enabled (default), the response is 201 with **requireVerification: true** and **no token**; the user must verify their email then sign in via login. When email verification is disabled, a token and refreshToken are returned. 
+  # @param register_local_user_request Registration payload (email, password, firstName, lastName, projectId).
+  # @param [Hash] opts the optional parameters
+  # @return [RegisterLocalUser201Response]
+  describe 'register_local_user test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for request_local_password_reset
+  # Request password reset (project-based, OTP)
+  # When projectId is provided, sends a 6-digit OTP to the user's email (project-based reset uses OTP, not link). When projectId is omitted, sends a token link (org/platform local account). Rate limited. 
+  # @param request_local_password_reset_request Email and optional projectId for project-based OTP or org token link.
+  # @param [Hash] opts the optional parameters
+  # @return [MessageResponse]
+  describe 'request_local_password_reset test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for reset_local_password
+  # Reset password with token (project-based, legacy)
+  # Legacy token-based completion. Prefer OTP flow: use POST .../password-reset/confirm with the OTP sent to email for project-based resets. 
+  # @param token Password reset token from email link.
+  # @param reset_local_password_request New password and optional projectId.
+  # @param [Hash] opts the optional parameters
+  # @return [MessageResponse]
+  describe 'reset_local_password test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for send_magic_link
+  # Send magic link
+  # Sends a one-time magic link to the given email for the project. The user clicks the link and is authenticated without a password. Use verify endpoint with the token from the link. Public endpoint; rate limited. 
+  # @param magic_link_request Email, projectId, and optional redirect URL for the magic link.
+  # @param [Hash] opts the optional parameters
+  # @return [MessageResponse]
+  describe 'send_magic_link test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for send_otp
+  # Send OTP code
+  # Sends a one-time code via SMS or email for the given project. Use verify endpoint to exchange the code for a session. Public endpoint; rate limited. 
+  # @param otp_send_request Project ID, delivery method (sms/email), and phone or email.
+  # @param [Hash] opts the optional parameters
+  # @return [MessageResponse]
+  describe 'send_otp test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for verify_magic_link
+  # Verify magic link
+  # Exchanges the magic link token (from the link sent by send) for a session. Returns token and user on success. Token is short-lived and single-use. 
+  # @param verify_magic_link_request The token from the magic link URL.
+  # @param [Hash] opts the optional parameters
+  # @return [AuthResponse]
+  describe 'verify_magic_link test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for verify_otp
+  # Verify OTP code
+  # Verifies the OTP code and returns a session token and user. Public endpoint. 
+  # @param otp_verify_request Identifier (phone/email), OTP code, and project ID.
+  # @param [Hash] opts the optional parameters
+  # @return [AuthResponse]
+  describe 'verify_otp test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/api/billing_api_spec.rb

@@ -1,9 +1,9 @@
 =begin
 #MUDBASESDK
 
-#MUDBASE is a scalable, real-time, and secure Backend-as-a-Service (BaaS) platform  designed for modern applications. Built with custom logic, it offers fine-grained  control, extensibility, and enterprise-grade security.  ## Features - 🔐 Multi-provider authentication (30+ OAuth providers) - 📊 Real-time database with collections - 📁 File storage and management - 🔑 API key management with permissions - 🔗 Webhook system with retry logic - ⚡ Serverless functions - 💬 Multi-channel messaging (Push, Email, SMS) - 📈 Usage analytics and monitoring - 🌐 Real-time WebSocket events - 🔍 Full-text search capabilities - 💳 Billing: Flutterwave only for fiat (platform subscriptions + org payment processing with 7% + $0.50 split); crypto payment processor for multi-chain checkout - 📡 Block-based multi-chain wallet monitoring (ETH/UTXO scanners, GetBlock, scanner metrics API) 
+#MUDBASE is a scalable, real-time, and secure Backend-as-a-Service (BaaS) platform  designed for modern applications. Built with custom logic, it offers fine-grained  control, extensibility, and enterprise-grade security.  ## Features - 🔐 Multi-provider authentication (30+ OAuth providers) - 📊 Real-time database with collections - 📁 File storage and management - 🔑 API key management with permissions - 🔗 Webhook system with retry logic - ⚡ Serverless functions - 💬 Multi-channel messaging (Push, Email, SMS) - 📈 Usage analytics and monitoring - 🌐 Real-time WebSocket events - 🔍 Full-text search capabilities - 💳 Billing: Flutterwave only for fiat (platform subscriptions + org payment processing with 7% + $0.50 split); crypto payment processor for multi-chain checkout - 📡 Block-based multi-chain wallet monitoring (ETH/UTXO scanners, GetBlock, scanner metrics API)  ## Testing Configurations Below are example configurations for testing in different environments:  ### Production ```json {   \"scheme\": \"http\",   \"base_path\": \"\",   \"host\": \"cloud.mudbase.dev\",   \"xApiKey\": \"xApiKey\",   \"bearerToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4NWFjYmUwZTEyOTkzMmZiYjdhMGZjMiIsImVtYWlsIjoibXVkaGF4a3NlcnZpY2VzQGdtYWlsLmNvbSIsImlhdCI6MTc1MDc4MDg5OCwiZXhwIjoxNzUwODY3Mjk4fQ.sfoqzEbCuz5Y8qHkLItzrZZYC823SPT4RbO7Kucqvuc\",   \"userId\": \"685acbe0e129932fbb7a0fc2\",   \"projectId\": \"685ad30be129932fbb7a1047\",   \"collectionId\": \"685ada8fd9416ac02f171abf\",   \"documentId\": \"685ae1210136e73fa1dcaf36\",   \"apikeyId\": \"685ae8a785426b6a4190d5fc\",   \"webhookId\": \"685af3992f9c4c96514247e9\",   \"functionId\": \"685af8b85d73a104065b6a77\",   \"fileId\": \"685af8b85d73a104065b6a77\" } 
 
-The version of the OpenAPI document: 1.1.9
+The version of the OpenAPI document: 1.1.4
 Contact: support@mudbase.dev
 Generated by: https://openapi-generator.tech
 Generator version: 7.20.0
@@ -32,129 +32,129 @@ describe 'BillingApi' do
     end
   end
 
-  # unit tests for billing_check_feature_access
+  # unit tests for check_feature_access
   # Check feature access (public)
   # Check whether a customer has access to a feature (by plan or entitlement). Public; no auth required.
   # @param project_id Project ID (MongoDB ObjectId) for the billing project.
   # @param email Customer email
   # @param feature Feature slug to check access for
   # @param [Hash] opts the optional parameters
-  # @return [BillingCheckFeatureAccess200Response]
-  describe 'billing_check_feature_access test' do
+  # @return [CheckFeatureAccess200Response]
+  describe 'check_feature_access test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for billing_check_subscription
+  # unit tests for check_subscription
   # Check subscription status (public)
   # Check whether a customer (by email) has an active subscription for the project. Public; no auth required.
   # @param project_id Project ID (MongoDB ObjectId) for the billing project.
   # @param email Customer email to check subscription for
   # @param [Hash] opts the optional parameters
-  # @return [BillingCheckSubscription200Response]
-  describe 'billing_check_subscription test' do
+  # @return [CheckSubscription200Response]
+  describe 'check_subscription test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for billing_create_checkout_session
+  # unit tests for create_checkout_session
   # Create checkout session (Flutterwave or crypto)
   # Creates a checkout session for subscription billing. When Flutterwave is configured (platform), returns authorizationUrl and accessCode for redirect. When using crypto payment processor, returns checkoutUrl, paymentOptions (multi-chain USDC/USDT/BTC Lightning), and reference. 
   # @param project_id Project ID (MongoDB ObjectId) for the billing project.
-  # @param billing_create_checkout_session_request Plan to subscribe to, billing cycle, customer email/name, and optional success/cancel redirect URLs.
+  # @param create_checkout_session_request Plan to subscribe to, billing cycle, customer email/name, and optional success/cancel redirect URLs.
   # @param [Hash] opts the optional parameters
-  # @return [BillingCreateCheckoutSession200Response]
-  describe 'billing_create_checkout_session test' do
+  # @return [CreateCheckoutSession200Response]
+  describe 'create_checkout_session test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for billing_get_checkout_payment
+  # unit tests for get_checkout_payment
   # Get checkout payment details
   # Returns payment intent/checkout status (for refresh or deep link). No auth required.
   # @param project_id Project ID (MongoDB ObjectId) for the billing project.
   # @param payment_id Payment ID or reference from checkout session
   # @param [Hash] opts the optional parameters
-  # @return [BillingGetCheckoutPayment200Response]
-  describe 'billing_get_checkout_payment test' do
+  # @return [GetCheckoutPayment200Response]
+  describe 'get_checkout_payment test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for billing_get_public_plans
+  # unit tests for get_public_plans
   # Get public plans (no auth required)
   # Returns subscription plans available for the project. Public; no authentication required. Use for pricing pages and checkout flow.
   # @param project_id Project ID (MongoDB ObjectId) to list plans for.
   # @param [Hash] opts the optional parameters
-  # @return [BillingGetPublicPlans200Response]
-  describe 'billing_get_public_plans test' do
+  # @return [GetPublicPlans200Response]
+  describe 'get_public_plans test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for billing_handle_crypto_webhook
+  # unit tests for handle_crypto_payment_webhook
   # Crypto payment processor webhook
   # Receives crypto payment events (payment.completed, etc.) for platform billing. No auth; verified by provider signature.
-  # @param billing_handle_crypto_webhook_request Crypto payment webhook payload (event type and data with paymentId, reference, amount, currency, network, status, metadata).
+  # @param handle_crypto_payment_webhook_request Crypto payment webhook payload (event type and data with paymentId, reference, amount, currency, network, status, metadata).
   # @param [Hash] opts the optional parameters
-  # @return [BillingHandleCryptoWebhook200Response]
-  describe 'billing_handle_crypto_webhook test' do
+  # @return [HandleCryptoPaymentWebhook200Response]
+  describe 'handle_crypto_payment_webhook test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for billing_handle_flutterwave_webhook
+  # unit tests for handle_flutterwave_webhook
   # Flutterwave webhook
   # Receives Flutterwave webhook events (charge.completed, payment.successful). No auth; verified by verif-hash header. - Subscription billing: meta without isPaymentProcessing triggers verifyPaymentAndCreateSubscription (mudbase_xxx refs). - Payment processing: meta.isPaymentProcessing === true triggers fiat payment record (mudbase_fiat_xxx refs); org share goes to org subaccount, platform fee to main or configured subaccounts. 
-  # @param billing_handle_flutterwave_webhook_request Flutterwave webhook payload (event and data with id, tx_ref, amount, currency, status, customer, meta for subscription or payment-processing).
+  # @param handle_flutterwave_webhook_request Flutterwave webhook payload (event and data with id, tx_ref, amount, currency, status, customer, meta for subscription or payment-processing).
   # @param [Hash] opts the optional parameters
-  # @return [BillingHandleCryptoWebhook200Response]
-  describe 'billing_handle_flutterwave_webhook test' do
+  # @return [HandleCryptoPaymentWebhook200Response]
+  describe 'handle_flutterwave_webhook test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for billing_initialize_payment
-  # Initialize fiat payment (app-scoped)
+  # unit tests for initialize_payment_for_project
+  # Initialize fiat payment (project-scoped)
   # Same as org-level initialize-payment; projectId from path is used for scope and tx_ref. Resolves project to org and uses org's Flutterwave subaccount.
   # @param project_id Project ID for payment scope and tx_ref.
-  # @param billing_initialize_payment_request Payment amount, currency, customer (email, name), and optional metadata.
+  # @param initialize_payment_for_project_request Payment amount, currency, customer (email, name), and optional metadata.
   # @param [Hash] opts the optional parameters
   # @return [nil]
-  describe 'billing_initialize_payment test' do
+  describe 'initialize_payment_for_project test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for billing_record_usage
+  # unit tests for record_usage
   # Record usage (public)
   # Record metered usage for a customer (e.g. api_calls, storage_mb). Used for usage-based billing. Public endpoint; optionally secured by webhook or API key in production.
   # @param project_id Project ID (MongoDB ObjectId) for the billing project.
-  # @param billing_record_usage_request Customer email, metric name (e.g. api_calls, storage_mb), and quantity to record.
+  # @param record_usage_request Customer email, metric name (e.g. api_calls, storage_mb), and quantity to record.
   # @param [Hash] opts the optional parameters
   # @return [MessageResponse]
-  describe 'billing_record_usage test' do
+  describe 'record_usage test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for billing_verify_payment
+  # unit tests for verify_payment
   # Verify payment and create subscription
   # Verifies payment by reference (Flutterwave mudbase_xxx or crypto pmt_xxx) and creates or updates the subscription. Call after redirect from payment provider; pass reference as query (e.g. ?reference=mudbase_abc123). Idempotent for same reference. 
   # @param project_id Project ID (MongoDB ObjectId) for the billing project.
   # @param reference Payment reference (e.g. mudbase_abc123 or pmt_abc123)
   # @param [Hash] opts the optional parameters
-  # @return [BillingVerifyPayment200Response]
-  describe 'billing_verify_payment test' do
+  # @return [VerifyPayment200Response]
+  describe 'verify_payment test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end

data/spec/api/buckets_api_spec.rb

@@ -0,0 +1,103 @@
+=begin
+#MUDBASESDK
+
+#MUDBASE is a scalable, real-time, and secure Backend-as-a-Service (BaaS) platform  designed for modern applications. Built with custom logic, it offers fine-grained  control, extensibility, and enterprise-grade security.  ## Features - 🔐 Multi-provider authentication (30+ OAuth providers) - 📊 Real-time database with collections - 📁 File storage and management - 🔑 API key management with permissions - 🔗 Webhook system with retry logic - ⚡ Serverless functions - 💬 Multi-channel messaging (Push, Email, SMS) - 📈 Usage analytics and monitoring - 🌐 Real-time WebSocket events - 🔍 Full-text search capabilities - 💳 Billing: Flutterwave only for fiat (platform subscriptions + org payment processing with 7% + $0.50 split); crypto payment processor for multi-chain checkout - 📡 Block-based multi-chain wallet monitoring (ETH/UTXO scanners, GetBlock, scanner metrics API)  ## Testing Configurations Below are example configurations for testing in different environments:  ### Production ```json {   \"scheme\": \"http\",   \"base_path\": \"\",   \"host\": \"cloud.mudbase.dev\",   \"xApiKey\": \"xApiKey\",   \"bearerToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4NWFjYmUwZTEyOTkzMmZiYjdhMGZjMiIsImVtYWlsIjoibXVkaGF4a3NlcnZpY2VzQGdtYWlsLmNvbSIsImlhdCI6MTc1MDc4MDg5OCwiZXhwIjoxNzUwODY3Mjk4fQ.sfoqzEbCuz5Y8qHkLItzrZZYC823SPT4RbO7Kucqvuc\",   \"userId\": \"685acbe0e129932fbb7a0fc2\",   \"projectId\": \"685ad30be129932fbb7a1047\",   \"collectionId\": \"685ada8fd9416ac02f171abf\",   \"documentId\": \"685ae1210136e73fa1dcaf36\",   \"apikeyId\": \"685ae8a785426b6a4190d5fc\",   \"webhookId\": \"685af3992f9c4c96514247e9\",   \"functionId\": \"685af8b85d73a104065b6a77\",   \"fileId\": \"685af8b85d73a104065b6a77\" } 
+
+The version of the OpenAPI document: 1.1.4
+Contact: support@mudbase.dev
+Generated by: https://openapi-generator.tech
+Generator version: 7.20.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for Mudbase::BucketsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'BucketsApi' do
+  before do
+    # run before each test
+    @api_instance = Mudbase::BucketsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of BucketsApi' do
+    it 'should create an instance of BucketsApi' do
+      expect(@api_instance).to be_instance_of(Mudbase::BucketsApi)
+    end
+  end
+
+  # unit tests for create_bucket
+  # Create a new bucket
+  # Create a new storage bucket in a project. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+  # @param project_id Project ID.
+  # @param create_bucket_request Bucket name, isPublic flag, and optional settings.
+  # @param [Hash] opts the optional parameters
+  # @return [BucketResponse]
+  describe 'create_bucket test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for delete_bucket
+  # Delete bucket
+  # Delete a storage bucket permanently. This is a destructive operation that will also delete all files in the bucket. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+  # @param project_id Project ID.
+  # @param bucket_id Bucket ID.
+  # @param [Hash] opts the optional parameters
+  # @return [MessageResponse]
+  describe 'delete_bucket test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for get_bucket
+  # Get bucket details
+  # Retrieve metadata and configuration for a single storage bucket, including name, project, public/private status, and settings. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+  # @param project_id Project ID.
+  # @param bucket_id Bucket ID.
+  # @param [Hash] opts the optional parameters
+  # @return [BucketResponse]
+  describe 'get_bucket test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for list_buckets
+  # List buckets in a project
+  # List all storage buckets in a project with pagination and search. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+  # @param project_id Project ID.
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :page Page number (1-based).
+  # @option opts [Integer] :limit Number of buckets per page.
+  # @option opts [String] :search Search by bucket name.
+  # @return [BucketListResponse]
+  describe 'list_buckets test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for update_bucket
+  # Update bucket
+  # Update bucket configuration (name, public/private status, settings). Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+  # @param project_id Project ID.
+  # @param bucket_id Bucket ID.
+  # @param update_bucket_request Fields to update (name, isPublic, settings).
+  # @param [Hash] opts the optional parameters
+  # @return [BucketResponse]
+  describe 'update_bucket test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end