feat(web): guard EE user deletion behind SCIM and unify user API shape - #1425

Merged
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape
Jul 7, 2026
Merged

feat(web): guard EE user deletion behind SCIM and unify user API shape#1425
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Hardens and unifies the enterprise user-management API (/api/ee/user and /api/ee/users).

DELETE /api/ee/user

  • Disabled while SCIM is enabled. When SCIM provisioning is on, the IdP is the source of truth for membership, so the endpoint now returns membershipManagedByIdpError (403) — matching the existing member-management server actions (removeMemberFromOrg, suspendMember, etc.).
  • Delegates to removeMember instead of a raw prisma.user.delete. This makes it an org-scoped membership removal that revokes the member's credentials and enforces last-owner protection, rather than a global account delete.
  • Removed the self-delete guardremoveMember's last-active-owner protection already covers the only risky case, and owners can otherwise remove themselves.

GET /api/ee/user + GET /api/ee/users

  • Identical response shape. Both now return the same user object via a shared toPublicUser mapper (in ee/utils.ts), so they can't drift. Unified shape:
    { id, name, email, role, suspendedAt, createdAt, updatedAt, lastActivityAt }. This only adds fields to each endpoint (non-breaking).
  • Singular GET is now org-scoped. It looks up UserToOrg membership (404 for non-members) instead of doing a global user.findUnique by id — required to source role/suspendedAt/lastActivityAt, and it closes a cross-org read.
  • lastActivityAt now comes from UserToOrg.lastActiveAt (the throttled "last seen" heartbeat the members table already displays) instead of a per-member audit.findFirst. This removes the list endpoint's N+1.

Docs

  • Consolidated PublicEeUser / PublicEeUserListItem schemas into a single PublicEeUser component; updated the OpenAPI descriptions and regenerated sourcebot-public.openapi.json.

Behavior changes to note

  • Singular GET /api/ee/user returns 404 for a user who isn't a member of the caller's org (previously any user id resolved globally).
  • DELETE /api/ee/user is org-membership removal, not global account deletion, and is blocked under SCIM.
  • lastActivityAt is null for suspended members (their lastActiveAt is reset on suspension) and can lag real activity by up to ~5 min (write throttle).

Testing

  • eslint clean on all changed files.
  • tsc --noEmit reports no errors in any changed file (pre-existing unrelated test-mock errors remain).
  • OpenAPI spec regenerates deterministically (no drift).

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Organization user details now include membership role, status, and last activity in API responses.
    • User removal now follows organization membership rules, including protection for the last owner.
  • Bug Fixes

    • User lookup is now scoped to organization membership, so “not found” results are more accurate.
    • When account provisioning is managed externally, user deletion is now blocked with a clearer response.
  • Documentation

    • Updated API docs and changelog wording to match the revised user retrieval and removal behavior.

DELETE /api/ee/user now returns membershipManagedByIdpError when SCIM is
enabled (the IdP owns membership), matching the existing member-management
actions. It also delegates to removeMember, so it does an org-scoped
membership removal with last-owner protection and credential revocation
instead of a raw global user delete. The self-delete guard is removed;
removeMember's last-owner protection covers the risky case.
GET /api/ee/user and GET /api/ee/users now return an identical user shape
via a shared toPublicUser mapper. The singular GET is now scoped to org
membership (404 for non-members) instead of a global user lookup, and
lastActivityAt is sourced from UserToOrg.lastActiveAt (dropping a per-member
audit query / N+1).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlifyBot commented Jul 7, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewJul 7, 2026, 1:45 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7debdd4f-0db8-4c85-9278-2503d9805530

📥 Commits

Reviewing files that changed from the base of the PR and between 11ef472 and 2be8286.

📒 Files selected for processing (7)
  • CHANGELOG.md
  • docs/api-reference/sourcebot-public.openapi.json
  • packages/web/src/app/api/(server)/ee/user/route.ts
  • packages/web/src/app/api/(server)/ee/users/route.ts
  • packages/web/src/app/api/(server)/ee/utils.ts
  • packages/web/src/openapi/publicApiDocument.ts
  • packages/web/src/openapi/publicApiSchemas.ts

Walkthrough

This PR refactors EE user endpoints to use organization membership (UserToOrg) records instead of direct user records. A new toPublicUser utility maps memberships to public user objects. DELETE now enforces SCIM-managed restrictions via removeMember, replacing direct deletion. OpenAPI schemas and docs are updated accordingly.

Changes

EE User Membership Refactor

Layer / File(s)Summary
toPublicUser membership utility
packages/web/src/app/api/(server)/ee/utils.ts
New MembershipWithUser type and toPublicUser function map a membership record (with user) to a public user object with role, suspension, and timestamp fields.
GET /api/ee/user membership lookup
packages/web/src/app/api/(server)/ee/user/route.ts
GET handler queries prisma.userToOrg.findUnique scoped to org/user instead of prisma.user, and returns toPublicUser(membership).
DELETE /api/ee/user SCIM guard and removeMember
packages/web/src/app/api/(server)/ee/user/route.ts
DELETE handler adds an isScimEnabled guard returning membershipManagedByIdpError(), delegates removal to removeMember, and removes prior self-deletion/audit/direct-delete logic.
GET /api/ee/users list mapping
packages/web/src/app/api/(server)/ee/users/route.ts
Users list endpoint replaces per-user audit-based lastActivityAt enrichment with a direct toPublicUser mapping over memberships.
Public API schema updates
packages/web/src/openapi/publicApiSchemas.ts
publicEeUserSchema gains nullable lastActivityAt; publicEeUsersResponseSchema uses publicEeUserSchema array; publicEeUserListItemSchema export removed.
OpenAPI docs, generated spec, and changelog
packages/web/src/openapi/publicApiDocument.ts, docs/api-reference/sourcebot-public.openapi.json, CHANGELOG.md
Descriptions and required fields updated for GET/DELETE /api/ee/user and PublicEeUser/PublicEeUsersResponse schemas; changelog documents removal semantics and response unification.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
participant Client
participant UserRoute
participant Prisma
Client->>UserRoute: GET /api/ee/user
UserRoute->>Prisma: userToOrg.findUnique(orgId, userId)
Prisma-->>UserRoute: membership record (or null)
alt membership found
UserRoute->>UserRoute: toPublicUser(membership)
UserRoute-->>Client: public user response
else not found
UserRoute-->>Client: 404 not a member
end
Loading
sequenceDiagram
participant Client
participant UserRoute
participant SCIMCheck
participant RemoveMember
Client->>UserRoute: DELETE /api/ee/user
UserRoute->>SCIMCheck: isScimEnabled(org)
alt SCIM enabled
SCIMCheck-->>UserRoute: true
UserRoute-->>Client: membershipManagedByIdpError()
else SCIM disabled
UserRoute->>RemoveMember: removeMember(org.id, userId, actor)
RemoveMember-->>UserRoute: result or service error
UserRoute-->>Client: success or error response
end
Loading

Possibly related PRs

  • sourcebot-dev/sourcebot#940: Both PRs modify the same EE user route handlers (ee/user/route.ts, ee/users/route.ts), changing authorization gating and the returned user payload shape.
  • sourcebot-dev/sourcebot#1066: Both PRs touch the same EE user OpenAPI spec entries (GET/DELETE /api/ee/user, /api/ee/users) in sourcebot-public.openapi.json.
  • sourcebot-dev/sourcebot#1165: The main PR's removeMember(...)-based deletion path aligns with this PR's org member removal/leave audit event additions.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title clearly captures the two main changes: SCIM-gated EE user deletion and unifying the user API response shape.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch brendan/ee-user-api-scim-and-unified-shape

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@brendan-kellam
brendan-kellam merged commit 94b2af6 into mainJul 7, 2026
11 checks passed
@brendan-kellam
brendan-kellam deleted the brendan/ee-user-api-scim-and-unified-shape branch July 7, 2026 01:59
@github-actionsgithub-actionsBot mentioned this pull request Jul 7, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

feat(web): guard EE user deletion behind SCIM and unify user API shape - #1425

Merged
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape
Jul 7, 2026
Merged

feat(web): guard EE user deletion behind SCIM and unify user API shape#1425
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Hardens and unifies the enterprise user-management API (/api/ee/user and /api/ee/users).

DELETE /api/ee/user

  • Disabled while SCIM is enabled. When SCIM provisioning is on, the IdP is the source of truth for membership, so the endpoint now returns membershipManagedByIdpError (403) — matching the existing member-management server actions (removeMemberFromOrg, suspendMember, etc.).
  • Delegates to removeMember instead of a raw prisma.user.delete. This makes it an org-scoped membership removal that revokes the member's credentials and enforces last-owner protection, rather than a global account delete.
  • Removed the self-delete guardremoveMember's last-active-owner protection already covers the only risky case, and owners can otherwise remove themselves.

GET /api/ee/user + GET /api/ee/users

  • Identical response shape. Both now return the same user object via a shared toPublicUser mapper (in ee/utils.ts), so they can't drift. Unified shape:
    { id, name, email, role, suspendedAt, createdAt, updatedAt, lastActivityAt }. This only adds fields to each endpoint (non-breaking).
  • Singular GET is now org-scoped. It looks up UserToOrg membership (404 for non-members) instead of doing a global user.findUnique by id — required to source role/suspendedAt/lastActivityAt, and it closes a cross-org read.
  • lastActivityAt now comes from UserToOrg.lastActiveAt (the throttled "last seen" heartbeat the members table already displays) instead of a per-member audit.findFirst. This removes the list endpoint's N+1.

Docs

  • Consolidated PublicEeUser / PublicEeUserListItem schemas into a single PublicEeUser component; updated the OpenAPI descriptions and regenerated sourcebot-public.openapi.json.

Behavior changes to note

  • Singular GET /api/ee/user returns 404 for a user who isn't a member of the caller's org (previously any user id resolved globally).
  • DELETE /api/ee/user is org-membership removal, not global account deletion, and is blocked under SCIM.
  • lastActivityAt is null for suspended members (their lastActiveAt is reset on suspension) and can lag real activity by up to ~5 min (write throttle).

Testing

  • eslint clean on all changed files.
  • tsc --noEmit reports no errors in any changed file (pre-existing unrelated test-mock errors remain).
  • OpenAPI spec regenerates deterministically (no drift).

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Organization user details now include membership role, status, and last activity in API responses.
    • User removal now follows organization membership rules, including protection for the last owner.
  • Bug Fixes

    • User lookup is now scoped to organization membership, so “not found” results are more accurate.
    • When account provisioning is managed externally, user deletion is now blocked with a clearer response.
  • Documentation

    • Updated API docs and changelog wording to match the revised user retrieval and removal behavior.

DELETE /api/ee/user now returns membershipManagedByIdpError when SCIM is
enabled (the IdP owns membership), matching the existing member-management
actions. It also delegates to removeMember, so it does an org-scoped
membership removal with last-owner protection and credential revocation
instead of a raw global user delete. The self-delete guard is removed;
removeMember's last-owner protection covers the risky case.
GET /api/ee/user and GET /api/ee/users now return an identical user shape
via a shared toPublicUser mapper. The singular GET is now scoped to org
membership (404 for non-members) instead of a global user lookup, and
lastActivityAt is sourced from UserToOrg.lastActiveAt (dropping a per-member
audit query / N+1).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlifyBot commented Jul 7, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewJul 7, 2026, 1:45 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7debdd4f-0db8-4c85-9278-2503d9805530

📥 Commits

Reviewing files that changed from the base of the PR and between 11ef472 and 2be8286.

📒 Files selected for processing (7)
  • CHANGELOG.md
  • docs/api-reference/sourcebot-public.openapi.json
  • packages/web/src/app/api/(server)/ee/user/route.ts
  • packages/web/src/app/api/(server)/ee/users/route.ts
  • packages/web/src/app/api/(server)/ee/utils.ts
  • packages/web/src/openapi/publicApiDocument.ts
  • packages/web/src/openapi/publicApiSchemas.ts

Walkthrough

This PR refactors EE user endpoints to use organization membership (UserToOrg) records instead of direct user records. A new toPublicUser utility maps memberships to public user objects. DELETE now enforces SCIM-managed restrictions via removeMember, replacing direct deletion. OpenAPI schemas and docs are updated accordingly.

Changes

EE User Membership Refactor

Layer / File(s)Summary
toPublicUser membership utility
packages/web/src/app/api/(server)/ee/utils.ts
New MembershipWithUser type and toPublicUser function map a membership record (with user) to a public user object with role, suspension, and timestamp fields.
GET /api/ee/user membership lookup
packages/web/src/app/api/(server)/ee/user/route.ts
GET handler queries prisma.userToOrg.findUnique scoped to org/user instead of prisma.user, and returns toPublicUser(membership).
DELETE /api/ee/user SCIM guard and removeMember
packages/web/src/app/api/(server)/ee/user/route.ts
DELETE handler adds an isScimEnabled guard returning membershipManagedByIdpError(), delegates removal to removeMember, and removes prior self-deletion/audit/direct-delete logic.
GET /api/ee/users list mapping
packages/web/src/app/api/(server)/ee/users/route.ts
Users list endpoint replaces per-user audit-based lastActivityAt enrichment with a direct toPublicUser mapping over memberships.
Public API schema updates
packages/web/src/openapi/publicApiSchemas.ts
publicEeUserSchema gains nullable lastActivityAt; publicEeUsersResponseSchema uses publicEeUserSchema array; publicEeUserListItemSchema export removed.
OpenAPI docs, generated spec, and changelog
packages/web/src/openapi/publicApiDocument.ts, docs/api-reference/sourcebot-public.openapi.json, CHANGELOG.md
Descriptions and required fields updated for GET/DELETE /api/ee/user and PublicEeUser/PublicEeUsersResponse schemas; changelog documents removal semantics and response unification.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
participant Client
participant UserRoute
participant Prisma
Client->>UserRoute: GET /api/ee/user
UserRoute->>Prisma: userToOrg.findUnique(orgId, userId)
Prisma-->>UserRoute: membership record (or null)
alt membership found
UserRoute->>UserRoute: toPublicUser(membership)
UserRoute-->>Client: public user response
else not found
UserRoute-->>Client: 404 not a member
end
Loading
sequenceDiagram
participant Client
participant UserRoute
participant SCIMCheck
participant RemoveMember
Client->>UserRoute: DELETE /api/ee/user
UserRoute->>SCIMCheck: isScimEnabled(org)
alt SCIM enabled
SCIMCheck-->>UserRoute: true
UserRoute-->>Client: membershipManagedByIdpError()
else SCIM disabled
UserRoute->>RemoveMember: removeMember(org.id, userId, actor)
RemoveMember-->>UserRoute: result or service error
UserRoute-->>Client: success or error response
end
Loading

Possibly related PRs

  • sourcebot-dev/sourcebot#940: Both PRs modify the same EE user route handlers (ee/user/route.ts, ee/users/route.ts), changing authorization gating and the returned user payload shape.
  • sourcebot-dev/sourcebot#1066: Both PRs touch the same EE user OpenAPI spec entries (GET/DELETE /api/ee/user, /api/ee/users) in sourcebot-public.openapi.json.
  • sourcebot-dev/sourcebot#1165: The main PR's removeMember(...)-based deletion path aligns with this PR's org member removal/leave audit event additions.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title clearly captures the two main changes: SCIM-gated EE user deletion and unifying the user API response shape.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch brendan/ee-user-api-scim-and-unified-shape

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@brendan-kellam
brendan-kellam merged commit 94b2af6 into mainJul 7, 2026
11 checks passed
@brendan-kellam
brendan-kellam deleted the brendan/ee-user-api-scim-and-unified-shape branch July 7, 2026 01:59
@github-actionsgithub-actionsBot mentioned this pull request Jul 7, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(web): guard EE user deletion behind SCIM and unify user API shape - #1425

Merged
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape
Jul 7, 2026
Merged

feat(web): guard EE user deletion behind SCIM and unify user API shape#1425
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Hardens and unifies the enterprise user-management API (/api/ee/user and /api/ee/users).

DELETE /api/ee/user

  • Disabled while SCIM is enabled. When SCIM provisioning is on, the IdP is the source of truth for membership, so the endpoint now returns membershipManagedByIdpError (403) — matching the existing member-management server actions (removeMemberFromOrg, suspendMember, etc.).
  • Delegates to removeMember instead of a raw prisma.user.delete. This makes it an org-scoped membership removal that revokes the member's credentials and enforces last-owner protection, rather than a global account delete.
  • Removed the self-delete guardremoveMember's last-active-owner protection already covers the only risky case, and owners can otherwise remove themselves.

GET /api/ee/user + GET /api/ee/users

  • Identical response shape. Both now return the same user object via a shared toPublicUser mapper (in ee/utils.ts), so they can't drift. Unified shape:
    { id, name, email, role, suspendedAt, createdAt, updatedAt, lastActivityAt }. This only adds fields to each endpoint (non-breaking).
  • Singular GET is now org-scoped. It looks up UserToOrg membership (404 for non-members) instead of doing a global user.findUnique by id — required to source role/suspendedAt/lastActivityAt, and it closes a cross-org read.
  • lastActivityAt now comes from UserToOrg.lastActiveAt (the throttled "last seen" heartbeat the members table already displays) instead of a per-member audit.findFirst. This removes the list endpoint's N+1.

Docs

  • Consolidated PublicEeUser / PublicEeUserListItem schemas into a single PublicEeUser component; updated the OpenAPI descriptions and regenerated sourcebot-public.openapi.json.

Behavior changes to note

  • Singular GET /api/ee/user returns 404 for a user who isn't a member of the caller's org (previously any user id resolved globally).
  • DELETE /api/ee/user is org-membership removal, not global account deletion, and is blocked under SCIM.
  • lastActivityAt is null for suspended members (their lastActiveAt is reset on suspension) and can lag real activity by up to ~5 min (write throttle).

Testing

  • eslint clean on all changed files.
  • tsc --noEmit reports no errors in any changed file (pre-existing unrelated test-mock errors remain).
  • OpenAPI spec regenerates deterministically (no drift).

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Organization user details now include membership role, status, and last activity in API responses.
    • User removal now follows organization membership rules, including protection for the last owner.
  • Bug Fixes

    • User lookup is now scoped to organization membership, so “not found” results are more accurate.
    • When account provisioning is managed externally, user deletion is now blocked with a clearer response.
  • Documentation

    • Updated API docs and changelog wording to match the revised user retrieval and removal behavior.

DELETE /api/ee/user now returns membershipManagedByIdpError when SCIM is
enabled (the IdP owns membership), matching the existing member-management
actions. It also delegates to removeMember, so it does an org-scoped
membership removal with last-owner protection and credential revocation
instead of a raw global user delete. The self-delete guard is removed;
removeMember's last-owner protection covers the risky case.
GET /api/ee/user and GET /api/ee/users now return an identical user shape
via a shared toPublicUser mapper. The singular GET is now scoped to org
membership (404 for non-members) instead of a global user lookup, and
lastActivityAt is sourced from UserToOrg.lastActiveAt (dropping a per-member
audit query / N+1).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlifyBot commented Jul 7, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewJul 7, 2026, 1:45 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7debdd4f-0db8-4c85-9278-2503d9805530

📥 Commits

Reviewing files that changed from the base of the PR and between 11ef472 and 2be8286.

📒 Files selected for processing (7)
  • CHANGELOG.md
  • docs/api-reference/sourcebot-public.openapi.json
  • packages/web/src/app/api/(server)/ee/user/route.ts
  • packages/web/src/app/api/(server)/ee/users/route.ts
  • packages/web/src/app/api/(server)/ee/utils.ts
  • packages/web/src/openapi/publicApiDocument.ts
  • packages/web/src/openapi/publicApiSchemas.ts

Walkthrough

This PR refactors EE user endpoints to use organization membership (UserToOrg) records instead of direct user records. A new toPublicUser utility maps memberships to public user objects. DELETE now enforces SCIM-managed restrictions via removeMember, replacing direct deletion. OpenAPI schemas and docs are updated accordingly.

Changes

EE User Membership Refactor

Layer / File(s)Summary
toPublicUser membership utility
packages/web/src/app/api/(server)/ee/utils.ts
New MembershipWithUser type and toPublicUser function map a membership record (with user) to a public user object with role, suspension, and timestamp fields.
GET /api/ee/user membership lookup
packages/web/src/app/api/(server)/ee/user/route.ts
GET handler queries prisma.userToOrg.findUnique scoped to org/user instead of prisma.user, and returns toPublicUser(membership).
DELETE /api/ee/user SCIM guard and removeMember
packages/web/src/app/api/(server)/ee/user/route.ts
DELETE handler adds an isScimEnabled guard returning membershipManagedByIdpError(), delegates removal to removeMember, and removes prior self-deletion/audit/direct-delete logic.
GET /api/ee/users list mapping
packages/web/src/app/api/(server)/ee/users/route.ts
Users list endpoint replaces per-user audit-based lastActivityAt enrichment with a direct toPublicUser mapping over memberships.
Public API schema updates
packages/web/src/openapi/publicApiSchemas.ts
publicEeUserSchema gains nullable lastActivityAt; publicEeUsersResponseSchema uses publicEeUserSchema array; publicEeUserListItemSchema export removed.
OpenAPI docs, generated spec, and changelog
packages/web/src/openapi/publicApiDocument.ts, docs/api-reference/sourcebot-public.openapi.json, CHANGELOG.md
Descriptions and required fields updated for GET/DELETE /api/ee/user and PublicEeUser/PublicEeUsersResponse schemas; changelog documents removal semantics and response unification.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
participant Client
participant UserRoute
participant Prisma
Client->>UserRoute: GET /api/ee/user
UserRoute->>Prisma: userToOrg.findUnique(orgId, userId)
Prisma-->>UserRoute: membership record (or null)
alt membership found
UserRoute->>UserRoute: toPublicUser(membership)
UserRoute-->>Client: public user response
else not found
UserRoute-->>Client: 404 not a member
end
Loading
sequenceDiagram
participant Client
participant UserRoute
participant SCIMCheck
participant RemoveMember
Client->>UserRoute: DELETE /api/ee/user
UserRoute->>SCIMCheck: isScimEnabled(org)
alt SCIM enabled
SCIMCheck-->>UserRoute: true
UserRoute-->>Client: membershipManagedByIdpError()
else SCIM disabled
UserRoute->>RemoveMember: removeMember(org.id, userId, actor)
RemoveMember-->>UserRoute: result or service error
UserRoute-->>Client: success or error response
end
Loading

Possibly related PRs

  • sourcebot-dev/sourcebot#940: Both PRs modify the same EE user route handlers (ee/user/route.ts, ee/users/route.ts), changing authorization gating and the returned user payload shape.
  • sourcebot-dev/sourcebot#1066: Both PRs touch the same EE user OpenAPI spec entries (GET/DELETE /api/ee/user, /api/ee/users) in sourcebot-public.openapi.json.
  • sourcebot-dev/sourcebot#1165: The main PR's removeMember(...)-based deletion path aligns with this PR's org member removal/leave audit event additions.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title clearly captures the two main changes: SCIM-gated EE user deletion and unifying the user API response shape.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch brendan/ee-user-api-scim-and-unified-shape

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@brendan-kellam
brendan-kellam merged commit 94b2af6 into mainJul 7, 2026
11 checks passed
@brendan-kellam
brendan-kellam deleted the brendan/ee-user-api-scim-and-unified-shape branch July 7, 2026 01:59
@github-actionsgithub-actionsBot mentioned this pull request Jul 7, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(web): guard EE user deletion behind SCIM and unify user API shape - #1425

Merged
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape
Jul 7, 2026
Merged

feat(web): guard EE user deletion behind SCIM and unify user API shape#1425
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Hardens and unifies the enterprise user-management API (/api/ee/user and /api/ee/users).

DELETE /api/ee/user

  • Disabled while SCIM is enabled. When SCIM provisioning is on, the IdP is the source of truth for membership, so the endpoint now returns membershipManagedByIdpError (403) — matching the existing member-management server actions (removeMemberFromOrg, suspendMember, etc.).
  • Delegates to removeMember instead of a raw prisma.user.delete. This makes it an org-scoped membership removal that revokes the member's credentials and enforces last-owner protection, rather than a global account delete.
  • Removed the self-delete guardremoveMember's last-active-owner protection already covers the only risky case, and owners can otherwise remove themselves.

GET /api/ee/user + GET /api/ee/users

  • Identical response shape. Both now return the same user object via a shared toPublicUser mapper (in ee/utils.ts), so they can't drift. Unified shape:
    { id, name, email, role, suspendedAt, createdAt, updatedAt, lastActivityAt }. This only adds fields to each endpoint (non-breaking).
  • Singular GET is now org-scoped. It looks up UserToOrg membership (404 for non-members) instead of doing a global user.findUnique by id — required to source role/suspendedAt/lastActivityAt, and it closes a cross-org read.
  • lastActivityAt now comes from UserToOrg.lastActiveAt (the throttled "last seen" heartbeat the members table already displays) instead of a per-member audit.findFirst. This removes the list endpoint's N+1.

Docs

  • Consolidated PublicEeUser / PublicEeUserListItem schemas into a single PublicEeUser component; updated the OpenAPI descriptions and regenerated sourcebot-public.openapi.json.

Behavior changes to note

  • Singular GET /api/ee/user returns 404 for a user who isn't a member of the caller's org (previously any user id resolved globally).
  • DELETE /api/ee/user is org-membership removal, not global account deletion, and is blocked under SCIM.
  • lastActivityAt is null for suspended members (their lastActiveAt is reset on suspension) and can lag real activity by up to ~5 min (write throttle).

Testing

  • eslint clean on all changed files.
  • tsc --noEmit reports no errors in any changed file (pre-existing unrelated test-mock errors remain).
  • OpenAPI spec regenerates deterministically (no drift).

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Organization user details now include membership role, status, and last activity in API responses.
    • User removal now follows organization membership rules, including protection for the last owner.
  • Bug Fixes

    • User lookup is now scoped to organization membership, so “not found” results are more accurate.
    • When account provisioning is managed externally, user deletion is now blocked with a clearer response.
  • Documentation

    • Updated API docs and changelog wording to match the revised user retrieval and removal behavior.

DELETE /api/ee/user now returns membershipManagedByIdpError when SCIM is
enabled (the IdP owns membership), matching the existing member-management
actions. It also delegates to removeMember, so it does an org-scoped
membership removal with last-owner protection and credential revocation
instead of a raw global user delete. The self-delete guard is removed;
removeMember's last-owner protection covers the risky case.
GET /api/ee/user and GET /api/ee/users now return an identical user shape
via a shared toPublicUser mapper. The singular GET is now scoped to org
membership (404 for non-members) instead of a global user lookup, and
lastActivityAt is sourced from UserToOrg.lastActiveAt (dropping a per-member
audit query / N+1).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlifyBot commented Jul 7, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewJul 7, 2026, 1:45 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7debdd4f-0db8-4c85-9278-2503d9805530

📥 Commits

Reviewing files that changed from the base of the PR and between 11ef472 and 2be8286.

📒 Files selected for processing (7)
  • CHANGELOG.md
  • docs/api-reference/sourcebot-public.openapi.json
  • packages/web/src/app/api/(server)/ee/user/route.ts
  • packages/web/src/app/api/(server)/ee/users/route.ts
  • packages/web/src/app/api/(server)/ee/utils.ts
  • packages/web/src/openapi/publicApiDocument.ts
  • packages/web/src/openapi/publicApiSchemas.ts

Walkthrough

This PR refactors EE user endpoints to use organization membership (UserToOrg) records instead of direct user records. A new toPublicUser utility maps memberships to public user objects. DELETE now enforces SCIM-managed restrictions via removeMember, replacing direct deletion. OpenAPI schemas and docs are updated accordingly.

Changes

EE User Membership Refactor

Layer / File(s)Summary
toPublicUser membership utility
packages/web/src/app/api/(server)/ee/utils.ts
New MembershipWithUser type and toPublicUser function map a membership record (with user) to a public user object with role, suspension, and timestamp fields.
GET /api/ee/user membership lookup
packages/web/src/app/api/(server)/ee/user/route.ts
GET handler queries prisma.userToOrg.findUnique scoped to org/user instead of prisma.user, and returns toPublicUser(membership).
DELETE /api/ee/user SCIM guard and removeMember
packages/web/src/app/api/(server)/ee/user/route.ts
DELETE handler adds an isScimEnabled guard returning membershipManagedByIdpError(), delegates removal to removeMember, and removes prior self-deletion/audit/direct-delete logic.
GET /api/ee/users list mapping
packages/web/src/app/api/(server)/ee/users/route.ts
Users list endpoint replaces per-user audit-based lastActivityAt enrichment with a direct toPublicUser mapping over memberships.
Public API schema updates
packages/web/src/openapi/publicApiSchemas.ts
publicEeUserSchema gains nullable lastActivityAt; publicEeUsersResponseSchema uses publicEeUserSchema array; publicEeUserListItemSchema export removed.
OpenAPI docs, generated spec, and changelog
packages/web/src/openapi/publicApiDocument.ts, docs/api-reference/sourcebot-public.openapi.json, CHANGELOG.md
Descriptions and required fields updated for GET/DELETE /api/ee/user and PublicEeUser/PublicEeUsersResponse schemas; changelog documents removal semantics and response unification.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
participant Client
participant UserRoute
participant Prisma
Client->>UserRoute: GET /api/ee/user
UserRoute->>Prisma: userToOrg.findUnique(orgId, userId)
Prisma-->>UserRoute: membership record (or null)
alt membership found
UserRoute->>UserRoute: toPublicUser(membership)
UserRoute-->>Client: public user response
else not found
UserRoute-->>Client: 404 not a member
end
Loading
sequenceDiagram
participant Client
participant UserRoute
participant SCIMCheck
participant RemoveMember
Client->>UserRoute: DELETE /api/ee/user
UserRoute->>SCIMCheck: isScimEnabled(org)
alt SCIM enabled
SCIMCheck-->>UserRoute: true
UserRoute-->>Client: membershipManagedByIdpError()
else SCIM disabled
UserRoute->>RemoveMember: removeMember(org.id, userId, actor)
RemoveMember-->>UserRoute: result or service error
UserRoute-->>Client: success or error response
end
Loading

Possibly related PRs

  • sourcebot-dev/sourcebot#940: Both PRs modify the same EE user route handlers (ee/user/route.ts, ee/users/route.ts), changing authorization gating and the returned user payload shape.
  • sourcebot-dev/sourcebot#1066: Both PRs touch the same EE user OpenAPI spec entries (GET/DELETE /api/ee/user, /api/ee/users) in sourcebot-public.openapi.json.
  • sourcebot-dev/sourcebot#1165: The main PR's removeMember(...)-based deletion path aligns with this PR's org member removal/leave audit event additions.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title clearly captures the two main changes: SCIM-gated EE user deletion and unifying the user API response shape.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch brendan/ee-user-api-scim-and-unified-shape

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@brendan-kellam
brendan-kellam merged commit 94b2af6 into mainJul 7, 2026
11 checks passed
@brendan-kellam
brendan-kellam deleted the brendan/ee-user-api-scim-and-unified-shape branch July 7, 2026 01:59
@github-actionsgithub-actionsBot mentioned this pull request Jul 7, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

feat(web): guard EE user deletion behind SCIM and unify user API shape - #1425

Merged
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape
Jul 7, 2026
Merged

feat(web): guard EE user deletion behind SCIM and unify user API shape#1425
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Hardens and unifies the enterprise user-management API (/api/ee/user and /api/ee/users).

DELETE /api/ee/user

  • Disabled while SCIM is enabled. When SCIM provisioning is on, the IdP is the source of truth for membership, so the endpoint now returns membershipManagedByIdpError (403) — matching the existing member-management server actions (removeMemberFromOrg, suspendMember, etc.).
  • Delegates to removeMember instead of a raw prisma.user.delete. This makes it an org-scoped membership removal that revokes the member's credentials and enforces last-owner protection, rather than a global account delete.
  • Removed the self-delete guardremoveMember's last-active-owner protection already covers the only risky case, and owners can otherwise remove themselves.

GET /api/ee/user + GET /api/ee/users

  • Identical response shape. Both now return the same user object via a shared toPublicUser mapper (in ee/utils.ts), so they can't drift. Unified shape:
    { id, name, email, role, suspendedAt, createdAt, updatedAt, lastActivityAt }. This only adds fields to each endpoint (non-breaking).
  • Singular GET is now org-scoped. It looks up UserToOrg membership (404 for non-members) instead of doing a global user.findUnique by id — required to source role/suspendedAt/lastActivityAt, and it closes a cross-org read.
  • lastActivityAt now comes from UserToOrg.lastActiveAt (the throttled "last seen" heartbeat the members table already displays) instead of a per-member audit.findFirst. This removes the list endpoint's N+1.

Docs

  • Consolidated PublicEeUser / PublicEeUserListItem schemas into a single PublicEeUser component; updated the OpenAPI descriptions and regenerated sourcebot-public.openapi.json.

Behavior changes to note

  • Singular GET /api/ee/user returns 404 for a user who isn't a member of the caller's org (previously any user id resolved globally).
  • DELETE /api/ee/user is org-membership removal, not global account deletion, and is blocked under SCIM.
  • lastActivityAt is null for suspended members (their lastActiveAt is reset on suspension) and can lag real activity by up to ~5 min (write throttle).

Testing

  • eslint clean on all changed files.
  • tsc --noEmit reports no errors in any changed file (pre-existing unrelated test-mock errors remain).
  • OpenAPI spec regenerates deterministically (no drift).

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Organization user details now include membership role, status, and last activity in API responses.
    • User removal now follows organization membership rules, including protection for the last owner.
  • Bug Fixes

    • User lookup is now scoped to organization membership, so “not found” results are more accurate.
    • When account provisioning is managed externally, user deletion is now blocked with a clearer response.
  • Documentation

    • Updated API docs and changelog wording to match the revised user retrieval and removal behavior.

DELETE /api/ee/user now returns membershipManagedByIdpError when SCIM is
enabled (the IdP owns membership), matching the existing member-management
actions. It also delegates to removeMember, so it does an org-scoped
membership removal with last-owner protection and credential revocation
instead of a raw global user delete. The self-delete guard is removed;
removeMember's last-owner protection covers the risky case.
GET /api/ee/user and GET /api/ee/users now return an identical user shape
via a shared toPublicUser mapper. The singular GET is now scoped to org
membership (404 for non-members) instead of a global user lookup, and
lastActivityAt is sourced from UserToOrg.lastActiveAt (dropping a per-member
audit query / N+1).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlifyBot commented Jul 7, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewJul 7, 2026, 1:45 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7debdd4f-0db8-4c85-9278-2503d9805530

📥 Commits

Reviewing files that changed from the base of the PR and between 11ef472 and 2be8286.

📒 Files selected for processing (7)
  • CHANGELOG.md
  • docs/api-reference/sourcebot-public.openapi.json
  • packages/web/src/app/api/(server)/ee/user/route.ts
  • packages/web/src/app/api/(server)/ee/users/route.ts
  • packages/web/src/app/api/(server)/ee/utils.ts
  • packages/web/src/openapi/publicApiDocument.ts
  • packages/web/src/openapi/publicApiSchemas.ts

Walkthrough

This PR refactors EE user endpoints to use organization membership (UserToOrg) records instead of direct user records. A new toPublicUser utility maps memberships to public user objects. DELETE now enforces SCIM-managed restrictions via removeMember, replacing direct deletion. OpenAPI schemas and docs are updated accordingly.

Changes

EE User Membership Refactor

Layer / File(s)Summary
toPublicUser membership utility
packages/web/src/app/api/(server)/ee/utils.ts
New MembershipWithUser type and toPublicUser function map a membership record (with user) to a public user object with role, suspension, and timestamp fields.
GET /api/ee/user membership lookup
packages/web/src/app/api/(server)/ee/user/route.ts
GET handler queries prisma.userToOrg.findUnique scoped to org/user instead of prisma.user, and returns toPublicUser(membership).
DELETE /api/ee/user SCIM guard and removeMember
packages/web/src/app/api/(server)/ee/user/route.ts
DELETE handler adds an isScimEnabled guard returning membershipManagedByIdpError(), delegates removal to removeMember, and removes prior self-deletion/audit/direct-delete logic.
GET /api/ee/users list mapping
packages/web/src/app/api/(server)/ee/users/route.ts
Users list endpoint replaces per-user audit-based lastActivityAt enrichment with a direct toPublicUser mapping over memberships.
Public API schema updates
packages/web/src/openapi/publicApiSchemas.ts
publicEeUserSchema gains nullable lastActivityAt; publicEeUsersResponseSchema uses publicEeUserSchema array; publicEeUserListItemSchema export removed.
OpenAPI docs, generated spec, and changelog
packages/web/src/openapi/publicApiDocument.ts, docs/api-reference/sourcebot-public.openapi.json, CHANGELOG.md
Descriptions and required fields updated for GET/DELETE /api/ee/user and PublicEeUser/PublicEeUsersResponse schemas; changelog documents removal semantics and response unification.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
participant Client
participant UserRoute
participant Prisma
Client->>UserRoute: GET /api/ee/user
UserRoute->>Prisma: userToOrg.findUnique(orgId, userId)
Prisma-->>UserRoute: membership record (or null)
alt membership found
UserRoute->>UserRoute: toPublicUser(membership)
UserRoute-->>Client: public user response
else not found
UserRoute-->>Client: 404 not a member
end
Loading
sequenceDiagram
participant Client
participant UserRoute
participant SCIMCheck
participant RemoveMember
Client->>UserRoute: DELETE /api/ee/user
UserRoute->>SCIMCheck: isScimEnabled(org)
alt SCIM enabled
SCIMCheck-->>UserRoute: true
UserRoute-->>Client: membershipManagedByIdpError()
else SCIM disabled
UserRoute->>RemoveMember: removeMember(org.id, userId, actor)
RemoveMember-->>UserRoute: result or service error
UserRoute-->>Client: success or error response
end
Loading

Possibly related PRs

  • sourcebot-dev/sourcebot#940: Both PRs modify the same EE user route handlers (ee/user/route.ts, ee/users/route.ts), changing authorization gating and the returned user payload shape.
  • sourcebot-dev/sourcebot#1066: Both PRs touch the same EE user OpenAPI spec entries (GET/DELETE /api/ee/user, /api/ee/users) in sourcebot-public.openapi.json.
  • sourcebot-dev/sourcebot#1165: The main PR's removeMember(...)-based deletion path aligns with this PR's org member removal/leave audit event additions.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title clearly captures the two main changes: SCIM-gated EE user deletion and unifying the user API response shape.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch brendan/ee-user-api-scim-and-unified-shape

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@brendan-kellam
brendan-kellam merged commit 94b2af6 into mainJul 7, 2026
11 checks passed
@brendan-kellam
brendan-kellam deleted the brendan/ee-user-api-scim-and-unified-shape branch July 7, 2026 01:59
@github-actionsgithub-actionsBot mentioned this pull request Jul 7, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(web): guard EE user deletion behind SCIM and unify user API shape - #1425

Merged
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape
Jul 7, 2026
Merged

feat(web): guard EE user deletion behind SCIM and unify user API shape#1425
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Hardens and unifies the enterprise user-management API (/api/ee/user and /api/ee/users).

DELETE /api/ee/user

  • Disabled while SCIM is enabled. When SCIM provisioning is on, the IdP is the source of truth for membership, so the endpoint now returns membershipManagedByIdpError (403) — matching the existing member-management server actions (removeMemberFromOrg, suspendMember, etc.).
  • Delegates to removeMember instead of a raw prisma.user.delete. This makes it an org-scoped membership removal that revokes the member's credentials and enforces last-owner protection, rather than a global account delete.
  • Removed the self-delete guardremoveMember's last-active-owner protection already covers the only risky case, and owners can otherwise remove themselves.

GET /api/ee/user + GET /api/ee/users

  • Identical response shape. Both now return the same user object via a shared toPublicUser mapper (in ee/utils.ts), so they can't drift. Unified shape:
    { id, name, email, role, suspendedAt, createdAt, updatedAt, lastActivityAt }. This only adds fields to each endpoint (non-breaking).
  • Singular GET is now org-scoped. It looks up UserToOrg membership (404 for non-members) instead of doing a global user.findUnique by id — required to source role/suspendedAt/lastActivityAt, and it closes a cross-org read.
  • lastActivityAt now comes from UserToOrg.lastActiveAt (the throttled "last seen" heartbeat the members table already displays) instead of a per-member audit.findFirst. This removes the list endpoint's N+1.

Docs

  • Consolidated PublicEeUser / PublicEeUserListItem schemas into a single PublicEeUser component; updated the OpenAPI descriptions and regenerated sourcebot-public.openapi.json.

Behavior changes to note

  • Singular GET /api/ee/user returns 404 for a user who isn't a member of the caller's org (previously any user id resolved globally).
  • DELETE /api/ee/user is org-membership removal, not global account deletion, and is blocked under SCIM.
  • lastActivityAt is null for suspended members (their lastActiveAt is reset on suspension) and can lag real activity by up to ~5 min (write throttle).

Testing

  • eslint clean on all changed files.
  • tsc --noEmit reports no errors in any changed file (pre-existing unrelated test-mock errors remain).
  • OpenAPI spec regenerates deterministically (no drift).

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Organization user details now include membership role, status, and last activity in API responses.
    • User removal now follows organization membership rules, including protection for the last owner.
  • Bug Fixes

    • User lookup is now scoped to organization membership, so “not found” results are more accurate.
    • When account provisioning is managed externally, user deletion is now blocked with a clearer response.
  • Documentation

    • Updated API docs and changelog wording to match the revised user retrieval and removal behavior.

DELETE /api/ee/user now returns membershipManagedByIdpError when SCIM is
enabled (the IdP owns membership), matching the existing member-management
actions. It also delegates to removeMember, so it does an org-scoped
membership removal with last-owner protection and credential revocation
instead of a raw global user delete. The self-delete guard is removed;
removeMember's last-owner protection covers the risky case.
GET /api/ee/user and GET /api/ee/users now return an identical user shape
via a shared toPublicUser mapper. The singular GET is now scoped to org
membership (404 for non-members) instead of a global user lookup, and
lastActivityAt is sourced from UserToOrg.lastActiveAt (dropping a per-member
audit query / N+1).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlifyBot commented Jul 7, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewJul 7, 2026, 1:45 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7debdd4f-0db8-4c85-9278-2503d9805530

📥 Commits

Reviewing files that changed from the base of the PR and between 11ef472 and 2be8286.

📒 Files selected for processing (7)
  • CHANGELOG.md
  • docs/api-reference/sourcebot-public.openapi.json
  • packages/web/src/app/api/(server)/ee/user/route.ts
  • packages/web/src/app/api/(server)/ee/users/route.ts
  • packages/web/src/app/api/(server)/ee/utils.ts
  • packages/web/src/openapi/publicApiDocument.ts
  • packages/web/src/openapi/publicApiSchemas.ts

Walkthrough

This PR refactors EE user endpoints to use organization membership (UserToOrg) records instead of direct user records. A new toPublicUser utility maps memberships to public user objects. DELETE now enforces SCIM-managed restrictions via removeMember, replacing direct deletion. OpenAPI schemas and docs are updated accordingly.

Changes

EE User Membership Refactor

Layer / File(s)Summary
toPublicUser membership utility
packages/web/src/app/api/(server)/ee/utils.ts
New MembershipWithUser type and toPublicUser function map a membership record (with user) to a public user object with role, suspension, and timestamp fields.
GET /api/ee/user membership lookup
packages/web/src/app/api/(server)/ee/user/route.ts
GET handler queries prisma.userToOrg.findUnique scoped to org/user instead of prisma.user, and returns toPublicUser(membership).
DELETE /api/ee/user SCIM guard and removeMember
packages/web/src/app/api/(server)/ee/user/route.ts
DELETE handler adds an isScimEnabled guard returning membershipManagedByIdpError(), delegates removal to removeMember, and removes prior self-deletion/audit/direct-delete logic.
GET /api/ee/users list mapping
packages/web/src/app/api/(server)/ee/users/route.ts
Users list endpoint replaces per-user audit-based lastActivityAt enrichment with a direct toPublicUser mapping over memberships.
Public API schema updates
packages/web/src/openapi/publicApiSchemas.ts
publicEeUserSchema gains nullable lastActivityAt; publicEeUsersResponseSchema uses publicEeUserSchema array; publicEeUserListItemSchema export removed.
OpenAPI docs, generated spec, and changelog
packages/web/src/openapi/publicApiDocument.ts, docs/api-reference/sourcebot-public.openapi.json, CHANGELOG.md
Descriptions and required fields updated for GET/DELETE /api/ee/user and PublicEeUser/PublicEeUsersResponse schemas; changelog documents removal semantics and response unification.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
participant Client
participant UserRoute
participant Prisma
Client->>UserRoute: GET /api/ee/user
UserRoute->>Prisma: userToOrg.findUnique(orgId, userId)
Prisma-->>UserRoute: membership record (or null)
alt membership found
UserRoute->>UserRoute: toPublicUser(membership)
UserRoute-->>Client: public user response
else not found
UserRoute-->>Client: 404 not a member
end
Loading
sequenceDiagram
participant Client
participant UserRoute
participant SCIMCheck
participant RemoveMember
Client->>UserRoute: DELETE /api/ee/user
UserRoute->>SCIMCheck: isScimEnabled(org)
alt SCIM enabled
SCIMCheck-->>UserRoute: true
UserRoute-->>Client: membershipManagedByIdpError()
else SCIM disabled
UserRoute->>RemoveMember: removeMember(org.id, userId, actor)
RemoveMember-->>UserRoute: result or service error
UserRoute-->>Client: success or error response
end
Loading

Possibly related PRs

  • sourcebot-dev/sourcebot#940: Both PRs modify the same EE user route handlers (ee/user/route.ts, ee/users/route.ts), changing authorization gating and the returned user payload shape.
  • sourcebot-dev/sourcebot#1066: Both PRs touch the same EE user OpenAPI spec entries (GET/DELETE /api/ee/user, /api/ee/users) in sourcebot-public.openapi.json.
  • sourcebot-dev/sourcebot#1165: The main PR's removeMember(...)-based deletion path aligns with this PR's org member removal/leave audit event additions.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title clearly captures the two main changes: SCIM-gated EE user deletion and unifying the user API response shape.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch brendan/ee-user-api-scim-and-unified-shape

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@brendan-kellam
brendan-kellam merged commit 94b2af6 into mainJul 7, 2026
11 checks passed
@brendan-kellam
brendan-kellam deleted the brendan/ee-user-api-scim-and-unified-shape branch July 7, 2026 01:59
@github-actionsgithub-actionsBot mentioned this pull request Jul 7, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(web): guard EE user deletion behind SCIM and unify user API shape - #1425

Merged
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape
Jul 7, 2026
Merged

feat(web): guard EE user deletion behind SCIM and unify user API shape#1425
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Hardens and unifies the enterprise user-management API (/api/ee/user and /api/ee/users).

DELETE /api/ee/user

  • Disabled while SCIM is enabled. When SCIM provisioning is on, the IdP is the source of truth for membership, so the endpoint now returns membershipManagedByIdpError (403) — matching the existing member-management server actions (removeMemberFromOrg, suspendMember, etc.).
  • Delegates to removeMember instead of a raw prisma.user.delete. This makes it an org-scoped membership removal that revokes the member's credentials and enforces last-owner protection, rather than a global account delete.
  • Removed the self-delete guardremoveMember's last-active-owner protection already covers the only risky case, and owners can otherwise remove themselves.

GET /api/ee/user + GET /api/ee/users

  • Identical response shape. Both now return the same user object via a shared toPublicUser mapper (in ee/utils.ts), so they can't drift. Unified shape:
    { id, name, email, role, suspendedAt, createdAt, updatedAt, lastActivityAt }. This only adds fields to each endpoint (non-breaking).
  • Singular GET is now org-scoped. It looks up UserToOrg membership (404 for non-members) instead of doing a global user.findUnique by id — required to source role/suspendedAt/lastActivityAt, and it closes a cross-org read.
  • lastActivityAt now comes from UserToOrg.lastActiveAt (the throttled "last seen" heartbeat the members table already displays) instead of a per-member audit.findFirst. This removes the list endpoint's N+1.

Docs

  • Consolidated PublicEeUser / PublicEeUserListItem schemas into a single PublicEeUser component; updated the OpenAPI descriptions and regenerated sourcebot-public.openapi.json.

Behavior changes to note

  • Singular GET /api/ee/user returns 404 for a user who isn't a member of the caller's org (previously any user id resolved globally).
  • DELETE /api/ee/user is org-membership removal, not global account deletion, and is blocked under SCIM.
  • lastActivityAt is null for suspended members (their lastActiveAt is reset on suspension) and can lag real activity by up to ~5 min (write throttle).

Testing

  • eslint clean on all changed files.
  • tsc --noEmit reports no errors in any changed file (pre-existing unrelated test-mock errors remain).
  • OpenAPI spec regenerates deterministically (no drift).

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Organization user details now include membership role, status, and last activity in API responses.
    • User removal now follows organization membership rules, including protection for the last owner.
  • Bug Fixes

    • User lookup is now scoped to organization membership, so “not found” results are more accurate.
    • When account provisioning is managed externally, user deletion is now blocked with a clearer response.
  • Documentation

    • Updated API docs and changelog wording to match the revised user retrieval and removal behavior.

DELETE /api/ee/user now returns membershipManagedByIdpError when SCIM is
enabled (the IdP owns membership), matching the existing member-management
actions. It also delegates to removeMember, so it does an org-scoped
membership removal with last-owner protection and credential revocation
instead of a raw global user delete. The self-delete guard is removed;
removeMember's last-owner protection covers the risky case.
GET /api/ee/user and GET /api/ee/users now return an identical user shape
via a shared toPublicUser mapper. The singular GET is now scoped to org
membership (404 for non-members) instead of a global user lookup, and
lastActivityAt is sourced from UserToOrg.lastActiveAt (dropping a per-member
audit query / N+1).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlifyBot commented Jul 7, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewJul 7, 2026, 1:45 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7debdd4f-0db8-4c85-9278-2503d9805530

📥 Commits

Reviewing files that changed from the base of the PR and between 11ef472 and 2be8286.

📒 Files selected for processing (7)
  • CHANGELOG.md
  • docs/api-reference/sourcebot-public.openapi.json
  • packages/web/src/app/api/(server)/ee/user/route.ts
  • packages/web/src/app/api/(server)/ee/users/route.ts
  • packages/web/src/app/api/(server)/ee/utils.ts
  • packages/web/src/openapi/publicApiDocument.ts
  • packages/web/src/openapi/publicApiSchemas.ts

Walkthrough

This PR refactors EE user endpoints to use organization membership (UserToOrg) records instead of direct user records. A new toPublicUser utility maps memberships to public user objects. DELETE now enforces SCIM-managed restrictions via removeMember, replacing direct deletion. OpenAPI schemas and docs are updated accordingly.

Changes

EE User Membership Refactor

Layer / File(s)Summary
toPublicUser membership utility
packages/web/src/app/api/(server)/ee/utils.ts
New MembershipWithUser type and toPublicUser function map a membership record (with user) to a public user object with role, suspension, and timestamp fields.
GET /api/ee/user membership lookup
packages/web/src/app/api/(server)/ee/user/route.ts
GET handler queries prisma.userToOrg.findUnique scoped to org/user instead of prisma.user, and returns toPublicUser(membership).
DELETE /api/ee/user SCIM guard and removeMember
packages/web/src/app/api/(server)/ee/user/route.ts
DELETE handler adds an isScimEnabled guard returning membershipManagedByIdpError(), delegates removal to removeMember, and removes prior self-deletion/audit/direct-delete logic.
GET /api/ee/users list mapping
packages/web/src/app/api/(server)/ee/users/route.ts
Users list endpoint replaces per-user audit-based lastActivityAt enrichment with a direct toPublicUser mapping over memberships.
Public API schema updates
packages/web/src/openapi/publicApiSchemas.ts
publicEeUserSchema gains nullable lastActivityAt; publicEeUsersResponseSchema uses publicEeUserSchema array; publicEeUserListItemSchema export removed.
OpenAPI docs, generated spec, and changelog
packages/web/src/openapi/publicApiDocument.ts, docs/api-reference/sourcebot-public.openapi.json, CHANGELOG.md
Descriptions and required fields updated for GET/DELETE /api/ee/user and PublicEeUser/PublicEeUsersResponse schemas; changelog documents removal semantics and response unification.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
participant Client
participant UserRoute
participant Prisma
Client->>UserRoute: GET /api/ee/user
UserRoute->>Prisma: userToOrg.findUnique(orgId, userId)
Prisma-->>UserRoute: membership record (or null)
alt membership found
UserRoute->>UserRoute: toPublicUser(membership)
UserRoute-->>Client: public user response
else not found
UserRoute-->>Client: 404 not a member
end
Loading
sequenceDiagram
participant Client
participant UserRoute
participant SCIMCheck
participant RemoveMember
Client->>UserRoute: DELETE /api/ee/user
UserRoute->>SCIMCheck: isScimEnabled(org)
alt SCIM enabled
SCIMCheck-->>UserRoute: true
UserRoute-->>Client: membershipManagedByIdpError()
else SCIM disabled
UserRoute->>RemoveMember: removeMember(org.id, userId, actor)
RemoveMember-->>UserRoute: result or service error
UserRoute-->>Client: success or error response
end
Loading

Possibly related PRs

  • sourcebot-dev/sourcebot#940: Both PRs modify the same EE user route handlers (ee/user/route.ts, ee/users/route.ts), changing authorization gating and the returned user payload shape.
  • sourcebot-dev/sourcebot#1066: Both PRs touch the same EE user OpenAPI spec entries (GET/DELETE /api/ee/user, /api/ee/users) in sourcebot-public.openapi.json.
  • sourcebot-dev/sourcebot#1165: The main PR's removeMember(...)-based deletion path aligns with this PR's org member removal/leave audit event additions.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title clearly captures the two main changes: SCIM-gated EE user deletion and unifying the user API response shape.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch brendan/ee-user-api-scim-and-unified-shape

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@brendan-kellam
brendan-kellam merged commit 94b2af6 into mainJul 7, 2026
11 checks passed
@brendan-kellam
brendan-kellam deleted the brendan/ee-user-api-scim-and-unified-shape branch July 7, 2026 01:59
@github-actionsgithub-actionsBot mentioned this pull request Jul 7, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

feat(web): guard EE user deletion behind SCIM and unify user API shape - #1425

Merged
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape
Jul 7, 2026
Merged

feat(web): guard EE user deletion behind SCIM and unify user API shape#1425
brendan-kellam merged 2 commits into
mainfrom
brendan/ee-user-api-scim-and-unified-shape

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Hardens and unifies the enterprise user-management API (/api/ee/user and /api/ee/users).

DELETE /api/ee/user

  • Disabled while SCIM is enabled. When SCIM provisioning is on, the IdP is the source of truth for membership, so the endpoint now returns membershipManagedByIdpError (403) — matching the existing member-management server actions (removeMemberFromOrg, suspendMember, etc.).
  • Delegates to removeMember instead of a raw prisma.user.delete. This makes it an org-scoped membership removal that revokes the member's credentials and enforces last-owner protection, rather than a global account delete.
  • Removed the self-delete guardremoveMember's last-active-owner protection already covers the only risky case, and owners can otherwise remove themselves.

GET /api/ee/user + GET /api/ee/users

  • Identical response shape. Both now return the same user object via a shared toPublicUser mapper (in ee/utils.ts), so they can't drift. Unified shape:
    { id, name, email, role, suspendedAt, createdAt, updatedAt, lastActivityAt }. This only adds fields to each endpoint (non-breaking).
  • Singular GET is now org-scoped. It looks up UserToOrg membership (404 for non-members) instead of doing a global user.findUnique by id — required to source role/suspendedAt/lastActivityAt, and it closes a cross-org read.
  • lastActivityAt now comes from UserToOrg.lastActiveAt (the throttled "last seen" heartbeat the members table already displays) instead of a per-member audit.findFirst. This removes the list endpoint's N+1.

Docs

  • Consolidated PublicEeUser / PublicEeUserListItem schemas into a single PublicEeUser component; updated the OpenAPI descriptions and regenerated sourcebot-public.openapi.json.

Behavior changes to note

  • Singular GET /api/ee/user returns 404 for a user who isn't a member of the caller's org (previously any user id resolved globally).
  • DELETE /api/ee/user is org-membership removal, not global account deletion, and is blocked under SCIM.
  • lastActivityAt is null for suspended members (their lastActiveAt is reset on suspension) and can lag real activity by up to ~5 min (write throttle).

Testing

  • eslint clean on all changed files.
  • tsc --noEmit reports no errors in any changed file (pre-existing unrelated test-mock errors remain).
  • OpenAPI spec regenerates deterministically (no drift).

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Organization user details now include membership role, status, and last activity in API responses.
    • User removal now follows organization membership rules, including protection for the last owner.
  • Bug Fixes

    • User lookup is now scoped to organization membership, so “not found” results are more accurate.
    • When account provisioning is managed externally, user deletion is now blocked with a clearer response.
  • Documentation

    • Updated API docs and changelog wording to match the revised user retrieval and removal behavior.

DELETE /api/ee/user now returns membershipManagedByIdpError when SCIM is
enabled (the IdP owns membership), matching the existing member-management
actions. It also delegates to removeMember, so it does an org-scoped
membership removal with last-owner protection and credential revocation
instead of a raw global user delete. The self-delete guard is removed;
removeMember's last-owner protection covers the risky case.
GET /api/ee/user and GET /api/ee/users now return an identical user shape
via a shared toPublicUser mapper. The singular GET is now scoped to org
membership (404 for non-members) instead of a global user lookup, and
lastActivityAt is sourced from UserToOrg.lastActiveAt (dropping a per-member
audit query / N+1).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlifyBot commented Jul 7, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewJul 7, 2026, 1:45 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7debdd4f-0db8-4c85-9278-2503d9805530

📥 Commits

Reviewing files that changed from the base of the PR and between 11ef472 and 2be8286.

📒 Files selected for processing (7)
  • CHANGELOG.md
  • docs/api-reference/sourcebot-public.openapi.json
  • packages/web/src/app/api/(server)/ee/user/route.ts
  • packages/web/src/app/api/(server)/ee/users/route.ts
  • packages/web/src/app/api/(server)/ee/utils.ts
  • packages/web/src/openapi/publicApiDocument.ts
  • packages/web/src/openapi/publicApiSchemas.ts

Walkthrough

This PR refactors EE user endpoints to use organization membership (UserToOrg) records instead of direct user records. A new toPublicUser utility maps memberships to public user objects. DELETE now enforces SCIM-managed restrictions via removeMember, replacing direct deletion. OpenAPI schemas and docs are updated accordingly.

Changes

EE User Membership Refactor

Layer / File(s)Summary
toPublicUser membership utility
packages/web/src/app/api/(server)/ee/utils.ts
New MembershipWithUser type and toPublicUser function map a membership record (with user) to a public user object with role, suspension, and timestamp fields.
GET /api/ee/user membership lookup
packages/web/src/app/api/(server)/ee/user/route.ts
GET handler queries prisma.userToOrg.findUnique scoped to org/user instead of prisma.user, and returns toPublicUser(membership).
DELETE /api/ee/user SCIM guard and removeMember
packages/web/src/app/api/(server)/ee/user/route.ts
DELETE handler adds an isScimEnabled guard returning membershipManagedByIdpError(), delegates removal to removeMember, and removes prior self-deletion/audit/direct-delete logic.
GET /api/ee/users list mapping
packages/web/src/app/api/(server)/ee/users/route.ts
Users list endpoint replaces per-user audit-based lastActivityAt enrichment with a direct toPublicUser mapping over memberships.
Public API schema updates
packages/web/src/openapi/publicApiSchemas.ts
publicEeUserSchema gains nullable lastActivityAt; publicEeUsersResponseSchema uses publicEeUserSchema array; publicEeUserListItemSchema export removed.
OpenAPI docs, generated spec, and changelog
packages/web/src/openapi/publicApiDocument.ts, docs/api-reference/sourcebot-public.openapi.json, CHANGELOG.md
Descriptions and required fields updated for GET/DELETE /api/ee/user and PublicEeUser/PublicEeUsersResponse schemas; changelog documents removal semantics and response unification.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
participant Client
participant UserRoute
participant Prisma
Client->>UserRoute: GET /api/ee/user
UserRoute->>Prisma: userToOrg.findUnique(orgId, userId)
Prisma-->>UserRoute: membership record (or null)
alt membership found
UserRoute->>UserRoute: toPublicUser(membership)
UserRoute-->>Client: public user response
else not found
UserRoute-->>Client: 404 not a member
end
Loading
sequenceDiagram
participant Client
participant UserRoute
participant SCIMCheck
participant RemoveMember
Client->>UserRoute: DELETE /api/ee/user
UserRoute->>SCIMCheck: isScimEnabled(org)
alt SCIM enabled
SCIMCheck-->>UserRoute: true
UserRoute-->>Client: membershipManagedByIdpError()
else SCIM disabled
UserRoute->>RemoveMember: removeMember(org.id, userId, actor)
RemoveMember-->>UserRoute: result or service error
UserRoute-->>Client: success or error response
end
Loading

Possibly related PRs

  • sourcebot-dev/sourcebot#940: Both PRs modify the same EE user route handlers (ee/user/route.ts, ee/users/route.ts), changing authorization gating and the returned user payload shape.
  • sourcebot-dev/sourcebot#1066: Both PRs touch the same EE user OpenAPI spec entries (GET/DELETE /api/ee/user, /api/ee/users) in sourcebot-public.openapi.json.
  • sourcebot-dev/sourcebot#1165: The main PR's removeMember(...)-based deletion path aligns with this PR's org member removal/leave audit event additions.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title clearly captures the two main changes: SCIM-gated EE user deletion and unifying the user API response shape.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch brendan/ee-user-api-scim-and-unified-shape

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@brendan-kellam
brendan-kellam merged commit 94b2af6 into mainJul 7, 2026
11 checks passed
@brendan-kellam
brendan-kellam deleted the brendan/ee-user-api-scim-and-unified-shape branch July 7, 2026 01:59
@github-actionsgithub-actionsBot mentioned this pull request Jul 7, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam