Deprecate serializing invalid Dates

Co-authored-by: charmander <1889843+charmander@users.noreply.github.com>

Author: Copilot

packages/pg/lib/utils.js

@@ -1,9 +1,16 @@
 'use strict'
 
 const defaults = require('./defaults')
+const nodeUtils = require('util')
 
 const { isDate } = require('util/types')
 
+const invalidDateDeprecationNotice = nodeUtils.deprecate(
+  () => {},
+  'Sending an invalid date to Postgres is deprecated and will throw an error in the next major version of pg. Ensure any Date object passed as a query parameter is valid.',
+  'PG_INVALID_DATE'
+)
+
 function escapeElement(elementRepresentation) {
   const escaped = elementRepresentation.replace(/\\/g, '\\\\').replace(/"/g, '\\"')
 
@@ -54,6 +61,9 @@ const prepareValue = function (val, seen) {
       return Buffer.from(val.buffer, val.byteOffset, val.byteLength)
     }
     if (isDate(val)) {
+      if (isNaN(val.getTime())) {
+        invalidDateDeprecationNotice()
+      }
       if (defaults.parseInputDatesAsUTC) {
         return dateToStringUTC(val)
       } else {

packages/pg/test/unit/utils-tests.js

@@ -89,6 +89,23 @@ test('prepareValues: 1 BC date prepared properly', function () {
   helper.resetTimezoneOffset()
 })
 
+test('prepareValue: invalid date emits deprecation warning', function () {
+  const warningSeen = new Promise((resolve) => {
+    const onWarning = (warning) => {
+      if (warning.code === 'PG_INVALID_DATE') {
+        process.removeListener('warning', onWarning)
+        resolve()
+      }
+    }
+    process.on('warning', onWarning)
+  })
+
+  const out = utils.prepareValue(new Date(NaN))
+  assert.strictEqual(out, '0NaN-NaN-NaNTNaN:NaN:NaN.NaN+NaN:NaN')
+
+  return warningSeen
+})
+
 test('prepareValues: undefined prepared properly', function () {
   const out = utils.prepareValue(void 0)
   assert.strictEqual(out, null)