polen 0.11.0-next.14 → 0.11.0-next.16

package/build/api/schema/config-schema.js

@@ -0,0 +1,388 @@
+import { AugmentationSchema } from '#api/schema/augmentations/schema-augmentation';
+import { S } from '#lib/kit-temp/effect';
+// ============================================================================
+// Schema - Input Source Names
+// ============================================================================
+export const InputSourceNameSchema = S.Enums({
+    file: 'file',
+    directory: 'directory',
+    versionedDirectory: 'versionedDirectory',
+    memory: 'memory',
+    introspection: 'introspection',
+    introspectionFile: 'introspectionFile',
+});
+// ============================================================================
+// Schema - Input Sources
+// ============================================================================
+const FileOptionsSchema = S.Struct({
+    /**
+     * Path to the GraphQL SDL file.
+     *
+     * Can be absolute or relative to the project root.
+     *
+     * @default './schema.graphql'
+     *
+     * @example
+     * ```ts
+     * // Default location
+     * path: './schema.graphql'
+     *
+     * // Custom location
+     * path: './src/graphql/schema.sdl'
+     * ```
+     */
+    path: S.optional(S.String),
+}).annotations({
+    identifier: 'FileOptions',
+    description: 'Configuration for loading schema from a single SDL file.',
+});
+const DirectoryOptionsSchema = S.Struct({
+    /**
+     * Path to the directory containing schema files.
+     *
+     * Supports two patterns:
+     * 1. Multiple versioned files with ISO date prefixes: `YYYY-MM-DD.graphql`
+     * 2. Single file named: `schema.graphql`
+     *
+     * @default './schema'
+     *
+     * @example
+     * ```ts
+     * // Default location
+     * path: './schema'
+     *
+     * // Custom location
+     * path: './graphql/versions'
+     * ```
+     *
+     * Directory structure examples:
+     * ```
+     * // Versioned schemas (enables changelog)
+     * schema/
+     *   2024-01-15.graphql
+     *   2024-03-20.graphql
+     *   2024-06-10.graphql
+     *
+     * // Single schema (non-versioned)
+     * schema/
+     *   schema.graphql
+     * ```
+     */
+    path: S.optional(S.String),
+}).annotations({
+    identifier: 'DirectoryOptions',
+    description: 'Configuration for loading multiple schema versions from a directory.',
+});
+const VersionedDirectoryOptionsSchema = S.Struct({
+    /**
+     * Path to the directory containing versioned schema subdirectories.
+     *
+     * @default './schema'
+     */
+    path: S.optional(S.String),
+}).annotations({
+    identifier: 'VersionedDirectoryOptions',
+    description: 'Configuration for loading versioned schemas from subdirectories.',
+});
+const HttpHeadersSchema = S.Record({
+    key: S.String,
+    value: S.String,
+});
+const IntrospectionOptionsSchema = S.Struct({
+    /**
+     * The GraphQL endpoint URL to introspect.
+     *
+     * Must be a valid GraphQL endpoint that supports introspection queries.
+     *
+     * @example 'https://api.example.com/graphql'
+     */
+    url: S.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: S.optional(HttpHeadersSchema),
+}).annotations({
+    identifier: 'IntrospectionOptions',
+    description: 'Configuration for loading schema via GraphQL introspection.',
+});
+const IntrospectionFileOptionsSchema = S.Struct({
+    /**
+     * Path to the introspection file.
+     *
+     * @default './schema.introspection.json'
+     */
+    path: S.optional(S.String),
+}).annotations({
+    identifier: 'IntrospectionFileOptions',
+    description: 'Configuration for loading schema from an existing introspection file.',
+});
+// Complex union for memory revisions - we define the actual runtime types here
+// and use S.Unknown for now, with a TODO to properly type this later
+const MemoryRevisionsSchema = S.Unknown.annotations({
+    description: `Schema revisions in various formats: SDL strings, GraphQL schema objects, or pre-built unversioned Catalog`,
+});
+const MemoryOptionsSchema = S.Struct({
+    /**
+     * Schema revisions defined in various formats.
+     *
+     * Creates an unversioned catalog with multiple revisions (dated snapshots) that can show changes over time.
+     *
+     * Can be:
+     * - A single SDL string (single revision, no changelog)
+     * - Array of SDL strings (uses current date for all)
+     * - Array of objects with date and SDL (full changelog support)
+     * - A GraphQLSchema object (single revision, no changelog)
+     * - Array of GraphQLSchema objects (uses current date for all)
+     * - Array of objects with date and GraphQLSchema (full changelog support)
+     * - A pre-built unversioned Catalog object
+     *
+     * @example
+     * ```ts
+     * // Single SDL schema revision
+     * revisions: `
+     *   type Query {
+     *     hello: String
+     *   }
+     * `
+     *
+     * // Multiple revisions with explicit dates (enables changelog)
+     * revisions: [
+     *   {
+     *     date: new Date('2024-01-15'),
+     *     value: `type Query { users: [User] }`
+     *   },
+     *   {
+     *     date: new Date('2024-03-20'),
+     *     value: `type Query { users: [User], posts: [Post] }`
+     *   }
+     * ]
+     *
+     * // GraphQL schema object
+     * revisions: buildSchema(`type Query { hello: String }`)
+     *
+     * // Pre-built unversioned catalog
+     * revisions: myCatalog
+     * ```
+     */
+    revisions: MemoryRevisionsSchema,
+}).annotations({
+    identifier: 'MemoryOptions',
+    description: 'Configuration for defining schema revisions programmatically in memory. Creates an unversioned catalog.',
+});
+// ============================================================================
+// Schema - Sources
+// ============================================================================
+const SourcesSchema = S.Struct({
+    /**
+     * Configuration for loading schema from a single SDL file.
+     */
+    file: S.optional(FileOptionsSchema),
+    /**
+     * Configuration for loading multiple schema versions from a directory.
+     */
+    directory: S.optional(DirectoryOptionsSchema),
+    /**
+     * Configuration for loading versioned schemas from subdirectories.
+     */
+    versionedDirectory: S.optional(VersionedDirectoryOptionsSchema),
+    /**
+     * Configuration for defining schemas programmatically.
+     *
+     * Accepts SDL strings, GraphQL schema objects, or pre-built SchemaHydrated objects.
+     */
+    memory: S.optional(MemoryOptionsSchema),
+    /**
+     * Configuration for loading schema via GraphQL introspection.
+     *
+     * Introspection fetches your schema directly from a running GraphQL endpoint
+     * and caches it in `.polen/cache/introspection/`.
+     *
+     * @example
+     * ```ts
+     * introspection: {
+     *   url: 'https://api.example.com/graphql',
+     *   headers: { 'Authorization': 'Bearer token' }
+     * }
+     * ```
+     */
+    introspection: S.optional(IntrospectionOptionsSchema),
+    /**
+     * Configuration for loading schema from an existing introspection file.
+     *
+     * Reads a pre-existing `schema.introspection.json` file from your project root.
+     * This is useful when you have an introspection file generated by other tools.
+     *
+     * @example
+     * ```ts
+     * introspectionFile: {
+     *   // Uses default path: ./schema.introspection.json
+     * }
+     * ```
+     */
+    introspectionFile: S.optional(IntrospectionFileOptionsSchema),
+}).annotations({
+    identifier: 'Sources',
+    description: 'Configuration for each data source type.',
+});
+// ============================================================================
+// Schema - Main Config
+// ============================================================================
+/**
+ * Configuration for how Polen loads your GraphQL schema.
+ *
+ * Polen supports multiple schema sources:
+ * - `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
+ * // Default: looks for schema.graphql
+ * schema: {}
+ *
+ * // Load via introspection
+ * schema: {
+ *   sources: {
+ *     introspection: {
+ *       url: 'https://api.example.com/graphql',
+ *       headers: { 'Authorization': `Bearer ${process.env.API_TOKEN}` }
+ *     }
+ *   }
+ * }
+ *
+ * // Multiple versions for changelog
+ * schema: {
+ *   sources: {
+ *     directory: { path: './schema' }
+ *   }
+ * }
+ *
+ * // Custom source order
+ * schema: {
+ *   useSources: ['introspection', 'file'],
+ *   sources: {
+ *     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
+ */
+export const ConfigSchema = S.Struct({
+    /**
+     * Whether to enable schema loading.
+     *
+     * Set to `false` to disable schema features entirely. This removes
+     * the Reference and Changelog pages from your portal.
+     *
+     * @default true
+     *
+     * @example
+     * ```ts
+     * // Disable schema features
+     * schema: { enabled: false }
+     * ```
+     */
+    enabled: S.optional(S.Boolean),
+    /**
+     * Programmatically enhance your GraphQL schema documentation without modifying the schema files.
+     *
+     * Perfect for adding implementation details, usage examples, deprecation notices,
+     * or any additional context that helps developers understand your API better.
+     *
+     * @example
+     * ```ts
+     * augmentations: [
+     *   {
+     *     type: 'description',
+     *     on: {
+     *       type: 'TargetType',
+     *       name: 'User'
+     *     },
+     *     placement: 'after',
+     *     content: '\n\nSee the [User Guide](/guides/users) for detailed usage.'
+     *   },
+     *   {
+     *     type: 'description',
+     *     on: {
+     *       type: 'TargetField',
+     *       targetType: 'Query',
+     *       name: 'users'
+     *     },
+     *     placement: 'after',
+     *     content: '\n\n**Rate limit:** 100 requests per minute'
+     *   }
+     * ]
+     * ```
+     */
+    augmentations: S.optional(S.Array(AugmentationSchema)),
+    /**
+     * Which data sources to use for loading schemas.
+     *
+     * - `file` - Load from a single SDL file (default: `./schema.graphql`)
+     * - `directory` - Load multiple SDL files from a directory (default: `./schema/`)
+     * - `versionedDirectory` - Load versioned schemas from subdirectories (default: `./schema/`)
+     * - `memory` - Use schemas defined in configuration
+     * - `introspection` - Load schema via GraphQL introspection
+     * - `introspectionFile` - Load schema from an introspection JSON file
+     *
+     * If not specified, Polen tries all sources in this order:
+     * 1. `versionedDirectory` 2. `directory` 3. `file` 4. `memory` 5. `introspection` 6. `introspectionFile`
+     *
+     * @example
+     * ```ts
+     * // Use only file source
+     * useSources: 'file'
+     *
+     * // Try multiple sources in custom order
+     * useSources: ['introspection', 'file']
+     *
+     * // Default behavior (try all sources)
+     * // useSources: undefined
+     * ```
+     */
+    useSources: S.optional(S.Union(InputSourceNameSchema, S.Array(InputSourceNameSchema))),
+    /**
+     * Configuration for each data source type.
+     */
+    sources: S.optional(SourcesSchema),
+}).annotations({
+    identifier: 'SchemaConfig',
+    title: 'Schema Configuration',
+    description: 'Configuration for how Polen loads your GraphQL schema.',
+});
+// ============================================================================
+// Codec
+// ============================================================================
+export const decode = S.decode(ConfigSchema);
+export const encode = S.encode(ConfigSchema);
+export const validate = S.validate(ConfigSchema);
+//# sourceMappingURL=config-schema.js.map

package/build/api/schema/config-schema.js.map

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

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

@@ -0,0 +1,5 @@
+export type { Config, ConfigInput, InputSourceName } from './config-schema.js';
+export { InputSourceNameSchema } from './config-schema.js';
+import type { InputSources } from './input-sources/$.js';
+export type DataSourceTypeNew = typeof InputSources[keyof typeof InputSources]['loader']['name'];
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/api/schema/config.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAG1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD,MAAM,MAAM,iBAAiB,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/build/api/schema/config.js

@@ -0,0 +1,2 @@
+export { InputSourceNameSchema } from './config-schema.js';
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/api/schema/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA"}

package/build/api/schema/input-source/$$.d.ts

@@ -0,0 +1,3 @@
+export * from './input-source.js';
+export * from './load.js';
+//# sourceMappingURL=$$.d.ts.map

package/build/api/schema/input-source/$$.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../../src/api/schema/input-source/$$.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA"}

package/build/api/schema/input-source/$$.js

@@ -0,0 +1,3 @@
+export * from './input-source.js';
+export * from './load.js';
+//# sourceMappingURL=$$.js.map

package/build/api/schema/input-source/$$.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.js","sourceRoot":"","sources":["../../../../src/api/schema/input-source/$$.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA"}

package/build/api/schema/input-source/$.d.ts

@@ -0,0 +1,2 @@
+export * as InputSource from './$$.js';
+//# sourceMappingURL=$.d.ts.map

package/build/api/schema/input-source/$.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"$.d.ts","sourceRoot":"","sources":["../../../../src/api/schema/input-source/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,SAAS,CAAA"}

package/build/api/schema/input-source/$.js

@@ -0,0 +1,2 @@
+export * as InputSource from './$$.js';
+//# sourceMappingURL=$.js.map

package/build/api/schema/input-source/$.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"$.js","sourceRoot":"","sources":["../../../../src/api/schema/input-source/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,SAAS,CAAA"}

package/build/api/schema/input-source/input-source.d.ts

@@ -0,0 +1,39 @@
+import { InputSource } from '#api/schema/input-source/$';
+import type { Catalog } from '#lib/catalog/$';
+import type { PlatformError } from '@effect/platform/Error';
+import type { FileSystem } from '@effect/platform/FileSystem';
+import { Effect } from 'effect';
+type Options = object;
+export interface InputSourceError {
+    readonly _tag: 'InputSourceError';
+    readonly source: string;
+    readonly message: string;
+    readonly cause?: unknown;
+}
+export declare const InputSourceError: (source: string, message: string, cause?: unknown) => InputSourceError;
+export interface EffectInputSource<$Name extends string = string, $Options extends Options = Options, $Catalog extends Catalog.Catalog = Catalog.Catalog> {
+    name: $Name;
+    isApplicable: (options: $Options, context: InputSource.Context) => Effect.Effect<boolean, PlatformError | InputSourceError, FileSystem>;
+    readIfApplicableOrThrow: (options: $Options, context: InputSource.Context) => Effect.Effect<null | $Catalog, PlatformError | InputSourceError, FileSystem>;
+    reCreate?: (options: $Options, context: InputSource.Context) => Effect.Effect<null | $Catalog, PlatformError | InputSourceError, FileSystem>;
+}
+export declare const createEffect: <$Name extends string, $Options extends Options, $Catalog extends Catalog.Catalog>(input: {
+    name: $Name;
+    isApplicable?: (options: $Options, context: InputSource.Context) => Effect.Effect<boolean, PlatformError | InputSourceError, FileSystem>;
+    readIfApplicableOrThrow: (options: $Options, context: InputSource.Context) => Effect.Effect<null | $Catalog, PlatformError | InputSourceError, FileSystem>;
+    reCreate?: (options: $Options, context: InputSource.Context) => Effect.Effect<null | $Catalog, PlatformError | InputSourceError, FileSystem>;
+}) => EffectInputSource<$Name, $Options, $Catalog>;
+export interface InputSource<$Name extends string = string, $Options extends Options = Options, $Catalog extends Catalog.Catalog = Catalog.Catalog> {
+    name: $Name;
+    isApplicable: (options: $Options, context: InputSource.Context) => Promise<boolean>;
+    readIfApplicableOrThrow: (options: $Options, context: InputSource.Context) => Promise<null | $Catalog>;
+    reCreate?: (options: $Options, context: InputSource.Context) => Promise<null | $Catalog>;
+}
+export declare const create: <$Name extends string, $Options extends Options, $Catalog extends Catalog.Catalog>(input: {
+    name: $Name;
+    isApplicable?: (options: $Options, context: InputSource.Context) => Promise<boolean>;
+    readIfApplicableOrThrow: (options: $Options, context: InputSource.Context) => Promise<null | $Catalog>;
+    reCreate?: (options: $Options, context: InputSource.Context) => Promise<null | $Catalog>;
+}) => InputSource<$Name, $Options, $Catalog>;
+export {};
+//# sourceMappingURL=input-source.d.ts.map

package/build/api/schema/input-source/input-source.d.ts.map

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

package/build/api/schema/input-source/input-source.js

@@ -0,0 +1,35 @@
+import { InputSource } from '#api/schema/input-source/$';
+import { Err, Fn } from '@wollybeard/kit';
+import { Effect } from 'effect';
+export const InputSourceError = (source, message, cause) => ({
+    _tag: 'InputSourceError',
+    source,
+    message,
+    cause,
+});
+export const createEffect = (input) => {
+    const defaultIsApplicable = (options, context) => Effect.gen(function* () {
+        const result = yield* Effect.either(input.readIfApplicableOrThrow(options, context));
+        return result._tag === 'Right' && result.right !== null;
+    });
+    return {
+        name: input.name,
+        isApplicable: input.isApplicable ?? defaultIsApplicable,
+        readIfApplicableOrThrow: input.readIfApplicableOrThrow,
+        reCreate: input.reCreate,
+        __effectInputSource: true,
+    };
+};
+export const create = (input) => {
+    const defaultIsApplicable = async (options, context) => {
+        return Err.tryOrAsync(() => input.readIfApplicableOrThrow(options, context), false).then(Fn.constant(true));
+    };
+    const api = {
+        name: input.name,
+        isApplicable: input.isApplicable ?? defaultIsApplicable,
+        readIfApplicableOrThrow: input.readIfApplicableOrThrow,
+        reCreate: input.reCreate,
+    };
+    return api;
+};
+//# sourceMappingURL=input-source.js.map

package/build/api/schema/input-source/input-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-source.js","sourceRoot":"","sources":["../../../../src/api/schema/input-source/input-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAIxD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAe/B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,MAAc,EACd,OAAe,EACf,KAAe,EACG,EAAE,CAAC,CAAC;IACtB,IAAI,EAAE,kBAAkB;IACxB,MAAM;IACN,OAAO;IACP,KAAK;CACN,CAAC,CAAA;AA0BF,MAAM,CAAC,MAAM,YAAY,GAAG,CAI1B,KAcD,EAAgD,EAAE;IACjD,MAAM,mBAAmB,GAAG,CAC1B,OAAiB,EACjB,OAA4B,EAC0C,EAAE,CACxE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;QACpF,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,CAAA;IACzD,CAAC,CAAC,CAAA;IAEJ,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,mBAAmB;QACvD,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;QACtD,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,mBAAmB,EAAE,IAAI;KACsD,CAAA;AACnF,CAAC,CAAA;AAiBD,MAAM,CAAC,MAAM,MAAM,GAAG,CAIpB,KAKD,EAIC,EAAE;IACF,MAAM,mBAAmB,GAAG,KAAK,EAAE,OAAiB,EAAE,OAA4B,EAAoB,EAAE;QACtG,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;IAC7G,CAAC,CAAA;IAED,MAAM,GAAG,GAAG;QACV,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,mBAAmB;QACvD,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;QACtD,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACiB,CAAA;IAE3C,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA"}

package/build/api/schema/input-source/load.d.ts

@@ -0,0 +1,23 @@
+import { Config as PolenConfig } from '#api/config/$';
+import type { Config } from '#api/schema/config';
+import type { InputSource } from '#api/schema/input-source/input-source';
+import type { Catalog } from '#lib/catalog/$';
+/**
+ * Result of schema reading with provenance tracking for file watching and debugging.
+ */
+export interface LoadedCatalog {
+    data: Catalog.Catalog | null;
+    source: InputSource;
+}
+export interface Context {
+    paths: PolenConfig.Config['paths'];
+}
+type InputSourceName = string;
+export declare const loadOrThrow: (params: {
+    context: Context;
+    config: Config | null;
+    useFirst: (InputSourceName[]) | null;
+    sources: InputSource[];
+}) => Promise<LoadedCatalog>;
+export {};
+//# sourceMappingURL=load.d.ts.map

package/build/api/schema/input-source/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../../src/api/schema/input-source/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAA;AACxE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAE7C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC,OAAO,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE,WAAW,CAAA;CAapB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;CACnC;AAED,KAAK,eAAe,GAAG,MAAM,CAAA;AAE7B,eAAO,MAAM,WAAW,GACtB,QAAQ;IACN,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,EAAE,CAAC,eAAe,EAAE,CAAC,GAAG,IAAI,CAAA;IACpC,OAAO,EAAE,WAAW,EAAE,CAAA;CACvB,KACA,OAAO,CAAC,aAAa,CAoCvB,CAAA"}

package/build/api/schema/input-source/load.js

@@ -0,0 +1,39 @@
+import { Config as PolenConfig } from '#api/config/$';
+export const loadOrThrow = async (params) => {
+    const getSourceConfig = (sourceName) => {
+        const sourceConfigs = (params.config?.sources ?? {});
+        const sourceConfig = sourceConfigs[sourceName] ?? {};
+        return sourceConfig;
+    };
+    // If useFirst is specified, try sources in that specific order
+    if (params.useFirst) {
+        for (const sourceName of params.useFirst) {
+            const source = params.sources.find(s => s.name === sourceName);
+            if (!source)
+                continue;
+            const sourceConfig = getSourceConfig(source.name);
+            const result = await source.readIfApplicableOrThrow(sourceConfig, params.context);
+            if (result) {
+                return {
+                    data: result,
+                    source,
+                };
+            }
+        }
+    }
+    else {
+        // Otherwise, try all sources in the order they were provided
+        for (const source of params.sources) {
+            const sourceConfig = getSourceConfig(source.name);
+            const result = await source.readIfApplicableOrThrow(sourceConfig, params.context);
+            if (result) {
+                return {
+                    data: result,
+                    source,
+                };
+            }
+        }
+    }
+    throw new Error(`No applicable schema source found. Please check your configuration.`);
+};
+//# sourceMappingURL=load.js.map

package/build/api/schema/input-source/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../../../src/api/schema/input-source/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,eAAe,CAAA;AA+BrD,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC9B,MAKC,EACuB,EAAE;IAC1B,MAAM,eAAe,GAAG,CAAC,UAA2B,EAAE,EAAE;QACtD,MAAM,aAAa,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,IAAI,EAAE,CAAoC,CAAA;QACvF,MAAM,YAAY,GAAG,aAAa,CAAC,UAAU,CAAC,IAAI,EAAE,CAAA;QACpD,OAAO,YAAY,CAAA;IACrB,CAAC,CAAA;IACD,+DAA+D;IAC/D,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAA;YAC9D,IAAI,CAAC,MAAM;gBAAE,SAAQ;YAErB,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YACjD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,YAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;YACxF,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO;oBACL,IAAI,EAAE,MAAM;oBACZ,MAAM;iBACP,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,6DAA6D;QAC7D,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YACjD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,YAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;YACxF,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO;oBACL,IAAI,EAAE,MAAM;oBACZ,MAAM;iBACP,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAA;AACxF,CAAC,CAAA"}

package/build/api/schema/input-sources/$$.d.ts

@@ -0,0 +1,7 @@
+export * as Directory from './directory.js';
+export * as File from './file.js';
+export * as IntrospectionFile from './introspection-file.js';
+export * as Introspection from './introspection.js';
+export * as Memory from './memory.js';
+export * as VersionedDirectory from './versioned-directory.js';
+//# sourceMappingURL=$$.d.ts.map

package/build/api/schema/input-sources/$$.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../../src/api/schema/input-sources/$$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,iBAAiB,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,kBAAkB,MAAM,0BAA0B,CAAA"}

package/build/api/schema/input-sources/$$.js

@@ -0,0 +1,7 @@
+export * as Directory from './directory.js';
+export * as File from './file.js';
+export * as IntrospectionFile from './introspection-file.js';
+export * as Introspection from './introspection.js';
+export * as Memory from './memory.js';
+export * as VersionedDirectory from './versioned-directory.js';
+//# sourceMappingURL=$$.js.map

package/build/api/schema/input-sources/$$.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.js","sourceRoot":"","sources":["../../../../src/api/schema/input-sources/$$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,iBAAiB,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,kBAAkB,MAAM,0BAA0B,CAAA"}

package/build/api/schema/input-sources/$.d.ts

@@ -0,0 +1,2 @@
+export * as InputSources from './$$.js';
+//# sourceMappingURL=$.d.ts.map

package/build/api/schema/input-sources/$.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"$.d.ts","sourceRoot":"","sources":["../../../../src/api/schema/input-sources/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,SAAS,CAAA"}

package/build/api/schema/input-sources/$.js

@@ -0,0 +1,2 @@
+export * as InputSources from './$$.js';
+//# sourceMappingURL=$.js.map

package/build/api/schema/input-sources/$.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"$.js","sourceRoot":"","sources":["../../../../src/api/schema/input-sources/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,SAAS,CAAA"}