naystack 1.8.1 → 1.8.2

package/dist/graphql/client.cjs.js

@@ -115,9 +115,10 @@ var tokenContext = (token) => {
     credentials: `omit`
   };
 };
-function useAuthQuery(query, variables) {
+function useAuthQuery(query, variables, options) {
   const [fetch, result] = (0, import_client.useLazyQuery)(query, {
-    fetchPolicy: "no-cache"
+    fetchPolicy: "no-cache",
+    ...options
   });
   const prevVarsRef = (0, import_react.useRef)(null);
   (0, import_react.useEffect)(() => {

package/dist/graphql/client.d.mts

@@ -1,5 +1,5 @@
 import * as _apollo_client from '@apollo/client';
-import { InMemoryCacheConfig, OperationVariables, MutationHookOptions, ApolloClient } from '@apollo/client';
+import { InMemoryCacheConfig, OperationVariables, LazyQueryHookOptions, MutationHookOptions, ApolloClient } from '@apollo/client';
 import { TypedDocumentNode } from '@graphql-typed-document-node/core';
 import React__default, { PropsWithChildren } from 'react';
 
@@ -25,10 +25,14 @@ declare const tokenContext: (token?: string | null) => {
  * Hook to run a GraphQL query with the current user's token. The query auto-fires when both the token
  * and variables are available. Returns a refetch function and the Apollo query result.
  *
- * Uses `fetchPolicy: "no-cache"` by default to always get fresh data.
+ * Uses Apollo's default `fetchPolicy` (`cache-first`) unless you override it via
+ * `options`. Pass `{ fetchPolicy: "no-cache" }` for always-fresh, viewer-keyed data
+ * (e.g. the current user), or `{ fetchPolicy: "cache-and-network" }` to show cached
+ * data instantly while refetching.
  *
  * @param query - A `TypedDocumentNode` for the query (e.g. from codegen or a `gql` template).
  * @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.
+ * @param options - Optional Apollo `LazyQueryHookOptions` (e.g. `fetchPolicy`, `notifyOnNetworkStatusChange`). Merged into the underlying `useLazyQuery`.
  * @returns Tuple: `[refetch, result]`.
  *   - `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.
@@ -58,7 +62,7 @@ declare const tokenContext: (token?: string | null) => {
  *
  * @category GraphQL
  */
-declare function useAuthQuery<T, V extends OperationVariables>(query: TypedDocumentNode<T, V>, variables?: V["input"]): readonly [(input?: V["input"]) => Promise<_apollo_client.QueryResult<T, V>>, _apollo_client.QueryResult<T, V>];
+declare function useAuthQuery<T, V extends OperationVariables>(query: TypedDocumentNode<T, V>, variables?: V["input"], options?: LazyQueryHookOptions<T, V>): readonly [(input?: V["input"]) => Promise<_apollo_client.QueryResult<T, V>>, _apollo_client.QueryResult<T, V>];
 /**
  * Hook to run a GraphQL mutation with the current user's token. Returns a function you call with the mutation input.
  *

package/dist/graphql/client.d.ts

@@ -1,5 +1,5 @@
 import * as _apollo_client from '@apollo/client';
-import { InMemoryCacheConfig, OperationVariables, MutationHookOptions, ApolloClient } from '@apollo/client';
+import { InMemoryCacheConfig, OperationVariables, LazyQueryHookOptions, MutationHookOptions, ApolloClient } from '@apollo/client';
 import { TypedDocumentNode } from '@graphql-typed-document-node/core';
 import React__default, { PropsWithChildren } from 'react';
 
@@ -25,10 +25,14 @@ declare const tokenContext: (token?: string | null) => {
  * Hook to run a GraphQL query with the current user's token. The query auto-fires when both the token
  * and variables are available. Returns a refetch function and the Apollo query result.
  *
- * Uses `fetchPolicy: "no-cache"` by default to always get fresh data.
+ * Uses Apollo's default `fetchPolicy` (`cache-first`) unless you override it via
+ * `options`. Pass `{ fetchPolicy: "no-cache" }` for always-fresh, viewer-keyed data
+ * (e.g. the current user), or `{ fetchPolicy: "cache-and-network" }` to show cached
+ * data instantly while refetching.
  *
  * @param query - A `TypedDocumentNode` for the query (e.g. from codegen or a `gql` template).
  * @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.
+ * @param options - Optional Apollo `LazyQueryHookOptions` (e.g. `fetchPolicy`, `notifyOnNetworkStatusChange`). Merged into the underlying `useLazyQuery`.
  * @returns Tuple: `[refetch, result]`.
  *   - `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.
@@ -58,7 +62,7 @@ declare const tokenContext: (token?: string | null) => {
  *
  * @category GraphQL
  */
-declare function useAuthQuery<T, V extends OperationVariables>(query: TypedDocumentNode<T, V>, variables?: V["input"]): readonly [(input?: V["input"]) => Promise<_apollo_client.QueryResult<T, V>>, _apollo_client.QueryResult<T, V>];
+declare function useAuthQuery<T, V extends OperationVariables>(query: TypedDocumentNode<T, V>, variables?: V["input"], options?: LazyQueryHookOptions<T, V>): readonly [(input?: V["input"]) => Promise<_apollo_client.QueryResult<T, V>>, _apollo_client.QueryResult<T, V>];
 /**
  * Hook to run a GraphQL mutation with the current user's token. Returns a function you call with the mutation input.
  *

package/dist/graphql/client.esm.js

@@ -90,9 +90,10 @@ var tokenContext = (token) => {
     credentials: `omit`
   };
 };
-function useAuthQuery(query, variables) {
+function useAuthQuery(query, variables, options) {
   const [fetch, result] = useLazyQuery(query, {
-    fetchPolicy: "no-cache"
+    fetchPolicy: "no-cache",
+    ...options
   });
   const prevVarsRef = useRef(null);
   useEffect(() => {

package/dist/graphql/utils.d.mts

@@ -34,8 +34,15 @@ type Promisify<T> = T | Promise<T>;
  * there's no refresh cookie the only way to keep that promise is to not call the
  * resolver at all — hence the added `null`, which surfaces the logged-out case in
  * the types instead of passing a null `userId` through the cast.
+ *
+ * `[IsAuth] extends [true]` (not `IsAuth extends true`) is deliberate: `field()`
+ * has no `= false` default and can't reverse-infer `IsAuth` from a `ctx: Context`
+ * signature, so a non-authorized field infers `IsAuth = boolean`. A naked
+ * conditional would distribute over `true | false` and union `null` into every
+ * public field's return. The tuple wrapper stops the distribution, so only a
+ * literal `true` adds `null`.
  */
-type AuthCallReturn<IsAuth extends boolean, R> = IsAuth extends true ? Awaited<R> | null : Awaited<R>;
+type AuthCallReturn<IsAuth extends boolean, R> = [IsAuth] extends [true] ? Awaited<R> | null : Awaited<R>;
 /** Base for query/field definition (output, input, options). */
 interface BaseDefinition<T, U, IsAuth extends boolean = false, OutputNullable extends boolean = false, InputNullable extends boolean = false> {
     output: T;

package/dist/graphql/utils.d.ts

@@ -34,8 +34,15 @@ type Promisify<T> = T | Promise<T>;
  * there's no refresh cookie the only way to keep that promise is to not call the
  * resolver at all — hence the added `null`, which surfaces the logged-out case in
  * the types instead of passing a null `userId` through the cast.
+ *
+ * `[IsAuth] extends [true]` (not `IsAuth extends true`) is deliberate: `field()`
+ * has no `= false` default and can't reverse-infer `IsAuth` from a `ctx: Context`
+ * signature, so a non-authorized field infers `IsAuth = boolean`. A naked
+ * conditional would distribute over `true | false` and union `null` into every
+ * public field's return. The tuple wrapper stops the distribution, so only a
+ * literal `true` adds `null`.
  */
-type AuthCallReturn<IsAuth extends boolean, R> = IsAuth extends true ? Awaited<R> | null : Awaited<R>;
+type AuthCallReturn<IsAuth extends boolean, R> = [IsAuth] extends [true] ? Awaited<R> | null : Awaited<R>;
 /** Base for query/field definition (output, input, options). */
 interface BaseDefinition<T, U, IsAuth extends boolean = false, OutputNullable extends boolean = false, InputNullable extends boolean = false> {
     output: T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "naystack",
-  "version": "1.8.1",
+  "version": "1.8.2",
   "description": "A stack built with Next + GraphQL + S3 + Auth",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",