.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
filter-builder.tsxapps/web/src/components/database/filter-builder.tsxraw← database19,997 B← Back to the app
1"use client";
2 
3/**
4 * FilterBuilder — nested AND/OR/NOT filter tree editor (PRODUCT-SPEC §9.3).
5 *
6 * Produces exactly the documented wire shape (docs/api/databases.md §5.3):
7 *   { op: "and"|"or"|"not", conditions: (group|condition)[] }
8 *   { propertyId, op, value }
9 * Evaluation happens server-side / in @factory/database-engine — this file
10 * only builds and edits the tree. Live "N records match" preview is provided
11 * by the parent (DatabaseToolbar), which re-fetches useDatabaseRecords.
12 */
13import { useMemo, useState } from "react";
14import { ChevronDown, Plus, Trash2, X } from "lucide-react";
15import { cn } from "@/lib/utils";
16import {
17  DatabaseProperty,
18  FilterCondition,
19  FilterGroup,
20  FilterTree,
21  isCondition,
22  SelectOption
23} from "@/hooks/use-database";
24 
25// ---------------------------------------------------------------------------
26// Operator catalog per property kind (docs/api/databases.md §5.3)
27// ---------------------------------------------------------------------------
28 
29export interface OpDef {
30  op: string;
31  label: string;
32  /** Which value input the condition needs. */
33  needs: "none" | "text" | "number" | "option" | "options" | "date" | "dateRange" | "days" | "boolean" | "person";
34}
35 
36const TEXT_OPS: OpDef[] = [
37  { op: "contains", label: "Contains", needs: "text" },
38  { op: "does_not_contain", label: "Does not contain", needs: "text" },
39  { op: "starts_with", label: "Starts with", needs: "text" },
40  { op: "ends_with", label: "Ends with", needs: "text" },
41  { op: "is", label: "Is", needs: "text" },
42  { op: "is_not", label: "Is not", needs: "text" }
43];
44const NUMBER_OPS: OpDef[] = [
45  { op: "equals", label: "Equals", needs: "number" },
46  { op: "not_equals", label: "Does not equal", needs: "number" },
47  { op: "greater_than", label: "Greater than", needs: "number" },
48  { op: "less_than", label: "Less than", needs: "number" },
49  { op: "greater_or_equal", label: "Greater than or equal to", needs: "number" },
50  { op: "less_or_equal", label: "Less than or equal to", needs: "number" }
51];
52const OPTION_OPS: OpDef[] = [
53  { op: "equals", label: "Is", needs: "option" },
54  { op: "not_equals", label: "Is not", needs: "option" },
55  { op: "contains_any", label: "Contains any", needs: "options" },
56  { op: "contains_all", label: "Contains all", needs: "options" }
57];
58const DATE_OPS: OpDef[] = [
59  { op: "equals", label: "Is on date", needs: "date" },
60  { op: "before", label: "Is before", needs: "date" },
61  { op: "after", label: "Is after", needs: "date" },
62  { op: "between", label: "Is between", needs: "dateRange" },
63  { op: "on_or_before", label: "Is on or before", needs: "date" },
64  { op: "on_or_after", label: "Is on or after", needs: "date" },
65  { op: "is_this_week", label: "Is this week", needs: "none" },
66  { op: "is_this_month", label: "Is this month", needs: "none" },
67  { op: "within_next_days", label: "Is within next", needs: "days" },
68  { op: "is_past", label: "Is in the past", needs: "none" },
69  { op: "is_future", label: "Is in the future", needs: "none" }
70];
71const PERSON_OPS: OpDef[] = [
72  { op: "contains_any", label: "Contains any", needs: "person" },
73  { op: "contains_all", label: "Contains all", needs: "person" },
74  { op: "is_current_user", label: "Is me", needs: "none" }
75];
76const CHECKBOX_OPS: OpDef[] = [
77  { op: "is", label: "Is", needs: "boolean" },
78  { op: "is_not", label: "Is not", needs: "boolean" }
79];
80const EMPTY_OPS: OpDef[] = [
81  { op: "is_empty", label: "Is empty", needs: "none" },
82  { op: "is_not_empty", label: "Is not empty", needs: "none" }
83];
84 
85export function opsForProperty(p: DatabaseProperty): OpDef[] {
86  const empties: OpDef[] = [{ op: "is_empty", label: "Is empty", needs: "none" }, { op: "is_not_empty", label: "Is not empty", needs: "none" }];
87  switch (p.type) {
88    case "title":
89    case "text":
90    case "rich_text":
91    case "email":
92    case "url":
93      return [...TEXT_OPS, ...empties];
94    case "number":
95    case "rollup":
96    case "formula":
97      return [...NUMBER_OPS, ...empties];
98    case "select":
99    case "status":
100      return [...OPTION_OPS, ...empties];
101    case "multi_select":
102    case "relation":
103      return [...OPTION_OPS, ...empties].map((o) => (o.needs === "option" ? { ...o, needs: "options" as const } : o));
104    case "date":
105    case "date_range":
106      return [...DATE_OPS, ...empties];
107    case "person":
108      return [...PERSON_OPS, ...empties];
109    case "checkbox":
110      return CHECKBOX_OPS;
111    case "files":
112      return EMPTY_OPS;
113    default:
114      return empties;
115  }
116}
117 
118/** Filterable properties (every type has at least an emptiness test). */
119export function filterableProperties(properties: DatabaseProperty[]): DatabaseProperty[] {
120  return properties;
121}
122 
123// ---------------------------------------------------------------------------
124// Default value per needs
125// ---------------------------------------------------------------------------
126 
127function defaultValue(needs: OpDef["needs"]): Record<string, unknown> | undefined {
128  switch (needs) {
129    case "text":
130      return { text: "" };
131    case "number":
132      return { value: 0 };
133    case "option":
134      return { optionId: "" };
135    case "options":
136      return { optionIds: [] };
137    case "person":
138      return { userIds: [] };
139    case "date":
140      return { value: new Date().toISOString() };
141    case "dateRange":
142      return { start: "", end: "" };
143    case "days":
144      return { days: 7 };
145    case "boolean":
146      return { value: true };
147    default:
148      return undefined;
149  }
150}
151 
152// ---------------------------------------------------------------------------
153// Value input (per needs)
154// ---------------------------------------------------------------------------
155 
156const inputCls =
157  "rounded border border-input bg-background px-1.5 py-0.5 text-xs outline-none focus-visible:ring-1 focus-visible:ring-ring";
158 
159function ValueInput({
160  needs,
161  property,
162  value,
163  onChange
164}: {
165  needs: OpDef["needs"];
166  property: DatabaseProperty;
167  value?: Record<string, unknown>;
168  onChange: (v: Record<string, unknown> | undefined) => void;
169}) {
170  if (needs === "none") return <span className="text-xs text-muted-foreground">—</span>;
171  if (needs === "text") {
172    return (
173      <input
174        className={cn(inputCls, "w-32")}
175        value={String(value?.text ?? "")}
176        placeholder="Value"
177        onChange={(e) => onChange({ text: e.target.value })}
178      />
179    );
180  }
181  if (needs === "number" || needs === "days") {
182    const key = needs === "days" ? "days" : "value";
183    return (
184      <input
185        type="number"
186        className={cn(inputCls, "w-20")}
187        value={Number(value?.[key] ?? 0)}
188        onChange={(e) => onChange({ [key]: Number(e.target.value) })}
189      />
190    );
191  }
192  if (needs === "option") {
193    const options = property.config.options ?? [];
194    return (
195      <select
196        className={cn(inputCls, "w-36")}
197        value={String(value?.optionId ?? "")}
198        onChange={(e) => onChange({ optionId: e.target.value || undefined })}
199      >
200        <option value="">Select…</option>
201        {options.map((o: SelectOption) => (
202          <option key={o.id} value={o.id}>
203            {o.name}
204          </option>
205        ))}
206      </select>
207    );
208  }
209  if (needs === "options") {
210    const options = property.config.options ?? [];
211    const selected = (value?.optionIds as string[] | undefined) ?? [];
212    return (
213      <select
214        multiple
215        className={cn(inputCls, "h-16 w-36")}
216        value={selected}
217        onChange={(e) => {
218          const ids = Array.from(e.target.selectedOptions).map((o) => o.value);
219          onChange({ optionIds: ids });
220        }}
221      >
222        {options.map((o) => (
223          <option key={o.id} value={o.id}>
224            {o.name}
225          </option>
226        ))}
227      </select>
228    );
229  }
230  if (needs === "date" || needs === "dateRange") {
231    const type = property.config.includeTime ? "datetime-local" : "date";
232    if (needs === "dateRange") {
233      const toLocal = (iso?: string) => (iso ? String(iso).slice(0, 10) : "");
234      return (
235        <span className="inline-flex items-center gap-1">
236          <input
237            type="date"
238            className={inputCls}
239            value={toLocal(String(value?.start ?? ""))}
240            onChange={(e) => onChange({ ...value, start: e.target.value })}
241          />
242          <span className="text-xs">–</span>
243          <input
244            type="date"
245            className={inputCls}
246            value={toLocal(String(value?.end ?? ""))}
247            onChange={(e) => onChange({ ...value, end: e.target.value })}
248          />
249        </span>
250      );
251    }
252    return (
253      <input
254        type={type}
255        className={inputCls}
256        value={String(value?.value ?? "").slice(0, type === "datetime-local" ? 16 : 10)}
257        onChange={(e) => onChange({ value: e.target.value })}
258      />
259    );
260  }
261  if (needs === "boolean") {
262    return (
263      <select
264        className={cn(inputCls, "w-20")}
265        value={value?.value ? "true" : "false"}
266        onChange={(e) => onChange({ value: e.target.value === "true" })}
267      >
268        <option value="true">True</option>
269        <option value="false">False</option>
270      </select>
271    );
272  }
273  if (needs === "person") {
274    // Compact: comma-separated user ids is not friendly — use a text input
275    // that stores known member ids; the toolbar passes the workspace members
276    // via a data-attribute when available.
277    const ids = (value?.userIds as string[] | undefined) ?? [];
278    return (
279      <input
280        className={cn(inputCls, "w-40")}
281        placeholder="member id(s), comma-separated"
282        value={ids.join(", ")}
283        onChange={(e) =>
284          onChange({
285            userIds: e.target.value.split(",").map((s) => s.trim()).filter(Boolean)
286          })
287        }
288      />
289    );
290  }
291  return null;
292}
293 
294// ---------------------------------------------------------------------------
295// Tree editing helpers (immutable)
296// ---------------------------------------------------------------------------
297 
298type Node = FilterGroup | FilterCondition;
299 
300function isGroupNode(n: Node): n is FilterGroup {
301  return !isCondition(n);
302}
303 
304function updateGroup(
305  group: FilterGroup,
306  predicate: (node: Node) => boolean,
307  update: (node: Node) => Node | null
308): FilterGroup | null {
309  const next: Node[] = [];
310  for (const child of group.conditions) {
311    if (predicate(child)) {
312      const u = update(child);
313      if (u != null) next.push(u);
314    } else if (isGroupNode(child)) {
315      const u = updateGroup(child, predicate, update);
316      if (u != null) next.push(u);
317    } else {
318      next.push(child);
319    }
320  }
321  if (next.length === 0 && group.op !== "not") return null;
322  return { ...group, conditions: next };
323}
324 
325function addNode(tree: FilterTree | null, newNode: Node): FilterTree {
326  if (!tree) {
327    return { op: "and", conditions: [newNode] };
328  }
329  if (isCondition(tree)) {
330    return { op: "and", conditions: [tree, newNode] };
331  }
332  return { ...tree, conditions: [...tree.conditions, newNode] };
333}
334 
335function nodeKey(node: Node, index: number): string {
336  if (isCondition(node)) return `c${index}:${node.propertyId}:${node.op}`;
337  return `g${index}:${node.op}`;
338}
339 
340// ---------------------------------------------------------------------------
341// Condition row
342// ---------------------------------------------------------------------------
343 
344function ConditionRow({
345  condition,
346  properties,
347  onChange,
348  onRemove
349}: {
350  condition: FilterCondition;
351  properties: DatabaseProperty[];
352  onChange: (c: FilterCondition | null) => void;
353  onRemove: () => void;
354}) {
355  const property = properties.find((p) => p.id === condition.propertyId) ?? properties[0];
356  const ops = useMemo(() => (property ? opsForProperty(property) : []), [property]);
357  const opDef = ops.find((o) => o.op === condition.op) ?? ops[0];
358 
359  if (!property) return null;
360 
361  return (
362    <div className="flex flex-wrap items-center gap-1.5 py-1">
363      <select
364        className={cn(inputCls, "w-32")}
365        value={property.id}
366        onChange={(e) => {
367          const p = properties.find((x) => x.id === e.target.value);
368          const firstOp = p ? opsForProperty(p)[0] : undefined;
369          onChange({
370            propertyId: e.target.value,
371            op: firstOp?.op ?? "is_empty",
372            value: firstOp ? defaultValue(firstOp.needs) : undefined
373          });
374        }}
375        aria-label="Property"
376      >
377        {properties.map((p) => (
378          <option key={p.id} value={p.id}>
379            {p.name}
380          </option>
381        ))}
382      </select>
383      <select
384        className={cn(inputCls, "w-40")}
385        value={opDef?.op ?? ""}
386        onChange={(e) => {
387          const d = ops.find((o) => o.op === e.target.value);
388          onChange({ ...condition, op: e.target.value, value: d ? defaultValue(d.needs) : undefined });
389        }}
390        aria-label="Condition"
391      >
392        {ops.map((o) => (
393          <option key={o.op} value={o.op}>
394            {o.label}
395          </option>
396        ))}
397      </select>
398      <ValueInput
399        needs={opDef?.needs ?? "none"}
400        property={property}
401        value={condition.value}
402        onChange={(v) => onChange({ ...condition, value: v })}
403      />
404      <button
405        type="button"
406        className="rounded p-0.5 text-muted-foreground hover:bg-muted hover:text-destructive"
407        onClick={onRemove}
408        aria-label="Remove condition"
409      >
410        <X className="size-3.5" />
411      </button>
412    </div>
413  );
414}
415 
416// ---------------------------------------------------------------------------
417// Group block (recursive)
418// ---------------------------------------------------------------------------
419 
420function GroupBlock({
421  group,
422  depth,
423  properties,
424  onChange,
425  onRemove
426}: {
427  group: FilterGroup;
428  depth: number;
429  properties: DatabaseProperty[];
430  onChange: (g: FilterGroup | null) => void;
431  onRemove?: () => void;
432}) {
433  const [collapsed, setCollapsed] = useState(depth > 0);
434  const addCondition = () => {
435    const p = properties[0];
436    if (!p) return;
437    const op = opsForProperty(p)[0];
438    onChange({
439      ...group,
440      conditions: [
441        ...group.conditions,
442        { propertyId: p.id, op: op.op, value: defaultValue(op.needs) }
443      ]
444    });
445  };
446  const addGroup = () => {
447    onChange({
448      ...group,
449      conditions: [...group.conditions, { op: "or", conditions: [] }]
450    });
451  };
452 
453  return (
454    <div className={cn("rounded-md border", depth > 0 && "bg-muted/30 p-1.5")}>
455      <div className="flex items-center gap-2 py-1">
456        <button
457          type="button"
458          className="text-muted-foreground hover:text-foreground"
459          onClick={() => setCollapsed((c) => !c)}
460          aria-label={collapsed ? "Expand group" : "Collapse group"}
461        >
462          <ChevronDown className={cn("size-3.5 transition-transform", collapsed && "-rotate-90")} />
463        </button>
464        <select
465          className={cn(inputCls, "w-16 font-medium")}
466          value={group.op}
467          onChange={(e) => onChange({ ...group, op: e.target.value as FilterGroup["op"] })}
468          aria-label="Group operator"
469        >
470          <option value="and">AND</option>
471          <option value="or">OR</option>
472          {depth > 0 && <option value="not">NOT</option>}
473        </select>
474        <span className="text-xs text-muted-foreground">
475          {group.conditions.filter(isCondition).length} condition(s)
476        </span>
477        {onRemove && (
478          <button
479            type="button"
480            className="ml-auto rounded p-0.5 text-muted-foreground hover:bg-muted hover:text-destructive"
481            onClick={onRemove}
482            aria-label="Remove group"
483          >
484            <Trash2 className="size-3.5" />
485          </button>
486        )}
487      </div>
488      {!collapsed && (
489        <div className="pl-5">
490          {group.conditions.map((node, i) =>
491            isGroupNode(node) ? (
492              <GroupBlock
493                key={nodeKey(node, i)}
494                group={node}
495                depth={depth + 1}
496                properties={properties}
497                onChange={(g) =>
498                  onChange(
499                    updateGroup(group, (n) => n === node, () => g) ?? group
500                  )
501                }
502                onRemove={() =>
503                  onChange(
504                    updateGroup(group, (n) => n === node, () => null) ?? group
505                  )
506                }
507              />
508            ) : (
509              <ConditionRow
510                key={nodeKey(node, i)}
511                condition={node}
512                properties={properties}
513                onChange={(c) =>
514                  onChange(
515                    updateGroup(group, (n) => n === node, () => c) ?? group
516                  )
517                }
518                onRemove={() =>
519                  onChange(
520                    updateGroup(group, (n) => n === node, () => null) ?? group
521                  )
522                }
523              />
524            )
525          )}
526          <div className="flex items-center gap-2 py-1">
527            <button type="button" className="inline-flex items-center gap-1 rounded px-1.5 py-0.5 text-xs text-primary hover:bg-muted" onClick={addCondition}>
528              <Plus className="size-3" /> Add condition
529            </button>
530            <button type="button" className="inline-flex items-center gap-1 rounded px-1.5 py-0.5 text-xs text-primary hover:bg-muted" onClick={addGroup}>
531              <Plus className="size-3" /> Add group
532            </button>
533          </div>
534        </div>
535      )}
536    </div>
537  );
538}
539 
540// ---------------------------------------------------------------------------
541// Public component
542// ---------------------------------------------------------------------------
543 
544export interface FilterBuilderProps {
545  value: FilterTree | null;
546  onChange: (tree: FilterTree | null) => void;
547  properties: DatabaseProperty[];
548  /** Compact mode for narrow popovers. */
549  className?: string;
550}
551 
552export function FilterBuilder({ value, onChange, properties, className }: FilterBuilderProps) {
553  if (properties.length === 0) {
554    return <p className="px-1 py-2 text-xs text-muted-foreground">Add properties before filtering.</p>;
555  }
556  return (
557    <div className={cn("min-h-16", className)}>
558      {value ? (
559        isGroupNode(value) ? (
560          <GroupBlock group={value} depth={0} properties={properties} onChange={(g) => onChange(g ?? null)} />
561        ) : (
562          <div className="space-y-1">
563            <ConditionRow
564              condition={value}
565              properties={properties}
566              onChange={(c) => onChange(c)}
567              onRemove={() => onChange(null)}
568            />
569            <button
570              type="button"
571              className="inline-flex items-center gap-1 rounded px-1.5 py-0.5 text-xs text-primary hover:bg-muted"
572              onClick={() => {
573                const p = properties[0];
574                const op = opsForProperty(p)[0];
575                onChange(addNode(value, { propertyId: p.id, op: op.op, value: defaultValue(op.needs) }));
576              }}
577            >
578              <Plus className="size-3" /> Add condition
579            </button>
580          </div>
581        )
582      ) : (
583        <button
584          type="button"
585          className="inline-flex items-center gap-1 rounded px-1.5 py-1 text-xs text-primary hover:bg-muted"
586          onClick={() => {
587            const p = properties[0];
588            const op = opsForProperty(p)[0];
589            onChange({ propertyId: p.id, op: op.op, value: defaultValue(op.needs) });
590          }}
591        >
592          <Plus className="size-3" /> Add filter condition
593        </button>
594      )}
595      {value && (
596        <div className="mt-2 border-t pt-1">
597          <button type="button" className="rounded px-1.5 py-0.5 text-xs text-muted-foreground hover:bg-muted hover:text-destructive" onClick={() => onChange(null)}>
598            Clear all filters
599          </button>
600        </div>
601      )}
602    </div>
603  );
604}
605