@sleep2agi/commhub-server 0.9.0-preview.21 â 0.9.0-preview.210
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +130 -10
- package/bin/commhub.ts +99 -11
- package/package.json +7 -7
- package/src/ack-create-request-transport.test.ts +182 -0
- package/src/ack-create-request.test.ts +50 -7
- package/src/admin-delete-network-http.test.ts +228 -0
- package/src/admin-networks-http.test.ts +88 -0
- package/src/adoption-candidates-http.test.ts +137 -0
- package/src/adoption-candidates.ts +158 -0
- package/src/agent-access-batch.test.ts +210 -0
- package/src/agent-access.ts +487 -0
- package/src/agent-acl-groups-http.test.ts +247 -0
- package/src/agent-acl-http.test.ts +659 -0
- package/src/agent-acl-slice3-http.test.ts +267 -0
- package/src/agent-department-http.test.ts +215 -0
- package/src/agent-groups-perf.test.ts +223 -0
- package/src/agent-notice.ts +48 -0
- package/src/agent-team-whoami-http.test.ts +98 -0
- package/src/agent-teams-http.test.ts +330 -0
- package/src/agent-teams.ts +244 -0
- package/src/alias-baseline-2571.test.ts +162 -0
- package/src/alias-baseline.ts +113 -0
- package/src/alias-filter.test.ts +72 -0
- package/src/alias-filter.ts +42 -0
- package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
- package/src/api-host-supervisors-fallback.test.ts +21 -12
- package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
- package/src/api-nodes-shape.test.ts +120 -13
- package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
- package/src/auth-sessions-http.test.ts +250 -0
- package/src/auth-validate.test.ts +5 -1
- package/src/auth-weak-password-login.test.ts +176 -0
- package/src/auth.ts +609 -51
- package/src/avatar-validate.test.ts +163 -0
- package/src/avatar-validate.ts +103 -0
- package/src/backfill-node-ids-2664.test.ts +128 -0
- package/src/binding-generation-http.test.ts +121 -0
- package/src/blocked-exit-on-reply.test.ts +122 -0
- package/src/boot-side-effect.test.ts +124 -0
- package/src/broadcast-fanout-2721.test.ts +118 -0
- package/src/broadcast-fanout.ts +98 -0
- package/src/chain-attempt-dedup.test.ts +447 -0
- package/src/clone-node.test.ts +248 -0
- package/src/clone-node.ts +289 -0
- package/src/codex-config-flags.ts +77 -0
- package/src/codex-fork-contract.ts +23 -0
- package/src/codex-fork-migration.test.ts +38 -0
- package/src/commhub-bin-args.test.ts +85 -0
- package/src/config-apply-validate.test.ts +42 -1
- package/src/config-apply-validate.ts +30 -2
- package/src/create-node-blocked-gate.test.ts +356 -0
- package/src/create-node-network-id.test.ts +79 -0
- package/src/create-node-tool-schema.test.ts +49 -0
- package/src/create-node-unicode-name.test.ts +120 -0
- package/src/create-node-validate.test.ts +199 -7
- package/src/create-node-validate.ts +232 -15
- package/src/create-node-workdir.test.ts +289 -0
- package/src/create-node.ts +88 -23
- package/src/daemon-provider-snapshots.test.ts +421 -0
- package/src/daemon-provider-snapshots.ts +327 -0
- package/src/daemon-token-owner-http.test.ts +236 -0
- package/src/dashboard-slash-routing-http.test.ts +109 -0
- package/src/db-adapter-guard.test.ts +148 -0
- package/src/db-adapter-translate.test.ts +128 -0
- package/src/db-adapter.ts +377 -91
- package/src/db-timestamp.test.ts +38 -0
- package/src/db-timestamp.ts +15 -0
- package/src/db.ts +1306 -153
- package/src/delivered-without-push.test.ts +140 -0
- package/src/department-groups-http.test.ts +209 -0
- package/src/department-groups-sync-http.test.ts +328 -0
- package/src/department-groups.ts +434 -0
- package/src/department-heads-http.test.ts +330 -0
- package/src/department-heads.ts +226 -0
- package/src/departments-agent-count.test.ts +129 -0
- package/src/departments-http.test.ts +185 -0
- package/src/departments-mcp.test.ts +128 -0
- package/src/departments.ts +318 -0
- package/src/desktop-message-seam.test.ts +150 -0
- package/src/desktop-message.test.ts +368 -0
- package/src/dm-file-scope-http.test.ts +178 -0
- package/src/empty-node-sweeper.test.ts +104 -0
- package/src/empty-node-sweeper.ts +88 -0
- package/src/env-transport-gate-http.test.ts +240 -0
- package/src/env-transport-gate.ts +80 -0
- package/src/env-transport-policy.ts +56 -0
- package/src/event-loop-lag.test.ts +180 -0
- package/src/event-loop-lag.ts +181 -0
- package/src/ext-token-shared.test.ts +60 -0
- package/src/ext-validation-regression.test.ts +131 -0
- package/src/external-schedule-edits-http.test.ts +321 -0
- package/src/external-schedule-edits-timestamps.test.ts +64 -0
- package/src/external-schedule-edits.ts +327 -0
- package/src/file-download-authz-dev-open.test.ts +135 -0
- package/src/file-download-authz.test.ts +404 -0
- package/src/file-download-date-bucket.test.ts +436 -0
- package/src/file-network-scope-dev-open.test.ts +97 -0
- package/src/file-network-scope.test.ts +732 -0
- package/src/group-membership-events-http.test.ts +264 -0
- package/src/group-messages-http.test.ts +482 -0
- package/src/group-messages.ts +297 -0
- package/src/health-host-disk-2756.test.ts +49 -0
- package/src/health-redaction.test.ts +685 -0
- package/src/host-supervisor-identity-http.test.ts +152 -0
- package/src/host-supervisor-identity.ts +92 -0
- package/src/host-supervisors-daemon-version.test.ts +137 -0
- package/src/http-gzip.test.ts +94 -0
- package/src/http-gzip.ts +112 -0
- package/src/hub-catalog-read-http.test.ts +187 -0
- package/src/hub-provider-config.test.ts +139 -0
- package/src/hub-provider-config.ts +105 -0
- package/src/hub-timestamp.test.ts +38 -0
- package/src/hub-timestamp.ts +27 -0
- package/src/human-dm.ts +215 -0
- package/src/human-inbox.ts +42 -0
- package/src/inbox-caller.ts +49 -0
- package/src/inbox-count-sse.test.ts +310 -0
- package/src/inbox-count.ts +29 -0
- package/src/index.ts +15 -2385
- package/src/list-host-supervisors.test.ts +5 -4
- package/src/mcp-context-cost-http.test.ts +127 -0
- package/src/mcp-inflight.test.ts +92 -0
- package/src/mcp-inflight.ts +38 -0
- package/src/mcp-projects-events-http.test.ts +162 -0
- package/src/mcp-route-label-http.test.ts +120 -0
- package/src/mcp-write-network-resolution.test.ts +432 -0
- package/src/member-audit-network-id-http.test.ts +93 -0
- package/src/member-presence-http.test.ts +210 -0
- package/src/messages-ack-by-agent-http.test.ts +142 -0
- package/src/migrate-sqlite-to-pg.test.ts +47 -0
- package/src/migrate-sqlite-to-pg.ts +263 -0
- package/src/model-auth-notify-http.test.ts +181 -0
- package/src/model-auth-notify.ts +116 -0
- package/src/network-name-http.test.ts +75 -0
- package/src/network-rules-http.test.ts +169 -0
- package/src/network-rules.ts +129 -0
- package/src/network-scope.ts +276 -0
- package/src/network-token-membership-http.test.ts +139 -0
- package/src/node-alias-control.ts +12 -0
- package/src/node-attrs-validate.ts +88 -0
- package/src/node-attrs.test.ts +258 -0
- package/src/node-caller-identity-http.test.ts +1083 -0
- package/src/node-create-request-status-http.test.ts +105 -0
- package/src/node-daemon-bindings.test.ts +132 -0
- package/src/node-daemon-bindings.ts +135 -0
- package/src/node-failure-alert.test.ts +150 -0
- package/src/node-failure-alert.ts +177 -0
- package/src/node-files-transport.test.ts +344 -0
- package/src/node-health-codex-login.test.ts +120 -0
- package/src/node-health-dispatch-http.test.ts +279 -0
- package/src/node-health-guard.ts +105 -0
- package/src/node-health-passthrough.test.ts +115 -0
- package/src/node-health-store.ts +101 -0
- package/src/node-id-alias.test.ts +190 -0
- package/src/node-identity-conflict-http.test.ts +269 -0
- package/src/node-identity-conflict.ts +142 -0
- package/src/node-identity-mismatch.test.ts +74 -0
- package/src/node-in-flight-tasks.ts +31 -0
- package/src/node-lifecycle-controllable.test.ts +64 -0
- package/src/node-lifecycle-controllable.ts +53 -0
- package/src/node-lifecycle-read-http.test.ts +250 -0
- package/src/node-lifecycle-read.ts +124 -0
- package/src/node-logs-transport.test.ts +263 -0
- package/src/node-peer-allowlist.test.ts +114 -0
- package/src/node-permissions-http.test.ts +648 -0
- package/src/node-permissions.ts +494 -0
- package/src/node-request-retention.test.ts +281 -0
- package/src/node-request-retention.ts +120 -0
- package/src/node-secret-rest-http.test.ts +190 -0
- package/src/node-serviceability.test.ts +86 -0
- package/src/node-serviceability.ts +124 -0
- package/src/node-session-control-http.test.ts +310 -0
- package/src/node-session-control.ts +258 -0
- package/src/node-skills-transport.test.ts +209 -0
- package/src/node-token-identity.ts +35 -0
- package/src/node-token-ownership.ts +51 -0
- package/src/node-token-privilege-http.test.ts +158 -0
- package/src/not-found-api-http.test.ts +67 -0
- package/src/observer-avatar-http.test.ts +442 -0
- package/src/observer-push.test.ts +252 -0
- package/src/opencode-catalog-report-http.test.ts +139 -0
- package/src/opencode-v2-catalog.test.ts +268 -0
- package/src/opencode-v2-catalog.ts +352 -0
- package/src/package-version-consistency.test.ts +25 -0
- package/src/parent-source-marker.test.ts +50 -0
- package/src/password-network-tokens.ts +25 -0
- package/src/peer-reply-atomic.test.ts +455 -0
- package/src/peer-reply-capability.test.ts +70 -0
- package/src/pg-worker.ts +87 -0
- package/src/project-dir-warn-clear-http.test.ts +132 -0
- package/src/project-viewer-can-http.test.ts +116 -0
- package/src/push.test.ts +20 -10
- package/src/push.ts +466 -13
- package/src/redact-tokens.test.ts +65 -0
- package/src/redact-tokens.ts +40 -0
- package/src/rename.ts +38 -10
- package/src/reply-target-derivation.test.ts +96 -0
- package/src/report-status-handover-capabilities-http.test.ts +124 -0
- package/src/report-status-host-schema.test.ts +235 -0
- package/src/report-status-resume-id-handover.test.ts +184 -0
- package/src/report-status-secret-keys.test.ts +140 -0
- package/src/require-explicit-test-db.ts +9 -0
- package/src/requirement-due-reminders-http.test.ts +620 -0
- package/src/requirement-due-reminders.ts +416 -0
- package/src/requirement-events-http.test.ts +268 -0
- package/src/requirement-events.test.ts +45 -0
- package/src/requirement-events.ts +144 -0
- package/src/requirement-notify.ts +165 -0
- package/src/requirement-participant-notify-http.test.ts +309 -0
- package/src/requirement-tag-ops-http.test.ts +425 -0
- package/src/requirement-tag-tree-http.test.ts +275 -0
- package/src/requirement-tag-tree.ts +127 -0
- package/src/requirement-tags.ts +102 -0
- package/src/requirements-abandoned-http.test.ts +236 -0
- package/src/requirements-comment-http.test.ts +167 -0
- package/src/requirements-completed-at-migration.test.ts +70 -0
- package/src/requirements-errors-mcp-http.test.ts +164 -0
- package/src/requirements-errors.ts +158 -0
- package/src/requirements-etag-http.test.ts +91 -0
- package/src/requirements-http.test.ts +709 -0
- package/src/requirements-last-event-http.test.ts +349 -0
- package/src/requirements-list-mcp-slim-http.test.ts +155 -0
- package/src/requirements-list-slim-http.test.ts +324 -0
- package/src/requirements-mcp.test.ts +163 -0
- package/src/requirements-migrate.ts +283 -0
- package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
- package/src/requirements-people-http.test.ts +114 -0
- package/src/requirements-people-mcp-http.test.ts +231 -0
- package/src/requirements-people.ts +196 -0
- package/src/requirements-priority-lowest.test.ts +114 -0
- package/src/requirements-projects-parent-http.test.ts +123 -0
- package/src/requirements-search-http.test.ts +182 -0
- package/src/requirements-search.test.ts +32 -0
- package/src/requirements-search.ts +145 -0
- package/src/requirements-seq-http.test.ts +193 -0
- package/src/requirements-seq-migration.test.ts +63 -0
- package/src/requirements-start-date.test.ts +125 -0
- package/src/requirements-stats-http.test.ts +357 -0
- package/src/requirements-stats.ts +195 -0
- package/src/requirements-status-participants-http.test.ts +222 -0
- package/src/requirements-upgrade-e2e.test.ts +126 -0
- package/src/requirements-upgrade-migration.test.ts +98 -0
- package/src/requirements.ts +2027 -0
- package/src/resolve-port.test.ts +57 -0
- package/src/resolve-port.ts +44 -0
- package/src/response-charset.test.ts +130 -0
- package/src/rest-alias-network-fallback-http.test.ts +123 -0
- package/src/rest-alias-network-fallback.test.ts +60 -0
- package/src/rest-alias-network-fallback.ts +65 -0
- package/src/rest-explicit-columns-http.test.ts +266 -0
- package/src/rest-identity.test.ts +130 -0
- package/src/rest-identity.ts +141 -0
- package/src/rest-projections.ts +72 -0
- package/src/rest-read-network-real-chain.test.ts +97 -0
- package/src/rest-write-network-resolution.test.ts +133 -0
- package/src/restart-readiness-http.test.ts +121 -0
- package/src/restricted-files.ts +76 -0
- package/src/retention-first-sweep-quiet.test.ts +31 -0
- package/src/retention.test.ts +100 -40
- package/src/retention.ts +423 -104
- package/src/route-callers-http.test.ts +120 -0
- package/src/route-timing.test.ts +211 -0
- package/src/route-timing.ts +262 -0
- package/src/rules-file-duplicate-alias.test.ts +234 -0
- package/src/rules-file-session-target.test.ts +207 -0
- package/src/rules-file-transport.test.ts +237 -0
- package/src/runtime-label.test.ts +22 -0
- package/src/runtime-label.ts +21 -0
- package/src/runtime-readiness.ts +90 -0
- package/src/schedule-agent-mcp-http.test.ts +391 -0
- package/src/schedule-agent.ts +192 -0
- package/src/schedule-starved.test.ts +92 -0
- package/src/schedule-starved.ts +114 -0
- package/src/scheduled-backoff-http.test.ts +193 -0
- package/src/scheduled-backoff.ts +64 -0
- package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
- package/src/scheduled-failure-backoff-2622.test.ts +145 -0
- package/src/scheduled-failure-code.test.ts +73 -0
- package/src/scheduled-failure-code.ts +105 -0
- package/src/scheduled-failures-http.test.ts +279 -0
- package/src/scheduled-failures.ts +377 -0
- package/src/scheduled-noprogress-backoff-2622.test.ts +133 -0
- package/src/scheduled-offline-backoff-probe.test.ts +56 -0
- package/src/scheduled-offline.test.ts +131 -0
- package/src/scheduled-offline.ts +66 -0
- package/src/scheduled-outcome-guidance-http.test.ts +139 -0
- package/src/scheduled-outcome-guidance.ts +9 -0
- package/src/scheduled-reply-unread-http.test.ts +212 -0
- package/src/scheduled-requirement-wake-http.test.ts +279 -0
- package/src/scheduled-requirement-wake.ts +125 -0
- package/src/scheduled-run-terminal.test.ts +268 -0
- package/src/scheduled-skip-blocking-task.test.ts +120 -0
- package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
- package/src/scheduled-stuck-http.test.ts +312 -0
- package/src/scheduled-stuck-notice-cap.test.ts +80 -0
- package/src/scheduled-stuck.ts +219 -0
- package/src/scheduled-tasks-http.test.ts +679 -0
- package/src/scheduled-tasks.ts +959 -0
- package/src/scheduled-work-outcome-http.test.ts +154 -0
- package/src/scheduled-work-outcome.ts +50 -0
- package/src/scoped-secrets.ts +141 -0
- package/src/send-dedup-request-id.test.ts +229 -0
- package/src/send-reply-agent-warning.test.ts +202 -0
- package/src/send-reply-alias-optional.test.ts +131 -0
- package/src/send-reply-attachments.test.ts +458 -0
- package/src/send_dedup.test.ts +54 -0
- package/src/send_dedup.ts +52 -6
- package/src/serve-error.test.ts +38 -0
- package/src/serve-error.ts +27 -0
- package/src/server.ts +6220 -0
- package/src/session-task-on-dispatch.ts +14 -0
- package/src/session-token-ownership-http.test.ts +122 -0
- package/src/shared/codex-inventory.ts +41 -0
- package/src/shared/daemon-provider-login.ts +31 -0
- package/src/shared/daemon-provider-snapshot.ts +52 -0
- package/src/shared/external-schedule-contract.ts +60 -0
- package/src/shared/node-name.test.ts +62 -0
- package/src/shared/node-name.ts +161 -0
- package/src/shared/provider-application.ts +29 -0
- package/src/shared/provider-collection.ts +14 -0
- package/src/shared/provider-initialization.ts +8 -0
- package/src/shared/reserved-env-drift.test.ts +10 -0
- package/src/shared/scoped-secret-contract.ts +5 -0
- package/src/shared/task-content-limit-drift.test.ts +28 -0
- package/src/shared/task-content-limit.ts +25 -0
- package/src/side-thread-command-transport.test.ts +312 -0
- package/src/side-thread-command-transport.ts +318 -0
- package/src/side-thread-http-integration.test.ts +233 -0
- package/src/side-thread-http.ts +504 -0
- package/src/side-thread-production.test.ts +72 -0
- package/src/side-thread-production.ts +118 -0
- package/src/side-thread.test.ts +1067 -0
- package/src/side-thread.ts +2499 -0
- package/src/skillhub-http.test.ts +108 -0
- package/src/sqlite-close-checkpoint.test.ts +78 -0
- package/src/start-node.test.ts +264 -0
- package/src/status-alias-filter-http.test.ts +106 -0
- package/src/status-alias-resolver-http.test.ts +163 -0
- package/src/status-alias-resolver.ts +19 -0
- package/src/status-node-id-filter-http.test.ts +161 -0
- package/src/status-read-cache-http.test.ts +229 -0
- package/src/status-read-cache.ts +122 -0
- package/src/stop-delete-node.test.ts +567 -1
- package/src/task-access-http.test.ts +402 -0
- package/src/task-access.ts +420 -0
- package/src/task-activity.ts +60 -0
- package/src/task-auth-origin-http.test.ts +93 -0
- package/src/task-auth-origin.test.ts +24 -0
- package/src/task-auth-origin.ts +7 -0
- package/src/task-consumption.test.ts +482 -0
- package/src/task-diagnostic-http.test.ts +149 -0
- package/src/task-diagnostic.test.ts +115 -0
- package/src/task-diagnostic.ts +118 -0
- package/src/task-expiry-notice-http.test.ts +287 -0
- package/src/task-expiry-notice.ts +315 -0
- package/src/task-idempotency-mcp.test.ts +142 -0
- package/src/task-idempotency.test.ts +76 -0
- package/src/task-idempotency.ts +81 -0
- package/src/task-late-replies.ts +54 -0
- package/src/task-late-reply-http.test.ts +152 -0
- package/src/task-lifecycle-watcher-busy.test.ts +114 -0
- package/src/task-lifecycle-watcher.test.ts +204 -0
- package/src/task-lifecycle-watcher.ts +109 -0
- package/src/task-network-resolution-http.test.ts +140 -0
- package/src/task-offline-delivery-2668.test.ts +119 -0
- package/src/task-offline-delivery.ts +81 -0
- package/src/task-orphan-http.test.ts +287 -0
- package/src/task-orphan.ts +119 -0
- package/src/task-queue-ahead-http.test.ts +309 -0
- package/src/task-queue-ahead-scale.test.ts +236 -0
- package/src/task-queue-ahead.ts +186 -0
- package/src/task-rejection-log-http.test.ts +160 -0
- package/src/task-rejection-log.ts +49 -0
- package/src/task-sender-http.test.ts +143 -0
- package/src/task-stale-open-http.test.ts +290 -0
- package/src/task-stale-open.ts +103 -0
- package/src/tasks-pagination-http.test.ts +141 -0
- package/src/team-rules-status-http.test.ts +90 -0
- package/src/team-rules-status.test.ts +59 -0
- package/src/team-rules-status.ts +72 -0
- package/src/tool-audience-http.test.ts +230 -0
- package/src/tool-audience.ts +120 -0
- package/src/tools-list-json-schema.test.ts +94 -0
- package/src/tools.ts +4119 -391
- package/src/upload-early-reject-guard.test.ts +155 -0
- package/src/uploads-http.test.ts +97 -15
- package/src/uploads.ts +103 -6
- package/src/user-avatar-http.test.ts +74 -0
- package/src/user-avatar-image.ts +160 -0
- package/src/user-avatar-migration.test.ts +25 -0
- package/src/user-avatar-upload-http.test.ts +348 -0
- package/src/user-inbox-by-agent-http.test.ts +161 -0
- package/src/user-inbox-netid-notnull.test.ts +122 -0
- package/src/user-inbox-read-http.test.ts +223 -0
- package/src/user-inbox-schema.test.ts +54 -0
- package/src/version-stats.test.ts +66 -0
- package/src/version-stats.ts +109 -0
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
// #2614 ââ äşäťśĺžŞçŻĺ饿çćľďźĺŞč§ćľďźä¸ćšäťťä˝čĄä¸şďźă
|
|
2
|
+
//
|
|
3
|
+
// čćŻďź2026-10-26 21:55â22:12 çäş§ Hub ĺşç°ä¸¤ćŹĄĺ
ĺĺ°ĺł°ďźRSS 3.6 â 4.5 GBďźďź
|
|
4
|
+
// äź´éćş `mcp_inflight` 387 â 807ăäşĺçćĽĺżćĺç°**ĺä¸ćśĺťćĽĺżééť 14â47 ç§**
|
|
5
|
+
// ââHub ćŻĺçşżç¨ďźBun + ĺćĽ SQLiteďźďźćĽĺżééťĺ°ąçäşäşäťśĺžŞçŻč˘ŤéťĺĄă
|
|
6
|
+
//
|
|
7
|
+
// ç°ć `/api/stats/routes` ĺŞč˝ĺčŻć䝏âĺŞä¸Şčݎćą**ĺ厳**äşâďźĺŽçčćśĺ
ĺŤäşćéćśé´ďźďź
|
|
8
|
+
// ä¸č˝ĺčŻć䝏âĺ˝ćś**č°**ĺ¨éťĺĄâăçźşçĺ°ąćŻĺ饿ćŹčşŤçćśé´ĺşĺă
|
|
9
|
+
//
|
|
10
|
+
// čżä¸Şć¨Ąĺ襼ä¸čżä¸ć źďźćŻ `intervalMs` éä¸ćŹĄďźé `now - lastTick`ďź
|
|
11
|
+
// ćŁĺ¸¸ć
ĺľ â intervalďźčś
ĺş `thresholdMs` çé¨ĺĺ°ąćŻä¸ćŹĄçĺŽĺ饿ă
|
|
12
|
+
// ĺ饿äźďźâ 莥ć°/ç楣ďź`/health` ç `event_loop` ĺ掾ĺŻčŻťďźďź
|
|
13
|
+
// ⥠ćä¸čĄćĽĺżďźĺ¸Śĺ˝ćśç RSSďźćšäžżĺĺ
ĺć˛çşżĺŻšé˝ďźă
|
|
14
|
+
//
|
|
15
|
+
// 注ćďź`setInterval` čŞĺˇąäšäźč˘ŤéťĺĄ ââ čżćŁćŻć䝏čŚćľéçä¸čĽżă
|
|
16
|
+
// ĺ饿çťćĺ珏ä¸ćŹĄ tick ç gap ĺ°ąćŻĺ饿éżĺşŚďźä¸éčŚĺ¤é¨čżç¨é
ĺă
|
|
17
|
+
|
|
18
|
+
export type EventLoopStall = {
|
|
19
|
+
/** čżä¸Şé´ééĺ¤çĺŽç诡ćąć°ďź0 = çç沥ć¨čżďź>0 = 垪çŻĺ¨ĺš˛ć´ťďźĺŞćŻ timer 袍鼿ä˝ă */
|
|
20
|
+
/** ISO ćśé´ďźĺ饿**çťć**çćśĺťďźĺłčżćŹĄ tick çćśé´ďźă */
|
|
21
|
+
at: string;
|
|
22
|
+
/** čˇä¸ćŹĄ tick çĺŽé
é´éďźćŻŤç§ďźăçäş interval + ĺ饿ă */
|
|
23
|
+
gap_ms: number;
|
|
24
|
+
/** ĺ饿é = gap - intervală */
|
|
25
|
+
stall_ms: number;
|
|
26
|
+
/** ĺ饿çťććśçčżç¨ RSSďźMBďźďźç¨äşĺĺ
ĺĺ°ĺł°ĺŻšé˝ă */
|
|
27
|
+
rss_mb: number;
|
|
28
|
+
requests_since_last_tick?: number;
|
|
29
|
+
};
|
|
30
|
+
|
|
31
|
+
const KEEP_STALLS = 20;
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* #2614ďźçŹŹäşč˝Žďźââ 2026-10-27 00:39 çşżä¸ĺşç° gap 84887msďźä˝**ĺä¸ćśćŽľćĽĺżĺ¨ćŁĺ¸¸ĺ**
|
|
35
|
+
* ďź00:38:52 / 00:38:58 / 00:39:08 âŚďźďźčä¸ `/api/stats/routes` éćć
˘ç诡ćąĺŞć 2.4să
|
|
36
|
+
* äšĺ°ąćŻčŻ´ďźäşäťśĺžŞçŻ**沥ć袍éťĺĄ 84 ç§**ďźćŻ **timer ĺč°č˘Ť I/O éĺ鼿ä˝**äşă
|
|
37
|
+
* ĺŞç tick é´éäźćčżä¸¤ç§ć
ĺľćˇˇćä¸ćĄâĺĄäş 84 ç§âçĺçťčŽşă
|
|
38
|
+
*
|
|
39
|
+
* ĺşĺĺćłďźć°ä¸ä¸čżä¸Şé´éé**ćĺĄäşĺ¤ĺ°čݎćą**ă
|
|
40
|
+
* requests_since_last_tick > 0 â 垪çŻĺ¨ĺš˛ć´ť â čżćŻ timer 鼼鼿ďźéŤč´č˝˝/大ćšĺč°ďź
|
|
41
|
+
* requests_since_last_tick = 0 â çç沥ćć¨čżäťťä˝čŻˇćą â ćĺŻč˝ćŻĺćĽéťĺĄ
|
|
42
|
+
*/
|
|
43
|
+
let servedSinceTick = 0;
|
|
44
|
+
|
|
45
|
+
/** 诡ćąĺ¤çĺŽććśč°ç¨ďźroute-timing éďźăĺŞčŽĄć°ďźä¸ĺä¸äťťä˝ĺłçă */
|
|
46
|
+
export function noteRequestServed(): void {
|
|
47
|
+
servedSinceTick++;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
let maxGapMs = 0;
|
|
51
|
+
let lastGapMs = 0;
|
|
52
|
+
let stallCount = 0;
|
|
53
|
+
let lastStallAt: string | null = null;
|
|
54
|
+
let lastStallMs = 0;
|
|
55
|
+
const stalls: EventLoopStall[] = [];
|
|
56
|
+
|
|
57
|
+
/** 莰ĺ˝ä¸ćŹĄ tick é´éăčżĺčżćŹĄ tick çĺ饿éďźćŻŤç§ďźĺŻä¸şč´âĺ˝éśďźă */
|
|
58
|
+
export function recordGap(
|
|
59
|
+
gapMs: number,
|
|
60
|
+
opts: { intervalMs?: number; thresholdMs?: number; rssMb?: number; now?: number; served?: number } = {},
|
|
61
|
+
): number {
|
|
62
|
+
const interval = opts.intervalMs ?? 250;
|
|
63
|
+
const threshold = opts.thresholdMs ?? 2000;
|
|
64
|
+
lastGapMs = gapMs;
|
|
65
|
+
if (gapMs > maxGapMs) maxGapMs = gapMs;
|
|
66
|
+
const stallMs = Math.max(0, gapMs - interval);
|
|
67
|
+
if (stallMs < threshold) return stallMs;
|
|
68
|
+
const at = new Date(opts.now ?? Date.now()).toISOString();
|
|
69
|
+
stallCount++;
|
|
70
|
+
lastStallAt = at;
|
|
71
|
+
lastStallMs = stallMs;
|
|
72
|
+
stalls.push({
|
|
73
|
+
at,
|
|
74
|
+
gap_ms: Math.round(gapMs),
|
|
75
|
+
stall_ms: Math.round(stallMs),
|
|
76
|
+
rss_mb: opts.rssMb ?? 0,
|
|
77
|
+
requests_since_last_tick: opts.served ?? 0,
|
|
78
|
+
});
|
|
79
|
+
while (stalls.length > KEEP_STALLS) stalls.shift();
|
|
80
|
+
return stallMs;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
export function eventLoopStats(): {
|
|
84
|
+
max_gap_ms: number;
|
|
85
|
+
last_gap_ms: number;
|
|
86
|
+
stall_count: number;
|
|
87
|
+
last_stall_ms: number;
|
|
88
|
+
last_stall_at: string | null;
|
|
89
|
+
recent_stalls: EventLoopStall[];
|
|
90
|
+
} {
|
|
91
|
+
return {
|
|
92
|
+
max_gap_ms: Math.round(maxGapMs),
|
|
93
|
+
last_gap_ms: Math.round(lastGapMs),
|
|
94
|
+
stall_count: stallCount,
|
|
95
|
+
last_stall_ms: Math.round(lastStallMs),
|
|
96
|
+
last_stall_at: lastStallAt,
|
|
97
|
+
recent_stalls: [...stalls].reverse(),
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/** ĺŞçťćľčŻç¨ďźć¸
犺累莥çśćă */
|
|
102
|
+
export function resetEventLoopLagForTests(): void {
|
|
103
|
+
maxGapMs = 0;
|
|
104
|
+
lastGapMs = 0;
|
|
105
|
+
stallCount = 0;
|
|
106
|
+
lastStallAt = null;
|
|
107
|
+
lastStallMs = 0;
|
|
108
|
+
stalls.length = 0;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
function envMs(name: string, fallback: number): number {
|
|
112
|
+
const raw = Number(process.env[name]);
|
|
113
|
+
return Number.isFinite(raw) && raw >= 0 ? raw : fallback;
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/**
|
|
117
|
+
* ĺŻĺ¨çćľăčżĺ timerďźč°ç¨ćšč´č´Ł clearIntervalďźă
|
|
118
|
+
* - `COMMHUB_STALL_LOG_MS`ďźĺ饿ćĽĺżéĺźďźéťčޤ 2000 msďźčŽž 0 ĺ
łéćĽĺżďźäťčŽĄć°ďźďź
|
|
119
|
+
* - `COMMHUB_STALL_TICK_MS`ďźéć ˇé´éďźéťčޤ 250 msă
|
|
120
|
+
*/
|
|
121
|
+
export function startEventLoopLagMonitor(opts: {
|
|
122
|
+
intervalMs?: number;
|
|
123
|
+
thresholdMs?: number;
|
|
124
|
+
log?: (msg: string) => void;
|
|
125
|
+
rssMb?: () => number;
|
|
126
|
+
/**
|
|
127
|
+
* #2721 ââ ĺŻĺ¨ćç tick gap ä¸çŽĺ饿ăĺ¤ćŽćŻ**čżç¨ĺŻĺ¨ĺ¤äš
äş**ďźä¸ćŻçŹŹĺ 个 tickă
|
|
128
|
+
*
|
|
129
|
+
* äşć
形çśďźčżç¨ 22:21:06 ĺŻĺ¨ďź14:21:09.835Z čŽ°ĺ° gap 2972ms ââ ĺŻĺ¨ĺ 3 ç§ă
|
|
130
|
+
* éŁćŽľ gap 庌éçćŻăçć§ĺźĺ§ â 珏ä¸ćŹĄ tickă袍樥ĺĺ č˝˝/ĺźĺş/čżç§ťĺ 来çćśé´ă
|
|
131
|
+
*
|
|
132
|
+
* 两çé误ĺŽç°ďźé˝čŻčżďźé˝č˘Ťć˘ććľčŻćä˝ďźďź
|
|
133
|
+
* â 10 ç§**ćśé´çŞ** â çć§ĺ¨ĺ 10 ç§äťäšé˝ä¸čްďźăéĺź 40ms + spin 120ms ĺşććĽĺżăç´ćĽĺć
|
|
134
|
+
* ⥠ĺŞčˇł**珏ä¸ä¸Ş tick** â ćľčŻéç spin ć°ĺĽ˝č˝ĺ¨çŹŹä¸ä¸Ş tickďźĺć ˇĺć
|
|
135
|
+
*
|
|
136
|
+
* çćŁçĺşĺŤä¸ćŻă珏ĺ 个 tickăďźčćŻ**čżćŽľćśé´éčżç¨ć沥ćĺŻč˝čżĺ¨ĺŻĺ¨**ă
|
|
137
|
+
* ć䝼ďźĺŞćĺ˝ tick ĺ°ćĽćśčżç¨ uptime äťĺ°äş bootGraceMsďźćć gap ĺ˝ä˝ĺŻĺ¨ĺ°ĺł°ă
|
|
138
|
+
* ĺŻĺ¨ 20 ç§äšĺç珏ä¸ćĄ gap äžć§ç
§ĺ¸¸čŽ°ĺ˝ ââ éŁćśĺĺŽä¸ĺŻč˝ćŻĺŻĺ¨čćśă
|
|
139
|
+
*/
|
|
140
|
+
bootGraceMs?: number;
|
|
141
|
+
/** ćľčŻćł¨ĺ
Ľďźčżĺčżç¨ĺˇ˛čżčĄç母ç§ć°ďźéťčޤ process.uptime()ďźă */
|
|
142
|
+
uptimeMs?: () => number;
|
|
143
|
+
} = {}): ReturnType<typeof setInterval> {
|
|
144
|
+
const intervalMs = opts.intervalMs ?? Math.max(50, envMs("COMMHUB_STALL_TICK_MS", 250));
|
|
145
|
+
const thresholdMs = opts.thresholdMs ?? envMs("COMMHUB_STALL_LOG_MS", 2000);
|
|
146
|
+
const log = opts.log ?? ((m: string) => console.log(m));
|
|
147
|
+
const rssMb = opts.rssMb ?? (() => Math.round(process.memoryUsage().rss / 1048576));
|
|
148
|
+
let last = performance.now();
|
|
149
|
+
const startedAt = last;
|
|
150
|
+
// #2721 ââ ĺŻĺ¨é˘çä¸çŽĺ饿ă
|
|
151
|
+
// ĺŽćľďź2026-10-29 čżćŹĄčżç¨ 22:21:06 辡ćĽďź14:21:09.835Z 莰ĺ°ä¸ćŹĄ gap 2972msďź
|
|
152
|
+
// äšĺ°ąćŻ**ĺŻĺ¨ĺ 3 ç§**ăéŁćŽľćśé´ĺ¨ĺ樥ĺĺ č˝˝ / ćĺź DB / čżç§ťďźçŹŹä¸ä¸Ş tick ĺż
çśĺ大ă
|
|
153
|
+
// ä¸ćé¤ĺŽçĺććŻďźćŻćŹĄé¨ç˝˛é˝äźĺ¨ `/health` éçä¸ćĄăĺ饿ăďźčĺŽĺçşżä¸çĺŽĺĄéĄżéżĺžä¸ć¨Ąä¸ć ˇă
|
|
154
|
+
const bootGraceMs = opts.bootGraceMs ?? envMs("COMMHUB_STALL_BOOT_GRACE_MS", 15_000);
|
|
155
|
+
const uptimeMs = opts.uptimeMs ?? (() => process.uptime() * 1000);
|
|
156
|
+
let firstTick = true;
|
|
157
|
+
const timer = setInterval(() => {
|
|
158
|
+
const now = performance.now();
|
|
159
|
+
const gap = now - last;
|
|
160
|
+
last = now;
|
|
161
|
+
const rss = rssMb();
|
|
162
|
+
const served = servedSinceTick;
|
|
163
|
+
servedSinceTick = 0;
|
|
164
|
+
// ĺŻĺ¨ĺ°ĺł°ďźĺŞĺŻč˝ćŻ**珏ä¸ä¸Ş** tickďźä¸ĺ°ćĽćśčżç¨ćĺ辡ćĽă
|
|
165
|
+
// 两个ćĄäťśçźşä¸ä¸ĺŻ ââ ĺŞçă珏ä¸ä¸Ş tickăäźĺćčżčĄä¸çŤĺťĺçççĺŽĺ饿ă
|
|
166
|
+
if (firstTick) {
|
|
167
|
+
firstTick = false;
|
|
168
|
+
if (uptimeMs() < bootGraceMs) return;
|
|
169
|
+
}
|
|
170
|
+
const stall = recordGap(gap, { intervalMs, thresholdMs, rssMb: rss, served });
|
|
171
|
+
if (thresholdMs > 0 && stall >= thresholdMs) {
|
|
172
|
+
// ĺ retention/slow-sql çćĽĺżĺä¸ĺçźďźćšäžż grepă
|
|
173
|
+
// `served` ćŻĺ¤ćŽçĺ
łéŽďźĺŽééśĺ°ąčŻ´ć垪çŻĺ¨ĺš˛ć´ťďźčżćŽľâgapâćŻ timer 袍鼿ä˝ďźä¸ćŻéťĺĄă
|
|
174
|
+
log(`[commhub stall] loop idle ~${Math.round(stall)}ms (tick gap ${Math.round(gap)}ms, rss ${rss} MB, served ${served} req)`);
|
|
175
|
+
}
|
|
176
|
+
}, intervalMs);
|
|
177
|
+
// çćľä¸čŻĽćä˝čżç¨éĺşă
|
|
178
|
+
(timer as unknown as { unref?: () => void }).unref?.();
|
|
179
|
+
last = performance.now();
|
|
180
|
+
return timer;
|
|
181
|
+
}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import { describe, expect, test } from "bun:test";
|
|
2
|
+
import {
|
|
3
|
+
buildStoragePath,
|
|
4
|
+
pathForExistingBlob,
|
|
5
|
+
validateIndexEntry,
|
|
6
|
+
} from "./uploads.js";
|
|
7
|
+
|
|
8
|
+
const fileId = "0123456789abcdef0123456789abcdef";
|
|
9
|
+
const dateBucket = "2026-08-09";
|
|
10
|
+
const uploadsRoot = "/srv/uploads";
|
|
11
|
+
|
|
12
|
+
const malicious = [
|
|
13
|
+
"../x",
|
|
14
|
+
"/abs/x",
|
|
15
|
+
".png/../../y",
|
|
16
|
+
".p ng",
|
|
17
|
+
".p\0ng",
|
|
18
|
+
".\\..\\x",
|
|
19
|
+
"." + "a".repeat(17),
|
|
20
|
+
".tar.gz",
|
|
21
|
+
];
|
|
22
|
+
|
|
23
|
+
const legal = ["", ".png", ".PNG", ".mp4", "." + "a".repeat(16)];
|
|
24
|
+
|
|
25
|
+
describe("#527 shared extension-token invariant", () => {
|
|
26
|
+
test("new-upload path rejects every malformed token and accepts the shared legal set", () => {
|
|
27
|
+
for (const ext of malicious) {
|
|
28
|
+
expect(() => buildStoragePath(fileId, ext, { uploadsRoot })).toThrow(/ext .* is invalid/);
|
|
29
|
+
}
|
|
30
|
+
for (const ext of legal) {
|
|
31
|
+
expect(buildStoragePath(fileId, ext, { uploadsRoot }).ext).toBe(ext);
|
|
32
|
+
}
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
test("existing-blob path rejects every malformed token and accepts the shared legal set", () => {
|
|
36
|
+
for (const ext of malicious) {
|
|
37
|
+
expect(() => pathForExistingBlob(dateBucket, fileId, ext, { uploadsRoot })).toThrow(/ext .* is invalid/);
|
|
38
|
+
}
|
|
39
|
+
for (const ext of legal) {
|
|
40
|
+
expect(pathForExistingBlob(dateBucket, fileId, ext, { uploadsRoot }).ext).toBe(ext);
|
|
41
|
+
}
|
|
42
|
+
});
|
|
43
|
+
|
|
44
|
+
test("stored-index gate rejects every malformed token and accepts the shared legal set", () => {
|
|
45
|
+
for (const ext of malicious) {
|
|
46
|
+
expect(validateIndexEntry({ file_id: fileId, date_bucket: dateBucket, ext, size: 0 })).toBe(false);
|
|
47
|
+
}
|
|
48
|
+
for (const ext of legal) {
|
|
49
|
+
expect(validateIndexEntry({ file_id: fileId, date_bucket: dateBucket, ext, size: 0 })).toBe(true);
|
|
50
|
+
}
|
|
51
|
+
});
|
|
52
|
+
|
|
53
|
+
test("all three boundaries fail closed on non-string runtime values", () => {
|
|
54
|
+
for (const ext of [undefined, null, 7, {}, []]) {
|
|
55
|
+
expect(() => buildStoragePath(fileId, ext as never, { uploadsRoot })).toThrow(/ext .* is invalid/);
|
|
56
|
+
expect(() => pathForExistingBlob(dateBucket, fileId, ext as never, { uploadsRoot })).toThrow(/ext .* is invalid/);
|
|
57
|
+
expect(validateIndexEntry({ file_id: fileId, date_bucket: dateBucket, ext, size: 0 })).toBe(false);
|
|
58
|
+
}
|
|
59
|
+
});
|
|
60
|
+
});
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
// Task #25 â regression pins for ext validation in validateIndexEntry.
|
|
2
|
+
//
|
|
3
|
+
// đ´ SCOPE: this suite exercises the stored-index boundary through
|
|
4
|
+
// `validateIndexEntry`. Issue #527 removed the three independent copies
|
|
5
|
+
// of the stored extension-token grammar: buildStoragePath,
|
|
6
|
+
// pathForExistingBlob and validateIndexEntry now use one shared private
|
|
7
|
+
// validator. `ext-token-shared.test.ts` separately pins all three call
|
|
8
|
+
// sites. sanitizeExt remains intentionally independent because it parses
|
|
9
|
+
// a client filename rather than validating an already-extracted token.
|
|
10
|
+
//
|
|
11
|
+
// Background (éäżĄéž d01bb8ce): the stored extension-token grammar
|
|
12
|
+
// `/^\.[A-Za-z0-9]{1,16}$/` correctly rejects 11 known malicious ext
|
|
13
|
+
// values (path-escape, traversal, absolute paths, doubles, NUL bytes,
|
|
14
|
+
// backslash forms, over-length, whitespace). Verified via real-run on
|
|
15
|
+
// origin/main by lead â 11/11 malicious values â false.
|
|
16
|
+
//
|
|
17
|
+
// But NO test locked that behavior. Anyone who widens the regex in the
|
|
18
|
+
// future (accidentally or on purpose) would not hit a red test â the
|
|
19
|
+
// live protection would degrade silently. This suite pins current
|
|
20
|
+
// behavior in two directions:
|
|
21
|
+
//
|
|
22
|
+
// 1. SAFETY (ćŹ äżŽ direction) â 11 malicious values â false, one row
|
|
23
|
+
// per value with the exact literal. If regex is widened to accept
|
|
24
|
+
// any of them, that row turns red.
|
|
25
|
+
// 2. NON-REGRESSION (čżäżŽ direction) â a set of common legitimate
|
|
26
|
+
// extensions â true. If regex is tightened to reject any of them
|
|
27
|
+
// (e.g. someone locks down to a whitelist), that row turns red.
|
|
28
|
+
//
|
|
29
|
+
// Witnessed-red for the SAFETY rows: temporarily widen the regex to
|
|
30
|
+
// `/./` (or comment it out) in validateIndexEntry, run this suite,
|
|
31
|
+
// confirm all 11 malicious rows turn red, then revert. The mutation
|
|
32
|
+
// itself is not committed; the assertion IS the mutation-red proof
|
|
33
|
+
// for the reader. Recording the mutation output in the followup PR
|
|
34
|
+
// body (per Constraint 3 discipline established in #503).
|
|
35
|
+
//
|
|
36
|
+
// Pure unit test â no server setup, no DB, no filesystem. The regex
|
|
37
|
+
// lives in a pure function, so the guard is testable at that level.
|
|
38
|
+
|
|
39
|
+
import { describe, expect, test } from "bun:test";
|
|
40
|
+
import { validateIndexEntry } from "./uploads.js";
|
|
41
|
+
|
|
42
|
+
// A structurally-valid base entry â file_id / date_bucket / size all
|
|
43
|
+
// pass their own checks â so `ext` is the only field a test row varies.
|
|
44
|
+
// This isolates the ext regex as the deciding factor.
|
|
45
|
+
const validBase = {
|
|
46
|
+
file_id: "0123456789abcdef0123456789abcdef",
|
|
47
|
+
date_bucket: "2026-07-30",
|
|
48
|
+
size: 0,
|
|
49
|
+
};
|
|
50
|
+
|
|
51
|
+
describe("Task #25 (#503 followup) â ext validation regression pins", () => {
|
|
52
|
+
describe("SAFETY: the 11 malicious ext values from lead d01bb8ce all return false", () => {
|
|
53
|
+
// Each row uses the exact literal from lead's verification list so
|
|
54
|
+
// a widening regex catches on the same value the manual audit did.
|
|
55
|
+
const malicious: Array<{ label: string; ext: string }> = [
|
|
56
|
+
{ label: "path-escape prefix", ext: "../x" },
|
|
57
|
+
{ label: "deep traversal to /etc", ext: "../../etc/passwd" },
|
|
58
|
+
{ label: "absolute path", ext: "/abs/x" },
|
|
59
|
+
{ label: "double-dot alone", ext: ".." },
|
|
60
|
+
{ label: "single-dot alone", ext: "." },
|
|
61
|
+
{ label: "chained after legit prefix", ext: ".png/../../y" },
|
|
62
|
+
{ label: "embedded whitespace", ext: ".p ng" },
|
|
63
|
+
{ label: "over-length (>16 chars)", ext: "." + "a".repeat(17) },
|
|
64
|
+
{ label: "embedded NUL byte", ext: ".p\x00ng" },
|
|
65
|
+
{ label: "backslash traversal", ext: ".\\..\\x" },
|
|
66
|
+
{ label: "double-backslash prefix", ext: "..\\x" },
|
|
67
|
+
];
|
|
68
|
+
for (const { label, ext } of malicious) {
|
|
69
|
+
test(`rejects: ${label} â ext=${JSON.stringify(ext)}`, () => {
|
|
70
|
+
expect(validateIndexEntry({ ...validBase, ext })).toBe(false);
|
|
71
|
+
});
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
test("precondition: 11 malicious cases enumerated (defends against silent test-shrink)", () => {
|
|
75
|
+
// If someone deletes rows from the malicious list, this fails
|
|
76
|
+
// instead of the deletion silently narrowing the guard. Number
|
|
77
|
+
// matches lead's verification list â bump only when lead adds a
|
|
78
|
+
// case and confirms it via real-run.
|
|
79
|
+
expect(malicious.length).toBe(11);
|
|
80
|
+
});
|
|
81
|
+
});
|
|
82
|
+
|
|
83
|
+
describe("NON-REGRESSION: common legitimate extensions all return true (é˛čżäżŽ)", () => {
|
|
84
|
+
// These are the extensions the live upload path actually produces
|
|
85
|
+
// via sanitizeExt / mime-typed multipart uploads. If someone
|
|
86
|
+
// tightens the regex to a stricter whitelist, any of these turning
|
|
87
|
+
// red flags a break in a normal user path.
|
|
88
|
+
const legal = [".png", ".pdf", ".pptx", ".jpg", ".jpeg", ".txt", ".mp4", ".zip", ".json", ".md"];
|
|
89
|
+
for (const ext of legal) {
|
|
90
|
+
test(`accepts: ext=${JSON.stringify(ext)}`, () => {
|
|
91
|
+
expect(validateIndexEntry({ ...validBase, ext })).toBe(true);
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
test("empty ext is accepted (file with no extension is a legitimate upload)", () => {
|
|
96
|
+
expect(validateIndexEntry({ ...validBase, ext: "" })).toBe(true);
|
|
97
|
+
});
|
|
98
|
+
|
|
99
|
+
test("precondition: at least 10 legitimate ext values pinned", () => {
|
|
100
|
+
// Same discipline as the malicious side â reject silent shrink.
|
|
101
|
+
expect(legal.length).toBeGreaterThanOrEqual(10);
|
|
102
|
+
});
|
|
103
|
+
});
|
|
104
|
+
|
|
105
|
+
describe("regex shape assumptions (documented, not enforced by the function)", () => {
|
|
106
|
+
// These rows document facts the current regex enforces beyond the
|
|
107
|
+
// 11 malicious literals. They are close to the boundary and would
|
|
108
|
+
// be the first things to move if someone reworked the regex.
|
|
109
|
+
test("upper-case extensions accepted (regex is case-insensitive by [A-Za-z])", () => {
|
|
110
|
+
expect(validateIndexEntry({ ...validBase, ext: ".PNG" })).toBe(true);
|
|
111
|
+
});
|
|
112
|
+
test("mixed-case extensions accepted", () => {
|
|
113
|
+
expect(validateIndexEntry({ ...validBase, ext: ".PdF" })).toBe(true);
|
|
114
|
+
});
|
|
115
|
+
test("digits after dot accepted (e.g. .mp4, .mp3)", () => {
|
|
116
|
+
expect(validateIndexEntry({ ...validBase, ext: ".mp4" })).toBe(true);
|
|
117
|
+
});
|
|
118
|
+
test("exactly 16 chars after dot is accepted (upper bound of {1,16})", () => {
|
|
119
|
+
expect(validateIndexEntry({ ...validBase, ext: "." + "a".repeat(16) })).toBe(true);
|
|
120
|
+
});
|
|
121
|
+
test("exactly 17 chars after dot is rejected (immediately past upper bound)", () => {
|
|
122
|
+
expect(validateIndexEntry({ ...validBase, ext: "." + "a".repeat(17) })).toBe(false);
|
|
123
|
+
});
|
|
124
|
+
test("compound extensions like .tar.gz are rejected (contains inner dot)", () => {
|
|
125
|
+
// Documented: the current regex does not support compound
|
|
126
|
+
// extensions. If we ever want .tar.gz support, it needs its
|
|
127
|
+
// own explicit design + this row updated with lead sign-off.
|
|
128
|
+
expect(validateIndexEntry({ ...validBase, ext: ".tar.gz" })).toBe(false);
|
|
129
|
+
});
|
|
130
|
+
});
|
|
131
|
+
});
|