@hypequery/react 0.6.3 → 0.7.0

package/README.md

@@ -85,6 +85,39 @@ export const { useMetric, useDataset } =
   });
 ```
 
+## Use Python datasets
+
+Generate a TypeScript client file from the Python build contract with
+`hypequery generate:client client-contract.json --output src/hypequery-client.ts`.
+Use its API type and route map directly:
+
+```tsx
+import { createAnalyticsHooks } from '@hypequery/react';
+import { clientManifest, type ClientApi } from './hypequery-client.js';
+
+export const { useDataset, useMetric, useInfiniteDataset } =
+  createAnalyticsHooks<ClientApi>({
+    baseUrl: 'https://analytics.example.com',
+    manifest: clientManifest,
+    token: () => getShortLivedUserToken(),
+  });
+```
+
+Use the endpoint origin as `baseUrl`: generated paths already contain the full
+installed mount prefix. Every request sends its endpoint schema hash. A `409`
+with `CLIENT_SCHEMA_CHANGED` requires explicit regeneration and review; the client
+does not fetch a replacement schema or refresh authentication for that response.
+TanStack Query retry/refetch policies remain configurable by your application.
+Use a new client or cache scope when the deployment, user or authorization scope
+changes; a token resolver changing its return value does not invalidate cached data.
+
+Literal selections expose their selected fields. Omitted measures use the exported
+`defaultMeasures`; `measures: []` selects none. Numeric dimension values may be
+numbers or strings, unknown/related nullability includes null, and aggregates use
+strings or null. A time bucket may be null. Widened query inputs retain optional
+fields because their actual selection is known only at runtime. Existing server
+inference and handwritten API types remain supported.
+
 ## Build the dashboard
 
 ```tsx

package/dist/client.d.ts

@@ -5,10 +5,14 @@ export type ApiContract = Record<string, {
 export interface QueryMethodConfig {
     method?: string;
     path?: string;
+    /** Generated endpoint schema precondition. A mismatch requires explicit regeneration/refresh. */
+    schemaHash?: string;
 }
 export interface RouteManifestEntry {
     method?: string;
     path?: string;
+    /** Generated endpoint schema precondition. A mismatch requires explicit regeneration/refresh. */
+    schemaHash?: string;
 }
 export type RouteManifest = Record<string, RouteManifestEntry>;
 type HeaderMap = Record<string, string | undefined>;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAE/D,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AACpD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAC9E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAE3F,MAAM,WAAW,qBAAqB,CAAC,GAAG,SAAS,WAAW,GAAG,WAAW;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,gGAAgG;IAChG,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AAqED,MAAM,WAAW,eAAe,CAAC,GAAG,SAAS,WAAW,GAAG,WAAW;IACpE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzH;AAID,wBAAgB,qBAAqB,CAAC,GAAG,SAAS,WAAW,GAAG,WAAW,EACzE,MAAM,EAAE,qBAAqB,CAAC,GAAG,CAAC,GACjC,eAAe,CAAC,GAAG,CAAC,CAwFtB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAE/D,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AACpD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAC9E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAE3F,MAAM,WAAW,qBAAqB,CAAC,GAAG,SAAS,WAAW,GAAG,WAAW;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,gGAAgG;IAChG,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AAqED,MAAM,WAAW,eAAe,CAAC,GAAG,SAAS,WAAW,GAAG,WAAW;IACpE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzH;AAID,wBAAgB,qBAAqB,CAAC,GAAG,SAAS,WAAW,GAAG,WAAW,EACzE,MAAM,EAAE,qBAAqB,CAAC,GAAG,CAAC,GACjC,eAAe,CAAC,GAAG,CAAC,CAyFtB"}

package/dist/client.js

@@ -1,8 +1,9 @@
+import { clientSchemaHeaders } from './utils/client-schema-headers.js';
 import { HttpError } from './errors.js';
 const normalizeMethodConfig = (source) => {
     if (!source)
         return {};
-    return Object.fromEntries(Object.entries(source).map(([key, value]) => [key, { method: value.method ?? 'GET', path: value.path }]));
+    return Object.fromEntries(Object.entries(source).map(([key, value]) => [key, { method: value.method ?? 'GET', path: value.path, schemaHash: value.schemaHash }]));
 };
 const deriveMethodConfig = (api) => {
     if (typeof api !== 'object' || api === null)
@@ -62,11 +63,10 @@ let clientSequence = 0;
 export function createHypequeryClient(config) {
     const { baseUrl, fetchFn = fetch, headers, token, config: explicitConfig = {}, manifest, onUnauthorized, api, } = config;
     const cacheKey = config.cacheKey ?? `client:${++clientSequence}`;
-    const finalConfig = {
-        ...deriveMethodConfig(api),
-        ...(manifest ? normalizeMethodConfig(manifest) : {}),
-        ...explicitConfig,
-    };
+    const finalConfig = Object.assign(Object.create(null), deriveMethodConfig(api), manifest ? normalizeMethodConfig(manifest) : {});
+    for (const [name, override] of Object.entries(explicitConfig)) {
+        finalConfig[name] = { ...finalConfig[name], ...override };
+    }
     const request = async (name, input, defaultMethod = 'GET', extraHeaders) => {
         const methodConfig = finalConfig[name];
         if (name.includes(':') && !methodConfig?.path) {
@@ -100,12 +100,12 @@ export function createHypequeryClient(config) {
             ]);
             return fetchFn(finalUrl, {
                 method,
-                headers: {
+                headers: clientSchemaHeaders({
                     ...resolvedHeaders,
                     ...(resolvedToken ? { authorization: `Bearer ${resolvedToken}` } : {}),
                     ...(extraHeaders ?? {}),
                     ...(body ? { 'content-type': 'application/json' } : {}),
-                },
+                }, methodConfig?.schemaHash),
                 body,
             });
         };

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { createAnalyticsHooks } from './analyticsHooks.js';
 export { createHypequeryClient } from './client.js';
 export { HypequeryProvider, useHypequeryClient } from './provider.js';
 export { HttpError } from './errors.js';
-export type { QueryInput, QueryOutput, HttpMethod } from './types.js';
+export type { QueryInput, QueryOutput, QueryOutputForInput, HttpMethod } from './types.js';
 export type { CreateHooksConfig } from './createHooks.js';
 export type { ApiContract, HeadersInput, HypequeryClient, HypequeryClientConfig, QueryMethodConfig, RouteManifest, RouteManifestEntry, TokenInput, } from './client.js';
 export type { HypequeryProviderProps } from './provider.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3F,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/provider.d.ts

@@ -7,7 +7,7 @@ export interface HypequeryProviderProps<Api extends ApiContract = ApiContract> {
     /** Reuse an application's existing TanStack Query client when supplied. */
     queryClient?: QueryClient;
 }
-export declare function HypequeryProvider<Api extends ApiContract>({ client, children, queryClient, }: HypequeryProviderProps<Api>): import("react/jsx-runtime").JSX.Element;
+export declare function HypequeryProvider<Api extends ApiContract>({ client, children, queryClient, }: HypequeryProviderProps<Api>): import("react").JSX.Element;
 export declare function useHypequeryClient<Api extends ApiContract = ApiContract>(): HypequeryClient<Api>;
 export declare function useOptionalHypequeryClient<Api extends ApiContract = ApiContract>(): HypequeryClient<Api> | null;
 //# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAIhE,MAAM,WAAW,sBAAsB,CAAC,GAAG,SAAS,WAAW,GAAG,WAAW;IAC3E,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,EAAE,SAAS,CAAC;IACpB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,GAAG,SAAS,WAAW,EAAE,EACzD,MAAM,EACN,QAAQ,EACR,WAAW,GACZ,EAAE,sBAAsB,CAAC,GAAG,CAAC,2CAS7B;AAED,wBAAgB,kBAAkB,CAAC,GAAG,SAAS,WAAW,GAAG,WAAW,0BAMvE;AAED,wBAAgB,0BAA0B,CAAC,GAAG,SAAS,WAAW,GAAG,WAAW,KACvC,eAAe,CAAC,GAAG,CAAC,GAAG,IAAI,CACnE"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAIhE,MAAM,WAAW,sBAAsB,CAAC,GAAG,SAAS,WAAW,GAAG,WAAW;IAC3E,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,EAAE,SAAS,CAAC;IACpB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,GAAG,SAAS,WAAW,EAAE,EACzD,MAAM,EACN,QAAQ,EACR,WAAW,GACZ,EAAE,sBAAsB,CAAC,GAAG,CAAC,+BAS7B;AAED,wBAAgB,kBAAkB,CAAC,GAAG,SAAS,WAAW,GAAG,WAAW,0BAMvE;AAED,wBAAgB,0BAA0B,CAAC,GAAG,SAAS,WAAW,GAAG,WAAW,KACvC,eAAe,CAAC,GAAG,CAAC,GAAG,IAAI,CACnE"}

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { ClientOutputForInput } from './utils/client-projection.js';
 export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
 export type KnownStringKeys<T> = {
     [K in keyof T]: string extends K ? never : K extends string ? K : never;
@@ -53,10 +54,12 @@ type MetricOutputForInput<TInfo, TInput, TFallback> = TInfo extends {
 } & {
     [K in TMetricName]?: string | null;
 } & PeriodSelection<TInput>> : TFallback;
-export type QueryOutputForInput<Api, Name extends ExtractNames<Api>, TInput> = SemanticInfo<Api, Name> extends infer Info ? Info extends {
+type LegacyOutputForInput<Api, Name extends ExtractNames<Api>, TInput> = [SemanticInfo<Api, Name>] extends [never] ? QueryOutput<Api, Name> : SemanticInfo<Api, Name> extends infer Info ? Info extends {
     kind: 'dataset';
 } ? DatasetOutputForInput<Info, TInput, QueryOutput<Api, Name>> : Info extends {
     kind: 'metric';
 } ? MetricOutputForInput<Info, TInput, QueryOutput<Api, Name>> : QueryOutput<Api, Name> : QueryOutput<Api, Name>;
+/** Narrow generated client rows while retaining the legacy semantic and ordinary API contracts. */
+export type QueryOutputForInput<Api, Name extends ExtractNames<Api>, TInput> = '__hypequeryClientSemantic' extends keyof Api[Name] ? ClientOutputForInput<NonNullable<Api[Name]['__hypequeryClientSemantic']>, TInput, QueryOutput<Api, Name>> : LegacyOutputForInput<Api, Name, TInput>;
 export {};
 //# sourceMappingURL=types.d.ts.map

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/dist/utils/client-projection.d.ts

@@ -0,0 +1,48 @@
+/** Projection for the versioned data-only client contract emitted by generate:client. */
+type WireValue<Definition> = Definition extends {
+    wireType: infer Wire;
+    nullable: infer Nullable;
+} ? (Wire extends 'number-or-string' ? number | string : Wire extends 'number' ? number : Wire extends 'boolean' ? boolean : string) | (Nullable extends false ? never : null) : unknown;
+type ArrayNames<Value> = NonNullable<Value> extends readonly (infer Name)[] ? Name : never;
+type IsUnion<T, U = T> = T extends unknown ? ([U] extends [T] ? false : true) : never;
+/** Names one fixed tuple always selects: an element typed as a union may name any of them. */
+type TupleNames<Tuple> = Tuple extends readonly [infer Head, ...infer Rest] ? (IsUnion<Head> extends true ? never : Head) | TupleNames<Rest> : never;
+/** Names every alternative of a (possibly union-typed) tuple selection selects. */
+type CertainNames<Selection> = (Selection extends unknown ? (names: TupleNames<Selection>) => void : never) extends (names: infer Names) => void ? Names : never;
+type SelectedFields<Definitions, Input, Key extends string, Defaults = never> = Key extends keyof Input ? Input extends Record<Key, readonly unknown[]> ? number extends Input[Key]['length'] ? {
+    [Name in Extract<ArrayNames<Input[Key]>, keyof Definitions>]?: WireValue<Definitions[Name]>;
+} : {
+    [Name in Extract<CertainNames<Input[Key]>, keyof Definitions>]-?: WireValue<Definitions[Name]>;
+} & {
+    [Name in Exclude<Extract<ArrayNames<Input[Key]>, keyof Definitions>, CertainNames<Input[Key]>>]?: WireValue<Definitions[Name]>;
+} : {
+    [Name in Extract<ArrayNames<Input[Key]> | Defaults, keyof Definitions>]?: WireValue<Definitions[Name]>;
+} : {
+    [Name in Extract<Defaults, keyof Definitions>]-?: WireValue<Definitions[Name]>;
+};
+type Period<Input> = Input extends {
+    by: string;
+} ? {
+    period: string | null;
+} : 'by' extends keyof Input ? {
+    period?: string | null;
+} : {};
+type ProjectedOutput<Output, Row> = Omit<Output, 'data'> & {
+    data: Row[];
+};
+export type ClientOutputForInput<Info, Input, Fallback> = [Info] extends [never] ? Fallback : Input extends unknown ? Info extends {
+    version: 1;
+    kind: 'dataset';
+    dimensions: infer Dimensions;
+    measures: infer Measures;
+    defaultMeasures: readonly (infer Default)[];
+} ? ProjectedOutput<Fallback, SelectedFields<Dimensions, Input, 'dimensions'> & SelectedFields<Measures, Input, 'measures', Default> & Period<Input>> : Info extends {
+    version: 1;
+    kind: 'metric';
+    dimensions: infer Dimensions;
+    metricName: infer Name extends string;
+} ? ProjectedOutput<Fallback, SelectedFields<Dimensions, Input, 'dimensions'> & {
+    [Key in Name]: string | null;
+} & Period<Input>> : Fallback : never;
+export {};
+//# sourceMappingURL=client-projection.d.ts.map

package/dist/utils/client-projection.d.ts.map

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

package/dist/utils/client-projection.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/client-schema-headers.d.ts

@@ -0,0 +1,3 @@
+/** A generated precondition wins over differently cased user/header overrides. */
+export declare function clientSchemaHeaders(headers: Record<string, string>, schemaHash?: string): Record<string, string>;
+//# sourceMappingURL=client-schema-headers.d.ts.map

package/dist/utils/client-schema-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-schema-headers.d.ts","sourceRoot":"","sources":["../../src/utils/client-schema-headers.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMhH"}

package/dist/utils/client-schema-headers.js

@@ -0,0 +1,9 @@
+/** A generated precondition wins over differently cased user/header overrides. */
+export function clientSchemaHeaders(headers, schemaHash) {
+    if (!schemaHash)
+        return headers;
+    return {
+        ...Object.fromEntries(Object.entries(headers).filter(([name]) => name.toLowerCase() !== 'x-hypequery-client-schema')),
+        'X-Hypequery-Client-Schema': schemaHash,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/react",
-  "version": "0.6.3",
+  "version": "0.7.0",
   "description": "Type-safe React and TanStack Query hooks for ClickHouse analytics, metrics, and datasets",
   "keywords": [
     "react",
@@ -23,27 +23,33 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/**/*.type-test.*",
+    "!dist/**/__tests__/**",
+    "!dist/**/tests/**",
+    "!dist/**/type-tests/**"
   ],
   "sideEffects": false,
   "peerDependencies": {
-    "@tanstack/react-query": "^5.104.0",
+    "@tanstack/react-query": "^5.104.5",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
-    "@tanstack/react-query": "^5.104.0",
-    "@testing-library/react": "^14.2.1",
-    "@types/react": "^18.2.43",
-    "@types/react-dom": "^18.2.18",
-    "@vitest/coverage-v8": "^5.0.2",
-    "jsdom": "^27.4.0",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "typescript": "^5.7.3",
-    "vitest": "^5.0.2",
-    "@hypequery/serve": "0.19.3",
-    "@hypequery/datasets": "0.21.0"
+    "@tanstack/react-query": "^5.104.5",
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitest/coverage-v8": "^5.0.5",
+    "jsdom": "^30.1.3",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "typescript": "^6.0.3",
+    "vitest": "^5.0.5",
+    "@hypequery/datasets": "0.24.0",
+    "@hypequery/serve": "0.22.0"
   },
   "repository": {
     "type": "git",

package/dist/analyticsHooks.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=analyticsHooks.test.d.ts.map

package/dist/analyticsHooks.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"analyticsHooks.test.d.ts","sourceRoot":"","sources":["../src/analyticsHooks.test.tsx"],"names":[],"mappings":""}

package/dist/analyticsHooks.test.js

@@ -1,98 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { renderHook, waitFor } from '@testing-library/react';
-import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import { createAnalyticsHooks } from './analyticsHooks.js';
-function createWrapper() {
-    const queryClient = new QueryClient({
-        defaultOptions: {
-            queries: { retry: false },
-        },
-    });
-    return ({ children }) => (_jsx(QueryClientProvider, { client: queryClient, children: children }));
-}
-function mockSuccessResponse(data) {
-    return {
-        ok: true,
-        status: 200,
-        json: () => Promise.resolve(data),
-    };
-}
-describe('createAnalyticsHooks', () => {
-    const fetchMock = vi.fn();
-    beforeEach(() => {
-        fetchMock.mockReset();
-    });
-    it('queries metrics through useMetric with metric names only', async () => {
-        fetchMock.mockResolvedValue(mockSuccessResponse({ data: [{ totalRevenue: 42 }] }));
-        const { useMetric } = createAnalyticsHooks({
-            baseUrl: '/api/analytics',
-            fetchFn: fetchMock,
-            metrics: ['totalRevenue', 'monthlyRevenue'],
-            config: {
-                totalRevenue: { method: 'POST', path: '/api/analytics/metrics/totalRevenue' },
-            },
-        });
-        const { result } = renderHook(() => useMetric('totalRevenue', { dimensions: ['country'] }), { wrapper: createWrapper() });
-        await waitFor(() => {
-            expect(result.current.data).toEqual({ data: [{ totalRevenue: 42 }] });
-        });
-        expect(fetchMock).toHaveBeenCalledWith('/api/analytics/metrics/totalRevenue', expect.objectContaining({
-            method: 'POST',
-            body: JSON.stringify({ dimensions: ['country'] }),
-        }));
-    });
-    it('queries datasets through useDataset without exposing dataset: keys', async () => {
-        fetchMock.mockResolvedValue(mockSuccessResponse({ data: [{ country: 'US', revenue: 120 }] }));
-        const { useDataset } = createAnalyticsHooks({
-            baseUrl: '/api/analytics',
-            fetchFn: fetchMock,
-            metrics: [],
-            config: {
-                'dataset:orders': { method: 'POST', path: '/api/analytics/datasets/orders/query' },
-            },
-        });
-        const { result } = renderHook(() => useDataset('orders', { dimensions: ['country'], measures: ['revenue'] }), { wrapper: createWrapper() });
-        await waitFor(() => {
-            expect(result.current.data).toEqual({ data: [{ country: 'US', revenue: 120 }] });
-        });
-        expect(fetchMock).toHaveBeenCalledWith('/api/analytics/datasets/orders/query', expect.objectContaining({
-            method: 'POST',
-            body: JSON.stringify({ dimensions: ['country'], measures: ['revenue'] }),
-        }));
-    });
-    it('supports metric names from the declared semantic metric list', async () => {
-        fetchMock.mockResolvedValue(mockSuccessResponse({ data: [{ period: '2025-01-01', monthlyRevenue: 90 }] }));
-        const { useMetric } = createAnalyticsHooks({
-            baseUrl: '/api/analytics',
-            fetchFn: fetchMock,
-            metrics: ['totalRevenue', 'monthlyRevenue'],
-            config: {
-                monthlyRevenue: { method: 'POST', path: '/api/analytics/metrics/monthlyRevenue' },
-            },
-        });
-        const { result } = renderHook(() => useMetric('monthlyRevenue', { by: 'month' }), { wrapper: createWrapper() });
-        await waitFor(() => {
-            expect(result.current.data).toEqual({ data: [{ period: '2025-01-01', monthlyRevenue: 90 }] });
-        });
-    });
-    it('resolves semantic config paths against an absolute baseUrl host', async () => {
-        fetchMock.mockResolvedValue(mockSuccessResponse({ data: [{ totalRevenue: 42 }] }));
-        const { useMetric } = createAnalyticsHooks({
-            baseUrl: 'https://api.example.com/hypequery',
-            fetchFn: fetchMock,
-            metrics: ['totalRevenue', 'monthlyRevenue'],
-            config: {
-                totalRevenue: { method: 'POST', path: '/api/analytics/metrics/totalRevenue' },
-            },
-        });
-        const { result } = renderHook(() => useMetric('totalRevenue', { dimensions: ['country'] }), { wrapper: createWrapper() });
-        await waitFor(() => {
-            expect(result.current.data).toEqual({ data: [{ totalRevenue: 42 }] });
-        });
-        expect(fetchMock).toHaveBeenCalledWith('https://api.example.com/api/analytics/metrics/totalRevenue', expect.objectContaining({
-            method: 'POST',
-            body: JSON.stringify({ dimensions: ['country'] }),
-        }));
-    });
-});

package/dist/createHooks.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=createHooks.test.d.ts.map

package/dist/createHooks.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createHooks.test.d.ts","sourceRoot":"","sources":["../src/createHooks.test.tsx"],"names":[],"mappings":""}

package/dist/createHooks.test.js

@@ -1,772 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { renderHook, waitFor, act } from '@testing-library/react';
-import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import { createHooks, queryOptions } from './createHooks.js';
-import { HttpError } from './errors.js';
-function createWrapper() {
-    const queryClient = new QueryClient({
-        defaultOptions: {
-            queries: { retry: false },
-            mutations: { retry: false },
-        },
-    });
-    return ({ children }) => (_jsx(QueryClientProvider, { client: queryClient, children: children }));
-}
-function mockSuccessResponse(data) {
-    return {
-        ok: true,
-        status: 200,
-        json: () => Promise.resolve(data),
-    };
-}
-function mockErrorResponse(status, body) {
-    return {
-        ok: false,
-        status,
-        text: () => Promise.resolve(JSON.stringify(body)),
-    };
-}
-describe('createHooks', () => {
-    describe('Basic functionality', () => {
-        const fetchMock = vi.fn();
-        const { useQuery, useMutation } = createHooks({
-            baseUrl: 'https://example.com/api',
-            fetchFn: fetchMock,
-        });
-        beforeEach(() => {
-            fetchMock.mockReset();
-        });
-        it('executes queries via fetch', async () => {
-            fetchMock.mockResolvedValue(mockSuccessResponse({ total: 42 }));
-            const { result } = renderHook(() => useQuery('weeklyRevenue', { startDate: '2025-01-01' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => {
-                expect(result.current.data).toEqual({ total: 42 });
-            });
-            expect(fetchMock).toHaveBeenCalledWith('https://example.com/api/weeklyRevenue?startDate=2025-01-01', expect.objectContaining({ method: 'GET' }));
-        });
-        it('executes mutations via fetch', async () => {
-            fetchMock.mockResolvedValue(mockSuccessResponse({ success: true }));
-            const { result } = renderHook(() => useMutation('rebuildMetrics'), {
-                wrapper: createWrapper()
-            });
-            await result.current.mutateAsync({ force: true });
-            // Mutations default to POST
-            expect(fetchMock).toHaveBeenCalledWith('https://example.com/api/rebuildMetrics', expect.objectContaining({
-                method: 'POST',
-                body: JSON.stringify({ force: true }),
-            }));
-        });
-        it('allows queries with no input parameters', async () => {
-            fetchMock.mockResolvedValue(mockSuccessResponse({ status: 'ok' }));
-            const { result } = renderHook(() => useQuery('noInput'), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.data).toEqual({ status: 'ok' }));
-            expect(fetchMock).toHaveBeenCalledWith('https://example.com/api/noInput', expect.objectContaining({ method: 'GET' }));
-        });
-        it('invokes header factory per request', async () => {
-            const headerFactory = vi.fn()
-                .mockReturnValueOnce({ 'x-token': 'first' })
-                .mockReturnValueOnce({ 'x-token': 'second' });
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-                headers: headerFactory,
-            });
-            fetchMock.mockResolvedValue(mockSuccessResponse({ name: 'User' }));
-            const first = renderHook(() => useQuery('getUser', { id: '1' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => {
-                expect(first.result.current.data).toEqual({ name: 'User' });
-            });
-            const second = renderHook(() => useQuery('getUser', { id: '2' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => {
-                expect(second.result.current.data).toEqual({ name: 'User' });
-            });
-            expect(headerFactory).toHaveBeenCalledTimes(2);
-            expect(fetchMock.mock.calls[0][1]?.headers).toMatchObject({ 'x-token': 'first' });
-            expect(fetchMock.mock.calls[1][1]?.headers).toMatchObject({ 'x-token': 'second' });
-        });
-        it('supports an async header factory', async () => {
-            fetchMock.mockResolvedValue(mockSuccessResponse({ name: 'User' }));
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-                headers: async () => ({ authorization: 'Bearer fresh-token' }),
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '1' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock.mock.calls[0][1]?.headers).toMatchObject({ authorization: 'Bearer fresh-token' });
-        });
-        it('calls onUnauthorized and retries once on 401', async () => {
-            fetchMock
-                .mockResolvedValueOnce(mockErrorResponse(401, { error: 'expired' }))
-                .mockResolvedValueOnce(mockSuccessResponse({ name: 'User' }));
-            let token = 'stale';
-            const onUnauthorized = vi.fn(async () => { token = 'refreshed'; });
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-                headers: () => ({ authorization: `Bearer ${token}` }),
-                onUnauthorized,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '1' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(onUnauthorized).toHaveBeenCalledTimes(1);
-            expect(fetchMock).toHaveBeenCalledTimes(2);
-            // The retry uses freshly resolved headers.
-            expect(fetchMock.mock.calls[1][1]?.headers).toMatchObject({ authorization: 'Bearer refreshed' });
-            expect(result.current.data).toEqual({ name: 'User' });
-        });
-        it('throws after a single 401 retry still fails', async () => {
-            fetchMock.mockResolvedValue(mockErrorResponse(401, { error: 'nope' }));
-            const onUnauthorized = vi.fn(async () => { });
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-                onUnauthorized,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '1' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isError).toBe(true));
-            expect(onUnauthorized).toHaveBeenCalledTimes(1);
-            expect(fetchMock).toHaveBeenCalledTimes(2);
-            expect(result.current.error?.status).toBe(401);
-        });
-    });
-    describe('HTTP Method Handling', () => {
-        const fetchMock = vi.fn();
-        beforeEach(() => {
-            fetchMock.mockReset();
-            fetchMock.mockResolvedValue(mockSuccessResponse({ success: true }));
-        });
-        it('defaults to GET when no config provided', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith(expect.stringContaining('?'), expect.objectContaining({ method: 'GET' }));
-        });
-        it('uses POST when explicitly configured', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-                config: {
-                    getUser: { method: 'POST' },
-                },
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith('https://example.com/api/getUser', expect.objectContaining({
-                method: 'POST',
-                body: JSON.stringify({ id: '123' }),
-            }));
-        });
-        it('extracts method config from API object', async () => {
-            const mockApi = {
-                queries: {
-                    getUser: { method: 'GET' },
-                    updateUser: { method: 'PATCH' },
-                },
-            };
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-                api: mockApi,
-            });
-            const { result } = renderHook(() => useQuery('updateUser', { id: '123', name: 'John' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith(expect.any(String), expect.objectContaining({ method: 'PATCH' }));
-        });
-        it('prefers route-level config over endpoint config', async () => {
-            const mockApi = {
-                queries: {
-                    getUser: { method: 'POST' },
-                },
-                _routeConfig: {
-                    getUser: { method: 'GET' },
-                },
-            };
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-                api: mockApi,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith(expect.any(String), expect.objectContaining({ method: 'GET' }));
-        });
-        it('allows explicit config to override API config', async () => {
-            const mockApi = {
-                queries: {
-                    getUser: { method: 'GET' },
-                },
-            };
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-                api: mockApi,
-                config: {
-                    getUser: { method: 'POST' },
-                },
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith('https://example.com/api/getUser', expect.objectContaining({ method: 'POST' }));
-        });
-        it('resolves root-relative config paths against an absolute baseUrl host', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://api.example.com/hypequery',
-                fetchFn: fetchMock,
-                config: {
-                    getUser: { method: 'POST', path: '/api/analytics/queries/getUser' },
-                },
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith('https://api.example.com/api/analytics/queries/getUser', expect.objectContaining({
-                method: 'POST',
-                body: JSON.stringify({ id: '123' }),
-            }));
-        });
-        it('resolves relative config paths against baseUrl', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://api.example.com/hypequery',
-                fetchFn: fetchMock,
-                config: {
-                    getUser: { method: 'POST', path: 'queries/getUser' },
-                },
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith('https://api.example.com/hypequery/queries/getUser', expect.objectContaining({
-                method: 'POST',
-                body: JSON.stringify({ id: '123' }),
-            }));
-        });
-    });
-    describe('Route manifest', () => {
-        const fetchMock = vi.fn();
-        beforeEach(() => {
-            fetchMock.mockReset();
-            fetchMock.mockResolvedValue(mockSuccessResponse({ success: true }));
-        });
-        it('resolves method and path from a manifest', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://api.example.com',
-                fetchFn: fetchMock,
-                manifest: {
-                    getUser: { method: 'POST', path: '/api/analytics/metrics/getUser' },
-                },
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith('https://api.example.com/api/analytics/metrics/getUser', expect.objectContaining({
-                method: 'POST',
-                body: JSON.stringify({ id: '123' }),
-            }));
-        });
-        it('lets explicit config override the manifest', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://api.example.com',
-                fetchFn: fetchMock,
-                manifest: {
-                    getUser: { method: 'POST', path: '/manifest/getUser' },
-                },
-                config: {
-                    getUser: { method: 'POST', path: '/override/getUser' },
-                },
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith('https://api.example.com/override/getUser', expect.objectContaining({ method: 'POST' }));
-        });
-        it('derives method config from an api object exposing manifest()', async () => {
-            const mockApi = {
-                manifest: () => ({
-                    getUser: { method: 'PATCH', path: '/api/analytics/queries/getUser' },
-                }),
-            };
-            const { useQuery } = createHooks({
-                baseUrl: 'https://api.example.com',
-                fetchFn: fetchMock,
-                api: mockApi,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith('https://api.example.com/api/analytics/queries/getUser', expect.objectContaining({ method: 'PATCH' }));
-        });
-        it('throws for an unresolved semantic (dataset:) key', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://api.example.com',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('dataset:orders', { dimensions: ['country'] }), { wrapper: createWrapper() });
-            await waitFor(() => expect(result.current.isError).toBe(true));
-            expect(result.current.error?.message).toContain('No route configured for "dataset:orders"');
-            expect(fetchMock).not.toHaveBeenCalled();
-        });
-    });
-    describe('Query Parameter Serialization', () => {
-        const fetchMock = vi.fn();
-        beforeEach(() => {
-            fetchMock.mockReset();
-            fetchMock.mockResolvedValue(mockSuccessResponse({ success: true }));
-        });
-        it('serializes simple objects as query params for GET requests', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith('https://example.com/api/getUser?id=123', expect.objectContaining({ method: 'GET' }));
-        });
-        it('serializes arrays as multiple query params', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('listItems', { tags: ['react', 'typescript'], limit: 10 }), { wrapper: createWrapper() });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            const callUrl = fetchMock.mock.calls[0][0];
-            expect(callUrl).toContain('tags=react');
-            expect(callUrl).toContain('tags=typescript');
-            expect(callUrl).toContain('limit=10');
-        });
-        it('skips undefined and null values in query params', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('rebuildMetrics', { force: undefined }), { wrapper: createWrapper() });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            const callUrl = fetchMock.mock.calls[0][0];
-            expect(callUrl).not.toContain('force');
-        });
-        it('handles empty objects in GET requests', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('rebuildMetrics', {}), { wrapper: createWrapper() });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith('https://example.com/api/rebuildMetrics', expect.objectContaining({ method: 'GET' }));
-        });
-        it('uses JSON body for POST requests', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-                config: {
-                    getUser: { method: 'POST' },
-                },
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith('https://example.com/api/getUser', expect.objectContaining({
-                method: 'POST',
-                body: JSON.stringify({ id: '123' }),
-                headers: expect.objectContaining({
-                    'content-type': 'application/json',
-                }),
-            }));
-        });
-    });
-    describe('Error Handling', () => {
-        const fetchMock = vi.fn();
-        beforeEach(() => {
-            fetchMock.mockReset();
-        });
-        it('throws error with detailed message on failed request', async () => {
-            fetchMock.mockResolvedValue(mockErrorResponse(404, { message: 'Not found' }));
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isError).toBe(true));
-            expect(result.current.error).toBeInstanceOf(HttpError);
-            expect(result.current.error?.message).toContain('GET request to');
-            expect(result.current.error?.message).toContain('failed with status 404');
-            expect(result.current.error?.status).toBe(404);
-            expect(result.current.error?.body).toEqual({ message: 'Not found' });
-        });
-        it('parses JSON error responses', async () => {
-            fetchMock.mockResolvedValue(mockErrorResponse(400, { error: 'Bad request' }));
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isError).toBe(true));
-            expect(result.current.error).toBeInstanceOf(HttpError);
-            expect(result.current.error?.body).toEqual({ error: 'Bad request' });
-        });
-        it('parses text error responses', async () => {
-            fetchMock.mockResolvedValue({
-                ok: false,
-                status: 500,
-                text: () => Promise.resolve('Internal server error'),
-            });
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isError).toBe(true));
-            expect(result.current.error).toBeInstanceOf(HttpError);
-            expect(result.current.error?.body).toBe('Internal server error');
-        });
-        it('handles network errors', async () => {
-            fetchMock.mockRejectedValue(new Error('Network error'));
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isError).toBe(true));
-            expect(result.current.error?.message).toBe('Network error');
-        });
-    });
-    describe('useQuery Argument Overloads', () => {
-        const fetchMock = vi.fn();
-        beforeEach(() => {
-            fetchMock.mockReset();
-            fetchMock.mockResolvedValue(mockSuccessResponse({ status: 'ok' }));
-        });
-        it('handles useQuery(name) with no input', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('noInput'), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith('https://example.com/api/noInput', expect.any(Object));
-        });
-        it('handles useQuery(name, input)', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalled();
-        });
-        it('handles useQuery(name, options) - options only', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('noInput', { enabled: false, staleTime: 5000 }), { wrapper: createWrapper() });
-            // Should not fetch because enabled: false
-            expect(result.current.isSuccess).toBe(false);
-            expect(fetchMock).not.toHaveBeenCalled();
-        });
-        it('handles useQuery(name, input, options)', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }, { staleTime: 5000 }), { wrapper: createWrapper() });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalled();
-        });
-        it('correctly distinguishes input from options using isQueryOptions', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            // Input with 'enabled' field should be treated as input, not options
-            const { result: result1 } = renderHook(() => useQuery('rebuildMetrics', { force: true }), { wrapper: createWrapper() });
-            await waitFor(() => expect(result1.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalled();
-            fetchMock.mockClear();
-            // Options object should disable the query
-            renderHook(() => useQuery('noInput', { enabled: false, staleTime: 1000 }), { wrapper: createWrapper() });
-            expect(fetchMock).not.toHaveBeenCalled();
-        });
-        it('uses queryOptions() helper for explicit option marking', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            // Using queryOptions() helper ensures options are recognized
-            const { result } = renderHook(() => useQuery('noInput', queryOptions({ enabled: false })), { wrapper: createWrapper() });
-            // Query should be disabled
-            expect(result.current.isLoading).toBe(false);
-            expect(fetchMock).not.toHaveBeenCalled();
-        });
-    });
-    describe('Configuration', () => {
-        const fetchMock = vi.fn();
-        beforeEach(() => {
-            fetchMock.mockReset();
-            fetchMock.mockResolvedValue(mockSuccessResponse({ success: true }));
-        });
-        it('includes custom headers in requests', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-                headers: {
-                    'Authorization': 'Bearer token123',
-                    'X-Custom': 'value',
-                },
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalledWith(expect.any(String), expect.objectContaining({
-                headers: expect.objectContaining({
-                    'Authorization': 'Bearer token123',
-                    'X-Custom': 'value',
-                }),
-            }));
-        });
-        it('handles baseUrl with trailing slash', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api/',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            const callUrl = fetchMock.mock.calls[0][0];
-            expect(callUrl).toContain('https://example.com/api/getUser');
-            expect(callUrl).not.toContain('//getUser');
-        });
-        it('handles baseUrl without trailing slash', async () => {
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            const callUrl = fetchMock.mock.calls[0][0];
-            expect(callUrl).toContain('https://example.com/api/getUser');
-        });
-        it('throws error when baseUrl is missing', () => {
-            expect(() => {
-                createHooks({
-                    baseUrl: '',
-                    fetchFn: fetchMock,
-                });
-            }).not.toThrow();
-            const { useQuery } = createHooks({
-                baseUrl: '',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('getUser', { id: '123' }), {
-                wrapper: createWrapper(),
-            });
-            // Should throw during query execution
-            waitFor(() => {
-                expect(result.current.error?.message).toContain('baseUrl is required');
-            });
-        });
-    });
-    describe('Edge Cases', () => {
-        const fetchMock = vi.fn();
-        beforeEach(() => {
-            fetchMock.mockReset();
-        });
-        it('handles empty response body', async () => {
-            fetchMock.mockResolvedValue({
-                ok: true,
-                status: 204,
-                json: () => Promise.resolve(null),
-            });
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('noInput'), {
-                wrapper: createWrapper(),
-            });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(result.current.data).toBe(null);
-        });
-        it('handles non-JSON text responses', async () => {
-            fetchMock.mockResolvedValue({
-                ok: true,
-                status: 200,
-                json: () => Promise.reject(new Error('Not JSON')),
-                text: () => Promise.resolve('Plain text response'),
-            });
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useQuery('noInput'), {
-                wrapper: createWrapper(),
-            });
-            // This will fail because json() rejects, but shows the edge case
-            await waitFor(() => expect(result.current.isError).toBe(true));
-        });
-        it('passes through TanStack Query options correctly', async () => {
-            fetchMock.mockResolvedValue(mockSuccessResponse({ status: 'ok' }));
-            const { useQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result, rerender } = renderHook(({ enabled }) => useQuery('noInput', { enabled, staleTime: 1000 }), {
-                wrapper: createWrapper(),
-                initialProps: { enabled: false },
-            });
-            // Should not fetch when disabled (now requires 2+ option keys to be recognized)
-            expect(fetchMock).not.toHaveBeenCalled();
-            // Enable the query
-            rerender({ enabled: true });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            expect(fetchMock).toHaveBeenCalled();
-        });
-    });
-    describe('useMutation', () => {
-        const fetchMock = vi.fn();
-        beforeEach(() => {
-            fetchMock.mockReset();
-            fetchMock.mockResolvedValue(mockSuccessResponse({ success: true }));
-        });
-        it('defaults to POST method', async () => {
-            const { useMutation } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useMutation('updateUser'), {
-                wrapper: createWrapper(),
-            });
-            await result.current.mutateAsync({ id: '123', name: 'John' });
-            expect(fetchMock).toHaveBeenCalledWith('https://example.com/api/updateUser', expect.objectContaining({
-                method: 'POST',
-                body: JSON.stringify({ id: '123', name: 'John' }),
-            }));
-        });
-        it('allows custom HTTP methods via config', async () => {
-            const { useMutation } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-                config: {
-                    updateUser: { method: 'PATCH' },
-                },
-            });
-            const { result } = renderHook(() => useMutation('updateUser'), {
-                wrapper: createWrapper(),
-            });
-            await result.current.mutateAsync({ id: '123', name: 'John' });
-            expect(fetchMock).toHaveBeenCalledWith('https://example.com/api/updateUser', expect.objectContaining({
-                method: 'PATCH',
-                body: JSON.stringify({ id: '123', name: 'John' }),
-            }));
-        });
-        it('passes through mutation options', async () => {
-            const onSuccess = vi.fn();
-            const onError = vi.fn();
-            const { useMutation } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useMutation('updateUser', { onSuccess, onError }), { wrapper: createWrapper() });
-            await result.current.mutateAsync({ id: '123', name: 'John' });
-            expect(onSuccess).toHaveBeenCalled();
-            expect(onError).not.toHaveBeenCalled();
-        });
-        it('handles mutation errors', async () => {
-            fetchMock.mockResolvedValue(mockErrorResponse(400, { error: 'Invalid data' }));
-            const { useMutation } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-            });
-            const { result } = renderHook(() => useMutation('updateUser'), {
-                wrapper: createWrapper(),
-            });
-            await expect(result.current.mutateAsync({ id: '123', name: 'John' })).rejects.toThrow();
-        });
-    });
-    describe('useInfiniteQuery', () => {
-        const fetchMock = vi.fn();
-        beforeEach(() => {
-            fetchMock.mockReset();
-        });
-        it('paginates using meta.pagination and advances the offset', async () => {
-            fetchMock
-                .mockResolvedValueOnce(mockSuccessResponse({
-                data: [{ id: 'a' }],
-                meta: { pagination: { limit: 1, offset: 0, hasMore: true } },
-            }))
-                .mockResolvedValueOnce(mockSuccessResponse({
-                data: [{ id: 'b' }],
-                meta: { pagination: { limit: 1, offset: 1, hasMore: false } },
-            }));
-            const { useInfiniteQuery } = createHooks({
-                baseUrl: 'https://example.com/api',
-                fetchFn: fetchMock,
-                config: { listItems: { method: 'POST', path: '/datasets/items/query' } },
-            });
-            const { result } = renderHook(() => useInfiniteQuery('listItems', { tags: [], limit: 1 }), { wrapper: createWrapper() });
-            await waitFor(() => expect(result.current.isSuccess).toBe(true));
-            // First page requests offset 0 and opts into meta.
-            expect(fetchMock.mock.calls[0][1]?.headers['x-include-meta']).toBe('true');
-            expect(fetchMock.mock.calls[0][1]?.body).toBe(JSON.stringify({ tags: [], limit: 1, offset: 0 }));
-            expect(result.current.hasNextPage).toBe(true);
-            await act(async () => {
-                await result.current.fetchNextPage();
-            });
-            await waitFor(() => expect(result.current.hasNextPage).toBe(false));
-            // Second page advances offset by the page size.
-            expect(fetchMock.mock.calls[1][1]?.body).toBe(JSON.stringify({ tags: [], limit: 1, offset: 1 }));
-            expect(result.current.data?.pages).toHaveLength(2);
-        });
-    });
-});

package/dist/provider.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=provider.test.d.ts.map

package/dist/provider.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"provider.test.d.ts","sourceRoot":"","sources":["../src/provider.test.tsx"],"names":[],"mappings":""}

package/dist/provider.test.js

@@ -1,53 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { renderHook, waitFor } from '@testing-library/react';
-import { QueryClient } from '@tanstack/react-query';
-import { describe, expect, it, vi } from 'vitest';
-import { createHypequeryClient } from './client.js';
-import { createHooks } from './createHooks.js';
-import { HypequeryProvider } from './provider.js';
-function success(data) {
-    return { ok: true, status: 200, json: async () => data };
-}
-describe('HypequeryProvider', () => {
-    it('configures generated hooks once and supplies their TanStack Query client', async () => {
-        const fetchFn = vi.fn().mockResolvedValue(success({ message: 'Hello Luke' }));
-        const client = createHypequeryClient({
-            baseUrl: 'https://acme.hypequery.cloud/v1/analytics/production',
-            token: async () => 'browser-token',
-            fetchFn: fetchFn,
-            manifest: { greeting: { method: 'GET', path: 'queries/greeting' } },
-        });
-        const { useQuery } = createHooks();
-        const wrapper = ({ children }) => (_jsx(HypequeryProvider, { client: client, children: children }));
-        const { result } = renderHook(() => useQuery('greeting', { name: 'Luke' }), { wrapper });
-        await waitFor(() => expect(result.current.data).toEqual({ message: 'Hello Luke' }));
-        expect(fetchFn).toHaveBeenCalledWith('https://acme.hypequery.cloud/v1/analytics/production/queries/greeting?name=Luke', expect.objectContaining({
-            headers: expect.objectContaining({ authorization: 'Bearer browser-token' }),
-        }));
-    });
-    it('isolates cached responses when the provider client changes', async () => {
-        const firstFetch = vi.fn().mockResolvedValue(success({ message: 'First user' }));
-        const secondFetch = vi.fn().mockResolvedValue(success({ message: 'Second user' }));
-        const createClient = (fetchFn) => createHypequeryClient({
-            baseUrl: 'https://acme.hypequery.cloud/v1/analytics/production',
-            fetchFn: fetchFn,
-            manifest: { greeting: { method: 'GET', path: 'queries/greeting' } },
-        });
-        const firstClient = createClient(firstFetch);
-        const secondClient = createClient(secondFetch);
-        const queryClient = new QueryClient({
-            defaultOptions: { queries: { retry: false } },
-        });
-        const { useQuery } = createHooks();
-        let activeClient = firstClient;
-        const wrapper = ({ children }) => (_jsx(HypequeryProvider, { client: activeClient, queryClient: queryClient, children: children }));
-        const view = renderHook(() => useQuery('greeting', { name: 'Luke' }), { wrapper });
-        await waitFor(() => expect(view.result.current.data).toEqual({ message: 'First user' }));
-        activeClient = secondClient;
-        view.rerender();
-        await waitFor(() => expect(view.result.current.data).toEqual({ message: 'Second user' }));
-        expect(firstClient.cacheKey).not.toBe(secondClient.cacheKey);
-        expect(firstFetch).toHaveBeenCalledTimes(1);
-        expect(secondFetch).toHaveBeenCalledTimes(1);
-    });
-});