polen 0.11.0-next.1 → 0.11.0-next.10

package/build/api/config/configurator.d.ts

@@ -28,25 +28,56 @@ export interface ConfigInput {
      * - `file` - Load from a single SDL file (default: schema.graphql)
      * - `directory` - Load multiple SDL files with date prefixes (enables changelog)
      * - `memory` - Define schemas programmatically in configuration
+     * - `introspection` - Fetch schema from a GraphQL endpoint
+     * - `data` - Use pre-built schema objects
      *
      * @example
      * ```ts
-     * // Single file
+     * // Default: looks for schema.graphql
+     * schema: {}
+     *
+     * // Load via introspection
      * schema: {
-     *   useDataSources: 'file',
      *   dataSources: {
-     *     file: { path: './my-schema.graphql' }
+     *     introspection: {
+     *       url: 'https://api.example.com/graphql',
+     *       headers: { 'Authorization': `Bearer ${process.env.API_TOKEN}` }
+     *     }
      *   }
      * }
      *
      * // Multiple versions for changelog
      * schema: {
-     *   useDataSources: 'directory',
      *   dataSources: {
      *     directory: { path: './schema' }
      *   }
      * }
+     *
+     * // Custom source order
+     * schema: {
+     *   useDataSources: ['introspection', 'file'],
+     *   dataSources: {
+     *     introspection: { url: 'https://api.example.com/graphql' },
+     *     file: { path: './fallback.graphql' }
+     *   }
+     * }
      * ```
+     *
+     * **Two introspection features**:
+     * 1. **File Convention**: Polen auto-detects `schema.introspection.json` files
+     * 2. **Config-driven**: Polen fetches and caches introspection for you
+     *
+     * **Interoperability**: The `schema.introspection.json` file uses the standard
+     * GraphQL introspection format, compatible with GraphQL Codegen, Apollo CLI, etc.
+     *
+     * **Lifecycle**:
+     * - First run: Fetches from endpoint, saves to `schema.introspection.json`
+     * - Subsequent runs: Loads from JSON file (no network request)
+     * - To refresh: Delete the JSON file
+     * - Runs during `polen dev` and `polen build`, never at runtime
+     *
+     * **Query details**: Uses the standard introspection query from the GraphQL spec
+     * @see https://spec.graphql.org/draft/#sec-Introspection
      */
     schema?: SchemaConfigInput;
     /**
@@ -237,22 +268,6 @@ export interface ConfigInput {
          * @default false
          */
         isSelfContainedMode?: boolean;
-        /**
-         * Tweak the watch behavior.
-         */
-        watch?: {
-            /**
-             * Restart the development server when some arbitrary files change.
-             *
-             * Use this to restart when files that are not already watched by vite change.
-             *
-             * @see https://github.com/antfu/vite-plugin-restart
-             */
-            /**
-             * File paths to watch and restart the development server when they change.
-             */
-            also?: string[];
-        };
         /**
          * Whether to enable debug mode.
          *
@@ -287,9 +302,6 @@ export interface Config {
             assets: string;
         };
     };
-    watch: {
-        also: string[];
-    };
     templateVariables: TemplateVariables;
     schemaAugmentations: SchemaAugmentation.Augmentation[];
     schema: null | SchemaConfigInput;

package/build/api/config/configurator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configurator.d.ts","sourceRoot":"","sources":["../../../src/api/config/configurator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"configurator.d.ts","sourceRoot":"","sources":["../../../src/api/config/configurator.ts"],"names":[],"mappings":"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"}

package/build/api/config/configurator.js

@@ -74,9 +74,6 @@ const configInputDefaults = {
         title: `My Developer Portal`,
     },
     schemaAugmentations: [],
-    watch: {
-        also: [],
-    },
     build: {
         architecture: BuildArchitecture.enum.ssg,
         base: `/`,
@@ -166,9 +163,6 @@ baseRootDirPath) => {
     if (configInput?.advanced?.explorer !== undefined) {
         config.advanced.explorer = configInput.advanced.explorer;
     }
-    if (configInput?.advanced?.watch?.also) {
-        config.watch.also = configInput.advanced.watch.also;
-    }
     if (configInput?.server?.port !== undefined) {
         config.server.port = configInput.server.port;
     }

package/build/api/config/configurator.js.map

@@ -1 +1 @@
-{"version":3,"file":"configurator.js","sourceRoot":"","sources":["../../../src/api/config/configurator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"configurator.js","sourceRoot":"","sources":["../../../src/api/config/configurator.ts"],"names":[],"mappings":"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"}

package/build/api/config/merge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../src/api/config/merge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;GAGG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,WAAW,EACjB,YAAY,WAAW,GAAG,SAAS,KAClC,WAiEF,CAAA"}
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../src/api/config/merge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;GAGG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,WAAW,EACjB,YAAY,WAAW,GAAG,SAAS,KAClC,WAiDF,CAAA"}

package/build/api/config/merge.js

@@ -32,17 +32,6 @@ export const mergeInputs = (base, overrides) => {
     // Merge advanced config
     if (base.advanced ?? overrides.advanced) {
         merged.advanced = spreadShallow(base.advanced, overrides.advanced);
-        // Merge advanced.watch config
-        if (base.advanced?.watch ?? overrides.advanced?.watch) {
-            merged.advanced.watch = spreadShallow(base.advanced?.watch, overrides.advanced?.watch);
-            // Merge watch.also arrays
-            if (base.advanced?.watch?.also ?? overrides.advanced?.watch?.also) {
-                merged.advanced.watch.also = [
-                    ...(base.advanced?.watch?.also ?? []),
-                    ...(overrides.advanced?.watch?.also ?? []),
-                ];
-            }
-        }
         // Merge Vite configs if present
         if (base.advanced?.vite ?? overrides.advanced?.vite) {
             merged.advanced.vite = Vite.mergeConfig(base.advanced?.vite ?? {}, overrides.advanced?.vite ?? {});

package/build/api/config/merge.js.map

@@ -1 +1 @@
-{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../../src/api/config/merge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../../src/api/config/merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAG7C;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,IAAiB,EACjB,SAAmC,EACtB,EAAE;IACf,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,MAAM,GAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;IAE1D,+BAA+B;IAC/B,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAA;IACjD,CAAC;IAED,qBAAqB;IACrB,IAAI,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAA;IAC3D,CAAC;IAED,sBAAsB;IACtB,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,CAAC,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;IAC9D,CAAC;IAED,wBAAwB;IACxB,IAAI,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,CAAC,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAA;QAElE,wCAAwC;QACxC,IAAI,IAAI,CAAC,QAAQ,EAAE,wBAAwB,IAAI,SAAS,CAAC,QAAQ,EAAE,wBAAwB,EAAE,CAAC;YAC5F,MAAM,CAAC,QAAQ,CAAC,wBAAwB,GAAG,aAAa,CACtD,IAAI,CAAC,QAAQ,EAAE,wBAAwB,EACvC,SAAS,CAAC,QAAQ,EAAE,wBAAwB,CAC7C,CAAA;QACH,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,IAAI,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,CAAC,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAA;QAElE,gCAAgC;QAChC,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YACpD,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CACrC,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,EACzB,SAAS,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAC/B,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/build/api/content/metadata.d.ts

@@ -1,10 +1,16 @@
-import { z } from 'zod/v4';
+import { z } from 'zod';
 /**
  * Schema for validating front matter content
  */
 export declare const MetadataSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     hidden: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    hidden: boolean;
+    description?: string | undefined;
+}, {
+    description?: string | undefined;
+    hidden?: boolean | undefined;
+}>;
 export type Metadata = z.infer<typeof MetadataSchema>;
 //# sourceMappingURL=metadata.d.ts.map

package/build/api/content/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/api/content/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B;;GAEG;AACH,eAAO,MAAM,cAAc;;;iBAGzB,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/api/content/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;EAGzB,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA"}

package/build/api/content/metadata.js

@@ -1,4 +1,4 @@
-import { z } from 'zod/v4';
+import { z } from 'zod';
 /**
  * Schema for validating front matter content
  */

package/build/api/content/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/api/content/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACnC,CAAC,CAAA"}
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/api/content/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACnC,CAAC,CAAA"}

package/build/api/schema/data-sources/data-sources.d.ts

@@ -1,3 +1,4 @@
+export * as Introspection from './introspection/introspection.js';
 export * as Memory from './memory/memory.js';
 export * as SchemaDirectory from './schema-directory/schema-directory.js';
 export * as SchemaFile from './schema-file/schema-file.js';

package/build/api/schema/data-sources/data-sources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-sources.d.ts","sourceRoot":"","sources":["../../../../src/api/schema/data-sources/data-sources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,eAAe,MAAM,wCAAwC,CAAA;AACzE,OAAO,KAAK,UAAU,MAAM,8BAA8B,CAAA"}
+{"version":3,"file":"data-sources.d.ts","sourceRoot":"","sources":["../../../../src/api/schema/data-sources/data-sources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,kCAAkC,CAAA;AACjE,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,eAAe,MAAM,wCAAwC,CAAA;AACzE,OAAO,KAAK,UAAU,MAAM,8BAA8B,CAAA"}

package/build/api/schema/data-sources/data-sources.js

@@ -1,3 +1,4 @@
+export * as Introspection from './introspection/introspection.js';
 export * as Memory from './memory/memory.js';
 export * as SchemaDirectory from './schema-directory/schema-directory.js';
 export * as SchemaFile from './schema-file/schema-file.js';

package/build/api/schema/data-sources/data-sources.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-sources.js","sourceRoot":"","sources":["../../../../src/api/schema/data-sources/data-sources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,eAAe,MAAM,wCAAwC,CAAA;AACzE,OAAO,KAAK,UAAU,MAAM,8BAA8B,CAAA"}
+{"version":3,"file":"data-sources.js","sourceRoot":"","sources":["../../../../src/api/schema/data-sources/data-sources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,kCAAkC,CAAA;AACjE,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,eAAe,MAAM,wCAAwC,CAAA;AACzE,OAAO,KAAK,UAAU,MAAM,8BAA8B,CAAA"}

package/build/api/schema/data-sources/introspection/introspection.d.ts

@@ -0,0 +1,83 @@
+import { Grafaid } from '#lib/grafaid/index';
+import type { NonEmptyChangeSets, SchemaReadResult } from '../../schema.js';
+/**
+ * Configuration for loading schema via GraphQL introspection.
+ *
+ * Polen supports two introspection features:
+ * 1. **File Convention**: Automatically detects `schema.introspection.json` if present
+ * 2. **Automatic Introspection**: Fetches from your endpoint and creates the file
+ *
+ * When configured, Polen will:
+ * - Execute the standard GraphQL introspection query against your endpoint
+ * - Save the result to `schema.introspection.json` in your project root
+ * - Use this cached file for subsequent builds (no network requests)
+ *
+ * The saved file contains a standard GraphQL introspection query result as defined
+ * in the GraphQL specification, making it compatible with any tool that works with
+ * introspection data (GraphQL Codegen, Apollo CLI, etc.).
+ *
+ * To refresh the schema, delete `schema.introspection.json` and rebuild.
+ *
+ * **Technical details**:
+ * - Uses Graffle's introspection extension
+ * - Performs the full introspection query (all types, fields, descriptions, etc.)
+ * - No customization of the query is currently supported
+ *
+ * @see https://spec.graphql.org/draft/#sec-Introspection - GraphQL Introspection spec
+ * @see https://github.com/graphql/graphql-js/blob/main/src/utilities/getIntrospectionQuery.ts - Reference implementation
+ *
+ * @example
+ * ```ts
+ * // Basic introspection
+ * introspection: {
+ *   url: 'https://api.example.com/graphql'
+ * }
+ *
+ * // With authentication
+ * introspection: {
+ *   url: 'https://api.example.com/graphql',
+ *   headers: {
+ *     'Authorization': `Bearer ${process.env.API_TOKEN}`
+ *   }
+ * }
+ * ```
+ */
+export interface ConfigInput {
+    /**
+     * The GraphQL endpoint URL to introspect.
+     *
+     * Must be a valid GraphQL endpoint that supports introspection queries.
+     *
+     * @example 'https://api.example.com/graphql'
+     */
+    url?: string;
+    /**
+     * Optional headers to include in the introspection request.
+     *
+     * Use this for authentication, API keys, or any custom headers
+     * required by your GraphQL endpoint.
+     *
+     * @example
+     * ```ts
+     * headers: {
+     *   'Authorization': `Bearer ${process.env.API_TOKEN}`,
+     *   'X-API-Key': process.env.API_KEY
+     * }
+     * ```
+     */
+    headers?: Record<string, string>;
+    projectRoot?: string;
+}
+export interface Config {
+    url: string;
+    headers?: Record<string, string>;
+    projectRoot: string;
+}
+export declare const normalizeConfig: (configInput: ConfigInput) => Config;
+export declare const readOrThrow: (configInput: ConfigInput) => Promise<SchemaReadResult>;
+/**
+ * Create a single changeset from a schema object.
+ * This is the core logic for handling single (unversioned) schemas from introspection.
+ */
+export declare const createSingleSchemaChangeset: (schema: Grafaid.Schema.Schema) => Promise<NonEmptyChangeSets>;
+//# sourceMappingURL=introspection.d.ts.map

package/build/api/schema/data-sources/introspection/introspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection.d.ts","sourceRoot":"","sources":["../../../../../src/api/schema/data-sources/introspection/introspection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAK5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,eAAO,MAAM,eAAe,GAAI,aAAa,WAAW,KAAG,MAgB1D,CAAA;AAQD,eAAO,MAAM,WAAW,GACtB,aAAa,WAAW,KACvB,OAAO,CAAC,gBAAgB,CA+E1B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,GAAU,QAAQ,OAAO,CAAC,MAAM,CAAC,MAAM,KAAG,OAAO,CAAC,kBAAkB,CAmB3G,CAAA"}

package/build/api/schema/data-sources/introspection/introspection.js

@@ -0,0 +1,110 @@
+import { Grafaid } from '#lib/grafaid/index';
+import { GraphqlChange } from '#lib/graphql-change/index';
+import { GraphqlSchemaLoader } from '#lib/graphql-schema-loader/index';
+import { Fs, Json, Path } from '@wollybeard/kit';
+export const normalizeConfig = (configInput) => {
+    if (!configInput.url) {
+        throw new Error(`Introspection data source requires a URL`);
+    }
+    if (!configInput.projectRoot) {
+        throw new Error(`Introspection data source requires a projectRoot`);
+    }
+    const config = {
+        url: configInput.url,
+        headers: configInput.headers,
+        projectRoot: configInput.projectRoot,
+    };
+    return config;
+};
+const INTROSPECTION_FILE_NAME = `schema.introspection.json`;
+const getIntrospectionFilePath = (projectRoot) => {
+    return Path.join(projectRoot, INTROSPECTION_FILE_NAME);
+};
+export const readOrThrow = async (configInput) => {
+    const config = normalizeConfig(configInput);
+    const introspectionFilePath = getIntrospectionFilePath(config.projectRoot);
+    // Check if introspection file exists
+    const introspectionFileContent = await Fs.read(introspectionFilePath);
+    let schema;
+    if (introspectionFileContent) {
+        // Load from existing file - no reCreate capability
+        try {
+            const introspectionData = Json.codec.decode(introspectionFileContent);
+            // Validate introspection data structure before passing to fromIntrospectionQuery
+            if (!introspectionData || typeof introspectionData !== 'object') {
+                throw new Error('Introspection data must be a valid JSON object');
+            }
+            // Allow fromIntrospectionQuery to handle validation of the introspection format
+            // It will provide more specific GraphQL-related error messages
+            if (!('data' in introspectionData)) {
+                throw new Error('Introspection data missing required "data" property (expected GraphQL introspection result format)');
+            }
+            schema = Grafaid.Schema.fromIntrospectionQuery(introspectionData);
+        }
+        catch (error) {
+            if (error instanceof SyntaxError) {
+                throw new Error(`Invalid JSON in ${introspectionFilePath}: ${error.message}`);
+            }
+            else {
+                throw new Error(`Invalid introspection data in ${introspectionFilePath}: ${error instanceof Error ? error.message : String(error)}. Delete this file to fetch fresh introspection data.`);
+            }
+        }
+        const schemaData = await createSingleSchemaChangeset(schema);
+        return {
+            data: schemaData,
+            source: { type: 'introspectionFile' },
+        };
+    }
+    else {
+        // Fetch via introspection - can reCreate
+        const introspectionResult = await GraphqlSchemaLoader.load({
+            type: `introspect`,
+            url: config.url,
+            headers: config.headers,
+        });
+        schema = introspectionResult;
+        // Get the raw introspection result for saving
+        const __schema = Grafaid.Schema.toIntrospectionQuery(schema);
+        // Wrap in GraphQL response format for consistency with API responses
+        const introspectionData = { data: { __schema } };
+        // Write to file
+        await Fs.write({
+            path: introspectionFilePath,
+            content: Json.codec.encode(introspectionData),
+        });
+        const schemaData = await createSingleSchemaChangeset(schema);
+        return {
+            data: schemaData,
+            source: {
+                type: 'introspectionAuto',
+                reCreate: async () => {
+                    // Re-fetch using captured config - capture closure
+                    const result = await readOrThrow(configInput);
+                    return result.data;
+                },
+            },
+        };
+    }
+};
+/**
+ * Create a single changeset from a schema object.
+ * This is the core logic for handling single (unversioned) schemas from introspection.
+ */
+export const createSingleSchemaChangeset = async (schema) => {
+    const date = new Date(); // Generate date here for unversioned schema
+    const after = schema;
+    const before = Grafaid.Schema.empty;
+    const changes = await GraphqlChange.calcChangeset({
+        before,
+        after,
+    });
+    const changeset = {
+        date,
+        after,
+        before,
+        changes,
+    };
+    const result = [changeset];
+    return result;
+};
+//# sourceMappingURL=introspection.js.map

package/build/api/schema/data-sources/introspection/introspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection.js","sourceRoot":"","sources":["../../../../../src/api/schema/data-sources/introspection/introspection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AA8EhD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,WAAwB,EAAU,EAAE;IAClE,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;IAC7D,CAAC;IAED,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;IACrE,CAAC;IAED,MAAM,MAAM,GAAW;QACrB,GAAG,EAAE,WAAW,CAAC,GAAG;QACpB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,WAAW,EAAE,WAAW,CAAC,WAAW;KACrC,CAAA;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,uBAAuB,GAAG,2BAA2B,CAAA;AAE3D,MAAM,wBAAwB,GAAG,CAAC,WAAmB,EAAE,EAAE;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAA;AACxD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC9B,WAAwB,EACG,EAAE;IAC7B,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,CAAC,CAAA;IAC3C,MAAM,qBAAqB,GAAG,wBAAwB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAE1E,qCAAqC;IACrC,MAAM,wBAAwB,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;IACrE,IAAI,MAA6B,CAAA;IAEjC,IAAI,wBAAwB,EAAE,CAAC;QAC7B,mDAAmD;QACnD,IAAI,CAAC;YACH,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAA;YAErE,iFAAiF;YACjF,IAAI,CAAC,iBAAiB,IAAI,OAAO,iBAAiB,KAAK,QAAQ,EAAE,CAAC;gBAChE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;YACnE,CAAC;YAED,gFAAgF;YAChF,+DAA+D;YAC/D,IAAI,CAAC,CAAC,MAAM,IAAI,iBAAiB,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CACb,oGAAoG,CACrG,CAAA;YACH,CAAC;YAED,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,sBAAsB,CAAC,iBAAwB,CAAC,CAAA;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,mBAAmB,qBAAqB,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;YAC/E,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CACb,iCAAiC,qBAAqB,KACpD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,uDAAuD,CACxD,CAAA;YACH,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,2BAA2B,CAAC,MAAM,CAAC,CAAA;QAC5D,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE;SACtC,CAAA;IACH,CAAC;SAAM,CAAC;QACN,yCAAyC;QACzC,MAAM,mBAAmB,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC;YACzD,IAAI,EAAE,YAAY;YAClB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAA;QAEF,MAAM,GAAG,mBAAmB,CAAA;QAE5B,8CAA8C;QAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAA;QAE5D,qEAAqE;QACrE,MAAM,iBAAiB,GAAG,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAA;QAEhD,gBAAgB;QAChB,MAAM,EAAE,CAAC,KAAK,CAAC;YACb,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAwB,CAAC;SACrD,CAAC,CAAA;QAEF,MAAM,UAAU,GAAG,MAAM,2BAA2B,CAAC,MAAM,CAAC,CAAA;QAC5D,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE;gBACN,IAAI,EAAE,mBAAmB;gBACzB,QAAQ,EAAE,KAAK,IAAI,EAAE;oBACnB,mDAAmD;oBACnD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAA;oBAC7C,OAAO,MAAM,CAAC,IAAI,CAAA;gBACpB,CAAC;aACF;SACF,CAAA;IACH,CAAC;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,EAAE,MAA6B,EAA+B,EAAE;IAC9G,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAA,CAAC,4CAA4C;IACpE,MAAM,KAAK,GAAG,MAAM,CAAA;IACpB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAA;IACnC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC;QAChD,MAAM;QACN,KAAK;KACN,CAAC,CAAA;IAEF,MAAM,SAAS,GAA+B;QAC5C,IAAI;QACJ,KAAK;QACL,MAAM;QACN,OAAO;KACR,CAAA;IAED,MAAM,MAAM,GAAuB,CAAC,SAAS,CAAC,CAAA;IAE9C,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/build/api/schema/metadata.d.ts

@@ -1,8 +1,16 @@
-import { z } from 'zod/v4';
+import { z } from 'zod';
 export declare const SchemaMetadataSchema: z.ZodObject<{
+    /** Whether a schema is present in the project */
     hasSchema: z.ZodBoolean;
-    versions: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
+    /** Array of available version identifiers */
+    versions: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    hasSchema: boolean;
+    versions: string[];
+}, {
+    hasSchema: boolean;
+    versions: string[];
+}>;
 export type SchemaMetadata = z.infer<typeof SchemaMetadataSchema>;
 export declare const getMetadata: (path: string) => Promise<SchemaMetadata>;
 //# sourceMappingURL=metadata.d.ts.map

package/build/api/schema/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/api/schema/metadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,eAAO,MAAM,oBAAoB;;;iBAK/B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,eAAO,MAAM,WAAW,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,cAAc,CAUtE,CAAA"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/api/schema/metadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,oBAAoB;IAC/B,iDAAiD;;IAEjD,6CAA6C;;;;;;;;EAE7C,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,eAAO,MAAM,WAAW,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,cAAc,CAUtE,CAAA"}

package/build/api/schema/metadata.js

@@ -1,5 +1,5 @@
 import { Fs } from '@wollybeard/kit';
-import { z } from 'zod/v4';
+import { z } from 'zod';
 export const SchemaMetadataSchema = z.object({
     /** Whether a schema is present in the project */
     hasSchema: z.boolean(),

package/build/api/schema/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/api/schema/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,iDAAiD;IACjD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC9B,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,IAAY,EAA2B,EAAE;IACzE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,EAAE;SACb,CAAA;IACH,CAAC;IAED,OAAO,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AAC3C,CAAC,CAAA"}
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/api/schema/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,iDAAiD;IACjD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC9B,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,IAAY,EAA2B,EAAE;IACzE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,EAAE;SACb,CAAA;IACH,CAAC;IAED,OAAO,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AAC3C,CAAC,CAAA"}

package/build/api/schema/read.d.ts

@@ -1,36 +1,94 @@
 import { Arr } from '@wollybeard/kit';
 import * as DataSources from './data-sources/data-sources.js';
 import type { NonEmptyChangeSets } from './schema.js';
-export type DataSourceType = `file` | `directory` | `memory` | `data`;
+export type DataSourceType = `file` | `directory` | `memory` | `data` | `introspection` | `introspectionFile` | `introspectionAuto`;
+/**
+ * Result of schema reading with provenance tracking for file watching and debugging.
+ */
+export interface SchemaReadResult {
+    data: NonEmptyChangeSets | null;
+    source: {
+        type: DataSourceType;
+        /**
+         * Recreate the schema data and file after it has been deleted.
+         *
+         * This function re-fetches data from the original source and recreates
+         * the schema file on disk. Only called by file watchers after deletion.
+         *
+         * @returns Promise resolving to the recreated schema data, or null if recreation fails
+         */
+        reCreate?: () => Promise<NonEmptyChangeSets | null>;
+    };
+}
 /**
  * Schema configuration for Polen.
+ *
+ * Polen supports multiple ways to load your GraphQL schema, from simple files
+ * to dynamic introspection. Configure which sources to use and in what order.
+ *
+ * @example
+ * ```ts
+ * // Load from a file (default)
+ * schema: {} // Looks for schema.graphql
+ *
+ * // Load via introspection
+ * schema: {
+ *   dataSources: {
+ *     introspection: {
+ *       url: 'https://api.example.com/graphql',
+ *       headers: { 'Authorization': 'Bearer token' }
+ *     }
+ *   }
+ * }
+ *
+ * // Try multiple sources in order
+ * schema: {
+ *   useDataSources: ['introspection', 'file'],
+ *   dataSources: {
+ *     introspection: { url: 'https://api.example.com/graphql' },
+ *     file: { path: './fallback-schema.graphql' }
+ *   }
+ * }
+ * ```
  */
 export interface Config {
     /**
      * Whether to enable schema loading.
      *
-     * Set to `false` to disable schema features entirely.
+     * Set to `false` to disable schema features entirely. This removes
+     * the Reference and Changelog pages from your portal.
+     *
+     * @default true
      *
-     * @default `true`
+     * @example
+     * ```ts
+     * // Disable schema features
+     * schema: { enabled: false }
+     * ```
      */
     enabled?: boolean;
     /**
      * Which data sources to use for loading schemas.
      *
-     * - `file` - Load from a single SDL file
-     * - `directory` - Load multiple SDL files from a directory
+     * - `file` - Load from a single SDL file (default: `./schema.graphql`)
+     * - `directory` - Load multiple SDL files from a directory (default: `./schema/`)
      * - `memory` - Use schemas defined in configuration
      * - `data` - Use a pre-built schema object
+     * - `introspection` - Load schema via GraphQL introspection
      *
-     * If not specified, Polen will try all sources in order until one succeeds.
+     * If not specified, Polen tries all sources in this order:
+     * 1. `data` 2. `directory` 3. `file` 4. `memory` 5. `introspection`
      *
      * @example
      * ```ts
      * // Use only file source
      * useDataSources: 'file'
      *
-     * // Try multiple sources
-     * useDataSources: ['directory', 'file']
+     * // Try multiple sources in custom order
+     * useDataSources: ['introspection', 'file']
+     *
+     * // Default behavior (try all sources)
+     * // useDataSources: undefined
      * ```
      */
     useDataSources?: Arr.Maybe<DataSourceType>;
@@ -54,8 +112,24 @@ export interface Config {
          * Pre-built schema object to use directly.
          */
         data?: NonEmptyChangeSets;
+        /**
+         * Configuration for loading schema via GraphQL introspection.
+         *
+         * Introspection fetches your schema directly from a running GraphQL endpoint.
+         * The schema is saved to `schema.introspection.json` in your project root.
+         * Delete this file to force a fresh introspection on the next build.
+         *
+         * @example
+         * ```ts
+         * introspection: {
+         *   url: 'https://api.example.com/graphql',
+         *   headers: { 'Authorization': 'Bearer token' }
+         * }
+         * ```
+         */
+        introspection?: DataSources.Introspection.ConfigInput;
     };
     projectRoot: string;
 }
-export declare const readOrThrow: (config: Config) => Promise<null | NonEmptyChangeSets>;
+export declare const readOrThrow: (config: Config) => Promise<SchemaReadResult>;
 //# sourceMappingURL=read.d.ts.map

package/build/api/schema/read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/api/schema/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AACrC,OAAO,KAAK,WAAW,MAAM,gCAAgC,CAAA;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAA;AAErE;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;;;;;;;;;;;;;;OAkBG;IACH,cAAc,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IAC1C;;OAEG;IACH,WAAW,CAAC,EAAE;QACZ;;WAEG;QACH,IAAI,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,WAAW,CAAA;QACzC;;WAEG;QACH,SAAS,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,WAAW,CAAA;QACnD;;WAEG;QACH,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,WAAW,CAAA;QACvC;;WAEG;QACH,IAAI,CAAC,EAAE,kBAAkB,CAAA;KAC1B,CAAA;IACD,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,KACb,OAAO,CAAC,IAAI,GAAG,kBAAkB,CAwCnC,CAAA"}
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/api/schema/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAY,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,WAAW,MAAM,gCAAgC,CAAA;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,WAAW,GACX,QAAQ,GACR,MAAM,GACN,eAAe,GACf,mBAAmB,GACnB,mBAAmB,CAAA;AAEvB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAC/B,MAAM,EAAE;QACN,IAAI,EAAE,cAAc,CAAA;QACpB;;;;;;;WAOG;QACH,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAA;KACpD,CAAA;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,MAAM;IACrB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,cAAc,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IAC1C;;OAEG;IACH,WAAW,CAAC,EAAE;QACZ;;WAEG;QACH,IAAI,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,WAAW,CAAA;QACzC;;WAEG;QACH,SAAS,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,WAAW,CAAA;QACnD;;WAEG;QACH,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,WAAW,CAAA;QACvC;;WAEG;QACH,IAAI,CAAC,EAAE,kBAAkB,CAAA;QACzB;;;;;;;;;;;;;;WAcG;QACH,aAAa,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,WAAW,CAAA;KACtD,CAAA;IACD,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,KACb,OAAO,CAAC,gBAAgB,CAiD1B,CAAA"}