@flxbl-dev/client 0.1.0

package/README.md

@@ -0,0 +1,177 @@
+# @flxbl-dev/client
+
+Lightweight, type-safe runtime SDK for [FLXBL](https://flxbl.dev). Zero dependencies — uses native `fetch`.
+
+This package is the **production dependency** your app ships with. The generated typed client (from `@flxbl-dev/cli`) extends `FlxblClient` with schema-specific collections and full autocomplete.
+
+## Install
+
+```bash
+npm install @flxbl-dev/client
+```
+
+## Quick Start
+
+Use the generated client from `@flxbl-dev/cli` for full type safety:
+
+```typescript
+import { createFlxblClient } from './flxbl/_generated';
+
+const db = createFlxblClient({
+  instanceUrl: 'https://api.flxbl.dev',
+  apiKey: process.env.FLXBL_API_KEY,
+});
+
+// Fully typed — autocomplete on fields, type-checked inputs
+const users = await db.users.findMany({ where: { role: 'admin' }, limit: 10 });
+const post = await db.posts.create({ title: 'Hello', content: '...', published: true });
+const user = await db.users.findById('abc123');
+await db.users.update('abc123', { role: 'user' });
+await db.users.delete('abc123');
+```
+
+Or use the base client directly for untyped access:
+
+```typescript
+import { FlxblClient } from '@flxbl-dev/client';
+
+const client = new FlxblClient({
+  instanceUrl: 'https://api.flxbl.dev',
+  apiKey: process.env.FLXBL_API_KEY,
+});
+
+// Raw request
+const users = await client.request('POST', '/api/v1/dynamic/User/query', {
+  where: { role: 'admin' },
+  limit: 10,
+});
+```
+
+## Configuration
+
+```typescript
+import { FlxblClient } from '@flxbl-dev/client';
+
+const client = new FlxblClient({
+  // Required
+  instanceUrl: 'https://api.flxbl.dev',
+
+  // Auth — provide one of:
+  apiKey: 'flxbl_abc123...',     // API key (recommended for server-side)
+  accessToken: 'eyJhbG...',     // JWT token (for browser/short-lived)
+
+  // Optional
+  fetch: customFetch,           // Custom fetch implementation
+});
+
+// You can also set the token dynamically
+client.setAccessToken('eyJhbG...');
+```
+
+## Collection Methods
+
+Each generated collection (e.g., `db.users`) provides:
+
+| Method | Description |
+|--------|-------------|
+| `findMany(options?)` | Query with filters, sorting, pagination, traversals |
+| `findById(id)` | Get a single record by ID |
+| `create(data)` | Create a new record |
+| `update(id, data)` | Partial update by ID |
+| `delete(id)` | Delete by ID |
+
+### Query Options
+
+```typescript
+const result = await db.users.findMany({
+  where: { isActive: true, role: { $in: ['admin', 'editor'] } },
+  select: ['id', 'email', 'role'],
+  orderBy: 'createdAt',
+  orderDirection: 'DESC',
+  offset: 0,
+  limit: 25,
+  includeCount: true,
+  traverse: [{ relationship: 'AUTHORED', direction: 'out', select: ['title'] }],
+});
+
+console.log(result.items);  // User[]
+console.log(result.count);  // total count (if includeCount: true)
+```
+
+### Filter Operators
+
+| Operator | Description |
+|----------|-------------|
+| `$eq` | Equals |
+| `$neq` | Not equals |
+| `$gt`, `$gte` | Greater than (or equal) |
+| `$lt`, `$lte` | Less than (or equal) |
+| `$in`, `$notIn` | Value in / not in array |
+| `$isNull` | Is null check |
+| `$contains` | String contains |
+| `$startsWith`, `$endsWith` | String prefix/suffix |
+| `$and`, `$or` | Logical operators |
+
+## GraphQL
+
+```typescript
+const { data, errors } = await client.graphql(
+  'tenant-id',
+  `query { users { id email } }`,
+  { /* variables */ },
+);
+```
+
+## Relationships
+
+```typescript
+const rels = client.relationships('User', 'user-123');
+
+// Create a relationship
+await rels.create('AUTHORED', 'post-456', { role: 'primary' });
+
+// List related entities
+const { items, count } = await rels.list('AUTHORED', 'out');
+
+// Delete a relationship
+await rels.delete('AUTHORED', 'post-456');
+```
+
+## Error Handling
+
+```typescript
+import { FlxblApiError, FlxblAuthError, FlxblValidationError } from '@flxbl-dev/client';
+
+try {
+  await db.users.create({ email: 'bad' });
+} catch (error) {
+  if (error instanceof FlxblAuthError) {
+    // 401 — re-authenticate
+  } else if (error instanceof FlxblValidationError) {
+    // 400 — check error.validationErrors
+  } else if (error instanceof FlxblApiError) {
+    // Generic API error — check error.statusCode
+  }
+}
+```
+
+## How It Works
+
+Under the hood, the client maps collection methods to FLXBL's Dynamic REST API:
+
+| Method | HTTP Request |
+|--------|-------------|
+| `db.users.findMany(opts)` | `POST /api/v1/dynamic/User/query` |
+| `db.users.findById(id)` | `GET /api/v1/dynamic/User/:id` |
+| `db.users.create(data)` | `POST /api/v1/dynamic/User` |
+| `db.users.update(id, data)` | `PATCH /api/v1/dynamic/User/:id` |
+| `db.users.delete(id)` | `DELETE /api/v1/dynamic/User/:id` |
+
+## Requirements
+
+- Node.js >= 18 (for native `fetch`)
+- A FLXBL instance with an active schema
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,47 @@
+/**
+ * FlxblClient — Base runtime client for FLXBL
+ *
+ * Zero dependencies. Uses native fetch.
+ * Generated TypedFlxblClient extends this with typed collections.
+ */
+import type { FlxblClientConfig, CollectionMethods } from './types.js';
+export declare class FlxblClient {
+    protected readonly instanceUrl: string;
+    private readonly apiKey?;
+    private accessToken?;
+    private readonly fetchFn;
+    constructor(config: FlxblClientConfig);
+    /** Set the access token dynamically (e.g., after login) */
+    setAccessToken(token: string): void;
+    private getAuthToken;
+    /** Low-level HTTP request method. Available for advanced usage. */
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    private toError;
+    /**
+     * Creates a typed collection for an entity.
+     * Used by generated code to wire entity-specific CRUD.
+     */
+    protected createCollection<T extends {
+        id: string;
+    }, TCreate, TUpdate>(entityName: string): CollectionMethods<T, TCreate, TUpdate>;
+    /** Execute a raw GraphQL query against the tenant's GraphQL endpoint */
+    graphql<T = Record<string, unknown>>(tenantId: string, query: string, variables?: Record<string, unknown>): Promise<{
+        data?: T;
+        errors?: Array<{
+            message: string;
+        }>;
+    }>;
+    /** Manage relationships between entities */
+    relationships(entityName: string, entityId: string): {
+        create: (relationshipName: string, targetId: string, properties?: Record<string, unknown>) => Promise<Record<string, unknown>>;
+        list: (relationshipName: string, direction?: "out" | "in" | "both") => Promise<{
+            items: Array<Record<string, unknown>>;
+            count: number;
+        }>;
+        delete: (relationshipName: string, targetId: string) => Promise<{
+            success: boolean;
+            message: string;
+        }>;
+    };
+}
+//# 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;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAA6B,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElG,qBAAa,WAAW;IACtB,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAE3B,MAAM,EAAE,iBAAiB;IAOrC,2DAA2D;IAC3D,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC,OAAO,CAAC,YAAY;IAMpB,mEAAmE;IAC7D,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAiD1E,OAAO,CAAC,OAAO;IAaf;;;OAGG;IACH,SAAS,CAAC,gBAAgB,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,EAAE,OAAO,EACnE,UAAU,EAAE,MAAM,GACjB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;IA+CzC,wEAAwE;IAClE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAO7D,4CAA4C;IAC5C,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;mCAK1B,MAAM,YACd,MAAM,eACH,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACnC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;iCAQf,MAAM,cACb,KAAK,GAAG,IAAI,GAAG,MAAM,KAC/B,OAAO,CAAC;YAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;mCAUhD,MAAM,YACd,MAAM,KACf,OAAO,CAAC;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;;CAKtD"}

package/dist/client.js

@@ -0,0 +1,164 @@
+/**
+ * FlxblClient — Base runtime client for FLXBL
+ *
+ * Zero dependencies. Uses native fetch.
+ * Generated TypedFlxblClient extends this with typed collections.
+ */
+import { FlxblApiError, FlxblAuthError, FlxblValidationError } from './errors.js';
+export class FlxblClient {
+    instanceUrl;
+    apiKey;
+    accessToken;
+    fetchFn;
+    constructor(config) {
+        this.instanceUrl = config.instanceUrl.replace(/\/$/, '');
+        this.apiKey = config.apiKey;
+        this.accessToken = config.accessToken;
+        this.fetchFn = config.fetch ?? globalThis.fetch;
+    }
+    /** Set the access token dynamically (e.g., after login) */
+    setAccessToken(token) {
+        this.accessToken = token;
+    }
+    getAuthToken() {
+        if (this.accessToken)
+            return this.accessToken;
+        if (this.apiKey)
+            return this.apiKey;
+        throw new FlxblAuthError();
+    }
+    /** Low-level HTTP request method. Available for advanced usage. */
+    async request(method, path, body) {
+        const token = this.getAuthToken();
+        const url = `${this.instanceUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${token}`,
+            Accept: 'application/json',
+        };
+        const options = { method, headers };
+        if (body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+            options.body = JSON.stringify(body);
+        }
+        let response;
+        try {
+            response = await this.fetchFn(url, options);
+        }
+        catch (error) {
+            throw new FlxblApiError(`Network error: ${error instanceof Error ? error.message : 'Unknown error'}`, 0);
+        }
+        // Handle text responses (e.g., GraphQL SDL)
+        const contentType = response.headers.get('content-type');
+        if (contentType?.includes('text/plain') || contentType?.includes('application/graphql')) {
+            if (!response.ok)
+                throw this.toError(response);
+            return (await response.text());
+        }
+        let data;
+        try {
+            data = await response.json();
+        }
+        catch {
+            if (!response.ok) {
+                throw new FlxblApiError(`API error: ${response.statusText}`, response.status);
+            }
+            return null;
+        }
+        if (!response.ok) {
+            throw this.toError(response, data);
+        }
+        return data;
+    }
+    toError(response, data) {
+        const status = response.status;
+        const message = data?.message || response.statusText;
+        if (status === 401)
+            return new FlxblAuthError(message);
+        if (status === 404)
+            return new FlxblApiError(message, 404);
+        if (status === 400) {
+            const errors = data?.errors;
+            return new FlxblValidationError(message, errors);
+        }
+        return new FlxblApiError(message, status, data);
+    }
+    /**
+     * Creates a typed collection for an entity.
+     * Used by generated code to wire entity-specific CRUD.
+     */
+    createCollection(entityName) {
+        const basePath = `/api/v1/dynamic/${entityName}`;
+        return {
+            findMany: async (options) => {
+                const body = {};
+                if (options?.where)
+                    body.where = options.where;
+                if (options?.select)
+                    body.select = options.select;
+                if (options?.orderBy)
+                    body.orderBy = options.orderBy;
+                if (options?.orderDirection)
+                    body.orderDirection = options.orderDirection;
+                if (options?.offset !== undefined)
+                    body.offset = options.offset;
+                if (options?.limit !== undefined)
+                    body.limit = options.limit;
+                if (options?.includeCount)
+                    body.includeCount = options.includeCount;
+                if (options?.traverse)
+                    body.traverse = options.traverse;
+                const response = await this.request('POST', `${basePath}/query`, body);
+                // Normalize backend response
+                if (Array.isArray(response)) {
+                    return { items: response };
+                }
+                const wrapped = response;
+                return {
+                    items: wrapped.data ?? [],
+                    count: wrapped.totalCount,
+                    hasMore: false,
+                };
+            },
+            findById: async (id) => {
+                return this.request('GET', `${basePath}/${id}`);
+            },
+            create: async (data) => {
+                return this.request('POST', basePath, data);
+            },
+            update: async (id, data) => {
+                return this.request('PATCH', `${basePath}/${id}`, data);
+            },
+            delete: async (id) => {
+                await this.request('DELETE', `${basePath}/${id}`);
+            },
+        };
+    }
+    /** Execute a raw GraphQL query against the tenant's GraphQL endpoint */
+    async graphql(tenantId, query, variables) {
+        return this.request(`POST`, `/api/v1/dynamic-gql/${tenantId}`, {
+            query,
+            variables,
+        });
+    }
+    /** Manage relationships between entities */
+    relationships(entityName, entityId) {
+        const basePath = `/api/v1/dynamic/${entityName}/${entityId}/relationships`;
+        return {
+            create: async (relationshipName, targetId, properties) => {
+                return this.request('POST', `${basePath}/${relationshipName}`, {
+                    targetId,
+                    properties,
+                });
+            },
+            list: async (relationshipName, direction = 'out') => {
+                const response = await this.request('GET', `${basePath}/${relationshipName}?direction=${direction}`);
+                const items = response.map((r) => r.target);
+                return { items, count: items.length };
+            },
+            delete: async (relationshipName, targetId) => {
+                return this.request('DELETE', `${basePath}/${relationshipName}/${targetId}`);
+            },
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,27 @@
+/**
+ * FLXBL Client Errors
+ *
+ * Lightweight error classes for the runtime SDK.
+ */
+export declare class FlxblApiError extends Error {
+    readonly statusCode: number;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, statusCode: number, details?: Record<string, unknown> | undefined);
+}
+export declare class FlxblAuthError extends FlxblApiError {
+    constructor(message?: string);
+}
+export declare class FlxblNotFoundError extends FlxblApiError {
+    constructor(entity: string, id: string);
+}
+export declare class FlxblValidationError extends FlxblApiError {
+    readonly validationErrors?: Array<{
+        field: string;
+        message: string;
+    }> | undefined;
+    constructor(message: string, validationErrors?: Array<{
+        field: string;
+        message: string;
+    }> | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,UAAU,EAAE,MAAM;aAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,qBAAa,cAAe,SAAQ,aAAa;gBACnC,OAAO,GAAE,MAAiE;CAIvF;AAED,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;CAIvC;AAED,qBAAa,oBAAqB,SAAQ,aAAa;aAGnC,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;gBAD5E,OAAO,EAAE,MAAM,EACC,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,YAAA;CAK/E"}

package/dist/errors.js

@@ -0,0 +1,36 @@
+/**
+ * FLXBL Client Errors
+ *
+ * Lightweight error classes for the runtime SDK.
+ */
+export class FlxblApiError extends Error {
+    statusCode;
+    details;
+    constructor(message, statusCode, details) {
+        super(message);
+        this.statusCode = statusCode;
+        this.details = details;
+        this.name = 'FlxblApiError';
+    }
+}
+export class FlxblAuthError extends FlxblApiError {
+    constructor(message = 'Not authenticated. Provide an API key or access token.') {
+        super(message, 401);
+        this.name = 'FlxblAuthError';
+    }
+}
+export class FlxblNotFoundError extends FlxblApiError {
+    constructor(entity, id) {
+        super(`${entity} with id "${id}" not found`, 404);
+        this.name = 'FlxblNotFoundError';
+    }
+}
+export class FlxblValidationError extends FlxblApiError {
+    validationErrors;
+    constructor(message, validationErrors) {
+        super(message, 400, validationErrors ? { validationErrors } : undefined);
+        this.validationErrors = validationErrors;
+        this.name = 'FlxblValidationError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAGpB;IACA;IAHlB,YACE,OAAe,EACC,UAAkB,EAClB,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,eAAU,GAAV,UAAU,CAAQ;QAClB,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,aAAa;IAC/C,YAAY,UAAkB,wDAAwD;QACpF,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,MAAc,EAAE,EAAU;QACpC,KAAK,CAAC,GAAG,MAAM,aAAa,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IAGnC;IAFlB,YACE,OAAe,EACC,gBAA4D;QAE5E,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAFzD,qBAAgB,GAAhB,gBAAgB,CAA4C;QAG5E,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { FlxblClient } from './client.js';
+export { FlxblApiError, FlxblAuthError, FlxblNotFoundError, FlxblValidationError } from './errors.js';
+export type { FlxblClientConfig, QueryFilter, QueryOptions, QueryResult, CollectionMethods, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtG,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { FlxblClient } from './client.js';
+export { FlxblApiError, FlxblAuthError, FlxblNotFoundError, FlxblValidationError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Runtime query types for @flxbl-dev/client
+ *
+ * These types power the generated TypedFlxblClient's CRUD operations.
+ */
+export interface FlxblClientConfig {
+    /** URL of the FLXBL instance (e.g., https://api.flxbl.dev) */
+    instanceUrl: string;
+    /** API key for authentication */
+    apiKey?: string;
+    /** Access token (JWT) for authentication */
+    accessToken?: string;
+    /** Custom fetch implementation (defaults to global fetch) */
+    fetch?: typeof fetch;
+}
+export interface QueryFilter {
+    $eq?: unknown;
+    $neq?: unknown;
+    $gt?: number | string;
+    $gte?: number | string;
+    $lt?: number | string;
+    $lte?: number | string;
+    $in?: unknown[];
+    $notIn?: unknown[];
+    $isNull?: boolean;
+    $contains?: string;
+    $startsWith?: string;
+    $endsWith?: string;
+    $and?: QueryFilter[];
+    $or?: QueryFilter[];
+}
+export interface QueryOptions<T> {
+    /** Filter conditions. Keys are field names of T. */
+    where?: {
+        [K in keyof T]?: T[K] | QueryFilter;
+    };
+    /** Fields to select (empty = all) */
+    select?: Array<keyof T & string>;
+    /** Order by field name */
+    orderBy?: keyof T & string;
+    /** Order direction */
+    orderDirection?: 'ASC' | 'DESC';
+    /** Number of items to skip */
+    offset?: number;
+    /** Maximum number of items to return */
+    limit?: number;
+    /** Include total count in response */
+    includeCount?: boolean;
+    /** Relationship traversals */
+    traverse?: Array<{
+        relationship: string;
+        direction?: 'out' | 'in' | 'both';
+        select?: string[];
+        where?: Record<string, unknown>;
+    }>;
+}
+export interface QueryResult<T> {
+    items: T[];
+    count?: number;
+    hasMore?: boolean;
+}
+export interface CollectionMethods<T, TCreate, TUpdate> {
+    /** Find multiple records matching query options */
+    findMany(options?: QueryOptions<T>): Promise<QueryResult<T>>;
+    /** Find a single record by ID */
+    findById(id: string): Promise<T>;
+    /** Create a new record */
+    create(data: TCreate): Promise<T>;
+    /** Update a record by ID (partial update) */
+    update(id: string, data: TUpdate): Promise<T>;
+    /** Delete a record by ID */
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Runtime query types for @flxbl-dev/client
+ *
+ * These types power the generated TypedFlxblClient's CRUD operations.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@flxbl-dev/client",
+  "version": "0.1.0",
+  "description": "Lightweight runtime SDK for FLXBL — zero dependencies, uses native fetch",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "flxbl",
+    "sdk",
+    "client",
+    "typescript",
+    "schema",
+    "api"
+  ],
+  "author": "FLXBL",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flxbl/flxbl-monolith.git",
+    "directory": "packages/client"
+  }
+}