[CON-1575] feat: Add ListMetadata Github Connector

providers/github/README.md

@@ -0,0 +1,30 @@
+
+# GitHub Connector
+
+## Authentication Methods
+GitHub provides multiple authentication methods:
+- Personal Access Token (PAT)
+- OAuth2 (used by this connector)
+- GitHub App Authentication(JSON Web Tokens)
+- Fine-grained Personal Access Token (Beta)
+
+
+### Authentication Edge Cases
+Some endpoints only support specific authentication methods. For example:
+- Notification endpoints require Fine-grained access tokens.
+- Some endpoints don't support OAuth authentication at all
+- Enterprise-specific endpoints might require different authentication methods
+
+### Since Parameter Variations
+The `since` parameter behavior varies across endpoints:
+
+1. Timestamp-based (most common):
+   - Format: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`)
+   - Example: `?since=2024-03-15T14:30:45Z`
+
+2. ID-based (numeric):
+   - Some endpoints use `since` as an ID filter instead of a timestamp
+   - Format: Integer
+   - Example: `?since=12345`
+   - Used in endpoints like:
+     - `/users` (filters by user ID)

providers/github/connector.go

@@ -0,0 +1,37 @@
+package github
+
+import (
+	_ "embed"
+
+	"github.com/amp-labs/connectors/common"
+	"github.com/amp-labs/connectors/internal/components"
+	"github.com/amp-labs/connectors/internal/components/schema"
+	"github.com/amp-labs/connectors/providers"
+	"github.com/amp-labs/connectors/providers/github/metadata"
+)
+
+type Connector struct {
+	// Basic connector
+	*components.Connector
+
+	// Require authenticated client
+	common.RequireAuthenticatedClient
+
+	// supported operations
+	components.SchemaProvider
+}
+
+func NewConnector(params common.Parameters) (*Connector, error) {
+	// Create base connector with provider info
+	return components.Initialize(providers.Github, params, constructor)
+}
+
+//nolint:funlen
+func constructor(base *components.Connector) (*Connector, error) {
+	connector := &Connector{Connector: base}
+
+	// Set the metadata provider for the connector
+	connector.SchemaProvider = schema.NewOpenAPISchemaProvider(connector.ProviderContext.Module(), metadata.Schemas)
+
+	return connector, nil
+}