RELEASE

[phrogwrld]

Description

This PR merges improvements from the develop branch into production, including a new conditional validation system for form schemas, OpenCRVS token management improvements, email template enhancements, and schema updates for birth registration and sell goods forms.

Type of Change

• Bug fix
• New feature
• Breaking change
• Documentation update

Changes Made

Core Validation Updates

• Conditional required fields: Added support for required.when with all/any logic to conditionally require fields based on other field values
• Conditional validations: Added support for validations.condition with then/else branches for dynamic validation rules
• New operators: Support for exists, missing, null, empty, notEmpty, equals, notEquals, in, notIn

Files Changed

New Files

File	Purpose
src/opencrvs/common/opencrvs.constants.ts	Health facilities list and form-specific success/failure messages
src/opencrvs/common/opencrvs.utils.ts	Helper functions for OpenCRVS success/failure messages

Modified Schema Files

File	Changes
schemas/register-birth-form.json	Added conditional required for father object, age fields for mother/father, health facility field, conditional parish/streetAddress validation
schemas/sell-goods-services-beach-park.json	Added firstTestimonial and secondTestimonial objects with name, relationship, address, and testimonial fields

Modified OpenCRVS Files

File	Changes
src/opencrvs/opencrvs.service.ts	Use jwt-decode to calculate token expiry from JWT payload; removed localhost config option
src/opencrvs/opencrvs-cache.service.ts	Changed token buffer from 5 minutes to 2 minutes
src/opencrvs/opencrvs.processor.ts	Moved health facilities to constants file; code formatting cleanup
src/opencrvs/types/opencrvs.types.ts	Added HealthFacility type export

Modified Email Templates

File	Changes
src/email/templates/post-office-redirection-individual-receipt.hbs	Updated "What happens next" with clearer steps: visit Post Office, sign form, verify ID with reference number
src/email/templates/sell-goods-services-beach-park-receipt.hbs	Updated with NCC meeting process, licence collection steps, and pricing details (licence $117.50, watersports $176.25, etc.)

Modified Core Service Files

File	Changes
src/forms/forms.service.ts	Use form-specific success/failure messages from OpenCRVS utils
src/forms/interfaces/form-schema.interface.ts	Added ConditionalRequired, ConditionalWhen, ConditionalRule interfaces; added condition to FieldValidation
src/validation/schema-builder.service.ts	Major update: added superRefine for conditional required and conditional validation evaluation
src/processors/implementations/email.processor.ts	Support for comma-separated email recipients

Infrastructure/Config

File	Changes
src/config/configuration.ts	Removed localhost option for OpenCRVS configuration
package.json	Added jwt-decode ^4.0.0 dependency
package-lock.json	Dependency lock file update

Notes

• The conditional validation system enables complex form logic where fields can be required based on other field values
• OpenCRVS token handling now uses JWT payload expiry instead of response expires_in for more accurate token refresh
• Email templates updated to provide clearer next steps for applicants

Testing

• Conditional required validation works correctly with all/any logic
• Conditional field validations (then/else) apply correctly
• OpenCRVS token refresh with JWT expiry works
• Email templates render correctly with new content
• Comma-separated email recipients send to all addresses
• Birth registration form submits with new conditional fields
• Sell goods form submits with testimonial fields

Related Github Issue(s)/Trello Ticket(s)

• PR Handle validations dynamically #70: Handle validations dynamically
• PR fix: adjust token expiration time from 1 hour to 10 minutes #87: fix: adjust token expiration time from 1 hour to 10 minutes
• PR Quickfix (Sell Goods): Fixed issue where min was making an optional field required #88: Quickfix (Sell Goods): Fixed issue where min was making an optional field required
• PR chore: add testimonial fields to sell goods/services schema #89: chore: add testimonial fields to sell goods/services schema
• PR Chore (Forms): Updated receipt email template for Personal Mail #90: Chore (Forms): Updated receipt email template for Personal Mail

Checklist

• Code follows project style guidelines
• Self-review completed
• Tests added/updated
• Documentation updated

[IsaiahSama]

Looks good to me