@cosmneo/onion-lasagna 0.3.0 → 0.4.0

package/dist/graphql/field/index.d.cts

@@ -0,0 +1,214 @@
+import { SchemaAdapter, InferOutput } from '../../http/schema/types.cjs';
+import { b as GraphQLFieldDefinition, d as GraphQLSchemaConfig, e as GraphQLSchemaDefaults, f as GraphQLSchemaDefinition, D as DeepMergeSchemas, h as DeepMergeSchemasAll } from '../../schema-definition.type-C9PntBVc.cjs';
+export { F as FlattenSchema, g as GetField, a as GraphQLFieldDocumentation, G as GraphQLOperationType, c as GraphQLSchemaEntry, k as InferFieldContext, i as InferFieldInput, I as InferFieldOperation, j as InferFieldOutput, S as SchemaKeys, n as collectFields, l as isFieldDefinition, m as isSchemaDefinition } from '../../schema-definition.type-C9PntBVc.cjs';
+
+/**
+ * @fileoverview Factory functions for creating GraphQL field definitions.
+ *
+ * `defineQuery`, `defineMutation`, and `defineSubscription` are the main entry
+ * points for defining GraphQL fields. They mirror `defineRoute` /
+ * `defineEventHandler` from the HTTP and event layers.
+ *
+ * @module graphql/field/define-field
+ */
+
+/**
+ * Input for defineQuery / defineMutation.
+ *
+ * @example Query with input and output
+ * ```typescript
+ * defineQuery({
+ *   input: zodSchema(z.object({ userId: z.string() })),
+ *   output: zodSchema(userSchema),
+ *   docs: { description: 'Get a user by ID' },
+ * })
+ * ```
+ *
+ * @example Mutation with context
+ * ```typescript
+ * defineMutation({
+ *   input: zodSchema(z.object({ name: z.string() })),
+ *   output: zodSchema(z.object({ id: z.string() })),
+ *   context: zodSchema(executionContextSchema),
+ *   docs: { description: 'Create a project' },
+ * })
+ * ```
+ */
+interface DefineFieldInput<TInput extends SchemaAdapter | undefined = undefined, TOutput extends SchemaAdapter | undefined = undefined, TContext extends SchemaAdapter | undefined = undefined> {
+    /** Input arguments validation schema. */
+    readonly input?: TInput;
+    /** Output type validation schema. */
+    readonly output?: TOutput;
+    /** Context validation schema (e.g., JWT payload from middleware). */
+    readonly context?: TContext;
+    /** Field documentation. */
+    readonly docs?: {
+        readonly summary?: string;
+        readonly description?: string;
+        readonly tags?: readonly string[];
+        readonly deprecated?: boolean;
+        readonly deprecationReason?: string;
+    };
+}
+type ResolveInput<T> = T extends SchemaAdapter ? InferOutput<T> : undefined;
+type ResolveOutput<T> = T extends SchemaAdapter ? InferOutput<T> : undefined;
+type ResolveContext<T> = T extends SchemaAdapter ? InferOutput<T> : undefined;
+/**
+ * Creates a GraphQL query field definition.
+ *
+ * @param config - Field configuration with optional schemas
+ * @returns A frozen GraphQLFieldDefinition with operation 'query'
+ *
+ * @example
+ * ```typescript
+ * const getUser = defineQuery({
+ *   input: zodSchema(z.object({ userId: z.string() })),
+ *   output: zodSchema(userSchema),
+ *   docs: { description: 'Get a user by ID' },
+ * });
+ * ```
+ */
+declare function defineQuery<TInput extends SchemaAdapter | undefined = undefined, TOutput extends SchemaAdapter | undefined = undefined, TContext extends SchemaAdapter | undefined = undefined>(config?: DefineFieldInput<TInput, TOutput, TContext>): GraphQLFieldDefinition<'query', ResolveInput<TInput>, ResolveOutput<TOutput>, ResolveContext<TContext>>;
+/**
+ * Creates a GraphQL mutation field definition.
+ *
+ * @param config - Field configuration with optional schemas
+ * @returns A frozen GraphQLFieldDefinition with operation 'mutation'
+ *
+ * @example
+ * ```typescript
+ * const createProject = defineMutation({
+ *   input: zodSchema(z.object({ name: z.string() })),
+ *   output: zodSchema(z.object({ id: z.string() })),
+ *   context: zodSchema(executionContextSchema),
+ *   docs: { description: 'Create a new project' },
+ * });
+ * ```
+ */
+declare function defineMutation<TInput extends SchemaAdapter | undefined = undefined, TOutput extends SchemaAdapter | undefined = undefined, TContext extends SchemaAdapter | undefined = undefined>(config?: DefineFieldInput<TInput, TOutput, TContext>): GraphQLFieldDefinition<'mutation', ResolveInput<TInput>, ResolveOutput<TOutput>, ResolveContext<TContext>>;
+/**
+ * Creates a GraphQL subscription field definition.
+ *
+ * Subscription handlers return an `AsyncIterable` of values rather than
+ * a single response. The output schema validates each emitted value.
+ *
+ * @param config - Field configuration with optional schemas
+ * @returns A frozen GraphQLFieldDefinition with operation 'subscription'
+ *
+ * @example
+ * ```typescript
+ * const onTicketCreated = defineSubscription({
+ *   input: zodSchema(z.object({ projectId: z.string() })),
+ *   output: zodSchema(ticketSchema),
+ *   docs: { description: 'Subscribe to new tickets in a project' },
+ * });
+ * ```
+ */
+declare function defineSubscription<TInput extends SchemaAdapter | undefined = undefined, TOutput extends SchemaAdapter | undefined = undefined, TContext extends SchemaAdapter | undefined = undefined>(config?: DefineFieldInput<TInput, TOutput, TContext>): GraphQLFieldDefinition<'subscription', ResolveInput<TInput>, ResolveOutput<TOutput>, ResolveContext<TContext>>;
+
+/**
+ * @fileoverview Factory function for creating GraphQL schema definitions.
+ *
+ * The `defineGraphQLSchema` function groups fields into a hierarchical structure
+ * with optional schema-level defaults for context and tags.
+ *
+ * @module graphql/field/define-schema
+ */
+
+/**
+ * Options for schema definition.
+ */
+interface DefineGraphQLSchemaOptions {
+    /**
+     * Default values applied to all child fields.
+     *
+     * @example
+     * ```typescript
+     * defineGraphQLSchema({
+     *   getUser: getUserQuery,
+     *   createUser: createUserMutation,
+     * }, {
+     *   defaults: {
+     *     context: zodSchema(executionContextSchema),
+     *     tags: ['Users'],
+     *   },
+     * })
+     * ```
+     */
+    readonly defaults?: GraphQLSchemaDefaults;
+}
+/**
+ * Creates a GraphQL schema definition from a configuration object.
+ *
+ * A schema is a hierarchical grouping of fields that provides:
+ * - Organized API structure with nested namespaces
+ * - Type-safe resolver registration
+ * - Schema-level defaults for context and tags
+ *
+ * @param fields - Object containing fields and nested groups
+ * @param options - Optional schema configuration
+ * @returns A frozen GraphQLSchemaDefinition object
+ *
+ * @example Basic schema
+ * ```typescript
+ * const schema = defineGraphQLSchema({
+ *   users: {
+ *     get: getUserQuery,
+ *     list: listUsersQuery,
+ *     create: createUserMutation,
+ *   },
+ * });
+ * ```
+ *
+ * @example With defaults
+ * ```typescript
+ * const schema = defineGraphQLSchema({
+ *   get: getUserQuery,
+ *   list: listUsersQuery,
+ * }, {
+ *   defaults: {
+ *     context: zodSchema(executionContextSchema),
+ *     tags: ['Users'],
+ *   },
+ * });
+ * ```
+ */
+declare function defineGraphQLSchema<T extends GraphQLSchemaConfig>(fields: T, options?: DefineGraphQLSchemaOptions): GraphQLSchemaDefinition<T>;
+type SchemaInput<T extends GraphQLSchemaConfig> = T | GraphQLSchemaDefinition<T>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>): GraphQLSchemaDefinition<DeepMergeSchemas<T1, T2>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>): GraphQLSchemaDefinition<DeepMergeSchemasAll<[T1, T2, T3]>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>): GraphQLSchemaDefinition<DeepMergeSchemasAll<[T1, T2, T3, T4]>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>): GraphQLSchemaDefinition<DeepMergeSchemasAll<[T1, T2, T3, T4, T5]>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig, T6 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>, s6: SchemaInput<T6>): GraphQLSchemaDefinition<DeepMergeSchemasAll<[T1, T2, T3, T4, T5, T6]>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig, T6 extends GraphQLSchemaConfig, T7 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>, s6: SchemaInput<T6>, s7: SchemaInput<T7>): GraphQLSchemaDefinition<DeepMergeSchemasAll<[T1, T2, T3, T4, T5, T6, T7]>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig, T6 extends GraphQLSchemaConfig, T7 extends GraphQLSchemaConfig, T8 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>, s6: SchemaInput<T6>, s7: SchemaInput<T7>, s8: SchemaInput<T8>): GraphQLSchemaDefinition<DeepMergeSchemasAll<[T1, T2, T3, T4, T5, T6, T7, T8]>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig, T6 extends GraphQLSchemaConfig, T7 extends GraphQLSchemaConfig, T8 extends GraphQLSchemaConfig, T9 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>, s6: SchemaInput<T6>, s7: SchemaInput<T7>, s8: SchemaInput<T8>, s9: SchemaInput<T9>): GraphQLSchemaDefinition<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<T1, T2>, T3>, T4>, T5>, T6>, T7>, T8>, T9>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig, T6 extends GraphQLSchemaConfig, T7 extends GraphQLSchemaConfig, T8 extends GraphQLSchemaConfig, T9 extends GraphQLSchemaConfig, T10 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>, s6: SchemaInput<T6>, s7: SchemaInput<T7>, s8: SchemaInput<T8>, s9: SchemaInput<T9>, s10: SchemaInput<T10>): GraphQLSchemaDefinition<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<T1, T2>, T3>, T4>, T5>, T6>, T7>, T8>, T9>, T10>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig, T6 extends GraphQLSchemaConfig, T7 extends GraphQLSchemaConfig, T8 extends GraphQLSchemaConfig, T9 extends GraphQLSchemaConfig, T10 extends GraphQLSchemaConfig, T11 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>, s6: SchemaInput<T6>, s7: SchemaInput<T7>, s8: SchemaInput<T8>, s9: SchemaInput<T9>, s10: SchemaInput<T10>, s11: SchemaInput<T11>): GraphQLSchemaDefinition<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<T1, T2>, T3>, T4>, T5>, T6>, T7>, T8>, T9>, T10>, T11>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig, T6 extends GraphQLSchemaConfig, T7 extends GraphQLSchemaConfig, T8 extends GraphQLSchemaConfig, T9 extends GraphQLSchemaConfig, T10 extends GraphQLSchemaConfig, T11 extends GraphQLSchemaConfig, T12 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>, s6: SchemaInput<T6>, s7: SchemaInput<T7>, s8: SchemaInput<T8>, s9: SchemaInput<T9>, s10: SchemaInput<T10>, s11: SchemaInput<T11>, s12: SchemaInput<T12>): GraphQLSchemaDefinition<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<T1, T2>, T3>, T4>, T5>, T6>, T7>, T8>, T9>, T10>, T11>, T12>>;
+declare function mergeGraphQLSchemas(...schemas: SchemaInput<GraphQLSchemaConfig>[]): GraphQLSchemaDefinition<GraphQLSchemaConfig>;
+
+/**
+ * @fileoverview GraphQL field utility functions.
+ *
+ * @module graphql/field/utils
+ */
+/**
+ * Generates a field ID from a schema key path.
+ *
+ * This is the **single source of truth** for the naming convention used across:
+ * - SDL generation (`type Query { usersGet(...) }`)
+ * - Yoga resolver map keys
+ * - Client query string field names
+ *
+ * Converts dotted key paths to camelCase:
+ * - `"users.get"` → `"usersGet"`
+ * - `"projects.members.list"` → `"projectsMembersList"`
+ * - `"getUser"` → `"getUser"` (single segment unchanged)
+ *
+ * @param key - The dotted schema key path
+ * @returns A camelCase field ID string
+ */
+declare function generateFieldId(key: string): string;
+
+export { DeepMergeSchemas, DeepMergeSchemasAll, type DefineGraphQLSchemaOptions, GraphQLFieldDefinition, GraphQLSchemaConfig, GraphQLSchemaDefaults, GraphQLSchemaDefinition, defineGraphQLSchema, defineMutation, defineQuery, defineSubscription, generateFieldId, mergeGraphQLSchemas };

package/dist/graphql/field/index.d.ts

@@ -0,0 +1,214 @@
+import { SchemaAdapter, InferOutput } from '../../http/schema/types.js';
+import { b as GraphQLFieldDefinition, d as GraphQLSchemaConfig, e as GraphQLSchemaDefaults, f as GraphQLSchemaDefinition, D as DeepMergeSchemas, h as DeepMergeSchemasAll } from '../../schema-definition.type-CuhQLDr0.js';
+export { F as FlattenSchema, g as GetField, a as GraphQLFieldDocumentation, G as GraphQLOperationType, c as GraphQLSchemaEntry, k as InferFieldContext, i as InferFieldInput, I as InferFieldOperation, j as InferFieldOutput, S as SchemaKeys, n as collectFields, l as isFieldDefinition, m as isSchemaDefinition } from '../../schema-definition.type-CuhQLDr0.js';
+
+/**
+ * @fileoverview Factory functions for creating GraphQL field definitions.
+ *
+ * `defineQuery`, `defineMutation`, and `defineSubscription` are the main entry
+ * points for defining GraphQL fields. They mirror `defineRoute` /
+ * `defineEventHandler` from the HTTP and event layers.
+ *
+ * @module graphql/field/define-field
+ */
+
+/**
+ * Input for defineQuery / defineMutation.
+ *
+ * @example Query with input and output
+ * ```typescript
+ * defineQuery({
+ *   input: zodSchema(z.object({ userId: z.string() })),
+ *   output: zodSchema(userSchema),
+ *   docs: { description: 'Get a user by ID' },
+ * })
+ * ```
+ *
+ * @example Mutation with context
+ * ```typescript
+ * defineMutation({
+ *   input: zodSchema(z.object({ name: z.string() })),
+ *   output: zodSchema(z.object({ id: z.string() })),
+ *   context: zodSchema(executionContextSchema),
+ *   docs: { description: 'Create a project' },
+ * })
+ * ```
+ */
+interface DefineFieldInput<TInput extends SchemaAdapter | undefined = undefined, TOutput extends SchemaAdapter | undefined = undefined, TContext extends SchemaAdapter | undefined = undefined> {
+    /** Input arguments validation schema. */
+    readonly input?: TInput;
+    /** Output type validation schema. */
+    readonly output?: TOutput;
+    /** Context validation schema (e.g., JWT payload from middleware). */
+    readonly context?: TContext;
+    /** Field documentation. */
+    readonly docs?: {
+        readonly summary?: string;
+        readonly description?: string;
+        readonly tags?: readonly string[];
+        readonly deprecated?: boolean;
+        readonly deprecationReason?: string;
+    };
+}
+type ResolveInput<T> = T extends SchemaAdapter ? InferOutput<T> : undefined;
+type ResolveOutput<T> = T extends SchemaAdapter ? InferOutput<T> : undefined;
+type ResolveContext<T> = T extends SchemaAdapter ? InferOutput<T> : undefined;
+/**
+ * Creates a GraphQL query field definition.
+ *
+ * @param config - Field configuration with optional schemas
+ * @returns A frozen GraphQLFieldDefinition with operation 'query'
+ *
+ * @example
+ * ```typescript
+ * const getUser = defineQuery({
+ *   input: zodSchema(z.object({ userId: z.string() })),
+ *   output: zodSchema(userSchema),
+ *   docs: { description: 'Get a user by ID' },
+ * });
+ * ```
+ */
+declare function defineQuery<TInput extends SchemaAdapter | undefined = undefined, TOutput extends SchemaAdapter | undefined = undefined, TContext extends SchemaAdapter | undefined = undefined>(config?: DefineFieldInput<TInput, TOutput, TContext>): GraphQLFieldDefinition<'query', ResolveInput<TInput>, ResolveOutput<TOutput>, ResolveContext<TContext>>;
+/**
+ * Creates a GraphQL mutation field definition.
+ *
+ * @param config - Field configuration with optional schemas
+ * @returns A frozen GraphQLFieldDefinition with operation 'mutation'
+ *
+ * @example
+ * ```typescript
+ * const createProject = defineMutation({
+ *   input: zodSchema(z.object({ name: z.string() })),
+ *   output: zodSchema(z.object({ id: z.string() })),
+ *   context: zodSchema(executionContextSchema),
+ *   docs: { description: 'Create a new project' },
+ * });
+ * ```
+ */
+declare function defineMutation<TInput extends SchemaAdapter | undefined = undefined, TOutput extends SchemaAdapter | undefined = undefined, TContext extends SchemaAdapter | undefined = undefined>(config?: DefineFieldInput<TInput, TOutput, TContext>): GraphQLFieldDefinition<'mutation', ResolveInput<TInput>, ResolveOutput<TOutput>, ResolveContext<TContext>>;
+/**
+ * Creates a GraphQL subscription field definition.
+ *
+ * Subscription handlers return an `AsyncIterable` of values rather than
+ * a single response. The output schema validates each emitted value.
+ *
+ * @param config - Field configuration with optional schemas
+ * @returns A frozen GraphQLFieldDefinition with operation 'subscription'
+ *
+ * @example
+ * ```typescript
+ * const onTicketCreated = defineSubscription({
+ *   input: zodSchema(z.object({ projectId: z.string() })),
+ *   output: zodSchema(ticketSchema),
+ *   docs: { description: 'Subscribe to new tickets in a project' },
+ * });
+ * ```
+ */
+declare function defineSubscription<TInput extends SchemaAdapter | undefined = undefined, TOutput extends SchemaAdapter | undefined = undefined, TContext extends SchemaAdapter | undefined = undefined>(config?: DefineFieldInput<TInput, TOutput, TContext>): GraphQLFieldDefinition<'subscription', ResolveInput<TInput>, ResolveOutput<TOutput>, ResolveContext<TContext>>;
+
+/**
+ * @fileoverview Factory function for creating GraphQL schema definitions.
+ *
+ * The `defineGraphQLSchema` function groups fields into a hierarchical structure
+ * with optional schema-level defaults for context and tags.
+ *
+ * @module graphql/field/define-schema
+ */
+
+/**
+ * Options for schema definition.
+ */
+interface DefineGraphQLSchemaOptions {
+    /**
+     * Default values applied to all child fields.
+     *
+     * @example
+     * ```typescript
+     * defineGraphQLSchema({
+     *   getUser: getUserQuery,
+     *   createUser: createUserMutation,
+     * }, {
+     *   defaults: {
+     *     context: zodSchema(executionContextSchema),
+     *     tags: ['Users'],
+     *   },
+     * })
+     * ```
+     */
+    readonly defaults?: GraphQLSchemaDefaults;
+}
+/**
+ * Creates a GraphQL schema definition from a configuration object.
+ *
+ * A schema is a hierarchical grouping of fields that provides:
+ * - Organized API structure with nested namespaces
+ * - Type-safe resolver registration
+ * - Schema-level defaults for context and tags
+ *
+ * @param fields - Object containing fields and nested groups
+ * @param options - Optional schema configuration
+ * @returns A frozen GraphQLSchemaDefinition object
+ *
+ * @example Basic schema
+ * ```typescript
+ * const schema = defineGraphQLSchema({
+ *   users: {
+ *     get: getUserQuery,
+ *     list: listUsersQuery,
+ *     create: createUserMutation,
+ *   },
+ * });
+ * ```
+ *
+ * @example With defaults
+ * ```typescript
+ * const schema = defineGraphQLSchema({
+ *   get: getUserQuery,
+ *   list: listUsersQuery,
+ * }, {
+ *   defaults: {
+ *     context: zodSchema(executionContextSchema),
+ *     tags: ['Users'],
+ *   },
+ * });
+ * ```
+ */
+declare function defineGraphQLSchema<T extends GraphQLSchemaConfig>(fields: T, options?: DefineGraphQLSchemaOptions): GraphQLSchemaDefinition<T>;
+type SchemaInput<T extends GraphQLSchemaConfig> = T | GraphQLSchemaDefinition<T>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>): GraphQLSchemaDefinition<DeepMergeSchemas<T1, T2>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>): GraphQLSchemaDefinition<DeepMergeSchemasAll<[T1, T2, T3]>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>): GraphQLSchemaDefinition<DeepMergeSchemasAll<[T1, T2, T3, T4]>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>): GraphQLSchemaDefinition<DeepMergeSchemasAll<[T1, T2, T3, T4, T5]>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig, T6 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>, s6: SchemaInput<T6>): GraphQLSchemaDefinition<DeepMergeSchemasAll<[T1, T2, T3, T4, T5, T6]>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig, T6 extends GraphQLSchemaConfig, T7 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>, s6: SchemaInput<T6>, s7: SchemaInput<T7>): GraphQLSchemaDefinition<DeepMergeSchemasAll<[T1, T2, T3, T4, T5, T6, T7]>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig, T6 extends GraphQLSchemaConfig, T7 extends GraphQLSchemaConfig, T8 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>, s6: SchemaInput<T6>, s7: SchemaInput<T7>, s8: SchemaInput<T8>): GraphQLSchemaDefinition<DeepMergeSchemasAll<[T1, T2, T3, T4, T5, T6, T7, T8]>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig, T6 extends GraphQLSchemaConfig, T7 extends GraphQLSchemaConfig, T8 extends GraphQLSchemaConfig, T9 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>, s6: SchemaInput<T6>, s7: SchemaInput<T7>, s8: SchemaInput<T8>, s9: SchemaInput<T9>): GraphQLSchemaDefinition<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<T1, T2>, T3>, T4>, T5>, T6>, T7>, T8>, T9>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig, T6 extends GraphQLSchemaConfig, T7 extends GraphQLSchemaConfig, T8 extends GraphQLSchemaConfig, T9 extends GraphQLSchemaConfig, T10 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>, s6: SchemaInput<T6>, s7: SchemaInput<T7>, s8: SchemaInput<T8>, s9: SchemaInput<T9>, s10: SchemaInput<T10>): GraphQLSchemaDefinition<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<T1, T2>, T3>, T4>, T5>, T6>, T7>, T8>, T9>, T10>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig, T6 extends GraphQLSchemaConfig, T7 extends GraphQLSchemaConfig, T8 extends GraphQLSchemaConfig, T9 extends GraphQLSchemaConfig, T10 extends GraphQLSchemaConfig, T11 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>, s6: SchemaInput<T6>, s7: SchemaInput<T7>, s8: SchemaInput<T8>, s9: SchemaInput<T9>, s10: SchemaInput<T10>, s11: SchemaInput<T11>): GraphQLSchemaDefinition<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<T1, T2>, T3>, T4>, T5>, T6>, T7>, T8>, T9>, T10>, T11>>;
+declare function mergeGraphQLSchemas<T1 extends GraphQLSchemaConfig, T2 extends GraphQLSchemaConfig, T3 extends GraphQLSchemaConfig, T4 extends GraphQLSchemaConfig, T5 extends GraphQLSchemaConfig, T6 extends GraphQLSchemaConfig, T7 extends GraphQLSchemaConfig, T8 extends GraphQLSchemaConfig, T9 extends GraphQLSchemaConfig, T10 extends GraphQLSchemaConfig, T11 extends GraphQLSchemaConfig, T12 extends GraphQLSchemaConfig>(s1: SchemaInput<T1>, s2: SchemaInput<T2>, s3: SchemaInput<T3>, s4: SchemaInput<T4>, s5: SchemaInput<T5>, s6: SchemaInput<T6>, s7: SchemaInput<T7>, s8: SchemaInput<T8>, s9: SchemaInput<T9>, s10: SchemaInput<T10>, s11: SchemaInput<T11>, s12: SchemaInput<T12>): GraphQLSchemaDefinition<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<DeepMergeSchemas<T1, T2>, T3>, T4>, T5>, T6>, T7>, T8>, T9>, T10>, T11>, T12>>;
+declare function mergeGraphQLSchemas(...schemas: SchemaInput<GraphQLSchemaConfig>[]): GraphQLSchemaDefinition<GraphQLSchemaConfig>;
+
+/**
+ * @fileoverview GraphQL field utility functions.
+ *
+ * @module graphql/field/utils
+ */
+/**
+ * Generates a field ID from a schema key path.
+ *
+ * This is the **single source of truth** for the naming convention used across:
+ * - SDL generation (`type Query { usersGet(...) }`)
+ * - Yoga resolver map keys
+ * - Client query string field names
+ *
+ * Converts dotted key paths to camelCase:
+ * - `"users.get"` → `"usersGet"`
+ * - `"projects.members.list"` → `"projectsMembersList"`
+ * - `"getUser"` → `"getUser"` (single segment unchanged)
+ *
+ * @param key - The dotted schema key path
+ * @returns A camelCase field ID string
+ */
+declare function generateFieldId(key: string): string;
+
+export { DeepMergeSchemas, DeepMergeSchemasAll, type DefineGraphQLSchemaOptions, GraphQLFieldDefinition, GraphQLSchemaConfig, GraphQLSchemaDefaults, GraphQLSchemaDefinition, defineGraphQLSchema, defineMutation, defineQuery, defineSubscription, generateFieldId, mergeGraphQLSchemas };

package/dist/graphql/field/index.js

@@ -0,0 +1,25 @@
+import {
+  defineGraphQLSchema,
+  defineMutation,
+  defineQuery,
+  defineSubscription,
+  mergeGraphQLSchemas
+} from "../../chunk-TZRBETT3.js";
+import {
+  collectFields,
+  generateFieldId,
+  isFieldDefinition,
+  isSchemaDefinition
+} from "../../chunk-BG2FY27M.js";
+export {
+  collectFields,
+  defineGraphQLSchema,
+  defineMutation,
+  defineQuery,
+  defineSubscription,
+  generateFieldId,
+  isFieldDefinition,
+  isSchemaDefinition,
+  mergeGraphQLSchemas
+};
+//# sourceMappingURL=index.js.map

package/dist/graphql/field/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}