@gqlkit-ts/cli 0.2.0 → 0.4.0

package/README.md

@@ -0,0 +1,143 @@
+<div align="center">
+  
+# gqlkit
+
+**Just types and functions** — write TypeScript, generate GraphQL.
+
+[![gqlkit Documents](https://img.shields.io/badge/docs-gqlkit.izumin.dev-blue?logo=nextra&labelColor=%23313244&color=%23f5c2e7)](https://gqlkit.izumin.dev)
+[![NPM Version](https://img.shields.io/npm/v/%40gqlkit-ts%2Fcli?logo=npm&labelColor=%23313244&color=%23CB3837)](https://www.npmjs.com/package/@gqlkit-ts/cli)
+[![License](https://img.shields.io/github/license/izumin5210/gqlkit?labelColor=%23313244&color=%23a6e3a1)](./LICENSE)
+
+</div>
+
+## How it works
+
+1. Write TypeScript types in `src/gqlkit/schema/` → become GraphQL types
+2. Write resolver functions using `defineQuery`, `defineMutation`, `defineField` → become GraphQL resolvers
+3. Run `gqlkit gen` → outputs `typeDefs` and `resolvers` to `src/gqlkit/__generated__/`
+
+## Highlights
+
+- **Implement first** - Write types and resolvers, generate schema when ready. No edit-regenerate-implement loops.
+- **Just types and functions** - Plain TypeScript with a thin API. No complex generics, no decorators.
+- **Type-safe** - TypeScript types become GraphQL types. Resolver signatures checked at compile time.
+
+## Getting started
+
+### 1. Install dependencies
+
+```bash
+# Runtime dependencies
+npm install @gqlkit-ts/runtime graphql @graphql-tools/schema
+
+# Development dependency
+npm install -D @gqlkit-ts/cli
+```
+
+### 2. Create types and resolvers
+
+```ts
+// src/gqlkit/gqlkit.ts
+import { createGqlkitApis } from "@gqlkit-ts/runtime";
+import { Context } from "./context.js";
+
+export const { defineField, defineQuery, defineMutation } = createGqlkitApis<Context>();
+```
+
+```ts
+// src/gqlkit/schema/task.ts
+import type { IDString, NoArgs } from "@gqlkit-ts/runtime";
+import { defineQuery, defineMutation } from "../gqlkit.js";
+
+export type Task = {
+  id: IDString;
+  title: string;
+  completed: boolean;
+};
+
+const tasksData: Task[] = [];
+
+// Query
+export const tasks = defineQuery<NoArgs, Task[]>(() => tasksData);
+
+// Mutation
+export const createTask = defineMutation<{ input: { title: string } }, Task>(
+  (_root, { input }) => {
+    const task: Task = {
+      id: crypto.randomUUID(),
+      title: input.title,
+      completed: false,
+    };
+    tasksData.push(task);
+    return task;
+  }
+);
+```
+
+### 3. Generate schema and resolvers
+
+```bash
+gqlkit gen
+```
+
+This generates:
+- `src/gqlkit/__generated__/typeDefs.ts` - GraphQL schema AST
+- `src/gqlkit/__generated__/resolvers.ts` - Resolver map
+- `src/gqlkit/__generated__/schema.graphql` - SDL file
+
+### 4. Create the executable schema
+
+```ts
+// src/schema.ts
+import { makeExecutableSchema } from "@graphql-tools/schema";
+import { typeDefs } from "./gqlkit/__generated__/typeDefs.js";
+import { resolvers } from "./gqlkit/__generated__/resolvers.js";
+
+export const schema = makeExecutableSchema({ typeDefs, resolvers });
+```
+
+### 5. Start a GraphQL server (e.g., Yoga)
+
+```bash
+npm install graphql-yoga
+```
+
+```ts
+// src/server.ts
+import { createServer } from "node:http";
+import { createYoga } from "graphql-yoga";
+import { schema } from "./schema.js";
+
+const yoga = createYoga({ schema });
+const server = createServer(yoga);
+
+server.listen(4000, () => {
+  console.log("Server running at http://localhost:4000/graphql");
+});
+```
+
+Run the server and open http://localhost:4000/graphql to access GraphiQL:
+
+```graphql
+mutation {
+  createTask(input: { title: "Learn gqlkit" }) {
+    id
+    title
+    completed
+  }
+}
+
+query {
+  tasks {
+    id
+    title
+    completed
+  }
+}
+```
+
+## Documentation
+
+For detailed usage, features, and API reference, visit the documentation site:
+
+**[https://gqlkit.izumin.dev](https://gqlkit.izumin.dev)**

package/dist/auto-type-generator/auto-type-generator.d.ts

@@ -2,13 +2,14 @@ import type { ExtractResolversResult } from "../resolver-extractor/index.js";
 import type { DirectiveArgumentValue, DirectiveInfo } from "../shared/directive-detector.js";
 import type { DeprecationInfo } from "../shared/tsdoc-parser.js";
 import { type Diagnostic, type ExtractedTypeInfo, type GraphQLFieldType, type SourceLocation } from "../type-extractor/types/index.js";
+import type { ResolveTypeFieldPattern } from "./resolve-type-generator.js";
 /**
  * Information about where an auto-generated type was generated from.
  */
 export interface GeneratedFromInfo {
     readonly parentTypeName: string | null;
     readonly fieldPath: ReadonlyArray<string>;
-    readonly context: "typeField" | "inputField" | "resolverArg";
+    readonly context: "typeField" | "inputField" | "resolverArg" | "resolverPayload";
 }
 /**
  * Field information for auto-generated types.
@@ -37,20 +38,25 @@ export interface AutoGeneratedEnumValue {
  */
 export interface AutoGeneratedType {
     readonly name: string;
-    readonly kind: "Object" | "InputObject" | "Enum";
-    /** Fields for Object/InputObject kinds (null for Enum) */
+    readonly kind: "Object" | "InputObject" | "Enum" | "Union" | "OneOfInputObject";
+    /** Fields for Object/InputObject/OneOfInputObject kinds (null for Enum/Union) */
     readonly fields: ReadonlyArray<AutoGeneratedField> | null;
-    /** Enum values for Enum kind (null for Object/InputObject) */
+    /** Enum values for Enum kind (null for Object/InputObject/Union/OneOfInputObject) */
     readonly enumValues: ReadonlyArray<AutoGeneratedEnumValue> | null;
+    /** Union members for Union kind (null for Object/InputObject/Enum/OneOfInputObject) */
+    readonly unionMembers: ReadonlyArray<string> | null;
     /** True if enum needs value mapping (at least one value converted) */
     readonly needsStringEnumMapping: boolean;
     readonly sourceLocation: SourceLocation;
     readonly generatedFrom: GeneratedFromInfo;
     readonly description: string | null;
+    /** For Union types from resolverPayload context: the field pattern for resolveType */
+    readonly resolveTypeFieldPattern: ResolveTypeFieldPattern | null;
 }
 export interface AutoTypeGeneratorInput {
     readonly extractedTypes: ReadonlyArray<ExtractedTypeInfo>;
     readonly resolversResult: ExtractResolversResult;
+    readonly knownTypeNames: ReadonlySet<string>;
 }
 export interface AutoTypeGeneratorResult {
     readonly autoGeneratedTypes: ReadonlyArray<AutoGeneratedType>;

package/dist/auto-type-generator/auto-type-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-type-generator.d.ts","sourceRoot":"","sources":["../../src/auto-type-generator/auto-type-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,sBAAsB,EACtB,aAAa,EACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAMjE,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,iBAAiB,EAEtB,KAAK,gBAAgB,EAGrB,KAAK,cAAc,EACpB,MAAM,kCAAkC,CAAC;AAY1C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,GAAG,aAAa,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IACzD,QAAQ,CAAC,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,MAAM,CAAC;IACjD,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;IAC1D,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC;IAClE,sEAAsE;IACtE,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC1D,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;CAClD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,kBAAkB,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC9D,QAAQ,CAAC,qBAAqB,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACjE,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;IACxD,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACjD;AAovBD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,sBAAsB,GAC5B,uBAAuB,CAsEzB"}
+{"version":3,"file":"auto-type-generator.d.ts","sourceRoot":"","sources":["../../src/auto-type-generator/auto-type-generator.ts"],"names":[],"mappings":"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"}