Skip to content

fix: use crypto.randomUUID() for trigger conversationId - #13

Merged
mcheemaa merged 1 commit into
ghostwright:mainfrom
jeffklassen:fix/trigger-conversation-id-collision
Apr 5, 2026
Merged

fix: use crypto.randomUUID() for trigger conversationId#13
mcheemaa merged 1 commit into
ghostwright:mainfrom
jeffklassen:fix/trigger-conversation-id-collision

Conversation

@jeffklassen

Copy link
Copy Markdown
Contributor

Summary

  • Replace Date.now() with crypto.randomUUID() for trigger endpoint conversationId generation
  • Date.now() has millisecond precision and can collide when concurrent requests arrive in the same tick, causing session conflicts in the runtime

Test plan

  • All 822 tests pass
  • Lint clean
  • Verify conversationId uniqueness: fire two concurrent POST /trigger requests and confirm distinct conversation IDs in the response

Date.now() has millisecond precision and can collide when multiple
trigger requests arrive simultaneously, causing session conflicts.
Replace with crypto.randomUUID() for guaranteed uniqueness.
@mcheemaa
mcheemaa self-requested a review April 5, 2026 03:28
@mcheemaa
mcheemaa merged commit a605cf3 into ghostwright:mainApr 5, 2026
1 check passed
mutusfa pushed a commit to mutusfa/phantom that referenced this pull request Apr 14, 2026
…sation-id-collision
fix: use crypto.randomUUID() for trigger conversationId
imonlinux added a commit to imonlinux/phantom that referenced this pull request Apr 24, 2026
Complete security review and implementation of fixes for Nextcloud Talk
integration based on comprehensive security audit findings.
HIGH PRIORITY fixes (security-critical):
- ghostwright#1: Implement replay attack protection with LRU cache (5-minute TTL)
- ghostwright#2: Add 64KB request size limit before body buffering
- ghostwright#4: Replace Date.now() with crypto.randomUUID() for unique IDs
- ghostwright#7: Fix JSON unwrap logic for ActivityStreams Note objects
- ghostwright#11: Replace 'Error:' text sniffing with runtime error events
Logic and security fixes:
- ghostwright#3: Fix msgId/msg name collision in error handling
- ghostwright#5: Improve parseConversationId to handle colons in tokens
- ghostwright#6: Reject webhooks without target.id instead of silent fallback
- ghostwright#8: Normalize emoji to avoid variation selector validation issues
- ghostwright#9: Handle 404/409 reaction responses as success conditions
- ghostwright#10: Make setReaction return boolean for proper error handling
- ghostwright#12: Improve bot loop guard with actorId checking
Best practices and polish:
- ghostwright#13: Make port configurable instead of hardcoded 3200
- ghostwright#14: Move webhookPath default normalization to constructor
- ghostwright#15: Fix health check path precedence (check webhook first)
- ghostwright#16: Add exponential backoff retry for 5xx/429 responses
- ghostwright#17: Add URL validation and encoding for talkServer config
- ghostwright#18: Document HMAC signing asymmetry (inbound vs outbound)
- ghostwright#20: Import randomUUID explicitly from node:crypto
- ghostwright#21: Add reactions: true to channel capabilities
- ghostwright#22: Namespace environment variables with NEXTCLOUD_ prefix
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
imonlinux added a commit to imonlinux/phantom that referenced this pull request Apr 26, 2026
…k adapter
Implements full test suite for nextcloud.ts addressing all critical areas
identified in the nextcloud-talk-review document. 943 lines of tests
covering security, functionality, and edge cases.
Test coverage by category:
1. Signature verification (Fixghostwright#1, ghostwright#18) - Security Critical
- Valid HMAC signature acceptance
- Invalid HMAC signature rejection
- Replay attack protection via nonce cache
- Nonce cache size limits (1000 entries, FIFO eviction)
- Nonce expiration and periodic pruning (5-minute TTL)
- Asymmetric signing (inbound: random+body, outbound: random+content)
2. Request size limits (Fixghostwright#2) - Security Critical
- Content-Length validation before buffering
- Double-check after reading (missing Content-Length)
- 64 KB limit enforcement (Nextcloud caps at 32k chars)
3. JSON unwrapping (Fixghostwright#7) - Functionality Critical
- ActivityStreams Note objects unwrap correctly
- Plain text passes through unchanged
- Literal JSON-like text not corrupted (only Note type unwraps)
- Invalid JSON fallback to plain text
4. parseConversationId (Fixghostwright#5) - Correctness Critical
- Valid conversationId format parsing
- Missing prefix returns null
- Tokens containing colons handled correctly (indexOf+slice)
- Thread-scoped ID to room token extraction
5. Bot loop guard (Fixghostwright#12) - Multi-Bot Safety
- Application actor filtering (actorType === "Application")
- Self-filtering (actorId === config.botId)
- Person messages processed normally
- Multi-bot room scenarios
6. Retry and backoff (Fixghostwright#16) - Resilience
- 429 rate limiting with Retry-After header
- 5xx server errors with exponential backoff + jitter
- Network error retry logic
- Non-retryable 4xx handling
7. Reaction error handling (Fixghostwright#9)
- 404 on remove treated as success
- 409 on add treated as success
- 5xx retry for reaction operations
8. URL validation and encoding (Fixghostwright#17)
- talkServer scheme removal (http://, https://)
- Trailing slash removal
- URL-encoding of roomToken and messageId
9. Target validation (Fixghostwright#6)
- Missing target.id rejection (no silent fallback)
10. Emoji normalization (Fixghostwright#8)
- Variation selector removal (U+26A0 vs U+26A0 U+FE0F)
11. Unique message IDs (Fixghostwright#4)
- crypto.randomUUID() vs Date.now()
- Uniqueness across concurrent calls
12. Config normalization (Fixghostwright#13, ghostwright#14)
- webhookPath default in constructor
- Configurable port
- Session window configuration
13. Health check (Fixghostwright#15)
- Path precedence (webhook before health)
14. Message ID extraction
- Numeric and string ID handling
- Missing ID handling
15. Time-window session coalescing
- Recent session continuation
- New session creation
- Parent message ID handling
16. Capabilities declaration (Fixghostwright#21)
- reactions: true declared
All tests use bun:test with mocked dependencies and follow existing
patterns from webhook.test.ts, slack.test.ts, and email.test.ts.
Related: nextcloud-talk-review.md Issue ghostwright#19
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@jeffklassen@mcheemaa