@snackbase/sdk 0.1.0 → 0.2.0

package/dist/index.mjs

@@ -319,9 +319,9 @@ var Logger = class {
 	constructor(level = LogLevel.NONE) {
 		this.level = level;
 		this.handlers.push((entry) => {
-			const { level: level$1, message, data } = entry;
+			const { level, message, data } = entry;
 			const args = data ? [message, data] : [message];
-			switch (level$1) {
+			switch (level) {
 				case LogLevel.ERROR:
 					console.error("[SnackBase]", ...args);
 					break;
@@ -568,21 +568,29 @@ var AuthService = class {
 		const data = { ...credentials };
 		if (!data.account && this.defaultAccount) data.account = this.defaultAccount;
 		const authData = (await this.http.post("/api/v1/auth/login", data)).data;
+		console.log("Login Response:", JSON.stringify(authData, null, 2));
+		const refreshToken = authData.refresh_token || authData.refreshToken;
+		let expiresAt = authData.expiresAt;
+		if (authData.expires_in && !expiresAt) expiresAt = new Date(Date.now() + authData.expires_in * 1e3).toISOString();
 		await this.auth.setState({
-			user: authData.user,
-			account: authData.account,
-			token: authData.token,
-			refreshToken: authData.refreshToken,
-			expiresAt: authData.expiresAt
+			user: authData.user || null,
+			account: authData.account || null,
+			token: authData.token || null,
+			refreshToken: refreshToken || null,
+			expiresAt: expiresAt || null
 		});
-		return authData;
+		return {
+			...authData,
+			refreshToken,
+			expiresAt
+		};
 	}
 	/**
 	* Register a new user and account.
 	*/
 	async register(data) {
 		const payload = { ...data };
-		if (!payload.accountName && this.defaultAccount) payload.accountName = this.defaultAccount;
+		if (!payload.account_name && this.defaultAccount) payload.account_name = this.defaultAccount;
 		return (await this.http.post("/api/v1/auth/register", payload)).data;
 	}
 	/**
@@ -591,15 +599,20 @@ var AuthService = class {
 	async refreshToken() {
 		const refreshToken = this.auth.refreshToken;
 		if (!refreshToken) throw new Error("No refresh token available");
-		const authData = (await this.http.post("/api/v1/auth/refresh", { refreshToken })).data;
+		const authData = (await this.http.post("/api/v1/auth/refresh", { refresh_token: refreshToken })).data;
+		const newRefreshToken = authData.refresh_token || authData.refreshToken;
+		let expiresAt = authData.expiresAt;
+		if (authData.expires_in && !expiresAt) expiresAt = new Date(Date.now() + authData.expires_in * 1e3).toISOString();
 		await this.auth.setState({
-			user: authData.user,
-			account: authData.account,
-			token: authData.token,
-			refreshToken: authData.refreshToken,
-			expiresAt: authData.expiresAt
+			token: authData.token || null,
+			refreshToken: newRefreshToken || null,
+			expiresAt: expiresAt || null
 		});
-		return authData;
+		return {
+			...authData,
+			refreshToken: newRefreshToken,
+			expiresAt
+		};
 	}
 	/**
 	* Log out the current user.
@@ -617,11 +630,31 @@ var AuthService = class {
 	*/
 	async getCurrentUser() {
 		const authData = (await this.http.get("/api/v1/auth/me")).data;
+		console.log("GetMe Response:", JSON.stringify(authData, null, 2));
+		const user = authData.user || (authData.user_id ? {
+			id: authData.user_id,
+			email: authData.email || "",
+			role: authData.role || "user",
+			groups: [],
+			is_active: true,
+			created_at: "",
+			last_login: null
+		} : null);
+		const account = authData.account || (authData.account_id ? {
+			id: authData.account_id,
+			slug: "",
+			name: "",
+			created_at: ""
+		} : null);
 		await this.auth.setState({
-			user: authData.user,
-			account: authData.account
+			user,
+			account
 		});
-		return authData;
+		return {
+			...authData,
+			user: user || void 0,
+			account: account || void 0
+		};
 	}
 	/**
 	* Initiate password reset flow.
@@ -907,6 +940,62 @@ var CollectionService = class {
 		await this.http.delete(`/api/v1/collections/${collectionId}`);
 		return { success: true };
 	}
+	/**
+	* Export collections to JSON format.
+	* Returns collection schemas and rules for backup or migration.
+	*
+	* @param params Optional filter by collection IDs
+	* @returns Complete export data structure with collections, schemas, and rules
+	* @throws {AuthorizationError} If user is not a superadmin
+	*
+	* @example
+	* // Export all collections
+	* const exportData = await client.collections.export();
+	*
+	* @example
+	* // Export specific collections
+	* const exportData = await client.collections.export({
+	*   collection_ids: ['col-123', 'col-456']
+	* });
+	*/
+	async export(params) {
+		const queryParams = {};
+		if (params?.collection_ids && params.collection_ids.length > 0) queryParams.collection_ids = params.collection_ids.join(",");
+		return (await this.http.get("/api/v1/collections/export", { params: queryParams })).data;
+	}
+	/**
+	* Import collections from JSON export.
+	*
+	* @param request Import request with data and conflict strategy
+	* @returns Import result with per-collection status and migration IDs
+	* @throws {ValidationError} If import data is invalid
+	* @throws {ConflictError} If collection exists and strategy is 'error'
+	* @throws {AuthorizationError} If user is not a superadmin
+	*
+	* @example
+	* // Import with error strategy (fail on conflicts)
+	* const result = await client.collections.import({
+	*   data: exportData,
+	*   strategy: 'error'
+	* });
+	*
+	* @example
+	* // Import with skip strategy (skip existing collections)
+	* const result = await client.collections.import({
+	*   data: exportData,
+	*   strategy: 'skip'
+	* });
+	*
+	* @example
+	* // Import with update strategy (update existing collections)
+	* const result = await client.collections.import({
+	*   data: exportData,
+	*   strategy: 'update'
+	* });
+	*/
+	async import(request) {
+		return (await this.http.post("/api/v1/collections/import", request)).data;
+	}
 };
 
 //#endregion
@@ -1090,7 +1179,14 @@ var RecordService = class {
 			if (params.sort !== void 0) formattedParams.sort = params.sort;
 			if (params.fields) formattedParams.fields = Array.isArray(params.fields) ? params.fields.join(",") : params.fields;
 			if (params.expand) formattedParams.expand = Array.isArray(params.expand) ? params.expand.join(",") : params.expand;
-			if (params.filter) formattedParams.filter = typeof params.filter === "string" ? params.filter : JSON.stringify(params.filter);
+			if (params.filter) {
+				const filterStr = typeof params.filter === "string" ? params.filter : JSON.stringify(params.filter);
+				const match = filterStr.match(/^\(?\s*(\w+)\s*=\s*(["']?)([^"'\)]+)\2\s*\)?$/);
+				if (match) {
+					const [, key, , value] = match;
+					formattedParams[key] = value;
+				} else formattedParams.filter = filterStr;
+			}
 		}
 		return (await this.http.get(`/api/v1/records/${collection}`, { params: formattedParams })).data;
 	}
@@ -1325,7 +1421,25 @@ var AuditLogService = class {
 		return (await this.httpClient.get(`/api/v1/audit-logs/${logId}`)).data;
 	}
 	/**
-	* Exports audit logs in the specified format.
+	* Exports audit logs in the specified format (JSON, CSV, or PDF).
+	*
+	* @param params Optional filters (account_id, table_name, operation, date range, etc.)
+	* @param format Export format: 'json', 'csv', or 'pdf' (default: 'json')
+	* @returns Exported data as string (base64-encoded for PDF format)
+	* @throws {AuthorizationError} If user is not a superadmin
+	*
+	* @example
+	* // Export as JSON
+	* const jsonData = await client.auditLogs.export({ table_name: 'users' }, 'json');
+	*
+	* @example
+	* // Export as CSV
+	* const csvData = await client.auditLogs.export({ table_name: 'users' }, 'csv');
+	*
+	* @example
+	* // Export as PDF
+	* const pdfBase64 = await client.auditLogs.export({ table_name: 'users' }, 'pdf');
+	* // pdfBase64 is a base64-encoded PDF string
 	*/
 	async export(params, format = "json") {
 		return (await this.httpClient.get("/api/v1/audit-logs/export", { params: {

package/package.json

@@ -1,48 +1,40 @@
 {
   "name": "@snackbase/sdk",
-  "version": "0.1.0",
-  "description": "JavaScript/TypeScript SDK for SnackBase",
+  "version": "0.2.0",
+  "description": "Core SDK for SnackBase",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
   "exports": {
     ".": {
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./react": {
-      "import": "./dist/react/index.mjs",
-      "require": "./dist/react/index.js",
-      "types": "./dist/react/index.d.ts"
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     }
   },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "snackbase",
+    "sdk",
+    "database"
+  ],
+  "author": "SnackBase Team",
+  "license": "MIT",
+  "devDependencies": {
+    "@snackbase/tsconfig": "0.1.0"
+  },
   "scripts": {
-    "dev": "tsdown src/index.ts src/react/index.ts --watch",
-    "build": "tsdown src/index.ts src/react/index.ts",
+    "dev": "tsdown src/index.ts --format esm,cjs --watch",
+    "build": "tsdown src/index.ts --format esm,cjs --dts",
     "test": "vitest run",
-    "test:watch": "vitest",
-    "test:integration": "vitest run --config vitest.integration.config.ts",
-    "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint src --ext .ts,.tsx",
-    "prepublishOnly": "npm run build && npm run test"
-  },
-  "peerDependencies": {
-    "react": "^18.0.0"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@testing-library/jest-dom": "^6.9.1",
-    "@testing-library/react": "^16.3.2",
-    "@vitejs/plugin-react": "^5.1.2",
-    "jsdom": "^27.4.0",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "tsdown": "^0.20.0-beta.4",
-    "typescript": "^5.3.3",
-    "vite": "^7.3.1",
-    "vitest": "^1.2.1"
+    "clean": "rm -rf dist"
   }
-}
+}

package/CHANGELOG.md

@@ -1,61 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-### Added
-- Initial release of SnackBase SDK for JavaScript/TypeScript
-
-### Features
-- **Core Client**: `SnackBaseClient` with configuration validation
-- **HTTP Client**: Fetch-based HTTP client with interceptors
-- **Authentication**: Email/password, OAuth, SAML, and API key authentication
-- **Services**: 17+ service classes for all SnackBase resources
-  - Accounts, Users, Collections, Records
-  - Roles, Collection Rules (Permission System V2)
-  - Groups, Invitations, Macros
-  - API Keys, Audit Logs, Dashboard, Admin
-  - Email Templates, Files
-- **Real-Time**: WebSocket/SSE support with automatic reconnection
-- **Query Builder**: Fluent API for complex queries
-- **React Integration**: Context provider and hooks
-  - `useAuth`, `useQuery`, `useRecord`, `useMutation`, `useSubscription`
-- **Type Safety**: Complete TypeScript definitions
-- **Error Handling**: Typed error hierarchy
-- **Storage Abstraction**: Platform-agnostic storage backends
-- **Logging**: Structured logging system with configurable levels
-
-### Package Exports
-- `@snackbase/sdk` - Core SDK
-- `@snackbase/sdk/react` - React integration
-
-### Build Output
-- ESM (`.mjs`) - 14.87 KB gzipped
-- CommonJS (`.js`)
-- TypeScript declarations (`.d.ts`)
-
-## [0.1.0] - 2025-01-XX
-
-### Added
-- Initial beta release
-- Complete Phase 1-4 implementation
-- Core SDK features
-- React hooks
-- Real-time subscriptions
-- Query builder
-- 231 tests passing
-
-## [Future Releases]
-
-### Planned
-- Integration tests with test server
-- Performance benchmarks
-- Request deduplication
-- Advanced caching strategies
-- Vue 3 integration
-- Angular integration
-- Svelte integration

package/README.md

@@ -1,287 +0,0 @@
-# SnackBase SDK
-
-[![npm version](https://badge.fury.io/js/%40snackbase%2Fsdk.svg)](https://www.npmjs.com/package/@snackbase/sdk)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Build Status](https://github.com/snackbase/snackbase-js/workflows/CI/badge.svg)](https://github.com/snackbase/snackbase-js/actions)
-
-The official JavaScript/TypeScript SDK for [SnackBase](https://snackbase.dev) - a powerful backend-as-a-service platform.
-
-## Features
-
-- **Type-Safe**: Built with TypeScript for full type safety and excellent developer experience
-- **Authentication**: Support for JWT tokens, OAuth, SAML, and API keys
-- **Real-Time**: WebSocket and SSE support for real-time data synchronization
-- **React Integration**: Dedicated React hooks and context for seamless integration
-- **Query Builder**: Fluent API for building complex queries with filtering, sorting, and pagination
-- **Platform Agnostic**: Works in browsers, React Native, and Node.js
-- **Lightweight**: Only 14.87 KB gzipped for the core SDK
-
-## Installation
-
-```bash
-# npm
-npm install @snackbase/sdk
-
-# yarn
-yarn add @snackbase/sdk
-
-# pnpm
-pnpm add @snackbase/sdk
-```
-
-### React Integration
-
-```bash
-# npm
-npm install @snackbase/sdk react
-
-# yarn
-yarn add @snackbase/sdk react
-
-# pnpm
-pnpm add @snackbase/sdk react
-```
-
-## Quick Start
-
-### Basic Usage
-
-```typescript
-import { SnackBaseClient } from "@snackbase/sdk";
-
-// Initialize the client
-const client = new SnackBaseClient({
-  baseUrl: "https://your-project.snackbase.dev",
-  apiKey: "your-api-key", // Optional for public access
-});
-
-// Authenticate with email/password
-const auth = await client.auth.authenticateWithPassword({
-  email: "user@example.com",
-  password: "password123",
-});
-
-console.log("Logged in as:", auth.user.email);
-
-// List records from a collection
-const records = await client.records.list("posts", {
-  filter: { status: "published" },
-  sort: "-createdAt",
-});
-
-// Subscribe to real-time updates
-client.realtime.subscribe("posts", (event) => {
-  console.log("New event:", event.action, event.record);
-});
-```
-
-### React Integration
-
-```tsx
-import { SnackBaseProvider, useAuth, useRecord } from "@snackbase/sdk/react";
-
-function App() {
-  return (
-    <SnackBaseProvider
-      baseUrl="https://your-project.snackbase.dev"
-      apiKey="your-api-key"
-    >
-      <Posts />
-    </SnackBaseProvider>
-  );
-}
-
-function Posts() {
-  const { user, login, logout } = useAuth();
-  const { data: posts, loading } = useRecord("posts", {
-    filter: { status: "published" },
-  });
-
-  if (!user) {
-    return <button onClick={() => login(email, password)}>Login</button>;
-  }
-
-  return (
-    <div>
-      <button onClick={logout}>Logout</button>
-      {loading ? <p>Loading...</p> : <PostList posts={posts?.items} />}
-    </div>
-  );
-}
-```
-
-## Documentation
-
-- [Getting Started Guide](./docs/getting-started.md)
-- [Authentication Guide](./docs/authentication.md)
-- [Real-Time Features](./docs/realtime.md)
-- [React Integration](./docs/react-integration.md)
-- [API Reference](./docs/api-reference.md)
-- [Migration Guides](./docs/migration/)
-
-## Platform Support
-
-| Platform                                | Support |
-| --------------------------------------- | ------- |
-| Browser (Chrome, Firefox, Safari, Edge) | ✅ Full |
-| React Native                            | ✅ Full |
-| Node.js                                 | ✅ Full |
-| Next.js                                 | ✅ Full |
-| Vue/Nuxt                                | ✅ Full |
-
-## Authentication Methods
-
-| Method             | Description                                        |
-| ------------------ | -------------------------------------------------- |
-| **Email/Password** | Traditional authentication with email and password |
-| **OAuth**          | Sign in with Google, GitHub, etc.                  |
-| **SAML**           | Enterprise SSO support                             |
-| **API Key**        | Server-to-server authentication                    |
-
-## Core Services
-
-The SDK provides 17+ services for interacting with SnackBase:
-
-- `client.auth` - Authentication and user management
-- `client.users` - User CRUD operations
-- `client.accounts` - Account management
-- `client.collections` - Collection/schema management
-- `client.records` - Dynamic record operations (CRUD, queries)
-- `client.roles` - Role-based access control
-- `client.groups` - Group management
-- `client.invitations` - User invitations
-- `client.macros` - Macro operations
-- `client.apiKeys` - API key management
-- `client.auditLogs` - Audit log access
-- `client.dashboard` - Dashboard metrics
-- `client.admin` - Admin operations
-- `client.emailTemplates` - Email template management
-- `client.files` - File upload/download
-- `client.realtime` - Real-time subscriptions
-- `client.query` - Query builder
-
-## Query Builder
-
-Build complex queries with a fluent API:
-
-```typescript
-const results = await client
-  .query("posts")
-  .select("id", "title", "author.name")
-  .expand("author", "comments")
-  .filter("status", "=", "published")
-  .filter("createdAt", ">", "2024-01-01")
-  .sort("createdAt", "desc")
-  .page(1)
-  .perPage(20)
-  .execute();
-```
-
-## Real-Time Subscriptions
-
-Subscribe to record changes in real-time:
-
-```typescript
-// Subscribe to a collection
-const unsubscribe = client.realtime.subscribe("posts", (event) => {
-  switch (event.action) {
-    case "create":
-      console.log("New post created:", event.record);
-      break;
-    case "update":
-      console.log("Post updated:", event.record);
-      break;
-    case "delete":
-      console.log("Post deleted:", event.record);
-      break;
-  }
-});
-
-// Unsubscribe when done
-unsubscribe();
-```
-
-## Error Handling
-
-The SDK provides typed errors for comprehensive error handling:
-
-```typescript
-import {
-  SnackBaseError,
-  AuthenticationError,
-  ValidationError,
-  NetworkError,
-} from "@snackbase/sdk";
-
-try {
-  await client.records.create("posts", data);
-} catch (error) {
-  if (error instanceof ValidationError) {
-    console.error("Validation failed:", error.fields);
-  } else if (error instanceof AuthenticationError) {
-    console.error("Authentication failed:", error.message);
-  } else if (error instanceof NetworkError) {
-    console.error("Network error:", error.message);
-  }
-}
-```
-
-## TypeScript Support
-
-The SDK is written in TypeScript and provides full type definitions:
-
-```typescript
-import type { User, Post, Comment } from "@snackbase/sdk";
-
-// Type-safe record operations
-const post: Post = await client.records.get<Post>("posts", "record-id");
-
-// Type-safe auth state
-const user: User = await client.auth.getCurrentUser();
-```
-
-## Development
-
-```bash
-# Clone the repository
-git clone https://github.com/snackbase/snackbase-js.git
-cd snackbase-js
-
-# Install dependencies
-npm install
-
-# Build
-npm run build
-
-# Run tests
-npm test
-
-# Watch mode
-npm run dev
-```
-
-## Bundle Size
-
-- Core SDK: **14.87 KB** (gzipped)
-- React Integration: **1.42 KB** (gzipped)
-- Total: **16.29 KB** (gzipped)
-
-## License
-
-MIT © [SnackBase](https://snackbase.dev)
-
-## Contributing
-
-We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.
-
-## Support
-
-- Documentation: [https://docs.snackbase.dev](https://docs.snackbase.dev)
-- GitHub Issues: [https://github.com/snackbase/snackbase-js/issues](https://github.com/snackbase/snackbase-js/issues)
-- Discord: [https://discord.gg/snackbase](https://discord.gg/snackbase)
-
-## Related Projects
-
-- [SnackBase](https://snackbase.dev) - The official SnackBase platform
-- [snackbase-python](https://github.com/snackbase/snackbase-python) - Python SDK
-- [snackbase-go](https://github.com/snackbase/snackbase-go) - Go SDK