polen 0.11.0-next.22 → 0.11.0-next.24

package/build/lib/catalog/versioned.d.ts

@@ -1551,11 +1551,11 @@ export declare const make: (props: {
                 readonly path?: string | undefined;
                 readonly message: string;
                 readonly name: string;
+                readonly locations: readonly string[];
                 readonly criticality: {
                     readonly reason?: string | undefined;
                     readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                 };
-                readonly locations: readonly string[];
             } | {
                 readonly _tag: "DIRECTIVE_REMOVED";
                 readonly path?: string | undefined;
@@ -2146,11 +2146,11 @@ export declare const make: (props: {
                     readonly path?: string | undefined;
                     readonly message: string;
                     readonly name: string;
+                    readonly locations: readonly string[];
                     readonly criticality: {
                         readonly reason?: string | undefined;
                         readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                     };
-                    readonly locations: readonly string[];
                 } | {
                     readonly _tag: "DIRECTIVE_REMOVED";
                     readonly path?: string | undefined;
@@ -2743,11 +2743,11 @@ export declare const make: (props: {
                 readonly path?: string | undefined;
                 readonly message: string;
                 readonly name: string;
+                readonly locations: readonly string[];
                 readonly criticality: {
                     readonly reason?: string | undefined;
                     readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                 };
-                readonly locations: readonly string[];
             } | {
                 readonly _tag: "DIRECTIVE_REMOVED";
                 readonly path?: string | undefined;
@@ -3338,11 +3338,11 @@ export declare const make: (props: {
                     readonly path?: string | undefined;
                     readonly message: string;
                     readonly name: string;
+                    readonly locations: readonly string[];
                     readonly criticality: {
                         readonly reason?: string | undefined;
                         readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                     };
-                    readonly locations: readonly string[];
                 } | {
                     readonly _tag: "DIRECTIVE_REMOVED";
                     readonly path?: string | undefined;
@@ -3936,11 +3936,11 @@ export declare const is: (u: unknown, overrideOptions?: import("effect/SchemaAST
                 readonly path?: string | undefined;
                 readonly message: string;
                 readonly name: string;
+                readonly locations: readonly string[];
                 readonly criticality: {
                     readonly reason?: string | undefined;
                     readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                 };
-                readonly locations: readonly string[];
             } | {
                 readonly _tag: "DIRECTIVE_REMOVED";
                 readonly path?: string | undefined;
@@ -4531,11 +4531,11 @@ export declare const is: (u: unknown, overrideOptions?: import("effect/SchemaAST
                     readonly path?: string | undefined;
                     readonly message: string;
                     readonly name: string;
+                    readonly locations: readonly string[];
                     readonly criticality: {
                         readonly reason?: string | undefined;
                         readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                     };
-                    readonly locations: readonly string[];
                 } | {
                     readonly _tag: "DIRECTIVE_REMOVED";
                     readonly path?: string | undefined;
@@ -5128,11 +5128,11 @@ export declare const decode: (i: {
                 readonly _tag: "DIRECTIVE_ADDED";
                 readonly message: string;
                 readonly name: string;
+                readonly locations: readonly string[];
                 readonly criticality: {
                     readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                     readonly reason?: string | undefined;
                 };
-                readonly locations: readonly string[];
                 readonly path?: string | undefined;
             } | {
                 readonly _tag: "DIRECTIVE_REMOVED";
@@ -5723,11 +5723,11 @@ export declare const decode: (i: {
                     readonly _tag: "DIRECTIVE_ADDED";
                     readonly message: string;
                     readonly name: string;
+                    readonly locations: readonly string[];
                     readonly criticality: {
                         readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                         readonly reason?: string | undefined;
                     };
-                    readonly locations: readonly string[];
                     readonly path?: string | undefined;
                 } | {
                     readonly _tag: "DIRECTIVE_REMOVED";
@@ -6321,11 +6321,11 @@ export declare const decode: (i: {
                 readonly path?: string | undefined;
                 readonly message: string;
                 readonly name: string;
+                readonly locations: readonly string[];
                 readonly criticality: {
                     readonly reason?: string | undefined;
                     readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                 };
-                readonly locations: readonly string[];
             } | {
                 readonly _tag: "DIRECTIVE_REMOVED";
                 readonly path?: string | undefined;
@@ -6916,11 +6916,11 @@ export declare const decode: (i: {
                     readonly path?: string | undefined;
                     readonly message: string;
                     readonly name: string;
+                    readonly locations: readonly string[];
                     readonly criticality: {
                         readonly reason?: string | undefined;
                         readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                     };
-                    readonly locations: readonly string[];
                 } | {
                     readonly _tag: "DIRECTIVE_REMOVED";
                     readonly path?: string | undefined;
@@ -7514,11 +7514,11 @@ export declare const encode: (a: {
                 readonly path?: string | undefined;
                 readonly message: string;
                 readonly name: string;
+                readonly locations: readonly string[];
                 readonly criticality: {
                     readonly reason?: string | undefined;
                     readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                 };
-                readonly locations: readonly string[];
             } | {
                 readonly _tag: "DIRECTIVE_REMOVED";
                 readonly path?: string | undefined;
@@ -8109,11 +8109,11 @@ export declare const encode: (a: {
                     readonly path?: string | undefined;
                     readonly message: string;
                     readonly name: string;
+                    readonly locations: readonly string[];
                     readonly criticality: {
                         readonly reason?: string | undefined;
                         readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                     };
-                    readonly locations: readonly string[];
                 } | {
                     readonly _tag: "DIRECTIVE_REMOVED";
                     readonly path?: string | undefined;
@@ -8705,11 +8705,11 @@ export declare const encode: (a: {
                 readonly _tag: "DIRECTIVE_ADDED";
                 readonly message: string;
                 readonly name: string;
+                readonly locations: readonly string[];
                 readonly criticality: {
                     readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                     readonly reason?: string | undefined;
                 };
-                readonly locations: readonly string[];
                 readonly path?: string | undefined;
             } | {
                 readonly _tag: "DIRECTIVE_REMOVED";
@@ -9300,11 +9300,11 @@ export declare const encode: (a: {
                     readonly _tag: "DIRECTIVE_ADDED";
                     readonly message: string;
                     readonly name: string;
+                    readonly locations: readonly string[];
                     readonly criticality: {
                         readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                         readonly reason?: string | undefined;
                     };
-                    readonly locations: readonly string[];
                     readonly path?: string | undefined;
                 } | {
                     readonly _tag: "DIRECTIVE_REMOVED";
@@ -9899,11 +9899,11 @@ export declare const equivalence: import("effect/Equivalence").Equivalence<{
                 readonly path?: string | undefined;
                 readonly message: string;
                 readonly name: string;
+                readonly locations: readonly string[];
                 readonly criticality: {
                     readonly reason?: string | undefined;
                     readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                 };
-                readonly locations: readonly string[];
             } | {
                 readonly _tag: "DIRECTIVE_REMOVED";
                 readonly path?: string | undefined;
@@ -10494,11 +10494,11 @@ export declare const equivalence: import("effect/Equivalence").Equivalence<{
                     readonly path?: string | undefined;
                     readonly message: string;
                     readonly name: string;
+                    readonly locations: readonly string[];
                     readonly criticality: {
                         readonly reason?: string | undefined;
                         readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
                     };
-                    readonly locations: readonly string[];
                 } | {
                     readonly _tag: "DIRECTIVE_REMOVED";
                     readonly path?: string | undefined;

package/build/lib/change/change.d.ts

@@ -1573,11 +1573,11 @@ export declare const is: (u: unknown, overrideOptions?: import("effect/SchemaAST
     readonly path?: string | undefined;
     readonly message: string;
     readonly name: string;
+    readonly locations: readonly string[];
     readonly criticality: {
         readonly reason?: string | undefined;
         readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
     };
-    readonly locations: readonly string[];
 } | {
     readonly _tag: "DIRECTIVE_REMOVED";
     readonly path?: string | undefined;
@@ -2206,11 +2206,11 @@ export declare const decode: (i: {
     readonly _tag: "DIRECTIVE_ADDED";
     readonly message: string;
     readonly name: string;
+    readonly locations: readonly string[];
     readonly criticality: {
         readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
         readonly reason?: string | undefined;
     };
-    readonly locations: readonly string[];
     readonly path?: string | undefined;
 } | {
     readonly _tag: "DIRECTIVE_REMOVED";
@@ -2793,11 +2793,11 @@ export declare const decode: (i: {
     readonly path?: string | undefined;
     readonly message: string;
     readonly name: string;
+    readonly locations: readonly string[];
     readonly criticality: {
         readonly reason?: string | undefined;
         readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
     };
-    readonly locations: readonly string[];
 } | {
     readonly _tag: "DIRECTIVE_REMOVED";
     readonly path?: string | undefined;
@@ -3380,11 +3380,11 @@ export declare const encode: (a: {
     readonly path?: string | undefined;
     readonly message: string;
     readonly name: string;
+    readonly locations: readonly string[];
     readonly criticality: {
         readonly reason?: string | undefined;
         readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
     };
-    readonly locations: readonly string[];
 } | {
     readonly _tag: "DIRECTIVE_REMOVED";
     readonly path?: string | undefined;
@@ -3965,11 +3965,11 @@ export declare const encode: (a: {
     readonly _tag: "DIRECTIVE_ADDED";
     readonly message: string;
     readonly name: string;
+    readonly locations: readonly string[];
     readonly criticality: {
         readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
         readonly reason?: string | undefined;
     };
-    readonly locations: readonly string[];
     readonly path?: string | undefined;
 } | {
     readonly _tag: "DIRECTIVE_REMOVED";
@@ -4569,11 +4569,11 @@ export declare const equivalence: import("effect/Equivalence").Equivalence<{
     readonly path?: string | undefined;
     readonly message: string;
     readonly name: string;
+    readonly locations: readonly string[];
     readonly criticality: {
         readonly reason?: string | undefined;
         readonly level: "BREAKING" | "DANGEROUS" | "NON_BREAKING";
     };
-    readonly locations: readonly string[];
 } | {
     readonly _tag: "DIRECTIVE_REMOVED";
     readonly path?: string | undefined;

package/build/lib/grafaid/$$.d.ts

@@ -1,5 +1,7 @@
 export * as Document from './document.js';
 export * from './graphql.js';
 export * as HTTP from './http/http.js';
+export { ParseError } from './parse-error.js';
+export * as Parse from './parse.js';
 export * as Schema from './schema/schema.js';
 //# sourceMappingURL=$$.d.ts.map

package/build/lib/grafaid/$$.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../src/lib/grafaid/$$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,cAAc,cAAc,CAAA;AAC5B,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAA;AACtC,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../src/lib/grafaid/$$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,cAAc,cAAc,CAAA;AAC5B,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA"}

package/build/lib/grafaid/$$.js

@@ -1,5 +1,7 @@
 export * as Document from './document.js';
 export * from './graphql.js';
 export * as HTTP from './http/http.js';
+export { ParseError } from './parse-error.js';
+export * as Parse from './parse.js';
 export * as Schema from './schema/schema.js';
 //# sourceMappingURL=$$.js.map

package/build/lib/grafaid/$$.js.map

@@ -1 +1 @@
-{"version":3,"file":"$$.js","sourceRoot":"","sources":["../../../src/lib/grafaid/$$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,cAAc,cAAc,CAAA;AAC5B,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAA;AACtC,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"$$.js","sourceRoot":"","sources":["../../../src/lib/grafaid/$$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,cAAc,cAAc,CAAA;AAC5B,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA"}

package/build/lib/grafaid/parse-error.d.ts

@@ -0,0 +1,46 @@
+declare const ParseError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ParseError";
+} & Readonly<A>;
+/**
+ * Error that occurs when parsing GraphQL source text fails.
+ *
+ * This error provides structured information about parse failures,
+ * including the source context and the underlying parse error details.
+ */
+export declare class ParseError extends ParseError_base<{
+    /**
+     * The type of GraphQL content being parsed.
+     * Helps identify whether the error occurred while parsing a schema or a document.
+     */
+    readonly parseType: 'schema' | 'document' | 'unknown';
+    /**
+     * Optional source identifier for debugging.
+     * Could be a file path, URL, or other identifier.
+     */
+    readonly source?: string;
+    /**
+     * The error message describing what went wrong.
+     */
+    readonly message: string;
+    /**
+     * The original error that caused the parse failure.
+     */
+    readonly cause?: unknown;
+    /**
+     * Optional excerpt of the source text where the error occurred.
+     * Useful for showing context in error messages.
+     */
+    readonly excerpt?: string;
+}> {
+}
+/**
+ * Helper to create a ParseError with common defaults.
+ */
+export declare const makeParseError: (message: string, options?: {
+    parseType?: "schema" | "document" | "unknown";
+    source?: string;
+    cause?: unknown;
+    excerpt?: string;
+}) => ParseError;
+export {};
+//# sourceMappingURL=parse-error.d.ts.map

package/build/lib/grafaid/parse-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-error.d.ts","sourceRoot":"","sources":["../../../src/lib/grafaid/parse-error.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,gBAA+B;IAC7D;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;IAErD;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IAExB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAC;CAAG;AAEL;;GAEG;AACH,eAAO,MAAM,cAAc,GACzB,SAAS,MAAM,EACf,UAAU;IACR,SAAS,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,KACA,UAmBF,CAAA"}

package/build/lib/grafaid/parse-error.js

@@ -0,0 +1,29 @@
+import { Data } from 'effect';
+/**
+ * Error that occurs when parsing GraphQL source text fails.
+ *
+ * This error provides structured information about parse failures,
+ * including the source context and the underlying parse error details.
+ */
+export class ParseError extends Data.TaggedError('ParseError') {
+}
+/**
+ * Helper to create a ParseError with common defaults.
+ */
+export const makeParseError = (message, options) => {
+    const props = {
+        parseType: options?.parseType ?? 'unknown',
+        message,
+    };
+    if (options?.source !== undefined) {
+        props.source = options.source;
+    }
+    if (options?.cause !== undefined) {
+        props.cause = options.cause;
+    }
+    if (options?.excerpt !== undefined) {
+        props.excerpt = options.excerpt;
+    }
+    return new ParseError(props);
+};
+//# sourceMappingURL=parse-error.js.map

package/build/lib/grafaid/parse-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-error.js","sourceRoot":"","sources":["../../../src/lib/grafaid/parse-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAE7B;;;;;GAKG;AACH,MAAM,OAAO,UAAW,SAAQ,IAAI,CAAC,WAAW,CAAC,YAAY,CA4B3D;CAAG;AAEL;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,OAAe,EACf,OAKC,EACW,EAAE;IACd,MAAM,KAAK,GAAQ;QACjB,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,SAAS;QAC1C,OAAO;KACR,CAAA;IAED,IAAI,OAAO,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAC/B,CAAC;IAED,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;QACjC,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;IAC7B,CAAC;IAED,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IACjC,CAAC;IAED,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAA;AAC9B,CAAC,CAAA"}

package/build/lib/grafaid/parse.d.ts

@@ -0,0 +1,70 @@
+import { Effect } from 'effect';
+import { type DocumentNode } from 'graphql';
+import { ParseError } from './parse-error.js';
+/**
+ * Parse GraphQL source text into an AST.
+ *
+ * This is the centralized parsing function that should be used throughout
+ * the codebase for parsing any GraphQL content (schemas or documents).
+ *
+ * @param source - The GraphQL source text to parse
+ * @param options - Optional parsing configuration
+ * @returns An Effect that yields a DocumentNode AST or fails with ParseError
+ *
+ * @example
+ * ```ts
+ * // Parse a schema
+ * const schemaAst = yield* parse(schemaSDL, {
+ *   parseType: 'schema',
+ *   source: 'schema.graphql'
+ * })
+ *
+ * // Parse a query document
+ * const queryAst = yield* parse(queryString, {
+ *   parseType: 'document',
+ *   source: 'getUserQuery'
+ * })
+ * ```
+ */
+export declare const parse: (source: string, options?: {
+    /**
+     * The type of content being parsed.
+     * Helps provide better error messages.
+     */
+    parseType?: "schema" | "document" | "unknown";
+    /**
+     * Optional source identifier for debugging.
+     * Could be a file path, URL, or descriptive name.
+     */
+    source?: string;
+}) => Effect.Effect<DocumentNode, ParseError>;
+/**
+ * Parse GraphQL schema SDL with typed errors.
+ *
+ * This is a specialized version of parse() that's explicitly for schemas.
+ *
+ * @param source - The GraphQL schema SDL to parse
+ * @param options - Optional parsing configuration
+ * @returns An Effect that yields a DocumentNode AST or fails with ParseError
+ */
+export declare const parseSchema: (source: string, options?: {
+    source?: string;
+}) => Effect.Effect<DocumentNode, ParseError>;
+/**
+ * Parse GraphQL document (query/mutation/subscription) with typed errors.
+ *
+ * This is a specialized version of parse() that's explicitly for executable documents.
+ *
+ * @param source - The GraphQL document to parse
+ * @param options - Optional parsing configuration
+ * @returns An Effect that yields a DocumentNode AST or fails with ParseError
+ */
+export declare const parseDocument: (source: string, options?: {
+    source?: string;
+}) => Effect.Effect<DocumentNode, ParseError>;
+/**
+ * Create an empty DocumentNode.
+ * Useful for representing an absence of GraphQL content.
+ */
+export declare const empty: DocumentNode;
+//# sourceMappingURL=parse.d.ts.map

package/build/lib/grafaid/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/lib/grafaid/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,KAAK,YAAY,EAA+B,MAAM,SAAS,CAAA;AACxE,OAAO,EAAkB,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,KAAK,GAChB,QAAQ,MAAM,EACd,UAAU;IACR;;;OAGG;IACH,SAAS,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;IAE7C;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,KACA,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CA6CrC,CAAA;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,EACd,UAAU;IACR,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,KACA,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAIrC,CAAA;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,MAAM,EACd,UAAU;IACR,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,KACA,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAIrC,CAAA;AA4BJ;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,YAGnB,CAAA"}

package/build/lib/grafaid/parse.js

@@ -0,0 +1,119 @@
+import { Effect } from 'effect';
+import { Kind, parse as graphqlParse } from 'graphql';
+import { makeParseError, ParseError } from './parse-error.js';
+/**
+ * Parse GraphQL source text into an AST.
+ *
+ * This is the centralized parsing function that should be used throughout
+ * the codebase for parsing any GraphQL content (schemas or documents).
+ *
+ * @param source - The GraphQL source text to parse
+ * @param options - Optional parsing configuration
+ * @returns An Effect that yields a DocumentNode AST or fails with ParseError
+ *
+ * @example
+ * ```ts
+ * // Parse a schema
+ * const schemaAst = yield* parse(schemaSDL, {
+ *   parseType: 'schema',
+ *   source: 'schema.graphql'
+ * })
+ *
+ * // Parse a query document
+ * const queryAst = yield* parse(queryString, {
+ *   parseType: 'document',
+ *   source: 'getUserQuery'
+ * })
+ * ```
+ */
+export const parse = (source, options) => Effect.try({
+    try: () => graphqlParse(source),
+    catch: (error) => {
+        // Extract useful error information
+        let message = 'Failed to parse GraphQL';
+        let excerpt;
+        if (error instanceof Error) {
+            message = error.message;
+            // GraphQL parse errors often include location info
+            // Try to extract a meaningful excerpt if possible
+            if ('locations' in error && Array.isArray(error.locations) && error.locations.length > 0) {
+                const location = error.locations[0];
+                if (location && typeof location.line === 'number') {
+                    const lines = source.split('\n');
+                    const errorLine = lines[location.line - 1];
+                    if (errorLine) {
+                        excerpt = `Line ${location.line}: ${errorLine.trim()}`;
+                    }
+                }
+            }
+        }
+        const parseType = options?.parseType ?? inferParseType(source);
+        const errorOptions = {
+            parseType,
+            cause: error,
+        };
+        if (options?.source) {
+            errorOptions.source = options.source;
+        }
+        if (excerpt) {
+            errorOptions.excerpt = excerpt;
+        }
+        return makeParseError(`Failed to parse GraphQL ${parseType}${options?.source ? ` from ${options.source}` : ''}: ${message}`, errorOptions);
+    },
+});
+/**
+ * Parse GraphQL schema SDL with typed errors.
+ *
+ * This is a specialized version of parse() that's explicitly for schemas.
+ *
+ * @param source - The GraphQL schema SDL to parse
+ * @param options - Optional parsing configuration
+ * @returns An Effect that yields a DocumentNode AST or fails with ParseError
+ */
+export const parseSchema = (source, options) => parse(source, {
+    parseType: 'schema',
+    ...options,
+});
+/**
+ * Parse GraphQL document (query/mutation/subscription) with typed errors.
+ *
+ * This is a specialized version of parse() that's explicitly for executable documents.
+ *
+ * @param source - The GraphQL document to parse
+ * @param options - Optional parsing configuration
+ * @returns An Effect that yields a DocumentNode AST or fails with ParseError
+ */
+export const parseDocument = (source, options) => parse(source, {
+    parseType: 'document',
+    ...options,
+});
+/**
+ * Try to infer whether the source is a schema or document.
+ * This is a best-effort heuristic and may not always be accurate.
+ */
+const inferParseType = (source) => {
+    // Common schema definition keywords
+    const schemaKeywords = /^\s*(type|interface|enum|scalar|union|input|schema|extend|directive)\s+/m;
+    // Common document keywords
+    const documentKeywords = /^\s*(query|mutation|subscription|fragment)\s+/m;
+    if (schemaKeywords.test(source)) {
+        return 'schema';
+    }
+    if (documentKeywords.test(source)) {
+        return 'document';
+    }
+    // Check for anonymous query syntax { ... }
+    if (/^\s*\{/.test(source)) {
+        return 'document';
+    }
+    return 'unknown';
+};
+/**
+ * Create an empty DocumentNode.
+ * Useful for representing an absence of GraphQL content.
+ */
+export const empty = {
+    definitions: [],
+    kind: Kind.DOCUMENT,
+};
+//# sourceMappingURL=parse.js.map

package/build/lib/grafaid/parse.js.map

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

package/build/lib/grafaid/schema/ast.d.ts

@@ -1,6 +1,4 @@
-import { Effect } from 'effect';
 import { type DocumentNode } from 'graphql';
-export declare const parse: (source: string) => Effect.Effect<DocumentNode, Error>;
 export { type DocumentNode as Document } from 'graphql';
 export declare const empty: DocumentNode;
 //# sourceMappingURL=ast.d.ts.map

package/build/lib/grafaid/schema/ast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../../../src/lib/grafaid/schema/ast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,KAAK,YAAY,EAA+B,MAAM,SAAS,CAAA;AAGxE,eAAO,MAAM,KAAK,GAAI,QAAQ,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAIpE,CAAA;AAEJ,OAAO,EAAE,KAAK,YAAY,IAAI,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvD,eAAO,MAAM,KAAK,EAAE,YAAuD,CAAA"}
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../../../src/lib/grafaid/schema/ast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAQ,MAAM,SAAS,CAAA;AAEjD,OAAO,EAAE,KAAK,YAAY,IAAI,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvD,eAAO,MAAM,KAAK,EAAE,YAAuD,CAAA"}

package/build/lib/grafaid/schema/ast.js

@@ -1,10 +1,4 @@
-import { Effect } from 'effect';
-import { Kind, parse as graphqlParse } from 'graphql';
-// Effect-based version of parse
-export const parse = (source) => Effect.try({
-    try: () => graphqlParse(source),
-    catch: (error) => new Error(`Failed to parse GraphQL: ${error}`),
-});
+import { Kind } from 'graphql';
 export {} from 'graphql';
 export const empty = { definitions: [], kind: Kind.DOCUMENT };
 //# sourceMappingURL=ast.js.map

package/build/lib/grafaid/schema/ast.js.map

@@ -1 +1 @@
-{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../../../src/lib/grafaid/schema/ast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAqB,IAAI,EAAE,KAAK,IAAI,YAAY,EAAE,MAAM,SAAS,CAAA;AAExE,gCAAgC;AAChC,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAc,EAAsC,EAAE,CAC1E,MAAM,CAAC,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC;CACjE,CAAC,CAAA;AAEJ,OAAO,EAAiC,MAAM,SAAS,CAAA;AAEvD,MAAM,CAAC,MAAM,KAAK,GAAiB,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAA"}
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../../../src/lib/grafaid/schema/ast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,IAAI,EAAE,MAAM,SAAS,CAAA;AAEjD,OAAO,EAAiC,MAAM,SAAS,CAAA;AAEvD,MAAM,CAAC,MAAM,KAAK,GAAiB,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAA"}

package/build/lib/grafaid/schema/read.js

@@ -2,7 +2,7 @@ import { FileSystem } from '@effect/platform/FileSystem';
 import { Fs } from '@wollybeard/kit';
 import { Effect } from 'effect';
 import {} from 'graphql';
-import * as AST from './ast.js';
+import * as Parse from '../parse.js';
 import { fromAST } from './schema.js';
 export const read = (sdlFilePath) => Effect.gen(function* () {
     const fs = yield* FileSystem;
@@ -14,7 +14,7 @@ export const read = (sdlFilePath) => Effect.gen(function* () {
     // Read file content
     const content = yield* fs.readFileString(sdlFilePath);
     // Parse and build schema
-    const node = yield* AST.parse(content);
+    const node = yield* Parse.parseSchema(content, { source: sdlFilePath });
     const schema = yield* fromAST(node);
     return {
         path: sdlFilePath,

package/build/lib/grafaid/schema/read.js.map

@@ -1 +1 @@
-{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../../src/lib/grafaid/schema/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAsB,MAAM,SAAS,CAAA;AAC5C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,WAAmB,EAAmE,EAAE,CAC3G,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAA;IAE5B,uBAAuB;IACvB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAA;IAC3D,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,oBAAoB;IACpB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,CAAA;IAErD,yBAAyB;IACzB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACtC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnC,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,MAAM;KAChB,CAAA;AACH,CAAC,CAAC,CAAA"}
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../../src/lib/grafaid/schema/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAsB,MAAM,SAAS,CAAA;AAC5C,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,WAAmB,EAAmE,EAAE,CAC3G,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAA;IAE5B,uBAAuB;IACvB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAA;IAC3D,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,oBAAoB;IACpB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,CAAA;IAErD,yBAAyB;IACzB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;IACvE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnC,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,MAAM;KAChB,CAAA;AACH,CAAC,CAAC,CAAA"}