@zveltio/sdk 1.2.0

package/README.md

@@ -0,0 +1,191 @@
+# @zveltio/sdk
+
+TypeScript SDK for Zveltio — HTTP client, Realtime WebSocket, and Local-First offline support.
+
+## Installation
+
+```bash
+bun add @zveltio/sdk
+```
+
+## Basic Usage
+
+```typescript
+import { createZveltioClient } from '@zveltio/sdk';
+
+const client = createZveltioClient({ baseUrl: 'https://api.myapp.com' });
+
+// CRUD
+const todos = await client.collection('todos').list();
+await client.collection('todos').create({ title: 'Buy milk', done: false });
+await client.collection('todos').update('id-123', { done: true });
+await client.collection('todos').delete('id-123');
+```
+
+## Live TypeScript Types
+
+Get full IntelliSense on every `.collection()` call by pointing the client at your generated schema.
+
+**Step 1 — Generate types** (one-shot or watch mode):
+
+```bash
+# One-shot
+bunx zveltio generate-types --url http://localhost:3000 --out ./src/zveltio-types.d.ts
+
+# Watch mode (re-generates on every schema change while developing)
+bunx zveltio dev --watch
+```
+
+**Step 2 — Import the generated alias:**
+
+```typescript
+import type { ZveltioSchema } from './zveltio-types';
+```
+
+**Step 3 — Pass it to `createZveltioClient`:**
+
+```typescript
+import { createZveltioClient } from '@zveltio/sdk';
+import type { ZveltioSchema } from './zveltio-types';
+
+const client = createZveltioClient<ZveltioSchema>({
+  baseUrl: 'https://api.myapp.com',
+});
+```
+
+**Step 4 — Every `.collection()` call is now fully typed:**
+
+```typescript
+// TypeScript knows the shape of each record automatically
+const { data: products } = await client.collection('products').list();
+//           ^-- typed as Products[] (from your generated CollectionTypeMap)
+
+const order = await client.collection('orders').getOne('ord-123');
+//    ^-- typed as Orders
+
+await client.collection('products').create({ name: 'Widget', price: 9.99 });
+//   TypeScript will error if you pass unknown fields or the wrong types
+```
+
+The generated file (`zveltio-types.d.ts`) exports individual interfaces per collection, a `CollectionTypeMap` interface, and the `ZveltioSchema` alias — all kept in sync automatically when you run in watch mode.
+
+## Realtime
+
+```typescript
+import { ZveltioRealtime } from '@zveltio/sdk';
+
+const rt = new ZveltioRealtime('https://api.myapp.com');
+rt.connect();
+
+const unsub = rt.subscribe('todos', (event) => {
+  console.log('Event:', event.event, event.record_id);
+});
+
+// Cleanup
+unsub();
+rt.disconnect();
+```
+
+## Local-First Usage
+
+Zveltio SDK supports offline-first data access with automatic background sync:
+
+```typescript
+import { createZveltioClient, SyncManager } from '@zveltio/sdk';
+
+const client = createZveltioClient({ baseUrl: 'https://api.myapp.com' });
+const sync = new SyncManager(client, {
+  syncInterval: 5000,
+  onConflict: (local, server) => {
+    // Custom merge: keep local 'notes' field, take rest from server
+    return { ...server, notes: local?.notes };
+  },
+});
+
+// Start: opens IndexedDB, connects WebSocket, starts periodic sync
+await sync.start('https://api.myapp.com');
+
+// All operations are instant (local-first)
+const todos = sync.collection('todos');
+
+// Create — writes locally, syncs in background
+await todos.create({ title: 'Buy milk', done: false });
+
+// List — reads from local IndexedDB (instant, works offline)
+const all = await todos.list();
+// each record has _syncStatus: 'synced' | 'pending' | 'conflict'
+
+// Update — writes locally, syncs in background
+await todos.update('id-123', { done: true });
+
+// Delete — soft-deletes locally, syncs in background
+await todos.delete('id-123');
+
+// Subscribe — reactive updates (local writes + server push via WebSocket)
+const unsub = todos.subscribe((records) => {
+  console.log('Todos updated:', records);
+});
+
+// Check sync status
+const status = await sync.getStatus();
+// { pending: 2, conflicts: 0, isOnline: true }
+
+// Handle conflicts manually
+const conflicts = await todos.getConflicts();
+for (const conflict of conflicts) {
+  await todos.resolveConflict(conflict.id, { ...conflict.data, resolved: true });
+}
+
+// Cleanup
+unsub();
+await sync.stop();
+```
+
+## Svelte 5 Integration
+
+```svelte
+<script lang="ts">
+  import { onDestroy } from 'svelte';
+  import { useSyncCollection, useSyncStatus } from '@zveltio/sdk';
+
+  let todos = $state<any[]>([]);
+  let syncStatus = $state({ pending: 0, conflicts: 0, isOnline: true });
+
+  const unsubTodos = useSyncCollection(sync, 'todos', (records) => {
+    todos = records;
+  });
+
+  const unsubStatus = useSyncStatus(sync, (s) => {
+    syncStatus = s;
+  });
+
+  onDestroy(() => {
+    unsubTodos();
+    unsubStatus();
+  });
+</script>
+
+{#if !syncStatus.isOnline}
+  <div class="alert alert-warning">Offline — changes will sync when reconnected</div>
+{/if}
+
+{#if syncStatus.pending > 0}
+  <div class="badge badge-warning">{syncStatus.pending} pending</div>
+{/if}
+
+{#each todos as todo}
+  <div class:opacity-60={todo._syncStatus === 'pending'}>
+    {todo.title}
+    {#if todo._syncStatus === 'conflict'}<span class="badge badge-error">conflict</span>{/if}
+  </div>
+{/each}
+```
+
+## Engine Sync Endpoints
+
+The engine exposes two endpoints for batch sync:
+
+- `POST /api/sync/push` — send offline operations to server
+- `POST /api/sync/pull` — pull changes since a timestamp
+
+These are used automatically by `SyncManager`. You can also call them directly for custom sync logic.

package/dist/client/Auth.d.ts

@@ -0,0 +1,19 @@
+import type { ZveltioConfig } from '../types/index.js';
+export declare class Auth {
+    private config;
+    constructor(config: ZveltioConfig);
+    signIn(email: string, password: string): Promise<{
+        user: any;
+        session: any;
+    }>;
+    signUp(name: string, email: string, password: string): Promise<{
+        user: any;
+    }>;
+    signOut(): Promise<void>;
+    getSession(): Promise<{
+        user: any;
+        session: any;
+    } | null>;
+    signInWithOAuth(provider: 'google' | 'github' | 'microsoft'): void;
+}
+//# sourceMappingURL=Auth.d.ts.map

package/dist/client/Auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Auth.d.ts","sourceRoot":"","sources":["../../src/client/Auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,qBAAa,IAAI;IACf,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAI3B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE,CAAC;IAW7E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC;IAW7E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxB,UAAU,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE,GAAG,IAAI,CAAC;IAQ/D,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,IAAI;CAGnE"}

package/dist/client/Auth.js

@@ -0,0 +1,45 @@
+export class Auth {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async signIn(email, password) {
+        const res = await fetch(`${this.config.baseUrl}/api/auth/sign-in/email`, {
+            method: 'POST',
+            credentials: 'include',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ email, password }),
+        });
+        if (!res.ok)
+            throw new Error((await res.json()).message || 'Sign in failed');
+        return res.json();
+    }
+    async signUp(name, email, password) {
+        const res = await fetch(`${this.config.baseUrl}/api/auth/sign-up/email`, {
+            method: 'POST',
+            credentials: 'include',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ name, email, password }),
+        });
+        if (!res.ok)
+            throw new Error((await res.json()).message || 'Sign up failed');
+        return res.json();
+    }
+    async signOut() {
+        await fetch(`${this.config.baseUrl}/api/auth/sign-out`, {
+            method: 'POST',
+            credentials: 'include',
+        });
+    }
+    async getSession() {
+        const res = await fetch(`${this.config.baseUrl}/api/me`, { credentials: 'include' });
+        if (!res.ok)
+            return null;
+        const data = await res.json();
+        return { user: data.user, session: {} };
+    }
+    // OAuth redirect
+    signInWithOAuth(provider) {
+        window.location.href = `${this.config.baseUrl}/api/auth/sign-in/${provider}`;
+    }
+}

package/dist/client/QueryBuilder.d.ts

@@ -0,0 +1,17 @@
+import type { ZveltioConfig, QueryOptions, QueryResponse } from '../types/index.js';
+export declare class QueryBuilder {
+    private _collection;
+    private _config;
+    private _filters;
+    private _options;
+    constructor(collection: string, config: ZveltioConfig);
+    where(field: string, value: any): this;
+    where(field: string, op: string, value: any): this;
+    page(n: number): this;
+    limit(n: number): this;
+    sortBy(field: string, order?: 'asc' | 'desc'): this;
+    search(q: string): this;
+    query<T = any>(overrideOptions?: QueryOptions): Promise<QueryResponse<T>>;
+    [Symbol.asyncIterator]<T = any>(): AsyncGenerator<T[]>;
+}
+//# sourceMappingURL=QueryBuilder.d.ts.map

package/dist/client/QueryBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryBuilder.d.ts","sourceRoot":"","sources":["../../src/client/QueryBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEpF,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,QAAQ,CAAoB;gBAExB,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa;IAMrD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IACtC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAWlD,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IACrB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAGtB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,KAAK,GAAG,MAAc,GAAG,IAAI;IAO1D,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAGjB,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,eAAe,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAiCxE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,cAAc,CAAC,CAAC,EAAE,CAAC;CAY9D"}

package/dist/client/QueryBuilder.js

@@ -0,0 +1,76 @@
+export class QueryBuilder {
+    _collection;
+    _config;
+    _filters = {};
+    _options = {};
+    constructor(collection, config) {
+        this._collection = collection;
+        this._config = config;
+    }
+    where(field, opOrValue, value) {
+        if (value === undefined) {
+            this._filters[field] = opOrValue;
+        }
+        else {
+            this._filters[field] = { [opOrValue]: value };
+        }
+        return this;
+    }
+    // Pagination
+    page(n) { this._options.page = n; return this; }
+    limit(n) { this._options.limit = n; return this; }
+    // Sorting
+    sortBy(field, order = 'asc') {
+        this._options.sort = field;
+        this._options.order = order;
+        return this;
+    }
+    // Search
+    search(q) { this._options.search = q; return this; }
+    // Execute
+    async query(overrideOptions) {
+        const opts = { ...this._options, ...overrideOptions };
+        const params = new URLSearchParams();
+        if (opts.page)
+            params.set('page', String(opts.page));
+        if (opts.limit)
+            params.set('limit', String(opts.limit));
+        if (opts.sort)
+            params.set('sort', opts.sort);
+        if (opts.order)
+            params.set('order', opts.order);
+        if (opts.search)
+            params.set('search', opts.search);
+        if (Object.keys(this._filters).length > 0) {
+            params.set('filter', JSON.stringify(this._filters));
+        }
+        const qs = params.toString();
+        const url = `/api/data/${this._collection}${qs ? '?' + qs : ''}`;
+        const headers = { 'Content-Type': 'application/json' };
+        if (this._config.apiKey)
+            headers['X-API-Key'] = this._config.apiKey;
+        const res = await fetch(`${this._config.baseUrl}${url}`, {
+            credentials: 'include',
+            headers,
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({ error: res.statusText }));
+            throw new Error(err.error || `Query failed: ${res.status}`);
+        }
+        return res.json();
+    }
+    // Async iterable — allows `for await (const page of query)`
+    async *[Symbol.asyncIterator]() {
+        let currentPage = this._options.page || 1;
+        const pageSize = this._options.limit || 20;
+        while (true) {
+            const result = await this.page(currentPage).limit(pageSize).query();
+            if (result.records.length === 0)
+                break;
+            yield result.records;
+            if (currentPage >= result.pagination.pages)
+                break;
+            currentPage++;
+        }
+    }
+}

package/dist/client/RealtimeClient.d.ts

@@ -0,0 +1,22 @@
+import type { RealtimeMessage } from '../types/index.js';
+type EventCallback = (message: RealtimeMessage) => void;
+type StatusCallback = (status: 'connecting' | 'connected' | 'disconnected') => void;
+export declare class RealtimeClient {
+    private ws;
+    private baseUrl;
+    private subscriptions;
+    private statusCallbacks;
+    private reconnectDelay;
+    private maxReconnectDelay;
+    private shouldReconnect;
+    constructor(baseUrl: string);
+    connect(): void;
+    disconnect(): void;
+    subscribe(collection: string, event: string | '*', callback: EventCallback): () => void;
+    onStatusChange(callback: StatusCallback): () => void;
+    private sendSubscribe;
+    private sendUnsubscribe;
+    private notifyStatus;
+}
+export {};
+//# sourceMappingURL=RealtimeClient.d.ts.map

package/dist/client/RealtimeClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RealtimeClient.d.ts","sourceRoot":"","sources":["../../src/client/RealtimeClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;AACxD,KAAK,cAAc,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,GAAG,cAAc,KAAK,IAAI,CAAC;AAEpF,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,eAAe,CAAQ;gBAEnB,OAAO,EAAE,MAAM;IAI3B,OAAO,IAAI,IAAI;IA4Cf,UAAU,IAAI,IAAI;IAQlB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAwBvF,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI;IAKpD,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,YAAY;CAGrB"}

package/dist/client/RealtimeClient.js

@@ -0,0 +1,96 @@
+export class RealtimeClient {
+    ws = null;
+    baseUrl;
+    subscriptions = new Map();
+    statusCallbacks = new Set();
+    reconnectDelay = 1000;
+    maxReconnectDelay = 30000;
+    shouldReconnect = true;
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    connect() {
+        if (this.ws?.readyState === WebSocket.OPEN)
+            return;
+        const wsUrl = this.baseUrl.replace(/^http/, 'ws') + '/api/ws';
+        this.ws = new WebSocket(wsUrl);
+        this.notifyStatus('connecting');
+        this.ws.onopen = () => {
+            this.reconnectDelay = 1000;
+            this.notifyStatus('connected');
+            // Re-subscribe all active subscriptions
+            for (const channel of this.subscriptions.keys()) {
+                this.sendSubscribe(channel);
+            }
+        };
+        this.ws.onmessage = (event) => {
+            try {
+                const message = JSON.parse(event.data);
+                const key = `${message.collection}:${message.event}`;
+                const wildcard = `${message.collection}:*`;
+                const allWildcard = `*:*`;
+                for (const [sub, callbacks] of this.subscriptions) {
+                    if (sub === key || sub === wildcard || sub === allWildcard) {
+                        callbacks.forEach((cb) => cb(message));
+                    }
+                }
+            }
+            catch { /* ignore invalid messages */ }
+        };
+        this.ws.onclose = () => {
+            this.notifyStatus('disconnected');
+            if (this.shouldReconnect) {
+                setTimeout(() => this.connect(), this.reconnectDelay);
+                this.reconnectDelay = Math.min(this.reconnectDelay * 2, this.maxReconnectDelay);
+            }
+        };
+        this.ws.onerror = () => {
+            this.ws?.close();
+        };
+    }
+    disconnect() {
+        this.shouldReconnect = false;
+        this.ws?.close();
+        this.ws = null;
+    }
+    // Subscribe to events on a collection
+    // pattern examples: 'products:insert', 'products:*', '*:*'
+    subscribe(collection, event, callback) {
+        const key = `${collection}:${event}`;
+        if (!this.subscriptions.has(key)) {
+            this.subscriptions.set(key, new Set());
+        }
+        this.subscriptions.get(key).add(callback);
+        if (this.ws?.readyState === WebSocket.OPEN) {
+            this.sendSubscribe(key);
+        }
+        else {
+            this.connect();
+        }
+        // Return unsubscribe function
+        return () => {
+            this.subscriptions.get(key)?.delete(callback);
+            if (this.subscriptions.get(key)?.size === 0) {
+                this.subscriptions.delete(key);
+                this.sendUnsubscribe(key);
+            }
+        };
+    }
+    onStatusChange(callback) {
+        this.statusCallbacks.add(callback);
+        return () => this.statusCallbacks.delete(callback);
+    }
+    sendSubscribe(channel) {
+        if (this.ws?.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify({ type: 'subscribe', channel }));
+        }
+    }
+    sendUnsubscribe(channel) {
+        if (this.ws?.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify({ type: 'unsubscribe', channel }));
+        }
+    }
+    notifyStatus(status) {
+        this.statusCallbacks.forEach((cb) => cb(status));
+    }
+}

package/dist/client/ZveltioClient.d.ts

@@ -0,0 +1,20 @@
+import type { ZveltioConfig, QueryOptions, QueryResponse, DeleteResponse } from '../types/index.js';
+import { QueryBuilder } from './QueryBuilder.js';
+import { Auth } from './Auth.js';
+import { RealtimeClient } from './RealtimeClient.js';
+export declare class ZveltioClient {
+    readonly auth: Auth;
+    readonly realtime: RealtimeClient;
+    private config;
+    constructor(config: ZveltioConfig);
+    from(collection: string): QueryBuilder;
+    list<T = any>(collection: string, options?: QueryOptions): Promise<QueryResponse<T>>;
+    get<T = any>(collection: string, id: string): Promise<T>;
+    create<T = any>(collection: string, data: Partial<T>): Promise<T>;
+    update<T = any>(collection: string, id: string, data: Partial<T>): Promise<T>;
+    replace<T = any>(collection: string, id: string, data: T): Promise<T>;
+    delete(collection: string, id: string): Promise<DeleteResponse>;
+    request<T>(path: string, init?: RequestInit): Promise<T>;
+}
+export declare function createClient(config: ZveltioConfig): ZveltioClient;
+//# sourceMappingURL=ZveltioClient.d.ts.map

package/dist/client/ZveltioClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZveltioClient.d.ts","sourceRoot":"","sources":["../../src/client/ZveltioClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAkC,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACpI,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,qBAAa,aAAa;IACxB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAOjC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IAKhC,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAIpF,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAKxD,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAQjE,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ7E,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAQrE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAO/D,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;CA4B/D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAEjE"}

package/dist/client/ZveltioClient.js

@@ -0,0 +1,78 @@
+import { QueryBuilder } from './QueryBuilder.js';
+import { Auth } from './Auth.js';
+import { RealtimeClient } from './RealtimeClient.js';
+export class ZveltioClient {
+    auth;
+    realtime;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.auth = new Auth(config);
+        this.realtime = new RealtimeClient(config.baseUrl);
+    }
+    // Fluent query builder
+    from(collection) {
+        return new QueryBuilder(collection, this.config);
+    }
+    // Direct CRUD methods
+    async list(collection, options) {
+        return this.from(collection).query(options);
+    }
+    async get(collection, id) {
+        const res = await this.request(`/api/data/${collection}/${id}`);
+        return res.record;
+    }
+    async create(collection, data) {
+        const res = await this.request(`/api/data/${collection}`, {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+        return res.record;
+    }
+    async update(collection, id, data) {
+        const res = await this.request(`/api/data/${collection}/${id}`, {
+            method: 'PATCH',
+            body: JSON.stringify(data),
+        });
+        return res.record;
+    }
+    async replace(collection, id, data) {
+        const res = await this.request(`/api/data/${collection}/${id}`, {
+            method: 'PUT',
+            body: JSON.stringify(data),
+        });
+        return res.record;
+    }
+    async delete(collection, id) {
+        return this.request(`/api/data/${collection}/${id}`, {
+            method: 'DELETE',
+        });
+    }
+    // Raw request helper
+    async request(path, init) {
+        const headers = {
+            'Content-Type': 'application/json',
+            ...init?.headers,
+        };
+        if (this.config.apiKey) {
+            headers['X-API-Key'] = this.config.apiKey;
+        }
+        const res = await fetch(`${this.config.baseUrl}${path}`, {
+            ...init,
+            credentials: 'include',
+            headers,
+        });
+        if (res.status === 401) {
+            this.config.onUnauthorized?.();
+            throw new Error('Unauthorized');
+        }
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({ error: res.statusText }));
+            throw new Error(err.error || `Request failed: ${res.status}`);
+        }
+        return res.json();
+    }
+}
+export function createClient(config) {
+    return new ZveltioClient(config);
+}

package/dist/client.d.ts

@@ -0,0 +1,82 @@
+export interface ZveltioClientConfig {
+    baseUrl: string;
+    apiKey?: string;
+    headers?: Record<string, string>;
+}
+export interface ListParams {
+    page?: number;
+    limit?: number;
+    sort?: string;
+    order?: 'asc' | 'desc';
+    search?: string;
+    filter?: Record<string, any>;
+    cursor?: string;
+}
+export interface ListResult<T> {
+    data: T[];
+    total: number;
+    page: number;
+    limit: number;
+    next_cursor?: string;
+}
+declare class CollectionRef<T extends Record<string, any>> {
+    private readonly name;
+    private readonly client;
+    constructor(name: string, client: ZveltioClient<any>);
+    list(params?: ListParams): Promise<ListResult<T>>;
+    getMany(params?: ListParams): Promise<ListResult<T>>;
+    get(id: string): Promise<T>;
+    getOne(id: string): Promise<T>;
+    create(data: Omit<T, 'id' | 'created_at' | 'updated_at'>): Promise<T>;
+    update(id: string, data: Partial<Omit<T, 'id' | 'created_at' | 'updated_at'>>): Promise<T>;
+    delete(id: string): Promise<{
+        success: boolean;
+    }>;
+}
+/**
+ * ZveltioClient — generic over your schema type.
+ *
+ * Usage with generated types (run `zveltio generate-types` once):
+ *
+ *   import type { ZveltioSchema } from './zveltio-types';
+ *   const client = createZveltioClient<ZveltioSchema>({ baseUrl: '...' });
+ *   const { data } = await client.collection('products').list();
+ *   //          ^-- typed as your Products interface
+ *
+ * Usage without types (untyped, same as before):
+ *   const client = createZveltioClient({ baseUrl: '...' });
+ */
+export declare class ZveltioClient<Schema extends Record<string, any> = Record<string, any>> {
+    private baseUrl;
+    private headers;
+    constructor(config: ZveltioClientConfig);
+    private request;
+    get<T = any>(path: string): Promise<T>;
+    post<T = any>(path: string, body?: unknown): Promise<T>;
+    patch<T = any>(path: string, body?: unknown): Promise<T>;
+    delete<T = any>(path: string): Promise<T>;
+    upload<T = any>(path: string, formData: FormData): Promise<T>;
+    /**
+     * Returns a fully-typed collection reference.
+     * If Schema is provided (via createZveltioClient<MySchema>()),
+     * the return type reflects the collection's record shape.
+     */
+    collection<K extends keyof Schema & string>(name: K): CollectionRef<Schema[K]>;
+    collection(name: string): CollectionRef<Record<string, any>>;
+    /** Auth helpers */
+    readonly auth: {
+        readonly login: (email: string, password: string) => Promise<any>;
+        readonly signup: (email: string, password: string, name: string) => Promise<any>;
+        readonly logout: () => Promise<any>;
+        readonly session: () => Promise<any>;
+    };
+    /** Storage helpers */
+    readonly storage: {
+        readonly upload: (file: File, folder?: string) => Promise<any>;
+        readonly list: (folder?: string) => Promise<any>;
+        readonly delete: (key: string) => Promise<any>;
+    };
+}
+export declare function createZveltioClient<Schema extends Record<string, any> = Record<string, any>>(config: ZveltioClientConfig): ZveltioClient<Schema>;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,cAAM,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAE7C,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC;IAG7C,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAajD,OAAO,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAIpD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAI3B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9B,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,YAAY,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1F,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAGlD;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAa,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACjF,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAyB;gBAE5B,MAAM,EAAE,mBAAmB;YASzB,OAAO;IAcrB,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IACvD,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IACxD,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAEnC,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IAUnE;;;;OAIG;IACH,UAAU,CAAC,CAAC,SAAS,MAAM,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9E,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAK5D,mBAAmB;IACnB,QAAQ,CAAC,IAAI;gCACI,MAAM,YAAY,MAAM;iCAEvB,MAAM,YAAY,MAAM,QAAQ,MAAM;;;MAI7C;IAEX,sBAAsB;IACtB,QAAQ,CAAC,OAAO;gCACC,IAAI,WAAW,MAAM;iCAMpB,MAAM;+BACR,MAAM;MACX;CACZ;AAED,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1F,MAAM,EAAE,mBAAmB,GAC1B,aAAa,CAAC,MAAM,CAAC,CAEvB"}