Download the PHP package conduit-ui/connector without Composer
On this page you can find all versions of the php package conduit-ui/connector. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download conduit-ui/connector
More information about conduit-ui/connector
Files in conduit-ui/connector
Package connector
Short Description Core GitHub API connector with authentication
License MIT
Homepage https://github.com/conduit-ui/github-connector
Informations about the package connector
Connector - GitHub API Without the Guesswork
Stop wrestling with GitHub API authentication and error handling. Start with a clean HTTP transport layer that maps GitHub's API responses to typed exceptions automatically.
Perfect for: Building GitHub integrations, creating developer tools, automating repository workflows
Installation
Quick Start
Features
- Token authentication - Pass your GitHub token, done
- Automatic exception mapping - 401s become
GitHubAuthException, 403s becomeGitHubForbiddenException, 404s becomeGitHubResourceNotFoundException - Rate limit awareness - Headers exposed, limits tracked
- Built on Saloon - Full power of Saloon's HTTP client underneath
- GitHub API v3 compatibility - API version headers set correctly
- Zero opinions on requests - Bring your own Request objects or use with higher-level SDKs
Why This Exists
GitHub's API returns generic HTTP errors. Your application needs domain-specific exceptions. This package bridges that gap without forcing you into a full SDK.
The connector is the foundation - it handles authentication and error translation. Build your own request layer on top, or use it with conduit-ui's higher-level packages.
Usage
Basic Authentication
Using with Saloon Requests
Exception Handling
All GitHub HTTP errors are mapped to typed exceptions:
Rate Limit Headers
GitHub's rate limit headers are automatically included in responses:
Repository Context
The connector maintains a static repository context that ecosystem packages can inherit. Set once, use everywhere.
Setting Context
Accessing Context
Switching Context
Error Handling
Using in Ecosystem Packages
Packages in the conduit-ui ecosystem can delegate to the connector:
This creates a unified experience where any package can set or use the context:
Related Packages
The conduit-ui ecosystem builds on this connector:
- conduit-ui/issue - GitHub issue management
- conduit-ui/pr - Pull request operations
- conduit-ui/repo - Repository operations
- conduit-ui/commit - Commit management
- conduit-ui/action - GitHub Actions operations
- conduit-ui/know - Domain knowledge for AI agents
Requirements
- PHP 8.2 or higher
- Saloon HTTP client 3.10+
Testing
Support
Enterprise support available - Need SLA guarantees, custom integrations, or priority bug fixes? Email [email protected]
Community - Open an issue on GitHub or contribute a PR.
License
MIT License. See LICENSE for details.