rzyfront/vendix-error-handling
skills/vendix-error-handling/SKILL.md
Standardized backend/frontend error handling with VendixHttpException, error-codes.ts, AllExceptionsFilter, validation error mapping, frontend parseApiError, and UX message mapping. Trigger: When adding errors, handling exceptions, mapping API errors, or replacing generic Nest exceptions.
$ install --global
skillsauthnpx skillsauth add rzyfront/vendix vendix-error-handlingInstall 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 16, 2026, 5:08 AM244.5s1 file scanned
SKILL.md
- name:
- vendix-error-handling
- description:
- >
- mapping. Trigger:
- When adding errors, handling exceptions, mapping API errors, or
- license:
- MIT
- author:
- rzyfront
- version:
- 2.0
- scope:
- [root]
- auto_invoke:
- Handling Errors
Vendix Error Handling
Source of Truth
- Backend codes:
apps/backend/src/common/errors/error-codes.ts. - Exception class:
apps/backend/src/common/errors/vendix-http.exception.ts. - Global filter:
apps/backend/src/common/filters/http-exception.filter.ts. - Frontend messages:
apps/frontend/src/app/core/utils/error-messages.ts. - Frontend parser:
apps/frontend/src/app/core/utils/parse-api-error.tsandapi-error-handler.ts.
Backend Pattern
Prefer VendixHttpException with an existing ErrorCodes entry:
throw new VendixHttpException(ErrorCodes.PAYMENT_SOURCE_NOT_FOUND, undefined, { payment_source_id });
The registry contains mixed naming styles. Do not invent a stricter format than the current file; follow nearby domain naming.
Response Shape
Responses include:
statusCodeerror_codemessagetimestamppath- optional
details - optional non-production
devDetails
Validation arrays are mapped by AllExceptionsFilter to SYS_VALIDATION_001. Unknown errors map to SYS_INTERNAL_001.
Frontend Pattern
Use extractApiErrorMessage(error) for simple display. It delegates to parseApiError() when error_code exists and maps to ERROR_MESSAGES.
Use parseApiError() directly only when component behavior depends on the code:
const { errorCode, userMessage } = parseApiError(error);
this.toastService.error(userMessage);
Never display backend developer details to users.
Adding A New Error
- Add the backend code in
error-codes.tsnear the owning domain. - Use
VendixHttpExceptionat the service/controller boundary. - Add or update frontend UX copy in
error-messages.tsif the error can reach UI. - Keep
detailssafe for clients; put sensitive diagnostics only in logs/dev details.
Related Skills
vendix-validationvendix-backend-apivendix-frontend
Related Skills
rzyfront/mobile-dev
development
VerifiedTrustedCommunity
Mobile app development rules for Vendix Expo/React Native project. Trigger: When editing, creating, or modifying any file under apps/mobile, or when developing mobile-specific features.
5SKILL.mdUpdated May 29, 2026
rzyfront/vendix-subscription-gate
development
VerifiedTrustedCommunity
Feature gating by store subscription state: global store write guard, AI feature gate, Redis feature resolution, quota consumption, frontend paywall interceptor, banner, and subscription UI states. Trigger: When adding feature gates, paywalls, subscription-based access control, protecting store write operations, AI feature gates, or rollout flags.
5SKILL.mdUpdated May 16, 2026
rzyfront/vendix-saas-billing
testing
VerifiedTrustedCommunity
SaaS subscription billing for Vendix stores: plan pricing, invoices, Wompi platform payments, manual payments, partner commissions, payouts, proration, and dunning. Trigger: When creating SaaS invoices, working with partner rev-share, margin/surcharge pricing, invoice sequence allocation, partner payout batches, subscription payments, manual payments, or dunning flows.
5SKILL.mdUpdated May 16, 2026
rzyfront/vendix-redis-quota
development
VerifiedTrustedCommunity
Periodic quota counters with Redis, UTC period keys, Lua-based idempotent AI quota consumption, request-id deduplication, and post-success consumption. Trigger: When building quota counters, enforcing monthly/daily feature caps, or reusing AI quota patterns for uploads, emails, exports, or rate-limited features.
5SKILL.mdUpdated May 16, 2026