wisemen-core

Use when scanning NestJS providers with DiscoveryService-backed utilities.

Use when working with the @wisemen/nestjs-custom-fields package — developer-defined custom fields in NestJS with TypeORM persistence and runtime validation. Covers registering the CustomFieldDefinition entity, authoring definitions with customFieldDefinition(), storing resolved values via @CustomFieldValueColumn(), exposing them through CustomFieldValueDto / @IsCustomFields(), and validating submissions with CustomFieldDefinitionsRepository + validateCustomFieldValues(). Use this whenever a task involves custom field definitions, CustomFieldValue columns, custom-field DTOs, or tenant-scoped field definitions, even if the package is not named explicitly.

Use when defining Typesense collections, collectors, and search queries in NestJS APIs.

Generate PDFs through API2PDF in NestJS. Use when converting HTML or URLs to PDFs in apis.

Use when storing and validating multilingual text in NestJS apis with TypeORM and class-validator.

Use when configuring NATS messaging, subscribers, or the simple NatsClient in NestJS applications.

Use when writing tests for NestJS api packages with custom expect matchers, domain events, or transactional TypeORM use cases.

Use when working with domain events and subscribers in NestJS applications.

Create an HTTP client with interceptors. Use when making authenticated HTTP requests from a NestJS service.

Feature flags for NestJS API applications backed by OpenFeature and Go Feature Flag. Use when defining, evaluating feature flags.

Use when generating CSVs in APIs.

Use when parsing CSVs in APIs.

Use when building Express routes with validated body and query DTOs plus standardized error responses.

Use when sending SMS or voice calls in NestJS apis.

Use when validating EU VAT numbers from NestJS APIs.

Use when dealing with monetary values (euros, dollars etc) Supports: - basic arithmetic and rounding utils - columns with typeorm - validation with class-validator - openapi documentation with nestjs

Use when working with geographic coordinates in apis.

Use when documenting discriminated NestJS API responses with Swagger.

Use when dealing with physical quantities like distance, duration, speed, power etc Supports: - basic arithmetic and utils - columns with typeorm - validation with class-validator - openapi documentation with nestjs

Use when configuring Redis caching in NestJS APIs.

Use when bootstrapping NestJS api, worker, or job containers with Express or Fastify.

UITabs provides value-based tabbed navigation, while UITabsRouterLink provides route-based tabbed navigation integrated with Vue Router. Both support three visual variants, horizontal and vertical orientations, full-width mode, and scrollable overflow.

Use when working with street addresses in apis.

Define custom API errors. Use when throwing errors in an api.

Custom class-validator decorators for NestJS DTOs. Use when validating optional, nullable or conditional values.

Offset and Keyset pagination for NestJS applications. Use when an endpoints need a paginated response.

OpenTelemetry for NestJS applications. Use when distributed tracing is needed, and when capturing exceptions.

Avatar system with four components: UIAvatar (image or initials), UIAvatarGroup (stacked row with overflow), UIAvatarGroupAddButton (dashed add action), and UIAvatarLabel (avatar with name and supporting text).

Versatile badge component with support for labels, icons, dots, avatars, and separators. Includes BadgeGroup for wrapping collections and BadgeGroupTruncate for overflow handling.

A hover/focus-triggered floating label built on Reka UI TooltipRoot. Supports configurable delay, side positioning, arrow visibility, and custom content via slots.

Conventions for Storybook stories and playground components in vue-core-design-system. Use when creating, updating, reviewing, or refactoring files in src/**/stories/, especially for argTypes, control hygiene, story naming, meta typing, and showcase story structure.

Resolve npm vulnerabilities. Use when auditing and resolving vulnerabilities.

Extended NestJS TypeOrmModule. Use when working with databases in NestJS applications.

S3 or Azure Blob storage for NestJS. Use when uploading, downloading, etc files.

neverthrow Result architectural basis; three-state AsyncResult relationship to Result; @tanstack/vue-query lifecycle (staleTime, gcTime, refetch); composition of TanStack Query + neverthrow + Vue 3 reactivity.

Install @wisemen/vue-core-api-utils, initialize apiUtilsPlugin with QueryClient config, register typed query keys via module augmentation, set up a typed QueryClient wrapper.

Create, update, delete resources using useMutation, typed queryKeysToInvalidate, AsyncResult error handling, execute function, request shape with body/params separation.

Type-safe QueryClient with get/set/update/invalidate methods, predicate-based updates, cascade invalidation strategy, shared cache across components, lazy refetch patterns.

Combining mutations, cache updates, and AsyncResult to create responsive UIs with instant feedback; optimistic updates with error handling, async transitions, immediate user feedback without request latency.

Infinite pagination with useOffsetInfiniteQuery and useKeysetInfiniteQuery, offset vs keyset strategies determined by backend API, fetchNextPage, hasNextPage, isFetchingNextPage, data/meta result structure, proper page assembly.