chore: release 4.0.0

[github-actions]

I have created a release PR for this version

4.0.0 (2025-04-23)

⚠ BREAKING CHANGES

• refactor exceptions handling for JsonbArray in the style used for the network types (#311)
• preserve the type of booleans, floats, integers & scientific notations when transforming back and forth between PostgreSQL and PHP (#304)

Features

• Add (limited) support for json_exists, json_query, json_scalar, json_serialize and json_value (#277) (4a26400)
• Add NULL value support for array_append(), array_replace(), array_prepend(), array_remove() and improve test scenarios for NULL (#322) (396856f)
• Add limited support for json_build_object and jsonb_build_object (#268) (2605f5a)
• Add multiple arguments support for ARRAY (#279) (7f2b05d)
• Add support for any_value() (#323) (19ee3db)
• Add support for array_shuffle() (#324) (90a9b9e)
• Add support for DATE_ADD(), DATE_SUBTRACT() and DATE_BIN() (#345) (c3cb08d)
• Add support for DISTINCT and ORDER BY clauses to json_agg() and jsonb_agg() (#317) (4cdc638)
• Add support for DISTINCT clause to array_agg() (#316) (3c46021)
• Add support for JSONB_PATH_EXISTS(), JSONB_PATH_MATCH(), JSONB_PATH_QUERY(), JSONB_PATH_QUERY_ARRAY() and JSONB_PATH_QUERY_FIRST() (#346) (0cda902)
• Add support for ORDER BY clause for array_agg() (#267) (7c64742)
• Add support for REGEXP_COUNT(), REGEXP_INSTR() and REGEXP_SUBSTR() and extend support for REGEXP_REPLACE() (#352) (9959476)
• Add support for xmlagg() (#318) (0b4db8a)
• Add support for arrays of REAL and DOUBLE PRECISION (#307) (1db35ac)
• Add support for network types inet, _inet, cidr, _cidr, macaddr, _macaddr (#310) (ba3f9f2)
• Add support for range functions (#263) (2fa8434)
• Extend existing function support with optional boolean parameters (#347) (67265cc)
• Extend support of REGEXP_LIKE(), REGEXP_MATCH() and REGEXP_REPLACE() while deprecating the legacy limited flagged variations of FlaggedRegexpLike, FlaggedRegexpMatch and FlaggedRegexpReplace (#357) (ef688dc)
• Preserve the type of booleans, floats, integers & scientific notations when transforming back and forth between PostgreSQL and PHP (#304) (c584099)
• Refactor exceptions handling for JsonbArray in the style used for the network types (#311) (0058d1c)

Bug Fixes

• Add support for Lexer v1 (allowed by ORM < v2.15) (#300) (16fd227)
• Avoid infinite parsing loop for GREATEST() and LEAST() by using SimpleArithmeticExpression (#338) (169192b)
• Improve BC by deprecating customiseFunction instead of renaming it straight away (#294) (910d328)
• Restore support for unquoted string values stored in text[] (#333) (339e988)
• Wrap up ORM v3 throwable when parsing fails in variadic functions (#285) (59a8cb9)

Code Refactoring

• Allow multiple node mapping patterns to be used and their arguments to be validated in variadic functions (#350) (e111dd2)
• Allow node mapping in variadic functions to have different patterns, thus opening the path to a combination of node types (compared to the previous single type support) (#349) (6a5ba9e)
• Introduce BaseRegexpFunction and ParserException (#269) (fed0367)
• Modernise the validation in active code and the associated tests when dealing with integer arrays (#308) (67c344e)
• Stricter method argument types when handling variadic functions (#343) (553a30c)
• Validate that variadic functions have only the expected count of arguments (#274) (019f84d)

---

This PR was generated with Release Please. See documentation.