mudbase-sdk 1.1.9 → 1.2.1

package/docs/BillingApi.md

@@ -4,22 +4,22 @@ All URIs are relative to *https://cloud.mudbase.dev*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
-| [**checkFeatureAccess**](BillingApi.md#checkfeatureaccess) | **GET** /api/billing/public/projects/{projectId}/feature-access | Check feature access (public) |
-| [**checkSubscription**](BillingApi.md#checksubscription) | **GET** /api/billing/public/projects/{projectId}/subscription | Check subscription status (public) |
-| [**createCheckoutSession**](BillingApi.md#createcheckoutsessionoperation) | **POST** /api/billing/public/projects/{projectId}/checkout | Create checkout session (Flutterwave or crypto) |
-| [**getCheckoutPayment**](BillingApi.md#getcheckoutpayment) | **GET** /api/billing/public/projects/{projectId}/checkout/{paymentId} | Get checkout payment details |
-| [**getPublicPlans**](BillingApi.md#getpublicplans) | **GET** /api/billing/public/projects/{projectId}/plans | Get public plans (no auth required) |
-| [**handleCryptoPaymentWebhook**](BillingApi.md#handlecryptopaymentwebhookoperation) | **POST** /api/billing/webhooks/crypto | Crypto payment processor webhook |
-| [**handleFlutterwaveWebhook**](BillingApi.md#handleflutterwavewebhookoperation) | **POST** /api/billing/webhooks/flutterwave | Flutterwave webhook |
-| [**initializePaymentForProject**](BillingApi.md#initializepaymentforprojectoperation) | **POST** /api/projects/{projectId}/payment-processing/initialize-payment | Initialize fiat payment (project-scoped) |
-| [**recordUsage**](BillingApi.md#recordusageoperation) | **POST** /api/billing/public/projects/{projectId}/usage | Record usage (public) |
-| [**verifyPayment**](BillingApi.md#verifypayment) | **POST** /api/billing/public/projects/{projectId}/verify-payment | Verify payment and create subscription |
+| [**billingCheckFeatureAccess**](BillingApi.md#billingcheckfeatureaccess) | **GET** /api/billing/public/projects/{projectId}/feature-access | Check feature access (public) |
+| [**billingCheckSubscription**](BillingApi.md#billingchecksubscription) | **GET** /api/billing/public/projects/{projectId}/subscription | Check subscription status (public) |
+| [**billingCreateCheckoutSession**](BillingApi.md#billingcreatecheckoutsessionoperation) | **POST** /api/billing/public/projects/{projectId}/checkout | Create checkout session (Flutterwave or crypto) |
+| [**billingGetCheckoutPayment**](BillingApi.md#billinggetcheckoutpayment) | **GET** /api/billing/public/projects/{projectId}/checkout/{paymentId} | Get checkout payment details |
+| [**billingGetPublicPlans**](BillingApi.md#billinggetpublicplans) | **GET** /api/billing/public/projects/{projectId}/plans | Get public plans (no auth required) |
+| [**billingHandleCryptoWebhook**](BillingApi.md#billinghandlecryptowebhookoperation) | **POST** /api/billing/webhooks/crypto | Crypto payment processor webhook |
+| [**billingHandleFlutterwaveWebhook**](BillingApi.md#billinghandleflutterwavewebhookoperation) | **POST** /api/billing/webhooks/flutterwave | Flutterwave webhook |
+| [**billingInitializePayment**](BillingApi.md#billinginitializepaymentoperation) | **POST** /api/projects/{projectId}/payment-processing/initialize-payment | Initialize fiat payment (app-scoped) |
+| [**billingRecordUsage**](BillingApi.md#billingrecordusageoperation) | **POST** /api/billing/public/projects/{projectId}/usage | Record usage (public) |
+| [**billingVerifyPayment**](BillingApi.md#billingverifypayment) | **POST** /api/billing/public/projects/{projectId}/verify-payment | Verify payment and create subscription |
 
 
 
-## checkFeatureAccess
+## billingCheckFeatureAccess
 
-> CheckFeatureAccess200Response checkFeatureAccess(projectId, email, feature)
+> BillingCheckFeatureAccess200Response billingCheckFeatureAccess(projectId, email, feature)
 
 Check feature access (public)
 
@@ -32,7 +32,7 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { CheckFeatureAccessRequest } from 'mudbase-sdk';
+import type { BillingCheckFeatureAccessRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
@@ -45,10 +45,10 @@ async function example() {
     email: email_example,
     // string | Feature slug to check access for
     feature: feature_example,
-  } satisfies CheckFeatureAccessRequest;
+  } satisfies BillingCheckFeatureAccessRequest;
 
   try {
-    const data = await api.checkFeatureAccess(body);
+    const data = await api.billingCheckFeatureAccess(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -70,7 +70,7 @@ example().catch(console.error);
 
 ### Return type
 
-[**CheckFeatureAccess200Response**](CheckFeatureAccess200Response.md)
+[**BillingCheckFeatureAccess200Response**](BillingCheckFeatureAccess200Response.md)
 
 ### Authorization
 
@@ -86,15 +86,15 @@ No authorization required
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **200** | Feature access status |  -  |
-| **401** | Authentication required |  -  |
-| **403** | Access denied |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## checkSubscription
+## billingCheckSubscription
 
-> CheckSubscription200Response checkSubscription(projectId, email)
+> BillingCheckSubscription200Response billingCheckSubscription(projectId, email)
 
 Check subscription status (public)
 
@@ -107,7 +107,7 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { CheckSubscriptionRequest } from 'mudbase-sdk';
+import type { BillingCheckSubscriptionRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
@@ -118,10 +118,10 @@ async function example() {
     projectId: projectId_example,
     // string | Customer email to check subscription for
     email: email_example,
-  } satisfies CheckSubscriptionRequest;
+  } satisfies BillingCheckSubscriptionRequest;
 
   try {
-    const data = await api.checkSubscription(body);
+    const data = await api.billingCheckSubscription(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -142,7 +142,7 @@ example().catch(console.error);
 
 ### Return type
 
-[**CheckSubscription200Response**](CheckSubscription200Response.md)
+[**BillingCheckSubscription200Response**](BillingCheckSubscription200Response.md)
 
 ### Authorization
 
@@ -158,15 +158,15 @@ No authorization required
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **200** | Subscription status |  -  |
-| **401** | Authentication required |  -  |
-| **403** | Access denied |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## createCheckoutSession
+## billingCreateCheckoutSession
 
-> CreateCheckoutSession200Response createCheckoutSession(projectId, createCheckoutSessionRequest)
+> BillingCreateCheckoutSession200Response billingCreateCheckoutSession(projectId, billingCreateCheckoutSessionRequest)
 
 Create checkout session (Flutterwave or crypto)
 
@@ -179,7 +179,7 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { CreateCheckoutSessionOperationRequest } from 'mudbase-sdk';
+import type { BillingCreateCheckoutSessionOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
@@ -188,12 +188,12 @@ async function example() {
   const body = {
     // string | Project ID (MongoDB ObjectId) for the billing project.
     projectId: projectId_example,
-    // CreateCheckoutSessionRequest | Plan to subscribe to, billing cycle, customer email/name, and optional success/cancel redirect URLs.
-    createCheckoutSessionRequest: {"planId":"65a1b2c3d4e5f6789012345d","billingCycle":"monthly","customerInfo":{"email":"customer@example.com","name":"John Doe"},"successUrl":"https://app.example.com/success","cancelUrl":"https://app.example.com/cancel"},
-  } satisfies CreateCheckoutSessionOperationRequest;
+    // BillingCreateCheckoutSessionRequest | Plan to subscribe to, billing cycle, customer email/name, and optional success/cancel redirect URLs.
+    billingCreateCheckoutSessionRequest: {"planId":"65a1b2c3d4e5f6789012345d","billingCycle":"monthly","customerInfo":{"email":"customer@example.com","name":"John Doe"},"successUrl":"https://app.example.com/success","cancelUrl":"https://app.example.com/cancel"},
+  } satisfies BillingCreateCheckoutSessionOperationRequest;
 
   try {
-    const data = await api.createCheckoutSession(body);
+    const data = await api.billingCreateCheckoutSession(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -210,11 +210,11 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **projectId** | `string` | Project ID (MongoDB ObjectId) for the billing project. | [Defaults to `undefined`] |
-| **createCheckoutSessionRequest** | [CreateCheckoutSessionRequest](CreateCheckoutSessionRequest.md) | Plan to subscribe to, billing cycle, customer email/name, and optional success/cancel redirect URLs. | |
+| **billingCreateCheckoutSessionRequest** | [BillingCreateCheckoutSessionRequest](BillingCreateCheckoutSessionRequest.md) | Plan to subscribe to, billing cycle, customer email/name, and optional success/cancel redirect URLs. | |
 
 ### Return type
 
-[**CreateCheckoutSession200Response**](CreateCheckoutSession200Response.md)
+[**BillingCreateCheckoutSession200Response**](BillingCreateCheckoutSession200Response.md)
 
 ### Authorization
 
@@ -231,16 +231,16 @@ No authorization required
 |-------------|-------------|------------------|
 | **200** | Checkout session created |  -  |
 | **400** | Missing planId, billingCycle, or customerInfo.email |  -  |
-| **401** | Authentication required |  -  |
-| **403** | Access denied |  -  |
-| **500** | Internal server error |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## getCheckoutPayment
+## billingGetCheckoutPayment
 
-> GetCheckoutPayment200Response getCheckoutPayment(projectId, paymentId)
+> BillingGetCheckoutPayment200Response billingGetCheckoutPayment(projectId, paymentId)
 
 Get checkout payment details
 
@@ -253,7 +253,7 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { GetCheckoutPaymentRequest } from 'mudbase-sdk';
+import type { BillingGetCheckoutPaymentRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
@@ -264,10 +264,10 @@ async function example() {
     projectId: projectId_example,
     // string | Payment ID or reference from checkout session
     paymentId: paymentId_example,
-  } satisfies GetCheckoutPaymentRequest;
+  } satisfies BillingGetCheckoutPaymentRequest;
 
   try {
-    const data = await api.getCheckoutPayment(body);
+    const data = await api.billingGetCheckoutPayment(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -288,7 +288,7 @@ example().catch(console.error);
 
 ### Return type
 
-[**GetCheckoutPayment200Response**](GetCheckoutPayment200Response.md)
+[**BillingGetCheckoutPayment200Response**](BillingGetCheckoutPayment200Response.md)
 
 ### Authorization
 
@@ -304,17 +304,17 @@ No authorization required
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **200** | Payment details |  -  |
-| **401** | Authentication required |  -  |
-| **403** | Access denied |  -  |
-| **404** | Payment not found |  -  |
-| **500** | Internal server error |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
+| **404** | Payment not found (exact backend message for payment admin endpoints). |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## getPublicPlans
+## billingGetPublicPlans
 
-> GetPublicPlans200Response getPublicPlans(projectId)
+> BillingGetPublicPlans200Response billingGetPublicPlans(projectId)
 
 Get public plans (no auth required)
 
@@ -327,7 +327,7 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { GetPublicPlansRequest } from 'mudbase-sdk';
+import type { BillingGetPublicPlansRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
@@ -336,10 +336,10 @@ async function example() {
   const body = {
     // string | Project ID (MongoDB ObjectId) to list plans for.
     projectId: projectId_example,
-  } satisfies GetPublicPlansRequest;
+  } satisfies BillingGetPublicPlansRequest;
 
   try {
-    const data = await api.getPublicPlans(body);
+    const data = await api.billingGetPublicPlans(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -359,7 +359,7 @@ example().catch(console.error);
 
 ### Return type
 
-[**GetPublicPlans200Response**](GetPublicPlans200Response.md)
+[**BillingGetPublicPlans200Response**](BillingGetPublicPlans200Response.md)
 
 ### Authorization
 
@@ -375,15 +375,15 @@ No authorization required
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **200** | Public plans list |  -  |
-| **401** | Authentication required |  -  |
-| **403** | Access denied |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## handleCryptoPaymentWebhook
+## billingHandleCryptoWebhook
 
-> HandleCryptoPaymentWebhook200Response handleCryptoPaymentWebhook(handleCryptoPaymentWebhookRequest)
+> BillingHandleCryptoWebhook200Response billingHandleCryptoWebhook(billingHandleCryptoWebhookRequest)
 
 Crypto payment processor webhook
 
@@ -396,19 +396,19 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { HandleCryptoPaymentWebhookOperationRequest } from 'mudbase-sdk';
+import type { BillingHandleCryptoWebhookOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const api = new BillingApi();
 
   const body = {
-    // HandleCryptoPaymentWebhookRequest | Crypto payment webhook payload (event type and data with paymentId, reference, amount, currency, network, status, metadata).
-    handleCryptoPaymentWebhookRequest: {"event":"payment.completed","data":{"paymentId":"pmt_abc123xyz789","reference":"pmt_abc123xyz789","amount":29.99,"currency":"USD","network":"polygon","status":"completed","metadata":{"isPlatformBilling":true,"planId":"65a1b2c3d4e5f6789012345d","billingCycle":"monthly","customerEmail":"customer@example.com"}}},
-  } satisfies HandleCryptoPaymentWebhookOperationRequest;
+    // BillingHandleCryptoWebhookRequest | Crypto payment webhook payload (event type and data with paymentId, reference, amount, currency, network, status, metadata).
+    billingHandleCryptoWebhookRequest: {"event":"payment.completed","data":{"paymentId":"pmt_abc123xyz789","reference":"pmt_abc123xyz789","amount":29.99,"currency":"USD","network":"polygon","status":"completed","metadata":{"isPlatformBilling":true,"planId":"65a1b2c3d4e5f6789012345d","billingCycle":"monthly","customerEmail":"customer@example.com"}}},
+  } satisfies BillingHandleCryptoWebhookOperationRequest;
 
   try {
-    const data = await api.handleCryptoPaymentWebhook(body);
+    const data = await api.billingHandleCryptoWebhook(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -424,11 +424,11 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **handleCryptoPaymentWebhookRequest** | [HandleCryptoPaymentWebhookRequest](HandleCryptoPaymentWebhookRequest.md) | Crypto payment webhook payload (event type and data with paymentId, reference, amount, currency, network, status, metadata). | |
+| **billingHandleCryptoWebhookRequest** | [BillingHandleCryptoWebhookRequest](BillingHandleCryptoWebhookRequest.md) | Crypto payment webhook payload (event type and data with paymentId, reference, amount, currency, network, status, metadata). | |
 
 ### Return type
 
-[**HandleCryptoPaymentWebhook200Response**](HandleCryptoPaymentWebhook200Response.md)
+[**BillingHandleCryptoWebhook200Response**](BillingHandleCryptoWebhook200Response.md)
 
 ### Authorization
 
@@ -445,16 +445,16 @@ No authorization required
 |-------------|-------------|------------------|
 | **200** | Webhook processed |  -  |
 | **400** | Event type is required or invalid payload |  -  |
-| **401** | Authentication required |  -  |
-| **403** | Access denied |  -  |
-| **500** | Internal server error |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## handleFlutterwaveWebhook
+## billingHandleFlutterwaveWebhook
 
-> HandleCryptoPaymentWebhook200Response handleFlutterwaveWebhook(handleFlutterwaveWebhookRequest)
+> BillingHandleCryptoWebhook200Response billingHandleFlutterwaveWebhook(billingHandleFlutterwaveWebhookRequest)
 
 Flutterwave webhook
 
@@ -467,19 +467,19 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { HandleFlutterwaveWebhookOperationRequest } from 'mudbase-sdk';
+import type { BillingHandleFlutterwaveWebhookOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const api = new BillingApi();
 
   const body = {
-    // HandleFlutterwaveWebhookRequest | Flutterwave webhook payload (event and data with id, tx_ref, amount, currency, status, customer, meta for subscription or payment-processing).
-    handleFlutterwaveWebhookRequest: {"event":"charge.completed","data":{"id":123456789,"tx_ref":"mudbase_fiat_org123_project456_1234567890_abc","amount":100,"currency":"USD","status":"successful","customer":{"email":"customer@example.com","name":"John Doe"},"meta":{"orgId":"65a1b2c3d4e5f6789012345a","projectId":"65a1b2c3d4e5f6789012345b","isPaymentProcessing":true}}},
-  } satisfies HandleFlutterwaveWebhookOperationRequest;
+    // BillingHandleFlutterwaveWebhookRequest | Flutterwave webhook payload (event and data with id, tx_ref, amount, currency, status, customer, meta for subscription or payment-processing).
+    billingHandleFlutterwaveWebhookRequest: {"event":"charge.completed","data":{"id":123456789,"tx_ref":"mudbase_fiat_org123_project456_1234567890_abc","amount":100,"currency":"USD","status":"successful","customer":{"email":"customer@example.com","name":"John Doe"},"meta":{"orgId":"65a1b2c3d4e5f6789012345a","projectId":"65a1b2c3d4e5f6789012345b","isPaymentProcessing":true}}},
+  } satisfies BillingHandleFlutterwaveWebhookOperationRequest;
 
   try {
-    const data = await api.handleFlutterwaveWebhook(body);
+    const data = await api.billingHandleFlutterwaveWebhook(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -495,11 +495,11 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **handleFlutterwaveWebhookRequest** | [HandleFlutterwaveWebhookRequest](HandleFlutterwaveWebhookRequest.md) | Flutterwave webhook payload (event and data with id, tx_ref, amount, currency, status, customer, meta for subscription or payment-processing). | |
+| **billingHandleFlutterwaveWebhookRequest** | [BillingHandleFlutterwaveWebhookRequest](BillingHandleFlutterwaveWebhookRequest.md) | Flutterwave webhook payload (event and data with id, tx_ref, amount, currency, status, customer, meta for subscription or payment-processing). | |
 
 ### Return type
 
-[**HandleCryptoPaymentWebhook200Response**](HandleCryptoPaymentWebhook200Response.md)
+[**BillingHandleCryptoWebhook200Response**](BillingHandleCryptoWebhook200Response.md)
 
 ### Authorization
 
@@ -516,18 +516,18 @@ No authorization required
 |-------------|-------------|------------------|
 | **200** | Webhook received |  -  |
 | **400** | Invalid or missing event |  -  |
-| **401** | Authentication required |  -  |
-| **403** | Access denied |  -  |
-| **500** | Internal server error |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## initializePaymentForProject
+## billingInitializePayment
 
-> initializePaymentForProject(projectId, initializePaymentForProjectRequest)
+> billingInitializePayment(projectId, billingInitializePaymentRequest)
 
-Initialize fiat payment (project-scoped)
+Initialize fiat payment (app-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.
 
@@ -538,12 +538,12 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { InitializePaymentForProjectOperationRequest } from 'mudbase-sdk';
+import type { BillingInitializePaymentOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: ProjectBearerAuth
+    // Configure HTTP bearer authorization: BearerToken
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new BillingApi(config);
@@ -551,12 +551,12 @@ async function example() {
   const body = {
     // string | Project ID for payment scope and tx_ref.
     projectId: projectId_example,
-    // InitializePaymentForProjectRequest | Payment amount, currency, customer (email, name), and optional metadata.
-    initializePaymentForProjectRequest: ...,
-  } satisfies InitializePaymentForProjectOperationRequest;
+    // BillingInitializePaymentRequest | Payment amount, currency, customer (email, name), and optional metadata.
+    billingInitializePaymentRequest: ...,
+  } satisfies BillingInitializePaymentOperationRequest;
 
   try {
-    const data = await api.initializePaymentForProject(body);
+    const data = await api.billingInitializePayment(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -573,7 +573,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **projectId** | `string` | Project ID for payment scope and tx_ref. | [Defaults to `undefined`] |
-| **initializePaymentForProjectRequest** | [InitializePaymentForProjectRequest](InitializePaymentForProjectRequest.md) | Payment amount, currency, customer (email, name), and optional metadata. | |
+| **billingInitializePaymentRequest** | [BillingInitializePaymentRequest](BillingInitializePaymentRequest.md) | Payment amount, currency, customer (email, name), and optional metadata. | |
 
 ### Return type
 
@@ -581,7 +581,7 @@ example().catch(console.error);
 
 ### Authorization
 
-[ProjectBearerAuth](../README.md#ProjectBearerAuth)
+[BearerToken](../README.md#BearerToken)
 
 ### HTTP request headers
 
@@ -593,16 +593,16 @@ example().catch(console.error);
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **200** | Payment link and fee breakdown (same shape as org-level) |  -  |
-| **400** | Bad request |  -  |
-| **401** | Authentication required |  -  |
-| **500** | Internal server error |  -  |
+| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## recordUsage
+## billingRecordUsage
 
-> MessageResponse recordUsage(projectId, recordUsageRequest)
+> MessageResponse billingRecordUsage(projectId, billingRecordUsageRequest)
 
 Record usage (public)
 
@@ -615,7 +615,7 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { RecordUsageOperationRequest } from 'mudbase-sdk';
+import type { BillingRecordUsageOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
@@ -624,12 +624,12 @@ async function example() {
   const body = {
     // string | Project ID (MongoDB ObjectId) for the billing project.
     projectId: projectId_example,
-    // RecordUsageRequest | Customer email, metric name (e.g. api_calls, storage_mb), and quantity to record.
-    recordUsageRequest: {"email":"customer@example.com","metric":"api_calls","quantity":150},
-  } satisfies RecordUsageOperationRequest;
+    // BillingRecordUsageRequest | Customer email, metric name (e.g. api_calls, storage_mb), and quantity to record.
+    billingRecordUsageRequest: {"email":"customer@example.com","metric":"api_calls","quantity":150},
+  } satisfies BillingRecordUsageOperationRequest;
 
   try {
-    const data = await api.recordUsage(body);
+    const data = await api.billingRecordUsage(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -646,7 +646,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **projectId** | `string` | Project ID (MongoDB ObjectId) for the billing project. | [Defaults to `undefined`] |
-| **recordUsageRequest** | [RecordUsageRequest](RecordUsageRequest.md) | Customer email, metric name (e.g. api_calls, storage_mb), and quantity to record. | |
+| **billingRecordUsageRequest** | [BillingRecordUsageRequest](BillingRecordUsageRequest.md) | Customer email, metric name (e.g. api_calls, storage_mb), and quantity to record. | |
 
 ### Return type
 
@@ -666,16 +666,16 @@ No authorization required
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **200** | Usage recorded |  -  |
-| **400** | Bad request |  -  |
-| **401** | Authentication required |  -  |
-| **403** | Access denied |  -  |
+| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
+| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
+| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## verifyPayment
+## billingVerifyPayment
 
-> VerifyPayment200Response verifyPayment(projectId, reference)
+> BillingVerifyPayment200Response billingVerifyPayment(projectId, reference)
 
 Verify payment and create subscription
 
@@ -688,7 +688,7 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { VerifyPaymentRequest } from 'mudbase-sdk';
+import type { BillingVerifyPaymentRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
@@ -699,10 +699,10 @@ async function example() {
     projectId: projectId_example,
     // string | Payment reference (e.g. mudbase_abc123 or pmt_abc123)
     reference: reference_example,
-  } satisfies VerifyPaymentRequest;
+  } satisfies BillingVerifyPaymentRequest;
 
   try {
-    const data = await api.verifyPayment(body);
+    const data = await api.billingVerifyPayment(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -723,7 +723,7 @@ example().catch(console.error);
 
 ### Return type
 
-[**VerifyPayment200Response**](VerifyPayment200Response.md)
+[**BillingVerifyPayment200Response**](BillingVerifyPayment200Response.md)
 
 ### Authorization
 
@@ -741,7 +741,7 @@ No authorization required
 | **200** | Payment verified and subscription created |  -  |
 | **400** | reference is required or organization context missing |  -  |
 | **403** | Payment does not belong to your organization |  -  |
-| **500** | Internal server error |  -  |
+| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 

package/docs/BillingCheckFeatureAccess200Response.md

@@ -0,0 +1,36 @@
+
+# BillingCheckFeatureAccess200Response
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`hasAccess` | boolean
+`reason` | string
+
+## Example
+
+```typescript
+import type { BillingCheckFeatureAccess200Response } from 'mudbase-sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "hasAccess": null,
+  "reason": null,
+} satisfies BillingCheckFeatureAccess200Response
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as BillingCheckFeatureAccess200Response
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+