naystack 1.7.0 → 1.7.3

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;
@@ -905,11 +919,90 @@ function FieldLibrary(type, queries) {
   }
   return GeneratedResolver;
 }
+
+// src/graphql/server.tsx
+import {
+  ApolloClient,
+  HttpLink,
+  InMemoryCache
+} from "@apollo/client";
+import { registerApolloClient } from "@apollo/client-integration-nextjs";
+import { cookies as cookies3 } from "next/headers";
+import React from "react";
+import { Suspense } from "react";
+function Injector({
+  fetch: fetch2,
+  Component,
+  props
+}) {
+  return /* @__PURE__ */ React.createElement(Suspense, { fallback: /* @__PURE__ */ React.createElement(Component, { ...props || {}, loading: true }) }, /* @__PURE__ */ React.createElement(InjectorSuspensed, { Component, fetch: fetch2, props }));
+}
+async function InjectorSuspensed({
+  fetch: fetch2,
+  Component,
+  props
+}) {
+  const data = await fetch2();
+  return /* @__PURE__ */ React.createElement(Component, { loading: false, ...props || {}, data });
+}
+var { query: gqlQuery } = registerApolloClient(() => {
+  return new ApolloClient({
+    cache: new InMemoryCache(),
+    link: new HttpLink({
+      uri: getEnv("NEXT_PUBLIC_GRAPHQL_ENDPOINT" /* NEXT_PUBLIC_GRAPHQL_ENDPOINT */)
+    })
+  });
+});
+var query = async (_query, options) => {
+  const res = await gqlQuery({
+    query: _query,
+    variables: options?.variables,
+    context: {
+      headers: {
+        Cookie: options?.noCookie ? void 0 : await cookies3()
+      },
+      fetchOptions: {
+        cache: options?.revalidate ? "force-cache" : void 0,
+        next: {
+          revalidate: options?.revalidate || 0,
+          tags: options?.tags
+        }
+      }
+    }
+  });
+  return res.data;
+};
+
+// src/graphql/next.tsx
+import { HttpLink as HttpLink2 } from "@apollo/client";
+import {
+  ApolloClient as ApolloClient2,
+  ApolloNextAppProvider,
+  InMemoryCache as InMemoryCache2
+} from "@apollo/client-integration-nextjs";
+import React2 from "react";
+function makeClient(cacheConfig) {
+  return new ApolloClient2({
+    cache: new InMemoryCache2(cacheConfig),
+    link: new HttpLink2({
+      uri: getEnv("NEXT_PUBLIC_GRAPHQL_ENDPOINT" /* NEXT_PUBLIC_GRAPHQL_ENDPOINT */)
+    })
+  });
+}
+var ApolloWrapper = ({
+  children,
+  cacheConfig
+}) => {
+  return /* @__PURE__ */ React2.createElement(ApolloNextAppProvider, { makeClient: () => makeClient(cacheConfig) }, children);
+};
 export {
+  ApolloWrapper,
   FieldLibrary,
   GQLError,
+  Injector,
   QueryLibrary,
   field,
-  initGraphQLServer,
-  query
+  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

@@ -3,8 +3,8 @@
  *
  * 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/auth/client` — Client-side auth hooks (useLogin, useSignUp, etc.)
+ * - `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

@@ -3,8 +3,8 @@
  *
  * 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/auth/client` — Client-side auth hooks (useLogin, useSignUp, etc.)
+ * - `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/socials/instagram/webhook.d.mts

@@ -9,10 +9,10 @@ import { NextRequest } from 'next/server';
  *
  * @param options - Configuration object.
  * @param options.secret - The verify token you configured in the Meta Developer Portal.
- * @param options.callback - Called for each webhook event: `(type, value, pageId) => Promise<void>`.
+ * @param options.callback - Called for each webhook event: `(type, value, id) => Promise<void>`.
  *   - `type` — Event type (e.g. `"messaging"`, `"changes"`).
  *   - `value` — Event payload.
- *   - `id` — The page/account id from the entry.
+ *   - `id` — The entry id (page or account id) from the webhook payload.
  * @returns Object with `GET` and `POST` — export as your route's handlers.
  *
  * @example

package/dist/socials/instagram/webhook.d.ts

@@ -9,10 +9,10 @@ import { NextRequest } from 'next/server';
  *
  * @param options - Configuration object.
  * @param options.secret - The verify token you configured in the Meta Developer Portal.
- * @param options.callback - Called for each webhook event: `(type, value, pageId) => Promise<void>`.
+ * @param options.callback - Called for each webhook event: `(type, value, id) => Promise<void>`.
  *   - `type` — Event type (e.g. `"messaging"`, `"changes"`).
  *   - `value` — Event payload.
- *   - `id` — The page/account id from the entry.
+ *   - `id` — The entry id (page or account id) from the webhook payload.
  * @returns Object with `GET` and `POST` — export as your route's handlers.
  *
  * @example

package/dist/{client → utils/client}/hooks.cjs.js

@@ -17,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/client/hooks.ts
+// src/utils/client/hooks.ts
 var hooks_exports = {};
 __export(hooks_exports, {
   useBreakpoint: () => useBreakpoint,

package/dist/{client → utils/client}/hooks.esm.js

@@ -1,4 +1,4 @@
-// src/client/hooks.ts
+// src/utils/client/hooks.ts
 import { useEffect, useRef, useState } from "react";
 function useVisibility(onVisible) {
   const visibilityRef = useRef(null);

package/dist/{client → utils/client}/index.cjs.js

@@ -17,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/client/index.ts
+// src/utils/client/index.ts
 var client_exports = {};
 __export(client_exports, {
   setupSEO: () => setupSEO,
@@ -26,7 +26,7 @@ __export(client_exports, {
 });
 module.exports = __toCommonJS(client_exports);
 
-// src/client/hooks.ts
+// src/utils/client/hooks.ts
 var import_react = require("react");
 function useVisibility(onVisible) {
   const visibilityRef = (0, import_react.useRef)(null);
@@ -121,7 +121,7 @@ function getEnv(key, skipCheck) {
   return value;
 }
 
-// src/client/seo.ts
+// src/utils/client/seo.ts
 var setupSEO = (SEO) => (title, description, image) => ({
   title: title ? `${title} \u2022 ${SEO.siteName}` : SEO.title,
   description: description || SEO.description,

package/dist/{client → utils/client}/index.esm.js

@@ -1,4 +1,4 @@
-// src/client/hooks.ts
+// src/utils/client/hooks.ts
 import { useEffect, useRef, useState } from "react";
 function useVisibility(onVisible) {
   const visibilityRef = useRef(null);
@@ -93,7 +93,7 @@ function getEnv(key, skipCheck) {
   return value;
 }
 
-// src/client/seo.ts
+// src/utils/client/seo.ts
 var setupSEO = (SEO) => (title, description, image) => ({
   title: title ? `${title} \u2022 ${SEO.siteName}` : SEO.title,
   description: description || SEO.description,