tinbase 0.1.0

package/dist/node/native/wire.js

@@ -0,0 +1,345 @@
+/**
+ * Minimal Postgres wire-protocol (v3) client — enough for tinbase's needs:
+ * trust auth over a unix socket, simple + extended queries, typed decoding,
+ * LISTEN/NOTIFY. Pure Node, no dependencies.
+ */
+import { createConnection } from 'node:net';
+export class PgWireError extends Error {
+    code;
+    detail;
+    hint;
+    severity;
+    constructor(fields) {
+        super(fields.get('M') ?? 'postgres error');
+        this.code = fields.get('C');
+        this.detail = fields.get('D');
+        this.hint = fields.get('H');
+        this.severity = fields.get('S');
+    }
+}
+export class PgWireClient {
+    socket;
+    buffer = Buffer.alloc(0);
+    pending = null;
+    queue = Promise.resolve();
+    closed = false;
+    onNotification = null;
+    static async connect(opts) {
+        const client = new PgWireClient();
+        await client.open(opts);
+        return client;
+    }
+    open(opts) {
+        return new Promise((resolve, reject) => {
+            this.socket = opts.socketPath
+                ? createConnection(opts.socketPath)
+                : createConnection(opts.port ?? 5432, opts.host ?? '127.0.0.1');
+            this.socket.on('error', (e) => {
+                if (this.pending)
+                    this.pending.reject(e);
+                reject(e);
+            });
+            this.socket.on('close', () => {
+                this.closed = true;
+                this.pending?.reject(new Error('connection closed'));
+            });
+            this.socket.on('connect', () => {
+                // StartupMessage: length, protocol 196608, key/value pairs
+                const params = `user\0${opts.user}\0database\0${opts.database}\0client_encoding\0UTF8\0\0`;
+                const body = Buffer.from(params, 'utf8');
+                const msg = Buffer.alloc(8 + body.length);
+                msg.writeInt32BE(8 + body.length, 0);
+                msg.writeInt32BE(196608, 4);
+                body.copy(msg, 8);
+                this.socket.write(msg);
+            });
+            // Startup phase: consume until first ReadyForQuery
+            const startupHandler = (chunk) => {
+                this.buffer = Buffer.concat([this.buffer, chunk]);
+                let msg;
+                while ((msg = this.nextMessage()) !== null) {
+                    const [type, payload] = msg;
+                    if (type === 0x52) {
+                        // Authentication — only trust (code 0) supported
+                        const code = payload.readInt32BE(0);
+                        if (code !== 0) {
+                            reject(new Error(`unsupported auth method ${code} (tinbase native uses trust over unix socket)`));
+                            return;
+                        }
+                    }
+                    else if (type === 0x45) {
+                        reject(new PgWireError(parseErrorFields(payload)));
+                        return;
+                    }
+                    else if (type === 0x5a) {
+                        // ReadyForQuery
+                        this.socket.off('data', startupHandler);
+                        this.socket.on('data', (c) => {
+                            this.buffer = Buffer.concat([this.buffer, c]);
+                            this.processMessages();
+                        });
+                        resolve();
+                        return;
+                    }
+                    // ParameterStatus (S), BackendKeyData (K), NoticeResponse (N) — ignore
+                }
+            };
+            this.socket.on('data', startupHandler);
+        });
+    }
+    /** One protocol op at a time; queued to be safe under concurrency. */
+    run(send) {
+        const op = this.queue.then(() => new Promise((resolve, reject) => {
+            if (this.closed)
+                return reject(new Error('connection closed'));
+            this.pending = { resolve, reject, results: [], columns: [], error: null };
+            send();
+        }));
+        this.queue = op.catch(() => { });
+        return op;
+    }
+    /** Simple query protocol — supports multiple statements. */
+    async exec(sql) {
+        return this.run(() => this.socket.write(message(0x51, cstring(sql))));
+    }
+    /** Extended query protocol with text-format params. */
+    async query(sql, params = []) {
+        const results = await this.run(() => {
+            const parse = message(0x50, Buffer.concat([cstring(''), cstring(sql), int16(0)]));
+            const paramBufs = [int16(0), int16(params.length)];
+            for (const p of params) {
+                if (p === null || p === undefined) {
+                    paramBufs.push(int32(-1));
+                }
+                else {
+                    const b = Buffer.from(String(p), 'utf8');
+                    paramBufs.push(int32(b.length), b);
+                }
+            }
+            paramBufs.push(int16(0));
+            const bind = message(0x42, Buffer.concat([cstring(''), cstring(''), ...paramBufs]));
+            const describe = message(0x44, Buffer.concat([Buffer.from('P'), cstring('')]));
+            const execute = message(0x45, Buffer.concat([cstring(''), int32(0)]));
+            const sync = message(0x53, Buffer.alloc(0));
+            this.socket.write(Buffer.concat([parse, bind, describe, execute, sync]));
+        });
+        return (results[0] ?? { rows: [] });
+    }
+    close() {
+        return new Promise((resolve) => {
+            if (this.closed)
+                return resolve();
+            this.socket.write(message(0x58, Buffer.alloc(0))); // Terminate
+            this.socket.end(() => resolve());
+        });
+    }
+    // ── message pump ──────────────────────────────────────────────────────
+    nextMessage() {
+        if (this.buffer.length < 5)
+            return null;
+        const type = this.buffer[0];
+        const length = this.buffer.readInt32BE(1);
+        if (this.buffer.length < 1 + length)
+            return null;
+        const payload = this.buffer.subarray(5, 1 + length);
+        this.buffer = this.buffer.subarray(1 + length);
+        return [type, Buffer.from(payload)];
+    }
+    processMessages() {
+        let msg;
+        while ((msg = this.nextMessage()) !== null) {
+            const [type, payload] = msg;
+            const p = this.pending;
+            switch (type) {
+                case 0x54: {
+                    // RowDescription
+                    if (!p)
+                        break;
+                    const count = payload.readInt16BE(0);
+                    let off = 2;
+                    const columns = [];
+                    for (let i = 0; i < count; i++) {
+                        const end = payload.indexOf(0, off);
+                        const name = payload.toString('utf8', off, end);
+                        off = end + 1;
+                        const typeOid = payload.readInt32BE(off + 6);
+                        off += 18;
+                        columns.push({ name, typeOid });
+                    }
+                    p.columns = columns;
+                    break;
+                }
+                case 0x44: {
+                    // DataRow
+                    if (!p)
+                        break;
+                    const count = payload.readInt16BE(0);
+                    let off = 2;
+                    const row = {};
+                    for (let i = 0; i < count; i++) {
+                        const len = payload.readInt32BE(off);
+                        off += 4;
+                        let value = null;
+                        if (len >= 0) {
+                            value = decodeValue(payload.toString('utf8', off, off + len), p.columns[i]?.typeOid ?? 25);
+                            off += len;
+                        }
+                        row[p.columns[i]?.name ?? `col${i}`] = value;
+                    }
+                    if (p.results.length === 0)
+                        p.results.push({ rows: [] });
+                    p.results[p.results.length - 1].rows.push(row);
+                    break;
+                }
+                case 0x43: {
+                    // CommandComplete — tag like "INSERT 0 5" / "UPDATE 3" / "SELECT 2"
+                    if (!p)
+                        break;
+                    const tag = payload.toString('utf8', 0, payload.length - 1);
+                    const parts = tag.split(' ');
+                    const affected = parseInt(parts[parts.length - 1], 10);
+                    if (p.results.length === 0)
+                        p.results.push({ rows: [] });
+                    const current = p.results[p.results.length - 1];
+                    if (!Number.isNaN(affected))
+                        current.affectedRows = affected;
+                    // next statement in a multi-statement exec starts a fresh result
+                    p.results.push({ rows: [] });
+                    p.columns = [];
+                    break;
+                }
+                case 0x45: {
+                    // ErrorResponse — final resolution happens at ReadyForQuery
+                    if (p)
+                        p.error = new PgWireError(parseErrorFields(payload));
+                    break;
+                }
+                case 0x41: {
+                    // NotificationResponse
+                    payload.readInt32BE(0); // sender pid
+                    const channelEnd = payload.indexOf(0, 4);
+                    const channel = payload.toString('utf8', 4, channelEnd);
+                    const payloadEnd = payload.indexOf(0, channelEnd + 1);
+                    const body = payload.toString('utf8', channelEnd + 1, payloadEnd);
+                    this.onNotification?.(channel, body);
+                    break;
+                }
+                case 0x5a: {
+                    // ReadyForQuery — op finished
+                    if (!p)
+                        break;
+                    this.pending = null;
+                    if (p.error)
+                        p.reject(p.error);
+                    else {
+                        // drop the trailing empty result opened by the last CommandComplete
+                        const results = p.results.filter((r, i) => i < p.results.length - 1 || r.rows.length > 0 || r.affectedRows !== undefined);
+                        p.resolve(results.length > 0 ? results : [{ rows: [] }]);
+                    }
+                    break;
+                }
+                // ParseComplete (1), BindComplete (2), NoData (n), EmptyQueryResponse (I),
+                // NoticeResponse (N), ParameterStatus (S) — ignored
+            }
+        }
+    }
+}
+// ── helpers ───────────────────────────────────────────────────────────────
+function message(type, body) {
+    const out = Buffer.alloc(5 + body.length);
+    out[0] = type;
+    out.writeInt32BE(4 + body.length, 1);
+    body.copy(out, 5);
+    return out;
+}
+const cstring = (s) => Buffer.from(s + '\0', 'utf8');
+const int16 = (n) => {
+    const b = Buffer.alloc(2);
+    b.writeInt16BE(n);
+    return b;
+};
+const int32 = (n) => {
+    const b = Buffer.alloc(4);
+    b.writeInt32BE(n);
+    return b;
+};
+function parseErrorFields(payload) {
+    const fields = new Map();
+    let off = 0;
+    while (off < payload.length && payload[off] !== 0) {
+        const key = String.fromCharCode(payload[off]);
+        const end = payload.indexOf(0, off + 1);
+        fields.set(key, payload.toString('utf8', off + 1, end));
+        off = end + 1;
+    }
+    return fields;
+}
+/** Decode a text-format value by type OID to match PGlite's JS types. */
+function decodeValue(text, oid) {
+    switch (oid) {
+        case 16: // bool
+            return text === 't';
+        case 20: // int8
+        case 21: // int2
+        case 23: // int4
+        case 26: // oid
+            return Number(text);
+        case 700:
+        case 701: // float4/8
+            return Number(text);
+        case 114: // json
+        case 3802: // jsonb
+            return JSON.parse(text);
+        case 1114: // timestamp
+            return new Date(text.replace(' ', 'T') + 'Z');
+        case 1184: {
+            // timestamptz: "2026-07-05 14:00:00.1+00"
+            let iso = text.replace(' ', 'T');
+            if (/[+-]\d\d$/.test(iso))
+                iso += ':00';
+            return new Date(iso);
+        }
+        case 1000: // _bool
+            return parsePgArray(text).map((v) => v === 't');
+        case 1007: // _int4
+        case 1016: // _int8
+            return parsePgArray(text).map((v) => (v === null ? null : Number(v)));
+        case 1009: // _text
+        case 1015: // _varchar
+            return parsePgArray(text);
+        default:
+            return text;
+    }
+}
+/** Parse a one-dimensional Postgres array literal: {a,"b c",NULL} */
+export function parsePgArray(text) {
+    const out = [];
+    if (text.length < 2)
+        return out;
+    let i = 1;
+    while (i < text.length - 1) {
+        if (text[i] === ',') {
+            i++;
+            continue;
+        }
+        if (text[i] === '"') {
+            let value = '';
+            i++;
+            while (text[i] !== '"') {
+                if (text[i] === '\\')
+                    i++;
+                value += text[i++];
+            }
+            i++;
+            out.push(value);
+        }
+        else {
+            let value = '';
+            while (i < text.length - 1 && text[i] !== ',')
+                value += text[i++];
+            out.push(value === 'NULL' ? null : value);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=wire.js.map

package/dist/node/native/wire.js.map

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

package/dist/node/project.d.ts

@@ -0,0 +1,6 @@
+import type { MigrationFile } from '../types.js';
+export interface SupabaseProject {
+    migrations: MigrationFile[];
+    seedSql?: string;
+}
+export declare function loadSupabaseProject(projectDir: string): Promise<SupabaseProject>;

package/dist/node/project.js

@@ -0,0 +1,29 @@
+/** Loads migrations + seed following Supabase CLI conventions (supabase/ dir). */
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export async function loadSupabaseProject(projectDir) {
+    const migrationsDir = join(projectDir, 'supabase', 'migrations');
+    const migrations = [];
+    let entries = [];
+    try {
+        entries = await readdir(migrationsDir);
+    }
+    catch {
+        // no migrations directory — that's fine
+    }
+    for (const entry of entries.sort()) {
+        if (!entry.endsWith('.sql'))
+            continue;
+        const sql = await readFile(join(migrationsDir, entry), 'utf8');
+        migrations.push({ name: entry.replace(/\.sql$/, ''), sql });
+    }
+    let seedSql;
+    try {
+        seedSql = await readFile(join(projectDir, 'supabase', 'seed.sql'), 'utf8');
+    }
+    catch {
+        // no seed file
+    }
+    return { migrations, seedSql };
+}
+//# sourceMappingURL=project.js.map

package/dist/node/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/node/project.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAQhC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAkB;IAC1D,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,CAAC,CAAA;IAChE,MAAM,UAAU,GAAoB,EAAE,CAAA;IAEtC,IAAI,OAAO,GAAa,EAAE,CAAA;IAC1B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,SAAQ;QACrC,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAA;QAC9D,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED,IAAI,OAA2B,CAAA;IAC/B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAA;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAA;AAChC,CAAC"}

package/dist/node/server-shared.d.ts

@@ -0,0 +1,6 @@
+import type { RealtimeEngine } from '../realtime/engine.js';
+/** The slice of a backend that servers need — keeps bun/node servers decoupled. */
+export interface SupaliteBackendShape {
+    fetch: (req: Request) => Promise<Response>;
+    realtime: RealtimeEngine;
+}

package/dist/node/server-shared.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server-shared.js.map

package/dist/node/server-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-shared.js","sourceRoot":"","sources":["../../src/node/server-shared.ts"],"names":[],"mappings":""}

package/dist/node/server.d.ts

@@ -0,0 +1,14 @@
+/** Node HTTP wrapper: serves the backend's fetch handler and upgrades /realtime/v1 WebSockets. */
+import { type Server } from 'node:http';
+import type { TinbaseBackend } from '../index.js';
+export interface ServeOptions {
+    port?: number;
+    host?: string;
+}
+export interface RunningServer {
+    server: Server;
+    port: number;
+    url: string;
+    close: () => Promise<void>;
+}
+export declare function serve(backend: TinbaseBackend, opts?: ServeOptions): Promise<RunningServer>;

package/dist/node/server.js

@@ -0,0 +1,83 @@
+/** Node HTTP wrapper: serves the backend's fetch handler and upgrades /realtime/v1 WebSockets. */
+import { createServer } from 'node:http';
+import { acceptWebSocket } from './ws.js';
+export async function serve(backend, opts = {}) {
+    const host = opts.host ?? '127.0.0.1';
+    const server = createServer(async (req, res) => {
+        try {
+            const request = await toRequest(req, host);
+            const response = await backend.fetch(request);
+            await writeResponse(response, res);
+        }
+        catch (e) {
+            res.writeHead(500, { 'content-type': 'application/json' });
+            res.end(JSON.stringify({ message: e instanceof Error ? e.message : String(e) }));
+        }
+    });
+    server.on('upgrade', (req, socket, head) => {
+        const url = new URL(req.url ?? '/', `http://${req.headers.host ?? host}`);
+        if (!url.pathname.startsWith('/realtime/v1')) {
+            socket.write('HTTP/1.1 404 Not Found\r\n\r\n');
+            socket.destroy();
+            return;
+        }
+        const ws = acceptWebSocket(req, socket, head);
+        if (!ws)
+            return;
+        const session = backend.realtime.connect(ws, { vsn: url.searchParams.get('vsn') ?? '1.0.0' });
+        ws.onMessage = session.onMessage;
+        ws.onClose = session.onClose;
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(opts.port ?? 54321, host, () => resolve());
+    });
+    const address = server.address();
+    const port = typeof address === 'object' && address ? address.port : (opts.port ?? 54321);
+    return {
+        server,
+        port,
+        url: `http://${host}:${port}`,
+        close: () => new Promise((resolve, reject) => {
+            server.closeAllConnections?.();
+            server.close((err) => (err ? reject(err) : resolve()));
+        }),
+    };
+}
+async function toRequest(req, fallbackHost) {
+    const url = `http://${req.headers.host ?? fallbackHost}${req.url ?? '/'}`;
+    const method = req.method ?? 'GET';
+    const headers = new Headers();
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (value === undefined)
+            continue;
+        if (Array.isArray(value))
+            for (const v of value)
+                headers.append(key, v);
+        else
+            headers.set(key, value);
+    }
+    let body;
+    if (method !== 'GET' && method !== 'HEAD') {
+        const chunks = [];
+        for await (const chunk of req)
+            chunks.push(chunk);
+        body = Buffer.concat(chunks);
+    }
+    return new Request(url, { method, headers, body: body });
+}
+async function writeResponse(response, res) {
+    const headers = {};
+    response.headers.forEach((value, key) => {
+        headers[key] = value;
+    });
+    res.writeHead(response.status, headers);
+    if (response.body) {
+        const buf = Buffer.from(await response.arrayBuffer());
+        res.end(buf);
+    }
+    else {
+        res.end();
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/node/server.js.map

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

package/dist/node/ws.d.ts

@@ -0,0 +1,8 @@
+import type { IncomingMessage } from 'node:http';
+import type { Duplex } from 'node:stream';
+import type { RealtimeSocketLike } from '../realtime/engine.js';
+export interface WsConnection extends RealtimeSocketLike {
+    onMessage: ((data: string | Uint8Array) => void) | null;
+    onClose: (() => void) | null;
+}
+export declare function acceptWebSocket(req: IncomingMessage, socket: Duplex, head: Buffer): WsConnection | null;