@stonecrop/nuxt-grafserv 0.16.6 → 0.17.0

package/dist/module.d.mts

@@ -181,8 +181,48 @@ interface SchemaConfig {
  * @see SchemaConfig for custom schemas with resolvers
  */
 type ModuleOptions = PostGraphileConfig | SchemaConfig;
+/**
+ * PostGraphile-mode runtime config, as the module writes it into Nitro.
+ *
+ * Build-time-only keys (`preset`, `fieldCasing`, `schemas`, `explain`, `debug`) are deliberately
+ * absent: they are consumed while building the `#internal/grafserv/pgl` virtual module and have no
+ * meaning at request time.
+ */
+interface PostGraphileRuntimeConfig {
+    type: 'postgraphile';
+    /** Always concrete — the module resolves `options.url ?? '/graphql/'` at build time. */
+    url: string;
+    /** Always concrete — the module resolves `options.graphiql ?? nuxt.options.dev` at build time. */
+    graphiql: boolean;
+}
+/**
+ * Schema-mode runtime config, as the module writes it into Nitro.
+ *
+ * Note `resolversPath` rather than `resolvers`: the module resolves the authored path against
+ * `rootDir` and stores the absolute result, so the handler never re-resolves it.
+ */
+interface SchemaRuntimeConfig {
+    type: 'schema';
+    /** File path(s) already resolved to absolute, or the provider function passed through. */
+    schema: SchemaConfig['schema'];
+    /** Absolute path to the resolvers module, or `undefined` when none was configured. */
+    resolversPath?: string;
+    /** Always concrete — the module resolves `options.url ?? '/graphql/'` at build time. */
+    url: string;
+    /** Always concrete — the module resolves `options.graphiql ?? nuxt.options.dev` at build time. */
+    graphiql: boolean;
+}
+/**
+ * What `runtimeConfig.grafserv` actually holds at request time.
+ *
+ * This is **not** `ModuleOptions`. The module resolves authored options during `nitro:config` and
+ * writes this narrower, fully-resolved shape instead. Treating the two as interchangeable is what
+ * previously forced a `@ts-expect-error` in the runtime handler for `resolversPath`, and left the
+ * unit tests describing the runtime config with a type that has no `resolversPath` at all.
+ */
+type GrafservRuntimeConfig = PostGraphileRuntimeConfig | SchemaRuntimeConfig;
 
 declare const module$1: NuxtModule<ModuleOptions>;
 
 export { module$1 as default };
-export type { ModuleOptions, PostGraphileConfig, SchemaConfig, SchemaProvider };
+export type { GrafservRuntimeConfig, ModuleOptions, PostGraphileConfig, PostGraphileRuntimeConfig, SchemaConfig, SchemaProvider, SchemaRuntimeConfig };

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@stonecrop/nuxt-grafserv",
   "configKey": "grafserv",
-  "version": "0.16.6",
+  "version": "0.17.0",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"

package/dist/module.mjs

@@ -176,12 +176,13 @@ export default {
           ].join("\n");
         }
         config.virtual["#internal/grafserv/resolvers"] = "export default null";
-        config.runtimeConfig = config.runtimeConfig || {};
-        config.runtimeConfig.grafserv = {
+        const pgRuntimeConfig = {
           type: "postgraphile",
           url: options.url || "/graphql/",
           graphiql: graphiqlEnabled
         };
+        config.runtimeConfig = config.runtimeConfig || {};
+        config.runtimeConfig.grafserv = pgRuntimeConfig;
       } else if (options.type === "schema") {
         logger.info("Using schema configuration");
         const resolverPath = options.resolvers ? resolveForVirtualModule(options.resolvers) : void 0;
@@ -203,14 +204,15 @@ export default {
         } else {
           runtimeSchema = options.schema;
         }
-        config.runtimeConfig = config.runtimeConfig || {};
-        config.runtimeConfig.grafserv = {
+        const schemaRuntimeConfig = {
           type: "schema",
           schema: runtimeSchema,
           resolversPath: resolverPath,
           url: options.url || "/graphql/",
           graphiql: graphiqlEnabled
         };
+        config.runtimeConfig = config.runtimeConfig || {};
+        config.runtimeConfig.grafserv = schemaRuntimeConfig;
         config.virtual = config.virtual || {};
         if (resolverPath) {
           config.virtual["#internal/grafserv/resolvers"] = `export { default } from '${resolverPath}'`;

package/dist/runtime/handler.d.ts

@@ -1,5 +1,5 @@
 import { grafserv } from 'grafserv/h3/v1';
-import type { ModuleOptions } from '../types.js';
+import type { GrafservRuntimeConfig } from '../types.js';
 /**
  * Get or create the grafserv instance
  * Exported for use by separate handler files
@@ -8,7 +8,7 @@ import type { ModuleOptions } from '../types.js';
  * execution context (withPgClient, pgSettings, plugin middleware, etc.).
  * For schema mode: builds a schema from files/function and wraps with grafserv.
  */
-export declare function getGrafservInstance(options: ModuleOptions): Promise<ReturnType<typeof grafserv>>;
+export declare function getGrafservInstance(options: GrafservRuntimeConfig): Promise<ReturnType<typeof grafserv>>;
 /**
  * Clear the cached instances (useful for development hot reload)
  *

package/dist/types.d.mts

@@ -1,3 +1,3 @@
 export { default } from './module.mjs'
 
-export { type ModuleOptions, type PostGraphileConfig, type SchemaConfig, type SchemaProvider } from './module.mjs'
+export { type GrafservRuntimeConfig, type ModuleOptions, type PostGraphileConfig, type PostGraphileRuntimeConfig, type SchemaConfig, type SchemaProvider, type SchemaRuntimeConfig } from './module.mjs'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stonecrop/nuxt-grafserv",
-  "version": "0.16.6",
+  "version": "0.17.0",
   "description": "Pluggable Grafserv GraphQL server as Nuxt Module",
   "bugs": {
     "url": "https://github.com/agritheory/stonecrop/issues"
@@ -44,7 +44,7 @@
     "grafserv": "^1.0.0",
     "graphql": "^16.14.0",
     "postgraphile": "^5.0.3",
-    "@stonecrop/graphql-middleware": "0.16.6"
+    "@stonecrop/graphql-middleware": "0.17.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
@@ -99,7 +99,7 @@
     "test:ci": "vitest run --run",
     "test:coverage": "vitest run --coverage.enabled --coverage.provider=istanbul",
     "test:e2e": "vitest run test/e2e",
-    "test:types": "vue-tsc --noEmit && cd playground && vue-tsc --noEmit",
+    "test:types": "vue-tsc --noEmit -p tsconfig.src.json && vue-tsc --noEmit -p tsconfig.test.json && cd playground && vue-tsc --noEmit",
     "test:watch": "vitest watch"
   }
 }