@buildbase/sdk 0.0.45 → 0.0.46

package/dist/react/index.d.ts

@@ -99,6 +99,8 @@ type DunningStateType = (typeof DunningState)[keyof typeof DunningState];
 interface ISubscription {
     _id: string;
     subscriptionStatus: SubscriptionStatusType;
+    /** Stripe Subscription ID (e.g. 'sub_...'). Present when linked to Stripe. */
+    subscriptionId?: string;
     stripePriceId?: string;
     stripeCurrentPeriodEnd?: string;
     /** When the current monthly usage period ends (quotas reset on this date). */
@@ -537,12 +539,10 @@ interface IInvoice {
     subscription: string;
 }
 interface IInvoiceListResponse {
-    success: boolean;
     invoices: IInvoice[];
     has_more: boolean;
 }
 interface IInvoiceResponse {
-    success: boolean;
     invoice: IInvoice;
 }
 /** Request body for POST .../workspaces/:id/subscription/usage */
@@ -1066,6 +1066,8 @@ interface IBaseApiConfig {
         method: string;
         path: string;
     }) => void;
+    /** Called when any request receives a 401 response (session expired mid-use). */
+    onUnauthorized?: () => void;
     /** Custom fetch implementation. */
     fetch?: typeof globalThis.fetch;
 }
@@ -1089,6 +1091,7 @@ declare abstract class BaseApi {
     private readonly _debug;
     private readonly _customHeaders;
     private readonly _onError?;
+    private readonly _onUnauthorized?;
     private readonly _fetch;
     constructor(config: IBaseApiConfig);
     /** Throws if config is not ready for API calls. Called automatically by fetchJson/fetchResponse. */
@@ -1117,6 +1120,16 @@ declare abstract class BaseApi {
      * Caller is responsible for checking response.ok and parsing body.
      */
     protected fetchResponse(path: string, init?: RequestInit): Promise<Response>;
+    /**
+     * Throw an error from a failed response.
+     * Tries to parse JSON error body; falls back to status-based message.
+     */
+    protected throwResponseError(response: Response, defaultMsg: string): Promise<never>;
+    /**
+     * Parse JSON and unwrap `{ success, data }` envelope if present.
+     * Throws if `success` is explicitly `false`.
+     */
+    protected unwrapResponse<T>(response: Response, defaultMsg: string): Promise<T>;
 }
 
 /**
@@ -1145,7 +1158,8 @@ declare class AuthApi extends BaseApi {
     });
     /**
      * Initiate OAuth sign-in flow. Returns redirect URL to the auth provider.
-     * Uses /api/v1/auth/request (no 'public' prefix — auth endpoints are at the root).
+     * Uses /api/v1/auth/request — auth endpoints sit outside the /public basePath,
+     * so we build the URL directly instead of using fetchResponse.
      */
     requestAuth(params: AuthRequestParams): Promise<AuthRequestResponse>;
     /** Fetch user profile with the given session ID (used after OAuth redirect or from storage). */
@@ -1298,6 +1312,7 @@ interface NotificationEvent {
 declare class WorkspaceApi extends BaseApi {
     constructor(config: IOsConfig & {
         sessionId?: string;
+        onUnauthorized?: () => void;
     });
     getWorkspaces(): Promise<IWorkspace[]>;
     createWorkspace(data: {
@@ -1671,23 +1686,11 @@ declare class EventEmitter {
 }
 declare const eventEmitter: EventEmitter;
 
-/**
- * Notify all subscribers to refetch credit balance (e.g. after consume or purchase).
- * Called internally by useConsumeCredits, usePurchaseCredits on success.
- */
-declare function invalidateCreditBalance(): void;
+declare const invalidateCreditBalance: () => void;
 
-/**
- * Notify all subscribers to refetch quota usage (e.g. after recording usage).
- * Called internally by useRecordUsage on success.
- */
-declare function invalidateQuotaUsage(): void;
+declare const invalidateQuotaUsage: () => void;
 
-/**
- * Notify all subscribers to refetch subscription (e.g. after update/cancel/resume).
- * Called internally by useUpdateSubscription, useCancelSubscription, useResumeSubscription on success.
- */
-declare function invalidateSubscription(): void;
+declare const invalidateSubscription: () => void;
 
 /**
  * BuildBase URL parameter utilities.
@@ -2148,7 +2151,7 @@ declare function hasPermission(permission: string | string[], ctx: PermissionCon
  *
  * Or manually create `public/push-sw.js` with this content.
  */
-declare const PUSH_SERVICE_WORKER_SCRIPT = "\n// BuildBase Push Notification Service Worker\n// Place this file in your app's public directory (e.g. public/push-sw.js)\n\nself.addEventListener('push', function(event) {\n  if (!event.data) return;\n\n  try {\n    var payload = event.data.json();\n    var title = payload.title || 'Notification';\n    var options = {\n      body: payload.body || '',\n      icon: payload.icon || undefined,\n      badge: payload.icon || undefined,\n      data: { url: payload.url, ...(payload.data || {}) },\n      tag: 'buildbase-push-' + Date.now(),\n    };\n\n    event.waitUntil(\n      self.registration.showNotification(title, options)\n    );\n  } catch (e) {\n    console.error('[PushSW] Failed to show notification:', e);\n  }\n});\n\nself.addEventListener('notificationclick', function(event) {\n  event.notification.close();\n\n  var url = event.notification.data && event.notification.data.url;\n  if (url) {\n    event.waitUntil(\n      clients.matchAll({ type: 'window', includeUncontrolled: true }).then(function(clientList) {\n        for (var i = 0; i < clientList.length; i++) {\n          var client = clientList[i];\n          if (client.url === url && 'focus' in client) {\n            return client.focus();\n          }\n        }\n        if (clients.openWindow) {\n          return clients.openWindow(url);\n        }\n      })\n    );\n  }\n});\n";
+declare const PUSH_SERVICE_WORKER_SCRIPT = "\n// BuildBase Push Notification Service Worker\n// Place this file in your app's public directory (e.g. public/push-sw.js)\n\nself.addEventListener('push', function(event) {\n  if (!event.data) return;\n\n  try {\n    const payload = event.data.json();\n    const title = payload.title || 'Notification';\n    const options = {\n      body: payload.body || '',\n      icon: payload.icon || undefined,\n      badge: payload.icon || undefined,\n      data: { url: payload.url, ...(payload.data || {}) },\n      tag: 'buildbase-push-' + Date.now(),\n    };\n\n    event.waitUntil(\n      self.registration.showNotification(title, options)\n    );\n  } catch (e) {\n    console.error('[PushSW] Failed to show notification:', e);\n  }\n});\n\nself.addEventListener('notificationclick', function(event) {\n  event.notification.close();\n\n  const url = event.notification.data && event.notification.data.url;\n  if (url) {\n    event.waitUntil(\n      clients.matchAll({ type: 'window', includeUncontrolled: true }).then(function(clientList) {\n        for (let i = 0; i < clientList.length; i++) {\n          const client = clientList[i];\n          if (client.url === url && 'focus' in client) {\n            return client.focus();\n          }\n        }\n        if (clients.openWindow) {\n          return clients.openWindow(url);\n        }\n      })\n    );\n  }\n});\n";
 
 interface BetaFormData {
     name?: string;
@@ -2206,6 +2209,9 @@ interface SDKMessages {
             error: string;
             refreshAction: string;
             retryAction: string;
+            noPermissionTitle: string;
+            noPermissionDescription: string;
+            billingManageOnly: string;
         };
     };
     subscription: {
@@ -4473,7 +4479,7 @@ declare const useSubscriptionManagement: (workspaceId: string | null | undefined
  *   return (
  *     <div>
  *       {invoices.map(invoice => (
- *         <InvoiceCard key={invoice._id} invoice={invoice} />
+ *         <InvoiceCard key={invoice.id} invoice={invoice} />
  *       ))}
  *       {hasMore && <button onClick={() => refetch()}>Load More</button>}
  *     </div>
@@ -4501,7 +4507,7 @@ declare const useSubscriptionManagement: (workspaceId: string | null | undefined
  *
  *   return (
  *     <div>
- *       {invoices.map(invoice => <InvoiceCard key={invoice._id} invoice={invoice} />)}
+ *       {invoices.map(invoice => <InvoiceCard key={invoice.id} invoice={invoice} />)}
  *       {hasMore && <button onClick={loadMore}>Load More</button>}
  *     </div>
  *   );