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 info@hitaqnia.com rather than opening a public issue.

License

Released under the MIT License.