@happyvertical/graphql 0.74.8

package/AGENT.md

@@ -0,0 +1,33 @@
+# @happyvertical/graphql
+
+<!-- BEGIN AGENT:GENERATED -->
+## Purpose
+GitHub GraphQL client for SDK packages
+
+## Package Map
+- Package: `@happyvertical/graphql`
+- Hierarchy path: `@happyvertical/sdk > packages > graphql`
+- Workspace position: `14 of 30` local packages
+- Internal dependencies: none
+- Internal dependents: `@happyvertical/projects`, `@happyvertical/repos`
+- Knowledge graph files: `AGENT.md`, `metadata.json`, `ecosystem-manifest.json`
+
+## Build & Test
+```bash
+pnpm --filter @happyvertical/graphql build
+pnpm --filter @happyvertical/graphql test
+pnpm --filter @happyvertical/graphql clean
+```
+
+## Agent Correction Loops
+- If Vite or TypeScript reports missing packages, run `pnpm install` at the repo root and rerun `pnpm --filter @happyvertical/graphql build`.
+- If tests or exports fail after API, type, or bundle changes, run `pnpm --filter @happyvertical/graphql clean` followed by `pnpm --filter @happyvertical/graphql build` and `pnpm --filter @happyvertical/graphql test`.
+- If failures span multiple packages or Turborepo ordering looks wrong, run `pnpm build` and `pnpm typecheck` from the repo root before retrying package-scoped commands.
+
+## Ecosystem Relationships
+- Provides: GitHub GraphQL client for SDK packages
+- Implements: none
+- Requires: none
+- Stability: stable (Primary package surface is described as implemented and production-oriented.)
+<!-- END AGENT:GENERATED -->
+

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright <2025> <Happy Vertical Corporation>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/claude-context.d.ts

@@ -0,0 +1 @@
+export { }

package/dist/cli/claude-context.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=claude-context.d.ts.map

package/dist/cli/claude-context.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, copyFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const Dirname = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = join(Dirname, "../..");
+const targetDir = join(process.cwd(), ".claude");
+if (!existsSync(targetDir)) {
+  mkdirSync(targetDir, { recursive: true });
+}
+const pkgName = "graphql";
+const agentMdSrc = existsSync(join(pkgRoot, "AGENT.md")) ? join(pkgRoot, "AGENT.md") : join(pkgRoot, "CLAUDE.md");
+const metaSrc = existsSync(join(pkgRoot, "metadata.json")) ? join(pkgRoot, "metadata.json") : join(pkgRoot, ".claude-meta.json");
+if (existsSync(agentMdSrc)) {
+  copyFileSync(agentMdSrc, join(targetDir, `have-${pkgName}.md`));
+}
+if (existsSync(metaSrc)) {
+  copyFileSync(metaSrc, join(targetDir, `have-${pkgName}.meta.json`));
+}
+console.log(`✓ Installed @happyvertical/${pkgName} context to .claude/`);
+//# sourceMappingURL=claude-context.js.map

package/dist/cli/claude-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-context.js","sources":["../../src/cli/claude-context.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CLI script to install agent context for @happyvertical/graphql\n * Run the published context installer binary for this package.\n */\nimport { copyFileSync, existsSync, mkdirSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst Dirname = dirname(fileURLToPath(import.meta.url));\nconst pkgRoot = join(Dirname, '../..');\nconst targetDir = join(process.cwd(), '.claude');\n\nif (!existsSync(targetDir)) {\n  mkdirSync(targetDir, { recursive: true });\n}\n\nconst pkgName = 'graphql';\nconst agentMdSrc = existsSync(join(pkgRoot, 'AGENT.md'))\n  ? join(pkgRoot, 'AGENT.md')\n  : join(pkgRoot, 'CLAUDE.md');\nconst metaSrc = existsSync(join(pkgRoot, 'metadata.json'))\n  ? join(pkgRoot, 'metadata.json')\n  : join(pkgRoot, '.claude-meta.json');\n\nif (existsSync(agentMdSrc)) {\n  copyFileSync(agentMdSrc, join(targetDir, `have-${pkgName}.md`));\n}\n\nif (existsSync(metaSrc)) {\n  copyFileSync(metaSrc, join(targetDir, `have-${pkgName}.meta.json`));\n}\n\nconsole.log(`✓ Installed @happyvertical/${pkgName} context to .claude/`);\n"],"names":[],"mappings":";;;;AASA,MAAM,UAAU,QAAQ,cAAc,YAAY,GAAG,CAAC;AACtD,MAAM,UAAU,KAAK,SAAS,OAAO;AACrC,MAAM,YAAY,KAAK,QAAQ,IAAA,GAAO,SAAS;AAE/C,IAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,YAAU,WAAW,EAAE,WAAW,KAAA,CAAM;AAC1C;AAEA,MAAM,UAAU;AAChB,MAAM,aAAa,WAAW,KAAK,SAAS,UAAU,CAAC,IACnD,KAAK,SAAS,UAAU,IACxB,KAAK,SAAS,WAAW;AAC7B,MAAM,UAAU,WAAW,KAAK,SAAS,eAAe,CAAC,IACrD,KAAK,SAAS,eAAe,IAC7B,KAAK,SAAS,mBAAmB;AAErC,IAAI,WAAW,UAAU,GAAG;AAC1B,eAAa,YAAY,KAAK,WAAW,QAAQ,OAAO,KAAK,CAAC;AAChE;AAEA,IAAI,WAAW,OAAO,GAAG;AACvB,eAAa,SAAS,KAAK,WAAW,QAAQ,OAAO,YAAY,CAAC;AACpE;AAEA,QAAQ,IAAI,8BAA8B,OAAO,sBAAsB;"}

package/dist/index.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Get a GraphQL client instance
+ *
+ * This is the main entry point for creating GraphQL clients.
+ * It can accept either a configuration object or an existing client instance.
+ *
+ * @param options - GraphQL configuration or existing client instance
+ * @returns Promise resolving to GraphQL client interface
+ *
+ * @example
+ * ```typescript
+ * import { getGraphQLClient } from '@happyvertical/graphql';
+ *
+ * // Create a GitHub GraphQL client
+ * const github = await getGraphQLClient({
+ *   endpoint: 'https://api.github.com/graphql',
+ *   token: process.env.GITHUB_TOKEN
+ * });
+ *
+ * // Create a GitLab GraphQL client
+ * const gitlab = await getGraphQLClient({
+ *   endpoint: 'https://gitlab.com/api/graphql',
+ *   token: process.env.GITLAB_TOKEN
+ * });
+ *
+ * // Custom headers for other APIs
+ * const custom = await getGraphQLClient({
+ *   endpoint: 'https://api.example.com/graphql',
+ *   headers: {
+ *     'X-API-Key': 'my-api-key',
+ *     'X-Custom-Header': 'value'
+ *   }
+ * });
+ *
+ * // Execute a query
+ * const result = await github.query<{ viewer: { login: string } }>(`
+ *   query {
+ *     viewer {
+ *       login
+ *     }
+ *   }
+ * `);
+ *
+ * // Pass existing instance (returns it unchanged)
+ * const sameClient = await getGraphQLClient(github);
+ * ```
+ */
+export declare function getGraphQLClient(options: GraphQLConfig | IGraphQLClient): Promise<IGraphQLClient>;
+
+/**
+ * Generic GraphQL client implementation
+ *
+ * Works with any GraphQL endpoint - GitHub, GitLab, Shopify, custom APIs, etc.
+ */
+export declare class GraphQLClient implements IGraphQLClient {
+    private readonly endpoint;
+    private readonly headers;
+    constructor(config: GraphQLConfig);
+    /**
+     * Execute a GraphQL query
+     */
+    query<T>(query: string, variables?: Record<string, unknown>): Promise<T>;
+    /**
+     * Execute a GraphQL mutation
+     */
+    mutate<T>(mutation: string, variables?: Record<string, unknown>): Promise<T>;
+    /**
+     * Execute GraphQL operation
+     */
+    private execute;
+}
+
+/**
+ * GraphQL client types
+ */
+/**
+ * GraphQL client configuration
+ *
+ * Generic configuration for any GraphQL endpoint.
+ * GraphQL is a protocol, not a provider - the client
+ * works with any GraphQL API (GitHub, GitLab, Shopify, etc.)
+ */
+export declare interface GraphQLConfig {
+    /** GraphQL endpoint URL */
+    endpoint: string;
+    /** Bearer token for Authorization header */
+    token?: string;
+    /** Custom headers (merged with defaults) */
+    headers?: Record<string, string>;
+}
+
+/**
+ * GraphQL error class
+ */
+export declare class GraphQLError extends Error {
+    readonly code: GraphQLErrorCode;
+    readonly details?: GraphQLErrorDetail[];
+    readonly originalError?: unknown;
+    constructor(message: string, code: GraphQLErrorCode, details?: GraphQLErrorDetail[], originalError?: unknown);
+    /**
+     * Create error from HTTP status code
+     */
+    static fromHTTPStatus(status: number, message: string, originalError?: unknown): GraphQLError;
+    /**
+     * Create error from GraphQL response errors
+     */
+    static fromGraphQLErrors(errors: GraphQLErrorDetail[]): GraphQLError;
+    /**
+     * Create network error
+     */
+    static networkError(message: string, originalError?: unknown): GraphQLError;
+    /**
+     * Check if error is retryable
+     */
+    isRetryable(): boolean;
+}
+
+/**
+ * Error codes for GraphQL operations
+ */
+export declare enum GraphQLErrorCode {
+    /** Authentication failed */
+    UNAUTHORIZED = "UNAUTHORIZED",
+    /** Resource not found */
+    NOT_FOUND = "NOT_FOUND",
+    /** Rate limit exceeded */
+    RATE_LIMITED = "RATE_LIMITED",
+    /** Network error */
+    NETWORK_ERROR = "NETWORK_ERROR",
+    /** Invalid query or mutation */
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    /** Unknown error */
+    UNKNOWN = "UNKNOWN"
+}
+
+/**
+ * GraphQL error detail from API response
+ */
+export declare interface GraphQLErrorDetail {
+    message: string;
+    type?: string;
+    path?: string[];
+    locations?: Array<{
+        line: number;
+        column: number;
+    }>;
+}
+
+/**
+ * GraphQL response structure
+ */
+export declare interface GraphQLResponse<T> {
+    data?: T;
+    errors?: GraphQLErrorDetail[];
+}
+
+/**
+ * GraphQL client interface
+ */
+export declare interface IGraphQLClient {
+    /**
+     * Execute a GraphQL query
+     */
+    query<T>(query: string, variables?: Record<string, unknown>): Promise<T>;
+    /**
+     * Execute a GraphQL mutation
+     */
+    mutate<T>(mutation: string, variables?: Record<string, unknown>): Promise<T>;
+}
+
+export { }

package/dist/index.js

@@ -0,0 +1,166 @@
+var GraphQLErrorCode = /* @__PURE__ */ ((GraphQLErrorCode2) => {
+  GraphQLErrorCode2["UNAUTHORIZED"] = "UNAUTHORIZED";
+  GraphQLErrorCode2["NOT_FOUND"] = "NOT_FOUND";
+  GraphQLErrorCode2["RATE_LIMITED"] = "RATE_LIMITED";
+  GraphQLErrorCode2["NETWORK_ERROR"] = "NETWORK_ERROR";
+  GraphQLErrorCode2["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+  GraphQLErrorCode2["UNKNOWN"] = "UNKNOWN";
+  return GraphQLErrorCode2;
+})(GraphQLErrorCode || {});
+class GraphQLError extends Error {
+  code;
+  details;
+  originalError;
+  constructor(message, code, details, originalError) {
+    super(message);
+    this.name = "GraphQLError";
+    this.code = code;
+    this.details = details;
+    this.originalError = originalError;
+  }
+  /**
+   * Create error from HTTP status code
+   */
+  static fromHTTPStatus(status, message, originalError) {
+    let code;
+    switch (status) {
+      case 401:
+        code = "UNAUTHORIZED";
+        break;
+      case 403:
+        code = "RATE_LIMITED";
+        break;
+      case 404:
+        code = "NOT_FOUND";
+        break;
+      case 422:
+        code = "VALIDATION_ERROR";
+        break;
+      default:
+        code = "UNKNOWN";
+    }
+    return new GraphQLError(message, code, void 0, originalError);
+  }
+  /**
+   * Create error from GraphQL response errors
+   */
+  static fromGraphQLErrors(errors) {
+    const message = errors.map((e) => e.message).join("; ");
+    return new GraphQLError(
+      `GraphQL errors: ${message}`,
+      "VALIDATION_ERROR",
+      errors
+    );
+  }
+  /**
+   * Create network error
+   */
+  static networkError(message, originalError) {
+    return new GraphQLError(
+      message,
+      "NETWORK_ERROR",
+      void 0,
+      originalError
+    );
+  }
+  /**
+   * Check if error is retryable
+   */
+  isRetryable() {
+    return this.code === "RATE_LIMITED" || this.code === "NETWORK_ERROR";
+  }
+}
+class GraphQLClient {
+  endpoint;
+  headers;
+  constructor(config) {
+    if (!config.endpoint) {
+      throw new GraphQLError(
+        "GraphQL endpoint is required",
+        GraphQLError.fromHTTPStatus(400, "Missing endpoint").code
+      );
+    }
+    this.endpoint = config.endpoint;
+    this.headers = {
+      "Content-Type": "application/json"
+    };
+    if (config.token) {
+      this.headers.Authorization = `Bearer ${config.token}`;
+    }
+    if (config.headers) {
+      Object.assign(this.headers, config.headers);
+    }
+  }
+  /**
+   * Execute a GraphQL query
+   */
+  async query(query, variables) {
+    return this.execute(query, variables);
+  }
+  /**
+   * Execute a GraphQL mutation
+   */
+  async mutate(mutation, variables) {
+    return this.execute(mutation, variables);
+  }
+  /**
+   * Execute GraphQL operation
+   */
+  async execute(operation, variables) {
+    let response;
+    try {
+      response = await fetch(this.endpoint, {
+        method: "POST",
+        headers: this.headers,
+        body: JSON.stringify({ query: operation, variables })
+      });
+    } catch (error) {
+      throw GraphQLError.networkError(
+        `Failed to connect to GraphQL API: ${error instanceof Error ? error.message : "Unknown error"}`,
+        error
+      );
+    }
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw GraphQLError.fromHTTPStatus(
+        response.status,
+        `GraphQL error: ${response.statusText}
+${errorText}`,
+        errorText
+      );
+    }
+    const result = await response.json();
+    if (result.errors && result.errors.length > 0) {
+      throw GraphQLError.fromGraphQLErrors(result.errors);
+    }
+    if (!result.data) {
+      throw new GraphQLError(
+        "GraphQL response contained no data",
+        GraphQLError.fromHTTPStatus(500, "No data").code
+      );
+    }
+    return result.data;
+  }
+}
+function isGraphQLClientInstance(value) {
+  return value !== null && typeof value === "object" && "query" in value && "mutate" in value && typeof value.query === "function" && typeof value.mutate === "function";
+}
+async function getGraphQLClient(options) {
+  if (isGraphQLClientInstance(options)) {
+    return options;
+  }
+  if (!options.endpoint) {
+    throw new GraphQLError(
+      "GraphQL endpoint is required",
+      GraphQLErrorCode.VALIDATION_ERROR
+    );
+  }
+  return new GraphQLClient(options);
+}
+export {
+  GraphQLClient,
+  GraphQLError,
+  GraphQLErrorCode,
+  getGraphQLClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/errors.ts","../src/client.ts","../src/factory.ts"],"sourcesContent":["/**\n * GraphQL error handling\n */\n\nimport type { GraphQLErrorDetail } from './types.js';\n\n/**\n * Error codes for GraphQL operations\n */\nexport enum GraphQLErrorCode {\n  /** Authentication failed */\n  UNAUTHORIZED = 'UNAUTHORIZED',\n  /** Resource not found */\n  NOT_FOUND = 'NOT_FOUND',\n  /** Rate limit exceeded */\n  RATE_LIMITED = 'RATE_LIMITED',\n  /** Network error */\n  NETWORK_ERROR = 'NETWORK_ERROR',\n  /** Invalid query or mutation */\n  VALIDATION_ERROR = 'VALIDATION_ERROR',\n  /** Unknown error */\n  UNKNOWN = 'UNKNOWN',\n}\n\n/**\n * GraphQL error class\n */\nexport class GraphQLError extends Error {\n  readonly code: GraphQLErrorCode;\n  readonly details?: GraphQLErrorDetail[];\n  readonly originalError?: unknown;\n\n  constructor(\n    message: string,\n    code: GraphQLErrorCode,\n    details?: GraphQLErrorDetail[],\n    originalError?: unknown,\n  ) {\n    super(message);\n    this.name = 'GraphQLError';\n    this.code = code;\n    this.details = details;\n    this.originalError = originalError;\n  }\n\n  /**\n   * Create error from HTTP status code\n   */\n  static fromHTTPStatus(\n    status: number,\n    message: string,\n    originalError?: unknown,\n  ): GraphQLError {\n    let code: GraphQLErrorCode;\n\n    switch (status) {\n      case 401:\n        code = GraphQLErrorCode.UNAUTHORIZED;\n        break;\n      case 403:\n        code = GraphQLErrorCode.RATE_LIMITED;\n        break;\n      case 404:\n        code = GraphQLErrorCode.NOT_FOUND;\n        break;\n      case 422:\n        code = GraphQLErrorCode.VALIDATION_ERROR;\n        break;\n      default:\n        code = GraphQLErrorCode.UNKNOWN;\n    }\n\n    return new GraphQLError(message, code, undefined, originalError);\n  }\n\n  /**\n   * Create error from GraphQL response errors\n   */\n  static fromGraphQLErrors(errors: GraphQLErrorDetail[]): GraphQLError {\n    const message = errors.map((e) => e.message).join('; ');\n    return new GraphQLError(\n      `GraphQL errors: ${message}`,\n      GraphQLErrorCode.VALIDATION_ERROR,\n      errors,\n    );\n  }\n\n  /**\n   * Create network error\n   */\n  static networkError(message: string, originalError?: unknown): GraphQLError {\n    return new GraphQLError(\n      message,\n      GraphQLErrorCode.NETWORK_ERROR,\n      undefined,\n      originalError,\n    );\n  }\n\n  /**\n   * Check if error is retryable\n   */\n  isRetryable(): boolean {\n    return (\n      this.code === GraphQLErrorCode.RATE_LIMITED ||\n      this.code === GraphQLErrorCode.NETWORK_ERROR\n    );\n  }\n}\n","/**\n * Generic GraphQL client\n */\n\nimport { GraphQLError } from './errors.js';\nimport type {\n  GraphQLConfig,\n  GraphQLErrorDetail,\n  IGraphQLClient,\n} from './types.js';\n\n/**\n * Generic GraphQL client implementation\n *\n * Works with any GraphQL endpoint - GitHub, GitLab, Shopify, custom APIs, etc.\n */\nexport class GraphQLClient implements IGraphQLClient {\n  private readonly endpoint: string;\n  private readonly headers: Record<string, string>;\n\n  constructor(config: GraphQLConfig) {\n    if (!config.endpoint) {\n      throw new GraphQLError(\n        'GraphQL endpoint is required',\n        GraphQLError.fromHTTPStatus(400, 'Missing endpoint').code,\n      );\n    }\n\n    this.endpoint = config.endpoint;\n\n    // Build headers - start with defaults\n    this.headers = {\n      'Content-Type': 'application/json',\n    };\n\n    // Add Authorization if token provided\n    if (config.token) {\n      this.headers.Authorization = `Bearer ${config.token}`;\n    }\n\n    // Merge custom headers (can override defaults)\n    if (config.headers) {\n      Object.assign(this.headers, config.headers);\n    }\n  }\n\n  /**\n   * Execute a GraphQL query\n   */\n  async query<T>(\n    query: string,\n    variables?: Record<string, unknown>,\n  ): Promise<T> {\n    return this.execute<T>(query, variables);\n  }\n\n  /**\n   * Execute a GraphQL mutation\n   */\n  async mutate<T>(\n    mutation: string,\n    variables?: Record<string, unknown>,\n  ): Promise<T> {\n    return this.execute<T>(mutation, variables);\n  }\n\n  /**\n   * Execute GraphQL operation\n   */\n  private async execute<T>(\n    operation: string,\n    variables?: Record<string, unknown>,\n  ): Promise<T> {\n    let response: Response;\n\n    try {\n      response = await fetch(this.endpoint, {\n        method: 'POST',\n        headers: this.headers,\n        body: JSON.stringify({ query: operation, variables }),\n      });\n    } catch (error) {\n      throw GraphQLError.networkError(\n        `Failed to connect to GraphQL API: ${error instanceof Error ? error.message : 'Unknown error'}`,\n        error,\n      );\n    }\n\n    if (!response.ok) {\n      const errorText = await response.text();\n      throw GraphQLError.fromHTTPStatus(\n        response.status,\n        `GraphQL error: ${response.statusText}\\n${errorText}`,\n        errorText,\n      );\n    }\n\n    const result = (await response.json()) as {\n      data?: T;\n      errors?: GraphQLErrorDetail[];\n    };\n\n    if (result.errors && result.errors.length > 0) {\n      throw GraphQLError.fromGraphQLErrors(result.errors);\n    }\n\n    if (!result.data) {\n      throw new GraphQLError(\n        'GraphQL response contained no data',\n        GraphQLError.fromHTTPStatus(500, 'No data').code,\n      );\n    }\n\n    return result.data;\n  }\n}\n","/**\n * GraphQL client factory function\n */\n\nimport { GraphQLClient } from './client.js';\nimport { GraphQLError, GraphQLErrorCode } from './errors.js';\nimport type { GraphQLConfig, IGraphQLClient } from './types.js';\n\n/**\n * Check if value is already a GraphQL client instance\n */\nfunction isGraphQLClientInstance(value: unknown): value is IGraphQLClient {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    'query' in value &&\n    'mutate' in value &&\n    typeof (value as IGraphQLClient).query === 'function' &&\n    typeof (value as IGraphQLClient).mutate === 'function'\n  );\n}\n\n/**\n * Get a GraphQL client instance\n *\n * This is the main entry point for creating GraphQL clients.\n * It can accept either a configuration object or an existing client instance.\n *\n * @param options - GraphQL configuration or existing client instance\n * @returns Promise resolving to GraphQL client interface\n *\n * @example\n * ```typescript\n * import { getGraphQLClient } from '@happyvertical/graphql';\n *\n * // Create a GitHub GraphQL client\n * const github = await getGraphQLClient({\n *   endpoint: 'https://api.github.com/graphql',\n *   token: process.env.GITHUB_TOKEN\n * });\n *\n * // Create a GitLab GraphQL client\n * const gitlab = await getGraphQLClient({\n *   endpoint: 'https://gitlab.com/api/graphql',\n *   token: process.env.GITLAB_TOKEN\n * });\n *\n * // Custom headers for other APIs\n * const custom = await getGraphQLClient({\n *   endpoint: 'https://api.example.com/graphql',\n *   headers: {\n *     'X-API-Key': 'my-api-key',\n *     'X-Custom-Header': 'value'\n *   }\n * });\n *\n * // Execute a query\n * const result = await github.query<{ viewer: { login: string } }>(`\n *   query {\n *     viewer {\n *       login\n *     }\n *   }\n * `);\n *\n * // Pass existing instance (returns it unchanged)\n * const sameClient = await getGraphQLClient(github);\n * ```\n */\nexport async function getGraphQLClient(\n  options: GraphQLConfig | IGraphQLClient,\n): Promise<IGraphQLClient> {\n  // If already a client instance, return it\n  if (isGraphQLClientInstance(options)) {\n    return options;\n  }\n\n  // Validate configuration\n  if (!options.endpoint) {\n    throw new GraphQLError(\n      'GraphQL endpoint is required',\n      GraphQLErrorCode.VALIDATION_ERROR,\n    );\n  }\n\n  return new GraphQLClient(options);\n}\n"],"names":["GraphQLErrorCode"],"mappings":"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"}

package/metadata.json

@@ -0,0 +1,29 @@
+{
+  "name": "@happyvertical/graphql",
+  "path": "packages/graphql",
+  "position": {
+    "index": 14,
+    "count": 30
+  },
+  "description": "GitHub GraphQL client for SDK packages",
+  "provides": [
+    "GitHub GraphQL client for SDK packages"
+  ],
+  "implements": [],
+  "requires": {
+    "workspace": [],
+    "externalHappyVertical": [],
+    "external": []
+  },
+  "dependents": [
+    "@happyvertical/projects",
+    "@happyvertical/repos"
+  ],
+  "stability": {
+    "level": "stable",
+    "reason": "Primary package surface is described as implemented and production-oriented."
+  },
+  "keywords": [
+    "graphql"
+  ]
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@happyvertical/graphql",
+  "version": "0.74.8",
+  "description": "GitHub GraphQL client for SDK packages",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "have-graphql-context": "./dist/cli/claude-context.js"
+  },
+  "devDependencies": {
+    "@types/node": "25.0.10",
+    "typescript": "^5.9.3",
+    "vite": "7.3.2",
+    "vite-plugin-dts": "4.5.4",
+    "vitest": "4.1.5"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "AGENT.md",
+    "metadata.json"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/sdk.git",
+    "directory": "packages/graphql"
+  },
+  "bugs": {
+    "url": "https://github.com/happyvertical/sdk/issues"
+  },
+  "homepage": "https://github.com/happyvertical/sdk/tree/main/packages/graphql#readme",
+  "license": "MIT",
+  "scripts": {
+    "test": "npx vitest run --passWithNoTests",
+    "test:watch": "npx vitest",
+    "build": "vite build",
+    "build:watch": "vite build --watch",
+    "clean": "rm -rf dist",
+    "dev": "npm run build:watch & npm run test:watch"
+  }
+}