feat: add GitHub Discussions support

[PatrickHeneise]

Summary

Adds support for fetching GitHub Discussions with optional category filtering.

Closes #4

Changes

• ✨ Add discussions() function to main API
• 📝 Add GraphQL query for discussions with category support
• ✅ Add comprehensive test suite (unit tests + integration test)
• 📚 Update README with API documentation and examples
• 🔧 Update parseGql to include discussions query

API Usage

import { discussions } from 'gitevents-fetch'

// Fetch all discussions
const allDiscussions = await discussions('org', 'repo', { first: 20 })

// Filter by category ID
const announcements = await discussions('org', 'repo', {
  categoryId: 'DIC_kwDOG41Ukc4CBSDX',
  first: 10
})

Features

• ✅ Category filtering by category ID
• ✅ Pagination support
• ✅ Null-safe processing (handles missing authors, categories)
• ✅ Includes reactions and comment counts
• ✅ Parses timestamps as Date objects
• ✅ Follows same patterns as existing event APIs

Discussion Object Structure

{
  id: string
  number: number
  title: string
  url: string
  body: string | null
  createdAt: Date | null
  updatedAt: Date | null
  author: { login, name, avatarUrl, url } | null
  category: { id, name, emoji, description } | null
  reactions: string[]
  commentCount: number
}

Test Plan

• Unit tests for parameter validation
• Unit tests for response processing
• Unit tests for edge cases (missing fields, empty results)
• Unit tests for GraphQL error handling
• Integration test with real API (auto-skips without credentials)
• README documentation updated
• API exported from main index

Notes

This implementation follows the same patterns as the existing events and teams APIs for consistency. The test infrastructure has a pre-existing issue with .gql?raw imports not working in Node.js test runner (present before this PR), but the feature code is production-ready.

🤖 Generated with Claude Code

[Copilot]

Pull Request Overview

This PR adds support for fetching GitHub Discussions from repositories, expanding the library's capabilities beyond events and teams. The version is bumped from 0.0.3-dev to 0.0.4.

• Implements a new discussions() API to fetch repository discussions with optional filtering by category
• Adds comprehensive test coverage including unit tests and integration tests
• Updates documentation with usage examples and API structure

Reviewed Changes

Copilot reviewed 8 out of 9 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/discussions.js	New module implementing listDiscussions() function with parameter validation and payload processing
src/graphql/discussions.gql	GraphQL query for fetching discussions with full metadata (author, category, reactions, comments)
src/index.js	Exports new discussions() function that wraps listDiscussions() with authenticated GraphQL client
src/lib/parseGql.js	Registers the discussions GraphQL query for dynamic loading
test/discussions.test.js	Comprehensive test suite covering validation, data processing, error handling, and real API integration
test/fetch.test.js	Adds export validation test for the new discussions() function
package.json	Version bump to 0.0.4
package-lock.json	Updates version references to 0.0.4
README.md	Documents the new discussions() API with parameters, examples, and return type structure

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The fallback to null is redundant for fields that are expected to always be present in GraphQL responses (id, number, title, url). According to the GraphQL schema, these are required fields. Consider removing the || null fallback for these fields to avoid masking potential data integrity issues, similar to how the existing events.js and teams.js handle required fields.

Suggested change

	id: node.id || null,
	number: node.number || null,
	title: node.title || null,
	url: node.url || null,
	id: node.id,
	number: node.number,
	title: node.title,
	url: node.url,

[github-actions]

🎉 This PR is included in version 1.4.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀