polen 0.11.0-next.12 → 0.11.0-next.13

package/build/lib/graphql-path/$$.d.ts

@@ -0,0 +1,42 @@
+/**
+ * GraphQL Path Library
+ *
+ * This library provides type-safe path representations for GraphQL schemas.
+ * It distinguishes between definition paths (addresses to schema elements)
+ * and query paths (traversal paths through the schema graph).
+ *
+ * @example
+ * ```ts
+ * import { GraphQLPath } from '#lib/graphql-path'
+ *
+ * // Create a path to a type definition
+ * const userTypePath = GraphQLPath.Definition.type('User')
+ *
+ * // Create a path to a field definition
+ * const userNameFieldPath = GraphQLPath.Definition.field('User', 'name')
+ *
+ * // Create a path to an argument definition
+ * const userPostsLimitArgPath = GraphQLPath.Definition.argument('User', 'posts', 'limit')
+ *
+ * // Encode/decode definition paths
+ * const encoded = GraphQLPath.Definition.encode(userNameFieldPath) // "User.name"
+ * const decoded = GraphQLPath.Definition.decode("User.name") // field definition path
+ *
+ * // Create a query path
+ * const queryPath = GraphQLPath.Query.builder()
+ *   .type('User')
+ *   .field('posts')
+ *   .type('Post')
+ *   .field('author')
+ *   .type('User')
+ *   .field('name')
+ *   .build()
+ *
+ * // Encode/decode query paths
+ * const encodedQuery = GraphQLPath.Query.encode(queryPath) // "User.posts.Post.author.User.name"
+ * const decodedQuery = GraphQLPath.Query.decode("User.posts.Post.author") // query path
+ * ```
+ */
+export * as Definition from './definition.js';
+export * as Query from './query.js';
+//# sourceMappingURL=$$.d.ts.map

package/build/lib/graphql-path/$$.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-path/$$.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA"}

package/build/lib/graphql-path/$$.js

@@ -0,0 +1,42 @@
+/**
+ * GraphQL Path Library
+ *
+ * This library provides type-safe path representations for GraphQL schemas.
+ * It distinguishes between definition paths (addresses to schema elements)
+ * and query paths (traversal paths through the schema graph).
+ *
+ * @example
+ * ```ts
+ * import { GraphQLPath } from '#lib/graphql-path'
+ *
+ * // Create a path to a type definition
+ * const userTypePath = GraphQLPath.Definition.type('User')
+ *
+ * // Create a path to a field definition
+ * const userNameFieldPath = GraphQLPath.Definition.field('User', 'name')
+ *
+ * // Create a path to an argument definition
+ * const userPostsLimitArgPath = GraphQLPath.Definition.argument('User', 'posts', 'limit')
+ *
+ * // Encode/decode definition paths
+ * const encoded = GraphQLPath.Definition.encode(userNameFieldPath) // "User.name"
+ * const decoded = GraphQLPath.Definition.decode("User.name") // field definition path
+ *
+ * // Create a query path
+ * const queryPath = GraphQLPath.Query.builder()
+ *   .type('User')
+ *   .field('posts')
+ *   .type('Post')
+ *   .field('author')
+ *   .type('User')
+ *   .field('name')
+ *   .build()
+ *
+ * // Encode/decode query paths
+ * const encodedQuery = GraphQLPath.Query.encode(queryPath) // "User.posts.Post.author.User.name"
+ * const decodedQuery = GraphQLPath.Query.decode("User.posts.Post.author") // query path
+ * ```
+ */
+export * as Definition from './definition.js';
+export * as Query from './query.js';
+//# sourceMappingURL=$$.js.map

package/build/lib/graphql-path/$$.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.js","sourceRoot":"","sources":["../../../src/lib/graphql-path/$$.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA"}

package/build/lib/graphql-path/$.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Namespace export for graphql-path library
+ */
+export * as GraphQLPath from './$$.js';
+//# sourceMappingURL=$.d.ts.map

package/build/lib/graphql-path/$.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"$.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-path/$.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,SAAS,CAAA"}

package/build/lib/graphql-path/$.js

@@ -0,0 +1,5 @@
+/**
+ * Namespace export for graphql-path library
+ */
+export * as GraphQLPath from './$$.js';
+//# sourceMappingURL=$.js.map

package/build/lib/graphql-path/$.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"$.js","sourceRoot":"","sources":["../../../src/lib/graphql-path/$.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,SAAS,CAAA"}

package/build/lib/graphql-path/constructors.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Constructor functions and type guards
+ */
+import type { ArgumentSegment, FieldSegment, QuerySegment, Segment, TypeSegment } from './types.js';
+/**
+ * Type guard to check if a segment is a type segment
+ *
+ * @param segment - The segment to check
+ * @returns True if the segment is a type segment
+ */
+export declare const isTypeSegment: (segment: Segment) => segment is TypeSegment;
+/**
+ * Type guard to check if a segment is a field segment
+ *
+ * @param segment - The segment to check
+ * @returns True if the segment is a field segment
+ */
+export declare const isFieldSegment: (segment: Segment) => segment is FieldSegment;
+/**
+ * Type guard to check if a segment is an argument segment
+ *
+ * @param segment - The segment to check
+ * @returns True if the segment is an argument segment
+ */
+export declare const isArgumentSegment: (segment: Segment) => segment is ArgumentSegment;
+/**
+ * Type guard to check if a segment can be used in a query path
+ *
+ * @param segment - The segment to check
+ * @returns True if the segment can be used in a query path
+ */
+export declare const isQuerySegment: (segment: Segment) => segment is QuerySegment;
+/**
+ * Create a type segment
+ *
+ * @param type - The type name
+ * @returns A type segment
+ * @example createTypeSegment('User') // { kind: 'type', type: 'User' }
+ */
+export declare const createTypeSegment: (type: string) => TypeSegment;
+/**
+ * Create a field segment
+ *
+ * @param field - The field name
+ * @returns A field segment
+ * @example createFieldSegment('name') // { kind: 'field', field: 'name' }
+ */
+export declare const createFieldSegment: (field: string) => FieldSegment;
+/**
+ * Create an argument segment
+ *
+ * @param argument - The argument name
+ * @returns An argument segment
+ * @example createArgumentSegment('limit') // { kind: 'argument', argument: 'limit' }
+ */
+export declare const createArgumentSegment: (argument: string) => ArgumentSegment;
+//# sourceMappingURL=constructors.d.ts.map

package/build/lib/graphql-path/constructors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructors.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-path/constructors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEnG;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,OAAO,KAAG,OAAO,IAAI,WAE3D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,OAAO,KAAG,OAAO,IAAI,YAE5D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,OAAO,KAAG,OAAO,IAAI,eAE/D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,OAAO,KAAG,OAAO,IAAI,YAE5D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,WAG/C,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,YAGjD,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,eAGvD,CAAA"}

package/build/lib/graphql-path/constructors.js

@@ -0,0 +1,73 @@
+/**
+ * Constructor functions and type guards
+ */
+/**
+ * Type guard to check if a segment is a type segment
+ *
+ * @param segment - The segment to check
+ * @returns True if the segment is a type segment
+ */
+export const isTypeSegment = (segment) => {
+    return segment.kind === 'type';
+};
+/**
+ * Type guard to check if a segment is a field segment
+ *
+ * @param segment - The segment to check
+ * @returns True if the segment is a field segment
+ */
+export const isFieldSegment = (segment) => {
+    return segment.kind === 'field';
+};
+/**
+ * Type guard to check if a segment is an argument segment
+ *
+ * @param segment - The segment to check
+ * @returns True if the segment is an argument segment
+ */
+export const isArgumentSegment = (segment) => {
+    return segment.kind === 'argument';
+};
+/**
+ * Type guard to check if a segment can be used in a query path
+ *
+ * @param segment - The segment to check
+ * @returns True if the segment can be used in a query path
+ */
+export const isQuerySegment = (segment) => {
+    return segment.kind === 'type' || segment.kind === 'field';
+};
+/**
+ * Create a type segment
+ *
+ * @param type - The type name
+ * @returns A type segment
+ * @example createTypeSegment('User') // { kind: 'type', type: 'User' }
+ */
+export const createTypeSegment = (type) => ({
+    kind: 'type',
+    type,
+});
+/**
+ * Create a field segment
+ *
+ * @param field - The field name
+ * @returns A field segment
+ * @example createFieldSegment('name') // { kind: 'field', field: 'name' }
+ */
+export const createFieldSegment = (field) => ({
+    kind: 'field',
+    field,
+});
+/**
+ * Create an argument segment
+ *
+ * @param argument - The argument name
+ * @returns An argument segment
+ * @example createArgumentSegment('limit') // { kind: 'argument', argument: 'limit' }
+ */
+export const createArgumentSegment = (argument) => ({
+    kind: 'argument',
+    argument,
+});
+//# sourceMappingURL=constructors.js.map

package/build/lib/graphql-path/constructors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructors.js","sourceRoot":"","sources":["../../../src/lib/graphql-path/constructors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAgB,EAA0B,EAAE;IACxE,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,CAAA;AAChC,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAgB,EAA2B,EAAE;IAC1E,OAAO,OAAO,CAAC,IAAI,KAAK,OAAO,CAAA;AACjC,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAgB,EAA8B,EAAE;IAChF,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU,CAAA;AACpC,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAgB,EAA2B,EAAE;IAC1E,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAA;AAC5D,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAe,EAAE,CAAC,CAAC;IAC/D,IAAI,EAAE,MAAM;IACZ,IAAI;CACL,CAAC,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAgB,EAAE,CAAC,CAAC;IAClE,IAAI,EAAE,OAAO;IACb,KAAK;CACN,CAAC,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAgB,EAAmB,EAAE,CAAC,CAAC;IAC3E,IAAI,EAAE,UAAU;IAChB,QAAQ;CACT,CAAC,CAAA"}

package/build/lib/graphql-path/definition.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Definition path operations
+ */
+import type { ArgumentSegment, FieldSegment, TypeSegment } from '#lib/graphql-path/types';
+/**
+ * Encode a definition path to a human-readable expression string
+ *
+ * @param path - The definition path to encode
+ * @returns A string expression representation
+ * @example
+ * encode(field('User', 'name')) // 'User.name'
+ * encode(argument('User', 'posts', 'limit')) // 'User.posts(limit)'
+ */
+export declare const encode: (path: DefinitionPath) => string;
+/**
+ * Decode a string expression into a definition path
+ *
+ * @param expression - The string expression to decode
+ * @returns The decoded definition path or null if invalid
+ * @example
+ * decode('User') // type definition path
+ * decode('User.name') // field definition path
+ * decode('User.posts(limit)') // argument definition path
+ */
+export declare const decode: (expression: string) => DefinitionPath | null;
+/**
+ * Extract the type name from any definition path
+ *
+ * @param path - The definition path
+ * @returns The type name
+ * @example getType([{ kind: 'type', type: 'User' }]) // 'User'
+ */
+export declare const getType: (path: DefinitionPath) => string;
+/**
+ * Extract the field name from a field or argument definition path
+ *
+ * @param path - The field or argument definition path
+ * @returns The field name
+ * @example getField([{ kind: 'type', type: 'User' }, { kind: 'field', field: 'name' }]) // 'name'
+ */
+export declare const getField: (path: FieldDefinitionPath | ArgumentDefinitionPath) => string;
+/**
+ * Extract the argument name from an argument definition path
+ *
+ * @param path - The argument definition path
+ * @returns The argument name
+ * @example getArgument([{ kind: 'type', type: 'User' }, { kind: 'field', field: 'posts' }, { kind: 'argument', argument: 'limit' }]) // 'limit'
+ */
+export declare const getArgument: (path: ArgumentDefinitionPath) => string;
+/**
+ * Parse field path like "User.email" into type and field names
+ */
+export declare const parseFieldPath: (path?: string) => {
+    typeName: string | null;
+    fieldName: string | null;
+};
+/**
+ * Definition paths - direct paths to schema definition elements
+ * These represent the "address" of a specific schema element
+ */
+export type DefinitionPath = TypeDefinitionPath | FieldDefinitionPath | ArgumentDefinitionPath;
+/**
+ * Path to a type definition
+ * @example [{ kind: 'type', type: 'User' }]
+ */
+export type TypeDefinitionPath = [TypeSegment];
+/**
+ * Path to a field definition (type + field)
+ * @example [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'name' }]
+ */
+export type FieldDefinitionPath = [TypeSegment, FieldSegment];
+/**
+ * Path to an argument definition (type + field + argument)
+ * @example [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'posts' }, { kind: 'argument', argument: 'limit' }]
+ */
+export type ArgumentDefinitionPath = [TypeSegment, FieldSegment, ArgumentSegment];
+/**
+ * Type guard to check if a path is a type definition path
+ *
+ * @param path - The path to check
+ * @returns True if the path is a type definition path
+ */
+export declare const isTypeDefinitionPath: (path: DefinitionPath) => path is TypeDefinitionPath;
+/**
+ * Type guard to check if a path is a field definition path
+ *
+ * @param path - The path to check
+ * @returns True if the path is a field definition path
+ */
+export declare const isFieldDefinitionPath: (path: DefinitionPath) => path is FieldDefinitionPath;
+/**
+ * Type guard to check if a path is an argument definition path
+ *
+ * @param path - The path to check
+ * @returns True if the path is an argument definition path
+ */
+export declare const isArgumentDefinitionPath: (path: DefinitionPath) => path is ArgumentDefinitionPath;
+/**
+ * Create a path to a type definition
+ *
+ * @param type - The type name
+ * @returns A type definition path
+ * @example createTypeDefinitionPath('User') // [{ kind: 'type', type: 'User' }]
+ */
+export declare const createTypeDefinitionPath: (type: string) => TypeDefinitionPath;
+/**
+ * Create a path to a field definition
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @returns A field definition path
+ * @example createFieldDefinitionPath('User', 'name') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'name' }]
+ */
+export declare const createFieldDefinitionPath: (type: string, field: string) => FieldDefinitionPath;
+/**
+ * Create a path to an argument definition
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @param argument - The argument name
+ * @returns An argument definition path
+ * @example createArgumentDefinitionPath('User', 'posts', 'limit') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'posts' }, { kind: 'argument', argument: 'limit' }]
+ */
+export declare const createArgumentDefinitionPath: (type: string, field: string, argument: string) => ArgumentDefinitionPath;
+/**
+ * Create a type definition path
+ *
+ * @param type - The type name
+ * @returns A type definition path
+ * @example type('User') // [{ kind: 'type', type: 'User' }]
+ */
+export declare const type: (type: string) => TypeDefinitionPath;
+/**
+ * Create a field definition path
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @returns A field definition path
+ * @example field('User', 'name') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'name' }]
+ */
+export declare const field: (type: string, field: string) => FieldDefinitionPath;
+/**
+ * Create an argument definition path
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @param argument - The argument name
+ * @returns An argument definition path
+ * @example argument('User', 'posts', 'limit') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'posts' }, { kind: 'argument', argument: 'limit' }]
+ */
+export declare const argument: (type: string, field: string, argument: string) => ArgumentDefinitionPath;
+//# sourceMappingURL=definition.d.ts.map

package/build/lib/graphql-path/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-path/definition.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAEzF;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,cAAc,KAAG,MAS7C,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,GAAI,YAAY,MAAM,KAAG,cAAc,GAAG,IAwB5D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,cAAc,KAAG,MAE9C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,mBAAmB,GAAG,sBAAsB,KAAG,MAE7E,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,sBAAsB,KAAG,MAE1D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAYjG,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,mBAAmB,GACnB,sBAAsB,CAAA;AAE1B;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,WAAW,CAAC,CAAA;AAE9C;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,CAAA;AAE7D;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,eAAe,CAAC,CAAA;AAEjF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,cAAc,KAAG,IAAI,IAAI,kBAEnE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,cAAc,KAAG,IAAI,IAAI,mBAEpE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,cAAc,KAAG,IAAI,IAAI,sBAEvE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,MAAM,KAAG,kBAEvD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,mBAEvE,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,EACZ,OAAO,MAAM,EACb,UAAU,MAAM,KACf,sBAEF,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,SAxC8B,MAAM,KAAG,kBAwCZ,CAAA;AAE5C;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,SAtC8B,MAAM,SAAS,MAAM,KAAG,mBAsC1B,CAAA;AAE9C;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,SAnCb,MAAM,SACL,MAAM,YACH,MAAM,KACf,sBAgCiD,CAAA"}

package/build/lib/graphql-path/definition.js

@@ -0,0 +1,192 @@
+/**
+ * Definition path operations
+ */
+import { createArgumentSegment, createFieldSegment, createTypeSegment } from './constructors.js';
+/**
+ * Encode a definition path to a human-readable expression string
+ *
+ * @param path - The definition path to encode
+ * @returns A string expression representation
+ * @example
+ * encode(field('User', 'name')) // 'User.name'
+ * encode(argument('User', 'posts', 'limit')) // 'User.posts(limit)'
+ */
+export const encode = (path) => {
+    if (isTypeDefinitionPath(path)) {
+        return path[0].type;
+    }
+    else if (isFieldDefinitionPath(path)) {
+        return `${path[0].type}.${path[1].field}`;
+    }
+    else if (isArgumentDefinitionPath(path)) {
+        return `${path[0].type}.${path[1].field}(${path[2].argument})`;
+    }
+    return '';
+};
+/**
+ * Decode a string expression into a definition path
+ *
+ * @param expression - The string expression to decode
+ * @returns The decoded definition path or null if invalid
+ * @example
+ * decode('User') // type definition path
+ * decode('User.name') // field definition path
+ * decode('User.posts(limit)') // argument definition path
+ */
+export const decode = (expression) => {
+    // Handle argument path: Type.field(argument)
+    const argMatch = expression.match(/^([^.]+)\.([^.(]+)\(([^)]+)\)$/);
+    if (argMatch) {
+        const [, typeName, fieldName, argName] = argMatch;
+        if (!typeName || !fieldName || !argName)
+            return null;
+        return createArgumentDefinitionPath(typeName, fieldName, argName);
+    }
+    // Handle field path: Type.field
+    const fieldMatch = expression.match(/^([^.]+)\.([^.]+)$/);
+    if (fieldMatch) {
+        const [, typeName, fieldName] = fieldMatch;
+        if (!typeName || !fieldName)
+            return null;
+        return createFieldDefinitionPath(typeName, fieldName);
+    }
+    // Handle type path: Type
+    const typeMatch = expression.match(/^[^.]+$/);
+    if (typeMatch) {
+        return createTypeDefinitionPath(expression);
+    }
+    return null;
+};
+/**
+ * Extract the type name from any definition path
+ *
+ * @param path - The definition path
+ * @returns The type name
+ * @example getType([{ kind: 'type', type: 'User' }]) // 'User'
+ */
+export const getType = (path) => {
+    return path[0].type;
+};
+/**
+ * Extract the field name from a field or argument definition path
+ *
+ * @param path - The field or argument definition path
+ * @returns The field name
+ * @example getField([{ kind: 'type', type: 'User' }, { kind: 'field', field: 'name' }]) // 'name'
+ */
+export const getField = (path) => {
+    return path[1].field;
+};
+/**
+ * Extract the argument name from an argument definition path
+ *
+ * @param path - The argument definition path
+ * @returns The argument name
+ * @example getArgument([{ kind: 'type', type: 'User' }, { kind: 'field', field: 'posts' }, { kind: 'argument', argument: 'limit' }]) // 'limit'
+ */
+export const getArgument = (path) => {
+    return path[2].argument;
+};
+/**
+ * Parse field path like "User.email" into type and field names
+ */
+export const parseFieldPath = (path) => {
+    if (!path)
+        return { typeName: null, fieldName: null };
+    const parts = path.split('.');
+    if (parts.length >= 2) {
+        return {
+            typeName: parts[0] || null,
+            fieldName: parts[1] || null,
+        };
+    }
+    return { typeName: null, fieldName: null };
+};
+/**
+ * Type guard to check if a path is a type definition path
+ *
+ * @param path - The path to check
+ * @returns True if the path is a type definition path
+ */
+export const isTypeDefinitionPath = (path) => {
+    return path.length === 1 && path[0].kind === 'type';
+};
+/**
+ * Type guard to check if a path is a field definition path
+ *
+ * @param path - The path to check
+ * @returns True if the path is a field definition path
+ */
+export const isFieldDefinitionPath = (path) => {
+    return path.length === 2 && path[0].kind === 'type' && path[1].kind === 'field';
+};
+/**
+ * Type guard to check if a path is an argument definition path
+ *
+ * @param path - The path to check
+ * @returns True if the path is an argument definition path
+ */
+export const isArgumentDefinitionPath = (path) => {
+    return path.length === 3 && path[0].kind === 'type' && path[1].kind === 'field' && path[2].kind === 'argument';
+};
+/**
+ * Create a path to a type definition
+ *
+ * @param type - The type name
+ * @returns A type definition path
+ * @example createTypeDefinitionPath('User') // [{ kind: 'type', type: 'User' }]
+ */
+export const createTypeDefinitionPath = (type) => {
+    return [createTypeSegment(type)];
+};
+/**
+ * Create a path to a field definition
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @returns A field definition path
+ * @example createFieldDefinitionPath('User', 'name') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'name' }]
+ */
+export const createFieldDefinitionPath = (type, field) => {
+    return [createTypeSegment(type), createFieldSegment(field)];
+};
+/**
+ * Create a path to an argument definition
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @param argument - The argument name
+ * @returns An argument definition path
+ * @example createArgumentDefinitionPath('User', 'posts', 'limit') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'posts' }, { kind: 'argument', argument: 'limit' }]
+ */
+export const createArgumentDefinitionPath = (type, field, argument) => {
+    return [createTypeSegment(type), createFieldSegment(field), createArgumentSegment(argument)];
+};
+/**
+ * Create a type definition path
+ *
+ * @param type - The type name
+ * @returns A type definition path
+ * @example type('User') // [{ kind: 'type', type: 'User' }]
+ */
+export const type = createTypeDefinitionPath;
+/**
+ * Create a field definition path
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @returns A field definition path
+ * @example field('User', 'name') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'name' }]
+ */
+export const field = createFieldDefinitionPath;
+/**
+ * Create an argument definition path
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @param argument - The argument name
+ * @returns An argument definition path
+ * @example argument('User', 'posts', 'limit') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'posts' }, { kind: 'argument', argument: 'limit' }]
+ */
+export const argument = createArgumentDefinitionPath;
+//# sourceMappingURL=definition.js.map

package/build/lib/graphql-path/definition.js.map

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