@fougere/adapter-graphql 0.2.0-alpha.2

package/dist/pothos.d.ts

@@ -0,0 +1,177 @@
+/**
+ * @fougere/adapter-graphql — génère des types Pothos depuis les entités fougere
+ */
+import type SchemaBuilder from '@pothos/core';
+import type { SchemaView, SchemaSource } from '@fougere/schema';
+type EntityClass = SchemaView & (abstract new (...args: any[]) => any);
+/** Presenter instance — each method is a computed field resolver. */
+type PresenterInstance = Record<string, (parent: any) => any>;
+export interface TypeConfig {
+    /** Nom du type GraphQL */
+    name: string;
+    /** Entity source */
+    /** The schema whose fields become the type — a live class, or a card that travelled. */
+    entity: SchemaSource;
+    /** Champs à exclure du type GraphQL */
+    exclude?: string[];
+    /** Relations à résoudre */
+    relations?: Record<string, RelationConfig>;
+    /** Presenter instance — adds computed fields as resolveFields on this type. */
+    presenter?: PresenterInstance;
+    /** Presenter field names (methods to expose). If absent, all methods are exposed. */
+    presenterFields?: string[];
+    /** Per-field type metadata from source parsing. */
+    presenterFieldMeta?: {
+        name: string;
+        returnType?: string;
+        list?: boolean;
+        nullable?: boolean;
+    }[];
+    /**
+     * The view a computed field emits, when the presenter declared one — the object type
+     * to build for it. Without a declaration the scan reads a scalar or nothing, and an
+     * object-valued field can only be serialized.
+     */
+    presenterViews?: Record<string, EntityClass | [EntityClass]>;
+    /** Builds (or reuses) the GraphQL object type for a declared view. */
+    viewType?: (view: EntityClass, fieldName: string) => any;
+}
+export interface RelationConfig {
+    /** Type GraphQL cible (retourné par registerType) */
+    type: any;
+    /** Est-ce une liste ? */
+    list?: boolean;
+    /** Résolveur personnalisé */
+    resolve: (parent: any) => any;
+}
+export interface InputConfig {
+    /** Nom de l'input GraphQL */
+    name: string;
+    /** SchemaView source (résultat de pick/omit/partial) */
+    schema: SchemaView;
+}
+/** Parsed method signature (mirrors core OperationMeta.signature). */
+interface ParsedSignature {
+    name: string;
+    params: {
+        name: string;
+        type: {
+            raw: string;
+            name: string;
+            array?: boolean;
+            nullable?: boolean;
+            generics?: ParsedSignature['params'][0]['type'][];
+        };
+        optional?: boolean;
+    }[];
+    returnType?: {
+        raw: string;
+        name: string;
+        array?: boolean;
+        nullable?: boolean;
+        generics?: ParsedSignature['params'][0]['type'][];
+    };
+}
+/** Metadata for a handler operation (from scanner). */
+interface OperationMeta {
+    input?: SchemaView;
+    output?: SchemaView;
+    signature?: ParsedSignature;
+    /**
+     * The operation in words. It reaches here already — `handler.operations` is core's
+     * `Map<string, OperationContract>`, and this narrowed view simply did not name the
+     * field, so an explorer showed every field undocumented while the sentence sat one
+     * property away.
+     */
+    description?: string;
+}
+export interface OperationsConfig {
+    /** Entity name (PascalCase). */
+    name: string;
+    /** GraphQL entity type ref (from registerType). */
+    type: any;
+    /** Handler facade — each op receives InvocationContext. */
+    facade: Record<string, Function>;
+    /** Operations metadata from scanner (signature + resolved schemas). */
+    operations: Map<string, OperationMeta>;
+    /** Per-op kind overrides from frond.config.ts (optional). */
+    operationsOverrides?: Record<string, {
+        kind?: 'query' | 'command';
+    }>;
+    /**
+     * The GraphQL type for a schema an operation declares as its return. The caller owns
+     * this because it alone knows whether the schema IS the entity's (then: the type
+     * already registered) or something else (then: a new named type).
+     */
+    viewType?: (view: SchemaView, opName: string) => any;
+}
+type ScalarName = 'string' | 'int' | 'float' | 'boolean';
+/** Declarative field definition for registerObjectType. */
+export interface ObjectFieldDef {
+    /** Scalar name ('string', 'int', 'float', 'boolean') or Pothos type ref. Use [ref] for lists. */
+    type: ScalarName | any;
+    nullable?: boolean;
+    /** Custom resolver. Defaults to `(parent) => parent[fieldName]`. */
+    resolve?: (parent: any) => any;
+}
+/**
+ * Register a GraphQL object type from a declarative field map.
+ *
+ * Each field auto-resolves from `parent[key]` unless a custom `resolve` is provided.
+ * Works for wrapper types, result types, or any structural type.
+ *
+ * ```ts
+ * const PostList = registerObjectType(builder, 'PostList', {
+ *   items:     { type: [PostType] },
+ *   total:     { type: 'int', nullable: true, resolve: async (p) => lazyCount(p) },
+ *   hasMore:   { type: 'boolean', nullable: true },
+ *   endCursor: { type: 'string', nullable: true },
+ * });
+ * ```
+ */
+export declare function registerObjectType(builder: InstanceType<typeof SchemaBuilder>, name: string, fieldDefs: Record<string, ObjectFieldDef>): any;
+/**
+ * Enregistre un type GraphQL (lecture) depuis une entité fougere.
+ *
+ * ```ts
+ * const ProductType = registerType(builder, {
+ *   name: 'Product',
+ *   entity: Product,
+ *   exclude: ['categoryId'],
+ *   relations: {
+ *     category: {
+ *       type: CategoryType,
+ *       resolve: (parent) => db.select()...
+ *     },
+ *   },
+ * });
+ * ```
+ */
+export declare function registerType(builder: InstanceType<typeof SchemaBuilder>, config: TypeConfig): any;
+/**
+ * Enregistre un input GraphQL (écriture) depuis un SchemaView.
+ *
+ * ```ts
+ * const CreateProductInput = registerInput(builder, {
+ *   name: 'CreateProductInput',
+ *   schema: CreateProduct,
+ * });
+ * ```
+ */
+export declare function registerInput(builder: InstanceType<typeof SchemaBuilder>, config: InputConfig): any;
+/**
+ * Register all GraphQL operations for an entity from parsed handler signatures.
+ *
+ * Each operation in the map is registered as a Query or Mutation field
+ * based on naming convention (list*, find*, get*, search* → Query, else → Mutation).
+ *
+ * Args are generated from the parsed method signature:
+ * - Primitives (string, number) → scalar args
+ * - Entity/object params → input types (derived from meta.input)
+ * - Partial<T> wrapper → all input fields nullable
+ * - ListOptions → standard pagination args
+ * - InvocationContext → skipped (injected by resolver)
+ */
+export declare function registerOperations(builder: InstanceType<typeof SchemaBuilder>, config: OperationsConfig): void;
+export {};
+//# sourceMappingURL=pothos.d.ts.map

package/dist/pothos.d.ts.map

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