smartproxy/changelog.md

Changelog

2025-05-28 - 19.5.0 - feat(socket-handler)

Add socket-handler support for custom socket handling in SmartProxy

• Introduce new action type 'socket-handler' in IRouteAction to allow users to provide a custom socket handler function.
• Update the RouteConnectionHandler to detect 'socket-handler' actions and invoke the handler with the raw socket, giving full control to the user.
• Provide optional context (such as route configuration, client IP, and port) to the socket handler if needed.
• Add helper functions in route-helpers for creating socket handler routes and common patterns like echo, proxy, and line-based protocols.
• Include a detailed implementation plan and usage examples in readme.plan.md.

2025-05-28 - 19.4.3 - fix(smartproxy)

Improve port binding intelligence and ACME challenge route management; update route configuration tests and dependency versions.

• Bumped dev dependency versions in package.json (tsbuild from ^2.5.1 to ^2.6.4, tstest from ^1.9.0 to ^2.3.1, @types/node updated, smartfile from ^11.2.0 to ^11.2.5, smartlog from ^3.1.7 to ^3.1.8)
• Removed readme.plan.md containing legacy development plan information
• Normalized route configuration properties across tests (using 'ports' and 'domains' instead of legacy 'port' or 'domain')
• Enhanced PortManager with reference counting and smarter port conflict detection to avoid redundant bindings
• Refined ACME challenge route integration to merge with existing port bindings and improve error handling
• Adjusted test expectations (e.g. using toEqual instead of toBe, and improved timeout handling) to align with current API changes

2025-05-20 - 19.4.2 - fix(dependencies)

Update dependency versions: upgrade @types/node to ^22.15.20 and @push.rocks/smartlog to ^3.1.7 in package.json

• Bump @types/node from ^22.15.19 to ^22.15.20
• Bump @push.rocks/smartlog from ^3.1.3 to ^3.1.7

2025-05-20 - 19.4.1 - fix(smartproxy)

Bump @push.rocks/smartlog to ^3.1.3 and improve ACME port binding behavior in SmartProxy

• Updated package.json to use @push.rocks/smartlog version ^3.1.3
• Enhanced tests (test.http-port8080-simple.ts) to verify improved port binding intelligence for ACME challenge routes
• Ensured that existing port listeners are reused and not re-bound when updating routes

2025-05-20 - 19.4.0 - feat(certificate-manager, smart-proxy)

Improve port binding intelligence for ACME challenges

• Reordered SmartProxy initialization flow to bind ports before initializing the certificate manager
• Enhanced port binding logic to better handle ACME challenge routes
• Improved error detection and reporting for port binding conflicts
• Added better diagnostics for ACME challenge port issues
• Made route updates more intelligent with detailed port tracking
• Fixed race condition where ACME routes were added before port 80 was bound
• Added special handling for ACME port conflicts with improved error messages

2025-05-20 - 19.3.14 - fix(certificate-manager, smart-proxy)

Add error handling around logger calls in route update callback

• Added try/catch blocks around logger calls in certificate-manager.ts
• Added try/catch blocks around logger calls in smart-proxy.ts related to route updates
• Provided fallback to console.log when logger fails
• Ensured core route update functionality continues to work even if logging fails

2025-05-20 - 19.3.13 - fix(port-manager, certificate-manager)

Improve port binding and ACME challenge route integration in SmartProxy

• Added reference counting in PortManager so that routes sharing the same port reuse the existing binding.
• Enhanced error handling to distinguish internal port conflicts from external ones, with more descriptive messages.
• Adjusted ACME challenge route addition to merge with existing port bindings when port is already in use.
• Refactored updateRoutes to release orphaned ports and bind only new required ports, minimizing rebinding operations.
• Improved certificate-manager logic to provide clearer error notifications when ACME port conflicts occur.

2025-05-19 - 19.3.12 - fix(tests)

Update test mocks to include provisionAllCertificates methods in certificate manager stubs and related objects.

• Added async provisionAllCertificates functions to several test mocks (e.g. in test.port80-management.node.ts, test.route-callback-simple.ts, test.route-update-callback.node.ts, and test.simple-acme-mock.ts) to simulate ACME certificate provisioning.
• Enhanced logging and port-add history debugging for ACME challenge port addition.

2025-05-19 - 19.3.11 - fix(logger)

Replace raw console logging calls with structured logger usage across certificate management, connection handling, and route processing for improved observability.

• Replaced console.log, console.warn, and console.error in SmartCertManager with logger.log for more consistent logging.
• Updated ConnectionManager and RouteConnectionHandler to log detailed connection events using a structured logger.
• Enhanced logging statements with contextual metadata such as connection IDs, remote IPs, target information, and component identifiers.
• Standardized log output across proxy modules to aid in debugging and monitoring.

2025-05-19 - 19.3.10 - fix(certificate-manager, smart-proxy)

Fix race condition in ACME certificate provisioning and refactor certificate manager initialization to defer provisioning until after port listeners are active

• Removed superfluous provisionCertificatesAfterPortsReady method
• Made provisionAllCertificates public so that SmartProxy.start() calls it after ports are listening
• Updated SmartProxy.start() to wait for port setup (via PortManager) before triggering certificate provisioning
• Improved ACME HTTP-01 challenge timing so that port 80 (or configured ACME port) is guaranteed to be ready
• Updated documentation (changelog and Acme timing docs) and tests to reflect the change

2025-05-19 - 19.3.10 - refactor(certificate-manager, smart-proxy)

Simplify certificate provisioning code by removing unnecessary wrapper method

• Removed superfluous SmartCertManager.provisionCertificatesAfterPortsReady() method
• Made SmartCertManager.provisionAllCertificates() public instead
• Updated SmartProxy.start() to call provisionAllCertificates() directly
• Updated documentation and tests to reflect the change
• No functional changes, just code simplification

2025-05-19 - 19.3.9 - fix(certificate-manager, smart-proxy)

Fix ACME certificate provisioning timing to ensure ports are listening first

• Fixed race condition where certificate provisioning would start before ports were listening
• Modified SmartCertManager.initialize() to defer certificate provisioning
• Added SmartCertManager.provisionCertificatesAfterPortsReady() for delayed provisioning
• Updated SmartProxy.start() to call certificate provisioning after ports are ready