@hypequery/react 0.4.0 → 0.5.1

package/README.md

@@ -1,307 +1,77 @@
 # @hypequery/react
 
-React hooks for typed Hypequery HTTP endpoints, built on TanStack Query.
+Typed React hooks for ClickHouse analytics, powered by TanStack Query.
 
-Use `@hypequery/react` with APIs created by `@hypequery/serve`. The hooks call generated routes and infer input/output types from the API type you pass in.
+`@hypequery/react` carries `@hypequery/serve` contracts into React and Next.js. Query names, inputs, metrics, dataset fields, and response rows stay inferred from the server, so frontend analytics do not drift into a second set of hand-written types.
+
+Use it for product dashboards, embedded analytics, customer reporting, and multi-tenant SaaS metrics.
 
 ## Install
 
 ```bash
 npm install @hypequery/react @tanstack/react-query
-# or
-pnpm add @hypequery/react @tanstack/react-query
 ```
 
-## Quick Start
-
-Given a serve API:
-
-```ts
-// server/api.ts
-import { initServe } from '@hypequery/serve';
-import { z } from 'zod';
-import { db } from './db.js';
-
-const { query, serve } = initServe({
-  context: () => ({ db }),
-  basePath: '/api/analytics',
-});
-
-const weeklyRevenue = query({
-  description: 'Weekly revenue',
-  input: z.object({ startDate: z.string() }),
-  query: ({ ctx, input }) =>
-    ctx.db
-      .table('orders')
-      .where('created_at', 'gte', input.startDate)
-      .sum('total', 'revenue')
-      .execute(),
-});
+## Create hooks from your API
 
-export const api = serve({
-  queries: { weeklyRevenue },
-});
+Generate a small route manifest during the build:
 
-api.route('/weeklyRevenue', api.queries.weeklyRevenue);
-
-export type AnalyticsApi = typeof api;
+```bash
+npx hypequery generate:manifest analytics/api.ts \
+  --output src/generated/hypequery-manifest.json
 ```
 
-Create hooks on the client:
-
 ```tsx
-// client/analytics-hooks.ts
-import { createHooks } from '@hypequery/react';
+import { createAnalyticsHooks } from '@hypequery/react';
 import type { AnalyticsApi } from '../server/api.js';
+import manifest from '../generated/hypequery-manifest.json';
 
-export const { useQuery, useMutation } = createHooks<AnalyticsApi>({
-  baseUrl: '/api/analytics',
-  api: {} as AnalyticsApi,
-});
-```
-
-Use them inside a component:
-
-```tsx
-function RevenuePanel() {
-  const revenue = useQuery('weeklyRevenue', {
-    startDate: '2026-01-01',
+export const { useMetric, useDataset } =
+  createAnalyticsHooks<AnalyticsApi>({
+    baseUrl: '/api/analytics',
+    manifest,
+    metrics: ['revenue'] as const,
   });
-
-  if (revenue.isLoading) return <p>Loading...</p>;
-  if (revenue.error) return <p>{revenue.error.message}</p>;
-
-  return <pre>{JSON.stringify(revenue.data, null, 2)}</pre>;
-}
 ```
 
-## Dataset And Metric Hooks
-
-`createAnalyticsHooks` adds convenience wrappers for semantic endpoint names. Metrics use their endpoint name directly. Dataset endpoints are addressed as `dataset:<name>` in the API type and exposed through `useDataset(name, ...)`.
+## Build the dashboard
 
 ```tsx
-import { createAnalyticsHooks } from '@hypequery/react';
-import type { InferApiType } from '@hypequery/serve';
-import type { api } from '../server/api.js';
-
-import manifest from './hypequery-manifest.json';
-
-type AnalyticsApi = InferApiType<typeof api>;
-
-export const { useMetric, useDataset } = createAnalyticsHooks<AnalyticsApi>({
-  baseUrl: '/api/analytics',
-  manifest,
-  metrics: ['revenue', 'averageOrderValue'] as const,
-});
-
-function Dashboard() {
+function RevenueByRegion() {
   const revenue = useMetric('revenue', {
-    dimensions: ['country'],
-    filters: [{ field: 'status', operator: 'eq', value: 'completed' }],
+    dimensions: ['region'],
     orderBy: [{ field: 'revenue', direction: 'desc' }],
     limit: 10,
   });
 
-  const orders = useDataset('orders', {
-    dimensions: ['status'],
-    measures: ['revenue', 'orderCount'],
-  });
-
-  return (
-    <pre>
-      {JSON.stringify({ revenue: revenue.data, orders: orders.data }, null, 2)}
-    </pre>
-  );
-}
-```
-
-## Pagination
-
-Semantic queries that set a `limit` return `meta.pagination = { limit, offset, hasMore }`
-(`hasMore` is exact — the server over-fetches one row rather than running a count query).
-`useInfiniteQuery`, and the `useInfiniteMetric` / `useInfiniteDataset` wrappers, build on
-this to page through results. They advance the offset automatically and request meta for you.
-
-```tsx
-function OrdersTable() {
-  const orders = useInfiniteDataset('orders', {
-    dimensions: ['status'],
-    measures: ['revenue'],
-    limit: 50,
-  });
-
-  return (
-    <>
-      {orders.data?.pages.flatMap((page) => page.data).map((row, i) => (
-        <Row key={i} row={row} />
-      ))}
-      <button
-        onClick={() => orders.fetchNextPage()}
-        disabled={!orders.hasNextPage || orders.isFetchingNextPage}
-      >
-        Load more
-      </button>
-    </>
-  );
-}
-```
-
-`input.limit` is the page size; `input.offset`, if provided, is the starting offset.
-
-## Route Configuration
-
-Hooks need to know each endpoint's HTTP method and path. There are three ways to
-supply that, in increasing precedence: a route manifest, a runtime `api` object,
-or explicit `config`.
-
-### Route manifest (recommended)
-
-`@hypequery/serve`'s `api.manifest()` returns a serializable map of every
-query/metric/dataset key to its `{ method, path }`. Export it from a server-only
-module and pass it to the hooks — this avoids importing server code into the
-browser bundle while keeping client routes in sync with the server.
-
-```ts
-// server side (server-only module)
-export const manifest = api.manifest();
-
-// client side
-const { useQuery } = createHooks<AnalyticsApi>({
-  baseUrl: '/api/analytics',
-  manifest,
-});
-```
-
-> Metric and dataset endpoints are POST routes whose paths differ from their map
-> keys (e.g. `dataset:orders` → `POST /api/analytics/datasets/orders/query`). They
-> require a `manifest` (or explicit `config`); calling them without one throws a
-> clear error rather than hitting the wrong URL.
-
-#### Generating the manifest at build time
-
-The cleanest way to keep server code out of the browser bundle is to generate a
-JSON file at build time and import that on the client.
-
-```bash
-npx hypequery generate:manifest analytics/api.ts --output src/generated/hypequery-manifest.json
-```
+  if (revenue.isLoading) return <p>Loading revenue…</p>;
+  if (revenue.error) return <p>{revenue.error.message}</p>;
 
-```jsonc
-// package.json
-{
-  "scripts": {
-    "gen:manifest": "hypequery generate:manifest analytics/api.ts --output src/generated/hypequery-manifest.json",
-    "build": "npm run gen:manifest && <your client build>"
-  }
+  return <RevenueChart rows={revenue.data?.data ?? []} />;
 }
 ```
 
-```ts
-// client side — imports plain JSON, no server code in the bundle
-import { createAnalyticsHooks } from '@hypequery/react';
-import type { InferApiType } from '@hypequery/serve';
-import type { api } from '../analytics/api.js';
-import manifest from './generated/hypequery-manifest.json';
-
-type AnalyticsApi = InferApiType<typeof api>;
-
-const { useMetric, useDataset } = createAnalyticsHooks<AnalyticsApi>({
-  baseUrl: '/api/analytics',
-  manifest,
-});
-```
-
-The manifest is derived entirely from your serve config (`basePath`, route keys,
-and `semanticPaths`), so the generated file is deterministic and only changes when
-your API shape does — commit it or regenerate it on every build.
-
-> `baseUrl` supplies the origin/host; the per-endpoint path comes from the
-> manifest (it already includes the server's `basePath`), so there's no
-> double-prefixing. Keep `baseUrl` aligned with where the API is mounted.
-
-### Explicit config
-
-If a manifest is not available at runtime, pass route config explicitly. This
-overrides any manifest entry.
-
-```ts
-const { useQuery } = createHooks<AnalyticsApi>({
-  baseUrl: '/api/analytics',
-  config: {
-    weeklyRevenue: { method: 'POST', path: '/weeklyRevenue' },
-  },
-});
-```
-
-`path` may be relative to `baseUrl`, absolute within the same origin, or an absolute HTTP URL.
-
-## Headers & auth
-
-Pass static headers, or a function (sync or async) invoked per request — handy for
-attaching a fresh/short-lived token.
-
-```ts
-const hooks = createHooks<AnalyticsApi>({
-  baseUrl: '/api/analytics',
-  headers: async () => ({
-    authorization: `Bearer ${await getAccessToken()}`,
-  }),
-});
-```
-
-Provide `onUnauthorized` to refresh credentials on a `401` and retry the request once
-with freshly resolved headers:
-
-```ts
-const hooks = createHooks<AnalyticsApi>({
-  baseUrl: '/api/analytics',
-  headers: () => ({ authorization: `Bearer ${tokenStore.access}` }),
-  onUnauthorized: async () => {
-    await tokenStore.refresh(); // throw to abort; resolve to retry once
-  },
-});
-```
-
-## Query Options
-
-TanStack Query options can be passed as the final argument.
-
-```tsx
-const result = useQuery(
-  'weeklyRevenue',
-  { startDate: '2026-01-01' },
-  {
-    staleTime: 60_000,
-    refetchOnWindowFocus: false,
-  },
-);
-```
-
-For no-input queries, use `queryOptions()` when an options object might look like input.
-
-```tsx
-import { queryOptions } from '@hypequery/react';
+Change the server contract and TypeScript points to the components that need updating.
 
-const result = useQuery('health', queryOptions({
-  staleTime: 30_000,
-}));
-```
+## Included
 
-## Mutations
+- named query hooks and mutations;
+- metric and dataset hooks with selected-field inference;
+- infinite queries with semantic pagination metadata;
+- TanStack Query caching, retries, and refresh behavior;
+- static route manifests that keep server code out of browser bundles;
+- per-request auth headers and one-time `401` refresh.
 
-`useMutation(name)` uses the same endpoint typing and sends requests as `POST` by default unless route config overrides it.
+## Why it matters
 
-```tsx
-const refresh = useMutation('refreshReport');
-
-refresh.mutate({ reportId: 'revenue' });
-```
+The ClickHouse query, semantic metric, HTTP schema, and React component share one contract. That means fewer casts, fewer mismatched route types, and no frontend rewrite when a dashboard graduates from a prototype into a governed multi-tenant product surface.
 
-## Notes
+## Learn more
 
-- This package does not define datasets. Use `@hypequery/datasets` for semantic definitions.
-- This package does not generate SQL. It calls HTTP routes exposed by `@hypequery/serve`.
-- Dataset relationship JOIN execution is not implied by the React hooks; hooks consume whatever endpoint behavior the server exposes.
+- [React quick start](https://hypequery.com/docs/react/getting-started)
+- [Using queries](https://hypequery.com/docs/react/using-queries)
+- [Advanced patterns](https://hypequery.com/docs/react/advanced-patterns)
+- [Current capabilities](https://hypequery.com/docs/capabilities)
 
 ## License
 

package/dist/types.d.ts

@@ -42,7 +42,7 @@ type DatasetOutputForInput<TInfo, TInput, TFallback> = TInfo extends {
 } ? WithTypedData<TFallback, {
     [K in SelectedDimensions<TDimensions, TInput>]?: DimensionValue<TDimensions[K]>;
 } & {
-    [K in SelectedMeasures<TMeasures, TInput>]?: number;
+    [K in SelectedMeasures<TMeasures, TInput>]?: string;
 } & PeriodSelection<TInput>> : TFallback;
 type MetricOutputForInput<TInfo, TInput, TFallback> = TInfo extends {
     kind: 'metric';
@@ -51,7 +51,7 @@ type MetricOutputForInput<TInfo, TInput, TFallback> = TInfo extends {
 } ? WithTypedData<TFallback, {
     [K in SelectedDimensions<TDimensions, TInput>]?: DimensionValue<TDimensions[K]>;
 } & {
-    [K in TMetricName]?: number;
+    [K in TMetricName]?: string;
 } & PeriodSelection<TInput>> : TFallback;
 export type QueryOutputForInput<Api, Name extends ExtractNames<Api>, TInput> = SemanticInfo<Api, Name> extends infer Info ? Info extends {
     kind: 'dataset';

package/dist/types.d.ts.map

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

package/package.json

@@ -1,7 +1,19 @@
 {
   "name": "@hypequery/react",
-  "version": "0.4.0",
-  "description": "React hooks for consuming hypequery APIs",
+  "version": "0.5.1",
+  "description": "Type-safe React and TanStack Query hooks for ClickHouse analytics, metrics, and datasets",
+  "keywords": [
+    "react",
+    "tanstack-query",
+    "clickhouse",
+    "analytics",
+    "semantic-layer",
+    "typescript",
+    "query-builder",
+    "orm",
+    "dashboard",
+    "embedded-analytics"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "exports": {
@@ -30,8 +42,17 @@
     "react-dom": "^18.2.0",
     "typescript": "^5.7.3",
     "vitest": "^3.2.6",
-    "@hypequery/datasets": "0.0.0-canary-20260703190705",
-    "@hypequery/serve": "0.0.0-canary-20260703190705"
+    "@hypequery/serve": "0.15.2",
+    "@hypequery/datasets": "0.13.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hypequery/hypequery.git",
+    "directory": "packages/react"
+  },
+  "homepage": "https://hypequery.com",
+  "bugs": {
+    "url": "https://github.com/hypequery/hypequery/issues"
   },
   "publishConfig": {
     "access": "public"