@boltstore/client 0.5.2 → 0.6.1

package/README.md

@@ -1,8 +1,6 @@
 # @boltstore/client
 
-TypeScript SDK for Boltstore. Works in Bun, Node 18+, browsers, and React Native.
-
-**Zero external dependencies** (only `@boltstore/utils` for types).
+JavaScript/TypeScript SDK for Boltstore. Works in the browser, Node.js, and React Native.
 
 ## Installation
 
@@ -10,106 +8,110 @@ TypeScript SDK for Boltstore. Works in Bun, Node 18+, browsers, and React Native
 npm install @boltstore/client
 ```
 
-## Quick Start
+## Quick start
 
-```ts
-import { BoltstoreClient, login, listRecords } from "@boltstore/client";
+```typescript
+import { BoltStoreClient } from "@boltstore/client";
 
-const client = new BoltstoreClient({
-  url: "http://localhost:8090",
+const client = new BoltStoreClient({
+  url: "http://localhost:8080",
 });
 
-// Authenticate
-await login(client, {
-  email: "alice@example.com",
-  password: "secret123",
+// Collections
+const collections = await client.collections.list();
+
+// Records
+const records = await client.records.list("posts", {
+  filter: "status:eq:published",
+  sort: ["created_at:desc"],
+  pagination: { page: 1, perPage: 20 },
 });
 
-// Query records
-const todos = await listRecords(client, "todos", {
-  filter: "status = 'active'",
-  sort: "-created",
-  perPage: 50,
+const record = await client.records.create("posts", {
+  title: "Hello World",
+  content: "My first post",
 });
 
-console.log(todos.items);
-```
+const updated = await client.records.update("posts", record.id, {
+  title: "Updated title",
+});
 
-## Features
+await client.records.delete("posts", record.id);
 
-| Module | Description |
-|--------|-------------|
-| `client.ts` | Main client — auth state, request helpers, auto-refresh |
-| `auth.ts` | Login, register, refresh, logout, OAuth2 |
-| `records.ts` | CRUD operations, filtering, sorting, pagination |
-| `collections.ts` | Read/write collection schemas |
-| `realtime.ts` | WebSocket subscriptions, auto-reconnect |
-| `sync.ts` | Offline-first sync engine with conflict resolution |
-| `storage.ts` | File upload, download, presigned URLs |
-| `adapters/` | Platform adapters: Node/Bun, Web, React Native |
-| `typegen/` | CLI to generate TypeScript types from your schema |
+// Auth (Phase 2)
+const { token, user } = await client.auth.login({
+  email: "user@example.com",
+  password: "secret",
+});
 
-## Platform Adapters
+// Realtime (Phase 3)
+const unsubscribe = client.realtime.subscribe("posts", (event) => {
+  console.log("Change:", event);
+});
 
-```ts
-// Node / Bun (auto-detected)
-import { createNodeAdapter } from "@boltstore/client/adapters/node";
+// Sync (Phase 4)
+client.sync.start({ collections: ["posts"] });
+```
 
-// Browser
-import { createWebAdapter } from "@boltstore/client/adapters/web";
+## API
 
-// React Native
-import { createReactNativeAdapter } from "@boltstore/client/adapters/react-native";
+### Client
 
-// Or auto-detect
-import { autoDetectAdapter } from "@boltstore/client/adapters/web";
+```typescript
+const client = new BoltStoreClient({ url: string, token?: string });
+client.setToken(token: string);
+client.onTokenExpired(callback: () => Promise<string>);
 ```
 
-## Realtime Subscriptions
-
-```ts
-import { connectRealtime } from "@boltstore/client";
+### Collections
 
-const rt = connectRealtime(client);
+```typescript
+client.collections.list(): Promise<Collection[]>
+client.collections.get(name: string): Promise<Collection>
+```
 
-const unsub = rt.subscribe("table:app_123:todos", (event) => {
-  console.log(`${event.type}:`, event.record);
-});
+### Records
 
-// Later: unsub(); to stop receiving events
+```typescript
+client.records.list(collection: string, options?: QueryOptions): Promise<PaginatedResponse>
+client.records.get(collection: string, id: string): Promise<Record>
+client.records.create(collection: string, data: object): Promise<Record>
+client.records.update(collection: string, id: string, data: object): Promise<Record>
+client.records.delete(collection: string, id: string): Promise<void>
+client.records.count(collection: string, filter?: string): Promise<number>
 ```
 
-## Offline Sync
-
-```ts
-import { enableSync } from "@boltstore/client";
+### Query Options
+
+```typescript
+interface QueryOptions {
+  filter?: string;
+  sort?: string[];
+  page?: number;
+  perPage?: number;
+  cursor?: string;
+  limit?: number;
+  fields?: string[];
+  expand?: string[];
+  search?: string;
+}
+```
 
-const sync = enableSync(client, {
-  collections: ["todos", "notes"],
-  onConflict: (local, server, strategy) => {
-    // Custom conflict resolution
-    return server; // server-wins default
-  },
-});
+## Development
 
-// Track local changes
-sync.trackLocalChange({
-  rowId: "rec_123",
-  collection: "todos",
-  operation: "update",
-  field: "title",
-  newValue: "Updated offline",
-});
+```bash
+bun install
+bun run build    # compile TypeScript
+bun test         # run tests
+bun run dev      # watch mode
 ```
 
-## Type Generation
-
-Generate TypeScript types from your Boltstore schema:
+## Publishing
 
 ```bash
-boltstore typegen --url http://localhost:8090 --output types.ts
+npm publish
 ```
 
 ## License
 
-MIT
+MIT

package/dist/api/auth.d.ts

@@ -0,0 +1,17 @@
+import type { BoltstoreClient } from "../client";
+import type { UserProfile, TokenPair, OAuthProvider } from "../types";
+export declare function createAuthApi(client: BoltstoreClient): {
+    register: (email: string, password: string) => Promise<UserProfile>;
+    login: (email: string, password: string) => Promise<TokenPair>;
+    refresh: (refreshToken?: string) => Promise<TokenPair>;
+    autoRefresh: (thresholdSeconds?: number) => Promise<TokenPair | null>;
+    logout: () => Promise<void>;
+    me: () => Promise<UserProfile>;
+    updateProfile: (data: {
+        email?: string;
+        password?: string;
+    }) => Promise<UserProfile>;
+    oauthUrl: (provider: OAuthProvider, redirectUri: string) => Promise<string>;
+    oauthExchange: (provider: OAuthProvider, code: string, redirectUri: string) => Promise<TokenPair>;
+};
+//# sourceMappingURL=auth.d.ts.map

package/dist/api/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/api/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAItE,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe;sBAEzB,MAAM,YAAY,MAAM,KAAG,OAAO,CAAC,WAAW,CAAC;mBAKlD,MAAM,YAAY,MAAM,KAAG,OAAO,CAAC,SAAS,CAAC;6BAOnC,MAAM,KAAG,OAAO,CAAC,SAAS,CAAC;gDASd,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;kBASnD,OAAO,CAAC,IAAI,CAAC;cAMjB,OAAO,CAAC,WAAW,CAAC;0BAKN;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,WAAW,CAAC;yBAK7D,aAAa,eAAe,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;8BAQ/C,aAAa,QAAQ,MAAM,eAAe,MAAM,KAAG,OAAO,CAAC,SAAS,CAAC;EAUxG"}

package/dist/api/auth.js

@@ -0,0 +1,63 @@
+import { decodeJwtPayload } from "../jwt";
+import { BoltstoreError } from "../errors";
+export function createAuthApi(client) {
+    return {
+        register: async (email, password) => {
+            const res = await client.request("POST", client.dbPath("/auth/register"), { email, password });
+            return res.data;
+        },
+        login: async (email, password) => {
+            const res = await client.request("POST", client.dbPath("/auth/login"), { email, password });
+            client.setToken(res.data.accessToken);
+            client.setRefreshToken(res.data.refreshToken);
+            return res.data;
+        },
+        refresh: async (refreshToken) => {
+            const token = refreshToken || client.getRefreshToken();
+            if (!token)
+                throw new BoltstoreError(400, "MISSING_REFRESH_TOKEN", "No refresh token available.");
+            const res = await client.request("POST", client.dbPath("/auth/refresh"), { refreshToken: token });
+            client.setToken(res.data.accessToken);
+            client.setRefreshToken(res.data.refreshToken);
+            return res.data;
+        },
+        autoRefresh: async (thresholdSeconds = 60) => {
+            if (!client.getToken() || !client.getRefreshToken())
+                return null;
+            const payload = decodeJwtPayload(client.getToken());
+            if (!payload || !payload.exp)
+                return null;
+            const nowSec = Math.floor(Date.now() / 1000);
+            if (payload.exp - nowSec > thresholdSeconds)
+                return null;
+            return client.auth.refresh();
+        },
+        logout: async () => {
+            await client.request("POST", client.dbPath("/auth/logout"));
+            client.setToken(undefined);
+            client.setRefreshToken(undefined);
+        },
+        me: async () => {
+            const res = await client.request("GET", client.dbPath("/auth/me"));
+            return res.data;
+        },
+        updateProfile: async (data) => {
+            const res = await client.request("PATCH", client.dbPath("/auth/me"), data);
+            return res.data;
+        },
+        oauthUrl: async (provider, redirectUri) => {
+            const res = await client.request("GET", client.dbPath(`/auth/oauth/${provider}/url?redirect_uri=${encodeURIComponent(redirectUri)}`));
+            return res.data.url;
+        },
+        oauthExchange: async (provider, code, redirectUri) => {
+            const res = await client.request("POST", client.dbPath(`/auth/oauth/${provider}`), {
+                code,
+                redirect_uri: redirectUri,
+            });
+            client.setToken(res.data.accessToken);
+            client.setRefreshToken(res.data.refreshToken);
+            return res.data;
+        },
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/api/auth.js.map

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

package/dist/api/collections.d.ts

@@ -0,0 +1,7 @@
+import type { BoltstoreClient } from "../client";
+import type { CollectionInfo } from "@boltstore/utils";
+export declare function createCollectionsApi(client: BoltstoreClient): {
+    list: () => Promise<CollectionInfo[]>;
+    get: (name: string) => Promise<CollectionInfo>;
+};
+//# sourceMappingURL=collections.d.ts.map

package/dist/api/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/api/collections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe;gBAExC,OAAO,CAAC,cAAc,EAAE,CAAC;gBAKvB,MAAM,KAAG,OAAO,CAAC,cAAc,CAAC;EAKrD"}

package/dist/api/collections.js

@@ -0,0 +1,13 @@
+export function createCollectionsApi(client) {
+    return {
+        list: async () => {
+            const res = await client.request("GET", client.dbPath("/collections"));
+            return res.data ?? [];
+        },
+        get: async (name) => {
+            const res = await client.request("GET", client.dbPath(`/collections/${name}`));
+            return res.data;
+        },
+    };
+}
+//# sourceMappingURL=collections.js.map

package/dist/api/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/api/collections.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,oBAAoB,CAAC,MAAuB;IAC1D,OAAO;QACL,IAAI,EAAE,KAAK,IAA+B,EAAE;YAC1C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAmB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;YACzF,OAAO,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QACxB,CAAC;QAED,GAAG,EAAE,KAAK,EAAE,IAAY,EAA2B,EAAE;YACnD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAiB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,CAAC;YAC/F,OAAO,GAAG,CAAC,IAAK,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/api/health.d.ts

@@ -0,0 +1,6 @@
+import type { BoltstoreClient } from "../client";
+import type { HealthCheck } from "../types";
+export declare function createHealthApi(client: BoltstoreClient): {
+    check: () => Promise<HealthCheck>;
+};
+//# sourceMappingURL=health.d.ts.map

package/dist/api/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/api/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe;iBAElC,OAAO,CAAC,WAAW,CAAC;EAKxC"}

package/dist/api/health.js

@@ -0,0 +1,9 @@
+export function createHealthApi(client) {
+    return {
+        check: async () => {
+            const res = await client.request("GET", "/api/health");
+            return res.data ?? { status: "unknown", version: "", uptime: 0, timestamp: "" };
+        },
+    };
+}
+//# sourceMappingURL=health.js.map

package/dist/api/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/api/health.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,OAAO;QACL,KAAK,EAAE,KAAK,IAA0B,EAAE;YACtC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAc,KAAK,EAAE,aAAa,CAAC,CAAC;YACpE,OAAO,GAAG,CAAC,IAAI,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAClF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/api/records.d.ts

@@ -0,0 +1,16 @@
+import type { BoltstoreClient } from "../client";
+import type { BoltstoreRecord, ListOptions, BatchOperation, BatchResult } from "@boltstore/utils";
+import type { PaginateOptions, PaginatedResult } from "../types";
+export declare function createRecordsApi(client: BoltstoreClient): {
+    create: (collection: string, data: Record<string, unknown>) => Promise<BoltstoreRecord>;
+    list: (collection: string, options?: ListOptions) => Promise<BoltstoreRecord[]>;
+    get: (collection: string, id: string) => Promise<BoltstoreRecord>;
+    update: (collection: string, id: string, data: Record<string, unknown>) => Promise<BoltstoreRecord>;
+    delete: (collection: string, id: string) => Promise<void>;
+    count: (collection: string, filter?: Record<string, unknown>) => Promise<number>;
+    distinct: (collection: string, field: string) => Promise<unknown[]>;
+    batch: (collection: string, operations: BatchOperation[]) => Promise<BatchResult>;
+    paginate: (collection: string, options: PaginateOptions) => Promise<PaginatedResult<BoltstoreRecord>>;
+    listAll: (collection: string, options?: Omit<PaginateOptions, "page">) => Promise<BoltstoreRecord[]>;
+};
+//# sourceMappingURL=records.d.ts.map

package/dist/api/records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/api/records.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAgB,MAAM,kBAAkB,CAAC;AAChH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGjE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe;yBAEzB,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,eAAe,CAAC;uBAKlE,MAAM,YAAY,WAAW,KAAG,OAAO,CAAC,eAAe,EAAE,CAAC;sBAM3D,MAAM,MAAM,MAAM,KAAG,OAAO,CAAC,eAAe,CAAC;yBAK1C,MAAM,MAAM,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,eAAe,CAAC;yBAK5E,MAAM,MAAM,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;wBAInC,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAAC;2BAiBvD,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,EAAE,CAAC;wBAQ7C,MAAM,cAAc,cAAc,EAAE,KAAG,OAAO,CAAC,WAAW,CAAC;2BAKxD,MAAM,WAAW,eAAe,KAAG,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;0BA+B7E,MAAM,YAAY,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,KAAG,OAAO,CAAC,eAAe,EAAE,CAAC;EAiB3G"}

package/dist/api/records.js

@@ -0,0 +1,100 @@
+import { BoltstoreError } from "../errors";
+export function createRecordsApi(client) {
+    return {
+        create: async (collection, data) => {
+            const res = await client.request("POST", client.dbPath(`/collections/${collection}/records`), data);
+            return res.data;
+        },
+        list: async (collection, options) => {
+            const path = client.buildListPath(collection, options);
+            const res = await client.request("GET", path);
+            return res.data ?? [];
+        },
+        get: async (collection, id) => {
+            const res = await client.request("GET", client.dbPath(`/collections/${collection}/records/${id}`));
+            return res.data;
+        },
+        update: async (collection, id, data) => {
+            const res = await client.request("PATCH", client.dbPath(`/collections/${collection}/records/${id}`), data);
+            return res.data;
+        },
+        delete: async (collection, id) => {
+            await client.request("DELETE", client.dbPath(`/collections/${collection}/records/${id}`));
+        },
+        count: async (collection, filter) => {
+            const params = new URLSearchParams();
+            if (filter) {
+                for (const [k, v] of Object.entries(filter)) {
+                    if (v === null || v === undefined)
+                        continue;
+                    if (typeof v === "object" && !Array.isArray(v)) {
+                        throw new BoltstoreError(400, "INVALID_FILTER", `Filter value for "${k}" must be a scalar or array.`);
+                    }
+                    params.set(k, Array.isArray(v) ? v.join(",") : String(v));
+                }
+            }
+            const qs = params.toString();
+            const path = client.dbPath(`/collections/${collection}/records/count`) + (qs ? `?${qs}` : "");
+            const res = await client.request("GET", path);
+            return res.data?.count ?? 0;
+        },
+        distinct: async (collection, field) => {
+            const res = await client.request("GET", client.dbPath(`/collections/${collection}/records/distinct?field=${encodeURIComponent(field)}`));
+            return res.data?.values ?? [];
+        },
+        batch: async (collection, operations) => {
+            const res = await client.request("POST", client.dbPath(`/collections/${collection}/records/batch`), operations);
+            return res.data;
+        },
+        paginate: async (collection, options) => {
+            const perPage = options.perPage ?? 50;
+            const params = new URLSearchParams();
+            params.set("page", String(options.page));
+            params.set("per_page", String(perPage));
+            if (options.sort)
+                params.set("sort", options.sort);
+            if (options.direction)
+                params.set("direction", options.direction);
+            if (options.filter) {
+                for (const [k, v] of Object.entries(options.filter)) {
+                    if (v === null || v === undefined)
+                        continue;
+                    if (typeof v === "object" && !Array.isArray(v)) {
+                        throw new BoltstoreError(400, "INVALID_FILTER", `Filter value for "${k}" must be a scalar or array.`);
+                    }
+                    params.set(k, Array.isArray(v) ? v.join(",") : String(v));
+                }
+            }
+            const qs = params.toString();
+            const path = client.dbPath(`/collections/${collection}/records`) + (qs ? `?${qs}` : "");
+            const res = await client.request("GET", path);
+            const meta = res.meta ?? {};
+            return {
+                data: res.data ?? [],
+                meta: {
+                    page: meta.page ?? options.page,
+                    per_page: meta.per_page ?? perPage,
+                    total: meta.total ?? (res.data?.length ?? 0),
+                    total_pages: meta.total_pages ?? 1,
+                },
+            };
+        },
+        listAll: async (collection, options) => {
+            const perPage = options?.perPage ?? 100;
+            const maxPages = 1000;
+            const all = [];
+            let page = 1;
+            while (true) {
+                const result = await client.records.paginate(collection, { ...options, page, perPage });
+                all.push(...result.data);
+                if (page >= result.meta.total_pages)
+                    break;
+                if (page >= maxPages)
+                    throw new BoltstoreError(400, "TOO_MANY_PAGES", `listAll stopped after ${maxPages} pages.`);
+                page++;
+            }
+            return all;
+        },
+    };
+}
+//# sourceMappingURL=records.js.map

package/dist/api/records.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,38 @@
+import type { ApiResponse, BoltstoreRecord, ListOptions, QueryOptions } from "@boltstore/utils";
+import { BoltstoreError } from "./errors";
+import type { TypedCollection } from "./types";
+import type { HttpMethod, TokenPair, UserProfile, OAuthProvider, ClientConfig, HealthCheck, PaginatedResult, TypedRecord, TypedBatchOperation, PaginateOptions } from "./types";
+import { createAuthApi } from "./api/auth";
+import { createHealthApi } from "./api/health";
+import { createCollectionsApi } from "./api/collections";
+import { createRecordsApi } from "./api/records";
+export { BoltstoreError };
+export { TypedCollectionImpl } from "./typed-collection";
+export type { TypedCollection } from "./typed-collection";
+export type { TokenPair, UserProfile, OAuthProvider, ClientConfig, HealthCheck, PaginatedResult, PaginateOptions, TypedRecord, TypedBatchOperation, };
+export declare class BoltstoreClient {
+    private baseUrl;
+    private database;
+    private databaseId;
+    private token;
+    private refreshToken;
+    auth: ReturnType<typeof createAuthApi>;
+    health: ReturnType<typeof createHealthApi>;
+    collections: ReturnType<typeof createCollectionsApi>;
+    records: ReturnType<typeof createRecordsApi>;
+    constructor(config: ClientConfig);
+    collection<Fields = Record<string, unknown>>(name: string): TypedCollection<Fields>;
+    setToken(token: string | undefined): void;
+    getToken(): string | undefined;
+    setRefreshToken(token: string | undefined): void;
+    getRefreshToken(): string | undefined;
+    query(options: QueryOptions): Promise<{
+        data: BoltstoreRecord[];
+        meta: Record<string, unknown>;
+    }>;
+    request<T = unknown>(method: HttpMethod, path: string, body?: unknown, retries?: number): Promise<ApiResponse<T>>;
+    dbPath(path: string): string;
+    buildListPath(collection: string, options?: ListOptions): string;
+}
+export default BoltstoreClient;
+//# 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,OAAO,KAAK,EACV,WAAW,EAEX,eAAe,EACf,WAAW,EAGX,YAAY,EACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,eAAe,EAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EACV,SAAS,EACT,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,EACf,eAAe,EACf,WAAW,EACX,mBAAmB,GACpB,CAAC;AAEF,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,YAAY,CAAqB;IAEzC,IAAI,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IACvC,MAAM,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;IAC3C,WAAW,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IACrD,OAAO,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;gBAEjC,MAAM,EAAE,YAAY;IAwBhC,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC;IAInF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIzC,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIhD,eAAe,IAAI,MAAM,GAAG,SAAS;IAI/B,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,eAAe,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAKjG,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,SAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAkDlH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAM5B,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM;CAoBjE;AAED,eAAe,eAAe,CAAC"}