@butterbase/sdk 1.1.1 → 1.2.1

package/dist/billing/billing-client.js

@@ -0,0 +1,135 @@
+export class BillingClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    // ── Admin methods (require platform auth) ──
+    async connectOnboard() {
+        try {
+            const data = await this.client.request('POST', `/v1/${this.client.appId}/billing/connect/onboard`);
+            return { data, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    async connectStatus() {
+        try {
+            const data = await this.client.request('GET', `/v1/${this.client.appId}/billing/connect/status`);
+            return { data, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    async createPlan(params) {
+        try {
+            const data = await this.client.request('POST', `/v1/${this.client.appId}/billing/plans`, params);
+            return { data, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    async updatePlan(planId, updates) {
+        try {
+            const data = await this.client.request('PUT', `/v1/${this.client.appId}/billing/plans/${planId}`, updates);
+            return { data, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    async createProduct(params) {
+        try {
+            const data = await this.client.request('POST', `/v1/${this.client.appId}/billing/products`, params);
+            return { data, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    async updateProduct(productId, updates) {
+        try {
+            const data = await this.client.request('PUT', `/v1/${this.client.appId}/billing/products/${productId}`, updates);
+            return { data, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    // ── Client methods (end-user auth) ──
+    async listPlans() {
+        try {
+            const data = await this.client.request('GET', `/v1/${this.client.appId}/billing/plans`);
+            return { data: data.plans, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    async listProducts() {
+        try {
+            const data = await this.client.request('GET', `/v1/${this.client.appId}/billing/products`);
+            return { data: data.products, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    async subscribe(params) {
+        try {
+            const data = await this.client.request('POST', `/v1/${this.client.appId}/billing/subscribe`, params);
+            return { data, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    async getSubscription() {
+        try {
+            const data = await this.client.request('GET', `/v1/${this.client.appId}/billing/subscription`);
+            return { data: data.subscription, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    async cancel() {
+        try {
+            const data = await this.client.request('POST', `/v1/${this.client.appId}/billing/cancel`);
+            return { data, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    async purchase(params) {
+        try {
+            const data = await this.client.request('POST', `/v1/${this.client.appId}/billing/purchase`, params);
+            return { data, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    async listOrders() {
+        try {
+            const data = await this.client.request('GET', `/v1/${this.client.appId}/billing/orders`);
+            return { data: data.orders, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    async getOrder(orderId) {
+        try {
+            const data = await this.client.request('GET', `/v1/${this.client.appId}/billing/orders/${orderId}`);
+            return { data, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+}
+//# sourceMappingURL=billing-client.js.map

package/dist/billing/billing-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-client.js","sourceRoot":"","sources":["../../src/billing/billing-client.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,aAAa;IAChB,MAAM,CAAmB;IAEjC,YAAY,MAAwB;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,8CAA8C;IAE9C,KAAK,CAAC,cAAc;QAClB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,MAAM,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,0BAA0B,CAC3D,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,KAAK,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,yBAAyB,CACzD,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAwB;QACvC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,MAAM,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,gBAAgB,EAAE,MAAM,CACzD,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,OAAyD;QACxF,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,KAAK,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,kBAAkB,MAAM,EAAE,EAAE,OAAO,CACnE,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAA2B;QAC7C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,MAAM,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,mBAAmB,EAAE,MAAM,CAC5D,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,OAA4D;QACjG,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,KAAK,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,qBAAqB,SAAS,EAAE,EAAE,OAAO,CACzE,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,uCAAuC;IAEvC,KAAK,CAAC,SAAS;QACb,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,KAAK,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,gBAAgB,CAChD,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,KAAK,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,mBAAmB,CACnD,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAuB;QACrC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,MAAM,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,oBAAoB,EAAE,MAAM,CAC7D,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,KAAK,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,uBAAuB,CACvD,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,MAAM,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,iBAAiB,CAClD,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAsB;QACnC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,MAAM,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,mBAAmB,EAAE,MAAM,CAC5D,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,KAAK,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,iBAAiB,CACjD,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,KAAK,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,mBAAmB,OAAO,EAAE,CAC5D,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;CACF"}

package/dist/billing/types.d.ts

@@ -0,0 +1,93 @@
+export interface Plan {
+    id: string;
+    name: string;
+    price_cents: number;
+    interval: 'month' | 'year';
+    features: string[];
+    active: boolean;
+    created_at: string;
+    updated_at?: string;
+}
+export interface CreatePlanParams {
+    name: string;
+    priceCents: number;
+    interval?: 'month' | 'year';
+    features?: string[];
+}
+export interface Product {
+    id: string;
+    name: string;
+    description?: string;
+    price_cents: number;
+    currency: string;
+    active: boolean;
+    metadata: Record<string, string>;
+    created_at: string;
+    updated_at?: string;
+}
+export interface CreateProductParams {
+    name: string;
+    description?: string;
+    priceCents: number;
+    metadata?: Record<string, string>;
+}
+export interface Subscription {
+    id: string;
+    plan_id: string;
+    status: string;
+    current_period_start: string;
+    current_period_end: string;
+    cancel_at_period_end: boolean;
+    plan_name: string;
+    price_cents: number;
+    interval: string;
+    features: string[];
+}
+export interface SubscribeParams {
+    planId: string;
+    successUrl?: string;
+    cancelUrl?: string;
+}
+export interface CheckoutSession {
+    sessionId: string;
+    url: string;
+}
+export interface PurchaseParams {
+    productId: string;
+    successUrl?: string;
+    cancelUrl?: string;
+}
+export interface PurchaseResult {
+    sessionId: string;
+    url: string;
+    orderId: string;
+}
+export interface Order {
+    id: string;
+    product_id: string;
+    amount_cents: number;
+    platform_fee_cents: number;
+    currency: string;
+    status: string;
+    created_at: string;
+    refunded_at?: string;
+    product_name: string;
+    product_description?: string;
+    metadata?: Record<string, any>;
+}
+export interface ConnectOnboardParams {
+    returnUrl?: string;
+    refreshUrl?: string;
+}
+export interface ConnectOnboardResult {
+    accountId: string;
+    onboardingUrl: string;
+}
+export interface ConnectStatus {
+    connected: boolean;
+    accountId?: string;
+    chargesEnabled?: boolean;
+    payoutsEnabled?: boolean;
+    detailsSubmitted?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/billing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/billing/types.ts"],"names":[],"mappings":"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"}

package/dist/billing/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/billing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/billing/types.ts"],"names":[],"mappings":""}

package/dist/errors/index.d.ts

@@ -0,0 +1,26 @@
+export declare class ButterbaseError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly remediation?: string;
+    constructor(message: string, code: string, status: number, remediation?: string);
+}
+export declare class AuthError extends ButterbaseError {
+    constructor(message: string, code: string, status: number, remediation?: string);
+}
+export declare class ValidationError extends ButterbaseError {
+    constructor(message: string, code: string, status: number, remediation?: string);
+}
+export declare class NotFoundError extends ButterbaseError {
+    constructor(message: string, code: string, status: number, remediation?: string);
+}
+export declare class QuotaError extends ButterbaseError {
+    constructor(message: string, code: string, status: number, remediation?: string);
+}
+export declare class NetworkError extends ButterbaseError {
+    constructor(message: string, code?: string, status?: number, remediation?: string);
+}
+/**
+ * Parse an API error response into the appropriate ButterbaseError subclass
+ */
+export declare function parseApiError(status: number, body: any): ButterbaseError;
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAOhF;AAED,qBAAa,SAAU,SAAQ,eAAe;gBAChC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAIhF;AAED,qBAAa,eAAgB,SAAQ,eAAe;gBACtC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAIhF;AAED,qBAAa,aAAc,SAAQ,eAAe;gBACpC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAIhF;AAED,qBAAa,UAAW,SAAQ,eAAe;gBACjC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAIhF;AAED,qBAAa,YAAa,SAAQ,eAAe;gBACnC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAwB,EAAE,MAAM,GAAE,MAAU,EAAE,WAAW,CAAC,EAAE,MAAM;CAItG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,eAAe,CAsBxE"}

package/dist/errors/index.js

@@ -0,0 +1,64 @@
+export class ButterbaseError extends Error {
+    code;
+    status;
+    remediation;
+    constructor(message, code, status, remediation) {
+        super(message);
+        this.name = 'ButterbaseError';
+        this.code = code;
+        this.status = status;
+        this.remediation = remediation;
+    }
+}
+export class AuthError extends ButterbaseError {
+    constructor(message, code, status, remediation) {
+        super(message, code, status, remediation);
+        this.name = 'AuthError';
+    }
+}
+export class ValidationError extends ButterbaseError {
+    constructor(message, code, status, remediation) {
+        super(message, code, status, remediation);
+        this.name = 'ValidationError';
+    }
+}
+export class NotFoundError extends ButterbaseError {
+    constructor(message, code, status, remediation) {
+        super(message, code, status, remediation);
+        this.name = 'NotFoundError';
+    }
+}
+export class QuotaError extends ButterbaseError {
+    constructor(message, code, status, remediation) {
+        super(message, code, status, remediation);
+        this.name = 'QuotaError';
+    }
+}
+export class NetworkError extends ButterbaseError {
+    constructor(message, code = 'NETWORK_ERROR', status = 0, remediation) {
+        super(message, code, status, remediation);
+        this.name = 'NetworkError';
+    }
+}
+/**
+ * Parse an API error response into the appropriate ButterbaseError subclass
+ */
+export function parseApiError(status, body) {
+    const message = body?.error || body?.message || 'Unknown error';
+    const code = body?.code || '';
+    const remediation = body?.remediation;
+    if (status === 401 || status === 403 || code.startsWith('AUTH_')) {
+        return new AuthError(message, code || 'AUTH_UNAUTHORIZED', status, remediation);
+    }
+    if (status === 404 || code === 'RESOURCE_NOT_FOUND') {
+        return new NotFoundError(message, code || 'RESOURCE_NOT_FOUND', status, remediation);
+    }
+    if (status === 429 || code.startsWith('QUOTA_')) {
+        return new QuotaError(message, code || 'QUOTA_EXCEEDED', status, remediation);
+    }
+    if (status === 400 || status === 422 || code.startsWith('VALIDATION_')) {
+        return new ValidationError(message, code || 'VALIDATION_INVALID', status, remediation);
+    }
+    return new ButterbaseError(message, code || 'UNKNOWN_ERROR', status, remediation);
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,8 +4,23 @@ export { InsertBuilder, UpdateBuilder, DeleteBuilder } from './lib/mutation-buil
 export { AuthClient } from './auth/auth-client.js';
 export { StorageClient } from './storage/storage-client.js';
 export { FunctionsClient } from './functions/functions-client.js';
+export { AiClient } from './ai/ai-client.js';
+export { BillingClient } from './billing/billing-client.js';
+export { AdminClient } from './admin/admin-client.js';
+export { AdminSchemaClient } from './admin/schema-client.js';
+export { AdminRlsClient } from './admin/rls-client.js';
+export { AdminOAuthClient } from './admin/oauth-client.js';
+export { AdminConfigClient } from './admin/config-client.js';
+export { AdminFunctionsClient } from './admin/functions-client.js';
+export { AdminApiKeysClient } from './admin/api-keys-client.js';
+export { AdminAuditLogsClient } from './admin/audit-logs-client.js';
+export { AdminFrontendClient } from './admin/frontend-client.js';
+export { AdminRealtimeClient } from './admin/realtime-client.js';
+export { RealtimeClient } from './realtime/realtime-client.js';
+export { ButterbaseError, AuthError, ValidationError, NotFoundError, QuotaError, NetworkError, } from './errors/index.js';
 export { SessionManager } from './auth/session-manager.js';
 export { LocalSessionStorage, MemorySessionStorage, detectSessionStorage } from './auth/session-storage.js';
 export type { SessionStorage } from './auth/session-storage.js';
-export type { ButterbaseClientOptions, ButterbaseResponse, User, Session, SignUpParams, SignInParams, AuthResponse, LoginResponse, SignupResponse, OAuthParams, StorageObject, UploadResponse, DownloadUrlResponse, QueryOperator, QueryFilter, OrderByOptions, InvokeFunctionOptions, AuthEvent, AuthChangeCallback, Subscription, } from './types/index.js';
+export type { ButterbaseClientOptions, ButterbaseResponse, User, Session, SignUpParams, SignInParams, AuthResponse, LoginResponse, SignupResponse, OAuthParams, OAuthCallbackResult, StorageObject, UploadResponse, DownloadUrlResponse, QueryOperator, QueryFilter, OrderByOptions, InvokeFunctionOptions, AuthEvent, AuthChangeCallback, Subscription, ChatMessage, ChatOptions, ChatCompletion, ChatStreamChunk, AiConfig, AiUsage, Plan, CreatePlanParams, Product, CreateProductParams, BillingSubscription, CheckoutSession, SubscribeParams, PurchaseParams, PurchaseResult, Order, ConnectOnboardResult, ConnectStatus, SchemaTable, SchemaColumn, SchemaIndex, SchemaDefinition, MigrationResult, Migration, RlsPolicy, CreatePolicyParams, OAuthConfig, OAuthConfigParams, AppConfig, CorsConfig, JwtConfig, DeployFunctionParams, FunctionDetails, FunctionSummary, FunctionLog, LogOptions, ApiKey, ApiKeySummary, AuditLog, AuditLogQueryOptions, Deployment, CreateDeploymentParams, RealtimeConfig, RealtimeTableResult, } from './types/index.js';
+export type { RealtimeStatus, RealtimeChange, PresenceEvent, ChangeCallback, PresenceCallback, StatusCallback, RealtimeSubscription, } from './realtime/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGzF,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC5G,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,IAAI,EACJ,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,SAAS,EACT,kBAAkB,EAClB,YAAY,GACb,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGzF,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D,OAAO,EACL,eAAe,EACf,SAAS,EACT,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC5G,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,IAAI,EACJ,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,SAAS,EACT,kBAAkB,EAClB,YAAY,EAEZ,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAE5E,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,mBAAmB,EACpD,mBAAmB,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EACrF,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAE1C,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EACpF,SAAS,EAAE,kBAAkB,EAC7B,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,UAAU,EAAE,SAAS,EAChC,oBAAoB,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAC/E,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,oBAAoB,EAC9B,UAAU,EAAE,sBAAsB,EAElC,cAAc,EAAE,mBAAmB,GACpC,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,cAAc,EAAE,cAAc,EAAE,aAAa,EAC7C,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAChD,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -8,6 +8,23 @@ export { InsertBuilder, UpdateBuilder, DeleteBuilder } from './lib/mutation-buil
 export { AuthClient } from './auth/auth-client.js';
 export { StorageClient } from './storage/storage-client.js';
 export { FunctionsClient } from './functions/functions-client.js';
+export { AiClient } from './ai/ai-client.js';
+export { BillingClient } from './billing/billing-client.js';
+// Admin client
+export { AdminClient } from './admin/admin-client.js';
+export { AdminSchemaClient } from './admin/schema-client.js';
+export { AdminRlsClient } from './admin/rls-client.js';
+export { AdminOAuthClient } from './admin/oauth-client.js';
+export { AdminConfigClient } from './admin/config-client.js';
+export { AdminFunctionsClient } from './admin/functions-client.js';
+export { AdminApiKeysClient } from './admin/api-keys-client.js';
+export { AdminAuditLogsClient } from './admin/audit-logs-client.js';
+export { AdminFrontendClient } from './admin/frontend-client.js';
+export { AdminRealtimeClient } from './admin/realtime-client.js';
+// Realtime client
+export { RealtimeClient } from './realtime/realtime-client.js';
+// Error types
+export { ButterbaseError, AuthError, ValidationError, NotFoundError, QuotaError, NetworkError, } from './errors/index.js';
 // Session persistence
 export { SessionManager } from './auth/session-manager.js';
 export { LocalSessionStorage, MemorySessionStorage, detectSessionStorage } from './auth/session-storage.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE5E,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEzF,iBAAiB;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,sBAAsB;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE5E,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEzF,iBAAiB;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,cAAc;AACd,OAAO,EACL,eAAe,EACf,SAAS,EACT,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,sBAAsB;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/lib/butterbase-client.d.ts

@@ -4,6 +4,10 @@ import { StorageClient } from '../storage/storage-client.js';
 import { FunctionsClient } from '../functions/functions-client.js';
 import { SessionManager } from '../auth/session-manager.js';
 import { QueryBuilder } from './query-builder.js';
+import { AiClient } from '../ai/ai-client.js';
+import { BillingClient } from '../billing/billing-client.js';
+import { AdminClient } from '../admin/admin-client.js';
+import { RealtimeClient } from '../realtime/realtime-client.js';
 export declare class ButterbaseClient {
     readonly appId: string;
     private apiUrl;
@@ -14,7 +18,16 @@ export declare class ButterbaseClient {
     readonly auth: AuthClient;
     readonly storage: StorageClient;
     readonly functions: FunctionsClient;
+    readonly ai: AiClient;
+    readonly billing: BillingClient;
+    readonly admin: AdminClient;
+    readonly realtime: RealtimeClient;
     constructor(options: ButterbaseClientOptions);
+    /**
+     * If the current URL contains OAuth callback tokens, handle them automatically.
+     * This fires-and-forgets — consumers who need the result should use auth.handleOAuthCallback() instead.
+     */
+    private detectOAuthTokensFromUrl;
     /**
      * Create a query builder for a table
      */
@@ -44,6 +57,11 @@ export declare class ButterbaseClient {
      * Internal request method for blob responses (e.g., file exports)
      */
     requestBlob(method: string, path: string, body?: any, customHeaders?: Record<string, string>): Promise<Blob>;
+    /**
+     * Internal request method that returns the raw Response (for streaming).
+     * Handles auth headers but does not parse the body.
+     */
+    requestRaw(method: string, path: string, body?: any, customHeaders?: Record<string, string>): Promise<Response>;
 }
 /**
  * Create a new Butterbase client instance

package/dist/lib/butterbase-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"butterbase-client.d.ts","sourceRoot":"","sources":["../../src/lib/butterbase-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,qBAAa,gBAAgB;IAC3B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,OAAO,CAA0B;IAEzC,SAAgB,cAAc,EAAE,cAAc,CAAC;IAC/C,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,SAAgB,OAAO,EAAE,aAAa,CAAC;IACvC,SAAgB,SAAS,EAAE,eAAe,CAAC;gBAE/B,OAAO,EAAE,uBAAuB;IAwB5C;;OAEG;IACH,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;IAI7C;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAIxC;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,YAAY;IAI7D;;;OAGG;YACW,gBAAgB;IAY9B;;OAEG;IACG,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,GAAG,EACV,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,OAAO,CAAC,CAAC,CAAC;IA8Db;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,GAAG,EACV,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC;CA4CjB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAE/E"}
+{"version":3,"file":"butterbase-client.d.ts","sourceRoot":"","sources":["../../src/lib/butterbase-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,qBAAa,gBAAgB;IAC3B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,OAAO,CAA0B;IAEzC,SAAgB,cAAc,EAAE,cAAc,CAAC;IAC/C,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,SAAgB,OAAO,EAAE,aAAa,CAAC;IACvC,SAAgB,SAAS,EAAE,eAAe,CAAC;IAC3C,SAAgB,EAAE,EAAE,QAAQ,CAAC;IAC7B,SAAgB,OAAO,EAAE,aAAa,CAAC;IACvC,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,QAAQ,EAAE,cAAc,CAAC;gBAE7B,OAAO,EAAE,uBAAuB;IAiC5C;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAYhC;;OAEG;IACH,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;IAI7C;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAIxC;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,YAAY;IAI7D;;;OAGG;YACW,gBAAgB;IAY9B;;OAEG;IACG,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,GAAG,EACV,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,OAAO,CAAC,CAAC,CAAC;IA6Db;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,GAAG,EACV,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC;IA4ChB;;;OAGG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,GAAG,EACV,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,OAAO,CAAC,QAAQ,CAAC;CA4CrB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAE/E"}

package/dist/lib/butterbase-client.js

@@ -4,6 +4,11 @@ import { FunctionsClient } from '../functions/functions-client.js';
 import { SessionManager } from '../auth/session-manager.js';
 import { detectSessionStorage, MemorySessionStorage } from '../auth/session-storage.js';
 import { QueryBuilder } from './query-builder.js';
+import { parseApiError } from '../errors/index.js';
+import { AiClient } from '../ai/ai-client.js';
+import { BillingClient } from '../billing/billing-client.js';
+import { AdminClient } from '../admin/admin-client.js';
+import { RealtimeClient } from '../realtime/realtime-client.js';
 export class ButterbaseClient {
     appId;
     apiUrl;
@@ -14,6 +19,10 @@ export class ButterbaseClient {
     auth;
     storage;
     functions;
+    ai;
+    billing;
+    admin;
+    realtime;
     constructor(options) {
         this.appId = options.appId;
         this.apiUrl = options.apiUrl;
@@ -28,11 +37,34 @@ export class ButterbaseClient {
         this.auth = new AuthClient(this);
         this.storage = new StorageClient(this);
         this.functions = new FunctionsClient(this);
+        this.ai = new AiClient(this);
+        this.billing = new BillingClient(this);
+        this.admin = new AdminClient(this);
+        this.realtime = new RealtimeClient(this);
         // Restore session from storage
         const restored = this.sessionManager.restoreSession();
         if (restored) {
             this.accessToken = restored.accessToken;
         }
+        // Auto-detect OAuth tokens in the URL (browser only, opt-out with detectSessionFromUrl: false)
+        if (options.detectSessionFromUrl !== false) {
+            this.detectOAuthTokensFromUrl();
+        }
+    }
+    /**
+     * If the current URL contains OAuth callback tokens, handle them automatically.
+     * This fires-and-forgets — consumers who need the result should use auth.handleOAuthCallback() instead.
+     */
+    detectOAuthTokensFromUrl() {
+        if (typeof globalThis.window === 'undefined' || !globalThis.window.location)
+            return;
+        const params = new URLSearchParams(window.location.search);
+        if (params.has('access_token') && params.has('refresh_token')) {
+            // Kick off the callback handler; errors are surfaced via onAuthStateChange
+            this.auth.handleOAuthCallback().catch(() => {
+                // Swallow — apps that care should call handleOAuthCallback() explicitly
+            });
+        }
     }
     /**
      * Create a query builder for a table
@@ -109,15 +141,14 @@ export class ButterbaseClient {
             if (response.status === 401 && this.options.onUnauthorized) {
                 this.options.onUnauthorized();
             }
-            let errorMessage = response.statusText;
+            let errorBody = {};
             try {
-                const errorData = await response.json();
-                errorMessage = errorData.error || errorData.message || errorMessage;
+                errorBody = await response.json();
             }
             catch {
-                // If JSON parsing fails, use statusText
+                errorBody = { error: response.statusText };
             }
-            throw new Error(errorMessage);
+            throw parseApiError(response.status, errorBody);
         }
         // Handle 204 No Content
         if (response.status === 204) {
@@ -160,18 +191,59 @@ export class ButterbaseClient {
             if (response.status === 401 && this.options.onUnauthorized) {
                 this.options.onUnauthorized();
             }
-            let errorMessage = response.statusText;
+            let errorBody = {};
             try {
-                const errorData = await response.json();
-                errorMessage = errorData.error || errorData.message || errorMessage;
+                errorBody = await response.json();
             }
             catch {
-                // If JSON parsing fails, use statusText
+                errorBody = { error: response.statusText };
             }
-            throw new Error(errorMessage);
+            throw parseApiError(response.status, errorBody);
         }
         return response.blob();
     }
+    /**
+     * Internal request method that returns the raw Response (for streaming).
+     * Handles auth headers but does not parse the body.
+     */
+    async requestRaw(method, path, body, customHeaders) {
+        if (!path.endsWith('/refresh')) {
+            await this.ensureValidToken();
+        }
+        const headers = {
+            ...customHeaders,
+        };
+        const serializedBody = body !== undefined && body !== null ? JSON.stringify(body) : undefined;
+        if (serializedBody !== undefined) {
+            headers['Content-Type'] = 'application/json';
+        }
+        if (this.accessToken) {
+            headers['Authorization'] = `Bearer ${this.accessToken}`;
+        }
+        else if (this.anonKey) {
+            headers['Authorization'] = `Bearer ${this.anonKey}`;
+        }
+        const url = `${this.apiUrl}${path}`;
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: serializedBody,
+        });
+        if (!response.ok) {
+            if (response.status === 401 && this.options.onUnauthorized) {
+                this.options.onUnauthorized();
+            }
+            let errorBody = {};
+            try {
+                errorBody = await response.json();
+            }
+            catch {
+                errorBody = { error: response.statusText };
+            }
+            throw parseApiError(response.status, errorBody);
+        }
+        return response;
+    }
 }
 /**
  * Create a new Butterbase client instance