npm - @giaeulate/baas-sdk - Versions diffs - 1.0.0 - Mend

@giaeulate/baas-sdk 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (33) hide show

package/js/demo/index.html +133 -0
package/js/src/index.ts +278 -0
package/package.json +34 -0
package/realtime.test.ts +184 -0
package/scripts/dev.sh +30 -0
package/src/client.ts +263 -0
package/src/http-client.ts +144 -0
package/src/index.ts +43 -0
package/src/modules/api-keys.ts +36 -0
package/src/modules/audit.ts +46 -0
package/src/modules/auth.ts +158 -0
package/src/modules/backups.ts +68 -0
package/src/modules/branches.ts +46 -0
package/src/modules/database.ts +158 -0
package/src/modules/email.ts +93 -0
package/src/modules/env-vars.ts +42 -0
package/src/modules/functions.ts +57 -0
package/src/modules/graphql.ts +24 -0
package/src/modules/jobs.ts +78 -0
package/src/modules/log-drains.ts +76 -0
package/src/modules/metrics.ts +72 -0
package/src/modules/migrations.ts +51 -0
package/src/modules/projects.ts +25 -0
package/src/modules/realtime.ts +30 -0
package/src/modules/search.ts +37 -0
package/src/modules/storage.ts +27 -0
package/src/modules/users.ts +31 -0
package/src/modules/webhooks.ts +58 -0
package/src/query-builder.ts +157 -0
package/src/realtime.ts +157 -0
package/src/types.ts +49 -0
package/tsconfig.json +18 -0
package/vitest.config.ts +14 -0

package/js/demo/index.html ADDED Viewed

@@ -0,0 +1,133 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>BaaS SDK Demo</title>
+    <style>
+        body { font-family: 'Inter', sans-serif; background: #0f172a; color: white; padding: 2rem; }
+        pre { background: #1e293b; padding: 1rem; border-radius: 8px; overflow-x: auto; border: 1px solid #334155; }
+        .card { background: #1e293b; padding: 1.5rem; border-radius: 12px; margin-bottom: 1rem; border: 1px solid #334155; }
+        button { background: #6366f1; color: white; border: none; padding: 0.5rem 1rem; border-radius: 6px; cursor: pointer; }
+        input { background: #0f172a; border: 1px solid #334155; color: white; padding: 0.5rem; border-radius: 6px; margin-bottom: 0.5rem; width: 100%; box-sizing: border-box; }
+        .grid { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; }
+        .status { font-size: 0.8rem; color: #94a3b8; margin-top: 0.5rem; }
+    </style>
+</head>
+<body>
+    <h1>BaaS SDK Demo</h1>
+    <div class="grid">
+        <div class="card">
+            <h2>Authentication</h2>
+            <input type="text" id="email" placeholder="Email" value="test@example.com">
+            <input type="password" id="password" placeholder="Password" value="password123">
+            <button onclick="login()">Login</button>
+            <button onclick="register()">Register</button>
+            <div id="auth-status" class="status">Not authenticated</div>
+        </div>
+        <div class="card">
+            <h2>Query Data</h2>
+            <input type="text" id="table" placeholder="Table Name" value="products">
+            <button onclick="fetchData()">Fetch with Select & Filter</button>
+        </div>
+    </div>
+    <div class="card">
+        <h2>Output</h2>
+        <pre id="output">Results will appear here...</pre>
+    </div>
+    <!-- We import the SDK as a module (transpiled to JS or just using the browser-compatible JS version) -->
+    <script type="module">
+        // For the demo, we'll use a direct implementation of the SDK logic in JS
+        // to avoid build steps in this environment.
+        class BaasClient {
+            constructor(url, projectID) {
+                this.url = url.endsWith('/') ? url.slice(0, -1) : url;
+                this.projectID = projectID;
+                this.token = localStorage.getItem('baas_token');
+            }
+            from(table) {
+                return new QueryBuilder(table, this.url, this.projectID, this.token);
+            }
+            async login(email, password) {
+                const res = await fetch(`${this.url}/api/login`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json', 'X-Project-ID': this.projectID },
+                    body: JSON.stringify({ email, password }),
+                });
+                const data = await res.json();
+                if (data.token) {
+                    this.token = data.token;
+                    localStorage.setItem('baas_token', data.token);
+                }
+                return data;
+            }
+            async register(email, password) {
+                const res = await fetch(`${this.url}/api/register`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json', 'X-Project-ID': this.projectID },
+                    body: JSON.stringify({ email, password }),
+                });
+                return await res.json();
+            }
+        }
+        class QueryBuilder {
+            constructor(table, url, projectID, token) {
+                this.table = table; this.url = url; this.projectID = projectID; this.token = token;
+                this.queryParams = new URLSearchParams();
+            }
+            select(columns = '*') { this.queryParams.set('select', columns); return this; }
+            eq(column, value) { this.queryParams.set(column, `eq.${value}`); return this; }
+            order(column, { ascending = true } = {}) { this.queryParams.set('order', `${column}.${ascending ? 'asc' : 'desc'}`); return this; }
+            limit(count) { this.queryParams.set('limit', count.toString()); return this; }
+            async get() {
+                const res = await fetch(`${this.url}/api/v1/data/${this.table}?${this.queryParams.toString()}`, {
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-Project-ID': this.projectID,
+                        'Authorization': this.token ? `Bearer ${this.token}` : undefined
+                    }
+                });
+                return await res.json();
+            }
+        }
+        const client = new BaasClient('http://localhost:8080', 'proj-123');
+        window.client = client;
+        window.login = async () => {
+            const email = document.getElementById('email').value;
+            const password = document.getElementById('password').value;
+            const res = await client.login(email, password);
+            document.getElementById('output').textContent = JSON.stringify(res, null, 2);
+            document.getElementById('auth-status').textContent = res.token ? 'Authenticated ✅' : 'Login failed ❌';
+        };
+        window.register = async () => {
+            const email = document.getElementById('email').value;
+            const password = document.getElementById('password').value;
+            const res = await client.register(email, password);
+            document.getElementById('output').textContent = JSON.stringify(res, null, 2);
+        };
+        window.fetchData = async () => {
+            const table = document.getElementById('table').value;
+            const res = await client.from(table)
+                .select('*')
+                .limit(5)
+                .get();
+            document.getElementById('output').textContent = JSON.stringify(res, null, 2);
+        };
+    </script>
+</body>
+</html>

package/js/src/index.ts ADDED Viewed

@@ -0,0 +1,278 @@
+/**
+ * BaaS Client SDK
+ * A fluent JavaScript/TypeScript client for the Go BaaS.
+ */
+export type QueryFilter = {
+  column: string;
+  operator: string;
+  value: any;
+};
+export class BaasClient {
+  public url: string;
+  public projectID: string = '';
+  public token: string | null = null;
+  public onAuthError?: (error: { status: number; message: string }) => void;
+  constructor(url: string, projectID?: string) {
+    this.url = url.endsWith('/') ? url.slice(0, -1) : url;
+    if (projectID) this.projectID = projectID;
+    // Attempt to load session from localStorage for persistence
+    if (typeof localStorage !== 'undefined') {
+        const storedToken = localStorage.getItem('baas_token');
+        const storedProject = localStorage.getItem('baas_project_id');
+        if (storedToken) this.token = storedToken;
+        if (!this.projectID && storedProject) this.projectID = storedProject;
+    }
+  }
+  /**
+   * Generates headers for API requests
+   */
+  public getHeaders(contentType: string = 'application/json') {
+    const headers: Record<string, string> = {
+      'X-Project-ID': this.projectID || 'default',
+    };
+    if (contentType) {
+      headers['Content-Type'] = contentType;
+    }
+    if (this.token) {
+      headers['Authorization'] = `Bearer ${this.token.trim()}`;
+    }
+    return headers;
+  }
+  /**
+   * Data Operations
+   */
+  from(table: string) {
+    return new QueryBuilder(table, this.url, this);
+  }
+  /**
+   * Authentication
+   */
+  async login(email: string, password: string) {
+    const res = await fetch(`${this.url}/api/login`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', 'X-Project-ID': this.projectID || 'default' },
+      body: JSON.stringify({ email, password }),
+    });
+    const data = await res.json();
+    if (!res.ok) throw new Error(data.error || 'Login failed');
+    if (data.token) {
+      this.token = data.token;
+      if (typeof localStorage !== 'undefined') {
+          localStorage.setItem('baas_token', data.token);
+          localStorage.setItem('baas_project_id', this.projectID);
+      }
+    }
+    return data;
+  }
+  async verifyMFA(mfaToken: string, code: string) {
+    const res = await fetch(`${this.url}/api/mfa/finalize`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', 'X-Project-ID': this.projectID || 'default' },
+      body: JSON.stringify({ mfa_token: mfaToken, code }),
+    });
+    const data = await res.json();
+    if (!res.ok) throw new Error(data.error || 'MFA validation failed');
+    if (data.token) {
+      this.token = data.token;
+      if (typeof localStorage !== 'undefined') {
+          localStorage.setItem('baas_token', data.token);
+      }
+    }
+    return data;
+  }
+  async register(email: string, password: string) {
+    const res = await fetch(`${this.url}/api/register`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', 'X-Project-ID': this.projectID || 'default' },
+      body: JSON.stringify({ email, password }),
+    });
+    const data = await res.json();
+    if (!res.ok) throw new Error(data.error || 'Registration failed');
+    return data;
+  }
+  logout() {
+    this.token = null;
+    if (typeof localStorage !== 'undefined') {
+        localStorage.removeItem('baas_token');
+    }
+  }
+  /**
+   * Edge Functions
+   */
+  async invokeFunction(id: string, data: any = {}) {
+    const res = await fetch(`${this.url}/api/functions/${id}/execute`, {
+      method: 'POST',
+      headers: this.getHeaders(),
+      body: JSON.stringify(data),
+    });
+    const result = await res.json();
+    if (!res.ok && res.status === 401 && this.onAuthError) {
+        this.onAuthError({ status: 401, message: 'Expired session' });
+    }
+    return result;
+  }
+  /**
+   * Storage
+   */
+  async upload(bucketID: string, file: File) {
+    const formData = new FormData();
+    formData.append('file', file);
+    formData.append('bucket_id', bucketID);
+    formData.append('name', file.name);
+    const res = await fetch(`${this.url}/api/storage/upload`, {
+      method: 'POST',
+      headers: this.getHeaders(''), // Let browser set multipart boundary
+      body: formData
+    });
+    const data = await res.json();
+    if (!res.ok && res.status === 401 && this.onAuthError) {
+        this.onAuthError({ status: 401, message: 'Expired session' });
+    }
+    return data;
+  }
+  /**
+   * Realtime
+   */
+  subscribe(table: string, callback: (payload: any) => void) {
+    const protocol = this.url.startsWith('https') ? 'wss' : 'ws';
+    const socket = new WebSocket(`${protocol}://${this.url.replace(/^https?:\/\//, '')}/api/ws?token=${this.token}`);
+    socket.onmessage = (event) => {
+      try {
+          const payload = JSON.parse(event.data);
+          if (payload.table === table || table === '*') {
+            callback(payload);
+          }
+      } catch(e) {}
+    };
+    return {
+      unsubscribe: () => socket.close()
+    };
+  }
+}
+class QueryBuilder {
+  private table: string;
+  private url: string;
+  private client: BaasClient;
+  private queryParams: URLSearchParams = new URLSearchParams();
+  constructor(table: string, url: string, client: BaasClient) {
+    this.table = table;
+    this.url = url;
+    this.client = client;
+  }
+  select(columns: string = '*') {
+    this.queryParams.set('select', columns);
+    return this;
+  }
+  eq(column: string, value: any) {
+    this.queryParams.set(column, `eq.${value}`);
+    return this;
+  }
+  gt(column: string, value: any) {
+    this.queryParams.set(column, `gt.${value}`);
+    return this;
+  }
+  lt(column: string, value: any) {
+    this.queryParams.set(column, `lt.${value}`);
+    return this;
+  }
+  like(column: string, value: any) {
+    this.queryParams.set(column, `like.${value}`);
+    return this;
+  }
+  order(column: string, { ascending = true } = {}) {
+    this.queryParams.set('order', `${column}.${ascending ? 'asc' : 'desc'}`);
+    return this;
+  }
+  limit(count: number) {
+    this.queryParams.set('limit', count.toString());
+    return this;
+  }
+  offset(count: number) {
+    this.queryParams.set('offset', count.toString());
+    return this;
+  }
+  /**
+   * Execution
+   */
+  async get() {
+    const res = await fetch(`${this.url}/api/v1/data/${this.table}?${this.queryParams.toString()}`, {
+      headers: this.client.getHeaders(),
+    });
+    return await this.handleResponse(res);
+  }
+  async insert(data: any) {
+    const res = await fetch(`${this.url}/api/v1/data/${this.table}`, {
+      method: 'POST',
+      headers: this.client.getHeaders(),
+      body: JSON.stringify(data),
+    });
+    return await this.handleResponse(res);
+  }
+  async update(id: string | number, data: any) {
+    const res = await fetch(`${this.url}/api/v1/data/${this.table}/${id}`, {
+      method: 'PATCH',
+      headers: this.client.getHeaders(),
+      body: JSON.stringify(data),
+    });
+    return await this.handleResponse(res);
+  }
+  async delete(id: string | number) {
+    const res = await fetch(`${this.url}/api/v1/data/${this.table}/${id}`, {
+      method: 'DELETE',
+      headers: this.client.getHeaders(),
+    });
+    if (res.status === 204) return { data: { success: true }, error: null };
+    return await this.handleResponse(res);
+  }
+  private async handleResponse(res: Response) {
+    const text = await res.text();
+    let data = null;
+    try {
+        data = text ? JSON.parse(text) : null;
+    } catch(e) {}
+    if (!res.ok) {
+      if (res.status === 401 && this.client.onAuthError) {
+          this.client.onAuthError({ status: 401, message: 'Expired session' });
+      }
+      return { data: null, error: data?.error || 'Request failed', status: res.status };
+    }
+    return { data, error: null, status: res.status };
+  }
+}

package/package.json ADDED Viewed

@@ -0,0 +1,34 @@
+{
+  "name": "@giaeulate/baas-sdk",
+  "version": "1.0.0",
+  "description": "Standalone SDK for BaaS Golang",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --watch --dts",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "axios": "^1.13.2"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.0.17",
+    "jsdom": "^27.4.0",
+    "tsup": "^8.0.0",
+    "typescript": "~5.9.3",
+    "vitest": "^4.0.17"
+  }
+}

package/realtime.test.ts ADDED Viewed

@@ -0,0 +1,184 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { RealtimeService } from './src/realtime';
+// Mock WebSocket
+class MockWebSocket {
+  onopen: (() => void) | null = null;
+  onclose: (() => void) | null = null;
+  onmessage: ((event: { data: string }) => void) | null = null;
+  onerror: ((error: any) => void) | null = null;
+  readyState = 1; // OPEN immediately for simplicity
+  url: string;
+  constructor(url: string) {
+    this.url = url;
+    // Trigger onopen in next tick
+    Promise.resolve().then(() => {
+      if (this.onopen) this.onopen();
+    });
+  }
+  close() {
+    this.readyState = 3; // CLOSED
+    if (this.onclose) this.onclose();
+  }
+  send(data: string) {}
+}
+describe('RealtimeService', () => {
+  let service: RealtimeService;
+  const baseUrl = 'http://localhost:8080';
+  const projectId = 'test-project';
+  const token = 'test-token';
+  beforeEach(() => {
+    service = new RealtimeService(baseUrl, projectId, () => token, MockWebSocket);
+  });
+  afterEach(() => {
+    service.disconnect();
+    vi.restoreAllMocks();
+  });
+  it('should connect to the correct WebSocket URL', async () => {
+    const subPromise = service.subscribe('users', '*', () => {});
+    const sub = await subPromise;
+    const socket = service._socket;
+    expect(socket).not.toBeNull();
+    expect(socket?.url).toContain('ws://localhost:8080/ws');
+    expect(socket?.url).toContain(`project_id=${projectId}`);
+    expect(socket?.url).toContain(`token=${token}`);
+    sub.unsubscribe();
+  });
+  it('should dispatch events to subscribers', async () => {
+    const callback = vi.fn();
+    const sub = await service.subscribe('users', '*', callback);
+    const payload = {
+      table: 'users',
+      action: 'insert',
+      record: { id: 1, name: 'John' },
+      timestamp: new Date().toISOString()
+    };
+    const socket = service._socket;
+    if (socket) {
+      // @ts-ignore
+      socket.onmessage({ data: JSON.stringify(payload) });
+    }
+    expect(callback).toHaveBeenCalledWith(expect.objectContaining({
+      table: 'users',
+      record: { id: 1, name: 'John' }
+    }));
+    sub.unsubscribe();
+  });
+  it('should filter events by action', async () => {
+    const insertCallback = vi.fn();
+    const updateCallback = vi.fn();
+    const [s1, s2] = await Promise.all([
+      service.subscribe('users', 'INSERT', insertCallback),
+      service.subscribe('users', 'UPDATE', updateCallback)
+    ]);
+    const payload = {
+      table: 'users',
+      action: 'update',
+      record: { id: 1, name: 'John Updated' },
+      timestamp: new Date().toISOString()
+    };
+    const socket = service._socket;
+    if (socket) {
+      // @ts-ignore
+      socket.onmessage({ data: JSON.stringify(payload) });
+    }
+    expect(insertCallback).not.toHaveBeenCalled();
+    expect(updateCallback).toHaveBeenCalled();
+    s1.unsubscribe();
+    s2.unsubscribe();
+  });
+  it('should handle wildcard actions', async () => {
+    const callback = vi.fn();
+    const sub = await service.subscribe('users', '*', callback);
+    const payload = {
+      table: 'users',
+      action: 'delete',
+      record: { id: 1 },
+      timestamp: new Date().toISOString()
+    };
+    const socket = service._socket;
+    if (socket) {
+      // @ts-ignore
+      socket.onmessage({ data: JSON.stringify(payload) });
+    }
+    expect(callback).toHaveBeenCalled();
+    sub.unsubscribe();
+  });
+  it('should unsubscribe correctly', async () => {
+    const callback = vi.fn();
+    const sub = await service.subscribe('users', '*', callback);
+    sub.unsubscribe();
+    const payload = {
+      table: 'users',
+      action: 'insert',
+      record: { id: 1 },
+      timestamp: new Date().toISOString()
+    };
+    const socket = service._socket;
+    if (socket) {
+      // @ts-ignore
+      socket.onmessage({ data: JSON.stringify(payload) });
+    }
+    expect(callback).not.toHaveBeenCalled();
+  });
+  it('should handle wildcard table subscriptions', async () => {
+    const callback = vi.fn();
+    await service.subscribe('*', '*', callback);
+    const payloadA = {
+      table: 'table_a',
+      action: 'insert',
+      record: { id: 1 },
+      timestamp: new Date().toISOString()
+    };
+    const payloadB = {
+      table: 'table_b',
+      action: 'update',
+      record: { id: 2 },
+      timestamp: new Date().toISOString()
+    };
+    const socket = service._socket;
+    if (socket) {
+      // @ts-ignore
+      socket.onmessage({ data: JSON.stringify(payloadA) });
+      // @ts-ignore
+      socket.onmessage({ data: JSON.stringify(payloadB) });
+    }
+    expect(callback).toHaveBeenCalledWith(expect.objectContaining({ table: 'table_a' }));
+    expect(callback).toHaveBeenCalledWith(expect.objectContaining({ table: 'table_b' }));
+    expect(callback).toHaveBeenCalledTimes(2);
+  });
+});

package/scripts/dev.sh ADDED Viewed

@@ -0,0 +1,30 @@
+#!/bin/bash
+set -e
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+echo -e "${BLUE}========================================${NC}"
+echo -e "${BLUE}   BaaS SDK - Development Mode         ${NC}"
+echo -e "${BLUE}========================================${NC}"
+# Change to SDK directory
+cd "$(dirname "$0")/.."
+# Check if node_modules exists
+if [ ! -d "node_modules" ]; then
+    echo -e "${YELLOW}Installing dependencies...${NC}"
+    npm install
+fi
+echo ""
+echo -e "${GREEN}Starting SDK in watch mode...${NC}"
+echo -e "${YELLOW}Changes will be automatically rebuilt${NC}"
+echo -e "${YELLOW}Press Ctrl+C to stop${NC}"
+echo ""
+npm run dev