hitaqnia/huwiya-laravel

A Laravel SDK for integrating with the Huwiya Identity Provider.

v1.0.0 2026-04-20 22:52 UTC

Requires

• php: ^8.3
• illuminate/auth: ^13.0
• illuminate/contracts: ^13.0
• illuminate/http: ^13.0
• illuminate/routing: ^13.0
• illuminate/support: ^13.0

Requires (Dev)

• orchestra/testbench: ^11.0
• pestphp/pest: ^4.4
• pestphp/pest-plugin-laravel: ^4.1

MIT

• HiTaqnia

• Authentication
• oauth
• identity
• laravel
• jwt
• huwiya

README

The official Laravel SDK for the Huwiya Identity Provider. It integrates Huwiya-issued JWTs with Laravel's native guard system through two first-class drivers:

• huwiya-web — OAuth 2.0 Authorization Code flow for session-based web applications.
• huwiya-api — JWT Bearer authentication for stateless APIs.

Documentation

Full documentation lives in the docs/ directory.

• 01 · Getting started — install, migrate, register a guard, start a login.
• 02 · Configuration — environment variables and config reference.
• 03 · Customization — the policy hooks you override on your User model.
• 04 · Extensions — recipes for invitations, phone recycling, tenant scoping, role sync.
• 05 · Events — lifecycle events and listener examples.
• 06 · Errors — the Result pattern, exceptions, and HTTP status codes.
• 07 · Security — security properties and defaults.
• 08 · Testing — authenticating users in tests.

Contributing

Bug reports, feature requests, and pull requests are welcome on GitHub. Please run the test suite before submitting a pull request:

composer test

Security

If you discover a security vulnerability, email [e-mail] rather than opening a public issue.

License

Released under the MIT License.