@lewebsimple/nuxt-graphql 0.5.9 → 0.5.11

package/README.md

@@ -163,9 +163,8 @@ Write operations in `.gql` files; operation names become registry keys like `use
 
 By default, the module scans `**/*.gql` and generates:
 
-- Typed documents and types in virtual modules under the `#graphql/operations` alias (internal)
+- Typed documents and operations / fragments types in virtual modules under the `#graphql/operations` alias (internal)
 - Operation registry in virtual modules under the `#graphql/registry` alias (internal)
-- Fragment types in virtual modules under the `#graphql/fragments` alias
 
 Example document files:
 
@@ -198,7 +197,7 @@ That's it! You can now use Nuxt GraphQL in your Nuxt app ✨
 Fragments are fully supported and are the recommended way to share selection sets across operations.
 
 - Fragment names must be unique across all `.gql` files (duplicates throw during generation).
-- Fragment types are re-exported from `#graphql/fragments`.
+- Fragment types are re-exported from `#graphql/operations`.
 - Fragments are not executable by themselves and are not part of the registry.
 
 Example with a fragment:
@@ -222,7 +221,7 @@ query SwapiFilms {
 From TypeScript, you can also use fragment types explicitly when needed:
 
 ```ts
-import type { TheFilmFragment } from "#graphql/fragments";
+import type { TheFilmFragment } from "#graphql/operations";
 ```
 
 

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxt-graphql",
   "configKey": "graphql",
-  "version": "0.5.9",
+  "version": "0.5.11",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -97,7 +97,7 @@ async function renderOperationsTemplate({ schema, documents }) {
   const module = docs.map(({ name, object }) => `export const ${name} = ${object};`).join("\n");
   const types = `${content.replace(/export const \w+ = [\s\S]*?;\n?/g, "")}
 declare module "#graphql/operations" {
-  ${docs.map(({ name, type }) => `export type ${name} = ${type};`).join("\n  ")}
+  ${docs.map(({ name, type }) => `export const ${name}: ${type};`).join("\n  ")}
 }`.trim();
   return { module, types };
 }
@@ -305,7 +305,6 @@ export {};
 function renderSharedTypesTemplate() {
   return `
 import type { DocumentNode } from "graphql";
-import type { CacheConfig } from "nuxt-graphql/runtime/shared/lib/cache-config";
 
 declare global {
   type GraphQLCacheConfig = {
@@ -326,7 +325,6 @@ declare module "nuxt/schema" {
 }
 
 export { };
-
 `.trim();
 }
 
@@ -360,7 +358,7 @@ const module$1 = defineNuxtModule({
       return relativePath;
     }
     nuxt.options.alias ||= {};
-    nuxt.options.alias["#graphql"] ||= resolveBuild("graphql");
+    nuxt.options.alias["#graphql"] = resolveBuild("graphql");
     const buildCache = /* @__PURE__ */ new Map();
     function cachedLoader(baseKey, loader) {
       return async (...args) => {
@@ -405,10 +403,12 @@ const module$1 = defineNuxtModule({
       const schema = stitchSchemas({
         subschemas: await Promise.all(Object.values(schemaCachedLoaders).map((loader) => loader()))
       });
-      const sdl = await printSchemaSDL(schema);
-      mkdirSync(dirname(sdlPath), { recursive: true });
-      writeFileSync(sdlPath, sdl, { encoding: "utf-8" });
-      logger.info(`GraphQL SDL saved to: ${cyan}${getRelativePath(sdlPath)}${reset}`);
+      if (nuxt.options.dev) {
+        const sdl = await printSchemaSDL(schema);
+        mkdirSync(dirname(sdlPath), { recursive: true });
+        writeFileSync(sdlPath, sdl, { encoding: "utf-8" });
+        logger.info(`GraphQL SDL saved to: ${cyan}${getRelativePath(sdlPath)}${reset}`);
+      }
       return schema;
     });
     addTemplate({ filename: "graphql/schema.mjs", getContents: () => renderSchemaTemplate({ schemaNames: Object.keys(options.yoga?.schemas || {}) }), write: true });
@@ -424,7 +424,9 @@ const module$1 = defineNuxtModule({
           "!**/dist/**",
           "!**/node_modules/**"
         ], { loaders: [new GraphQLFileLoader()] });
-      } catch {
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warn(`Failed to load documents: ${message}`);
         return [];
       }
     });
@@ -470,8 +472,11 @@ const module$1 = defineNuxtModule({
       nuxt.hook("builder:watch", async (_event, changedPath) => {
         if (changedPath.endsWith(".gql")) {
           logger.info(`Documents change detected: ${cyan}${getRelativePath(changedPath)}${reset}`);
-          buildCache.delete("documents");
-          buildCache.delete("operations");
+          for (const key of buildCache.keys()) {
+            if (key.startsWith("documents:") || key.startsWith("operations:") || key.startsWith("registry:")) {
+              buildCache.delete(key);
+            }
+          }
         }
       });
     }

package/dist/runtime/app/composables/useAsyncGraphQLQuery.d.ts

@@ -10,8 +10,7 @@ type UseAsyncGraphQLQueryOptions<TName extends QueryName> = ExecuteGraphQLHTTPOp
  * Async GraphQL query composable with caching support.
  *
  * @param operationName Operation name from the registry.
- * @param variables Operation variables (ref or getter).
- * @param options HTTP and cache options.
+ * @param args Operation variables (if any) and optional HTTP headers.
  * @returns Nuxt AsyncData wrapper for the query result.
  */
 export declare function useAsyncGraphQLQuery<TName extends QueryName>(operationName: TName, ...args: IsEmptyObject<VariablesOf<TName>> extends true ? [variables?: MaybeRefOrGetter<VariablesOf<TName>>, options?: UseAsyncGraphQLQueryOptions<TName>] : [variables: MaybeRefOrGetter<VariablesOf<TName>>, options?: UseAsyncGraphQLQueryOptions<TName>]): ReturnType<typeof useAsyncData<ResultOf<TName>>>;

package/dist/runtime/app/composables/useGraphQLQuery.d.ts

@@ -6,6 +6,7 @@ import type { IsEmptyObject } from "../../shared/lib/utils.js";
  * Execute a GraphQL query over HTTP with in-flight deduplication.
  *
  * @param operationName Operation name from the registry.
+ * @param args Operation variables (if any) and optional HTTP headers.
  * @returns SafeResult containing data or a normalized error.
  */
 export declare function useGraphQLQuery<TName extends QueryName>(operationName: TName, ...args: IsEmptyObject<VariablesOf<TName>> extends true ? [variables?: VariablesOf<TName>, options?: ExecuteGraphQLHTTPOptions] : [variables: VariablesOf<TName>, options?: ExecuteGraphQLHTTPOptions]): Promise<SafeResult<ResultOf<TName>>>;

package/dist/runtime/app/composables/useGraphQLSubscription.client.d.ts

@@ -12,7 +12,7 @@ type UseGraphQLSubscriptionReturn<TName extends SubscriptionName> = {
  * GraphQL subscription composable (client-side only).
  *
  * @param operationName Subscription operation name.
- * @param variables Subscription variables.
+ * @param args Operation variables (if any).
  * @returns Object with reactive data, error, and start/stop helpers.
  */
 export declare function useGraphQLSubscription<TName extends SubscriptionName>(operationName: TName, ...args: IsEmptyObject<VariablesOf<TName>> extends true ? [variables?: VariablesOf<TName>] : [variables: VariablesOf<TName>]): UseGraphQLSubscriptionReturn<TName>;

package/dist/runtime/server/utils/useServerGraphQLMutation.d.ts

@@ -11,7 +11,7 @@ import type { IsEmptyObject } from "../../shared/lib/utils.js";
  *
  * @param event H3 event used to create context.
  * @param operationName Operation name from the registry.
- * @param variables Operation variables.
+ * @param args Operation variables (if any).
  * @returns SafeResult containing data or a normalized error.
  */
 export declare function useServerGraphQLMutation<TName extends MutationName>(event: H3Event, operationName: TName, ...args: IsEmptyObject<VariablesOf<TName>> extends true ? [variables?: VariablesOf<TName>] : [variables: VariablesOf<TName>]): Promise<SafeResult<ResultOf<TName>>>;

package/dist/runtime/server/utils/useServerGraphQLMutation.js

@@ -1,8 +1,8 @@
 import { executeGraphQLSchema } from "../lib/execute-schema.js";
 import { normalizeError } from "../../shared/lib/error.js";
 export async function useServerGraphQLMutation(event, operationName, ...args) {
+  const [variables] = args;
   try {
-    const [variables] = args;
     const data = await executeGraphQLSchema(event, operationName, variables);
     return { data, error: null };
   } catch (err) {

package/dist/runtime/server/utils/useServerGraphQLQuery.d.ts

@@ -11,7 +11,7 @@ import type { IsEmptyObject } from "../../shared/lib/utils.js";
  *
  * @param event H3 event used to create context.
  * @param operationName Operation name from the registry.
- * @param variables Operation variables.
+ * @param args Operation variables (if any).
  * @returns SafeResult containing data or a normalized error.
  */
 export declare function useServerGraphQLQuery<TName extends QueryName>(event: H3Event, operationName: TName, ...args: IsEmptyObject<VariablesOf<TName>> extends true ? [variables?: VariablesOf<TName>] : [variables: VariablesOf<TName>]): Promise<SafeResult<ResultOf<TName>>>;

package/dist/runtime/server/utils/useServerGraphQLQuery.js

@@ -3,11 +3,7 @@ import { normalizeError } from "../../shared/lib/error.js";
 export async function useServerGraphQLQuery(event, operationName, ...args) {
   const [variables] = args;
   try {
-    const data = await executeGraphQLSchema(
-      event,
-      operationName,
-      variables
-    );
+    const data = await executeGraphQLSchema(event, operationName, variables);
     return { data, error: null };
   } catch (err) {
     return {

package/dist/runtime/shared/lib/utils.d.ts

@@ -1 +1 @@
-export type IsEmptyObject<T> = T extends Record<string, never> ? true : keyof T extends never ? true : false;
+export type IsEmptyObject<T> = [T] extends [never] ? true : T extends object ? keyof T extends never ? true : false : false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lewebsimple/nuxt-graphql",
-  "version": "0.5.9",
+  "version": "0.5.11",
   "description": "Opinionated Nuxt module for using GraphQL",
   "repository": "lewebsimple/nuxt-graphql",
   "license": "AGPL-3.0-only",