clients added

Author: codeandwhisky

clients/GraphQLConsoleClient.cs

@@ -0,0 +1,66 @@
+// .NET Console GraphQL Client
+// Uses GraphQL.Client for queries, mutations, subscriptions
+// Add NuGet: GraphQL.Client, GraphQL.Client.Serializer.Newtonsoft
+
+using System;
+using System.Net.Http.Headers;
+using System.Threading.Tasks;
+using GraphQL;
+using GraphQL.Client.Http;
+using GraphQL.Client.Serializer.Newtonsoft;
+
+namespace GraphQLConsoleClient
+{
+    class Program
+    {
+        private const string HTTP_URL = "http://localhost:8000/graphql";
+        private const string WS_URL = "ws://localhost:8000/graphql-ws";
+        private const string AUTH_TOKEN = ""; // JWT placeholder
+
+        static async Task Main(string[] args)
+        {
+            var client = new GraphQLHttpClient(new GraphQLHttpClientOptions
+            {
+                EndPoint = new Uri(HTTP_URL),
+                UseWebSocketForQueriesAndMutations = false,
+                WebSocketEndPoint = new Uri(WS_URL)
+            }, new NewtonsoftJsonSerializer());
+
+            if (!string.IsNullOrEmpty(AUTH_TOKEN))
+            {
+                client.HttpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", AUTH_TOKEN);
+            }
+
+            // --- Query: Get All Posts ---
+            var query = new GraphQLRequest
+            {
+                Query = @"query GetPosts { posts { id title content author { name email } } }"
+            };
+            var queryResponse = await client.SendQueryAsync<dynamic>(query);
+            Console.WriteLine("Posts:");
+            Console.WriteLine(queryResponse.Data);
+
+            // --- Mutation: Create a New Post ---
+            var mutation = new GraphQLRequest
+            {
+                Query = @"mutation CreatePost($input: CreatePostInput!) { createPost(input: $input) { post { id title content } errors { message } } }",
+                Variables = new { input = new { title = "Hello World", content = "First post!" } }
+            };
+            var mutationResponse = await client.SendMutationAsync<dynamic>(mutation);
+            Console.WriteLine("Create Post Response:");
+            Console.WriteLine(mutationResponse.Data);
+
+            // --- Subscription: New Post Created ---
+            var subscription = new GraphQLRequest
+            {
+                Query = @"subscription OnPostCreated { onPostCreated { id title content author { name } } }"
+            };
+            using var sub = client.CreateSubscriptionStream<dynamic>(subscription);
+            await foreach (var response in sub)
+            {
+                Console.WriteLine("New post created:");
+                Console.WriteLine(response.Data);
+            }
+        }
+    }
+}

clients/README.md

@@ -0,0 +1,102 @@
+# GraphQL Client Integration Guide
+
+This directory contains ready-to-use GraphQL client programs for consuming the DotNet API Boilerplate GraphQL endpoint. Both frontend (TypeScript) and backend (.NET Core) clients are provided, supporting queries, mutations, and subscriptions.
+
+---
+
+## 1. TypeScript Client (Web/Mobile/Framework Agnostic)
+
+**File:** `graphql-client.ts`
+
+### Features
+- Connects to GraphQL endpoint via HTTP and WebSocket (`/graphql`, `/graphql-ws`)
+- Supports queries, mutations, and subscriptions
+- JWT authentication placeholder (add your token if needed)
+- Framework-agnostic, works with any TypeScript/JavaScript app
+
+### Setup
+1. Install dependencies:
+   ```sh
+   npm install graphql-ws
+   # or
+   yarn add graphql-ws
+   ```
+2. Copy `graphql-client.ts` into your project.
+3. Update endpoint URLs and authentication token as needed.
+
+### Usage Example
+```typescript
+import { subscribeNewBlog, getBlogs, createBlog } from './graphql-client';
+
+// Subscribe to new blog creation
+subscribeNewBlog();
+
+// Query all blogs
+getBlogs().then(console.log);
+
+// Create a new blog
+createBlog({ name: 'Tech Blog', description: 'A blog about tech', authorName: 'John Doe', tags: ['tech'] }).then(console.log);
+```
+
+---
+
+## 2. .NET Console Client (Backend/API Integration)
+
+**File:** `GraphQLConsoleClient.cs`
+
+### Features
+- Connects to GraphQL endpoint via HTTP and WebSocket (`/graphql`, `/graphql-ws`)
+- Supports queries, mutations, and subscriptions
+- JWT authentication placeholder (add your token if needed)
+- Console app, can be used as a service or starter for integration
+
+### Setup
+1. Create a new .NET console project:
+   ```sh
+   dotnet new console -n GraphQLConsoleClient
+   cd GraphQLConsoleClient
+   ```
+2. Add NuGet packages:
+   ```sh
+   dotnet add package GraphQL.Client
+   dotnet add package GraphQL.Client.Serializer.Newtonsoft
+   ```
+3. Copy `GraphQLConsoleClient.cs` into your project and replace `Program.cs`.
+4. Update endpoint URLs and authentication token as needed.
+
+### Usage Example
+Run the console app:
+```sh
+   dotnet run
+```
+- Prints queried posts
+- Prints mutation result for creating a post
+- Prints new post data as received via subscription
+
+---
+
+## Endpoints
+- **HTTP:** `http://localhost:8000/graphql`
+- **WebSocket:** `ws://localhost:8000/graphql-ws`
+
+## Authentication
+- No authentication required by default
+- Add JWT token to `AUTH_TOKEN` variable if needed
+
+## Supported Operations
+- **Queries:** Get blogs, get posts, etc.
+- **Mutations:** Create blog, create post, etc.
+- **Subscriptions:** On blog created, on post created, etc.
+
+## Customization
+- Update queries, mutations, and subscriptions as per your schema
+- Add error handling, logging, and UI integration as needed
+
+## Troubleshooting
+- Ensure the API server is running and accessible
+- Check endpoint URLs and ports
+- For subscriptions, ensure WebSocket support is enabled on the server
+
+---
+
+For further help, see the main project README or contact the API maintainer.

clients/graphql-client.ts

@@ -0,0 +1,121 @@
+// TypeScript GraphQL Client (framework agnostic)
+// Uses graphql-ws for subscriptions
+// Queries, Mutations, Subscriptions
+
+import { createClient } from 'graphql-ws';
+
+const WS_URL = 'ws://localhost:8000/graphql-ws';
+const HTTP_URL = 'http://localhost:8000/graphql';
+const AUTH_TOKEN = '';
+
+// Subscription: New Blog Created
+const SUBSCRIBE_NEW_BLOG = `
+  subscription OnBlogCreated {
+    onBlogCreated {
+      id
+      name
+      description
+      authorName
+      tags
+      createdAt
+    }
+  }
+`;
+
+// Query: Get All Blogs with Posts
+const QUERY_BLOGS = `
+  query GetBlogsWithPosts {
+    blogs {
+      id
+      name
+      description
+      posts {
+        id
+        title
+        content
+        author {
+          name
+          email
+        }
+        comments {
+          id
+          content
+          author
+        }
+      }
+    }
+  }
+`;
+
+// Mutation: Create a New Blog
+const MUTATION_CREATE_BLOG = `
+  mutation CreateBlog($input: CreateBlogInput!) {
+    createBlog(input: $input) {
+      blog {
+        id
+        name
+        description
+        authorName
+        tags
+        createdAt
+      }
+      errors {
+        message
+      }
+    }
+  }
+`;
+
+// --- Subscription Client ---
+export function subscribeNewBlog() {
+  const client = createClient({
+    url: WS_URL,
+    connectionParams: {
+      Authorization: AUTH_TOKEN ? `Bearer ${AUTH_TOKEN}` : undefined,
+    },
+  });
+
+  return client.subscribe(
+    {
+      query: SUBSCRIBE_NEW_BLOG,
+    },
+    {
+      next: (data) => console.log('New blog created:', data),
+      error: (err) => console.error('Subscription error:', err),
+      complete: () => console.log('Subscription complete'),
+    }
+  );
+}
+
+// --- Query Client ---
+export async function getBlogs() {
+  const res = await fetch(HTTP_URL, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      ...(AUTH_TOKEN && { Authorization: `Bearer ${AUTH_TOKEN}` }),
+    },
+    body: JSON.stringify({ query: QUERY_BLOGS }),
+  });
+  const json = await res.json();
+  return json.data;
+}
+
+// --- Mutation Client ---
+export async function createBlog(input: any) {
+  const res = await fetch(HTTP_URL, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      ...(AUTH_TOKEN && { Authorization: `Bearer ${AUTH_TOKEN}` }),
+    },
+    body: JSON.stringify({ query: MUTATION_CREATE_BLOG, variables: { input } }),
+  });
+  const json = await res.json();
+  return json.data;
+}
+
+// Usage Example
+// subscribeNewBlog();
+// getBlogs().then(console.log);
+// createBlog({ name: 'Tech Blog', description: 'A blog about tech', authorName: 'John Doe', tags: ['tech'] }).then(console.log);