hoangnguyen0403/nestjs-search
skills/nestjs/nestjs-search/SKILL.md
Integrate Elasticsearch and implement search index Sync patterns in NestJS. Use when integrating Elasticsearch or implementing search index sync in NestJS.
$ install --global
skillsauthnpx skillsauth add hoangnguyen0403/agent-skills-standard nestjs-searchInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 19, 2026, 3:38 AM134.1s2 files scanned
SKILL.md
- name:
- nestjs-search
- description:
- Integrate Elasticsearch and implement search index Sync patterns in NestJS. Use when integrating Elasticsearch or implementing search index sync in NestJS.
Search Engine & Full-Text
Priority: P1 (OPERATIONAL)
- Pattern: CQRS (Command Query Responsibility Segregation).
- Write: To Primary Database (Postgres/MySQL). Source of Truth.
- Read (Complex): To Search Engine (Elasticsearch, OpenSearch, MeiliSearch). Optimized for filtering, fuzzy search, and aggregation.
Synchronization ( Hard Part)
- Dual Write (Anti-Pattern):
await db.save(); await es.index();. - Why: Partial failures leave data inconsistent. Slows down HTTP response.
- Event-Driven (Recommended):
- Service writes to DB.
- Service emits
EntityUpdated. - Event Handler (Async) pushes to Queue (BullMQ).
- Worker indexes document to Search Engine with retries.
- CDC (Golden Standard): Change Data Capture (Debezium). Connects directly to DB transaction log. No app conceptual overhead, but higher ops complexity.
Organization
- Module: Encapsulate client in
SearchModule. - Abstraction: Create generic
SearchService<T>helpers. indexDocument(id, body)search(query, filters)- Mapping: Use
class-transformerto map Entities to "Search Documents". Keep docs flatter than relational entities.
Testing
- E2E: not mock search engine in critical E2E flows.
- Docker: Spin up
elasticsearch:8container in test harness to verify indexing works.
Anti-Patterns
- No dual writes to DB + ES: Use event-driven or CDC pattern; dual writes risk partial failure inconsistency.
- No Elasticsearch for structured queries: Use DB indexes for filtering; ES for full-text and complex search.
- No ES mocks in E2E search tests: Spin up
elasticsearch:8container to verify indexing behavior accurately.
Related Skills
hoangnguyen0403/common-software-requirements
development
VerifiedTrustedCommunity
Standardize SRS and FRS specifications for technical behavior, interfaces, data contracts, quality constraints, and verification mapping. Use when writing SRS, functional specification, system behavior requirements, API/data contracts, or non-functional thresholds.
503SKILL.mdUpdated May 23, 2026
hoangnguyen0403/common-business-requirements
development
VerifiedTrustedCommunity
Standardize BRD and BRD-lite discovery for business goals, stakeholder impact, current-to-future state, and measurable value outcomes. Use when creating BRD, business case, project justification, ROI narrative, or AS-IS to TO-BE scope.
503SKILL.mdUpdated May 23, 2026
hoangnguyen0403/common-tdd
development
VerifiedTrustedCommunity
Implements a strict Red-Green-Refactor loop to ensure zero production code is written without a prior failing test. Use when: creating new features, fixing bugs, or expanding test coverage.
503SKILL.mdUpdated May 10, 2026
hoangnguyen0403/common-product-requirements
testing
VerifiedTrustedCommunity
Standardize PRD discovery and drafting for product scope, user outcomes, requirement IDs, and acceptance criteria. Use when creating PRD, product requirements, feature specification, or acceptance criteria plan.
503SKILL.mdUpdated May 10, 2026