Wisemen Core

A collection of packages for Wisemen applications.

Contributing

Making Changes

1. Create a PR with your changes
2. Add a changeset to your PR describing the changes using:

   pnpm changeset

   For more details, see the Changesets documentation
3. Merge your PR – this triggers the changeset-release/main workflow
4. Review the auto-generated PR created by the changeset bot, which includes:
   • Updated CHANGELOG files
   • Bumped version numbers
   • Release summary
5. Merge the changeset release PR to automatically publish all changed packages to npm

New Package Setup

When creating a new package:

1. Manual first release – The first version must be published manually since the package doesn't exist on npm yet:

   pnpm publish

2. Setup OIDC Trusted Publishers – Configure your npm package with GitHub OIDC so future releases are automated:
   • Go to your npm package settings
   • Add GitHub as a trusted publisher
   • Configure the repository, branch, and environment

After this setup, all future releases will be automatic through the changeset workflow.

Packages

• Address – Address utilities and validation
• API Error – Standardized API error handling
• API Utils – Common API utilities and helpers
• App Container – Application container component
• Auth – Authentication utilities tailored for Zitadel
• Components – A collection of core UI components
• Components Next – The next generation of UI components
• Coordinates – Coordinate utilities
• CSV – CSV parsing and generation
• Date Range – Date range utilities
• Date Time Range – Date-time range utilities
• Datewise – Date-wise data operations
• Decorators – Useful TypeScript decorators
• Design System – Design system components and tokens
• ESLint Config – Shared ESLint configuration
• ESLint Config NestJS – NestJS-specific ESLint configuration
• ESLint Plugin – Custom ESLint rules
• Express DTO Router – DTO validation for Express routers
• Formango – Form management utilities
• Generator – Code generation tools
• Icons – Icon library and utilities
• Int Range – Integer range utilities
• Localized String – Localization string handling
• Modules – Modular application structure
• Monetary – Monetary value utilities
• NestJS Async API – AsyncAPI integration for NestJS
• NestJS File Storage – File storage for NestJS
• NestJS TypeORM – TypeORM integration for NestJS
• Node Doc Processor – Documentation processor for Node
• One Of – Type-safe union utilities
• Open API Plugins – OpenAPI plugin utilities
• OpenTelemetry – OpenTelemetry integration
• Pagination – Pagination utilities
• PGBoss NestJS Job – PGBoss job queue for NestJS
• Planning – Planning and scheduling utilities
• Quantity – Quantity handling utilities
• Telemetry – Telemetry and monitoring utilities
• Template TypeScript – TypeScript package template
• Template Vue – Vue package template
• Time – Time utilities
• Transformer – Data transformation utilities
• Twilio – Twilio integration utilities
• Validators – Validation utilities and schemas
• VIES – VIES VAT validation
• Wise Date – Advanced date utilities
• Zod HTTP Client (Deprecated) – A Zod-based HTTP client for Vue applications