@butterbase/sdk 1.0.0

package/README.md

@@ -0,0 +1,187 @@
+# @butterbase/sdk
+
+Universal TypeScript SDK for Butterbase - works in browser, Node.js, and Deno environments.
+
+## Installation
+
+```bash
+npm install @butterbase/sdk
+```
+
+## Quick Start
+
+```typescript
+import { createClient } from '@butterbase/sdk';
+
+// Initialize client
+const butterbase = createClient({
+  appId: 'app_abc123',
+  apiUrl: 'https://api.butterbase.com',
+  anonKey: 'your-anon-key' // Optional, for public access
+});
+
+// Query data
+const { data, error } = await butterbase
+  .from('posts')
+  .select('*')
+  .eq('status', 'published')
+  .order('created_at', { ascending: false })
+  .limit(10);
+
+// Insert data
+const { data, error } = await butterbase
+  .from('posts')
+  .insert({ title: 'Hello World', content: 'My first post' });
+
+// Update data
+const { data, error } = await butterbase
+  .from('posts')
+  .update({ status: 'archived' })
+  .eq('id', '123');
+
+// Delete data
+const { data, error } = await butterbase
+  .from('posts')
+  .delete()
+  .eq('id', '123');
+```
+
+## Migration from 0.x to 1.0
+
+**Breaking Change:** The `authUrl` parameter has been removed. All auth endpoints now run on the same URL as the API.
+
+**Before (0.x):**
+```typescript
+const butterbase = createClient({
+  appId: 'app_abc123',
+  apiUrl: 'https://api.butterbase.com',
+  authUrl: 'https://auth.butterbase.com', // ❌ No longer needed
+});
+```
+
+**After (1.0):**
+```typescript
+const butterbase = createClient({
+  appId: 'app_abc123',
+  apiUrl: 'https://api.butterbase.com', // ✅ All endpoints use this URL
+});
+```
+
+## Authentication
+
+```typescript
+// Sign up
+const { data, error } = await butterbase.auth.signUp({
+  email: 'user@example.com',
+  password: 'secure123'
+});
+
+// Sign in
+const { data, error } = await butterbase.auth.signIn({
+  email: 'user@example.com',
+  password: 'secure123'
+});
+
+// Get current user
+const { data: user } = await butterbase.auth.getUser();
+
+// Sign out
+await butterbase.auth.signOut();
+
+// OAuth
+const { url } = butterbase.auth.signInWithOAuth({
+  provider: 'google',
+  redirectTo: 'http://localhost:3000/callback'
+});
+window.location.href = url;
+```
+
+## Storage
+
+```typescript
+// Upload file
+const { data, error } = await butterbase.storage.upload(file);
+
+// Get download URL
+const { data } = await butterbase.storage.getDownloadUrl(objectId);
+
+// List files
+const { data: objects } = await butterbase.storage.list();
+
+// Delete file
+await butterbase.storage.delete(objectId);
+```
+
+## Functions
+
+```typescript
+// Invoke serverless function
+const { data, error } = await butterbase.functions.invoke('my-function', {
+  body: { key: 'value' },
+  method: 'POST'
+});
+```
+
+## Query Builder
+
+### Operators
+
+- `eq(column, value)` - Equal to
+- `neq(column, value)` - Not equal to
+- `gt(column, value)` - Greater than
+- `gte(column, value)` - Greater than or equal to
+- `lt(column, value)` - Less than
+- `lte(column, value)` - Less than or equal to
+- `like(column, pattern)` - Pattern matching (case-sensitive)
+- `ilike(column, pattern)` - Pattern matching (case-insensitive)
+- `in(column, values)` - Value in array
+- `is(column, value)` - Is null/true/false
+
+### Modifiers
+
+- `select(columns)` - Select specific columns
+- `order(column, options)` - Order results
+- `limit(count)` - Limit results
+- `offset(count)` - Skip results
+
+## Usage in Deno
+
+```typescript
+import { createClient } from 'npm:@butterbase/sdk';
+
+const butterbase = createClient({
+  appId: Deno.env.get('BUTTERBASE_APP_ID')!,
+  apiUrl: Deno.env.get('BUTTERBASE_API_URL')!,
+});
+
+// Use in serverless functions
+export async function handler(req: Request, ctx: any) {
+  const { data } = await butterbase.from('posts').select('*');
+  return Response.json({ data });
+}
+```
+
+## TypeScript Support
+
+The SDK is fully typed with TypeScript. All methods return `ButterbaseResponse<T>` with proper type inference:
+
+```typescript
+interface Post {
+  id: string;
+  title: string;
+  content: string;
+  status: 'draft' | 'published';
+}
+
+const { data, error } = await butterbase
+  .from<Post>('posts')
+  .select('*')
+  .eq('status', 'published');
+
+// data is typed as Post[] | null
+// error is typed as Error | null
+```
+
+## License
+
+MIT

package/dist/auth/auth-client.d.ts

@@ -0,0 +1,47 @@
+import type { ButterbaseClient } from '../lib/butterbase-client.js';
+import type { ButterbaseResponse, SignUpParams, SignInParams, LoginResponse, SignupResponse, User, OAuthParams } from '../types/index.js';
+export declare class AuthClient {
+    private client;
+    constructor(client: ButterbaseClient);
+    /**
+     * Sign up a new user with email and password
+     * Note: API returns user and message, but no tokens (email verification required)
+     */
+    signUp(params: SignUpParams): Promise<ButterbaseResponse<SignupResponse>>;
+    /**
+     * Sign in an existing user with email and password
+     */
+    signIn(params: SignInParams): Promise<ButterbaseResponse<LoginResponse>>;
+    /**
+     * Sign out the current user
+     */
+    signOut(): Promise<ButterbaseResponse<void>>;
+    /**
+     * Get the current authenticated user
+     */
+    getUser(): Promise<ButterbaseResponse<User>>;
+    /**
+     * Initiate OAuth sign-in flow
+     * Returns the URL to redirect the user to
+     */
+    signInWithOAuth(params: OAuthParams): {
+        url: string;
+    };
+    /**
+     * Refresh the access token using a refresh token
+     */
+    refreshSession(refreshToken: string): Promise<ButterbaseResponse<LoginResponse>>;
+    /**
+     * Request a password reset email
+     */
+    forgotPassword(email: string): Promise<ButterbaseResponse<void>>;
+    /**
+     * Reset password with token from email
+     */
+    resetPassword(token: string, newPassword: string): Promise<ButterbaseResponse<void>>;
+    /**
+     * Verify email with verification code
+     */
+    verifyEmail(code: string): Promise<ButterbaseResponse<void>>;
+}
+//# sourceMappingURL=auth-client.d.ts.map

package/dist/auth/auth-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-client.d.ts","sourceRoot":"","sources":["../../src/auth/auth-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,YAAY,EAEZ,aAAa,EACb,cAAc,EACd,IAAI,EACJ,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,UAAU;IACT,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,gBAAgB;IAE5C;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAe/E;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAiB9E;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAiBlD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAalD;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAMrD;;OAEG;IACG,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAiBtF;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IActE;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAc1F;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;CAanE"}

package/dist/auth/auth-client.js

@@ -0,0 +1,120 @@
+export class AuthClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Sign up a new user with email and password
+     * Note: API returns user and message, but no tokens (email verification required)
+     */
+    async signUp(params) {
+        try {
+            const response = await this.client.request('POST', `/auth/${this.client.appId}/signup`, params);
+            // No token returned from signup - user must verify email first
+            return { data: response, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    /**
+     * Sign in an existing user with email and password
+     */
+    async signIn(params) {
+        try {
+            const response = await this.client.request('POST', `/auth/${this.client.appId}/login`, params);
+            // Store access token from flat response
+            this.client.setAccessToken(response.access_token);
+            return { data: response, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    /**
+     * Sign out the current user
+     */
+    async signOut() {
+        try {
+            await this.client.request('POST', `/auth/${this.client.appId}/logout`, {});
+            // Clear access token
+            this.client.setAccessToken(undefined);
+            return { data: null, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    /**
+     * Get the current authenticated user
+     */
+    async getUser() {
+        try {
+            const user = await this.client.request('GET', `/auth/${this.client.appId}/me`);
+            return { data: user, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    /**
+     * Initiate OAuth sign-in flow
+     * Returns the URL to redirect the user to
+     */
+    signInWithOAuth(params) {
+        const apiUrl = this.client['apiUrl']; // Access private property
+        const url = `${apiUrl}/auth/${this.client.appId}/oauth/${params.provider}?redirect_to=${encodeURIComponent(params.redirectTo)}`;
+        return { url };
+    }
+    /**
+     * Refresh the access token using a refresh token
+     */
+    async refreshSession(refreshToken) {
+        try {
+            const response = await this.client.request('POST', `/auth/${this.client.appId}/refresh`, { refresh_token: refreshToken });
+            // Store new access token from flat response
+            this.client.setAccessToken(response.access_token);
+            return { data: response, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    /**
+     * Request a password reset email
+     */
+    async forgotPassword(email) {
+        try {
+            await this.client.request('POST', `/auth/${this.client.appId}/forgot-password`, { email });
+            return { data: null, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    /**
+     * Reset password with token from email
+     */
+    async resetPassword(token, newPassword) {
+        try {
+            await this.client.request('POST', `/auth/${this.client.appId}/reset-password`, { token, newPassword });
+            return { data: null, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    /**
+     * Verify email with verification code
+     */
+    async verifyEmail(code) {
+        try {
+            await this.client.request('POST', `/auth/${this.client.appId}/verify-email`, { code });
+            return { data: null, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+}
+//# sourceMappingURL=auth-client.js.map

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

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

package/dist/functions/functions-client.d.ts

@@ -0,0 +1,16 @@
+import type { ButterbaseClient } from '../lib/butterbase-client.js';
+import type { ButterbaseResponse, InvokeFunctionOptions } from '../types/index.js';
+export declare class FunctionsClient {
+    private client;
+    constructor(client: ButterbaseClient);
+    /**
+     * Invoke a serverless function
+     */
+    invoke<T = any>(functionName: string, options?: InvokeFunctionOptions): Promise<ButterbaseResponse<T>>;
+    /**
+     * Invoke a serverless function that returns binary data (blob)
+     * Use this for functions that return files, images, or other binary content
+     */
+    invokeBlob(functionName: string, options?: InvokeFunctionOptions): Promise<ButterbaseResponse<Blob>>;
+}
+//# sourceMappingURL=functions-client.d.ts.map

package/dist/functions/functions-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions-client.d.ts","sourceRoot":"","sources":["../../src/functions/functions-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAEnF,qBAAa,eAAe;IACd,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,gBAAgB;IAE5C;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,GAAG,EAClB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAkBjC;;;OAGG;IACG,UAAU,CACd,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;CAiBrC"}

package/dist/functions/functions-client.js

@@ -0,0 +1,36 @@
+export class FunctionsClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Invoke a serverless function
+     */
+    async invoke(functionName, options) {
+        try {
+            const method = options?.method || 'POST';
+            const path = `/v1/${this.client.appId}/fn/${functionName}`;
+            const data = await this.client.request(method, path, options?.body, options?.headers);
+            return { data, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    /**
+     * Invoke a serverless function that returns binary data (blob)
+     * Use this for functions that return files, images, or other binary content
+     */
+    async invokeBlob(functionName, options) {
+        try {
+            const method = options?.method || 'POST';
+            const path = `/v1/${this.client.appId}/fn/${functionName}`;
+            const blob = await this.client.requestBlob(method, path, options?.body, options?.headers);
+            return { data: blob, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+}
+//# sourceMappingURL=functions-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"functions-client.js","sourceRoot":"","sources":["../../src/functions/functions-client.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,eAAe;IACN;IAApB,YAAoB,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;IAAG,CAAC;IAEhD;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,YAAoB,EACpB,OAA+B;QAE/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC;YACzC,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,OAAO,YAAY,EAAE,CAAC;YAE3D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACpC,MAAM,EACN,IAAI,EACJ,OAAO,EAAE,IAAI,EACb,OAAO,EAAE,OAAO,CACjB,CAAC;YAEF,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;;;OAGG;IACH,KAAK,CAAC,UAAU,CACd,YAAoB,EACpB,OAA+B;QAE/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC;YACzC,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,OAAO,YAAY,EAAE,CAAC;YAE3D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CACxC,MAAM,EACN,IAAI,EACJ,OAAO,EAAE,IAAI,EACb,OAAO,EAAE,OAAO,CACjB,CAAC;YAEF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACrC,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/index.d.ts

@@ -0,0 +1,8 @@
+export { ButterbaseClient, createClient } from './lib/butterbase-client.js';
+export { QueryBuilder } from './lib/query-builder.js';
+export { InsertBuilder, UpdateBuilder, DeleteBuilder } from './lib/mutation-builders.js';
+export { AuthClient } from './auth/auth-client.js';
+export { StorageClient } from './storage/storage-client.js';
+export { FunctionsClient } from './functions/functions-client.js';
+export type { ButterbaseClientOptions, ButterbaseResponse, User, Session, SignUpParams, SignInParams, AuthResponse, LoginResponse, SignupResponse, OAuthParams, StorageObject, UploadResponse, DownloadUrlResponse, QueryOperator, QueryFilter, OrderByOptions, InvokeFunctionOptions, } from './types/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,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,GACtB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// Main client
+export { ButterbaseClient, createClient } from './lib/butterbase-client.js';
+// Query builder
+export { QueryBuilder } from './lib/query-builder.js';
+// Mutation builders
+export { InsertBuilder, UpdateBuilder, DeleteBuilder } from './lib/mutation-builders.js';
+// Client modules
+export { AuthClient } from './auth/auth-client.js';
+export { StorageClient } from './storage/storage-client.js';
+export { FunctionsClient } from './functions/functions-client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

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

@@ -0,0 +1,41 @@
+import type { ButterbaseClientOptions } from '../types/index.js';
+import { AuthClient } from '../auth/auth-client.js';
+import { StorageClient } from '../storage/storage-client.js';
+import { FunctionsClient } from '../functions/functions-client.js';
+import { QueryBuilder } from './query-builder.js';
+export declare class ButterbaseClient {
+    readonly appId: string;
+    private apiUrl;
+    private anonKey?;
+    private accessToken?;
+    private options;
+    readonly auth: AuthClient;
+    readonly storage: StorageClient;
+    readonly functions: FunctionsClient;
+    constructor(options: ButterbaseClientOptions);
+    /**
+     * Create a query builder for a table
+     */
+    from<T = any>(table: string): QueryBuilder<T>;
+    /**
+     * Set the access token for authenticated requests
+     */
+    setAccessToken(token: string | undefined): void;
+    /**
+     * Get the current access token
+     */
+    getAccessToken(): string | undefined;
+    /**
+     * Internal request method used by all clients
+     */
+    request<T>(method: string, path: string, body?: any, customHeaders?: Record<string, string>): Promise<T>;
+    /**
+     * Internal request method for blob responses (e.g., file exports)
+     */
+    requestBlob(method: string, path: string, body?: any, customHeaders?: Record<string, string>): Promise<Blob>;
+}
+/**
+ * Create a new Butterbase client instance
+ */
+export declare function createClient(options: ButterbaseClientOptions): ButterbaseClient;
+//# sourceMappingURL=butterbase-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"butterbase-client.d.ts","sourceRoot":"","sources":["../../src/lib/butterbase-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACjE,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,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,IAAI,EAAE,UAAU,CAAC;IACjC,SAAgB,OAAO,EAAE,aAAa,CAAC;IACvC,SAAgB,SAAS,EAAE,eAAe,CAAC;gBAE/B,OAAO,EAAE,uBAAuB;IAW5C;;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;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;IAyDb;;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;CAuCjB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAE/E"}

package/dist/lib/butterbase-client.js

@@ -0,0 +1,138 @@
+import { AuthClient } from '../auth/auth-client.js';
+import { StorageClient } from '../storage/storage-client.js';
+import { FunctionsClient } from '../functions/functions-client.js';
+import { QueryBuilder } from './query-builder.js';
+export class ButterbaseClient {
+    appId;
+    apiUrl;
+    anonKey;
+    accessToken;
+    options;
+    auth;
+    storage;
+    functions;
+    constructor(options) {
+        this.appId = options.appId;
+        this.apiUrl = options.apiUrl;
+        this.anonKey = options.anonKey;
+        this.options = options;
+        this.auth = new AuthClient(this);
+        this.storage = new StorageClient(this);
+        this.functions = new FunctionsClient(this);
+    }
+    /**
+     * Create a query builder for a table
+     */
+    from(table) {
+        return new QueryBuilder(table, this);
+    }
+    /**
+     * Set the access token for authenticated requests
+     */
+    setAccessToken(token) {
+        this.accessToken = token;
+    }
+    /**
+     * Get the current access token
+     */
+    getAccessToken() {
+        return this.accessToken;
+    }
+    /**
+     * Internal request method used by all clients
+     */
+    async request(method, path, body, customHeaders) {
+        const headers = {
+            ...customHeaders,
+        };
+        // Only set Content-Type when sending a body to avoid Fastify's FST_ERR_CTP_EMPTY_JSON_BODY
+        const serializedBody = body !== undefined && body !== null ? JSON.stringify(body) : undefined;
+        if (serializedBody !== undefined) {
+            headers['Content-Type'] = 'application/json';
+        }
+        // Auth priority: access token > anon key
+        if (this.accessToken) {
+            headers['Authorization'] = `Bearer ${this.accessToken}`;
+        }
+        else if (this.anonKey) {
+            headers['Authorization'] = `Bearer ${this.anonKey}`;
+        }
+        // All endpoints use apiUrl
+        const url = `${this.apiUrl}${path}`;
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: serializedBody,
+        });
+        if (!response.ok) {
+            // Call onUnauthorized callback for 401 responses
+            if (response.status === 401 && this.options.onUnauthorized) {
+                this.options.onUnauthorized();
+            }
+            let errorMessage = response.statusText;
+            try {
+                const errorData = await response.json();
+                errorMessage = errorData.error || errorData.message || errorMessage;
+            }
+            catch {
+                // If JSON parsing fails, use statusText
+            }
+            throw new Error(errorMessage);
+        }
+        // Handle 204 No Content
+        if (response.status === 204) {
+            return undefined;
+        }
+        // Parse JSON response
+        const text = await response.text();
+        if (!text) {
+            return undefined;
+        }
+        return JSON.parse(text);
+    }
+    /**
+     * Internal request method for blob responses (e.g., file exports)
+     */
+    async requestBlob(method, path, body, customHeaders) {
+        const headers = {
+            ...customHeaders,
+        };
+        // Auth priority: access token > anon key
+        if (this.accessToken) {
+            headers['Authorization'] = `Bearer ${this.accessToken}`;
+        }
+        else if (this.anonKey) {
+            headers['Authorization'] = `Bearer ${this.anonKey}`;
+        }
+        // All endpoints use apiUrl
+        const url = `${this.apiUrl}${path}`;
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            // Call onUnauthorized callback for 401 responses
+            if (response.status === 401 && this.options.onUnauthorized) {
+                this.options.onUnauthorized();
+            }
+            let errorMessage = response.statusText;
+            try {
+                const errorData = await response.json();
+                errorMessage = errorData.error || errorData.message || errorMessage;
+            }
+            catch {
+                // If JSON parsing fails, use statusText
+            }
+            throw new Error(errorMessage);
+        }
+        return response.blob();
+    }
+}
+/**
+ * Create a new Butterbase client instance
+ */
+export function createClient(options) {
+    return new ButterbaseClient(options);
+}
+//# sourceMappingURL=butterbase-client.js.map

package/dist/lib/butterbase-client.js.map

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