fix: support invited by in waitlist invite

[shavonn]

Allow invited_by (and other options) to be passed through Waitlist::invite()

WaitlistService::invite() now accepts an optional array $options = [] second argument that's forwarded to InviteOnly::invite(). This unblocks setting invited_by (the field was always being written as null) and also exposes role, metadata, and expires_at to callers without changing existing call sites.

Why

Inviting from the waitlist always resulted in invitations.invited_by = null, since the service had no parameter for it and never consulted auth(). The fix belongs in the package — every consumer benefits, and no app-side wrapper is needed.

Behavior

• Caller-supplied options override config-derived defaults from resolveInvitationMetadata().
• If invited_by is not provided, it falls back to auth()->user().
• If no user is authenticated and none is passed, invited_by stays null (prior behavior).
• Backward compatible — Waitlist::invite($entry) still works unchanged.

[Copilot]

Pull request overview

This PR extends the waitlist invitation flow so callers can pass invitation options (notably invited_by) through Waitlist::invite() / WaitlistService::invite(), enabling correct attribution and exposing additional invitation fields while keeping existing call sites backwards compatible.

Changes:

• Added optional $options = [] argument to WaitlistService::invite() and forwarded/merged it into InviteOnly::invite(...).
• Added feature tests validating invited_by pass-through and authenticated-user fallback behavior.
• Updated README to document the new Waitlist::invite($entry, $options) usage and signature.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
src/WaitlistService.php	Accepts and forwards invitation options; introduces invited_by fallback behavior.
tests/Feature/WaitlistTest.php	Adds regression tests for invited_by being passed and defaulted.
README.md	Documents new invite(..., $options) capability and updates the public API signature.

---

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