turbine-orm 0.3.0

package/dist/serverless.d.ts

@@ -0,0 +1,162 @@
+/**
+ * @batadata/turbine/serverless — HTTP-based query driver for edge functions
+ *
+ * Use this driver when you cannot establish a direct TCP connection to Postgres
+ * (e.g., Vercel Edge Functions, Cloudflare Workers, Deno Deploy).
+ *
+ * It sends queries as JSON over HTTP to a Turbine query endpoint, which executes
+ * them against the actual database and returns typed results.
+ *
+ * NOTE: This is a scaffold. The server-side query endpoint does not exist yet.
+ * The HTTP protocol and response format are defined here and will be implemented
+ * on the server side in a future release.
+ *
+ * @example
+ * ```ts
+ * import { createServerlessClient } from '@batadata/turbine/serverless';
+ *
+ * const db = createServerlessClient({
+ *   endpoint: 'https://your-turbine-proxy.fly.dev/query',
+ *   authToken: process.env.TURBINE_AUTH_TOKEN!,
+ * });
+ *
+ * const result = await db.query('SELECT * FROM users WHERE id = $1', [1]);
+ * ```
+ */
+/** Configuration for the serverless HTTP driver */
+export interface ServerlessConfig {
+    /** URL of the Turbine query endpoint (e.g. https://proxy.example.com/query) */
+    endpoint: string;
+    /** Authentication token for the endpoint */
+    authToken: string;
+    /** Request timeout in milliseconds (default: 10000) */
+    timeout?: number;
+    /** Custom fetch implementation (defaults to global fetch) */
+    fetch?: typeof globalThis.fetch;
+    /** Custom headers to include with every request */
+    headers?: Record<string, string>;
+}
+/** A single SQL query to execute */
+export interface QueryRequest {
+    /** SQL query string with $1, $2, ... parameter placeholders */
+    sql: string;
+    /** Parameter values */
+    params?: unknown[];
+    /** Hint for the server about expected result shape */
+    mode?: 'rows' | 'one' | 'count' | 'void';
+}
+/** Batch of queries to execute in a single round-trip */
+export interface BatchRequest {
+    queries: QueryRequest[];
+    /** Whether to wrap the batch in a transaction */
+    transaction?: boolean;
+}
+/** Response from the query endpoint for a single query */
+export interface QueryResponse<T = Record<string, unknown>> {
+    /** Returned rows */
+    rows: T[];
+    /** Number of rows affected (for INSERT/UPDATE/DELETE) */
+    rowCount: number;
+    /** Column metadata */
+    fields?: Array<{
+        name: string;
+        dataTypeID: number;
+    }>;
+    /** Server-side execution time in milliseconds */
+    durationMs?: number;
+}
+/** Response from the query endpoint for a batch */
+export interface BatchResponse {
+    results: QueryResponse[];
+    /** Total server-side execution time in milliseconds */
+    totalDurationMs?: number;
+}
+/** Error response from the query endpoint */
+export interface QueryError {
+    error: string;
+    code?: string;
+    detail?: string;
+}
+/**
+ * HTTP-based Postgres query client for serverless/edge environments.
+ *
+ * Sends SQL queries as JSON POST requests to a Turbine query endpoint.
+ * Does not require a direct TCP connection to Postgres.
+ */
+export declare class ServerlessClient {
+    private readonly config;
+    private readonly fetchFn;
+    constructor(config: ServerlessConfig);
+    /**
+     * Execute a single SQL query.
+     *
+     * @param sql - SQL string with $1, $2, ... placeholders
+     * @param params - Parameter values
+     * @returns Query result with typed rows
+     *
+     * @example
+     * ```ts
+     * const result = await client.query<{ id: number; name: string }>(
+     *   'SELECT id, name FROM users WHERE org_id = $1',
+     *   [42]
+     * );
+     * console.log(result.rows);
+     * ```
+     */
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<QueryResponse<T>>;
+    /**
+     * Execute a single SQL query and return the first row, or null.
+     */
+    queryOne<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T | null>;
+    /**
+     * Execute a batch of queries in a single HTTP request.
+     * Optionally wraps them in a transaction.
+     *
+     * @param queries - Array of queries to execute
+     * @param options - Batch options
+     * @returns Array of results, one per query
+     *
+     * @example
+     * ```ts
+     * const results = await client.batch([
+     *   { sql: 'SELECT * FROM users WHERE id = $1', params: [1] },
+     *   { sql: 'SELECT COUNT(*) FROM posts WHERE user_id = $1', params: [1] },
+     * ], { transaction: true });
+     * ```
+     */
+    batch(queries: QueryRequest[], options?: {
+        transaction?: boolean;
+    }): Promise<BatchResponse>;
+    /**
+     * Tagged template helper for SQL queries.
+     *
+     * @example
+     * ```ts
+     * const users = await client.sql<{ id: number; name: string }>`
+     *   SELECT id, name FROM users WHERE org_id = ${orgId}
+     * `;
+     * ```
+     */
+    sql<T = Record<string, unknown>>(strings: TemplateStringsArray, ...values: unknown[]): Promise<T[]>;
+    private post;
+}
+/**
+ * Create a serverless Turbine client for edge/serverless environments.
+ *
+ * @param config - Endpoint URL and auth token
+ * @returns A ServerlessClient instance
+ *
+ * @example
+ * ```ts
+ * import { createServerlessClient } from '@batadata/turbine/serverless';
+ *
+ * const db = createServerlessClient({
+ *   endpoint: process.env.TURBINE_ENDPOINT!,
+ *   authToken: process.env.TURBINE_AUTH_TOKEN!,
+ * });
+ *
+ * const users = await db.sql`SELECT * FROM users LIMIT 10`;
+ * ```
+ */
+export declare function createServerlessClient(config: ServerlessConfig): ServerlessClient;
+//# sourceMappingURL=serverless.d.ts.map

package/dist/serverless.d.ts.map

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

package/dist/serverless.js

@@ -0,0 +1,195 @@
+/**
+ * @batadata/turbine/serverless — HTTP-based query driver for edge functions
+ *
+ * Use this driver when you cannot establish a direct TCP connection to Postgres
+ * (e.g., Vercel Edge Functions, Cloudflare Workers, Deno Deploy).
+ *
+ * It sends queries as JSON over HTTP to a Turbine query endpoint, which executes
+ * them against the actual database and returns typed results.
+ *
+ * NOTE: This is a scaffold. The server-side query endpoint does not exist yet.
+ * The HTTP protocol and response format are defined here and will be implemented
+ * on the server side in a future release.
+ *
+ * @example
+ * ```ts
+ * import { createServerlessClient } from '@batadata/turbine/serverless';
+ *
+ * const db = createServerlessClient({
+ *   endpoint: 'https://your-turbine-proxy.fly.dev/query',
+ *   authToken: process.env.TURBINE_AUTH_TOKEN!,
+ * });
+ *
+ * const result = await db.query('SELECT * FROM users WHERE id = $1', [1]);
+ * ```
+ */
+// ---------------------------------------------------------------------------
+// Serverless client
+// ---------------------------------------------------------------------------
+/**
+ * HTTP-based Postgres query client for serverless/edge environments.
+ *
+ * Sends SQL queries as JSON POST requests to a Turbine query endpoint.
+ * Does not require a direct TCP connection to Postgres.
+ */
+export class ServerlessClient {
+    config;
+    fetchFn;
+    constructor(config) {
+        if (!config.endpoint) {
+            throw new Error('[turbine/serverless] endpoint is required');
+        }
+        if (!config.authToken) {
+            throw new Error('[turbine/serverless] authToken is required');
+        }
+        this.config = {
+            ...config,
+            timeout: config.timeout ?? 10_000,
+        };
+        this.fetchFn = config.fetch ?? globalThis.fetch;
+    }
+    /**
+     * Execute a single SQL query.
+     *
+     * @param sql - SQL string with $1, $2, ... placeholders
+     * @param params - Parameter values
+     * @returns Query result with typed rows
+     *
+     * @example
+     * ```ts
+     * const result = await client.query<{ id: number; name: string }>(
+     *   'SELECT id, name FROM users WHERE org_id = $1',
+     *   [42]
+     * );
+     * console.log(result.rows);
+     * ```
+     */
+    async query(sql, params) {
+        const request = { sql, params, mode: 'rows' };
+        const response = await this.post('/query', request);
+        return response;
+    }
+    /**
+     * Execute a single SQL query and return the first row, or null.
+     */
+    async queryOne(sql, params) {
+        const request = { sql, params, mode: 'one' };
+        const response = await this.post('/query', request);
+        return response.rows[0] ?? null;
+    }
+    /**
+     * Execute a batch of queries in a single HTTP request.
+     * Optionally wraps them in a transaction.
+     *
+     * @param queries - Array of queries to execute
+     * @param options - Batch options
+     * @returns Array of results, one per query
+     *
+     * @example
+     * ```ts
+     * const results = await client.batch([
+     *   { sql: 'SELECT * FROM users WHERE id = $1', params: [1] },
+     *   { sql: 'SELECT COUNT(*) FROM posts WHERE user_id = $1', params: [1] },
+     * ], { transaction: true });
+     * ```
+     */
+    async batch(queries, options) {
+        const request = {
+            queries,
+            transaction: options?.transaction ?? false,
+        };
+        return this.post('/batch', request);
+    }
+    /**
+     * Tagged template helper for SQL queries.
+     *
+     * @example
+     * ```ts
+     * const users = await client.sql<{ id: number; name: string }>`
+     *   SELECT id, name FROM users WHERE org_id = ${orgId}
+     * `;
+     * ```
+     */
+    async sql(strings, ...values) {
+        let sqlStr = '';
+        strings.forEach((str, i) => {
+            sqlStr += str;
+            if (i < values.length) {
+                sqlStr += `$${i + 1}`;
+            }
+        });
+        const result = await this.query(sqlStr, values);
+        return result.rows;
+    }
+    // -------------------------------------------------------------------------
+    // Internal HTTP transport
+    // -------------------------------------------------------------------------
+    async post(path, body) {
+        const url = this.config.endpoint.replace(/\/$/, '') + path;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            const response = await this.fetchFn(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.config.authToken}`,
+                    'User-Agent': '@batadata/turbine-serverless',
+                    ...this.config.headers,
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorBody = await response.text();
+                let parsed;
+                try {
+                    parsed = JSON.parse(errorBody);
+                }
+                catch {
+                    // Not JSON
+                }
+                const message = parsed?.error ?? `HTTP ${response.status}: ${errorBody.slice(0, 200)}`;
+                const err = new Error(`[turbine/serverless] ${message}`);
+                err['status'] = response.status;
+                err['code'] = parsed?.code;
+                throw err;
+            }
+            return (await response.json());
+        }
+        catch (err) {
+            if (err instanceof DOMException && err.name === 'AbortError') {
+                throw new Error(`[turbine/serverless] Request timed out after ${this.config.timeout}ms`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory function
+// ---------------------------------------------------------------------------
+/**
+ * Create a serverless Turbine client for edge/serverless environments.
+ *
+ * @param config - Endpoint URL and auth token
+ * @returns A ServerlessClient instance
+ *
+ * @example
+ * ```ts
+ * import { createServerlessClient } from '@batadata/turbine/serverless';
+ *
+ * const db = createServerlessClient({
+ *   endpoint: process.env.TURBINE_ENDPOINT!,
+ *   authToken: process.env.TURBINE_AUTH_TOKEN!,
+ * });
+ *
+ * const users = await db.sql`SELECT * FROM users LIMIT 10`;
+ * ```
+ */
+export function createServerlessClient(config) {
+    return new ServerlessClient(config);
+}
+//# sourceMappingURL=serverless.js.map

package/dist/serverless.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @batadata/turbine — Generated entity types
+ *
+ * These types mirror the Postgres schema and would normally be auto-generated
+ * by `npx turbine generate` from your database schema or Rust entity definitions.
+ *
+ * Schema: turbine/sql/schema.sql
+ */
+export interface Organization {
+    id: number;
+    name: string;
+    slug: string;
+    plan: string;
+    createdAt: Date;
+}
+export interface User {
+    id: number;
+    orgId: number;
+    email: string;
+    name: string;
+    role: string;
+    avatarUrl: string | null;
+    lastLoginAt: Date | null;
+    createdAt: Date;
+}
+export interface Post {
+    id: number;
+    userId: number;
+    orgId: number;
+    title: string;
+    content: string;
+    published: boolean;
+    viewCount: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface Comment {
+    id: number;
+    postId: number;
+    userId: number;
+    body: string;
+    createdAt: Date;
+}
+export type OrganizationCreate = Omit<Organization, 'id' | 'createdAt'>;
+export type OrganizationUpdate = Partial<Omit<Organization, 'id' | 'createdAt'>>;
+export type UserCreate = Omit<User, 'id' | 'createdAt'>;
+export type UserUpdate = Partial<Omit<User, 'id' | 'createdAt'>>;
+export type PostCreate = Omit<Post, 'id' | 'createdAt' | 'updatedAt' | 'viewCount'>;
+export type PostUpdate = Partial<Omit<Post, 'id' | 'createdAt' | 'updatedAt'>>;
+export type CommentCreate = Omit<Comment, 'id' | 'createdAt'>;
+export type CommentUpdate = Partial<Omit<Comment, 'id' | 'createdAt'>>;
+/** User with their posts loaded */
+export interface UserWithPosts extends User {
+    posts: Post[];
+}
+/** User with posts and each post's comments */
+export interface UserWithPostsAndComments extends User {
+    posts: (Post & {
+        comments: Comment[];
+    })[];
+}
+/** Post with its comments loaded */
+export interface PostWithComments extends Post {
+    comments: Comment[];
+}
+/** Organization with all nested relations (full tree) */
+export interface OrgWithEverything extends Organization {
+    users: (User & {
+        posts: (Post & {
+            comments: Comment[];
+        })[];
+    })[];
+}
+/** Organization with users loaded */
+export interface OrgWithUsers extends Organization {
+    users: User[];
+}
+/** Maps camelCase field names to snake_case column names */
+export declare const COLUMN_MAP: Record<string, Record<string, string>>;
+/** Reverse map: snake_case column -> camelCase field */
+export declare function snakeToCamel(s: string): string;
+/** Forward map: camelCase field -> snake_case column */
+export declare function camelToSnake(s: string): string;
+export interface RelationDef {
+    type: 'hasMany' | 'hasOne' | 'belongsTo';
+    from: string;
+    to: string;
+    foreignKey: string;
+    referenceKey: string;
+}
+export declare const RELATIONS: Record<string, Record<string, RelationDef>>;
+export declare const DATE_COLUMNS: Record<string, Set<string>>;
+//# 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,126 @@
+/**
+ * @batadata/turbine — Generated entity types
+ *
+ * These types mirror the Postgres schema and would normally be auto-generated
+ * by `npx turbine generate` from your database schema or Rust entity definitions.
+ *
+ * Schema: turbine/sql/schema.sql
+ */
+// ---------------------------------------------------------------------------
+// Column-name mappings (camelCase <-> snake_case)
+// ---------------------------------------------------------------------------
+/** Maps camelCase field names to snake_case column names */
+export const COLUMN_MAP = {
+    organizations: {
+        id: 'id',
+        name: 'name',
+        slug: 'slug',
+        plan: 'plan',
+        createdAt: 'created_at',
+    },
+    users: {
+        id: 'id',
+        orgId: 'org_id',
+        email: 'email',
+        name: 'name',
+        role: 'role',
+        avatarUrl: 'avatar_url',
+        lastLoginAt: 'last_login_at',
+        createdAt: 'created_at',
+    },
+    posts: {
+        id: 'id',
+        userId: 'user_id',
+        orgId: 'org_id',
+        title: 'title',
+        content: 'content',
+        published: 'published',
+        viewCount: 'view_count',
+        createdAt: 'created_at',
+        updatedAt: 'updated_at',
+    },
+    comments: {
+        id: 'id',
+        postId: 'post_id',
+        userId: 'user_id',
+        body: 'body',
+        createdAt: 'created_at',
+    },
+};
+/** Reverse map: snake_case column -> camelCase field */
+export function snakeToCamel(s) {
+    return s.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+/** Forward map: camelCase field -> snake_case column */
+export function camelToSnake(s) {
+    return s.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+export const RELATIONS = {
+    organizations: {
+        users: {
+            type: 'hasMany',
+            from: 'organizations',
+            to: 'users',
+            foreignKey: 'org_id',
+            referenceKey: 'id',
+        },
+    },
+    users: {
+        organization: {
+            type: 'belongsTo',
+            from: 'users',
+            to: 'organizations',
+            foreignKey: 'org_id',
+            referenceKey: 'id',
+        },
+        posts: {
+            type: 'hasMany',
+            from: 'users',
+            to: 'posts',
+            foreignKey: 'user_id',
+            referenceKey: 'id',
+        },
+    },
+    posts: {
+        user: {
+            type: 'belongsTo',
+            from: 'posts',
+            to: 'users',
+            foreignKey: 'user_id',
+            referenceKey: 'id',
+        },
+        comments: {
+            type: 'hasMany',
+            from: 'posts',
+            to: 'comments',
+            foreignKey: 'post_id',
+            referenceKey: 'id',
+        },
+    },
+    comments: {
+        post: {
+            type: 'belongsTo',
+            from: 'comments',
+            to: 'posts',
+            foreignKey: 'post_id',
+            referenceKey: 'id',
+        },
+        user: {
+            type: 'belongsTo',
+            from: 'comments',
+            to: 'users',
+            foreignKey: 'user_id',
+            referenceKey: 'id',
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// Timestamp columns that need Date parsing
+// ---------------------------------------------------------------------------
+export const DATE_COLUMNS = {
+    organizations: new Set(['created_at']),
+    users: new Set(['last_login_at', 'created_at']),
+    posts: new Set(['created_at', 'updated_at']),
+    comments: new Set(['created_at']),
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "turbine-orm",
+  "version": "0.3.0",
+  "description": "TypeScript ORM with json_agg nested queries — 2-3x faster than Prisma, 1.5x faster than Drizzle",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./cli": {
+      "import": "./dist/cli/config.js",
+      "types": "./dist/cli/config.d.ts"
+    },
+    "./serverless": {
+      "import": "./dist/serverless.js",
+      "types": "./dist/serverless.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "turbine": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "!dist/test",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "generate": "tsx src/cli/index.ts generate",
+    "status": "tsx src/cli/index.ts status",
+    "examples": "tsx src/examples.ts",
+    "test": "node --test --experimental-strip-types src/test/*.test.ts"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "pg": "^8.13.1"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.11.11",
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0",
+    "tsx": "^4.19.0"
+  },
+  "keywords": [
+    "orm",
+    "postgres",
+    "postgresql",
+    "typescript",
+    "json-agg",
+    "query-builder",
+    "database",
+    "sql",
+    "turbine",
+    "batadata",
+    "nested-queries"
+  ],
+  "author": "ZVN DEV <dev@zvndev.com>",
+  "license": "MIT",
+  "homepage": "https://turbine.batadata.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zvndev/nexus-postgres",
+    "directory": "turbine/turbine-ts"
+  }
+}