naystack 1.7.0 → 1.7.1

package/dist/file/client.d.ts

@@ -5,11 +5,13 @@
  * The endpoint is read from `NEXT_PUBLIC_FILE_ENDPOINT` env var. The file is sent as multipart form data
  * along with a `type` string and optional JSON `data` for metadata.
  *
- * @returns A function `(file, type, data?) => Promise<FileUploadResponseType | null>`.
+ * @returns A function `(file, type, config?) => Promise<FileUploadResponseType | null>`.
  *   - `file` — `File` or `Blob` to upload.
  *   - `type` — String category (e.g. `"avatar"`, `"DealDocument"`); sent as form field `type`.
- *   - `data` — Optional JSON-serializable object for metadata; sent as form field `data`.
- *   Resolves to the JSON response `{ url, onUploadResponse }` or `null`.
+ *   - `config` — Optional object with:
+ *     - `data` — JSON-serializable metadata object; sent as form field `data`.
+ *     - `async` — If `true`, the upload is processed asynchronously on the server.
+ *   Resolves to the JSON response `{ url, data }` or `null`.
  *
  * @example
  * ```tsx
@@ -23,9 +25,7 @@
  *     setUploading(true);
  *     try {
  *       const result = await uploadFile(file, "DealDocument", {
- *         dealId,
- *         fileName: file.name,
- *         category: "Contract",
+ *         data: { dealId, fileName: file.name, category: "Contract" },
  *       });
  *       if (result?.url) {
  *         console.log("Uploaded:", result.url);
@@ -50,7 +50,7 @@ declare const useFileUpload: () => (file: File | Blob, type: string, config?: {
  * Shape of the JSON response from the file upload PUT endpoint.
  *
  * @property url - The public S3 URL of the uploaded file.
- * @property onUploadResponse - The return value from the `onUpload` callback in `setupFileUpload`.
+ * @property data - The return value from the `onUpload` callback in `setupFileUpload`.
  *
  * @category File
  */

package/dist/graphql/client.d.mts

@@ -29,10 +29,10 @@ declare const tokenContext: (token?: string | null) => {
  * Uses `fetchPolicy: "no-cache"` by default to always get fresh data.
  *
  * @param query - A `TypedDocumentNode` for the query (e.g. from codegen or a `gql` template).
- * @param variables - Optional initial variables. Query fires automatically when this and token are set; change to refetch.
+ * @param variables - Optional initial variables (the `input` value). Automatically wrapped as `{ input: variables }` before sending. Query fires automatically when this and token are set; change to refetch.
  * @returns Tuple: `[refetch, result]`.
- *   - `refetch(input)` — runs the query again with the given input (passed as `variables.input`).
- *   - `result` — `{ data, loading, error }` from Apollo.
+ *   - `refetch(input)` — runs the query again with the given input (wrapped as `variables.input`).
+ *   - `result` — `{ data, loading, error, hasAuth }` from Apollo. `hasAuth` is `true` when an auth token is available.
  *
  * @example Lazy query (no initial variables, manually triggered):
  * ```tsx
@@ -92,8 +92,8 @@ declare function useAuthQuery<T, V extends OperationVariables>(query: TypedDocum
  * @param mutation - A `TypedDocumentNode` for the mutation (e.g. from codegen or a `gql` template).
  * @param options - Optional Apollo `MutationHookOptions` (e.g. `onCompleted`, `onError`, `refetchQueries`).
  * @returns Tuple: `[mutate, result]`.
- *   - `mutate(input)` — runs the mutation with the given input. Returns a Promise with `{ data }`.
- *   - `result` — `{ data, loading, error }` from Apollo.
+ *   - `mutate(input)` — runs the mutation with the given input (wrapped as `variables.input`). Returns a Promise with `{ data }`.
+ *   - `result` — `{ data, loading, error, hasAuth }` from Apollo. `hasAuth` is `true` when an auth token is available.
  *
  * @example
  * ```tsx

package/dist/graphql/client.d.ts

@@ -29,10 +29,10 @@ declare const tokenContext: (token?: string | null) => {
  * Uses `fetchPolicy: "no-cache"` by default to always get fresh data.
  *
  * @param query - A `TypedDocumentNode` for the query (e.g. from codegen or a `gql` template).
- * @param variables - Optional initial variables. Query fires automatically when this and token are set; change to refetch.
+ * @param variables - Optional initial variables (the `input` value). Automatically wrapped as `{ input: variables }` before sending. Query fires automatically when this and token are set; change to refetch.
  * @returns Tuple: `[refetch, result]`.
- *   - `refetch(input)` — runs the query again with the given input (passed as `variables.input`).
- *   - `result` — `{ data, loading, error }` from Apollo.
+ *   - `refetch(input)` — runs the query again with the given input (wrapped as `variables.input`).
+ *   - `result` — `{ data, loading, error, hasAuth }` from Apollo. `hasAuth` is `true` when an auth token is available.
  *
  * @example Lazy query (no initial variables, manually triggered):
  * ```tsx
@@ -92,8 +92,8 @@ declare function useAuthQuery<T, V extends OperationVariables>(query: TypedDocum
  * @param mutation - A `TypedDocumentNode` for the mutation (e.g. from codegen or a `gql` template).
  * @param options - Optional Apollo `MutationHookOptions` (e.g. `onCompleted`, `onError`, `refetchQueries`).
  * @returns Tuple: `[mutate, result]`.
- *   - `mutate(input)` — runs the mutation with the given input. Returns a Promise with `{ data }`.
- *   - `result` — `{ data, loading, error }` from Apollo.
+ *   - `mutate(input)` — runs the mutation with the given input (wrapped as `variables.input`). Returns a Promise with `{ data }`.
+ *   - `result` — `{ data, loading, error, hasAuth }` from Apollo. `hasAuth` is `true` when an auth token is available.
  *
  * @example
  * ```tsx

package/dist/graphql/index.cjs.js

@@ -542,8 +542,8 @@ __export(graphql_exports, {
   GQLError: () => GQLError,
   QueryLibrary: () => QueryLibrary,
   field: () => field,
-  initGraphQLServer: () => initGraphQLServer,
-  query: () => query
+  resolver: () => resolver,
+  setupGraphQL: () => setupGraphQL
 });
 module.exports = __toCommonJS(graphql_exports);
 
@@ -711,7 +711,7 @@ var getContext = (req) => {
 };
 
 // src/graphql/init.ts
-async function initGraphQLServer({
+async function setupGraphQL({
   authChecker,
   resolvers,
   plugins,
@@ -756,7 +756,7 @@ async function initGraphQLServer({
 var import_headers2 = require("next/headers");
 var import_react = require("react");
 var import_type_graphql2 = require("type-graphql");
-function query(fn, options) {
+function resolver(fn, options) {
   return {
     ...options,
     fn,
@@ -829,6 +829,20 @@ function QueryLibrary(queries) {
   GeneratedResolver = __decorateClass([
     (0, import_type_graphql2.Resolver)()
   ], GeneratedResolver);
+  const hasQuery = Object.values(queries).some((def) => !def.mutation);
+  if (!hasQuery) {
+    Object.defineProperty(GeneratedResolver.prototype, "_health", {
+      value: async function() {
+        return true;
+      },
+      writable: false
+    });
+    const descriptor = Object.getOwnPropertyDescriptor(
+      GeneratedResolver.prototype,
+      "_health"
+    );
+    (0, import_type_graphql2.Query)(() => Boolean)(GeneratedResolver.prototype, "_health", descriptor);
+  }
   for (const key in queries) {
     const def = queries[key];
     if (!def) continue;
@@ -915,6 +929,6 @@ function FieldLibrary(type, queries) {
   GQLError,
   QueryLibrary,
   field,
-  initGraphQLServer,
-  query
+  resolver,
+  setupGraphQL
 });

package/dist/graphql/index.d.mts

@@ -1,7 +1,7 @@
 export { GQLError } from './errors.mjs';
-export { initGraphQLServer } from './init.mjs';
+export { setupGraphQL } from './init.mjs';
 export { AuthorizedContext, Context } from './types.mjs';
-export { FieldLibrary, FieldResolverDefinition, FieldResponseType, QueryDefinition, QueryLibrary, QueryResponseType, field, query } from './utils.mjs';
+export { FieldLibrary, FieldResolverDefinition, FieldResponseType, QueryDefinition, QueryLibrary, QueryResponseType, field, resolver } from './utils.mjs';
 import 'graphql/error';
 import '@apollo/server';
 import 'next/server';

package/dist/graphql/index.d.ts

@@ -1,7 +1,7 @@
 export { GQLError } from './errors.js';
-export { initGraphQLServer } from './init.js';
+export { setupGraphQL } from './init.js';
 export { AuthorizedContext, Context } from './types.js';
-export { FieldLibrary, FieldResolverDefinition, FieldResponseType, QueryDefinition, QueryLibrary, QueryResponseType, field, query } from './utils.js';
+export { FieldLibrary, FieldResolverDefinition, FieldResponseType, QueryDefinition, QueryLibrary, QueryResponseType, field, resolver } from './utils.js';
 import 'graphql/error';
 import '@apollo/server';
 import 'next/server';

package/dist/graphql/index.esm.js

@@ -698,7 +698,7 @@ var getContext = (req) => {
 };
 
 // src/graphql/init.ts
-async function initGraphQLServer({
+async function setupGraphQL({
   authChecker,
   resolvers,
   plugins,
@@ -752,7 +752,7 @@ import {
   Resolver,
   Root
 } from "type-graphql";
-function query(fn, options) {
+function resolver(fn, options) {
   return {
     ...options,
     fn,
@@ -825,6 +825,20 @@ function QueryLibrary(queries) {
   GeneratedResolver = __decorateClass([
     Resolver()
   ], GeneratedResolver);
+  const hasQuery = Object.values(queries).some((def) => !def.mutation);
+  if (!hasQuery) {
+    Object.defineProperty(GeneratedResolver.prototype, "_health", {
+      value: async function() {
+        return true;
+      },
+      writable: false
+    });
+    const descriptor = Object.getOwnPropertyDescriptor(
+      GeneratedResolver.prototype,
+      "_health"
+    );
+    Query(() => Boolean)(GeneratedResolver.prototype, "_health", descriptor);
+  }
   for (const key in queries) {
     const def = queries[key];
     if (!def) continue;
@@ -910,6 +924,6 @@ export {
   GQLError,
   QueryLibrary,
   field,
-  initGraphQLServer,
-  query
+  resolver,
+  setupGraphQL
 };

package/dist/graphql/init.cjs.js

@@ -20,7 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/graphql/init.ts
 var init_exports = {};
 __export(init_exports, {
-  initGraphQLServer: () => initGraphQLServer
+  setupGraphQL: () => setupGraphQL
 });
 module.exports = __toCommonJS(init_exports);
 var import_reflect_metadata = require("reflect-metadata");
@@ -164,7 +164,7 @@ var getContext = (req) => {
 };
 
 // src/graphql/init.ts
-async function initGraphQLServer({
+async function setupGraphQL({
   authChecker,
   resolvers,
   plugins,
@@ -206,5 +206,5 @@ async function initGraphQLServer({
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  initGraphQLServer
+  setupGraphQL
 });

package/dist/graphql/init.d.mts

@@ -24,18 +24,18 @@ import { AuthChecker, NonEmptyArray } from 'type-graphql';
  * @example
  * ```ts
  * // app/api/(graphql)/route.ts
- * import { initGraphQLServer } from "naystack/graphql";
+ * import { setupGraphQL } from "naystack/graphql";
  * import { UserResolvers, UserFieldResolvers } from "./User/graphql";
  * import { ChatResolvers } from "./Chat/graphql";
  *
- * export const { GET, POST } = await initGraphQLServer({
+ * export const { GET, POST } = await setupGraphQL({
  *   resolvers: [UserResolvers, UserFieldResolvers, ChatResolvers],
  * });
  * ```
  *
  * @category GraphQL
  */
-declare function initGraphQLServer({ authChecker, resolvers, plugins, getContext: overrideGetContext, allowedOrigins, }: {
+declare function setupGraphQL({ authChecker, resolvers, plugins, getContext: overrideGetContext, allowedOrigins, }: {
     authChecker?: AuthChecker<any>;
     resolvers: NonEmptyArray<Function>;
     plugins?: ApolloServerPlugin[];
@@ -47,4 +47,4 @@ declare function initGraphQLServer({ authChecker, resolvers, plugins, getContext
     OPTIONS: () => NextResponse<unknown>;
 }>;
 
-export { initGraphQLServer };
+export { setupGraphQL };

package/dist/graphql/init.d.ts

@@ -24,18 +24,18 @@ import { AuthChecker, NonEmptyArray } from 'type-graphql';
  * @example
  * ```ts
  * // app/api/(graphql)/route.ts
- * import { initGraphQLServer } from "naystack/graphql";
+ * import { setupGraphQL } from "naystack/graphql";
  * import { UserResolvers, UserFieldResolvers } from "./User/graphql";
  * import { ChatResolvers } from "./Chat/graphql";
  *
- * export const { GET, POST } = await initGraphQLServer({
+ * export const { GET, POST } = await setupGraphQL({
  *   resolvers: [UserResolvers, UserFieldResolvers, ChatResolvers],
  * });
  * ```
  *
  * @category GraphQL
  */
-declare function initGraphQLServer({ authChecker, resolvers, plugins, getContext: overrideGetContext, allowedOrigins, }: {
+declare function setupGraphQL({ authChecker, resolvers, plugins, getContext: overrideGetContext, allowedOrigins, }: {
     authChecker?: AuthChecker<any>;
     resolvers: NonEmptyArray<Function>;
     plugins?: ApolloServerPlugin[];
@@ -47,4 +47,4 @@ declare function initGraphQLServer({ authChecker, resolvers, plugins, getContext
     OPTIONS: () => NextResponse<unknown>;
 }>;
 
-export { initGraphQLServer };
+export { setupGraphQL };

package/dist/graphql/init.esm.js

@@ -145,7 +145,7 @@ var getContext = (req) => {
 };
 
 // src/graphql/init.ts
-async function initGraphQLServer({
+async function setupGraphQL({
   authChecker,
   resolvers,
   plugins,
@@ -186,5 +186,5 @@ async function initGraphQLServer({
   };
 }
 export {
-  initGraphQLServer
+  setupGraphQL
 };

package/dist/graphql/utils.cjs.js

@@ -31,7 +31,7 @@ __export(utils_exports, {
   FieldLibrary: () => FieldLibrary,
   QueryLibrary: () => QueryLibrary,
   field: () => field,
-  query: () => query
+  resolver: () => resolver
 });
 module.exports = __toCommonJS(utils_exports);
 var import_headers2 = require("next/headers");
@@ -113,7 +113,7 @@ function getUserIdFromRefreshToken(refreshToken) {
 }
 
 // src/graphql/utils.ts
-function query(fn, options) {
+function resolver(fn, options) {
   return {
     ...options,
     fn,
@@ -186,6 +186,20 @@ function QueryLibrary(queries) {
   GeneratedResolver = __decorateClass([
     (0, import_type_graphql.Resolver)()
   ], GeneratedResolver);
+  const hasQuery = Object.values(queries).some((def) => !def.mutation);
+  if (!hasQuery) {
+    Object.defineProperty(GeneratedResolver.prototype, "_health", {
+      value: async function() {
+        return true;
+      },
+      writable: false
+    });
+    const descriptor = Object.getOwnPropertyDescriptor(
+      GeneratedResolver.prototype,
+      "_health"
+    );
+    (0, import_type_graphql.Query)(() => Boolean)(GeneratedResolver.prototype, "_health", descriptor);
+  }
   for (const key in queries) {
     const def = queries[key];
     if (!def) continue;
@@ -271,5 +285,5 @@ function FieldLibrary(type, queries) {
   FieldLibrary,
   QueryLibrary,
   field,
-  query
+  resolver
 });

package/dist/graphql/utils.d.mts

@@ -35,7 +35,7 @@ interface BaseDefinition<T, U, IsAuth extends boolean = false, OutputNullable ex
     authorized?: IsAuth;
 }
 /**
- * Full query/mutation definition returned by {@link query}. Contains the resolver function,
+ * Full query/mutation definition returned by {@link resolver}. Contains the resolver function,
  * plus `.call()` and `.authCall()` for direct server-side invocation.
  *
  * @category GraphQL
@@ -50,7 +50,7 @@ interface QueryDefinition<T, U, IsAuth extends boolean = false, OutputNullable e
 }
 /**
  * Defines a type-graphql query or mutation with typed input/output and optional auth.
- * Use with {@link QueryLibrary} to build resolver classes for `initGraphQLServer`.
+ * Use with {@link QueryLibrary} to build resolver classes for `setupGraphQL`.
  *
  * Each query definition gets `.call(data)` and `.authCall(data)` methods for direct server-side invocation
  * (e.g. in Server Components or other resolvers). Both are cached via React's `cache()`.
@@ -69,9 +69,9 @@ interface QueryDefinition<T, U, IsAuth extends boolean = false, OutputNullable e
  *
  * @example Simple query (no input, nullable output):
  * ```ts
- * import { query } from "naystack/graphql";
+ * import { resolver } from "naystack/graphql";
  *
- * export default query(
+ * export default resolver(
  *   async (ctx) => {
  *     if (!ctx.userId) return null;
  *     const [user] = await db.select().from(UserTable).where(eq(UserTable.id, ctx.userId));
@@ -83,7 +83,7 @@ interface QueryDefinition<T, U, IsAuth extends boolean = false, OutputNullable e
  *
  * @example Mutation with input and authorization:
  * ```ts
- * export default query(
+ * export default resolver(
  *   async (ctx, input: SubmitFeedbackInput) => {
  *     await db.insert(FeedbackTable).values({ userId: ctx.userId, score: input.score, text: input.text });
  *     return true;
@@ -100,7 +100,7 @@ interface QueryDefinition<T, U, IsAuth extends boolean = false, OutputNullable e
  *
  * @category GraphQL
  */
-declare function query<T, U, IsAuth extends boolean = false, OutputNullable extends boolean = false, InputNullable extends boolean = false, R extends Promisify<ParsedGQLTypeWithNullability<T, OutputNullable, true>> = Promisify<ParsedGQLTypeWithNullability<T, OutputNullable, true>>>(fn: (ctx: IsAuth extends true ? AuthorizedContext : Context, data: ParsedGQLTypeWithNullability<U, InputNullable, false>) => R, options: Omit<QueryDefinition<T, U, IsAuth, OutputNullable, InputNullable, R>, "fn" | "authCall" | "call">): QueryDefinition<T, U, IsAuth, OutputNullable, InputNullable, R>;
+declare function resolver<T, U, IsAuth extends boolean = false, OutputNullable extends boolean = false, InputNullable extends boolean = false, R extends Promisify<ParsedGQLTypeWithNullability<T, OutputNullable, true>> = Promisify<ParsedGQLTypeWithNullability<T, OutputNullable, true>>>(fn: (ctx: IsAuth extends true ? AuthorizedContext : Context, data: ParsedGQLTypeWithNullability<U, InputNullable, false>) => R, options: Omit<QueryDefinition<T, U, IsAuth, OutputNullable, InputNullable, R>, "fn" | "authCall" | "call">): QueryDefinition<T, U, IsAuth, OutputNullable, InputNullable, R>;
 /**
  * Full field resolver definition returned by {@link field}. Contains the resolver function,
  * plus `.call()` and `.authCall()` for direct server-side invocation.
@@ -118,13 +118,13 @@ interface FieldResolverDefinition<T, U, Root, IsAuth extends boolean = false, Ou
  * Defines a type-graphql field resolver with typed root, context, and input.
  * Use with {@link FieldLibrary} to attach computed fields to a parent GraphQL type.
  *
- * Like `query()`, each field definition gets `.call(root, data)` and `.authCall(root, data)` for server-side invocation.
+ * Like `resolver()`, each field definition gets `.call(root, data)` and `.authCall(root, data)` for server-side invocation.
  *
  * @param fn - Resolver function: `(root, ctx, data) => result`.
  *   - `root` is the parent object (e.g. the `User` row from the database).
  *   - `ctx` is `Context` (or `AuthorizedContext` when `authorized: true`).
  *   - `data` is the optional typed input argument.
- * @param options - Configuration (same as `query()` but without `mutation`).
+ * @param options - Configuration (same as `resolver()` but without `mutation`).
  * @returns A `FieldResolverDefinition` with `.call` and `.authCall` for server-side invocation.
  *
  * @example
@@ -159,14 +159,14 @@ interface FieldResolverDefinition<T, U, Root, IsAuth extends boolean = false, Ou
  */
 declare function field<T, U, IsAuth extends boolean, Root, OutputNullable extends boolean = false, InputNullable extends boolean = false, R extends Promisify<ParsedGQLTypeWithNullability<T, OutputNullable, true>> = Promisify<ParsedGQLTypeWithNullability<T, OutputNullable, true>>>(fn: (root: Root, ctx: IsAuth extends true ? AuthorizedContext : Context, data: ParsedGQLTypeWithNullability<U, InputNullable, false>) => R, options: Omit<FieldResolverDefinition<T, U, Root, IsAuth, OutputNullable, InputNullable, R>, "fn" | "authCall" | "call">): FieldResolverDefinition<T, U, Root, IsAuth, OutputNullable, InputNullable, R>;
 /**
- * Builds a type-graphql `@Resolver` class from a map of query/mutation definitions created with {@link query}.
+ * Builds a type-graphql `@Resolver` class from a map of query/mutation definitions created with {@link resolver}.
  * Each key in the `queries` object becomes a Query or Mutation field on the GraphQL schema.
  *
- * Pass the returned class in the `resolvers` array of `initGraphQLServer`.
+ * Pass the returned class in the `resolvers` array of `setupGraphQL`.
  *
- * @param queries - Object mapping GraphQL field names to `QueryDefinition`s (from `query()`).
+ * @param queries - Object mapping GraphQL field names to `QueryDefinition`s (from `resolver()`).
  *   Each key becomes the field name in the schema. Mutations are determined by `{ mutation: true }` in the definition.
- * @returns A `@Resolver` class suitable for `initGraphQLServer`.
+ * @returns A `@Resolver` class suitable for `setupGraphQL`.
  *
  * @example
  * ```ts
@@ -191,12 +191,12 @@ declare function QueryLibrary<T extends Record<string, QueryDefinition<any, any,
  * Builds a type-graphql `@Resolver(() => type)` class that resolves computed fields on a parent GraphQL type.
  * Each key in the `queries` object becomes a `@FieldResolver` on that type.
  *
- * Pass the returned class in the `resolvers` array of `initGraphQLServer`.
+ * Pass the returned class in the `resolvers` array of `setupGraphQL`.
  *
  * @typeParam X - The database/plain type of the parent object (e.g. `UserDB`).
  * @param type - The parent GraphQL type class (e.g. `User`). Must be a `@ObjectType` class.
  * @param queries - Object mapping field names to `FieldResolverDefinition`s (from `field()`).
- * @returns A `@Resolver` class for the given type; pass it in `initGraphQLServer`'s resolvers array.
+ * @returns A `@Resolver` class for the given type; pass it in `setupGraphQL`'s resolvers array.
  *
  * @example
  * ```ts
@@ -229,7 +229,7 @@ declare function FieldLibrary<X extends object, T extends Record<string, FieldRe
  * Infers the TypeScript return type of a query definition's `.call()` method.
  * Use this to type component props that receive query results, ensuring full type safety.
  *
- * @typeParam T - A `QueryDefinition` (the default export from a resolver file created with `query()`).
+ * @typeParam T - A `QueryDefinition` (the default export from a resolver file created with `resolver()`).
  *
  * @example
  * ```ts
@@ -264,4 +264,4 @@ type QueryResponseType<T extends QueryDefinition<any, any, any, any, any, any>>
  */
 type FieldResponseType<T extends FieldResolverDefinition<any, any, any, any, any, any, any>> = Awaited<ReturnType<T["call"]>>;
 
-export { FieldLibrary, type FieldResolverDefinition, type FieldResponseType, type QueryDefinition, QueryLibrary, type QueryResponseType, field, query };
+export { FieldLibrary, type FieldResolverDefinition, type FieldResponseType, type QueryDefinition, QueryLibrary, type QueryResponseType, field, resolver };

package/dist/graphql/utils.d.ts

@@ -35,7 +35,7 @@ interface BaseDefinition<T, U, IsAuth extends boolean = false, OutputNullable ex
     authorized?: IsAuth;
 }
 /**
- * Full query/mutation definition returned by {@link query}. Contains the resolver function,
+ * Full query/mutation definition returned by {@link resolver}. Contains the resolver function,
  * plus `.call()` and `.authCall()` for direct server-side invocation.
  *
  * @category GraphQL
@@ -50,7 +50,7 @@ interface QueryDefinition<T, U, IsAuth extends boolean = false, OutputNullable e
 }
 /**
  * Defines a type-graphql query or mutation with typed input/output and optional auth.
- * Use with {@link QueryLibrary} to build resolver classes for `initGraphQLServer`.
+ * Use with {@link QueryLibrary} to build resolver classes for `setupGraphQL`.
  *
  * Each query definition gets `.call(data)` and `.authCall(data)` methods for direct server-side invocation
  * (e.g. in Server Components or other resolvers). Both are cached via React's `cache()`.
@@ -69,9 +69,9 @@ interface QueryDefinition<T, U, IsAuth extends boolean = false, OutputNullable e
  *
  * @example Simple query (no input, nullable output):
  * ```ts
- * import { query } from "naystack/graphql";
+ * import { resolver } from "naystack/graphql";
  *
- * export default query(
+ * export default resolver(
  *   async (ctx) => {
  *     if (!ctx.userId) return null;
  *     const [user] = await db.select().from(UserTable).where(eq(UserTable.id, ctx.userId));
@@ -83,7 +83,7 @@ interface QueryDefinition<T, U, IsAuth extends boolean = false, OutputNullable e
  *
  * @example Mutation with input and authorization:
  * ```ts
- * export default query(
+ * export default resolver(
  *   async (ctx, input: SubmitFeedbackInput) => {
  *     await db.insert(FeedbackTable).values({ userId: ctx.userId, score: input.score, text: input.text });
  *     return true;
@@ -100,7 +100,7 @@ interface QueryDefinition<T, U, IsAuth extends boolean = false, OutputNullable e
  *
  * @category GraphQL
  */
-declare function query<T, U, IsAuth extends boolean = false, OutputNullable extends boolean = false, InputNullable extends boolean = false, R extends Promisify<ParsedGQLTypeWithNullability<T, OutputNullable, true>> = Promisify<ParsedGQLTypeWithNullability<T, OutputNullable, true>>>(fn: (ctx: IsAuth extends true ? AuthorizedContext : Context, data: ParsedGQLTypeWithNullability<U, InputNullable, false>) => R, options: Omit<QueryDefinition<T, U, IsAuth, OutputNullable, InputNullable, R>, "fn" | "authCall" | "call">): QueryDefinition<T, U, IsAuth, OutputNullable, InputNullable, R>;
+declare function resolver<T, U, IsAuth extends boolean = false, OutputNullable extends boolean = false, InputNullable extends boolean = false, R extends Promisify<ParsedGQLTypeWithNullability<T, OutputNullable, true>> = Promisify<ParsedGQLTypeWithNullability<T, OutputNullable, true>>>(fn: (ctx: IsAuth extends true ? AuthorizedContext : Context, data: ParsedGQLTypeWithNullability<U, InputNullable, false>) => R, options: Omit<QueryDefinition<T, U, IsAuth, OutputNullable, InputNullable, R>, "fn" | "authCall" | "call">): QueryDefinition<T, U, IsAuth, OutputNullable, InputNullable, R>;
 /**
  * Full field resolver definition returned by {@link field}. Contains the resolver function,
  * plus `.call()` and `.authCall()` for direct server-side invocation.
@@ -118,13 +118,13 @@ interface FieldResolverDefinition<T, U, Root, IsAuth extends boolean = false, Ou
  * Defines a type-graphql field resolver with typed root, context, and input.
  * Use with {@link FieldLibrary} to attach computed fields to a parent GraphQL type.
  *
- * Like `query()`, each field definition gets `.call(root, data)` and `.authCall(root, data)` for server-side invocation.
+ * Like `resolver()`, each field definition gets `.call(root, data)` and `.authCall(root, data)` for server-side invocation.
  *
  * @param fn - Resolver function: `(root, ctx, data) => result`.
  *   - `root` is the parent object (e.g. the `User` row from the database).
  *   - `ctx` is `Context` (or `AuthorizedContext` when `authorized: true`).
  *   - `data` is the optional typed input argument.
- * @param options - Configuration (same as `query()` but without `mutation`).
+ * @param options - Configuration (same as `resolver()` but without `mutation`).
  * @returns A `FieldResolverDefinition` with `.call` and `.authCall` for server-side invocation.
  *
  * @example
@@ -159,14 +159,14 @@ interface FieldResolverDefinition<T, U, Root, IsAuth extends boolean = false, Ou
  */
 declare function field<T, U, IsAuth extends boolean, Root, OutputNullable extends boolean = false, InputNullable extends boolean = false, R extends Promisify<ParsedGQLTypeWithNullability<T, OutputNullable, true>> = Promisify<ParsedGQLTypeWithNullability<T, OutputNullable, true>>>(fn: (root: Root, ctx: IsAuth extends true ? AuthorizedContext : Context, data: ParsedGQLTypeWithNullability<U, InputNullable, false>) => R, options: Omit<FieldResolverDefinition<T, U, Root, IsAuth, OutputNullable, InputNullable, R>, "fn" | "authCall" | "call">): FieldResolverDefinition<T, U, Root, IsAuth, OutputNullable, InputNullable, R>;
 /**
- * Builds a type-graphql `@Resolver` class from a map of query/mutation definitions created with {@link query}.
+ * Builds a type-graphql `@Resolver` class from a map of query/mutation definitions created with {@link resolver}.
  * Each key in the `queries` object becomes a Query or Mutation field on the GraphQL schema.
  *
- * Pass the returned class in the `resolvers` array of `initGraphQLServer`.
+ * Pass the returned class in the `resolvers` array of `setupGraphQL`.
  *
- * @param queries - Object mapping GraphQL field names to `QueryDefinition`s (from `query()`).
+ * @param queries - Object mapping GraphQL field names to `QueryDefinition`s (from `resolver()`).
  *   Each key becomes the field name in the schema. Mutations are determined by `{ mutation: true }` in the definition.
- * @returns A `@Resolver` class suitable for `initGraphQLServer`.
+ * @returns A `@Resolver` class suitable for `setupGraphQL`.
  *
  * @example
  * ```ts
@@ -191,12 +191,12 @@ declare function QueryLibrary<T extends Record<string, QueryDefinition<any, any,
  * Builds a type-graphql `@Resolver(() => type)` class that resolves computed fields on a parent GraphQL type.
  * Each key in the `queries` object becomes a `@FieldResolver` on that type.
  *
- * Pass the returned class in the `resolvers` array of `initGraphQLServer`.
+ * Pass the returned class in the `resolvers` array of `setupGraphQL`.
  *
  * @typeParam X - The database/plain type of the parent object (e.g. `UserDB`).
  * @param type - The parent GraphQL type class (e.g. `User`). Must be a `@ObjectType` class.
  * @param queries - Object mapping field names to `FieldResolverDefinition`s (from `field()`).
- * @returns A `@Resolver` class for the given type; pass it in `initGraphQLServer`'s resolvers array.
+ * @returns A `@Resolver` class for the given type; pass it in `setupGraphQL`'s resolvers array.
  *
  * @example
  * ```ts
@@ -229,7 +229,7 @@ declare function FieldLibrary<X extends object, T extends Record<string, FieldRe
  * Infers the TypeScript return type of a query definition's `.call()` method.
  * Use this to type component props that receive query results, ensuring full type safety.
  *
- * @typeParam T - A `QueryDefinition` (the default export from a resolver file created with `query()`).
+ * @typeParam T - A `QueryDefinition` (the default export from a resolver file created with `resolver()`).
  *
  * @example
  * ```ts
@@ -264,4 +264,4 @@ type QueryResponseType<T extends QueryDefinition<any, any, any, any, any, any>>
  */
 type FieldResponseType<T extends FieldResolverDefinition<any, any, any, any, any, any, any>> = Awaited<ReturnType<T["call"]>>;
 
-export { FieldLibrary, type FieldResolverDefinition, type FieldResponseType, type QueryDefinition, QueryLibrary, type QueryResponseType, field, query };
+export { FieldLibrary, type FieldResolverDefinition, type FieldResponseType, type QueryDefinition, QueryLibrary, type QueryResponseType, field, resolver };

package/dist/graphql/utils.esm.js

@@ -98,7 +98,7 @@ function getUserIdFromRefreshToken(refreshToken) {
 }
 
 // src/graphql/utils.ts
-function query(fn, options) {
+function resolver(fn, options) {
   return {
     ...options,
     fn,
@@ -171,6 +171,20 @@ function QueryLibrary(queries) {
   GeneratedResolver = __decorateClass([
     Resolver()
   ], GeneratedResolver);
+  const hasQuery = Object.values(queries).some((def) => !def.mutation);
+  if (!hasQuery) {
+    Object.defineProperty(GeneratedResolver.prototype, "_health", {
+      value: async function() {
+        return true;
+      },
+      writable: false
+    });
+    const descriptor = Object.getOwnPropertyDescriptor(
+      GeneratedResolver.prototype,
+      "_health"
+    );
+    Query(() => Boolean)(GeneratedResolver.prototype, "_health", descriptor);
+  }
   for (const key in queries) {
     const def = queries[key];
     if (!def) continue;
@@ -255,5 +269,5 @@ export {
   FieldLibrary,
   QueryLibrary,
   field,
-  query
+  resolver
 };

package/dist/index.d.mts

@@ -4,7 +4,7 @@
  * Use subpath imports for the specific module you need:
  * - `naystack/auth` — Email/Google/Instagram authentication
  * - `naystack/auth/email/client` — Client-side auth hooks (useLogin, useSignUp, etc.)
- * - `naystack/graphql` — GraphQL server: query, field, QueryLibrary, FieldLibrary, initGraphQLServer
+ * - `naystack/graphql` — GraphQL server: resolver, field, QueryLibrary, FieldLibrary, setupGraphQL
  * - `naystack/graphql/client` — Client-side GraphQL hooks (useAuthQuery, useAuthMutation, ApolloWrapper)
  * - `naystack/graphql/server` — Server-side GraphQL utilities (Injector, query)
  * - `naystack/file` — S3 file upload setup

package/dist/index.d.ts

@@ -4,7 +4,7 @@
  * Use subpath imports for the specific module you need:
  * - `naystack/auth` — Email/Google/Instagram authentication
  * - `naystack/auth/email/client` — Client-side auth hooks (useLogin, useSignUp, etc.)
- * - `naystack/graphql` — GraphQL server: query, field, QueryLibrary, FieldLibrary, initGraphQLServer
+ * - `naystack/graphql` — GraphQL server: resolver, field, QueryLibrary, FieldLibrary, setupGraphQL
  * - `naystack/graphql/client` — Client-side GraphQL hooks (useAuthQuery, useAuthMutation, ApolloWrapper)
  * - `naystack/graphql/server` — Server-side GraphQL utilities (Injector, query)
  * - `naystack/file` — S3 file upload setup