@ponder/client 0.9.0-next.1 → 0.9.0-next.11

package/dist/index.d.ts

@@ -1,22 +1,51 @@
+import { SQLWrapper, QueryWithTypings } from 'drizzle-orm';
+export { and, asc, avg, avgDistinct, between, count, countDistinct, desc, eq, exists, gt, gte, ilike, inArray, isNotNull, isNull, like, lt, lte, max, min, ne, not, notBetween, notExists, notIlike, notInArray, notLike, or, relations, sql, sum, sumDistinct } from 'drizzle-orm';
 import { PgRemoteDatabase } from 'drizzle-orm/pg-proxy';
-export { and, asc, avg, avgDistinct, between, count, countDistinct, desc, eq, exists, gt, gte, inArray, isNotNull, isNull, like, lt, lte, max, min, ne, not, notBetween, notExists, notIlike, notInArray, or, relations, sql, sum, sumDistinct } from 'drizzle-orm';
 export { alias, except, exceptAll, intersect, intersectAll, union, unionAll } from 'drizzle-orm/pg-core';
 
-declare const setDatabaseSchema: <T extends {
-    [name: string]: unknown;
-}>(schema: T, schemaName: string) => T;
-
 type Schema = {
     [name: string]: unknown;
 };
 type Prettify<T> = {
     [K in keyof T]: T[K];
 } & {};
+type Status = {
+    [network: string]: {
+        block: {
+            number: number;
+            timestamp: number;
+        } | null;
+        ready: boolean;
+    };
+};
+type ClientDb<schema extends Schema = Schema> = Prettify<Omit<PgRemoteDatabase<schema>, "insert" | "update" | "delete" | "transaction" | "refreshMaterializedView" | "_">>;
 type Client<schema extends Schema = Schema> = {
-    db: Prettify<Omit<PgRemoteDatabase<schema>, "insert" | "update" | "delete" | "transaction" | "refreshMaterializedView" | "_">>;
+    /** Query the database. */
+    db: ClientDb<schema>;
+    /** Subscribe to live updates. */
+    live: <result>(queryFn: (db: ClientDb<schema>) => Promise<result>, onData: (result: result) => void, onError?: (error: Error) => void) => {
+        unsubscribe: () => void;
+    };
+    /** Get the status of all chains. */
+    getStatus: () => Promise<Status>;
 };
-declare const createClient: <schema extends Schema>(url: string, { schema }: {
+declare const compileQuery: (query: SQLWrapper) => QueryWithTypings;
+/**
+ * Create a client for querying Ponder apps.
+ *
+ * @param baseUrl - The URL of the Ponder app.
+ * @param schema - The schema of the Ponder app.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from "@ponder/client";
+ * import * as schema from "../ponder.schema";
+ *
+ * const client = createClient("https://.../sql", { schema });
+ * ```
+ */
+declare const createClient: <schema extends Schema>(baseUrl: string, { schema }: {
     schema: schema;
 }) => Client<schema>;
 
-export { type Client, createClient, setDatabaseSchema };
+export { type Client, type Status, compileQuery, createClient };

package/dist/index.js

@@ -1,5 +1,6 @@
 // src/index.ts
 import { drizzle } from "drizzle-orm/pg-proxy";
+import superjson from "superjson";
 import {
   sql,
   eq,
@@ -17,6 +18,8 @@ import {
   between,
   notBetween,
   like,
+  notLike,
+  ilike,
   notIlike,
   not,
   asc,
@@ -42,32 +45,89 @@ import {
   except,
   exceptAll
 } from "drizzle-orm/pg-core";
-
-// src/setDatabaseSchema.ts
-import { Table, is } from "drizzle-orm";
-var Schema = Symbol.for("drizzle:Schema");
-var setDatabaseSchema = (schema, schemaName) => {
-  for (const table of Object.values(schema)) {
-    if (is(table, Table)) {
-      table[Schema] = schemaName;
-    }
+var getEventSource = async () => {
+  let SSE;
+  if (typeof window === "undefined") {
+    const undici = await import(
+      /* webpackIgnore: true */
+      "undici"
+    );
+    SSE = undici.EventSource;
+  } else {
+    SSE = EventSource;
   }
-  return schema;
+  return SSE;
 };
-
-// src/index.ts
-var createClient = (url, { schema }) => {
-  const db = drizzle(
-    async (sql2, params, method, typings) => {
-      const result = await fetch(`${url}/client`, {
-        method: "POST",
-        body: JSON.stringify({ sql: sql2, params, method, typings })
-      });
-      return await result.json();
+var getUrl = (baseUrl, method, query) => {
+  const url = new URL(`${baseUrl}/${method}`);
+  if (query) {
+    url.searchParams.set("sql", superjson.stringify(query));
+  }
+  return url;
+};
+var noopDatabase = drizzle(() => Promise.resolve({ rows: [] }), {
+  casing: "snake_case"
+});
+var dialect = noopDatabase.dialect;
+var compileQuery = (query) => {
+  return dialect.sqlToQuery(query.getSQL());
+};
+var createClient = (baseUrl, { schema }) => {
+  let sse;
+  let liveCount = 0;
+  const client = {
+    db: drizzle(
+      async (sql2, params, _, typings) => {
+        const builtQuery = { sql: sql2, params, typings };
+        const response = await fetch(getUrl(baseUrl, "db", builtQuery), {
+          method: "POST"
+        });
+        if (response.ok === false) {
+          const error = new Error(await response.text());
+          error.stack = void 0;
+          throw error;
+        }
+        const result = await response.json();
+        return {
+          ...result,
+          rows: result.rows.map((row) => Object.values(row))
+        };
+      },
+      { schema, casing: "snake_case" }
+    ),
+    live: (queryFn, onData, onError) => {
+      const addEventListeners = () => {
+        sse.addEventListener("message", () => {
+          queryFn(client.db).then(onData).catch(onError);
+        });
+        sse.addEventListener("error", () => {
+          onError?.(new Error("server disconnected"));
+        });
+      };
+      liveCount++;
+      if (sse === void 0) {
+        getEventSource().then((SSE) => {
+          sse = new SSE(getUrl(baseUrl, "live"));
+          addEventListeners();
+        });
+      } else {
+        addEventListeners();
+      }
+      return {
+        unsubscribe: () => {
+          if (--liveCount === 0)
+            sse?.close();
+        }
+      };
     },
-    { schema, casing: "snake_case" }
-  );
-  return { db };
+    getStatus: async () => {
+      const response = await fetch(getUrl(baseUrl, "status"), {
+        method: "POST"
+      });
+      return response.json();
+    }
+  };
+  return client;
 };
 export {
   alias,
@@ -76,6 +136,7 @@ export {
   avg,
   avgDistinct,
   between,
+  compileQuery,
   count,
   countDistinct,
   createClient,
@@ -86,6 +147,7 @@ export {
   exists,
   gt,
   gte,
+  ilike,
   inArray,
   intersect,
   intersectAll,
@@ -102,9 +164,9 @@ export {
   notExists,
   notIlike,
   notInArray,
+  notLike,
   or,
   relations,
-  setDatabaseSchema,
   sql,
   sum,
   sumDistinct,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/setDatabaseSchema.ts"],"sourcesContent":["import { type PgRemoteDatabase, drizzle } from \"drizzle-orm/pg-proxy\";\n\ntype Schema = { [name: string]: unknown };\n\ntype Prettify<T> = {\n  [K in keyof T]: T[K];\n} & {};\n\nexport type Client<schema extends Schema = Schema> = {\n  db: Prettify<\n    Omit<\n      PgRemoteDatabase<schema>,\n      | \"insert\"\n      | \"update\"\n      | \"delete\"\n      | \"transaction\"\n      | \"refreshMaterializedView\"\n      | \"_\"\n    >\n  >;\n};\n\nexport const createClient = <schema extends Schema>(\n  url: string,\n  { schema }: { schema: schema },\n): Client<schema> => {\n  const db = drizzle(\n    async (sql, params, method, typings) => {\n      const result = await fetch(`${url}/client`, {\n        method: \"POST\",\n        body: JSON.stringify({ sql, params, method, typings }),\n      });\n\n      return await result.json();\n    },\n    { schema, casing: \"snake_case\" },\n  );\n\n  return { db };\n};\n\nexport {\n  sql,\n  eq,\n  gt,\n  gte,\n  lt,\n  lte,\n  ne,\n  isNull,\n  isNotNull,\n  inArray,\n  notInArray,\n  exists,\n  notExists,\n  between,\n  notBetween,\n  like,\n  notIlike,\n  not,\n  asc,\n  desc,\n  and,\n  or,\n  count,\n  countDistinct,\n  avg,\n  avgDistinct,\n  sum,\n  sumDistinct,\n  max,\n  min,\n  relations,\n} from \"drizzle-orm\";\n\nexport {\n  alias,\n  union,\n  unionAll,\n  intersect,\n  intersectAll,\n  except,\n  exceptAll,\n} from \"drizzle-orm/pg-core\";\n\nexport { setDatabaseSchema } from \"./setDatabaseSchema.js\";\n","import { Table, is } from \"drizzle-orm\";\n\nconst Schema = Symbol.for(\"drizzle:Schema\");\n\nexport const setDatabaseSchema = <T extends { [name: string]: unknown }>(\n  schema: T,\n  schemaName: string,\n): T => {\n  for (const table of Object.values(schema)) {\n    if (is(table, Table)) {\n      // @ts-ignore\n      table[Schema] = schemaName;\n    }\n  }\n  return schema;\n};\n"],"mappings":";AAAA,SAAgC,eAAe;AAyC/C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;;;ACnFP,SAAS,OAAO,UAAU;AAE1B,IAAM,SAAS,OAAO,IAAI,gBAAgB;AAEnC,IAAM,oBAAoB,CAC/B,QACA,eACM;AACN,aAAW,SAAS,OAAO,OAAO,MAAM,GAAG;AACzC,QAAI,GAAG,OAAO,KAAK,GAAG;AAEpB,YAAM,MAAM,IAAI;AAAA,IAClB;AAAA,EACF;AACA,SAAO;AACT;;;ADOO,IAAM,eAAe,CAC1B,KACA,EAAE,OAAO,MACU;AACnB,QAAM,KAAK;AAAA,IACT,OAAOA,MAAK,QAAQ,QAAQ,YAAY;AACtC,YAAM,SAAS,MAAM,MAAM,GAAG,GAAG,WAAW;AAAA,QAC1C,QAAQ;AAAA,QACR,MAAM,KAAK,UAAU,EAAE,KAAAA,MAAK,QAAQ,QAAQ,QAAQ,CAAC;AAAA,MACvD,CAAC;AAED,aAAO,MAAM,OAAO,KAAK;AAAA,IAC3B;AAAA,IACA,EAAE,QAAQ,QAAQ,aAAa;AAAA,EACjC;AAEA,SAAO,EAAE,GAAG;AACd;","names":["sql"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { QueryWithTypings, SQLWrapper } from \"drizzle-orm\";\nimport type { PgDialect } from \"drizzle-orm/pg-core\";\nimport { type PgRemoteDatabase, drizzle } from \"drizzle-orm/pg-proxy\";\nimport superjson from \"superjson\";\n\nconst getEventSource = async () => {\n  let SSE: typeof EventSource;\n  if (typeof window === \"undefined\") {\n    const undici = await import(/* webpackIgnore: true */ \"undici\");\n    // @ts-ignore\n    SSE = undici.EventSource;\n  } else {\n    SSE = EventSource;\n  }\n\n  return SSE;\n};\n\ntype Schema = { [name: string]: unknown };\n\ntype Prettify<T> = {\n  [K in keyof T]: T[K];\n} & {};\n\nexport type Status = {\n  [network: string]: {\n    block: { number: number; timestamp: number } | null;\n    ready: boolean;\n  };\n};\n\ntype ClientDb<schema extends Schema = Schema> = Prettify<\n  Omit<\n    PgRemoteDatabase<schema>,\n    | \"insert\"\n    | \"update\"\n    | \"delete\"\n    | \"transaction\"\n    | \"refreshMaterializedView\"\n    | \"_\"\n  >\n>;\n\nexport type Client<schema extends Schema = Schema> = {\n  /** Query the database. */\n  db: ClientDb<schema>;\n  /** Subscribe to live updates. */\n  live: <result>(\n    queryFn: (db: ClientDb<schema>) => Promise<result>,\n    onData: (result: result) => void,\n    onError?: (error: Error) => void,\n  ) => {\n    unsubscribe: () => void;\n  };\n  /** Get the status of all chains. */\n  getStatus: () => Promise<Status>;\n};\n\nconst getUrl = (\n  baseUrl: string,\n  method: \"live\" | \"db\" | \"status\",\n  query?: QueryWithTypings,\n) => {\n  const url = new URL(`${baseUrl}/${method}`);\n  if (query) {\n    url.searchParams.set(\"sql\", superjson.stringify(query));\n  }\n  return url;\n};\n\nconst noopDatabase = drizzle(() => Promise.resolve({ rows: [] }), {\n  casing: \"snake_case\",\n});\n\n// @ts-ignore\nconst dialect: PgDialect = noopDatabase.dialect;\n\nexport const compileQuery = (query: SQLWrapper) => {\n  return dialect.sqlToQuery(query.getSQL());\n};\n\n/**\n * Create a client for querying Ponder apps.\n *\n * @param baseUrl - The URL of the Ponder app.\n * @param schema - The schema of the Ponder app.\n *\n * @example\n * ```ts\n * import { createClient } from \"@ponder/client\";\n * import * as schema from \"../ponder.schema\";\n *\n * const client = createClient(\"https://.../sql\", { schema });\n * ```\n */\nexport const createClient = <schema extends Schema>(\n  baseUrl: string,\n  { schema }: { schema: schema },\n): Client<schema> => {\n  let sse: EventSource | undefined;\n  let liveCount = 0;\n\n  const client: Client<schema> = {\n    db: drizzle(\n      async (sql, params, _, typings) => {\n        const builtQuery = { sql, params, typings };\n        const response = await fetch(getUrl(baseUrl, \"db\", builtQuery), {\n          method: \"POST\",\n        });\n\n        if (response.ok === false) {\n          const error = new Error(await response.text());\n          error.stack = undefined;\n          throw error;\n        }\n\n        const result = await response.json();\n\n        return {\n          ...result,\n          rows: result.rows.map((row: object) => Object.values(row)),\n        };\n      },\n      { schema, casing: \"snake_case\" },\n    ),\n    live: (queryFn, onData, onError) => {\n      const addEventListeners = () => {\n        sse!.addEventListener(\"message\", () => {\n          queryFn(client.db).then(onData).catch(onError);\n        });\n\n        sse!.addEventListener(\"error\", () => {\n          onError?.(new Error(\"server disconnected\"));\n        });\n      };\n\n      liveCount++;\n      if (sse === undefined) {\n        getEventSource().then((SSE) => {\n          sse = new SSE(getUrl(baseUrl, \"live\"));\n          addEventListeners();\n        });\n      } else {\n        addEventListeners();\n      }\n\n      return {\n        unsubscribe: () => {\n          if (--liveCount === 0) sse?.close();\n        },\n      };\n    },\n    getStatus: async () => {\n      const response = await fetch(getUrl(baseUrl, \"status\"), {\n        method: \"POST\",\n      });\n\n      return response.json();\n    },\n  };\n\n  return client;\n};\n\nexport {\n  sql,\n  eq,\n  gt,\n  gte,\n  lt,\n  lte,\n  ne,\n  isNull,\n  isNotNull,\n  inArray,\n  notInArray,\n  exists,\n  notExists,\n  between,\n  notBetween,\n  like,\n  notLike,\n  ilike,\n  notIlike,\n  not,\n  asc,\n  desc,\n  and,\n  or,\n  count,\n  countDistinct,\n  avg,\n  avgDistinct,\n  sum,\n  sumDistinct,\n  max,\n  min,\n  relations,\n} from \"drizzle-orm\";\n\nexport {\n  alias,\n  union,\n  unionAll,\n  intersect,\n  intersectAll,\n  except,\n  exceptAll,\n} from \"drizzle-orm/pg-core\";\n"],"mappings":"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","names":["sql"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ponder/client",
-  "version": "0.9.0-next.1",
+  "version": "0.9.0-next.11",
   "description": "",
   "license": "MIT",
   "type": "module",
@@ -26,6 +26,9 @@
       "import": "./dist/index.js"
     }
   },
+  "browser": {
+    "undici": false
+  },
   "peerDependencies": {
     "typescript": ">=5.0.4"
   },
@@ -35,7 +38,9 @@
     }
   },
   "dependencies": {
-    "drizzle-orm": "0.36.4"
+    "drizzle-orm": "0.36.4",
+    "superjson": "^2.2.2",
+    "undici": "^7.2.0"
   },
   "devDependencies": {
     "tsup": "^8.0.1"

package/src/index.ts

@@ -1,4 +1,20 @@
+import type { QueryWithTypings, SQLWrapper } from "drizzle-orm";
+import type { PgDialect } from "drizzle-orm/pg-core";
 import { type PgRemoteDatabase, drizzle } from "drizzle-orm/pg-proxy";
+import superjson from "superjson";
+
+const getEventSource = async () => {
+  let SSE: typeof EventSource;
+  if (typeof window === "undefined") {
+    const undici = await import(/* webpackIgnore: true */ "undici");
+    // @ts-ignore
+    SSE = undici.EventSource;
+  } else {
+    SSE = EventSource;
+  }
+
+  return SSE;
+};
 
 type Schema = { [name: string]: unknown };
 
@@ -6,37 +22,144 @@ type Prettify<T> = {
   [K in keyof T]: T[K];
 } & {};
 
+export type Status = {
+  [network: string]: {
+    block: { number: number; timestamp: number } | null;
+    ready: boolean;
+  };
+};
+
+type ClientDb<schema extends Schema = Schema> = Prettify<
+  Omit<
+    PgRemoteDatabase<schema>,
+    | "insert"
+    | "update"
+    | "delete"
+    | "transaction"
+    | "refreshMaterializedView"
+    | "_"
+  >
+>;
+
 export type Client<schema extends Schema = Schema> = {
-  db: Prettify<
-    Omit<
-      PgRemoteDatabase<schema>,
-      | "insert"
-      | "update"
-      | "delete"
-      | "transaction"
-      | "refreshMaterializedView"
-      | "_"
-    >
-  >;
+  /** Query the database. */
+  db: ClientDb<schema>;
+  /** Subscribe to live updates. */
+  live: <result>(
+    queryFn: (db: ClientDb<schema>) => Promise<result>,
+    onData: (result: result) => void,
+    onError?: (error: Error) => void,
+  ) => {
+    unsubscribe: () => void;
+  };
+  /** Get the status of all chains. */
+  getStatus: () => Promise<Status>;
 };
 
+const getUrl = (
+  baseUrl: string,
+  method: "live" | "db" | "status",
+  query?: QueryWithTypings,
+) => {
+  const url = new URL(`${baseUrl}/${method}`);
+  if (query) {
+    url.searchParams.set("sql", superjson.stringify(query));
+  }
+  return url;
+};
+
+const noopDatabase = drizzle(() => Promise.resolve({ rows: [] }), {
+  casing: "snake_case",
+});
+
+// @ts-ignore
+const dialect: PgDialect = noopDatabase.dialect;
+
+export const compileQuery = (query: SQLWrapper) => {
+  return dialect.sqlToQuery(query.getSQL());
+};
+
+/**
+ * Create a client for querying Ponder apps.
+ *
+ * @param baseUrl - The URL of the Ponder app.
+ * @param schema - The schema of the Ponder app.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from "@ponder/client";
+ * import * as schema from "../ponder.schema";
+ *
+ * const client = createClient("https://.../sql", { schema });
+ * ```
+ */
 export const createClient = <schema extends Schema>(
-  url: string,
+  baseUrl: string,
   { schema }: { schema: schema },
 ): Client<schema> => {
-  const db = drizzle(
-    async (sql, params, method, typings) => {
-      const result = await fetch(`${url}/client`, {
+  let sse: EventSource | undefined;
+  let liveCount = 0;
+
+  const client: Client<schema> = {
+    db: drizzle(
+      async (sql, params, _, typings) => {
+        const builtQuery = { sql, params, typings };
+        const response = await fetch(getUrl(baseUrl, "db", builtQuery), {
+          method: "POST",
+        });
+
+        if (response.ok === false) {
+          const error = new Error(await response.text());
+          error.stack = undefined;
+          throw error;
+        }
+
+        const result = await response.json();
+
+        return {
+          ...result,
+          rows: result.rows.map((row: object) => Object.values(row)),
+        };
+      },
+      { schema, casing: "snake_case" },
+    ),
+    live: (queryFn, onData, onError) => {
+      const addEventListeners = () => {
+        sse!.addEventListener("message", () => {
+          queryFn(client.db).then(onData).catch(onError);
+        });
+
+        sse!.addEventListener("error", () => {
+          onError?.(new Error("server disconnected"));
+        });
+      };
+
+      liveCount++;
+      if (sse === undefined) {
+        getEventSource().then((SSE) => {
+          sse = new SSE(getUrl(baseUrl, "live"));
+          addEventListeners();
+        });
+      } else {
+        addEventListeners();
+      }
+
+      return {
+        unsubscribe: () => {
+          if (--liveCount === 0) sse?.close();
+        },
+      };
+    },
+    getStatus: async () => {
+      const response = await fetch(getUrl(baseUrl, "status"), {
         method: "POST",
-        body: JSON.stringify({ sql, params, method, typings }),
       });
 
-      return await result.json();
+      return response.json();
     },
-    { schema, casing: "snake_case" },
-  );
+  };
 
-  return { db };
+  return client;
 };
 
 export {
@@ -56,6 +179,8 @@ export {
   between,
   notBetween,
   like,
+  notLike,
+  ilike,
   notIlike,
   not,
   asc,
@@ -82,5 +207,3 @@ export {
   except,
   exceptAll,
 } from "drizzle-orm/pg-core";
-
-export { setDatabaseSchema } from "./setDatabaseSchema.js";

package/src/setDatabaseSchema.ts

@@ -1,16 +0,0 @@
-import { Table, is } from "drizzle-orm";
-
-const Schema = Symbol.for("drizzle:Schema");
-
-export const setDatabaseSchema = <T extends { [name: string]: unknown }>(
-  schema: T,
-  schemaName: string,
-): T => {
-  for (const table of Object.values(schema)) {
-    if (is(table, Table)) {
-      // @ts-ignore
-      table[Schema] = schemaName;
-    }
-  }
-  return schema;
-};