.github/9
ISSUE_TEMPLATE/3bug_report.md config.yml feature_request.md
workflows/3ci.yml clean-clone.yml release.yml
CODEOWNERS dependabot.yml pull_request_template.md
apps/630
api/250
src/243
common/30
__tests__/3authorize.test.ts bigint-serialization.interceptor.test.ts files-limits.test.ts
filters/1all-exceptions.filter.ts
guards/3auth.guard.ts internal-service.guard.ts rate-limit.guard.ts
interceptors/2actor-context.interceptor.ts bigint-serialization.interceptor.ts
middleware/2idempotency.test.ts idempotency.ts
pipes/1zod-validation.pipe.ts
actor-context.ts audit.service.ts cache.test.ts cache.ts cookies.ts core.module.ts deprecation.ts email.service.ts errors.ts event-bus.ts log-scrubber.test.ts log-scrubber.ts logger.ts permission-cache-bridge.ts prisma.service.ts redis.service.ts trace-metadata.ts types.ts
config/1env.ts
lib/11
__tests__/5crypto.test.ts filter-builder.test.ts jwt.test.ts pagination.test.ts positions.test.ts
authorize.ts crypto.ts filter-builder.ts jwt.ts pagination.ts positions.ts
modules/197
ai/28
__tests__/4ai-writing.test.ts database-ai.test.ts generate-executor.test.ts prompts.test.ts
generator/4executor.ts generate.controller.ts generate.dto.ts generate.service.ts
ai-chat.service.ts ai-rate-limit.ts ai-writing.controller.ts ai-writing.dto.ts ai-writing.service.ts ai.controller.ts ai.module.ts ai.service.ts budget-guard.service.ts database-ai.controller.ts database-ai.dto.ts database-ai.service.ts db-prompts.ts dto.ts gateway-provider.ts ledger.service.ts prompts.ts rag.controller.ts rag.dto.ts rag.service.ts
api-keys/3api-keys.controller.ts api-keys.module.ts api-keys.service.ts
audit/2audit-log.controller.ts audit.module.ts
auth/4auth.controller.ts auth.module.ts auth.service.ts dto.ts
automations/5automations.controller.ts automations.module.ts automations.service.ts dto.ts webhook-incoming.controller.ts
blocks/5
__tests__/1batch-version-cas.test.ts
block.service.ts blocks.controller.ts blocks.module.ts dto.ts
comments/4comments.controller.ts comments.module.ts comments.service.ts dto.ts
databases/9
__tests__/3normalize-select-options.test.ts option-id-canonicalization.test.ts record-open-query-shape.test.ts
database.service.ts databases.controller.ts databases.module.ts dto.ts property-cache-schema.ts query.service.ts
docs/2docs.controller.ts docs.module.ts
files/10
__tests__/1quota.test.ts
dto.ts files.controller.ts files.module.ts files.service.ts quota.ts record.ts s3.ts uploads.controller.ts uploads.service.ts
forms/18debug.controller.ts form.dto.ts forms.controller.ts forms.module.ts forms.service.ts markdown.test.ts markdown.ts optional-auth.guard.ts public-forms.controller.ts public-forms.service.ts question.dto.ts questions.service.ts rate-limit.ts recaptcha.ts slug.ts submissions.controller.ts submissions.service.ts submit-schema.ts
health/3health.controller.ts health.module.ts health.service.ts
integrations/3integrations.controller.ts integrations.module.ts integrations.service.ts
internal/12
__tests__/2flush-query-shape.test.ts internal.endpoints.test.ts
ai-test-seam.controller.ts ai-test-seam.dto.ts ai-test-seam.service.ts internal.controller.ts internal.dto.ts internal.module.ts internal.service.ts test-seam.controller.ts test-seam.dto.ts test-seam.service.ts
notifications/3notifications.controller.ts notifications.module.ts notifications.service.ts
oauth/6
__tests__/1oauth.scopes.test.ts
oauth.controller.ts oauth.module.ts oauth.service.ts scopes.ts token-keys.ts
org/15audit.service.ts embed-preview.controller.ts guards.ts members.service.ts org-admin.controller.ts org-policy.service.ts org.module.ts overview.service.ts policy-effective.controller.ts policy.schema.ts policy.test.ts retention.service.ts totp.test.ts totp.ts two-factor.service.ts
orgs/5dto.ts orgs.controller.ts orgs.module.ts orgs.service.ts util.ts
pages/4dto.ts page.service.ts pages.controller.ts pages.module.ts
scim/15
__tests__/3email-mapping.test.ts etag.test.ts filters.test.ts
etag.ts filters.ts groups.service.ts schemas.ts scim-admin.controller.ts scim-admin.service.ts scim-auth.guard.ts scim-auth.service.ts scim-errors.ts scim.controller.ts scim.module.ts users.service.ts
search/4
__tests__/1search.service.test.ts
search.controller.ts search.module.ts search.service.ts
sessions/3sessions.controller.ts sessions.module.ts sessions.service.ts
share/3share.controller.ts share.module.ts share.service.ts
sso/16
__tests__/4enforcement.test.ts oidc.verify.test.ts provisioning.test.ts saml.validate.test.ts
enforcement.ts oidc.controller.ts oidc.service.ts oidc.ts provisioning.service.ts saml.controller.ts saml.ts schemas.ts sso-admin.controller.ts sso-admin.service.ts sso-secrets.ts sso.module.ts
teams/4dto.ts teams.controller.ts teams.module.ts teams.service.ts
users/4dto.ts users.controller.ts users.module.ts users.service.ts
webhooks/3webhooks.controller.ts webhooks.module.ts webhooks.service.ts
workspaces/4dto.ts workspaces.controller.ts workspaces.module.ts workspaces.service.ts
types/1xmldom.d.ts
app.module.ts constants.ts main.ts
_probe_rawbody.cjs .env.example Dockerfile package.json README.md tsconfig.json vitest.config.ts
realtime/33
src/17auth.ts comments.ts config.ts event-source.ts http-store.ts index.ts metrics.ts notifications.ts page-updated-source.ts presence.ts prisma-store.ts protocol.ts rate-limit.ts room-key.ts rooms.ts server.ts update-log.ts
test/11auth.test.ts config.test.ts event-source.test.ts http-store.test.ts metrics-merge.test.ts page-updated-source.test.ts presence.test.ts protocol.test.ts rate-limit.test.ts rooms.test.ts task-0094-builders.test.ts
.env.example Dockerfile package.json README.md tsconfig.json
web/255
src/244
app/45
__tests__/1theme-tokens.test.ts
(app)/26
w/25
[workspace]/25
ask/1page.tsx
databases/1
[id]/1page.tsx
favorites/1page.tsx
files/1page.tsx
notifications/1page.tsx
page/4
[id]/4
[block]/1page.tsx
share/1page.tsx
layout.tsx page.tsx
search/1page.tsx
settings/10
appearance/1page.tsx
automations/3
[id]/1page.tsx
new/1page.tsx
page.tsx
billing/1page.tsx
developers/1page.tsx
members/1page.tsx
permissions/1page.tsx
teams/1page.tsx
page.tsx
shared/1page.tsx
templates/1page.tsx
trash/1page.tsx
layout.tsx page.tsx
layout.tsx
(auth)/4
login/1page.tsx
register/1page.tsx
reset-password/1page.tsx
layout.tsx
api/2
metrics/1route.ts
v1/1
health/1route.ts
f/1
[slug]/1page.tsx
health/1
ready/1route.ts
org/2
[orgId]/2
admin/2
integrations/1page.tsx
page.tsx
share/1
[id]/1page.tsx
error.tsx global-error.tsx globals.css layout.tsx not-found.tsx page.tsx providers.tsx
components/118
admin/10
org-admin/8ApiKeysTab.tsx AuditTab.tsx MembersTab.tsx OverviewTab.tsx PoliciesTab.tsx RetentionTab.tsx WebhooksTab.tsx WorkspacePicker.tsx
ScimCard.tsx SsoTabs.tsx
ai/6ai-panel.tsx ask-ai-submenu.tsx db-ai-dialog.tsx generate-page-dialog.tsx writing-actions-menu.tsx writing-diff.tsx
automations/5action-editor.tsx condition-editor.tsx lib.ts run-history.tsx trigger-editor.tsx
collaboration/6CursorLayer.tsx OfflineBanner.tsx PresenceBar.tsx README.md ReviewFailedDialog.tsx StatusChip.tsx
comments/3comment-panel.tsx comment-thread.tsx mention-input.tsx
database/27
__tests__/2cell-editor.test.tsx cell-renderer.test.tsx
AiExtractDialog.tsx AiFormulaDialog.tsx AiGenerateDialog.tsx board-view.tsx buttons-panel.tsx calendar-view.tsx cell-editor.tsx cell-renderer.tsx chart-view.tsx database-page-view.tsx database-toolbar.tsx database-view-renderer.tsx db-embedded.tsx filter-builder.tsx form-builder-view.tsx formula-editor.tsx gallery-view.tsx group-builder.tsx list-view.tsx property-editor.tsx record-header.tsx record-panel.tsx sort-builder.tsx table-view.tsx timeline-view.tsx
dialogs/7
__tests__/1move-to-dialog.test.tsx
create-dialog.tsx dialog.tsx file-permissions-dialog.tsx invite-dialog.tsx move-to-dialog.tsx share-dialog.tsx
editor/19
__tests__/3code-block-text.test.ts code-block.test.tsx expandable.test.tsx
block-card.tsx block-renderer.tsx block-save-queue.ts block-toolbar.tsx context-menu.tsx expandable.tsx history-popover.tsx inline-editor.tsx insert-dialog.tsx page-canvas.tsx page-spinner.tsx page-view.tsx selection-toolbar.tsx slash-menu.tsx template-dialog.tsx type-menu.tsx
files/4FileBlock.tsx FileBrowser.tsx FilePicker.tsx PreviewModal.tsx
form/4form-field.tsx form-renderer.tsx form-responses-view.tsx form-view.tsx
layout/8
__tests__/1page-tree-icon.test.tsx
command-palette.tsx factory-logo.tsx page-tree-node.tsx sidebar.tsx theme-provider.tsx topbar.tsx workspace-shell.tsx
mentions/3
__tests__/1mention-model.test.ts
mention-model.ts MentionPopup.tsx
search/3ask-ai-search.tsx results-list.tsx search-dialog.tsx
settings/10
api-keys/4ApiKeyCreateDialog.tsx ApiKeyRevealDialog.tsx ApiKeyTable.tsx ScopesBadge.tsx
webhooks/5CurlExamples.tsx DeliveryInspector.tsx EventExplorer.tsx OverviewTab.tsx WebhooksTab.tsx
settings-shell.tsx
ui/3confirm-dialog.tsx form.tsx toaster.tsx
hooks/21
__tests__/4realtime-frame-handler.test.ts use-blocks.test.ts use-database-options.test.ts use-workspace.test.tsx
realtime-frame-handler.ts use-ai-stream.ts use-auth.ts use-blocks.ts use-database.ts use-db-ai-stream.ts use-forms.ts use-members.ts use-mention-sources.ts use-notifications.ts use-offline-status.ts use-pages.ts use-presence-announcer.ts use-presence-toasts.ts use-presence.ts use-realtime.ts use-workspace.ts
lib/50
__tests__/21ai-database.test.ts ai-generate.test.ts ai-sse.test.ts ai-writing.test.ts api-keys.test.ts api-members.test.ts auth-refresh.test.ts auth-store.test.ts batch-queue-drop.test.ts block-content.test.ts clipboard-import.test.ts code-highlight.test.ts offline-status.test.ts presence-announcer.test.ts presence-color.test.ts presence-cursor.test.ts presence-emitter.test.ts realtime-url.test.ts search.test.ts utils.test.ts writing-diff.test.ts
files/7
__tests__/2picker.test.ts upload.test.ts
api.ts picker.ts upload-store.ts upload.ts use-file-uploads.ts
ai-database.ts ai.ts api-keys.ts api.ts auth-store.ts batch-queue.ts block-content.ts clipboard-import.ts code-highlight.ts constants.ts offline-status.ts org-admin.ts presence-announcer.ts presence-color.ts presence-cursor.ts presence-editor-views.ts presence-emitter.ts query-client.ts realtime.ts search.ts types.ts utils.ts
stores/8
__tests__/1block-patch-store.test.ts
block-patch-store.ts comment-pill-store.ts database-store.ts editor-store.ts offlineQueue.ts presence-store.ts ui-store.ts
instrumentation.ts middleware.ts
.env.example Dockerfile next-env.d.ts next.config.mjs package.json postcss.config.mjs README.md tailwind.config.ts tsconfig.json tsconfig.tsbuildinfo vitest.config.ts
worker/92
src/87
__tests__/13ai-embedding.test.ts ai-request.test.ts ai-usage-budget.test.ts audit-export.test.ts email-decision.test.ts encrypt.test.ts health-search-index-lag.test.ts mime.test.ts retention.test.ts s3-sign.test.ts search-index.test.ts smtp.test.ts webhook-sign.test.ts
health/1server.ts
lib/12
__tests__/1clamav.test.ts
clamav.ts encrypt.ts job-otel.ts mime.ts notify.ts prisma.ts redis-stream.ts redis.ts s3.ts sharp.ts smtp.ts
processors/56
automations/28
__tests__/3condition-evaluator.spec.ts executors.spec.ts run-pipeline.spec.ts
executors/17assign-user.ts call-integration.ts change-status.ts classify.ts create-notification.ts create-page.ts email-cap.ts helpers.ts integration-registry.ts permission.ts record-write.ts registry.ts run-ai-action.ts send-email.ts send-webhook.ts types.ts update-record.ts
condition-evaluator.ts dead-letter.ts log.ts matcher.ts pipeline.ts run-state.ts schedule.ts watchdog.ts
files/15
__tests__/4errors.test.ts scan-gate.test.ts status.test.ts temp.test.ts
steps/4finalize.ts metadata.ts scan.ts thumbnails.ts
cleanup.ts errors.ts generateThumbs.ts processor.ts status.ts temp.ts types.ts
search-index/4builders.ts grants.ts index.ts processor.ts
ai-embedding.ts ai.processor.ts audit-export.ts automations.processor.ts email-decision.processor.ts email.processor.ts maintenance.processor.ts retention.ts webhooks.processor.ts
config.ts events.ts index.ts logger.ts queues.ts
.env.example Dockerfile package.json README.md tsconfig.json
docs/73
api/17ai.md authentication.md automations.md blocks.md comments.md databases.md files.md forms.md openapi.yaml org-admin.md pages.md scim.md search.md sso.md versioning.md webhooks.md workspaces.md
architecture/10ai-architecture.md automation.md backend-architecture.md database-architecture.md frontend-architecture.md realtime-architecture.md search-architecture.md security-architecture.md storage.md system-architecture.md
database/2database-architecture.md redis-keys.md
development/8admin-guide.md coding-standards.md deployment.md development-guide.md files-pipeline.md perf-report.md performance.md testing.md
product/4functional-requirements.md non-functional-requirements.md product-requirements.md ux-requirements.md
requirements/1requirements-matrix.md
security/5audit-report.md files.md forms.md license-allowlist.md security-architecture.md
tasks/16phase-00-foundation.md phase-01-authentication.md phase-02-workspace.md phase-03-pages.md phase-04-editor.md phase-05-databases.md phase-06-relations.md phase-07-collaboration.md phase-08-search.md phase-09-files.md phase-10-forms.md phase-11-automation.md phase-12-ai.md phase-13-api.md phase-14-enterprise.md phase-15-production.md
ui/9ai.md automations.md design-system.md developers.md files.md forms.md org-admin.md scim.md sso.md
support-matrix.md
infrastructure/71
caddy/1Caddyfile
docker/6
init/101-extensions.sql
opensearch/1init-indices.json
.env.docker docker-compose.yml opensearch-init.sh README.md
kubernetes/40
observability/20
alertmanager/1alertmanager.yaml
grafana/8
dashboards/6ai.json api-overview.json infra.json realtime.json search.json workers-queues.json
provisioning/2
dashboards/1dashboards.yaml
datasources/1datasource.yaml
prometheus/3alerts.yaml recording-rules.yaml scrape.yaml
scripts/1sync-sources.mjs
alertmanager.yaml grafana.yaml kustomization.yaml namespace.yaml node-exporter.yaml otel-collector.yaml prometheus.yaml
postgres/7configmap.yaml cronjob-backup.yaml cronjob-opensearch-snapshot.yaml pgbouncer.yaml replica.yaml statefulset.yaml walg-iam-policy.yaml
api.yaml configmap.yaml ingress.yaml kustomization.yaml namespace.yaml networkpolicy.yaml pdb.yaml README.md realtime.yaml redis.yaml secret.example.yaml web.yaml worker.yaml
nginx/2nginx.conf README.md
observability/14
alertmanager/1alertmanager.yaml
grafana/8
dashboards/6ai.json api-overview.json infra.json realtime.json search.json workers-queues.json
provisioning/2
dashboards/1dashboards.yaml
datasources/1datasource.yaml
prometheus/3alerts.yaml recording-rules.yaml scrape.yaml
scripts/1dashboard-completeness.mjs
README.md
terraform/8compute.tf data.tf main.tf network.tf outputs.tf README.md security.tf variables.tf
packages/289
ai/24
src/20
providers/7anthropic.ts google.ts http.ts index.ts openai-compatible.ts rag.test.ts writing.test.ts
schemas/2database.ts generate.ts
adapters.test.ts config.test.ts config.ts gateway.test.ts gateway.ts index.ts tools.test.ts tools.ts types.ts usage.test.ts usage.ts
package.json README.md tsconfig.json vitest.config.ts
auth/11
src/7index.ts passwords.test.ts passwords.ts sessions.test.ts sessions.ts tokens.test.ts tokens.ts
package.json README.md tsconfig.json vitest.config.ts
collaboration/17
src/13awareness.ts codec.test.ts codec.ts index.ts lww.test.ts lww.ts mapping.ts offline.ts outbox.test.ts outbox.ts provider.test.ts provider.ts types.ts
package.json README.md tsconfig.json vitest.config.ts
config/7
src/4eslint.base.js index.ts prettier.base.json tsconfig.base.json
package.json README.md tsconfig.json
database-client/5
src/2index.test.ts index.ts
package.json README.md tsconfig.json
database-engine/33
src/29
filter/2filter.test.ts index.ts
formula/8evaluator.ts formula.test.ts functions.ts index.ts lexer.ts parser.ts types.ts validate.ts
query/6group.ts index.ts paginate.ts pivot.ts query.test.ts sort.ts
relations/2index.ts relations.test.ts
rollups/2index.ts rollups.test.ts
values/5dates.ts index.ts registry.ts types.ts values.test.ts
views/3buttons.ts index.ts views.test.ts
index.ts
package.json README.md tsconfig.json vitest.config.ts
editor/25
src/21
marks/1highlight.ts
nodes/2equation.ts mention.ts
autosave.test.ts autosave.ts clipboard.test.ts clipboard.ts codec.test.ts codec.ts context-menu.test.ts context-menu.ts diff.test.ts diff.ts factory.ts history.test.ts history.ts index.ts positions.ts slash.test.ts slash.ts types.ts
package.json README.md tsconfig.json vitest.config.ts
observability/20
src/16
__tests__/8db-redis-metrics.test.ts metrics.test.ts otel.test.ts pino-otel.test.ts prometheus.test.ts resource.test.ts scrubber.test.ts traceparent.test.ts
index.ts metrics.ts otel.ts pino-otel.ts prometheus.ts resource.ts scrubber.ts traceparent.ts
package.json README.md tsconfig.json vitest.config.ts
permissions/11
src/7index.ts levels.test.ts levels.ts resolve.test.ts resolve.ts rules.test.ts rules.ts
package.json README.md tsconfig.json vitest.config.ts
search/22
src/18chunking.test.ts chunking.ts client.test.ts client.ts embeddings.test.ts embeddings.ts hybrid.test.ts hybrid.ts index.ts indexer.test.ts indexer.ts mapping.test.ts mapping.ts queries.test.ts queries.ts rrf.test.ts rrf.ts types.ts
package.json README.md tsconfig.json vitest.config.ts
shared/61
src/57
dto/17ai.dto.ts auth.dto.test.ts auth.dto.ts block.dto.ts browser-safety.test.ts comment.dto.ts database.dto.test.ts database.dto.ts file.dto.ts formula-ast.ts index.ts notification.dto.ts page.dto.ts search.dto.ts share.dto.ts webhook.dto.ts workspace.dto.ts
events/8audit-catalog.test.ts audit-catalog.ts audit-csv.test.ts audit-csv.ts audit-scope.test.ts audit-scope.ts catalog.test.ts catalog.ts
realtime/6comment-events.ts frames.test.ts frames.ts notification-policy.ts notification-prefs.ts task-0094.test.ts
automation.test.ts automation.ts constants.ts crypto.test.ts crypto.ts env.ts errors.ts events.test.ts events.ts forms.test.ts forms.ts index.ts markdown.test.ts markdown.ts mentions.test.ts mentions.ts net.test.ts net.ts positions.test.ts positions.ts presence.test.ts presence.ts security-headers.ts webhook-delivery.test.ts webhook-delivery.ts webhook-events.ts
package.json README.md tsconfig.json vitest.config.ts
storage/16
src/12client.test.ts client.ts index.ts keys.test.ts keys.ts mime.test.ts mime.ts presign.test.ts presign.ts thumbnails.test.ts thumbnails.ts types.ts
package.json README.md tsconfig.json vitest.config.ts
ui/37
src/33
components/19avatar.tsx badge.tsx button.tsx checkbox.tsx command.tsx context-menu.tsx dialog.tsx dropdown-menu.tsx empty-state.tsx index.ts popover.tsx separator.tsx skeleton.tsx slider.tsx spinner.tsx switch.tsx tabs.tsx toast.tsx tooltip.tsx
color.ts command-filter.test.ts command-filter.ts focus.test.ts focus.ts formatters.test.ts formatters.ts index.ts theme.test.ts theme.ts toast-store.test.ts toast-store.ts tokens.test.ts tokens.ts
package.json README.md tsconfig.json vitest.config.ts
prisma/16
migrations/13
20260927000000_init/1migration.sql
20260928000000_search_documents_content_hash/1migration.sql
20260929000000_workspace_usage_storage_bytes/1migration.sql
20260930000000_form_submitted_notification_type/1migration.sql
20261001000000_ai_phase12/1migration.sql
20261002000000_webhooks_secret_encrypted_dlq/1migration.sql
20261002111436_webhook_delivery_latency/1migration.sql
20261002120000_org_admin_2fa_retention_unique/1migration.sql
20261002215124_audit_export/1migration.sql
20261003210000_perf_indexes_hot_paths/1migration.sql
20261004004500_perf_indexes_hot_paths_2/1migration.sql
migration_lock.toml README.md
schema.prisma seed.ts verify.ts
scripts/7backup-health.ts docs-completeness.mjs generate-openapi.mjs minio-init.ts opensearch-reindex.ts storage-orphans.ts verify-clean-clone.sh
tests/169
e2e/63
.auth/1user.json
fixtures/7
files/6clip.mp4 clip.wav clip.webm hero-1400.png note.docx note.txt
realtime.ts
mocks/2oidc-issuer.ts saml-idp.ts
playwright-report/3
data/2a6557bae9c2714a658968d4eb8534195c08ebda8.png e3092d07d00a16063e46385c02a559a9054fa847.webm
index.html
reports/1files-security.json
specs/34ai-database.spec.ts ai-generate.spec.ts ai-rag.spec.ts ai-security.spec.ts ai-writing.spec.ts ai.spec.ts api-keys.spec.ts appearance-theme.spec.ts auth.spec.ts automation.spec.ts collab-two-tab.spec.ts comments.spec.ts databases.spec.ts default-workspace-alias.spec.ts developers.spec.ts editor.spec.ts files.spec.ts final-flow.spec.ts forms.spec.ts oauth.spec.ts org-admin.spec.ts pages.spec.ts performance.spec.ts presence-cursors.spec.ts qa-paste-toggle.spec.ts realtime.spec.ts scim.spec.ts search-index-lag.spec.ts search.spec.ts sharing.spec.ts sso.spec.ts task-0094-comments-notifications.spec.ts webhooks.spec.ts workspace.spec.ts
test-results-final-flow/3
final-flow-Release-v1-0-fi-6c06b-w-state-carries-sequential--chromium-desktop/2test-failed-1.png trace.zip
.last-run.json
utils/4api.ts dnd.ts search-lag.ts wait.ts
.gitignore fixtures.ts global-setup.ts package.json playwright.config.ts playwright.final-flow.config.ts README.md tsconfig.json
fixtures/1
files/1make-sparse.ts
integration/60
ai-capability/2ai-app.capability.test.ts gateway.capability.test.ts
drill/2seed-drill.mjs verify-restore.mjs
fixtures/5
files/5clip.mp4 clip.wav doc.pdf hero-1400.png note.txt
helpers/3api.ts containers.ts seed.ts
realtime/11control-channel.test.ts convergence.test.ts flush-rebase-http.test.ts handshake.test.ts heartbeat-limits.test.ts lifecycle.test.ts presence.test.ts rebase.test.ts resume.test.ts rt-helpers.ts task-0094-fanout.test.ts
ai-chat.integration.test.ts ai-database.integration.test.ts ai-generate.integration.test.ts ai-rag.integration.test.ts ai-writing.integration.test.ts api-keys.integration.test.ts audit-completeness.integration.test.ts audit-export-s3.integration.test.ts auth.integration.test.ts automation-pipeline.integration.test.ts automations.integration.test.ts blocks.integration.test.ts cache-invalidation.integration.test.ts comments.integration.test.ts databases.integration.test.ts files-lifecycle.integration.test.ts files-pipeline.integration.test.ts files-security.integration.test.ts files.integration.test.ts forms-responses.integration.test.ts forms.integration.test.ts oauth.integration.test.ts openapi.contract.test.ts org-admin.integration.test.ts package.json pages.integration.test.ts permissions.integration.test.ts README.md replica-routing.integration.test.ts retention-engine.integration.test.ts scim.integration.test.ts search.integration.test.ts sso.integration.test.ts tsconfig.json vitest.config.ts webhooks.integration.test.ts workspace.integration.test.ts
performance/28
fixtures/1search-100k.ts
helpers/2seed-100k.mjs seed-1k-load.mjs
reports/7api-load-smoke.json database-load-smoke.json editor-local.json realtime-load.json search-full.json search-last.json search-reduced.json
api-load.js api.js archive.tar database-load.js database.js editor-local.mjs extract-100k-env.mjs package.json README.md realtime-1k.js realtime-load.js realtime.js run-realtime-load.sh search-search.k6.js search-summary.json seed-100k.mjs threshold-breach-demo.js verify-zero-op-loss.mjs
security/16
helpers/1app.ts
audit-report.test.ts auth-paths.test.ts deps.test.ts formula-fuzz.test.ts gitleaks-config.test.ts headers.test.ts images.test.ts oracle.ts package.json permission-fuzz.test.ts rate-limits.test.ts README.md tsconfig.json upload-abuse.test.ts vitest.config.ts
README.md
.dockerignore .env .env.bak-task0125 .env.example .eslintrc.json .gitignore .npmrc .prettierignore .prettierrc.json AGENTS.md ARCHITECTURE.md CHANGELOG.md CONTRIBUTING.md gitleaks.toml LICENSE package.json pnpm-lock.yaml pnpm-workspace.yaml PRODUCT-SPEC.md README.md ROADMAP.md SECURITY.md tsconfig.json turbo.json
sso.spec.tstests/e2e/specs/sso.spec.tsraw← specs25,874 B← Back to the app
1/**
2 * TASK-0131 — SSO E2E (the phase exit criterion).
3 *
4 * Real two-origin dev stack: API :4000 (must run with SSO_ORIGIN=http://localhost:4000),
5 * web :3000. A per-run mock SAML IdP (tests/e2e/mocks/saml-idp.ts) and mock
6 * OIDC issuer (tests/e2e/mocks/oidc-issuer.ts) stand in for the customer IdP.
7 *
8 * Covers (per the task's acceptance criteria):
9 *  1. SAML round trip (BROWSER): login page → SSO discovery → start
10 *     dispatcher → SP-initiated redirect → mock IdP auto-approve → form
11 *     POST /saml/acs → refresh cookie → lands in the org's team workspace.
12 *     Assertions: the JIT user was created (passwordless + verified), the
13 *     SsoIdentity + OrganizationMember rows exist, the `sso.login.saml`
14 *     audit row carries ip+ua, and a second SSO login reuses the same user
15 *     (no duplicate rows).
16 *  2. ACS tamper matrix (direct POSTs to the API — the fast path for the
17 *     validation-matrix reasons: expired / non-success / wrong cert /
18 *     replay / bad signature / unsigned).
19 *  3. OIDC round trip (direct HTTP against the mock issuer): authorize →
20 *     IdP auto-approve → callback → session cookie.
21 *  4. Enforce mode: an org-owner password login → 403 {reason:"sso_required"};
22 *     a user with no org membership can still password-login.
23 *  5. Admin UI (SsoTabs): configure SAML via the form, test-connection →
24 *     green panel, enforce toggle + badge.
25 *
26 * Cleanup: orgs/workspaces/identity rows are pruned via Prisma (there is no
27 * user/org delete endpoint in this phase).
28 */
29import { test, expect, request } from "@playwright/test";
30import type { PrismaClient } from "@prisma/client";
31import { startMockSamlIdp, type MockSamlIdp } from "../mocks/saml-idp";
32import { startMockOidc, type MockOidc } from "../mocks/oidc-issuer";
33 
34const API = process.env.E2E_API_URL ?? "http://localhost:4000";
35const WEB = process.env.E2E_BASE_URL ?? "http://localhost:3000";
36const DSN = process.env.DATABASE_URL ?? "postgresql://factory:factory@localhost:5432/factory";
37const RUN = Math.random().toString(36).slice(2, 8);
38 
39function orgName() {
40  return `sso-e2e-${RUN}`;
41}
42 
43const cleanups: Array<() => Promise<void>> = [];
44test.afterAll(async () => {
45  const { PrismaClient: PC } = await import("@prisma/client");
46  const prisma = new PC({ datasources: { db: { url: DSN } } });
47  for (const fn of cleanups.splice(0).reverse()) {
48    try {
49      await fn();
50    } catch {
51      /* best-effort */
52    }
53  }
54  await prisma.$disconnect();
55});
56 
57async function prisma(): Promise<PrismaClient> {
58  const { PrismaClient: PC } = await import("@prisma/client");
59  return new PC({ datasources: { db: { url: DSN } } });
60}
61 
62/** Set up a fresh org + team workspace owned by the given user. */
63async function setupOrg(token: string): Promise<{
64  orgId: string;
65  slug: string;
66  teamWsId: string;
67}> {
68  const orgRes = await (
69    await fetch(`${API}/api/v1/orgs`, {
70      method: "POST",
71      headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
72      body: JSON.stringify({ name: orgName() })
73    })
74  ).json();
75  const orgId = orgRes.id as string;
76  const slug = orgRes.slug as string;
77 
78  const wsRes = await (
79    await fetch(`${API}/api/v1/workspaces`, {
80      method: "POST",
81      headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
82      body: JSON.stringify({ name: `Sso Team ${RUN}` })
83    })
84  ).json();
85  const teamWsId = wsRes.id as string;
86 
87  const p = await prisma();
88  await p.workspace.update({ where: { id: teamWsId }, data: { organizationId: orgId } });
89  await p.$disconnect();
90  cleanups.push(async () => {
91    const pc = await prisma();
92    // Users we created are pruned by their own cleanup; only unlink here.
93    await pc.$transaction([
94      pc.organizationMember.deleteMany({ where: { organizationId: orgId } }),
95      pc.ssoProvider.deleteMany({ where: { organizationId: orgId } }),
96      pc.workspaceMember.deleteMany({ where: { workspaceId: teamWsId } }),
97      pc.workspace.delete({ where: { id: teamWsId } }),
98      pc.organization.delete({ where: { id: orgId } })
99    ]);
100    await pc.$disconnect();
101  });
102  return { orgId, slug, teamWsId };
103}
104 
105/** Configure a SAML provider via the admin API. */
106async function configureSaml(
107  token: string,
108  orgId: string,
109  slug: string,
110  idp: MockSamlIdp,
111  overrides?: { metadataUrl?: string; ssoUrl?: string; acsUrl?: string; entityId?: string }
112) {
113  const res = await fetch(`${API}/api/v1/orgs/${orgId}/sso`, {
114    method: "POST",
115    headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
116    body: JSON.stringify({
117      type: "SAML",
118      name: "Mock IdP",
119      certificate: idp.certPem,
120      config: {
121        entityId: overrides?.entityId ?? `${API}/saml/metadata/${slug}`,
122        ssoUrl: overrides?.ssoUrl ?? `${idp.url}/authorize`,
123        acsUrl: overrides?.acsUrl ?? `${API}/saml/acs`,
124        ...(overrides?.metadataUrl ? { metadataUrl: overrides.metadataUrl } : {})
125      }
126    })
127  });
128  expect(res.status, "saml provider create").toBe(201);
129}
130 
131async function configureOidc(token: string, orgId: string, oidc: MockOidc) {
132  const res = await fetch(`${API}/api/v1/orgs/${orgId}/sso`, {
133    method: "POST",
134    headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
135    body: JSON.stringify({
136      type: "OIDC",
137      name: "Mock OIDC",
138      clientSecret: oidc.clientSecret,
139      config: {
140        issuer: oidc.issuer,
141        clientId: oidc.clientId,
142        authorizationEndpoint: oidc.authorizationEndpoint,
143        tokenEndpoint: oidc.tokenEndpoint,
144        jwksUri: oidc.jwksUri,
145        redirectUri: `${API}/sso/oidc/${orgId}/callback`,
146        scope: "openid email profile"
147      }
148    })
149  });
150  expect(res.status, "oidc provider create").toBe(201);
151}
152 
153/** Register + log in a fresh user; returns browser page (cookie jar) + api token. */
154test.describe("TASK-0131 SSO", () => {
155  test("SAML round trip: login page → mock IdP → ACS → workspace (JIT user)", async ({ page, browser }) => {
156    const ownerEmail = `sso-owner-${RUN}@factory.local`;
157    const ownerPassword = `Pw!${RUN}owner`;
158    const ssoEmail = `sso-jit-${RUN}@factory.local`;
159 
160    const ownerCtx = await request.newContext();
161    const reg = await ownerCtx.post(`${API}/api/v1/auth/register`, {
162      data: { name: "Sso Owner", email: ownerEmail, password: ownerPassword }
163    });
164    expect(reg.status()).toBe(201);
165    const login = await ownerCtx.post(`${API}/api/v1/auth/login`, {
166      data: { email: ownerEmail, password: ownerPassword }
167    });
168    expect(login.status()).toBe(200);
169    const token = ((await login.json()) as { accessToken: string }).accessToken;
170    const { orgId, slug, teamWsId } = await setupOrg(token);
171 
172    // IdP auto-approves as the JIT user.
173    const idp = await startMockSamlIdp({
174      acsUrl: `${API}/saml/acs`,
175      spEntityId: `${API}/saml/metadata/${slug}`,
176      user: { nameId: ssoEmail, email: ssoEmail, displayName: "Jit Doe" }
177    });
178    cleanups.push(() => idp.close());
179    await configureSaml(token, orgId, slug, idp, { metadataUrl: idp.metadataUrl });
180 
181    // ---- the browser flow (anonymous) ----
182    await page.goto(`${WEB}/login`);
183    await page.getByTestId("auth-email").fill(ssoEmail);
184    // The anonymous discovery must surface the org (it resolves via the
185    // org's members... a JIT user has no membership YET — the login page's
186    // SSO button appears for MEMBERS. For a brand-new email the discovery
187    // returns [] — so the round trip is started the way an org member (or
188    // a link) would: the start dispatcher directly. The spec's "click Sign
189    // in with SSO" path is covered by the owner below; the JIT entry is
190    // the dispatcher (the same URL the button navigates to).
191    const startUrl = `${API}/sso/start/${slug}`;
192    // 1) dispatcher → SAML start → IdP /authorize (200 HTML, auto-submits a
193    // form-POST to the ACS) → ACS 302s to the WEB landing (/w/default →
194    // first workspace). Wait for the IdP page, then the app landing.
195    await page.goto(startUrl);
196    await page.waitForURL(new RegExp("127\\.0\\.0\\.1:\\d+/authorize"), { timeout: 15_000 });
197    await page.waitForURL(`${WEB}/w/**`, { timeout: 25_000 });
198    // Landed in the org's team workspace (the only non-personal ws the user
199    // is a member of — /w/default resolves to the FIRST by createdAt, which
200    // is the personal ws; assert the team ws is reachable + the page loads).
201    await page.goto(`${WEB}/w/${teamWsId}`);
202    await page.waitForSelector('main, [data-testid="user-menu"]', { timeout: 20_000 });
203    const wsCookies = await page.context().cookies(`${API}`);
204    expect(wsCookies.some((c) => c.name === "factory_refresh")).toBe(true);
205 
206    // ---- DB assertions (JIT + identity + membership + audit) ----
207    const p = await prisma();
208    const user = await p.user.findUnique({ where: { email: ssoEmail } });
209    expect(user, "JIT user created").toBeTruthy();
210    expect(user?.passwordHash).toBeNull();
211    expect(user?.emailVerification).toBe("VERIFIED");
212    const identity = await p.ssoIdentity.findFirst({ where: { userId: user!.id, externalId: ssoEmail } });
213    expect(identity, "SsoIdentity linked").toBeTruthy();
214    const orgMember = await p.organizationMember.findUnique({
215      where: { organizationId_userId: { organizationId: orgId, userId: user!.id } }
216    });
217    expect(orgMember?.role, "org membership MEMBER").toBe("MEMBER");
218    const wsMember = await p.workspaceMember.findUnique({
219      where: { workspaceId_userId: { workspaceId: teamWsId, userId: user!.id } }
220    });
221    expect(wsMember, "auto-joined team workspace").toBeTruthy();
222    const audit = await p.auditLog.findFirst({
223      where: { action: "sso.login.saml", resourceId: user!.id }
224    });
225    expect(audit, "sso.login.saml audit").toBeTruthy();
226    expect(audit?.ipAddress).toBeTruthy();
227    expect(audit?.userAgent).toBeTruthy();
228    const before = (await p.user.count({ where: { email: ssoEmail } })) as number;
229    await p.$disconnect();
230 
231    // ---- second login reuses the same user (no duplicate) ----
232    const page2 = await (await browser.newContext()).newPage();
233    await page2.goto(startUrl);
234    await page2.waitForURL(`${WEB}/w/**`, { timeout: 20_000 });
235    const p2 = await prisma();
236    const after = await p2.user.count({ where: { email: ssoEmail } });
237    const auditCount = await p2.auditLog.count({ where: { action: "sso.login.saml", resourceId: user!.id } });
238    await p2.$disconnect();
239    expect(after, "no duplicate JIT user").toBe(before);
240    expect(auditCount).toBe(2);
241    await page2.context().close();
242 
243    // ---- the LOGIN-PAGE discovery path (org MEMBER sees the SSO button) ----
244    const page3 = await (await browser.newContext()).newPage();
245    await page3.goto(`${WEB}/login`);
246    await page3.getByTestId("auth-email").fill(ssoEmail);
247    // debounce 350ms + discovery round trip
248    await expect(page3.getByTestId("sso-start"), "login page shows SSO button").toBeVisible({
249      timeout: 10_000
250    });
251    await page3.context().close();
252    await ownerCtx.dispose();
253  });
254 
255  test("SAML ACS tamper matrix → correct sso_<reason> + audit", async () => {
256    const ownerEmail = `sso-matrix-${RUN}@factory.local`;
257    const ownerPassword = `Pw!${RUN}matrix`;
258    const ctx = await request.newContext();
259    await ctx.post(`${API}/api/v1/auth/register`, {
260      data: { name: "Matrix Owner", email: ownerEmail, password: ownerPassword }
261    });
262    const login = await ctx.post(`${API}/api/v1/auth/login`, {
263      data: { email: ownerEmail, password: ownerPassword }
264    });
265    const token = ((await login.json()) as { accessToken: string }).accessToken;
266    const { orgId, slug } = await setupOrg(token);
267 
268    const mkIdp = () =>
269      startMockSamlIdp({
270        acsUrl: `${API}/saml/acs`,
271        spEntityId: `${API}/saml/metadata/${slug}`,
272        user: { nameId: `matrix-${RUN}@factory.local`, email: `matrix-${RUN}@factory.local` }
273      });
274 
275    // expired
276    {
277      const idp = await mkIdp();
278      cleanups.push(() => idp.close());
279      await configureSaml(token, orgId, slug, idp);
280      const resp = await idp.buildAuthnResponse({ notOnOrAfterOffsetMs: -120_000 });
281      const loc = await postAcs(ctx, resp);
282      expect(loc, "expired").toContain("sso_expired");
283    }
284    // non-success status
285    {
286      const idp = await startMockSamlIdp({
287        acsUrl: `${API}/saml/acs`,
288        spEntityId: `${API}/saml/metadata/${slug}`,
289        statusValue: "urn:oasis:names:tc:SAML:2.0:status:Requester",
290        user: { nameId: `x-${RUN}@factory.local` }
291      });
292      cleanups.push(() => idp.close());
293      await deleteProvider(token, orgId);
294      await configureSaml(token, orgId, slug, idp);
295      const resp = await idp.buildAuthnResponse();
296      const loc = await postAcs(ctx, resp);
297      expect(loc, "non-success").toContain("sso_status_not_success");
298    }
299    // cert mismatch (rogue key signs + presents a cert the org did not configure)
300    {
301      const idp = await startMockSamlIdp({
302        acsUrl: `${API}/saml/acs`,
303        spEntityId: `${API}/saml/metadata/${slug}`,
304        rogueKey: true,
305        user: { nameId: `y-${RUN}@factory.local` }
306      });
307      cleanups.push(() => idp.close());
308      await deleteProvider(token, orgId);
309      await configureSaml(token, orgId, slug, idp);
310      const resp = await idp.buildAuthnResponse();
311      const loc = await postAcs(ctx, resp);
312      expect(loc, "cert mismatch").toContain("sso_cert_mismatch");
313    }
314    // replay (same Response ID twice)
315    {
316      const idp = await startMockSamlIdp({
317        acsUrl: `${API}/saml/acs`,
318        spEntityId: `${API}/saml/metadata/${slug}`,
319        responseId: `_${RUN}_fixed`,
320        user: { nameId: `z-${RUN}@factory.local` }
321      });
322      cleanups.push(() => idp.close());
323      await deleteProvider(token, orgId);
324      await configureSaml(token, orgId, slug, idp);
325      const resp = await idp.buildAuthnResponse();
326      const first = await postAcs(ctx, resp);
327      // Success → 302 to the RelayState ("/" → the web home).
328      expect(first, "first use ok").toBe(`${WEB}/`);
329      const second = await postAcs(ctx, resp);
330      expect(second, "replay rejected").toContain("sso_replayed");
331    }
332    // bad signature (signed with one key, presents a DIFFERENT valid cert)
333    {
334      const good = await mkIdp();
335      const signer = await mkIdp(); // different keypair
336      cleanups.push(() => good.close(), () => signer.close());
337      await deleteProvider(token, orgId);
338      // configure with the GOOD cert; the response is signed by the signer.
339      await configureSaml(token, orgId, slug, good);
340      const resp = await signer.buildAuthnResponse();
341      const loc = await postAcs(ctx, resp);
342      // The signer's cert is not configured → cert binding fails first.
343      expect(loc, "unconfigured signer").toContain("sso_cert_mismatch");
344    }
345    // audit rows for the failures
346    const p = await prisma();
347    const failures = await p.auditLog.findMany({
348      where: { action: "sso.login_failed", resourceType: "user", resourceId: { contains: RUN } },
349      select: { metadata: true }
350    });
351    await p.$disconnect();
352    const reasons = failures.map((f) => (f.metadata as { reason?: string }).reason);
353    expect(reasons).toEqual(
354      expect.arrayContaining(["expired", "status_not_success", "cert_mismatch", "cert_mismatch", "replayed"])
355    );
356    await ctx.dispose();
357  });
358 
359  test("OIDC round trip: authorize → callback → session", async () => {
360    const ownerEmail = `sso-oidc-${RUN}@factory.local`;
361    const ownerPassword = `Pw!${RUN}oidc`;
362    const ssoEmail = `sso-oidc-user-${RUN}@factory.local`;
363    const ctx = await request.newContext();
364    await ctx.post(`${API}/api/v1/auth/register`, {
365      data: { name: "Oidc Owner", email: ownerEmail, password: ownerPassword }
366    });
367    const login = await ctx.post(`${API}/api/v1/auth/login`, {
368      data: { email: ownerEmail, password: ownerPassword }
369    });
370    const token = ((await login.json()) as { accessToken: string }).accessToken;
371    const { orgId } = await setupOrg(token);
372 
373    const oidc = await startMockOidc({
374      clientId: `cli_sso_${RUN}`,
375      clientSecret: `sec_${RUN}_client_secret`,
376      initialBehavior: { sub: `sub_${RUN}`, email: ssoEmail, name: "Oidc User" }
377    });
378    cleanups.push(() => oidc.close());
379    await configureOidc(token, orgId, oidc);
380 
381    // authorize → 302 to the IdP (Playwright follows); the IdP 302s back to
382    // the API callback with code+state; the callback exchanges + provisions
383    // + 302s to the WEB landing.
384    // Walk the redirect chain hop-by-hop (maxRedirects: 0) so the exact
385    // Set-Cookie on the CALLBACK hop is visible (a followed redirect would
386    // surface only the final web-app response's headers).
387    const authz = await ctx.get(`${API}/sso/oidc/${orgId}/authorize`, { maxRedirects: 0 });
388    expect(authz.status(), "RP → IdP authorize").toBe(302);
389    const idpAuthUrl = authz.headers()["location"] ?? "";
390    expect(idpAuthUrl, "targets the mock IdP").toContain(oidc.url);
391 
392    const idpHop = await ctx.get(idpAuthUrl, { maxRedirects: 0 });
393    expect(idpHop.status(), "IdP auto-approve → callback").toBe(302);
394    const cbUrl = idpHop.headers()["location"] ?? "";
395    expect(cbUrl, "callback on the API origin").toContain(`${API}/sso/oidc/${orgId}/callback`);
396 
397    const cb = await ctx.get(cbUrl, { maxRedirects: 0 });
398    expect(cb.status(), "callback → WEB landing").toBe(302);
399    expect(cb.headers()["location"]).toContain(`${WEB}/w/`);
400    expect(cb.headers()["set-cookie"] ?? "", "session cookie set").toContain("factory_refresh=");
401 
402    const p = await prisma();
403    const user = await p.user.findUnique({ where: { email: ssoEmail } });
404    expect(user, "OIDC JIT user").toBeTruthy();
405    expect(user?.passwordHash).toBeNull();
406    const identity = await p.ssoIdentity.findFirst({ where: { userId: user!.id, externalId: `sub_${RUN}` } });
407    expect(identity, "SsoIdentity from sub").toBeTruthy();
408    const audit = await p.auditLog.findFirst({
409      where: { action: "sso.login.oidc", resourceId: user!.id }
410    });
411    expect(audit, "sso.login.oidc audit").toBeTruthy();
412    await p.$disconnect();
413    await ctx.dispose();
414  });
415 
416  test("enforce mode: 403 sso_required for org user; non-org user unaffected", async () => {
417    const orgUserEmail = `sso-enf-${RUN}@factory.local`;
418    const orgPassword = `Pw!${RUN}enf`;
419    const otherEmail = `sso-free-${RUN}@factory.local`;
420    const otherPassword = `Pw!${RUN}free`;
421    const ctx = await request.newContext();
422    await ctx.post(`${API}/api/v1/auth/register`, {
423      data: { name: "Enf Owner", email: orgUserEmail, password: orgPassword }
424    });
425    const login = await ctx.post(`${API}/api/v1/auth/login`, {
426      data: { email: orgUserEmail, password: orgPassword }
427    });
428    const token = ((await login.json()) as { accessToken: string }).accessToken;
429    const { orgId, slug } = await setupOrg(token);
430 
431    // A non-org user registers separately (no org membership).
432    await ctx.post(`${API}/api/v1/auth/register`, {
433      data: { name: "Free User", email: otherEmail, password: otherPassword }
434    });
435 
436    const idp = await startMockSamlIdp({
437      acsUrl: `${API}/saml/acs`,
438      spEntityId: `${API}/saml/metadata/${slug}`,
439      user: { nameId: orgUserEmail, email: orgUserEmail }
440    });
441    cleanups.push(() => idp.close());
442    await configureSaml(token, orgId, slug, idp);
443 
444    // Enforce ON.
445    const enf = await fetch(`${API}/api/v1/orgs/${orgId}/sso/enforce`, {
446      method: "PATCH",
447      headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
448      body: JSON.stringify({ enforce: true })
449    });
450    expect(enf.status).toBe(200);
451    const org = await (await fetch(`${API}/api/v1/orgs/${orgId}`, {
452      headers: { authorization: `Bearer ${token}` }
453    })).json();
454    expect((org.policy as { ssoEnforced?: boolean }).ssoEnforced, "policy mirror").toBe(true);
455 
456    // The org user's password login is now refused.
457    const refused = await ctx.post(`${API}/api/v1/auth/login`, {
458      data: { email: orgUserEmail, password: orgPassword }
459    });
460    expect(refused.status(), "org user 403").toBe(403);
461    const refusedBody = (await refused.json()) as {
462      error: { code: string; details?: Array<{ reason?: string; orgs?: string[] }> };
463    };
464    expect(refusedBody.error.details?.[0]?.reason).toBe("sso_required");
465    expect(refusedBody.error.details?.[0]?.orgs).toEqual([slug]);
466 
467    // A user with NO org membership is unaffected.
468    const free = await ctx.post(`${API}/api/v1/auth/login`, {
469      data: { email: otherEmail, password: otherPassword }
470    });
471    expect(free.status(), "non-org user OK").toBe(200);
472 
473    // ---- lockout-recovery runbook (the support flow) ----
474    // The owner is now password-blocked. The documented recovery path:
475    // sign in THROUGH the SSO (the enforce gate only blocks the PASSWORD
476    // path — SSO login is never refused for an enforced org), then turn
477    // enforce off with the (already-valid) session.
478    // start dispatcher → the SAML start redirect (SP-initiated hop toward
479    // the IdP's ssoUrl) — proves the SSO path stays open under enforce.
480    const recovery = await ctx.get(`${API}/sso/start/${slug}`, { maxRedirects: 0 });
481    expect(recovery.status(), "owner recovers via SSO").toBe(302);
482    expect(recovery.headers()["location"]).toContain(`${API}/saml/start/${slug}`);
483 
484    // Enforce OFF via the pre-enforcement session → password login works.
485    const unenf = await fetch(`${API}/api/v1/orgs/${orgId}/sso/enforce`, {
486      method: "PATCH",
487      headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
488      body: JSON.stringify({ enforce: false })
489    });
490    expect(unenf.status).toBe(200);
491    const back = await ctx.post(`${API}/api/v1/auth/login`, {
492      data: { email: orgUserEmail, password: orgPassword }
493    });
494    expect(back.status(), "un-enforced again").toBe(200);
495    await ctx.dispose();
496  });
497 
498  test("admin SSO tabs: configure SAML, test-connection green, enforce badge", async ({ page }) => {
499    const ownerEmail = `sso-ui-${RUN}@factory.local`;
500    const ownerPassword = `Pw!${RUN}ui`;
501    // Register + login through the BROWSER context so the refresh cookie
502    // lands in its jar (the admin route is session-gated on the web origin).
503    const regRes = await page.request.post(`${API}/api/v1/auth/register`, {
504      data: { name: "Ui Owner", email: ownerEmail, password: ownerPassword }
505    });
506    expect(regRes.status(), "register owner").toBe(201);
507    const loginRes = await page.request.post(`${API}/api/v1/auth/login`, {
508      data: { email: ownerEmail, password: ownerPassword }
509    });
510    expect(loginRes.status(), "login owner").toBe(200);
511    const owner = (await loginRes.json() as { accessToken: string }).accessToken;
512    const orgRes = await (
513      await fetch(`${API}/api/v1/orgs`, {
514        method: "POST",
515        headers: { "content-type": "application/json", authorization: `Bearer ${owner}` },
516        body: JSON.stringify({ name: `sso-ui-${RUN}` })
517      })
518    ).json();
519    const orgId = orgRes.id as string;
520    const slug = orgRes.slug as string;
521 
522    const idp = await startMockSamlIdp({
523      acsUrl: `${API}/saml/acs`,
524      spEntityId: `${API}/saml/metadata/${slug}`,
525      user: { nameId: `ui-${RUN}@factory.local` }
526    });
527    cleanups.push(() => idp.close());
528 
529    // The standalone admin route renders the SSO tabs.
530    await page.goto(`${WEB}/org/${orgId}/admin/integrations`);
531    await expect(page.getByText("No SSO provider configured yet")).toBeVisible({ timeout: 15_000 });
532    await page.getByRole("button", { name: /Configure SSO/ }).click();
533 
534    // Fill the SAML form (cert from the mock IdP; metadataUrl → probe green).
535    await page.getByRole("button", { name: "SAML 2.0" }).click();
536    await page.getByLabel("Display name").fill("Mock IdP (E2E)");
537    await page.getByLabel("SP entity ID").fill(`${API}/saml/metadata/${slug}`);
538    await page.getByLabel("IdP SSO URL").fill(`${idp.url}/authorize`);
539    await page.getByLabel("ACS URL").fill(`${API}/saml/acs`);
540    await page.getByTestId("sso-metadata-url").fill(idp.metadataUrl);
541    const certField = page.locator("textarea").first();
542    await certField.fill(idp.certPem);
543    await page.getByTestId("sso-save").click();
544 
545    // Provider set → summary + actions.
546    await expect(page.getByText("Mock IdP (E2E)")).toBeVisible({ timeout: 15_000 });
547    await expect(page.getByTestId("sso-enforce-toggle")).toBeVisible();
548 
549    // Test connection → green panel (scoped by testid — the toast region
550    // also carries role="status").
551    await page.getByTestId("sso-test").click();
552    await expect(page.getByTestId("sso-test-result")).toContainText("Connected", { timeout: 20_000 });
553 
554    // Enforce toggle → confirm → badge.
555    await page.getByTestId("sso-enforce-toggle").click();
556    await page.getByRole("dialog").getByRole("button", { name: "Enforce" }).click();
557    // exact: the success toast also reads "SSO enforce ON" while it is up.
558    await expect(page.getByText("Enforce ON", { exact: true })).toBeVisible({ timeout: 15_000 });
559  });
560});
561 
562async function postAcs(
563  ctx: Awaited<ReturnType<typeof request.newContext>>,
564  samlResponse: string
565): Promise<string> {
566  const res = await ctx.post(`${API}/saml/acs`, {
567    form: { SAMLResponse: Buffer.from(samlResponse, "utf8").toString("base64"), RelayState: "/" },
568    maxRedirects: 0
569  });
570  expect(res.status(), "ACS 302").toBe(302);
571  return res.headers()["location"] ?? "";
572}
573 
574async function deleteProvider(token: string, orgId: string) {
575  await fetch(`${API}/api/v1/orgs/${orgId}/sso`, {
576    method: "DELETE",
577    headers: { authorization: `Bearer ${token}` }
578  });
579}
580