Async functions for querying public graph

Currently the only way to query the public graph using a specific schema is to go through Hypergraph's client-side useQuery hook. This works well when you need to modify the data, as we can keep the source of truth for queried data in the same place as modified data.

There are some use-cases where you just need to query for public data but not modify it. For this use case useQuery still works, but it won't work for server-side rendering or ad-hoc queries that run as a result of side-effects.

We should expose the query internals in a separate query(Schema) function.

Query options

Queries require things like the mapping or the space in order to generate the query + filters for a specific schema. We'll need a way to provide these options to the query at query time.

Option 1
We can pass the options to the query directly.

await query(Address, { mapping, spaceId })

Option 2
We can create a QueryClient which accepts options. Not entirely sure but this probably looks similar to hypergraph/react's internal context for spaces.

const client = new HypergraphClient({ mapping, spaceId });
await client.query(Address)

Appendix

• https://github.com/graphprotocol/hypergraph/blob/eaa633a8ff2d659da4edd5b5b51071c1a47e517d/packages/hypergraph-react/src/internal/use-query-public.tsx#L384

付録でリンクされている内部実装 packages/hypergraph-react/src/internal/use-query-public.tsx の384行目から始め、useQuery がスキーマクエリ、mapping、space、フィルターをどのように構築するかを追跡します。mapping と spaceId を指定するために提案されている2つのオプション設計を比較し、その後、サーバーサイドレンダリングおよび副作用を伴うクエリのための非同期クエリエントリポイントを定義します。React の useQuery フックなしでパブリックグラフデータをクエリできれば完了です。