feat(user): rename loginId to loginIdOrUserId in user management methods

[yosiharan]

Related Issues

Resolves: https://github.com/descope/etc/issues/14620

Summary

• Renames the loginId parameter to loginIdOrUserId across 22 user management methods to clarify that both login IDs and user IDs are accepted as identifiers
• Aligns naming with the go-sdk convention (loginIDOrUserID)
• The JSON field sent to the Descope API remains loginId — no wire-format change
• Adds PatchUserOptionsUsingIdentifier interface for patchBatch with backward-compatible deprecated loginId field

Methods with renamed parameter:

     ✓  activate                     → loginIdOrUserId
     ✓  addRoles                     → loginIdOrUserId
     ✓  addSSOApps                   → loginIdOrUserId
     ✓  addTenant                    → loginIdOrUserId
     ✓  addTenantRoles               → loginIdOrUserId
     ✓  deactivate                   → loginIdOrUserId
     ✓  delete                       → loginIdOrUserId
     ✓  load                         → loginIdOrUserId
     ✓  patch                        → loginIdOrUserId
     ✓  removeRoles                  → loginIdOrUserId
     ✓  removeSSOApps                → loginIdOrUserId
     ✓  removeTenant                 → loginIdOrUserId
     ✓  removeTenantRoles            → loginIdOrUserId
     ✓  setRoles                     → loginIdOrUserId
     ✓  setSSOApps                   → loginIdOrUserId
     ✓  setTenantRoles               → loginIdOrUserId
     ✓  update                       → loginIdOrUserId
     ✓  updateCustomAttribute        → loginIdOrUserId
     ✓  updateDisplayName            → loginIdOrUserId
     ✓  updateEmail                  → loginIdOrUserId
     ✓  updatePhone                  → loginIdOrUserId
     ✓  updatePicture                → loginIdOrUserId
     ✓  updateUserNames              → loginIdOrUserId

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR clarifies user-identifier semantics in the Management User API by renaming loginId parameters to loginIdOrUserId (while keeping the wire format as loginId) and adds a backward-compatible identifier type for batch patch operations.

Changes:

• Renames user-management method parameters from loginId to loginIdOrUserId while continuing to send loginId to the API.
• Updates patch helpers (buildPatchRequestBody, patch, patchBatch) to use the new identifier naming.
• Introduces PatchUserOptionsUsingIdentifier for patchBatch, adds backward-compat test coverage for the legacy loginId field, and adds an invalid-input test.

Reviewed changes

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

File	Description
lib/management/user.ts	Renames identifier parameters to loginIdOrUserId, updates patch helpers, and introduces a new batch-patch identifier type.
lib/management/user.test.ts	Updates patchBatch call sites to use loginIdOrUserId and adds tests for legacy loginId support and invalid input.

---

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

[dorsha]

Check other review comments.

[yosiharan]

@dorsha All issues addressed, ready for re-review 🙏