@hugomrdias/foxer-client 0.0.1

package/README.md

@@ -0,0 +1,52 @@
+# foxer-client
+
+`foxer-client` provides a typed Drizzle-compatible client for querying `foxer` SQL endpoints, including live updates over SSE.
+
+## Features
+
+- Typed remote Drizzle client via `createClient`.
+- Query compilation helper with `compileQuery`.
+- Live query subscriptions using Server-Sent Events.
+- Works with schema + relations for end-to-end type safety.
+
+## Install
+
+```bash
+npm install foxer-client viem
+```
+
+## Entrypoint
+
+- Package root: `foxer-client`
+- Main export: `createClient`
+
+## Usage
+
+```ts
+import { createClient } from 'foxer-client'
+import { schema, relations } from './schema'
+
+const client = createClient({
+  baseUrl: 'http://localhost:4200/sql',
+  schema,
+  relations,
+})
+
+const rows = await client.db.query.sessionKeys.findMany({
+  limit: 10,
+  orderBy: { blockNumber: 'desc' },
+})
+
+const { unsubscribe } = client.live(
+  (db) => db.query.sessionKeys.findMany({ limit: 10 }),
+  (data) => {
+    console.log('live rows', data)
+  },
+  (error) => {
+    console.error(error)
+  }
+)
+
+// later
+unsubscribe()
+```

package/dist/src/index.d.ts

@@ -0,0 +1,18 @@
+import { type AnyRelations, type EmptyRelations, type QueryWithTypings, type SQLWrapper } from 'drizzle-orm';
+import { type PgRemoteDatabase } from 'drizzle-orm/pg-proxy';
+import type { Simplify } from 'type-fest';
+export declare const compileQuery: (query: SQLWrapper) => QueryWithTypings;
+type ClientDb<TSchema extends Record<string, unknown> = Record<string, unknown>, TRelations extends AnyRelations = EmptyRelations> = Simplify<Omit<PgRemoteDatabase<TSchema, TRelations>, 'insert' | 'update' | 'delete' | 'transaction' | 'refreshMaterializedView' | '_query'>>;
+export type Client<TSchema extends Record<string, unknown> = Record<string, unknown>, TRelations extends AnyRelations = EmptyRelations> = {
+    db: ClientDb<TSchema, TRelations>;
+    live: <result>(queryFn: (db: ClientDb<TSchema, TRelations>) => Promise<result>, onData: (result: result) => void, onError?: (error: Error) => void) => {
+        unsubscribe: () => void;
+    };
+};
+export declare function createClient<TSchema extends Record<string, unknown> = Record<string, unknown>, TRelations extends AnyRelations = EmptyRelations>({ baseUrl, relations, schema, }: {
+    baseUrl: string;
+    relations: TRelations;
+    schema: TSchema;
+}): Client<TSchema, TRelations>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,cAAc,EAGnB,KAAK,gBAAgB,EAGrB,KAAK,UAAU,EAEhB,MAAM,aAAa,CAAA;AAIpB,OAAO,EAAW,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAGrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAoDzC,eAAO,MAAM,YAAY,GAAI,OAAO,UAAU,qBAE7C,CAAA;AAED,KAAK,QAAQ,CACX,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,UAAU,SAAS,YAAY,GAAG,cAAc,IAC9C,QAAQ,CACV,IAAI,CACF,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAC,EACnC,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,yBAAyB,GACzB,QAAQ,CACX,CACF,CAAA;AAED,MAAM,MAAM,MAAM,CAChB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,UAAU,SAAS,YAAY,GAAG,cAAc,IAC9C;IACF,EAAE,EAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;IAEjC,IAAI,EAAE,CAAC,MAAM,EACX,OAAO,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,EAC/D,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KAC7B;QACH,WAAW,EAAE,MAAM,IAAI,CAAA;KACxB,CAAA;CACF,CAAA;AAED,wBAAgB,YAAY,CAC1B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,UAAU,SAAS,YAAY,GAAG,cAAc,EAChD,EACA,OAAO,EACP,SAAS,EACT,MAAM,GACP,EAAE;IACD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,UAAU,CAAA;IACrB,MAAM,EAAE,OAAO,CAAA;CAChB,GAAG,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAsI9B"}

package/dist/src/index.js

@@ -0,0 +1,151 @@
+import { Column, is, mapRelationalRow, SQL, Table, } from 'drizzle-orm';
+import { PgRelationalQuery } from 'drizzle-orm/pg-core/query-builders/query';
+import { PgRaw } from 'drizzle-orm/pg-core/query-builders/raw';
+import { drizzle } from 'drizzle-orm/pg-proxy';
+import { TypedQueryBuilder } from 'drizzle-orm/query-builders/query-builder';
+import { EventSource } from 'eventsource';
+import { stringify } from 'viem';
+function orderSelectedFields(fields, pathPrefix) {
+    return Object.entries(fields).reduce((result, [name, field]) => {
+        if (typeof name !== 'string') {
+            return result;
+        }
+        const newPath = pathPrefix ? [...pathPrefix, name] : [name];
+        if (is(field, Column) || is(field, SQL) || is(field, SQL.Aliased)) {
+            result.push({ path: newPath, field });
+        }
+        else if (is(field, Table)) {
+            result.push(
+            // @ts-expect-error
+            ...orderSelectedFields(field[Table.Symbol.Columns], newPath));
+        }
+        else {
+            result.push(...orderSelectedFields(field, newPath));
+        }
+        return result;
+    }, []);
+}
+const getUrl = (baseUrl, method, query) => {
+    const url = new URL(baseUrl);
+    url.pathname = `${url.pathname}/${method}`;
+    if (query) {
+        url.searchParams.set('sql', stringify(query));
+    }
+    return url;
+};
+const noopDatabase = drizzle(() => Promise.resolve({ rows: [] }), {
+    casing: 'snake_case',
+});
+// @ts-expect-error - dialect is not typed
+const dialect = noopDatabase.dialect;
+export const compileQuery = (query) => {
+    return dialect.sqlToQuery(query.getSQL());
+};
+export function createClient({ baseUrl, relations, schema, }) {
+    return {
+        db: drizzle(async (sql, params, method, typings) => {
+            const query = { sql, params, typings };
+            const url = getUrl(baseUrl, 'db', query);
+            const rsp = await fetch(url.toString(), {
+                method: 'GET',
+            });
+            if (!rsp.ok) {
+                throw new Error((await rsp.json()).error);
+            }
+            const result = await rsp.json();
+            if (method === 'all') {
+                return {
+                    ...result,
+                    rows: result.rows.map((row) => Object.values(row)),
+                };
+            }
+            return result;
+        }, {
+            relations: relations,
+            schema: schema,
+            casing: 'snake_case',
+        }),
+        live: (queryFn, onData, onError) => {
+            // biome-ignore lint/suspicious/noExplicitAny: fix later
+            let result;
+            const passThroughDatabase = drizzle((_, __, method) => {
+                if (method === 'all') {
+                    return Promise.resolve({
+                        ...result,
+                        rows: result.rows.map((row) => Object.values(row)),
+                    });
+                }
+                return Promise.resolve(result);
+            }, { schema: schema, relations: relations, casing: 'snake_case' });
+            const queryPromise = queryFn(passThroughDatabase);
+            if ('getSQL' in queryPromise === false) {
+                throw new Error('"queryFn" must return SQL. You may have to remove `.execute()` from your query.');
+            }
+            const queryBuilder = queryPromise;
+            const query = compileQuery(queryBuilder);
+            const sse = new EventSource(getUrl(baseUrl, 'live', query));
+            async function onMessage(event) {
+                result = JSON.parse(event.data);
+                let data;
+                if (queryBuilder instanceof TypedQueryBuilder) {
+                    data = await passThroughDatabase._.session
+                        .prepareQuery(query, 
+                    // @ts-expect-error - selectedFields is not typed
+                    orderSelectedFields(queryPromise._.selectedFields), undefined, false)
+                        .execute();
+                }
+                else if (queryBuilder instanceof PgRelationalQuery) {
+                    // @ts-expect-error - _toSQL is not typed
+                    const selection = queryBuilder._toSQL().query.selection;
+                    data = await passThroughDatabase._.session
+                        .prepareQuery(query, undefined, undefined, true, (rawRows, mapColumnValue) => {
+                        const rows = rawRows.map((row) => {
+                            const obj = {};
+                            row.forEach((value, index) => {
+                                // @ts-expect-error - selection is not typed
+                                obj[selection[index].key] = value;
+                            });
+                            return mapRelationalRow(obj, selection, mapColumnValue);
+                        });
+                        // @ts-expect-error - mode is not typed
+                        if (queryBuilder.mode === 'first') {
+                            return rows[0];
+                        }
+                        return rows;
+                    })
+                        .execute();
+                }
+                else if (queryBuilder instanceof PgRaw) {
+                    data = await passThroughDatabase._.session
+                        .prepareQuery(query, undefined, undefined, false)
+                        .execute();
+                }
+                else {
+                    throw new Error('Unsupported query builder');
+                }
+                // @ts-expect-error - data is not typed
+                onData(data);
+            }
+            function onSSEError(event) {
+                if ('data' in event) {
+                    onError?.(new Error(event.data));
+                }
+                else {
+                    // @ts-expect-error - message is not typed
+                    onError?.(new Error(`SSE error ${event?.message}`));
+                }
+                sse.close();
+            }
+            sse.addEventListener('message', onMessage);
+            sse.addEventListener('error', onSSEError);
+            return {
+                unsubscribe: () => {
+                    sse.removeEventListener('message', onMessage);
+                    sse.removeEventListener('error', onSSEError);
+                    sse.close();
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,MAAM,EAEN,EAAE,EACF,gBAAgB,EAGhB,GAAG,EAEH,KAAK,GACN,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAA;AAC5E,OAAO,EAAE,KAAK,EAAE,MAAM,wCAAwC,CAAA;AAC9D,OAAO,EAAE,OAAO,EAAyB,MAAM,sBAAsB,CAAA;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAA;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAEhC,SAAS,mBAAmB,CAC1B,MAA+B,EAC/B,UAAqB;IAErB,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAClC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QACxB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,MAAM,CAAA;QACf,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAC3D,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAClE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QACvC,CAAC;aAAM,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI;YACT,mBAAmB;YACnB,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAC7D,CAAA;QACH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CACT,GAAG,mBAAmB,CAAC,KAAgC,EAAE,OAAO,CAAC,CAClE,CAAA;QACH,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC,EACD,EAAE,CAC+B,CAAA;AACrC,CAAC;AAED,MAAM,MAAM,GAAG,CACb,OAAe,EACf,MAAqB,EACrB,KAAwB,EACxB,EAAE;IACF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;IAC5B,GAAG,CAAC,QAAQ,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAA;IAC1C,IAAI,KAAK,EAAE,CAAC;QACV,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;IAC/C,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE;IAChE,MAAM,EAAE,YAAY;CACrB,CAAC,CAAA;AAEF,0CAA0C;AAC1C,MAAM,OAAO,GAAc,YAAY,CAAC,OAAO,CAAA;AAE/C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAiB,EAAE,EAAE;IAChD,OAAO,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;AAC3C,CAAC,CAAA;AAgCD,MAAM,UAAU,YAAY,CAG1B,EACA,OAAO,EACP,SAAS,EACT,MAAM,GAKP;IACC,OAAO;QACL,EAAE,EAAE,OAAO,CACT,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;YACtC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;YAExC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;gBACtC,MAAM,EAAE,KAAK;aACd,CAAC,CAAA;YACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAA;YAC3C,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;YAE/B,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBACrB,OAAO;oBACL,GAAG,MAAM;oBACT,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;iBAC3D,CAAA;YACH,CAAC;YAED,OAAO,MAAM,CAAA;QACf,CAAC,EACD;YACE,SAAS,EAAE,SAAS;YACpB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,YAAY;SACrB,CACF;QACD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YACjC,wDAAwD;YACxD,IAAI,MAAW,CAAA;YACf,MAAM,mBAAmB,GAAG,OAAO,CACjC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE;gBAChB,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;oBACrB,OAAO,OAAO,CAAC,OAAO,CAAC;wBACrB,GAAG,MAAM;wBACT,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;qBAC3D,CAAC,CAAA;gBACJ,CAAC;gBAED,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YAChC,CAAC,EACD,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,CAC/D,CAAA;YACD,MAAM,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;YAEjD,IAAI,QAAQ,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAA;YACH,CAAC;YACD,MAAM,YAAY,GAAG,YAAqC,CAAA;YAE1D,MAAM,KAAK,GAAG,YAAY,CAAC,YAAY,CAAC,CAAA;YACxC,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;YAE3D,KAAK,UAAU,SAAS,CAAC,KAAmB;gBAC1C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;gBAC/B,IAAI,IAAa,CAAA;gBAEjB,IAAI,YAAY,YAAY,iBAAiB,EAAE,CAAC;oBAC9C,IAAI,GAAG,MAAM,mBAAmB,CAAC,CAAC,CAAC,OAAO;yBACvC,YAAY,CACX,KAAK;oBACL,iDAAiD;oBACjD,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,EAClD,SAAS,EACT,KAAK,CACN;yBACA,OAAO,EAAE,CAAA;gBACd,CAAC;qBAAM,IAAI,YAAY,YAAY,iBAAiB,EAAE,CAAC;oBACrD,yCAAyC;oBACzC,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAA;oBAEvD,IAAI,GAAG,MAAM,mBAAmB,CAAC,CAAC,CAAC,OAAO;yBACvC,YAAY,CACX,KAAK,EACL,SAAS,EACT,SAAS,EACT,IAAI,EACJ,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE;wBAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;4BAC/B,MAAM,GAAG,GAAG,EAAE,CAAA;4BACd,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gCAC3B,4CAA4C;gCAC5C,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;4BACnC,CAAC,CAAC,CAAA;4BACF,OAAO,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,cAAc,CAAC,CAAA;wBACzD,CAAC,CAAC,CAAA;wBACF,uCAAuC;wBACvC,IAAI,YAAY,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;4BAClC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAA;wBAChB,CAAC;wBACD,OAAO,IAAI,CAAA;oBACb,CAAC,CACF;yBACA,OAAO,EAAE,CAAA;gBACd,CAAC;qBAAM,IAAI,YAAY,YAAY,KAAK,EAAE,CAAC;oBACzC,IAAI,GAAG,MAAM,mBAAmB,CAAC,CAAC,CAAC,OAAO;yBACvC,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC;yBAChD,OAAO,EAAE,CAAA;gBACd,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;gBAC9C,CAAC;gBAED,uCAAuC;gBACvC,MAAM,CAAC,IAAI,CAAC,CAAA;YACd,CAAC;YAED,SAAS,UAAU,CAAC,KAA2B;gBAC7C,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;oBACpB,OAAO,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;gBAClC,CAAC;qBAAM,CAAC;oBACN,0CAA0C;oBAC1C,OAAO,EAAE,CAAC,IAAI,KAAK,CAAC,aAAa,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;gBACrD,CAAC;gBACD,GAAG,CAAC,KAAK,EAAE,CAAA;YACb,CAAC;YAED,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;YAC1C,GAAG,CAAC,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;YAEzC,OAAO;gBACL,WAAW,EAAE,GAAG,EAAE;oBAChB,GAAG,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;oBAC7C,GAAG,CAAC,mBAAmB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;oBAC5C,GAAG,CAAC,KAAK,EAAE,CAAA;gBACb,CAAC;aACF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@hugomrdias/foxer-client",
+  "version": "0.0.1",
+  "description": "React hooks for interacting with Filecoin Onchain Cloud smart contracts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hugomrdias/foxer.git"
+  },
+  "sideEffects": false,
+  "keywords": [
+    "filecoin",
+    "synapse",
+    "filecoin pay",
+    "filecoin onchain cloud",
+    "web3",
+    "react",
+    "hooks"
+  ],
+  "author": "Hugo Dias <hugomrdias@gmail.com>",
+  "license": "Apache-2.0 OR MIT",
+  "bugs": {
+    "url": "https://github.com/hugomrdias/foxer/issues"
+  },
+  "homepage": "https://github.com/hugomrdias/foxer/tree/main/packages/foxer-client",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "module": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "src",
+    "dist/src",
+    "dist/src/**/*.d.ts",
+    "dist/src/**/*.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "lint": "tsc --build && biome check ."
+  },
+  "dependencies": {
+    "drizzle-orm": "1.0.0-beta.15-859cf75",
+    "eventsource": "^4.1.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.5",
+    "@types/node": "25.3.3",
+    "type-fest": "^5.4.4",
+    "typescript": "5.9.3",
+    "viem": "2.46.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "viem": "2.x"
+  }
+}

package/src/index.ts

@@ -0,0 +1,251 @@
+import {
+  type AnyColumn,
+  type AnyRelations,
+  Column,
+  type EmptyRelations,
+  is,
+  mapRelationalRow,
+  type QueryWithTypings,
+  type SelectedFieldsOrdered,
+  SQL,
+  type SQLWrapper,
+  Table,
+} from 'drizzle-orm'
+import type { PgDialect } from 'drizzle-orm/pg-core'
+import { PgRelationalQuery } from 'drizzle-orm/pg-core/query-builders/query'
+import { PgRaw } from 'drizzle-orm/pg-core/query-builders/raw'
+import { drizzle, type PgRemoteDatabase } from 'drizzle-orm/pg-proxy'
+import { TypedQueryBuilder } from 'drizzle-orm/query-builders/query-builder'
+import { EventSource } from 'eventsource'
+import type { Simplify } from 'type-fest'
+import { stringify } from 'viem'
+
+function orderSelectedFields<TColumn extends AnyColumn>(
+  fields: Record<string, unknown>,
+  pathPrefix?: string[]
+): SelectedFieldsOrdered<TColumn> {
+  return Object.entries(fields).reduce<SelectedFieldsOrdered<AnyColumn>>(
+    (result, [name, field]) => {
+      if (typeof name !== 'string') {
+        return result
+      }
+
+      const newPath = pathPrefix ? [...pathPrefix, name] : [name]
+      if (is(field, Column) || is(field, SQL) || is(field, SQL.Aliased)) {
+        result.push({ path: newPath, field })
+      } else if (is(field, Table)) {
+        result.push(
+          // @ts-expect-error
+          ...orderSelectedFields(field[Table.Symbol.Columns], newPath)
+        )
+      } else {
+        result.push(
+          ...orderSelectedFields(field as Record<string, unknown>, newPath)
+        )
+      }
+      return result
+    },
+    []
+  ) as SelectedFieldsOrdered<TColumn>
+}
+
+const getUrl = (
+  baseUrl: string,
+  method: 'live' | 'db',
+  query?: QueryWithTypings
+) => {
+  const url = new URL(baseUrl)
+  url.pathname = `${url.pathname}/${method}`
+  if (query) {
+    url.searchParams.set('sql', stringify(query))
+  }
+  return url
+}
+
+const noopDatabase = drizzle(() => Promise.resolve({ rows: [] }), {
+  casing: 'snake_case',
+})
+
+// @ts-expect-error - dialect is not typed
+const dialect: PgDialect = noopDatabase.dialect
+
+export const compileQuery = (query: SQLWrapper) => {
+  return dialect.sqlToQuery(query.getSQL())
+}
+
+type ClientDb<
+  TSchema extends Record<string, unknown> = Record<string, unknown>,
+  TRelations extends AnyRelations = EmptyRelations,
+> = Simplify<
+  Omit<
+    PgRemoteDatabase<TSchema, TRelations>,
+    | 'insert'
+    | 'update'
+    | 'delete'
+    | 'transaction'
+    | 'refreshMaterializedView'
+    | '_query'
+  >
+>
+
+export type Client<
+  TSchema extends Record<string, unknown> = Record<string, unknown>,
+  TRelations extends AnyRelations = EmptyRelations,
+> = {
+  db: ClientDb<TSchema, TRelations>
+
+  live: <result>(
+    queryFn: (db: ClientDb<TSchema, TRelations>) => Promise<result>,
+    onData: (result: result) => void,
+    onError?: (error: Error) => void
+  ) => {
+    unsubscribe: () => void
+  }
+}
+
+export function createClient<
+  TSchema extends Record<string, unknown> = Record<string, unknown>,
+  TRelations extends AnyRelations = EmptyRelations,
+>({
+  baseUrl,
+  relations,
+  schema,
+}: {
+  baseUrl: string
+  relations: TRelations
+  schema: TSchema
+}): Client<TSchema, TRelations> {
+  return {
+    db: drizzle(
+      async (sql, params, method, typings) => {
+        const query = { sql, params, typings }
+        const url = getUrl(baseUrl, 'db', query)
+
+        const rsp = await fetch(url.toString(), {
+          method: 'GET',
+        })
+        if (!rsp.ok) {
+          throw new Error((await rsp.json()).error)
+        }
+
+        const result = await rsp.json()
+
+        if (method === 'all') {
+          return {
+            ...result,
+            rows: result.rows.map((row: object) => Object.values(row)),
+          }
+        }
+
+        return result
+      },
+      {
+        relations: relations,
+        schema: schema,
+        casing: 'snake_case',
+      }
+    ),
+    live: (queryFn, onData, onError) => {
+      // biome-ignore lint/suspicious/noExplicitAny: fix later
+      let result: any
+      const passThroughDatabase = drizzle(
+        (_, __, method) => {
+          if (method === 'all') {
+            return Promise.resolve({
+              ...result,
+              rows: result.rows.map((row: object) => Object.values(row)),
+            })
+          }
+
+          return Promise.resolve(result)
+        },
+        { schema: schema, relations: relations, casing: 'snake_case' }
+      )
+      const queryPromise = queryFn(passThroughDatabase)
+
+      if ('getSQL' in queryPromise === false) {
+        throw new Error(
+          '"queryFn" must return SQL. You may have to remove `.execute()` from your query.'
+        )
+      }
+      const queryBuilder = queryPromise as unknown as SQLWrapper
+
+      const query = compileQuery(queryBuilder)
+      const sse = new EventSource(getUrl(baseUrl, 'live', query))
+
+      async function onMessage(event: MessageEvent) {
+        result = JSON.parse(event.data)
+        let data: unknown
+
+        if (queryBuilder instanceof TypedQueryBuilder) {
+          data = await passThroughDatabase._.session
+            .prepareQuery(
+              query,
+              // @ts-expect-error - selectedFields is not typed
+              orderSelectedFields(queryPromise._.selectedFields),
+              undefined,
+              false
+            )
+            .execute()
+        } else if (queryBuilder instanceof PgRelationalQuery) {
+          // @ts-expect-error - _toSQL is not typed
+          const selection = queryBuilder._toSQL().query.selection
+
+          data = await passThroughDatabase._.session
+            .prepareQuery(
+              query,
+              undefined,
+              undefined,
+              true,
+              (rawRows, mapColumnValue) => {
+                const rows = rawRows.map((row) => {
+                  const obj = {}
+                  row.forEach((value, index) => {
+                    // @ts-expect-error - selection is not typed
+                    obj[selection[index].key] = value
+                  })
+                  return mapRelationalRow(obj, selection, mapColumnValue)
+                })
+                // @ts-expect-error - mode is not typed
+                if (queryBuilder.mode === 'first') {
+                  return rows[0]
+                }
+                return rows
+              }
+            )
+            .execute()
+        } else if (queryBuilder instanceof PgRaw) {
+          data = await passThroughDatabase._.session
+            .prepareQuery(query, undefined, undefined, false)
+            .execute()
+        } else {
+          throw new Error('Unsupported query builder')
+        }
+
+        // @ts-expect-error - data is not typed
+        onData(data)
+      }
+
+      function onSSEError(event: Event | MessageEvent) {
+        if ('data' in event) {
+          onError?.(new Error(event.data))
+        } else {
+          // @ts-expect-error - message is not typed
+          onError?.(new Error(`SSE error ${event?.message}`))
+        }
+        sse.close()
+      }
+
+      sse.addEventListener('message', onMessage)
+      sse.addEventListener('error', onSSEError)
+
+      return {
+        unsubscribe: () => {
+          sse.removeEventListener('message', onMessage)
+          sse.removeEventListener('error', onSSEError)
+          sse.close()
+        },
+      }
+    },
+  }
+}