Skip to main content

Changelog

All notable changes to MBC CQRS Serverless are documented here. This project follows Semantic Versioning and Conventional Commits.

Version Scheme

  • x.y.z - Production releases
  • x.y.z-beta.n - Beta releases for testing
  • x.y.z-alpha.n - Alpha releases for early access

Stable Releases (1.x)

1.0.26 (2026-01-26)

Features

  • cli: Add configurable local service ports via environment variables (See Details) (PR #300)
    • Support for LOCAL_HTTP_PORT, LOCAL_DYNAMODB_PORT, LOCAL_RDS_PORT, and other port variables
    • Allows users to resolve port conflicts with other services
    • Configuration is automatically applied to Docker Compose, Serverless Offline, and trigger scripts

Security

  • Update diff package from 4.0.2 to 4.0.4 for security fix (PR #297, PR #299)
  • Update lodash package from 4.17.21 to 4.17.23 for prototype pollution fix (PR #298)

1.0.25 (2026-01-19)

Features

  • core: Enhanced inline template email with advanced variable substitution (See Details)
    • Support for nested property access (e.g., {{user.profile.name}})
    • Support for Unicode/Japanese keys in template variables
    • Whitespace trimming inside placeholders (e.g., {{ name }} equals {{name}})
    • Improved local development fallback for template compilation

1.0.24 (2026-01-17)

Features

  • mcp-server: Add Claude Code Skills for guided development assistance (See Details)
    • /mbc-generate: Generate boilerplate code (modules, services, controllers, DTOs, handlers)
    • /mbc-review: Review code for best practices and anti-patterns (20 patterns)
    • /mbc-migrate: Guide version migrations and breaking changes
    • /mbc-debug: Debug and troubleshoot common issues
    • Skills are distributed via npm package and can be installed to ~/.claude/skills/ or .claude/skills/
  • cli: Add mbc install-skills command for easy skills installation (See Details)
    • Install skills to personal directory (~/.claude/skills/) or project directory (.claude/skills/)
    • Options: --project, --force, --list

Bug Fixes

  • core: Fix typo in parameter name skExpession to skExpression
    • Affected packages: core, directory, master, task, ui-setting
    • This was a breaking change for TypeScript users who referenced the old parameter name

1.0.23 (2026-01-16)

Features

  • core: Add inline template email support with sendInlineTemplateEmail() method (See Details)
    • New sendInlineTemplateEmail(msg: TemplatedEmailNotification) method in EmailService
    • Support for inline HTML/text templates with dynamic data substitution
    • Local development fallback with manual template compilation when SES is unavailable
    • New interfaces: InlineTemplateContent, TemplatedEmailNotification

1.0.22 (2026-01-16)

Features

  • mcp-server: Add code analysis tools for AI-assisted development (See Details)
    • mbc_check_anti_patterns: Detect common anti-patterns in code with severity levels
    • mbc_health_check: Project health check (dependencies, structure, configuration)
    • mbc_explain_code: Analyze and explain code in MBC CQRS context

Bug Fixes

  • mcp-server: Improve code analysis tools robustness
    • Renumber anti-patterns sequentially (AP001-AP010)
    • Limit regex match range to prevent false positives
    • Add error handling for file reading and JSON parsing
    • Add 18 unit tests for analyze tools

Security

  • Fix security vulnerabilities in dependencies: qs, express, body-parser

Dependencies

  • Bump qs from 6.13.0 to 6.14.1
  • Bump @nestjs/platform-express from 10.4.20 to 10.4.22
  • Bump express from 4.21.2 to 4.22.1
  • Bump body-parser from 1.20.3 to 1.20.4

1.0.21 (2026-01-15)

Features

  • import: Add ZIP finalization hooks support to ImportModule
    • New IZipFinalizationHook interface for custom post-import processing
    • Register hooks via zipFinalizationHooks option in ImportModule.register()
    • Hooks receive ZipFinalizationContext with results, status, and execution input

1.0.20 (2026-01-11)

Bug Fixes

  • import: Fix Step Functions CSV handler always setting COMPLETED status regardless of child job failures
    • Fixed CsvImportSfnEventHandler.finalizeParentJob() to correctly set status to FAILED when any child job fails
    • Fixed CsvImportSfnEventHandler in csv_loader state to correctly set status when early finalization occurs with failures
    • Previously, the ternary operator was incorrectly returning COMPLETED for both cases: failedRows > 0 ? COMPLETED : COMPLETED
    • Now correctly returns FAILED when failedRows > 0: failedRows > 0 ? FAILED : COMPLETED
    • This bug caused Step Functions to report SUCCESS even when child import jobs failed
    • See CsvImportSfnEventHandler for details

1.0.19 (2026-01-11)

Bug Fixes

  • import: Fix master job status not updating to FAILED when child import jobs fail
    • Previously, when a child import job failed with errors like ConditionalCheckFailedException, the master job status remained PROCESSING indefinitely
    • Fixed incrementParentJobCounters to correctly set master job status to FAILED when any child job fails (was always setting to COMPLETED)
    • Fixed ImportQueueEventHandler.handleImport to call incrementParentJobCounters on error, ensuring parent counters are updated
    • Removed throw error in error handler to prevent Lambda crashes and allow proper status propagation
    • This fix completes the Step Functions error handling started in v1.0.18, ensuring SendTaskFailure is properly triggered
    • See ImportQueueEventHandler Error Handling for details

1.0.18 (2026-01-10)

Bug Fixes

  • import: Add SendTaskFailure support to ImportStatusHandler for proper Step Functions error handling
    • Previously, when an import job failed, the Step Function would wait indefinitely because only SendTaskSuccess was implemented
    • Now the handler properly sends SendTaskFailure when a job fails, allowing Step Functions to handle errors correctly
    • Added sendTaskFailure() method to send SendTaskFailureCommand
    • Handler now processes both COMPLETED and FAILED statuses for CSV import jobs
    • See ImportStatusHandler API for details

1.0.17 (2026-01-08)

Bug Fixes

  • master: Fix masterTypeCode comparison in MasterDataService.search() - Changed from partial match (contains) to exact match for settingCode search parameter (See Details)
  • cli: Stabilize AbstractRunner tests by removing setTimeout to fix flaky CI failures

Security

  • Fix security vulnerabilities in dependencies: jws (HMAC signature verification issue), nodemailer (DoS vulnerability)

Dependencies

  • Bump validator from 13.15.20 to 13.15.26
  • Bump @modelcontextprotocol/sdk from 1.25.1 to 1.25.2

Documentation

  • Update README files for all packages with comprehensive API references and usage examples
  • Fix createTenantGroup parameter name in tenant package README
  • Update Japanese guide links to official documentation

1.0.16 (2025-12-31)

Bug Fixes

  • cli: Add cleanup for test-generated files and update .gitignore
  • master, directory, task, cli: Improve error messages for better clarity

Features

  • Include __s3Key in attributes for import creation
  • Zip mode provide table name
  • Add optional s3Key to CreateImportDto

1.0.15 (2025-12-31)

Bug Fixes

  • ui-setting: Improve error messages for better clarity
  • mcp-server: Use MBC_PROJECT_PATH for ERROR_CATALOG.md lookup

1.0.14 (2025-12-29)

Features

  • mcp-server: Add MCP server package for AI tool integration

Documentation

  • Add comprehensive error message catalog
  • Add JSDoc comments to core interfaces
  • Add operational documentation (FAQ, troubleshooting, security)
  • Add AI-friendly documentation files

1.0.13 (2025-12-26)

Features

  • Enhance CreateZipImportDto and ZipImportQueueEventHandler

1.0.12 (2025-12-23)

Bug Fixes

  • Merge tenant attributes in TenantService

1.0.11 (2025-12-22)

Bug Fixes

  • Handle unknown source IP in SequencesService

1.0.10 (2025-11-28)

Bug Fixes

  • Fix createTenantGroup method in TenantService

1.0.9 (2025-11-26)

Bug Fixes

  • Remove callback parameter from Lambda handler for Node.js 24 compatibility

1.0.8 (2025-11-17)

Security

  • Bump jws dependency for security fix

1.0.7 (2025-11-07)

Security

  • Bump validator dependency in examples
  • Bump js-yaml dependency for security fix

1.0.6 (2025-11-05)

Features

  • master: Add tenantCode support to MasterDataCreateDto and update service logic

1.0.5 (2025-11-04)

Features

  • master: Enhance master settings with tenantCode support in DTOs and service logic

1.0.4 (2025-10-29)

Features

  • core: Add configurable request body size limit to bootstrap and environment validation
  • master: Add bulk creation endpoints for master data and settings

Dependencies

  • Bump validator from 13.11.0/13.12.0 to 13.15.20
  • Bump multer from 1.4.4-lts.1 to 2.0.2 and @nestjs/platform-express from 10.4.4 to 10.4.20
  • Bump axios from 1.7.7 to 1.13.1 in CLI templates

1.0.3 (2025-10-23)

Features

  • master: Add bulk creation endpoints for master data and settings, enabling batch operations for improved efficiency

1.0.2 (2025-10-16)

Features

  • survey: Add survey template API for managing survey templates

Dependencies

  • Bump @nestjs/common from 10.3.0 to 10.4.16 in /examples/master
  • Bump multer from 1.4.4-lts.1 to 2.0.2 and @nestjs/platform-express from 10.4.15 to 10.4.20 in /examples/seq
  • Bump @nestjs/cli from 10.4.5 to 11.0.10 and inquirer from 8.2.6 to 8.2.7

1.0.1 (2025-09-19)

Features

  • import: Add zip mode support for import module, enabling compressed file imports

1.0.0 (2025-09-18)

Highlights

  • First stable production release
  • Based on beta version 0.1.74

Beta Releases (0.1.x)

0.1.75-beta.0

Bug Fixes

  • import: Add SendTaskFailure support to ImportStatusHandler for proper Step Functions error handling
    • Previously, when an import job failed, the Step Function would wait indefinitely because only SendTaskSuccess was implemented
    • Now the handler properly sends SendTaskFailure when a job fails, allowing Step Functions to handle errors correctly
    • Added sendTaskFailure() method to send SendTaskFailureCommand
    • Handler now processes both COMPLETED and FAILED statuses for CSV import jobs
    • See ImportStatusHandler API for details

0.1.74-beta.0 (2025-08-25)

Features

  • Import module implementation
  • Infrastructure updates for import module
  • Local infrastructure updates for import module

0.1.73-beta.0 (2025-07-31)

Bug Fixes

  • master: Fixed package installation issue

0.1.72-beta.0 (2025-07-24)

Features

  • Added case-insensitive search for master data and settings

0.1.71-beta.0 (2025-07-18)

Bug Fixes

  • Fixed core package test failures blocking CI
  • Fixed GitHub workflow issues
  • Handle Step Function name length limit
  • StepFunctionService execution name length validation

Features

  • CLI package comprehensive test enhancement
  • Core package service unit test enhancement
  • Implemented comprehensive unit tests for controllers
  • Master package service unit test enhancement
  • Sequence service test enhancement
  • Task service unit test enhancement
  • Implemented missing service unit tests
  • Implemented unit tests for high-priority packages

0.1.70-beta.0 (2025-07-14)

Bug Fixes

  • master: Fixed master-setting unit test
  • Updated package version

Features

  • master: Added copy to tenant functionality

0.1.69-beta.0 (2025-07-07)

Bug Fixes

  • master: Updated unit test

Features

  • master: Added Prisma option

0.1.68-beta.0 (2025-07-01)

Bug Fixes

  • Fixed build lib CI
  • Updated import template master data module

Features

  • Added template master API

0.1.67-beta.0 (2025-06-10)

Features

  • Enhanced EmailService to support attachments

0.1.65-beta.0 (2025-05-19)

Bug Fixes

  • Fixed empty AppSync URL issue
  • Fixed test AppSync URL

Features

  • Added second AppSync support

0.1.58-beta.0 (2025-04-24)

Bug Fixes

  • Fixed get format sequence from master data item

0.1.55-beta.0 (2025-02-14)

Features

  • Updated template to use Node 20 runtime

0.1.53-beta.0 (2025-02-12)

Features

  • Added queue and Step Function for task processing
  • Task processing by Step Function

0.1.51-beta.0 (2025-01-17)

Bug Fixes

  • Corrected description text

Features

  • Added logger
  • Added schematic description
  • Added schematic for generating controllers
  • Added schematic for generating dto, service, entity
  • Added schematic for generating module

0.1.50-beta.0 (2025-01-14)

Bug Fixes

  • Fixed serialize helper entity field processing

Features

  • Added serialize helper functions for internal/external structure conversion