> nestjs-search
Elasticsearch integration and Sync patterns. Use when integrating Elasticsearch or implementing search index sync in NestJS. (triggers: **/*.service.ts, **/search/**, Elasticsearch, CQRS, Synchronization)
curl "https://skillshub.wtf/HoangNguyen0403/agent-skills-standard/nestjs-search?format=md"Search Engine & Full-Text
Priority: P1 (OPERATIONAL)
Full-text search implementation with Elasticsearch and database patterns.
- 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 (The 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 the client in a
SearchModule. - Abstraction: Create generic
SearchService<T>helpers.indexDocument(id, body)search(query, filters)
- Mapping: Use
class-transformerto map Entities to "Search Documents". Search docs should be flatter than Relational entities constraints.
Testing
- E2E: Do not mock the search engine in critical E2E flows.
- Docker: Spin up
elasticsearch:8container in the test harness to verify indexing works.
🚫 Anti-Patterns
- Do NOT use standard patterns if specific project rules exist.
- Do NOT ignore error handling or edge cases.
> related_skills --same-repo
> typescript-tooling
Development tools, linting, and build config for TypeScript. Use when configuring ESLint, Prettier, Jest, Vitest, tsconfig, or any TS build tooling. (triggers: tsconfig.json, .eslintrc.*, jest.config.*, package.json, eslint, prettier, jest, vitest, build, compile, lint)
> typescript-security
Secure coding practices for TypeScript. Use when validating input, handling auth tokens, sanitizing data, or managing secrets and sensitive configuration. (triggers: **/*.ts, **/*.tsx, validate, sanitize, xss, injection, auth, password, secret, token)
> typescript-language
Modern TypeScript standards for type safety and maintainability. Use when working with types, interfaces, generics, enums, unions, or tsconfig settings. (triggers: **/*.ts, **/*.tsx, tsconfig.json, type, interface, generic, enum, union, intersection, readonly, const, namespace)
> typescript-best-practices
Idiomatic TypeScript patterns for clean, maintainable code. Use when writing or refactoring TypeScript classes, functions, modules, or async logic. (triggers: **/*.ts, **/*.tsx, class, function, module, import, export, async, promise)