tinbase 0.1.0

package/dist/node/ws.js

@@ -0,0 +1,165 @@
+/**
+ * Minimal RFC 6455 WebSocket server on top of node:http upgrade events —
+ * enough for Phoenix-protocol JSON text frames, so no `ws` dependency.
+ */
+import { createHash } from 'node:crypto';
+const WS_GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';
+export function acceptWebSocket(req, socket, head) {
+    const key = req.headers['sec-websocket-key'];
+    if (!key || (req.headers.upgrade ?? '').toLowerCase() !== 'websocket') {
+        socket.write('HTTP/1.1 400 Bad Request\r\n\r\n');
+        socket.destroy();
+        return null;
+    }
+    const accept = createHash('sha1').update(key + WS_GUID).digest('base64');
+    socket.write('HTTP/1.1 101 Switching Protocols\r\n' +
+        'Upgrade: websocket\r\n' +
+        'Connection: Upgrade\r\n' +
+        `Sec-WebSocket-Accept: ${accept}\r\n` +
+        '\r\n');
+    let buffer = head.length > 0 ? Buffer.from(head) : Buffer.alloc(0);
+    let fragments = [];
+    let fragmentOpcode = 0;
+    let closed = false;
+    const conn = {
+        onMessage: null,
+        onClose: null,
+        send(data) {
+            if (closed)
+                return;
+            if (typeof data === 'string') {
+                socket.write(encodeFrame(0x1, Buffer.from(data, 'utf8')));
+            }
+            else {
+                socket.write(encodeFrame(0x2, Buffer.from(data)));
+            }
+        },
+        close(code = 1000, reason = '') {
+            if (closed)
+                return;
+            const payload = Buffer.alloc(2 + Buffer.byteLength(reason));
+            payload.writeUInt16BE(code, 0);
+            payload.write(reason, 2);
+            socket.write(encodeFrame(0x8, payload));
+            finish();
+        },
+    };
+    function finish() {
+        if (closed)
+            return;
+        closed = true;
+        socket.end();
+        conn.onClose?.();
+    }
+    function deliver(opcode, payload) {
+        if (opcode === 0x1)
+            conn.onMessage?.(payload.toString('utf8'));
+        else if (opcode === 0x2)
+            conn.onMessage?.(new Uint8Array(payload));
+    }
+    socket.on('data', (chunk) => {
+        buffer = Buffer.concat([buffer, chunk]);
+        processFrames();
+    });
+    socket.on('close', finish);
+    socket.on('error', finish);
+    function processFrames() {
+        while (true) {
+            const frame = decodeFrame(buffer);
+            if (!frame)
+                return;
+            buffer = buffer.subarray(frame.frameLength);
+            switch (frame.opcode) {
+                case 0x0: // continuation
+                    fragments.push(frame.payload);
+                    if (frame.fin) {
+                        const full = Buffer.concat(fragments);
+                        fragments = [];
+                        deliver(fragmentOpcode, full);
+                    }
+                    break;
+                case 0x1: // text
+                case 0x2: // binary
+                    if (frame.fin) {
+                        deliver(frame.opcode, frame.payload);
+                    }
+                    else {
+                        fragments = [frame.payload];
+                        fragmentOpcode = frame.opcode;
+                    }
+                    break;
+                case 0x8: // close
+                    if (!closed) {
+                        socket.write(encodeFrame(0x8, frame.payload.subarray(0, 2)));
+                    }
+                    finish();
+                    return;
+                case 0x9: // ping
+                    socket.write(encodeFrame(0xa, frame.payload));
+                    break;
+                case 0xa: // pong
+                    break;
+            }
+        }
+    }
+    return conn;
+}
+function decodeFrame(buf) {
+    if (buf.length < 2)
+        return null;
+    const fin = (buf[0] & 0x80) !== 0;
+    const opcode = buf[0] & 0x0f;
+    const masked = (buf[1] & 0x80) !== 0;
+    let payloadLength = buf[1] & 0x7f;
+    let offset = 2;
+    if (payloadLength === 126) {
+        if (buf.length < offset + 2)
+            return null;
+        payloadLength = buf.readUInt16BE(offset);
+        offset += 2;
+    }
+    else if (payloadLength === 127) {
+        if (buf.length < offset + 8)
+            return null;
+        const big = buf.readBigUInt64BE(offset);
+        if (big > BigInt(64 * 1024 * 1024))
+            throw new Error('frame too large');
+        payloadLength = Number(big);
+        offset += 8;
+    }
+    let maskKey = null;
+    if (masked) {
+        if (buf.length < offset + 4)
+            return null;
+        maskKey = buf.subarray(offset, offset + 4);
+        offset += 4;
+    }
+    if (buf.length < offset + payloadLength)
+        return null;
+    let payload = Buffer.from(buf.subarray(offset, offset + payloadLength));
+    if (maskKey) {
+        for (let i = 0; i < payload.length; i++)
+            payload[i] ^= maskKey[i % 4];
+    }
+    return { fin, opcode, payload, frameLength: offset + payloadLength };
+}
+function encodeFrame(opcode, payload) {
+    let header;
+    if (payload.length < 126) {
+        header = Buffer.from([0x80 | opcode, payload.length]);
+    }
+    else if (payload.length < 65536) {
+        header = Buffer.alloc(4);
+        header[0] = 0x80 | opcode;
+        header[1] = 126;
+        header.writeUInt16BE(payload.length, 2);
+    }
+    else {
+        header = Buffer.alloc(10);
+        header[0] = 0x80 | opcode;
+        header[1] = 127;
+        header.writeBigUInt64BE(BigInt(payload.length), 2);
+    }
+    return Buffer.concat([header, payload]);
+}
+//# sourceMappingURL=ws.js.map

package/dist/node/ws.js.map

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

package/dist/realtime/engine.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Realtime engine speaking the Phoenix-channel protocol that
+ * @supabase/realtime-js uses (vsn=1.0.0 JSON serialization): channel
+ * join/leave, heartbeat, broadcast, presence, and postgres_changes fed by
+ * the trigger-based CDC pipeline in the database layer.
+ *
+ * Transport-agnostic: sockets are anything with send()/close(), so the same
+ * engine works over Node WebSockets today and an in-process pair in the
+ * browser.
+ */
+import type { Database } from '../db/database.js';
+export interface RealtimeSocketLike {
+    send(data: string | Uint8Array): void;
+    close(code?: number, reason?: string): void;
+}
+export declare class RealtimeEngine {
+    private db;
+    private connections;
+    private bindingCounter;
+    private phxRefCounter;
+    /** topic → key → metas */
+    private presence;
+    private stopCdc;
+    constructor(db: Database);
+    start(): Promise<void>;
+    stop(): void;
+    /** Attach a socket. Returns callbacks the transport must wire up. */
+    connect(socket: RealtimeSocketLike, opts?: {
+        vsn?: string;
+    }): {
+        onMessage: (data: string | Uint8Array) => void;
+        onClose: () => void;
+    };
+    private send;
+    private reply;
+    private handleMessage;
+    private handleJoin;
+    private leaveChannel;
+    /**
+     * Phoenix binary serializer, kind 3 (userBroadcastPush):
+     * [3, joinRefLen, refLen, topicLen, eventLen, metaLen, encoding,
+     *  joinRef, ref, topic, event, meta, payloadBytes]
+     * encoding: 0 = raw binary payload, 1 = JSON payload
+     */
+    private handleBinary;
+    private handleBroadcast;
+    private handlePresence;
+    private broadcastToTopic;
+    private dispatchCdc;
+    private bindingMatches;
+}
+/** Evaluate a realtime filter string ("col=eq.value") against a row. */
+export declare function matchFilter(filter: string, row: Record<string, unknown>): boolean;

package/dist/realtime/engine.js

@@ -0,0 +1,437 @@
+export class RealtimeEngine {
+    db;
+    connections = new Set();
+    bindingCounter = 1;
+    phxRefCounter = 1;
+    /** topic → key → metas */
+    presence = new Map();
+    stopCdc = null;
+    constructor(db) {
+        this.db = db;
+    }
+    async start() {
+        if (this.stopCdc)
+            return;
+        this.stopCdc = await this.db.onCdcEvent((e) => this.dispatchCdc(e));
+    }
+    stop() {
+        this.stopCdc?.();
+        this.stopCdc = null;
+        for (const conn of this.connections)
+            conn.socket.close(1001, 'server shutting down');
+        this.connections.clear();
+    }
+    /** Attach a socket. Returns callbacks the transport must wire up. */
+    connect(socket, opts = {}) {
+        const conn = { socket, channels: new Map(), vsn: opts.vsn ?? '1.0.0' };
+        this.connections.add(conn);
+        return {
+            onMessage: (data) => {
+                void this.handleMessage(conn, data);
+            },
+            onClose: () => {
+                for (const topic of conn.channels.keys())
+                    this.leaveChannel(conn, topic);
+                this.connections.delete(conn);
+            },
+        };
+    }
+    send(conn, msg) {
+        try {
+            const encoded = conn.vsn === '2.0.0'
+                ? JSON.stringify([msg.join_ref ?? null, msg.ref ?? null, msg.topic, msg.event, msg.payload])
+                : JSON.stringify(msg);
+            conn.socket.send(encoded);
+        }
+        catch {
+            // transport already closed
+        }
+    }
+    reply(conn, orig, status, response) {
+        this.send(conn, {
+            topic: orig.topic,
+            event: 'phx_reply',
+            payload: { status, response },
+            ref: orig.ref,
+            join_ref: orig.join_ref ?? null,
+        });
+    }
+    async handleMessage(conn, data) {
+        if (typeof data !== 'string') {
+            this.handleBinary(conn, data);
+            return;
+        }
+        let msg;
+        try {
+            const parsed = JSON.parse(data);
+            if (Array.isArray(parsed)) {
+                // Phoenix v2 serializer: [join_ref, ref, topic, event, payload]
+                const [join_ref, ref, topic, event, payload] = parsed;
+                msg = { join_ref, ref, topic, event, payload };
+            }
+            else {
+                msg = parsed;
+            }
+        }
+        catch {
+            return;
+        }
+        if (msg.topic === 'phoenix' && msg.event === 'heartbeat') {
+            this.reply(conn, msg, 'ok', {});
+            return;
+        }
+        switch (msg.event) {
+            case 'phx_join':
+                await this.handleJoin(conn, msg);
+                break;
+            case 'phx_leave':
+                this.leaveChannel(conn, msg.topic);
+                this.reply(conn, msg, 'ok', {});
+                break;
+            case 'broadcast':
+                this.handleBroadcast(conn, msg);
+                break;
+            case 'presence':
+                this.handlePresence(conn, msg);
+                break;
+            case 'access_token':
+                // token refresh — nothing to re-validate in this single-tenant setup
+                break;
+            default:
+                break;
+        }
+    }
+    async handleJoin(conn, msg) {
+        const config = (msg.payload?.config ?? {});
+        const bindings = [];
+        for (const spec of config.postgres_changes ?? []) {
+            const binding = {
+                id: this.bindingCounter++,
+                event: (spec.event ?? '*').toUpperCase(),
+                schema: spec.schema ?? 'public',
+                table: spec.table ?? '*',
+                filter: spec.filter,
+            };
+            bindings.push(binding);
+            if (binding.table !== '*') {
+                try {
+                    await this.db.ensureCdcTrigger(binding.schema, binding.table);
+                }
+                catch {
+                    this.reply(conn, msg, 'error', {
+                        reason: `unable to subscribe to changes on ${binding.schema}.${binding.table}`,
+                    });
+                    return;
+                }
+            }
+            else {
+                // wildcard table: attach triggers to every table currently in the schema
+                const info = await this.db.getSchemaInfo(binding.schema);
+                for (const table of info.tables.keys()) {
+                    await this.db.ensureCdcTrigger(binding.schema, table).catch(() => { });
+                }
+            }
+        }
+        const channel = {
+            topic: msg.topic,
+            joinRef: msg.join_ref ?? msg.ref ?? null,
+            bindings,
+            broadcastSelf: config.broadcast?.self ?? false,
+            broadcastAck: config.broadcast?.ack ?? false,
+            presenceKey: config.presence?.key || crypto.randomUUID(),
+            presenceEnabled: config.presence?.enabled ?? true,
+        };
+        conn.channels.set(msg.topic, channel);
+        this.reply(conn, msg, 'ok', {
+            postgres_changes: bindings.map((b) => ({
+                id: b.id,
+                event: b.event,
+                schema: b.schema,
+                table: b.table,
+                ...(b.filter ? { filter: b.filter } : {}),
+            })),
+        });
+        // initial presence snapshot
+        const state = this.presence.get(msg.topic);
+        this.send(conn, {
+            topic: msg.topic,
+            event: 'presence_state',
+            payload: state ? Object.fromEntries(state) : {},
+            ref: null,
+        });
+        // postgres_changes readiness signal (realtime-js listens for this)
+        if (bindings.length > 0) {
+            this.send(conn, {
+                topic: msg.topic,
+                event: 'system',
+                payload: {
+                    status: 'ok',
+                    extension: 'postgres_changes',
+                    message: 'Subscribed to PostgreSQL',
+                    channel: msg.topic.replace(/^realtime:/, ''),
+                },
+                ref: null,
+            });
+        }
+    }
+    leaveChannel(conn, topic) {
+        const channel = conn.channels.get(topic);
+        if (!channel)
+            return;
+        conn.channels.delete(topic);
+        // presence leave
+        const state = this.presence.get(topic);
+        if (state?.has(channel.presenceKey)) {
+            const metas = state.get(channel.presenceKey);
+            state.delete(channel.presenceKey);
+            if (state.size === 0)
+                this.presence.delete(topic);
+            this.broadcastToTopic(topic, {
+                topic,
+                event: 'presence_diff',
+                payload: { joins: {}, leaves: { [channel.presenceKey]: metas } },
+                ref: null,
+            });
+        }
+    }
+    /**
+     * Phoenix binary serializer, kind 3 (userBroadcastPush):
+     * [3, joinRefLen, refLen, topicLen, eventLen, metaLen, encoding,
+     *  joinRef, ref, topic, event, meta, payloadBytes]
+     * encoding: 0 = raw binary payload, 1 = JSON payload
+     */
+    handleBinary(conn, bytes) {
+        if (bytes.length < 7 || bytes[0] !== 3)
+            return;
+        const [, joinRefLen, refLen, topicLen, eventLen, metaLen, encoding] = bytes;
+        let offset = 7;
+        const decoder = new TextDecoder();
+        const read = (len) => {
+            const out = decoder.decode(bytes.subarray(offset, offset + len));
+            offset += len;
+            return out;
+        };
+        const joinRef = read(joinRefLen);
+        const ref = read(refLen);
+        const topic = read(topicLen);
+        const userEvent = read(eventLen);
+        read(metaLen); // metadata — not relayed
+        const payloadBytes = bytes.subarray(offset);
+        const payload = {
+            type: 'broadcast',
+            event: userEvent,
+            payload: encoding === 1 ? safeJsonParse(decoder.decode(payloadBytes)) : payloadBytes,
+        };
+        this.handleBroadcast(conn, {
+            topic,
+            event: 'broadcast',
+            payload,
+            ref: ref || null,
+            join_ref: joinRef || null,
+        });
+    }
+    handleBroadcast(conn, msg) {
+        const sender = conn.channels.get(msg.topic);
+        if (!sender)
+            return;
+        const userPayload = msg.payload.payload;
+        const binaryFrame = userPayload instanceof Uint8Array
+            ? encodeUserBroadcast(msg.topic, String(msg.payload.event ?? ''), userPayload)
+            : null;
+        for (const other of this.connections) {
+            const channel = other.channels.get(msg.topic);
+            if (!channel)
+                continue;
+            if (other === conn && !sender.broadcastSelf)
+                continue;
+            if (binaryFrame) {
+                try {
+                    other.socket.send(binaryFrame);
+                }
+                catch {
+                    // transport already closed
+                }
+            }
+            else {
+                this.send(other, { topic: msg.topic, event: 'broadcast', payload: msg.payload, ref: null });
+            }
+        }
+        if (sender.broadcastAck && msg.ref)
+            this.reply(conn, msg, 'ok', {});
+    }
+    handlePresence(conn, msg) {
+        const channel = conn.channels.get(msg.topic);
+        if (!channel)
+            return;
+        const event = String((msg.payload?.event ?? '')).toLowerCase();
+        if (event === 'track') {
+            const meta = {
+                ...(msg.payload?.payload ?? {}),
+                phx_ref: `F${this.phxRefCounter++}`,
+            };
+            let state = this.presence.get(msg.topic);
+            if (!state) {
+                state = new Map();
+                this.presence.set(msg.topic, state);
+            }
+            const previous = state.get(channel.presenceKey);
+            state.set(channel.presenceKey, { metas: [meta] });
+            this.broadcastToTopic(msg.topic, {
+                topic: msg.topic,
+                event: 'presence_diff',
+                payload: {
+                    joins: { [channel.presenceKey]: { metas: [meta] } },
+                    leaves: previous ? { [channel.presenceKey]: previous } : {},
+                },
+                ref: null,
+            });
+            if (msg.ref)
+                this.reply(conn, msg, 'ok', {});
+            return;
+        }
+        if (event === 'untrack') {
+            const state = this.presence.get(msg.topic);
+            const metas = state?.get(channel.presenceKey);
+            if (state && metas) {
+                state.delete(channel.presenceKey);
+                if (state.size === 0)
+                    this.presence.delete(msg.topic);
+                this.broadcastToTopic(msg.topic, {
+                    topic: msg.topic,
+                    event: 'presence_diff',
+                    payload: { joins: {}, leaves: { [channel.presenceKey]: metas } },
+                    ref: null,
+                });
+            }
+            if (msg.ref)
+                this.reply(conn, msg, 'ok', {});
+        }
+    }
+    broadcastToTopic(topic, msg) {
+        for (const conn of this.connections) {
+            if (conn.channels.has(topic))
+                this.send(conn, msg);
+        }
+    }
+    // ── postgres_changes fan-out ──────────────────────────────────────────
+    async dispatchCdc(event) {
+        // column metadata lets realtime-js run its type conversion
+        let columns = [];
+        try {
+            const info = await this.db.getSchemaInfo(event.schema);
+            columns = (info.tables.get(event.table)?.columns ?? []).map((c) => ({
+                name: c.name,
+                type: c.udtName,
+            }));
+        }
+        catch {
+            // schema went away — still deliver the event without columns
+        }
+        for (const conn of this.connections) {
+            for (const channel of conn.channels.values()) {
+                const ids = channel.bindings
+                    .filter((b) => this.bindingMatches(b, event))
+                    .map((b) => b.id);
+                if (ids.length === 0)
+                    continue;
+                this.send(conn, {
+                    topic: channel.topic,
+                    event: 'postgres_changes',
+                    payload: {
+                        ids,
+                        data: {
+                            schema: event.schema,
+                            table: event.table,
+                            commit_timestamp: event.commit_timestamp,
+                            eventType: event.type,
+                            type: event.type,
+                            columns,
+                            record: event.record ?? {},
+                            old_record: event.old_record ?? {},
+                            errors: event.errors ?? null,
+                        },
+                    },
+                    ref: null,
+                });
+            }
+        }
+    }
+    bindingMatches(b, e) {
+        if (b.schema !== '*' && b.schema !== e.schema)
+            return false;
+        if (b.table !== '*' && b.table !== e.table)
+            return false;
+        if (b.event !== '*' && b.event !== e.type)
+            return false;
+        if (b.filter) {
+            const row = e.type === 'DELETE' ? e.old_record : e.record;
+            if (!row || !matchFilter(b.filter, row))
+                return false;
+        }
+        return true;
+    }
+}
+/** Evaluate a realtime filter string ("col=eq.value") against a row. */
+export function matchFilter(filter, row) {
+    const m = filter.match(/^([^=]+)=(eq|neq|lt|lte|gt|gte|in)\.(.*)$/s);
+    if (!m)
+        return false;
+    const [, column, op, rawValue] = m;
+    const actual = row[column.trim()];
+    if (op === 'in') {
+        const list = rawValue.replace(/^\(/, '').replace(/\)$/, '').split(',').map((s) => s.trim());
+        return list.some((v) => looseEquals(actual, v));
+    }
+    if (op === 'eq')
+        return looseEquals(actual, rawValue);
+    if (op === 'neq')
+        return !looseEquals(actual, rawValue);
+    const a = Number(actual);
+    const b = Number(rawValue);
+    if (Number.isNaN(a) || Number.isNaN(b))
+        return false;
+    switch (op) {
+        case 'lt':
+            return a < b;
+        case 'lte':
+            return a <= b;
+        case 'gt':
+            return a > b;
+        case 'gte':
+            return a >= b;
+    }
+    return false;
+}
+function looseEquals(actual, expected) {
+    if (actual === null || actual === undefined)
+        return expected === 'null';
+    return String(actual) === expected;
+}
+function safeJsonParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Phoenix binary serializer, kind 4 (userBroadcast):
+ * [4, topicLen, eventLen, metaLen, encoding, topic, event, meta, payloadBytes]
+ */
+function encodeUserBroadcast(topic, event, payload) {
+    const enc = new TextEncoder();
+    const topicBytes = enc.encode(topic);
+    const eventBytes = enc.encode(event);
+    const out = new Uint8Array(5 + topicBytes.length + eventBytes.length + payload.length);
+    out[0] = 4;
+    out[1] = topicBytes.length;
+    out[2] = eventBytes.length;
+    out[3] = 0;
+    out[4] = 0;
+    out.set(topicBytes, 5);
+    out.set(eventBytes, 5 + topicBytes.length);
+    out.set(payload, 5 + topicBytes.length + eventBytes.length);
+    return out;
+}
+//# sourceMappingURL=engine.js.map