@hypequery/react 0.0.1 → 0.0.3

package/dist/createHooks.d.ts

@@ -4,41 +4,25 @@ import { HttpError } from './errors.js';
 export interface QueryMethodConfig {
     method?: string;
 }
-export interface CreateHooksConfig<TApi = any> {
+export interface CreateHooksConfig<TApi = Record<string, {
+    input: unknown;
+    output: unknown;
+}>> {
     baseUrl: string;
     fetchFn?: typeof fetch;
     headers?: Record<string, string>;
     config?: Record<string, QueryMethodConfig>;
     api?: TApi;
 }
-/**
- * Symbol used to mark objects as query options (not input)
- * @internal
- */
 declare const OPTIONS_SYMBOL: unique symbol;
-/**
- * Helper to explicitly mark an object as query options
- * Prevents ambiguity when query input and options have overlapping properties
- *
- * @example
- * ```ts
- * // Without helper - ambiguous (could be input or options)
- * useQuery('getData', { enabled: true, staleTime: 5000 })
- *
- * // With helper - explicit
- * useQuery('getData', queryOptions({ enabled: true, staleTime: 5000 }))
- * ```
- */
 export declare function queryOptions<T extends object>(opts: T): T & {
     [OPTIONS_SYMBOL]: true;
 };
-export declare function createHooks<Api extends {
-    [K in keyof Api]: {
-        input: unknown;
-        output: unknown;
-    };
-}>(config: CreateHooksConfig): {
-    readonly useQuery: <Name extends ExtractNames<Api>>(...args: QueryInput<Api, Name> extends unknown ? unknown extends QueryInput<Api, Name> ? [name: Name, options?: Omit<TanstackUseQueryOptions<QueryOutput<Api, Name>, HttpError, QueryOutput<Api, Name>, ["hypequery", Name, QueryInput<Api, Name>]>, "queryKey" | "queryFn"> | undefined] : [name: Name, input: QueryInput<Api, Name>, options?: Omit<TanstackUseQueryOptions<QueryOutput<Api, Name>, HttpError, QueryOutput<Api, Name>, ["hypequery", Name, QueryInput<Api, Name>]>, "queryKey" | "queryFn"> | undefined] : [name: Name, input: QueryInput<Api, Name>, options?: Omit<TanstackUseQueryOptions<QueryOutput<Api, Name>, HttpError, QueryOutput<Api, Name>, ["hypequery", Name, QueryInput<Api, Name>]>, "queryKey" | "queryFn"> | undefined]) => UseQueryResult<QueryOutput<Api, Name>, HttpError>;
+export declare function createHooks<Api extends Record<string, {
+    input: any;
+    output: any;
+}>>(config: CreateHooksConfig<Api>): {
+    readonly useQuery: <Name extends ExtractNames<Api>>(...args: QueryInput<Api, Name> extends never ? [name: Name, options?: Omit<TanstackUseQueryOptions<QueryOutput<Api, Name>, HttpError, QueryOutput<Api, Name>, QueryInput<Api, Name> extends never ? ["hypequery", Name] : ["hypequery", Name, QueryInput<Api, Name>]>, "queryKey" | "queryFn"> | undefined] : [name: Name, input: QueryInput<Api, Name>, options?: Omit<TanstackUseQueryOptions<QueryOutput<Api, Name>, HttpError, QueryOutput<Api, Name>, QueryInput<Api, Name> extends never ? ["hypequery", Name] : ["hypequery", Name, QueryInput<Api, Name>]>, "queryKey" | "queryFn"> | undefined]) => UseQueryResult<QueryOutput<Api, Name>, HttpError>;
     readonly useMutation: <Name extends ExtractNames<Api>>(name: Name, options?: Omit<TanstackUseMutationOptions<QueryOutput<Api, Name>, HttpError, QueryInput<Api, Name>, unknown>, "mutationFn">) => UseMutationResult<QueryOutput<Api, Name>, HttpError, QueryInput<Api, Name>>;
 };
 export {};

package/dist/createHooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createHooks.d.ts","sourceRoot":"","sources":["../src/createHooks.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,IAAI,uBAAuB,EAC/C,KAAK,kBAAkB,IAAI,0BAA0B,EACrD,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAEV,YAAY,EACZ,UAAU,EACV,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD,MAAM,WAAW,iBAAiB,CAAC,IAAI,GAAG,GAAG;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;;GAGG;AACH,QAAA,MAAM,cAAc,eAAkC,CAAC;AAEvD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,CAAC,cAAc,CAAC,EAAE,IAAI,CAAA;CAAE,CAEtF;AA4DD,wBAAgB,WAAW,CAAC,GAAG,SAAS;KACrC,CAAC,IAAI,MAAM,GAAG,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;KACjB;CACF,EAAE,MAAM,EAAE,iBAAiB;wBAiFR,IAAI,SAAS,YAAY,CAAC,GAAG,CAAC,kuBAE7C,cAAc,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,SAAS,CAAC;2BAoD/B,IAAI,SAAS,YAAY,CAAC,GAAG,CAAC,QAC3C,IAAI,kIAET,iBAAiB,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;EAW/E"}
+{"version":3,"file":"createHooks.d.ts","sourceRoot":"","sources":["../src/createHooks.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,IAAI,uBAAuB,EAC/C,KAAK,kBAAkB,IAAI,0BAA0B,EACrD,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;IAC3F,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,QAAA,MAAM,cAAc,eAAkC,CAAC;AAEvD,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,CAAC,cAAc,CAAC,EAAE,IAAI,CAAA;CAAE,CAEtF;AA6DD,wBAAgB,WAAW,CAAC,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC,EACjF,MAAM,EAAE,iBAAiB,CAAC,GAAG,CAAC;wBAkEZ,IAAI,SAAS,YAAY,CAAC,GAAG,CAAC,+kBAE7C,cAAc,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,SAAS,CAAC;2BAwC/B,IAAI,SAAS,YAAY,CAAC,GAAG,CAAC,QAC3C,IAAI,kIAET,iBAAiB,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;EAW/E"}

package/dist/createHooks.js

@@ -1,33 +1,37 @@
 import { useQuery as useTanstackQuery, useMutation as useTanstackMutation, } from '@tanstack/react-query';
 import { HttpError } from './errors.js';
-/**
- * Symbol used to mark objects as query options (not input)
- * @internal
- */
 const OPTIONS_SYMBOL = Symbol.for('hypequery-options');
-/**
- * Helper to explicitly mark an object as query options
- * Prevents ambiguity when query input and options have overlapping properties
- *
- * @example
- * ```ts
- * // Without helper - ambiguous (could be input or options)
- * useQuery('getData', { enabled: true, staleTime: 5000 })
- *
- * // With helper - explicit
- * useQuery('getData', queryOptions({ enabled: true, staleTime: 5000 }))
- * ```
- */
 export function queryOptions(opts) {
     return { ...opts, [OPTIONS_SYMBOL]: true };
 }
-function buildUrl(baseUrl, name) {
+const normalizeMethodConfig = (source) => {
+    if (!source)
+        return {};
+    return Object.fromEntries(Object.entries(source).map(([key, value]) => [key, { method: value.method ?? 'GET' }]));
+};
+const deriveMethodConfig = (api) => {
+    if (typeof api !== 'object' || api === null) {
+        return {};
+    }
+    if ('_routeConfig' in api &&
+        typeof api._routeConfig === 'object' &&
+        api._routeConfig !== null) {
+        return normalizeMethodConfig(api._routeConfig);
+    }
+    if ('queries' in api &&
+        typeof api.queries === 'object' &&
+        api.queries !== null) {
+        return normalizeMethodConfig(api.queries);
+    }
+    return {};
+};
+const buildUrl = (baseUrl, name) => {
     if (!baseUrl) {
         throw new Error('baseUrl is required');
     }
     return baseUrl.endsWith('/') ? `${baseUrl}${name}` : `${baseUrl}/${name}`;
-}
-async function parseResponse(res) {
+};
+const parseResponse = async (res) => {
     const text = await res.text();
     try {
         return JSON.parse(text);
@@ -35,69 +39,37 @@ async function parseResponse(res) {
     catch {
         return text;
     }
-}
-/**
- * Type guard to check if API object has route-level config
- */
-function hasRouteConfig(api) {
-    return (typeof api === 'object' &&
-        api !== null &&
-        '_routeConfig' in api &&
-        typeof api._routeConfig === 'object' &&
-        api._routeConfig !== null);
-}
-/**
- * Type guard to check if API object has queries property
- */
-function hasQueries(api) {
-    return (typeof api === 'object' &&
-        api !== null &&
-        'queries' in api &&
-        typeof api.queries === 'object' &&
-        api.queries !== null);
-}
-/**
- * Extract method configuration from a source object
- * Transforms { key: { method: 'POST' } } into { key: { method: 'POST' } }
- * with GET as default
- */
-function extractMethodConfig(source) {
-    return Object.fromEntries(Object.entries(source).map(([key, value]) => [
-        key,
-        { method: value.method || 'GET' },
-    ]));
-}
+};
+const isOptionsBag = (value) => {
+    return Boolean(value && typeof value === 'object' && OPTIONS_SYMBOL in value);
+};
+const looksLikeQueryOptions = (value) => {
+    if (isOptionsBag(value))
+        return true;
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const optionKeys = ['enabled', 'staleTime', 'gcTime', 'refetchInterval', 'refetchOnWindowFocus', 'retry', 'retryDelay'];
+    const matches = optionKeys.filter((key) => key in value).length;
+    return matches >= 2;
+};
 export function createHooks(config) {
-    const { baseUrl, fetchFn = fetch, headers = {}, config: methodConfig = {}, api } = config;
-    // Auto-extract method config from api object if provided
-    const extractedConfig = api
-        ? hasRouteConfig(api)
-            ? extractMethodConfig(api._routeConfig) // Prefer route-level config if available
-            : hasQueries(api)
-                ? extractMethodConfig(api.queries) // Fallback to endpoint method
-                : {}
-        : {};
-    // Merge extracted config with explicit config (explicit takes precedence)
-    const finalConfig = { ...extractedConfig, ...methodConfig };
+    const { baseUrl, fetchFn = fetch, headers = {}, config: explicitConfig = {}, api } = config;
+    const finalConfig = { ...deriveMethodConfig(api), ...explicitConfig };
     const fetchQuery = async (name, input, defaultMethod = 'GET') => {
         const url = buildUrl(baseUrl, name);
         const method = finalConfig[name]?.method ?? defaultMethod;
-        // For GET requests, encode input as query params; for others, use JSON body
         let finalUrl = url;
         let body;
-        if (method === 'GET' && input !== undefined && input !== null) {
+        if (method === 'GET' && input && typeof input === 'object') {
             const params = new URLSearchParams();
-            if (typeof input === 'object') {
-                for (const [key, value] of Object.entries(input)) {
-                    if (value !== undefined && value !== null) {
-                        // Handle arrays by appending multiple values with the same key
-                        if (Array.isArray(value)) {
-                            value.forEach(item => params.append(key, String(item)));
-                        }
-                        else {
-                            params.append(key, String(value));
-                        }
-                    }
+            for (const [key, value] of Object.entries(input)) {
+                if (value === undefined || value === null)
+                    continue;
+                if (Array.isArray(value)) {
+                    value.forEach((item) => params.append(key, String(item)));
+                }
+                else {
+                    params.append(key, String(value));
                 }
             }
             const queryString = params.toString();
@@ -121,50 +93,33 @@ export function createHooks(config) {
         return res.json();
     };
     function useQuery(...args) {
-        const [name, inputOrOptions, maybeOptions] = args;
-        // Parse arguments based on count and type
+        const [name, potentialInputOrOptions, maybeOptions] = args;
         let input;
         let options;
         if (args.length === 1) {
-            // useQuery('queryName')
             input = undefined;
             options = undefined;
         }
-        else if (args.length === 2) {
-            // useQuery('queryName', input) or useQuery('queryName', options)
-            if (isQueryOptions(inputOrOptions)) {
-                input = undefined;
-                options = inputOrOptions;
-            }
-            else {
-                input = inputOrOptions;
-                options = undefined;
-            }
+        else if (args.length === 2 && looksLikeQueryOptions(potentialInputOrOptions)) {
+            input = undefined;
+            options = potentialInputOrOptions;
         }
         else {
-            // useQuery('queryName', input, options)
-            input = inputOrOptions;
+            input = potentialInputOrOptions;
             options = maybeOptions;
         }
+        const queryKey = (() => {
+            if (input === undefined) {
+                return ['hypequery', name];
+            }
+            return ['hypequery', name, input];
+        })();
         return useTanstackQuery({
-            queryKey: ['hypequery', name, input],
+            queryKey,
             queryFn: () => fetchQuery(name, input),
             ...(options ?? {}),
         });
     }
-    function isQueryOptions(value) {
-        if (typeof value !== 'object' || value === null)
-            return false;
-        // Check for explicit symbol marker first (most reliable)
-        if (OPTIONS_SYMBOL in value)
-            return true;
-        // Fallback to heuristic for backward compatibility
-        // Check for known TanStack Query option keys
-        // Must have at least 2 matches to avoid false positives with user input
-        const optionKeys = ['enabled', 'staleTime', 'gcTime', 'refetchInterval', 'refetchOnWindowFocus', 'retry', 'retryDelay'];
-        const matches = optionKeys.filter(key => key in value).length;
-        return matches >= 2;
-    }
     function useMutation(name, options) {
         return useTanstackMutation({
             mutationFn: (input) => fetchQuery(name, input, 'POST'),

package/dist/createHooks.test.js

@@ -59,6 +59,14 @@ describe('createHooks', () => {
                 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' }));
+        });
     });
     describe('HTTP Method Handling', () => {
         const fetchMock = vi.fn();

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@hypequery/react",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "React hooks for consuming hypequery APIs",
   "type": "module",
+  "main": "./dist/index.js",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -30,6 +31,9 @@
     "typescript": "^5.7.3",
     "vitest": "^2.1.6"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsc -b",
     "types": "tsc -b --noEmit",

package/dist/errors.d.ts

@@ -1,9 +0,0 @@
-/**
- * HTTP error with status code and response body
- */
-export declare class HttpError extends Error {
-    readonly status: number;
-    readonly body: unknown;
-    constructor(message: string, status: number, body: unknown);
-}
-//# sourceMappingURL=errors.d.ts.map

package/dist/errors.js

@@ -1,13 +0,0 @@
-/**
- * HTTP error with status code and response body
- */
-export class HttpError extends Error {
-    constructor(message, status, body) {
-        super(message);
-        this.status = status;
-        this.body = body;
-        this.name = 'HttpError';
-        // Maintain proper prototype chain for instanceof checks
-        Object.setPrototypeOf(this, HttpError.prototype);
-    }
-}

package/dist/index.d.ts

@@ -1,5 +0,0 @@
-export { createHooks, queryOptions } from './createHooks.js';
-export { HttpError } from './errors.js';
-export type { QueryInput, QueryOutput, HttpMethod } from './types.js';
-export type { CreateHooksConfig, QueryMethodConfig } from './createHooks.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/types.d.ts

@@ -1,9 +0,0 @@
-export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-export type ExtractNames<Api> = Extract<keyof Api, string>;
-export type QueryInput<Api, Name extends ExtractNames<Api>> = Api[Name] extends {
-    input: infer Input;
-} ? Input : never;
-export type QueryOutput<Api, Name extends ExtractNames<Api>> = Api[Name] extends {
-    output: infer Output;
-} ? Output : never;
-//# sourceMappingURL=types.d.ts.map

package/dist/types.js

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