pg-sql2 5.0.0-rc.3 → 5.0.0-rc.5

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { $$type } from "./thereCanBeOnlyOne.js";
-export { version } from "./version.js";
+import { $$type } from "./thereCanBeOnlyOne.ts";
+export { version } from "./version.ts";
 /** Use this to enable coercing objects to SQL to make composing SQL fragments more ergonomic */
 export declare const $$toSQL: unique symbol;
 /** Experimental! */

package/dist/index.js

@@ -24,9 +24,9 @@ const tslib_1 = require("tslib");
 const lru_1 = tslib_1.__importDefault(require("@graphile/lru"));
 const assert = tslib_1.__importStar(require("assert"));
 const util_1 = require("util");
-const thereCanBeOnlyOne_js_1 = require("./thereCanBeOnlyOne.js");
-var version_js_1 = require("./version.js");
-Object.defineProperty(exports, "version", { enumerable: true, get: function () { return version_js_1.version; } });
+const thereCanBeOnlyOne_ts_1 = require("./thereCanBeOnlyOne.js");
+var version_ts_1 = require("./version.js");
+Object.defineProperty(exports, "version", { enumerable: true, get: function () { return version_ts_1.version; } });
 /** Use this to enable coercing objects to SQL to make composing SQL fragments more ergonomic */
 exports.$$toSQL = Symbol("toSQL");
 function exportAs(thing, exportName) {
@@ -50,7 +50,7 @@ const isDev = typeof process !== "undefined" &&
         process.env.GRAPHILE_ENV === "test");
 const defaultIncludeComments = isDev || (typeof process !== "undefined" && process.env.PGSQL2_DEBUG === "1");
 const nodeInspect = function (depth, options) {
-    if (this[thereCanBeOnlyOne_js_1.$$type] === "VALUE") {
+    if (this[thereCanBeOnlyOne_ts_1.$$type] === "VALUE") {
         if (depth < 0) {
             return `sql.value(...)`;
         }
@@ -59,22 +59,22 @@ const nodeInspect = function (depth, options) {
             depth: options.depth == null ? null : options.depth - 1,
         })})`;
     }
-    else if (this[thereCanBeOnlyOne_js_1.$$type] === "RAW") {
+    else if (this[thereCanBeOnlyOne_ts_1.$$type] === "RAW") {
         return `sql\`${this.t}\``;
     }
-    else if (this[thereCanBeOnlyOne_js_1.$$type] === "IDENTIFIER") {
+    else if (this[thereCanBeOnlyOne_ts_1.$$type] === "IDENTIFIER") {
         return `sql.identifier(${JSON.stringify(this.n)})`;
     }
-    else if (this[thereCanBeOnlyOne_js_1.$$type] === "QUERY") {
+    else if (this[thereCanBeOnlyOne_ts_1.$$type] === "QUERY") {
         if (depth < 0) {
             return `sql\`...\``;
         }
         else {
-            return `sql\`${this.n.map((n) => (n[thereCanBeOnlyOne_js_1.$$type] === "RAW" ? n.t : "${" + nodeInspect.call(n, depth + 1, options) + "}")).join("")}\``;
+            return `sql\`${this.n.map((n) => (n[thereCanBeOnlyOne_ts_1.$$type] === "RAW" ? n.t : "${" + nodeInspect.call(n, depth + 1, options) + "}")).join("")}\``;
         }
     }
     else {
-        return `sql{${this[thereCanBeOnlyOne_js_1.$$type]}}`;
+        return `sql{${this[thereCanBeOnlyOne_ts_1.$$type]}}`;
     }
 };
 const pgSQL2Proto = Object.assign(Object.create(null), {
@@ -136,7 +136,7 @@ function makeRawNode(text, exportName) {
     }
     const newNode = {
         __proto__: pgSQL2Proto,
-        [thereCanBeOnlyOne_js_1.$$type]: "RAW",
+        [thereCanBeOnlyOne_ts_1.$$type]: "RAW",
         t: text,
     };
     if (exportName) {
@@ -156,7 +156,7 @@ function makeCommentNode(rawCommentText) {
         .replace(/\/\*/g, "/ *");
     const newNode = {
         __proto__: pgSQL2Proto,
-        [thereCanBeOnlyOne_js_1.$$type]: "COMMENT",
+        [thereCanBeOnlyOne_ts_1.$$type]: "COMMENT",
         commentText,
     };
     return newNode;
@@ -165,7 +165,7 @@ function makeCommentNode(rawCommentText) {
 function makeIdentifierNode(s, n = getSymbolName(s)) {
     return Object.freeze({
         __proto__: pgSQL2Proto,
-        [thereCanBeOnlyOne_js_1.$$type]: "IDENTIFIER",
+        [thereCanBeOnlyOne_ts_1.$$type]: "IDENTIFIER",
         s,
         n,
     });
@@ -174,30 +174,30 @@ function makeIdentifierNode(s, n = getSymbolName(s)) {
 function makeValueNode(rawValue) {
     return Object.freeze({
         __proto__: pgSQL2Proto,
-        [thereCanBeOnlyOne_js_1.$$type]: "VALUE",
+        [thereCanBeOnlyOne_ts_1.$$type]: "VALUE",
         v: rawValue,
     });
 }
 function makeIndentNode(content) {
-    const flags = content[thereCanBeOnlyOne_js_1.$$type] === "QUERY" ? content.f : 0;
+    const flags = content[thereCanBeOnlyOne_ts_1.$$type] === "QUERY" ? content.f : 0;
     return Object.freeze({
-        [thereCanBeOnlyOne_js_1.$$type]: "INDENT",
+        [thereCanBeOnlyOne_ts_1.$$type]: "INDENT",
         f: flags,
-        c: content[thereCanBeOnlyOne_js_1.$$type] === "QUERY"
+        c: content[thereCanBeOnlyOne_ts_1.$$type] === "QUERY"
             ? content
             : makeQueryNode([enforceValidNode(content)]),
     });
 }
 function makeSymbolAliasNode(a, b) {
     return Object.freeze({
-        [thereCanBeOnlyOne_js_1.$$type]: "SYMBOL_ALIAS",
+        [thereCanBeOnlyOne_ts_1.$$type]: "SYMBOL_ALIAS",
         a: a,
         b: b,
     });
 }
 function makePlaceholderNode(symbol, fallback) {
     return Object.freeze({
-        [thereCanBeOnlyOne_js_1.$$type]: "PLACEHOLDER",
+        [thereCanBeOnlyOne_ts_1.$$type]: "PLACEHOLDER",
         s: symbol,
         k: fallback,
     });
@@ -205,7 +205,7 @@ function makePlaceholderNode(symbol, fallback) {
 function makeQueryNode(nodes, flags = 0) {
     let checksum = 0;
     for (const node of nodes) {
-        switch (node[thereCanBeOnlyOne_js_1.$$type]) {
+        switch (node[thereCanBeOnlyOne_ts_1.$$type]) {
             case "RAW": {
                 const { t } = node;
                 // Max value of charCodeAt is 65535. 65535 * 10000 < 2^30.
@@ -238,14 +238,14 @@ function makeQueryNode(nodes, flags = 0) {
                 break;
             }
             default: {
-                const never = node[thereCanBeOnlyOne_js_1.$$type];
+                const never = node[thereCanBeOnlyOne_ts_1.$$type];
                 throw new Error(`Unrecognized node type ${never}`);
             }
         }
     }
     return Object.freeze({
         __proto__: pgSQL2Proto,
-        [thereCanBeOnlyOne_js_1.$$type]: "QUERY",
+        [thereCanBeOnlyOne_ts_1.$$type]: "QUERY",
         n: nodes,
         f: flags,
         c: checksum,
@@ -254,7 +254,7 @@ function makeQueryNode(nodes, flags = 0) {
 function isSQL(node) {
     return (typeof node === "object" &&
         node !== null &&
-        typeof node[thereCanBeOnlyOne_js_1.$$type] === "string");
+        typeof node[thereCanBeOnlyOne_ts_1.$$type] === "string");
 }
 function isSQLable(value) {
     return (typeof value === "object" &&
@@ -333,19 +333,19 @@ function compile(sql, options) {
          * Join this to generate the SQL query
          */
         const sqlFragments = [];
-        const trustedInput = untrustedInput?.[thereCanBeOnlyOne_js_1.$$type] !== undefined
+        const trustedInput = untrustedInput?.[thereCanBeOnlyOne_ts_1.$$type] !== undefined
             ? untrustedInput
             : enforceValidNode(untrustedInput, ``);
-        const items = trustedInput[thereCanBeOnlyOne_js_1.$$type] === "QUERY"
+        const items = trustedInput[thereCanBeOnlyOne_ts_1.$$type] === "QUERY"
             ? expandQueryNodes(trustedInput)
             : [trustedInput];
         const itemCount = items.length;
         for (let itemIndex = 0; itemIndex < itemCount; itemIndex++) {
             const itemAtIndex = items[itemIndex];
-            const item = itemAtIndex?.[thereCanBeOnlyOne_js_1.$$type] !== undefined
+            const item = itemAtIndex?.[thereCanBeOnlyOne_ts_1.$$type] !== undefined
                 ? itemAtIndex
                 : enforceValidNode(itemAtIndex, `item ${itemIndex}`);
-            switch (item[thereCanBeOnlyOne_js_1.$$type]) {
+            switch (item[thereCanBeOnlyOne_ts_1.$$type]) {
                 case "RAW": {
                     if (item.t === "") {
                         // No need to add blank raw text!
@@ -492,19 +492,19 @@ const sqlBase = function sql(strings, ...values) {
         currentText += text;
         if (i < l - 1) {
             const rawVal = values[i];
-            const valid = rawVal?.[thereCanBeOnlyOne_js_1.$$type] !== undefined
+            const valid = rawVal?.[thereCanBeOnlyOne_ts_1.$$type] !== undefined
                 ? rawVal
                 : enforceValidNode(rawVal, `template literal placeholder ${i}`);
-            if (valid[thereCanBeOnlyOne_js_1.$$type] === "RAW") {
+            if (valid[thereCanBeOnlyOne_ts_1.$$type] === "RAW") {
                 currentText += valid.t;
             }
-            else if (valid[thereCanBeOnlyOne_js_1.$$type] === "QUERY") {
+            else if (valid[thereCanBeOnlyOne_ts_1.$$type] === "QUERY") {
                 // NOTE: this clears the flags
                 const nodes = expandQueryNodes(valid);
                 const nodeCount = nodes.length;
                 for (let nodeIndex = 0; nodeIndex < nodeCount; nodeIndex++) {
                     const node = nodes[nodeIndex];
-                    if (node[thereCanBeOnlyOne_js_1.$$type] === "RAW") {
+                    if (node[thereCanBeOnlyOne_ts_1.$$type] === "RAW") {
                         currentText += node.t;
                     }
                     else {
@@ -671,7 +671,7 @@ function join(items, separator = "") {
     }
     else if (items.length === 1) {
         const rawNode = items[0];
-        const node = rawNode?.[thereCanBeOnlyOne_js_1.$$type] !== undefined
+        const node = rawNode?.[thereCanBeOnlyOne_ts_1.$$type] !== undefined
             ? rawNode
             : enforceValidNode(rawNode, `join item ${0}`);
         return node;
@@ -682,15 +682,15 @@ function join(items, separator = "") {
     for (let i = 0, l = items.length; i < l; i++) {
         const rawNode = items[i];
         const addSeparator = i > 0 && hasSeparator;
-        const node = rawNode?.[thereCanBeOnlyOne_js_1.$$type] !== undefined
+        const node = rawNode?.[thereCanBeOnlyOne_ts_1.$$type] !== undefined
             ? rawNode
             : enforceValidNode(rawNode, `join item ${i}`);
         if (addSeparator) {
             currentText += separator;
         }
-        if (node[thereCanBeOnlyOne_js_1.$$type] === "QUERY") {
+        if (node[thereCanBeOnlyOne_ts_1.$$type] === "QUERY") {
             for (const innerNode of expandQueryNodes(node)) {
-                if (innerNode[thereCanBeOnlyOne_js_1.$$type] === "RAW") {
+                if (innerNode[thereCanBeOnlyOne_ts_1.$$type] === "RAW") {
                     currentText += innerNode.t;
                 }
                 else {
@@ -702,7 +702,7 @@ function join(items, separator = "") {
                 }
             }
         }
-        else if (node[thereCanBeOnlyOne_js_1.$$type] === "RAW") {
+        else if (node[thereCanBeOnlyOne_ts_1.$$type] === "RAW") {
             currentText += node.t;
         }
         else {
@@ -753,7 +753,7 @@ function isIdentifierLike(p) {
 }
 function parenthesize(fragment, inFlags = 0) {
     const flags = inFlags | FLAG_HAS_PARENS;
-    if (fragment[thereCanBeOnlyOne_js_1.$$type] === "QUERY") {
+    if (fragment[thereCanBeOnlyOne_ts_1.$$type] === "QUERY") {
         return makeQueryNode(fragment.n, flags);
     }
     else {
@@ -785,7 +785,7 @@ function parenthesize(fragment, inFlags = 0) {
  * - An identifier `table.column.attribute` / `"MyTaBlE"."MyCoLuMn"."MyAtTrIbUtE"` (this needs to be `(table.column).attribute`)
  */
 function parens(frag, force) {
-    if (frag[thereCanBeOnlyOne_js_1.$$type] === "QUERY") {
+    if (frag[thereCanBeOnlyOne_ts_1.$$type] === "QUERY") {
         if ((frag.f & FLAG_HAS_PARENS) === FLAG_HAS_PARENS) {
             return frag;
         }
@@ -804,8 +804,8 @@ function parens(frag, force) {
             // Check for `IDENTIFIER.rawtext`
             // ENHANCE: check for 'rawtext.IDENTIFIER' too
             const [identifier, rawtext] = nodes;
-            if (identifier[thereCanBeOnlyOne_js_1.$$type] !== "IDENTIFIER" ||
-                rawtext[thereCanBeOnlyOne_js_1.$$type] !== "RAW" ||
+            if (identifier[thereCanBeOnlyOne_ts_1.$$type] !== "IDENTIFIER" ||
+                rawtext[thereCanBeOnlyOne_ts_1.$$type] !== "RAW" ||
                 !rawtext.t.startsWith(".")) {
                 return parenthesize(frag);
             }
@@ -820,13 +820,13 @@ function parens(frag, force) {
             for (let i = 0; i < nodeCount; i++) {
                 const node = nodes[i];
                 if (i % 2 === 0) {
-                    if (node[thereCanBeOnlyOne_js_1.$$type] !== "IDENTIFIER" &&
-                        (node[thereCanBeOnlyOne_js_1.$$type] !== "RAW" || !isIdentifierLike(node.t))) {
+                    if (node[thereCanBeOnlyOne_ts_1.$$type] !== "IDENTIFIER" &&
+                        (node[thereCanBeOnlyOne_ts_1.$$type] !== "RAW" || !isIdentifierLike(node.t))) {
                         return parenthesize(frag);
                     }
                 }
                 else {
-                    if (node[thereCanBeOnlyOne_js_1.$$type] !== "RAW" || node.t !== ".") {
+                    if (node[thereCanBeOnlyOne_ts_1.$$type] !== "RAW" || node.t !== ".") {
                         return parenthesize(frag);
                     }
                 }
@@ -837,9 +837,9 @@ function parens(frag, force) {
             return parenthesize(frag);
         }
     }
-    else if (frag[thereCanBeOnlyOne_js_1.$$type] === "INDENT") {
+    else if (frag[thereCanBeOnlyOne_ts_1.$$type] === "INDENT") {
         const inner = parens(frag.c, force);
-        if (inner[thereCanBeOnlyOne_js_1.$$type] === "QUERY" &&
+        if (inner[thereCanBeOnlyOne_ts_1.$$type] === "QUERY" &&
             (inner.f & FLAG_HAS_PARENS) === FLAG_HAS_PARENS) {
             // Move the parens to outside
             return parenthesize(indent(makeQueryNode(inner.n)), inner.f);
@@ -854,16 +854,16 @@ function parens(frag, force) {
     else if (force) {
         return parenthesize(frag);
     }
-    else if (frag[thereCanBeOnlyOne_js_1.$$type] === "VALUE") {
+    else if (frag[thereCanBeOnlyOne_ts_1.$$type] === "VALUE") {
         return frag;
     }
-    else if (frag[thereCanBeOnlyOne_js_1.$$type] === "IDENTIFIER") {
+    else if (frag[thereCanBeOnlyOne_ts_1.$$type] === "IDENTIFIER") {
         return frag;
     }
-    else if (frag[thereCanBeOnlyOne_js_1.$$type] === "COMMENT") {
+    else if (frag[thereCanBeOnlyOne_ts_1.$$type] === "COMMENT") {
         return frag;
     }
-    else if (frag[thereCanBeOnlyOne_js_1.$$type] === "RAW") {
+    else if (frag[thereCanBeOnlyOne_ts_1.$$type] === "RAW") {
         const expr = frag.t;
         if (expr.match(NUMBER_REGEX_1) || expr.match(NUMBER_REGEX_2)) {
             return frag;
@@ -924,31 +924,31 @@ function isEquivalent(sql1, sql2, options) {
     if (sql1 === sql2) {
         return true;
     }
-    else if (sql1[thereCanBeOnlyOne_js_1.$$type] === "QUERY") {
-        if (sql2[thereCanBeOnlyOne_js_1.$$type] !== "QUERY" || sql2.f !== sql1.f || sql2.c !== sql1.c) {
+    else if (sql1[thereCanBeOnlyOne_ts_1.$$type] === "QUERY") {
+        if (sql2[thereCanBeOnlyOne_ts_1.$$type] !== "QUERY" || sql2.f !== sql1.f || sql2.c !== sql1.c) {
             return false;
         }
         return arraysMatch(sql1.n, sql2.n, (a, b) => isEquivalent(a, b, options));
     }
-    else if (sql2[thereCanBeOnlyOne_js_1.$$type] === "QUERY") {
+    else if (sql2[thereCanBeOnlyOne_ts_1.$$type] === "QUERY") {
         return false;
     }
     else {
-        switch (sql1[thereCanBeOnlyOne_js_1.$$type]) {
+        switch (sql1[thereCanBeOnlyOne_ts_1.$$type]) {
             case "RAW": {
-                if (sql2[thereCanBeOnlyOne_js_1.$$type] !== sql1[thereCanBeOnlyOne_js_1.$$type]) {
+                if (sql2[thereCanBeOnlyOne_ts_1.$$type] !== sql1[thereCanBeOnlyOne_ts_1.$$type]) {
                     return false;
                 }
                 return sql1.t === sql2.t;
             }
             case "VALUE": {
-                if (sql2[thereCanBeOnlyOne_js_1.$$type] !== sql1[thereCanBeOnlyOne_js_1.$$type]) {
+                if (sql2[thereCanBeOnlyOne_ts_1.$$type] !== sql1[thereCanBeOnlyOne_ts_1.$$type]) {
                     return false;
                 }
                 return sql1.v === sql2.v;
             }
             case "INDENT": {
-                if (sql2[thereCanBeOnlyOne_js_1.$$type] !== sql1[thereCanBeOnlyOne_js_1.$$type]) {
+                if (sql2[thereCanBeOnlyOne_ts_1.$$type] !== sql1[thereCanBeOnlyOne_ts_1.$$type]) {
                     return false;
                 }
                 return isEquivalent(sql1.c, sql2.c, options);
@@ -957,7 +957,7 @@ function isEquivalent(sql1, sql2, options) {
                 return true;
             }
             case "IDENTIFIER": {
-                if (sql2[thereCanBeOnlyOne_js_1.$$type] !== sql1[thereCanBeOnlyOne_js_1.$$type]) {
+                if (sql2[thereCanBeOnlyOne_ts_1.$$type] !== sql1[thereCanBeOnlyOne_ts_1.$$type]) {
                     return false;
                 }
                 const { n: ids1n, s: ids1s } = sql1;
@@ -970,7 +970,7 @@ function isEquivalent(sql1, sql2, options) {
                 return namesMatch && symbolsMatch;
             }
             case "PLACEHOLDER": {
-                if (sql2[thereCanBeOnlyOne_js_1.$$type] !== sql1[thereCanBeOnlyOne_js_1.$$type]) {
+                if (sql2[thereCanBeOnlyOne_ts_1.$$type] !== sql1[thereCanBeOnlyOne_ts_1.$$type]) {
                     return false;
                 }
                 const symbolSubstitutes = options?.symbolSubstitutes;
@@ -991,7 +991,7 @@ function isEquivalent(sql1, sql2, options) {
     }
 }
 function replaceSymbolInNode(frag, needle, replacement) {
-    switch (frag[thereCanBeOnlyOne_js_1.$$type]) {
+    switch (frag[thereCanBeOnlyOne_ts_1.$$type]) {
         case "COMMENT":
         case "RAW": {
             return frag;
@@ -1033,7 +1033,7 @@ function replaceSymbolInNode(frag, needle, replacement) {
         }
         default: {
             const never = frag;
-            throw new Error(`Unhandled SQL type ${never[thereCanBeOnlyOne_js_1.$$type]}`);
+            throw new Error(`Unhandled SQL type ${never[thereCanBeOnlyOne_ts_1.$$type]}`);
         }
     }
 }
@@ -1041,7 +1041,7 @@ function replaceSymbolInNode(frag, needle, replacement) {
  * @experimental
  */
 function replaceSymbol(frag, needle, replacement) {
-    if (frag[thereCanBeOnlyOne_js_1.$$type] === "QUERY") {
+    if (frag[thereCanBeOnlyOne_ts_1.$$type] === "QUERY") {
         let changed = false;
         const newNodes = frag.n.map((node) => {
             const newNode = replaceSymbolInNode(node, needle, replacement);
@@ -1094,7 +1094,7 @@ function withTransformer(transformer, callback) {
 }
 /** If node is an identifier, return its symbol, otherwise return null */
 function getIdentifierSymbol(potentialIdentifier) {
-    if (potentialIdentifier[thereCanBeOnlyOne_js_1.$$type] === "IDENTIFIER") {
+    if (potentialIdentifier[thereCanBeOnlyOne_ts_1.$$type] === "IDENTIFIER") {
         return potentialIdentifier.s;
     }
     else {

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "5.0.0-rc.3";
+export declare const version = "5.0.0-rc.5";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
 // This file is autogenerated by /scripts/postversion.mjs
-exports.version = "5.0.0-rc.3";
+exports.version = "5.0.0-rc.5";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,16 +1,9 @@
 {
   "name": "pg-sql2",
-  "version": "5.0.0-rc.3",
+  "version": "5.0.0-rc.5",
   "description": "Generate safe Postgres-compliant SQL with tagged template literals",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "scripts": {
-    "pretest": "node dist/index.js",
-    "test": "jest",
-    "posttest": "yarn test:docs",
-    "test:docs": "markdown-doctest",
-    "prepack": "tsc -b"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/graphile/crystal.git"
@@ -34,17 +27,8 @@
     "url": "https://github.com/graphile/crystal/issues"
   },
   "homepage": "https://github.com/graphile/crystal/tree/main/utils/pg-sql2",
-  "devDependencies": {
-    "@types/debug": "^4.1.12",
-    "@types/jest": "^30.0.0",
-    "@types/node": "^22.19.1",
-    "jest": "^30.2.0",
-    "markdown-doctest": "^1.1.0",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
-  },
   "dependencies": {
-    "@graphile/lru": "^5.0.0-rc.3",
+    "@graphile/lru": "^5.0.0-rc.5",
     "tslib": "^2.8.1"
   },
   "files": [

package/CHANGELOG.md

@@ -1,296 +0,0 @@
-# pg-sql2
-
-## 5.0.0-rc.3
-
-### Patch Changes
-
-- [#2873](https://github.com/graphile/crystal/pull/2873)
-  [`0772086`](https://github.com/graphile/crystal/commit/0772086411a55d56b4e345cff1eef133eee31b36)
-  Thanks [@benjie](https://github.com/benjie)! - Update TypeScript configuration
-  to support Node 22 minimum
-
-- [#2888](https://github.com/graphile/crystal/pull/2888)
-  [`1a56db2`](https://github.com/graphile/crystal/commit/1a56db2f53bc455a3d3ba6555a2cd777b27b271c)
-  Thanks [@benjaie](https://github.com/benjaie)! - Node v22+ is required for
-  this module.
-
-- [#2869](https://github.com/graphile/crystal/pull/2869)
-  [`afe31f0`](https://github.com/graphile/crystal/commit/afe31f09a5b204f79321f8db9b42440df23a1183)
-  Thanks [@benjie](https://github.com/benjie)! - Don't allow recursion when
-  calling `node[$$toSQL]()`; customize error message if `$$toSQL` was invoked.
-
-- [#2866](https://github.com/graphile/crystal/pull/2866)
-  [`d3a1be9`](https://github.com/graphile/crystal/commit/d3a1be921d70d143a94ca376d9d08dd85269f5bf)
-  Thanks [@benjie](https://github.com/benjie)! - More explicit types of exported
-  PgSQL
-
-- Updated dependencies
-  [[`0772086`](https://github.com/graphile/crystal/commit/0772086411a55d56b4e345cff1eef133eee31b36),
-  [`1a56db2`](https://github.com/graphile/crystal/commit/1a56db2f53bc455a3d3ba6555a2cd777b27b271c)]:
-  - @graphile/lru@5.0.0-rc.3
-
-## 5.0.0-rc.2
-
-### Patch Changes
-
-- [#2821](https://github.com/graphile/crystal/pull/2821)
-  [`8cfe23f`](https://github.com/graphile/crystal/commit/8cfe23f6e694503ffb99a642f816e858275f5b4e)
-  Thanks [@benjie](https://github.com/benjie)! - Add sql.json API
-
-- [#2829](https://github.com/graphile/crystal/pull/2829)
-  [`a82e6fa`](https://github.com/graphile/crystal/commit/a82e6fae099f7e9d62fb3fc1ee173368cdabca27)
-  Thanks [@benjie](https://github.com/benjie)! - Update dependency ranges.
-
-- Updated dependencies
-  [[`a82e6fa`](https://github.com/graphile/crystal/commit/a82e6fae099f7e9d62fb3fc1ee173368cdabca27)]:
-  - @graphile/lru@5.0.0-rc.2
-
-## 5.0.0-rc.1
-
-### Patch Changes
-
-- [#2740](https://github.com/graphile/crystal/pull/2740)
-  [`31b388c`](https://github.com/graphile/crystal/commit/31b388c6d5546640af7dcf4e6021643e47892ed1)
-  Thanks [@benjie](https://github.com/benjie)! - Support more comment strings.
-
-- [#2746](https://github.com/graphile/crystal/pull/2746)
-  [`930240a`](https://github.com/graphile/crystal/commit/930240a4a7d3373f5691d495df752bb8fedac2af)
-  Thanks [@jemgillam](https://github.com/jemgillam)! - New:
-  `sql.comment("...", true)` forces comments to be included, even in production.
-
-- [`8a5a7c5`](https://github.com/graphile/crystal/commit/8a5a7c536fc4b9b702600c5cc3d413724670c327)
-  Thanks [@benjie](https://github.com/benjie)! - Bump to release candidate
-
-- Updated dependencies
-  [[`8a5a7c5`](https://github.com/graphile/crystal/commit/8a5a7c536fc4b9b702600c5cc3d413724670c327)]:
-  - @graphile/lru@5.0.0-rc.1
-
-## 5.0.0-beta.9
-
-### Patch Changes
-
-- [#2434](https://github.com/graphile/crystal/pull/2434)
-  [`5a26196eff8fd1956d73e0b8fdf5cfcb7f01b7d3`](https://github.com/graphile/crystal/commit/5a26196eff8fd1956d73e0b8fdf5cfcb7f01b7d3)
-  Thanks [@benjie](https://github.com/benjie)! - `util.inspect(someSql)` will
-  now output a much nicer string
-
-- [#2482](https://github.com/graphile/crystal/pull/2482)
-  [`459e1869a2ec58925b2bac5458af487c52a8ca37`](https://github.com/graphile/crystal/commit/459e1869a2ec58925b2bac5458af487c52a8ca37)
-  Thanks [@benjie](https://github.com/benjie)! - Minimum version of Node.js
-  bumped to Node 22 (the latest LTS).
-
-- [#2450](https://github.com/graphile/crystal/pull/2450)
-  [`a87bbd76f1a8b60fd86de65922746d830cc160b4`](https://github.com/graphile/crystal/commit/a87bbd76f1a8b60fd86de65922746d830cc160b4)
-  Thanks [@benjie](https://github.com/benjie)! - Type-only tweak
-
-- [#2525](https://github.com/graphile/crystal/pull/2525)
-  [`c9cd0cc72a4db4b02b2bdf770161c9346cb4b174`](https://github.com/graphile/crystal/commit/c9cd0cc72a4db4b02b2bdf770161c9346cb4b174)
-  Thanks [@benjie](https://github.com/benjie)! - `sql.getIdentifierSymbol(node)`
-  method added to extract a symbol from an identifier node (if a node is an
-  identifier node, otherwise return `null`).
-- Updated dependencies
-  [[`459e1869a2ec58925b2bac5458af487c52a8ca37`](https://github.com/graphile/crystal/commit/459e1869a2ec58925b2bac5458af487c52a8ca37)]:
-  - @graphile/lru@5.0.0-beta.4
-
-## 5.0.0-beta.8
-
-### Patch Changes
-
-- [#2329](https://github.com/graphile/crystal/pull/2329)
-  [`e10c372dafbe0d6014b1e946349b22f40aa87ef9`](https://github.com/graphile/crystal/commit/e10c372dafbe0d6014b1e946349b22f40aa87ef9)
-  Thanks [@benjie](https://github.com/benjie)! - Fix bug causing unhelpful throw
-  on $type optimization on null - instead pass through to more helpful throw.
-
-- [#2341](https://github.com/graphile/crystal/pull/2341)
-  [`3b0f5082b2272997ce33ce8823a4752513d19e28`](https://github.com/graphile/crystal/commit/3b0f5082b2272997ce33ce8823a4752513d19e28)
-  Thanks [@benjie](https://github.com/benjie)! - Some of the pg-sql2 inputs are
-  now marked Readonly to indicate we won't mutate them.
-
-- [#2320](https://github.com/graphile/crystal/pull/2320)
-  [`3789326b2e2fdb86519acc75e606c752ddefe590`](https://github.com/graphile/crystal/commit/3789326b2e2fdb86519acc75e606c752ddefe590)
-  Thanks [@benjie](https://github.com/benjie)! - Add new `withTransformer`
-  functionality to enable embedding of non-SQL values into PgSQL fragments, for
-  improved user ergonomics.
-
-- [#2384](https://github.com/graphile/crystal/pull/2384)
-  [`412b92a0b1e03ad962521f630b57a996d8620cf6`](https://github.com/graphile/crystal/commit/412b92a0b1e03ad962521f630b57a996d8620cf6)
-  Thanks [@benjie](https://github.com/benjie)! - Small optimization/fix to
-  `arraysMatch` function.
-
-## 5.0.0-beta.7
-
-### Patch Changes
-
-- [#2250](https://github.com/graphile/crystal/pull/2250)
-  [`7bf045282`](https://github.com/graphile/crystal/commit/7bf04528264c3b9c509f148253fed96d3394141d)
-  Thanks [@benjie](https://github.com/benjie)! - Export version number.
-
-## 5.0.0-beta.6
-
-### Patch Changes
-
-- [#1994](https://github.com/graphile/crystal/pull/1994)
-  [`ab08cbf9c`](https://github.com/graphile/crystal/commit/ab08cbf9c504c3cc22495a99a965e7634c18a6a3)
-  Thanks [@benjie](https://github.com/benjie)! - Introduce
-  `interface SQLable {[$toSQL](): SQL}` to `pg-sql2` and use it to simplify SQL
-  fragments in various places.
-
-- [#1973](https://github.com/graphile/crystal/pull/1973)
-  [`94a05064e`](https://github.com/graphile/crystal/commit/94a05064ea05108685ff71174a9f871ab5b4c147)
-  Thanks [@benjie](https://github.com/benjie)! - Fix processing of GRAPHILE_ENV
-  to allow "test"
-
-## 5.0.0-beta.5
-
-### Patch Changes
-
-- [#1924](https://github.com/graphile/crystal/pull/1924)
-  [`ef44c29b2`](https://github.com/graphile/crystal/commit/ef44c29b24a1ad5a042ae1536a4546dd64b17195)
-  Thanks [@benjie](https://github.com/benjie)! - 🚨 TypeScript is now configured
-  to hide interfaces marked as `@internal`. This may result in a few errors
-  where you're accessing things you oughtn't be, but also may hide some
-  interfaces that should be exposed - please file an issue if an API you were
-  dependent on has been removed from the TypeScript typings. If that API happens
-  to be `step.dependencies`; you should first read this:
-  https://benjie.dev/graphql/ancestors
-
-## 5.0.0-beta.4
-
-### Patch Changes
-
-- [`2805edc68`](https://github.com/graphile/crystal/commit/2805edc68b90546bf71ffd293af4d87a79345825)
-  Thanks [@benjie](https://github.com/benjie)! - Don't freeze object, so that it
-  can be annotated as exportable.
-
-## 5.0.0-beta.3
-
-### Patch Changes
-
-- [#514](https://github.com/graphile/crystal-pre-merge/pull/514)
-  [`c9848f693`](https://github.com/graphile/crystal-pre-merge/commit/c9848f6936a5abd7740c0638bfb458fb5551f03b)
-  Thanks [@benjie](https://github.com/benjie)! - Update package.json repository
-  information
-
-- Updated dependencies
-  [[`c9848f693`](https://github.com/graphile/crystal-pre-merge/commit/c9848f6936a5abd7740c0638bfb458fb5551f03b)]:
-  - @graphile/lru@5.0.0-beta.3
-
-## 5.0.0-beta.2
-
-### Patch Changes
-
-- [#496](https://github.com/benjie/crystal/pull/496)
-  [`c9bfd9892`](https://github.com/benjie/crystal/commit/c9bfd989247f9433fb5b18c5175c9d8d64cd21a1)
-  Thanks [@benjie](https://github.com/benjie)! - Update dependencies (sometimes
-  through major versions).
-
-- Updated dependencies
-  [[`c9bfd9892`](https://github.com/benjie/crystal/commit/c9bfd989247f9433fb5b18c5175c9d8d64cd21a1)]:
-  - @graphile/lru@5.0.0-beta.2
-
-## 5.0.0-beta.1
-
-### Patch Changes
-
-- [`cbd987385`](https://github.com/benjie/crystal/commit/cbd987385f99bd1248bc093ac507cc2f641ba3e8)
-  Thanks [@benjie](https://github.com/benjie)! - Bump all packages to beta
-
-- Updated dependencies
-  [[`cbd987385`](https://github.com/benjie/crystal/commit/cbd987385f99bd1248bc093ac507cc2f641ba3e8)]:
-  - @graphile/lru@5.0.0-beta.1
-
-## 5.0.0-alpha.3
-
-### Patch Changes
-
-- [#370](https://github.com/benjie/crystal/pull/370)
-  [`339fe20d0`](https://github.com/benjie/crystal/commit/339fe20d0c6e8600d263ce8093cd85a6ea8adbbf)
-  Thanks [@benjie](https://github.com/benjie)! - Allow multiple instances of
-  pg-sql2 and tamedevil to help handle package manager shenanigans.
-
-## 5.0.0-alpha.2
-
-### Patch Changes
-
-- [`82cc01152`](https://github.com/benjie/crystal/commit/82cc01152ee06dafce45299661afd77ad943d785)
-  Thanks [@benjie](https://github.com/benjie)! - Performance overhaul and new
-  cache method.
-
-- [`7f857950a`](https://github.com/benjie/crystal/commit/7f857950a7e4ec763c936eb6bd1fb77824041d71)
-  Thanks [@benjie](https://github.com/benjie)! - Upgrade to the latest
-  TypeScript/tslib
-
-- Updated dependencies
-  [[`98ae00f59`](https://github.com/benjie/crystal/commit/98ae00f59a8ab3edc5718ad8437a0dab734a7d69),
-  [`7f857950a`](https://github.com/benjie/crystal/commit/7f857950a7e4ec763c936eb6bd1fb77824041d71)]:
-  - @graphile/lru@5.0.0-alpha.2
-
-## 5.0.0-alpha.1
-
-### Patch Changes
-
-- [`759ad403d`](https://github.com/benjie/crystal/commit/759ad403d71363312c5225c165873ae84b8a098c)
-  Thanks [@benjie](https://github.com/benjie)! - Alpha release - see
-  https://postgraphile.org/news/2023-04-26-version-5-alpha
-
-- Updated dependencies
-  [[`759ad403d`](https://github.com/benjie/crystal/commit/759ad403d71363312c5225c165873ae84b8a098c)]:
-  - @graphile/lru@5.0.0-alpha.1
-
-## 5.0.0-1.1
-
-### Patch Changes
-
-- [#260](https://github.com/benjie/crystal/pull/260)
-  [`d5312e6b9`](https://github.com/benjie/crystal/commit/d5312e6b968fbeb46d074b82a41b4bdbc166598c)
-  Thanks [@benjie](https://github.com/benjie)! - TypeScript v5 is now required
-
-- [#270](https://github.com/benjie/crystal/pull/270)
-  [`f93c79b94`](https://github.com/benjie/crystal/commit/f93c79b94eb93ae04b1b2e0478f5106e1aca8ee2)
-  Thanks [@benjie](https://github.com/benjie)! - Experimental: expose
-  `symbolToIdentifier` on `sql.compile()` result (via special
-  `$symbolToIdentifier` symbol key) so you can determine which identifiers were
-  used for which symbols.
-
-- [#270](https://github.com/benjie/crystal/pull/270)
-  [`53e164cbc`](https://github.com/benjie/crystal/commit/53e164cbca7eaf1e6e03c849ac1bbe1789c61105)
-  Thanks [@benjie](https://github.com/benjie)! - When the same `sql.value()`
-  node is used in multiple places, it will now be replaced with the same
-  placeholder (`$1`, etc).
-- Updated dependencies
-  [[`d5312e6b9`](https://github.com/benjie/crystal/commit/d5312e6b968fbeb46d074b82a41b4bdbc166598c)]:
-  - @graphile/lru@5.0.0-1.1
-
-## 5.0.0-0.4
-
-### Patch Changes
-
-- [#257](https://github.com/benjie/crystal/pull/257)
-  [`8f323bdc8`](https://github.com/benjie/crystal/commit/8f323bdc88e39924de50775891bd40f1acb9b7cf)
-  Thanks [@benjie](https://github.com/benjie)! - When multiple versions of
-  grafast or pg-sql2 are detected, a warning will be raised.
-
-## 5.0.0-0.3
-
-### Patch Changes
-
-- [`0ab95d0b1`](undefined) - Update sponsors.
-
-## 5.0.0-0.2
-
-### Patch Changes
-
-- [`9b296ba54`](undefined) - More secure, more compatible, and lots of fixes
-  across the monorepo
-
-## 5.0.0-0.1
-
-### Patch Changes
-
-- [#125](https://github.com/benjie/crystal/pull/125)
-  [`91f2256b3`](https://github.com/benjie/crystal/commit/91f2256b3fd699bec19fc86f1ca79df057e58639)
-  Thanks [@benjie](https://github.com/benjie)! - Initial changesets release
-
-- Updated dependencies
-  [[`91f2256b3`](https://github.com/benjie/crystal/commit/91f2256b3fd699bec19fc86f1ca79df057e58639)]:
-  - @graphile/lru@5.0.0-0.1