payload 3.86.0 → 3.87.1

package/dist/uploads/probeImageSize.spec.js

@@ -0,0 +1,366 @@
+import { readFileSync } from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { describe, expect, it } from 'vitest';
+import { probeImageSize } from './probeImageSize.js';
+const dirname = path.dirname(fileURLToPath(import.meta.url));
+const fixturesDir = path.resolve(dirname, '../../../../test/uploads');
+const readFixture = (name)=>readFileSync(path.join(fixturesDir, name));
+// Packs `{ length, value }` fields into a little-endian, LSB-first bitstream,
+// matching the JPEG XL `SizeHeader` bit layout.
+const packJXLBits = (fields)=>{
+    const bits = [];
+    for (const { length, value } of fields){
+        for(let i = 0; i < length; i++){
+            bits.push(value >> i & 1);
+        }
+    }
+    const bytes = Buffer.alloc(Math.ceil(bits.length / 8));
+    bits.forEach((bit, i)=>{
+        if (bit) {
+            bytes[Math.floor(i / 8)] |= 1 << i % 8;
+        }
+    });
+    return bytes;
+};
+// Encodes a non-small `SizeHeader` dimension: a 2-bit size class selecting
+// how many extra bits follow, then `value - 1` in that many bits.
+const packJXLDimension = (value)=>{
+    const n = value - 1;
+    const sizeClasses = [
+        9,
+        13,
+        18,
+        30
+    ];
+    const classIndex = sizeClasses.findIndex((extraBits)=>n < 2 ** extraBits);
+    return [
+        {
+            length: 2,
+            value: classIndex
+        },
+        {
+            length: sizeClasses[classIndex],
+            value: n
+        }
+    ];
+};
+const encodeJXLCodestream = (width, height)=>{
+    const body = packJXLBits([
+        {
+            length: 1,
+            value: 0
+        },
+        ...packJXLDimension(height),
+        {
+            length: 3,
+            value: 0
+        },
+        ...packJXLDimension(width)
+    ]);
+    return Buffer.concat([
+        Buffer.from([
+            0xff,
+            0x0a
+        ]),
+        body
+    ]);
+};
+const encodeSmallJXLCodestream = (width, height)=>{
+    const body = packJXLBits([
+        {
+            length: 1,
+            value: 1
+        },
+        {
+            length: 5,
+            value: height / 8 - 1
+        },
+        {
+            length: 3,
+            value: 0
+        },
+        {
+            length: 5,
+            value: width / 8 - 1
+        }
+    ]);
+    return Buffer.concat([
+        Buffer.from([
+            0xff,
+            0x0a
+        ]),
+        body
+    ]);
+};
+const jxlBox = (type, payload)=>{
+    const box = Buffer.alloc(8 + payload.length);
+    box.writeUInt32BE(box.length, 0);
+    box.write(type, 4, 'ascii');
+    payload.copy(box, 8);
+    return box;
+};
+// The fixed 12-byte JXL container signature box
+const jxlSignatureBox = Buffer.from([
+    0x00,
+    0x00,
+    0x00,
+    0x0c,
+    0x4a,
+    0x58,
+    0x4c,
+    0x20,
+    0x0d,
+    0x0a,
+    0x87,
+    0x0a
+]);
+const jxlFtypBox = jxlBox('ftyp', Buffer.concat([
+    Buffer.from('jxl '),
+    Buffer.alloc(4),
+    Buffer.from('jxl ')
+]));
+describe('probeImageSize', ()=>{
+    // Expected dimensions verified against the previous `image-size` implementation
+    const cases = [
+        {
+            file: 'test-image.png',
+            height: 800,
+            width: 800
+        },
+        {
+            file: 'small.png',
+            height: 80,
+            width: 320
+        },
+        {
+            file: 'image with spaces.png',
+            height: 1600,
+            width: 1600
+        },
+        {
+            file: 'test-image.jpg',
+            height: 800,
+            width: 800
+        },
+        {
+            file: 'test-image.tiff',
+            height: 100,
+            width: 200
+        },
+        {
+            file: 'image.svg',
+            height: 260,
+            width: 260
+        },
+        {
+            file: 'svgWithXml.svg',
+            height: 1,
+            width: 1
+        },
+        {
+            file: 'corrupt.svg',
+            height: 400,
+            width: 400
+        },
+        {
+            file: 'animated.webp',
+            height: 200,
+            width: 200
+        },
+        {
+            file: 'non-animated.webp',
+            height: 420,
+            width: 900
+        },
+        {
+            file: 'test-image-avif.avif',
+            height: 800,
+            width: 800
+        }
+    ];
+    it.each(cases)('should read dimensions for $file', ({ file, height, width })=>{
+        expect(probeImageSize(readFixture(file))).toEqual({
+            height,
+            width
+        });
+    });
+    it('should return the largest image for a HEIF file embedding a thumbnail', ()=>{
+        // Apple HEIC files place a small thumbnail `ispe` before the full-resolution
+        // primary `ispe` inside `ipco`; the primary (largest) must win.
+        const box = (type, payload)=>{
+            const b = Buffer.alloc(8 + payload.length);
+            b.writeUInt32BE(b.length, 0);
+            b.write(type, 4, 'ascii');
+            payload.copy(b, 8);
+            return b;
+        };
+        const ispe = (width, height)=>{
+            const payload = Buffer.alloc(12) // 4 bytes version/flags + width + height
+            ;
+            payload.writeUInt32BE(width, 4);
+            payload.writeUInt32BE(height, 8);
+            return box('ispe', payload);
+        };
+        const ipco = box('ipco', Buffer.concat([
+            ispe(80, 80),
+            ispe(400, 300)
+        ]));
+        const iprp = box('iprp', ipco);
+        const meta = box('meta', Buffer.concat([
+            Buffer.alloc(4),
+            iprp
+        ]));
+        const ftyp = box('ftyp', Buffer.from('avif    '));
+        const heif = Buffer.concat([
+            ftyp,
+            meta
+        ]);
+        expect(probeImageSize(heif)).toEqual({
+            height: 300,
+            width: 400
+        });
+    });
+    it('should throw on an unsupported file type', ()=>{
+        expect(()=>probeImageSize(Buffer.from('not an image'))).toThrow();
+    });
+    it('should read dimensions for a BMP file', ()=>{
+        const bmp = Buffer.alloc(54);
+        bmp.write('BM', 0, 'ascii');
+        bmp.writeUInt32LE(54, 10); // pixel data offset
+        bmp.writeUInt32LE(40, 14); // BITMAPINFOHEADER size
+        bmp.writeInt32LE(64, 18); // width
+        bmp.writeInt32LE(-48, 22); // height stored negative for a top-down bitmap
+        expect(probeImageSize(bmp)).toEqual({
+            height: 48,
+            width: 64
+        });
+    });
+    it('should read dimensions for an ICO file, picking the largest embedded image', ()=>{
+        const ico = Buffer.alloc(24);
+        ico.writeUInt16LE(1, 2); // type: 1 = icon
+        ico.writeUInt16LE(2, 4); // image count
+        ico[6] = 16; // entry 0: 16x16
+        ico[7] = 16;
+        ico[22] = 32; // entry 1: 32x32
+        ico[23] = 32;
+        expect(probeImageSize(ico)).toEqual({
+            height: 32,
+            width: 32
+        });
+    });
+    it('should read dimensions for a CUR file', ()=>{
+        const cur = Buffer.alloc(22);
+        cur.writeUInt16LE(2, 2); // type: 2 = cursor
+        cur.writeUInt16LE(1, 4); // image count
+        cur[6] = 24;
+        cur[7] = 24;
+        expect(probeImageSize(cur)).toEqual({
+            height: 24,
+            width: 24
+        });
+    });
+    it('should not hang on a malformed HEIF buffer with a zero-size box', ()=>{
+        // Reproduces the CVE-2025-71319 trigger: an ISO-BMFF box whose size field is
+        // zero inside a container would loop forever in the unpatched `image-size`.
+        const makeBox = (type, payload)=>{
+            const box = Buffer.alloc(8 + payload.length);
+            box.writeUInt32BE(box.length, 0);
+            box.write(type, 4, 'ascii');
+            payload.copy(box, 8);
+            return box;
+        };
+        const zeroSizeBox = Buffer.alloc(8);
+        zeroSizeBox.write('ipco', 4, 'ascii'); // size field left as 0
+        const meta = makeBox('meta', Buffer.concat([
+            Buffer.alloc(4),
+            zeroSizeBox
+        ]));
+        const ftyp = makeBox('ftyp', Buffer.from('avif    '));
+        const malformed = Buffer.concat([
+            ftyp,
+            meta
+        ]);
+        expect(()=>probeImageSize(malformed)).toThrow();
+    });
+    it('should read dimensions for a bare JPEG XL codestream', ()=>{
+        expect(probeImageSize(encodeJXLCodestream(1920, 1080))).toEqual({
+            height: 1080,
+            width: 1920
+        });
+    });
+    it('should read dimensions for a small bare JPEG XL codestream', ()=>{
+        expect(probeImageSize(encodeSmallJXLCodestream(64, 48))).toEqual({
+            height: 48,
+            width: 64
+        });
+    });
+    it('should read dimensions for a JPEG XL container with a single jxlc box', ()=>{
+        const jxlc = jxlBox('jxlc', encodeJXLCodestream(640, 480));
+        const container = Buffer.concat([
+            jxlSignatureBox,
+            jxlFtypBox,
+            jxlc
+        ]);
+        expect(probeImageSize(container)).toEqual({
+            height: 480,
+            width: 640
+        });
+    });
+    it('should reassemble a JPEG XL codestream split across jxlp boxes', ()=>{
+        const codestream = encodeJXLCodestream(800, 600);
+        const splitPoint = 3;
+        // Each jxlp payload is prefixed with a 4-byte partial-codestream index
+        const jxlp0 = jxlBox('jxlp', Buffer.concat([
+            Buffer.from([
+                0,
+                0,
+                0,
+                0
+            ]),
+            codestream.subarray(0, splitPoint)
+        ]));
+        const jxlp1 = jxlBox('jxlp', Buffer.concat([
+            Buffer.from([
+                0,
+                0,
+                0,
+                1
+            ]),
+            codestream.subarray(splitPoint)
+        ]));
+        const container = Buffer.concat([
+            jxlSignatureBox,
+            jxlFtypBox,
+            jxlp0,
+            jxlp1
+        ]);
+        expect(probeImageSize(container)).toEqual({
+            height: 600,
+            width: 800
+        });
+    });
+    it('should throw rather than hang on a JPEG XL container with a truncated jxlc box', ()=>{
+        const truncatedJxlc = Buffer.alloc(8);
+        truncatedJxlc.write('jxlc', 4, 'ascii'); // size field left as 0: extends to end of buffer, no payload left
+        const container = Buffer.concat([
+            jxlSignatureBox,
+            jxlFtypBox,
+            truncatedJxlc
+        ]);
+        expect(()=>probeImageSize(container)).toThrow();
+    });
+    it('should not hang on a JPEG XL container with thousands of unrelated boxes', ()=>{
+        const unrelatedBoxes = Buffer.concat(Array.from({
+            length: 5000
+        }, ()=>jxlBox('free', Buffer.alloc(0))));
+        const container = Buffer.concat([
+            jxlSignatureBox,
+            jxlFtypBox,
+            unrelatedBoxes
+        ]);
+        expect(()=>probeImageSize(container)).toThrow();
+    });
+});
+
+//# sourceMappingURL=probeImageSize.spec.js.map

package/dist/uploads/probeImageSize.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/uploads/probeImageSize.spec.ts"],"sourcesContent":["import { readFileSync } from 'fs'\nimport path from 'path'\nimport { fileURLToPath } from 'url'\nimport { describe, expect, it } from 'vitest'\n\nimport { probeImageSize } from './probeImageSize.js'\n\nconst dirname = path.dirname(fileURLToPath(import.meta.url))\nconst fixturesDir = path.resolve(dirname, '../../../../test/uploads')\n\nconst readFixture = (name: string) => readFileSync(path.join(fixturesDir, name))\n\n// Packs `{ length, value }` fields into a little-endian, LSB-first bitstream,\n// matching the JPEG XL `SizeHeader` bit layout.\nconst packJXLBits = (fields: Array<{ length: number; value: number }>): Buffer => {\n  const bits: number[] = []\n  for (const { length, value } of fields) {\n    for (let i = 0; i < length; i++) {\n      bits.push((value >> i) & 1)\n    }\n  }\n\n  const bytes = Buffer.alloc(Math.ceil(bits.length / 8))\n  bits.forEach((bit, i) => {\n    if (bit) {\n      bytes[Math.floor(i / 8)]! |= 1 << i % 8\n    }\n  })\n\n  return bytes\n}\n\n// Encodes a non-small `SizeHeader` dimension: a 2-bit size class selecting\n// how many extra bits follow, then `value - 1` in that many bits.\nconst packJXLDimension = (value: number): Array<{ length: number; value: number }> => {\n  const n = value - 1\n  const sizeClasses = [9, 13, 18, 30]\n  const classIndex = sizeClasses.findIndex((extraBits) => n < 2 ** extraBits)\n\n  return [\n    { length: 2, value: classIndex },\n    { length: sizeClasses[classIndex]!, value: n },\n  ]\n}\n\nconst encodeJXLCodestream = (width: number, height: number): Buffer => {\n  const body = packJXLBits([\n    { length: 1, value: 0 }, // isSmallImage = false\n    ...packJXLDimension(height),\n    { length: 3, value: 0 }, // widthMode = 0 (explicit dimension)\n    ...packJXLDimension(width),\n  ])\n\n  return Buffer.concat([Buffer.from([0xff, 0x0a]), body])\n}\n\nconst encodeSmallJXLCodestream = (width: number, height: number): Buffer => {\n  const body = packJXLBits([\n    { length: 1, value: 1 }, // isSmallImage = true\n    { length: 5, value: height / 8 - 1 },\n    { length: 3, value: 0 }, // widthMode = 0 (explicit dimension)\n    { length: 5, value: width / 8 - 1 },\n  ])\n\n  return Buffer.concat([Buffer.from([0xff, 0x0a]), body])\n}\n\nconst jxlBox = (type: string, payload: Buffer): Buffer => {\n  const box = Buffer.alloc(8 + payload.length)\n  box.writeUInt32BE(box.length, 0)\n  box.write(type, 4, 'ascii')\n  payload.copy(box, 8)\n  return box\n}\n\n// The fixed 12-byte JXL container signature box\nconst jxlSignatureBox = Buffer.from([\n  0x00, 0x00, 0x00, 0x0c, 0x4a, 0x58, 0x4c, 0x20, 0x0d, 0x0a, 0x87, 0x0a,\n])\nconst jxlFtypBox = jxlBox(\n  'ftyp',\n  Buffer.concat([Buffer.from('jxl '), Buffer.alloc(4), Buffer.from('jxl ')]),\n)\n\ndescribe('probeImageSize', () => {\n  // Expected dimensions verified against the previous `image-size` implementation\n  const cases: Array<{ file: string; height: number; width: number }> = [\n    { file: 'test-image.png', height: 800, width: 800 },\n    { file: 'small.png', height: 80, width: 320 },\n    { file: 'image with spaces.png', height: 1600, width: 1600 },\n    { file: 'test-image.jpg', height: 800, width: 800 },\n    { file: 'test-image.tiff', height: 100, width: 200 },\n    { file: 'image.svg', height: 260, width: 260 },\n    { file: 'svgWithXml.svg', height: 1, width: 1 },\n    { file: 'corrupt.svg', height: 400, width: 400 },\n    { file: 'animated.webp', height: 200, width: 200 },\n    { file: 'non-animated.webp', height: 420, width: 900 },\n    { file: 'test-image-avif.avif', height: 800, width: 800 },\n  ]\n\n  it.each(cases)('should read dimensions for $file', ({ file, height, width }) => {\n    expect(probeImageSize(readFixture(file))).toEqual({ height, width })\n  })\n\n  it('should return the largest image for a HEIF file embedding a thumbnail', () => {\n    // Apple HEIC files place a small thumbnail `ispe` before the full-resolution\n    // primary `ispe` inside `ipco`; the primary (largest) must win.\n    const box = (type: string, payload: Buffer) => {\n      const b = Buffer.alloc(8 + payload.length)\n      b.writeUInt32BE(b.length, 0)\n      b.write(type, 4, 'ascii')\n      payload.copy(b, 8)\n      return b\n    }\n    const ispe = (width: number, height: number) => {\n      const payload = Buffer.alloc(12) // 4 bytes version/flags + width + height\n      payload.writeUInt32BE(width, 4)\n      payload.writeUInt32BE(height, 8)\n      return box('ispe', payload)\n    }\n    const ipco = box('ipco', Buffer.concat([ispe(80, 80), ispe(400, 300)]))\n    const iprp = box('iprp', ipco)\n    const meta = box('meta', Buffer.concat([Buffer.alloc(4), iprp]))\n    const ftyp = box('ftyp', Buffer.from('avif    '))\n    const heif = Buffer.concat([ftyp, meta])\n\n    expect(probeImageSize(heif)).toEqual({ height: 300, width: 400 })\n  })\n\n  it('should throw on an unsupported file type', () => {\n    expect(() => probeImageSize(Buffer.from('not an image'))).toThrow()\n  })\n\n  it('should read dimensions for a BMP file', () => {\n    const bmp = Buffer.alloc(54)\n    bmp.write('BM', 0, 'ascii')\n    bmp.writeUInt32LE(54, 10) // pixel data offset\n    bmp.writeUInt32LE(40, 14) // BITMAPINFOHEADER size\n    bmp.writeInt32LE(64, 18) // width\n    bmp.writeInt32LE(-48, 22) // height stored negative for a top-down bitmap\n\n    expect(probeImageSize(bmp)).toEqual({ height: 48, width: 64 })\n  })\n\n  it('should read dimensions for an ICO file, picking the largest embedded image', () => {\n    const ico = Buffer.alloc(24)\n    ico.writeUInt16LE(1, 2) // type: 1 = icon\n    ico.writeUInt16LE(2, 4) // image count\n    ico[6] = 16 // entry 0: 16x16\n    ico[7] = 16\n    ico[22] = 32 // entry 1: 32x32\n    ico[23] = 32\n\n    expect(probeImageSize(ico)).toEqual({ height: 32, width: 32 })\n  })\n\n  it('should read dimensions for a CUR file', () => {\n    const cur = Buffer.alloc(22)\n    cur.writeUInt16LE(2, 2) // type: 2 = cursor\n    cur.writeUInt16LE(1, 4) // image count\n    cur[6] = 24\n    cur[7] = 24\n\n    expect(probeImageSize(cur)).toEqual({ height: 24, width: 24 })\n  })\n\n  it('should not hang on a malformed HEIF buffer with a zero-size box', () => {\n    // Reproduces the CVE-2025-71319 trigger: an ISO-BMFF box whose size field is\n    // zero inside a container would loop forever in the unpatched `image-size`.\n    const makeBox = (type: string, payload: Buffer) => {\n      const box = Buffer.alloc(8 + payload.length)\n      box.writeUInt32BE(box.length, 0)\n      box.write(type, 4, 'ascii')\n      payload.copy(box, 8)\n      return box\n    }\n    const zeroSizeBox = Buffer.alloc(8)\n    zeroSizeBox.write('ipco', 4, 'ascii') // size field left as 0\n    const meta = makeBox('meta', Buffer.concat([Buffer.alloc(4), zeroSizeBox]))\n    const ftyp = makeBox('ftyp', Buffer.from('avif    '))\n    const malformed = Buffer.concat([ftyp, meta])\n\n    expect(() => probeImageSize(malformed)).toThrow()\n  })\n\n  it('should read dimensions for a bare JPEG XL codestream', () => {\n    expect(probeImageSize(encodeJXLCodestream(1920, 1080))).toEqual({ height: 1080, width: 1920 })\n  })\n\n  it('should read dimensions for a small bare JPEG XL codestream', () => {\n    expect(probeImageSize(encodeSmallJXLCodestream(64, 48))).toEqual({ height: 48, width: 64 })\n  })\n\n  it('should read dimensions for a JPEG XL container with a single jxlc box', () => {\n    const jxlc = jxlBox('jxlc', encodeJXLCodestream(640, 480))\n    const container = Buffer.concat([jxlSignatureBox, jxlFtypBox, jxlc])\n\n    expect(probeImageSize(container)).toEqual({ height: 480, width: 640 })\n  })\n\n  it('should reassemble a JPEG XL codestream split across jxlp boxes', () => {\n    const codestream = encodeJXLCodestream(800, 600)\n    const splitPoint = 3\n    // Each jxlp payload is prefixed with a 4-byte partial-codestream index\n    const jxlp0 = jxlBox(\n      'jxlp',\n      Buffer.concat([Buffer.from([0, 0, 0, 0]), codestream.subarray(0, splitPoint)]),\n    )\n    const jxlp1 = jxlBox(\n      'jxlp',\n      Buffer.concat([Buffer.from([0, 0, 0, 1]), codestream.subarray(splitPoint)]),\n    )\n    const container = Buffer.concat([jxlSignatureBox, jxlFtypBox, jxlp0, jxlp1])\n\n    expect(probeImageSize(container)).toEqual({ height: 600, width: 800 })\n  })\n\n  it('should throw rather than hang on a JPEG XL container with a truncated jxlc box', () => {\n    const truncatedJxlc = Buffer.alloc(8)\n    truncatedJxlc.write('jxlc', 4, 'ascii') // size field left as 0: extends to end of buffer, no payload left\n    const container = Buffer.concat([jxlSignatureBox, jxlFtypBox, truncatedJxlc])\n\n    expect(() => probeImageSize(container)).toThrow()\n  })\n\n  it('should not hang on a JPEG XL container with thousands of unrelated boxes', () => {\n    const unrelatedBoxes = Buffer.concat(\n      Array.from({ length: 5000 }, () => jxlBox('free', Buffer.alloc(0))),\n    )\n    const container = Buffer.concat([jxlSignatureBox, jxlFtypBox, unrelatedBoxes])\n\n    expect(() => probeImageSize(container)).toThrow()\n  })\n})\n"],"names":["readFileSync","path","fileURLToPath","describe","expect","it","probeImageSize","dirname","url","fixturesDir","resolve","readFixture","name","join","packJXLBits","fields","bits","length","value","i","push","bytes","Buffer","alloc","Math","ceil","forEach","bit","floor","packJXLDimension","n","sizeClasses","classIndex","findIndex","extraBits","encodeJXLCodestream","width","height","body","concat","from","encodeSmallJXLCodestream","jxlBox","type","payload","box","writeUInt32BE","write","copy","jxlSignatureBox","jxlFtypBox","cases","file","each","toEqual","b","ispe","ipco","iprp","meta","ftyp","heif","toThrow","bmp","writeUInt32LE","writeInt32LE","ico","writeUInt16LE","cur","makeBox","zeroSizeBox","malformed","jxlc","container","codestream","splitPoint","jxlp0","subarray","jxlp1","truncatedJxlc","unrelatedBoxes","Array"],"mappings":"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"}

package/dist/utilities/getNextJsHMRURL.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Builds the URL of the Next.js dev HMR WebSocket, on the path served by the
+ * installed Next.js version. `PAYLOAD_HMR_URL_OVERRIDE` is used verbatim.
+ */
+export declare const getNextJsHMRURL: () => string;
+//# sourceMappingURL=getNextJsHMRURL.d.ts.map

package/dist/utilities/getNextJsHMRURL.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNextJsHMRURL.d.ts","sourceRoot":"","sources":["../../src/utilities/getNextJsHMRURL.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAO,MAYlC,CAAA"}

package/dist/utilities/getNextJsHMRURL.js

@@ -0,0 +1,33 @@
+import { compareVersions, parseVersion } from './dependencies/versionUtils.js';
+import { getNextVersion } from './getNextVersion.js';
+/** Next.js serves the dev HMR WebSocket on this path from 16.3 onwards. */ const modernHMRPath = '/_next/hmr';
+/** Next.js served the dev HMR WebSocket on this path before 16.3. */ const legacyHMRPath = '/_next/webpack-hmr';
+const firstModernHMRPathVersion = '16.3.0';
+/**
+ * Builds the URL of the Next.js dev HMR WebSocket, on the path served by the
+ * installed Next.js version. `PAYLOAD_HMR_URL_OVERRIDE` is used verbatim.
+ */ export const getNextJsHMRURL = ()=>{
+    if (process.env.PAYLOAD_HMR_URL_OVERRIDE) {
+        return process.env.PAYLOAD_HMR_URL_OVERRIDE;
+    }
+    const port = process.env.PORT || '3000';
+    const hasHTTPS = process.env.USE_HTTPS === 'true' || process.argv.includes('--experimental-https');
+    const protocol = hasHTTPS ? 'wss' : 'ws';
+    // The __NEXT_ASSET_PREFIX env variable is set for both assetPrefix and basePath (tested in Next.js 15.1.6)
+    const prefix = process.env.__NEXT_ASSET_PREFIX ?? '';
+    return `${protocol}://localhost:${port}${prefix}${getHMRPath()}`;
+};
+/**
+ * Pre-release identifiers are ignored, so that a `16.3.0-canary` build maps to the 16.3 path.
+ * An unreadable version uses the current path, as Payload being unable to resolve Next.js
+ * normally means it is not running under Next.js, where this strategy does not apply.
+ */ const getHMRPath = ()=>{
+    const nextVersion = getNextVersion();
+    if (!nextVersion) {
+        return modernHMRPath;
+    }
+    const mainVersion = parseVersion(nextVersion).parts.join('.');
+    return compareVersions(mainVersion, firstModernHMRPathVersion) === 'lower' ? legacyHMRPath : modernHMRPath;
+};
+
+//# sourceMappingURL=getNextJsHMRURL.js.map

package/dist/utilities/getNextJsHMRURL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getNextJsHMRURL.ts"],"sourcesContent":["import { compareVersions, parseVersion } from './dependencies/versionUtils.js'\nimport { getNextVersion } from './getNextVersion.js'\n\n/** Next.js serves the dev HMR WebSocket on this path from 16.3 onwards. */\nconst modernHMRPath = '/_next/hmr'\n\n/** Next.js served the dev HMR WebSocket on this path before 16.3. */\nconst legacyHMRPath = '/_next/webpack-hmr'\n\nconst firstModernHMRPathVersion = '16.3.0'\n\n/**\n * Builds the URL of the Next.js dev HMR WebSocket, on the path served by the\n * installed Next.js version. `PAYLOAD_HMR_URL_OVERRIDE` is used verbatim.\n */\nexport const getNextJsHMRURL = (): string => {\n  if (process.env.PAYLOAD_HMR_URL_OVERRIDE) {\n    return process.env.PAYLOAD_HMR_URL_OVERRIDE\n  }\n\n  const port = process.env.PORT || '3000'\n  const hasHTTPS = process.env.USE_HTTPS === 'true' || process.argv.includes('--experimental-https')\n  const protocol = hasHTTPS ? 'wss' : 'ws'\n  // The __NEXT_ASSET_PREFIX env variable is set for both assetPrefix and basePath (tested in Next.js 15.1.6)\n  const prefix = process.env.__NEXT_ASSET_PREFIX ?? ''\n\n  return `${protocol}://localhost:${port}${prefix}${getHMRPath()}`\n}\n\n/**\n * Pre-release identifiers are ignored, so that a `16.3.0-canary` build maps to the 16.3 path.\n * An unreadable version uses the current path, as Payload being unable to resolve Next.js\n * normally means it is not running under Next.js, where this strategy does not apply.\n */\nconst getHMRPath = (): string => {\n  const nextVersion = getNextVersion()\n\n  if (!nextVersion) {\n    return modernHMRPath\n  }\n\n  const mainVersion = parseVersion(nextVersion).parts.join('.')\n\n  return compareVersions(mainVersion, firstModernHMRPathVersion) === 'lower'\n    ? legacyHMRPath\n    : modernHMRPath\n}\n"],"names":["compareVersions","parseVersion","getNextVersion","modernHMRPath","legacyHMRPath","firstModernHMRPathVersion","getNextJsHMRURL","process","env","PAYLOAD_HMR_URL_OVERRIDE","port","PORT","hasHTTPS","USE_HTTPS","argv","includes","protocol","prefix","__NEXT_ASSET_PREFIX","getHMRPath","nextVersion","mainVersion","parts","join"],"mappings":"AAAA,SAASA,eAAe,EAAEC,YAAY,QAAQ,iCAAgC;AAC9E,SAASC,cAAc,QAAQ,sBAAqB;AAEpD,yEAAyE,GACzE,MAAMC,gBAAgB;AAEtB,mEAAmE,GACnE,MAAMC,gBAAgB;AAEtB,MAAMC,4BAA4B;AAElC;;;CAGC,GACD,OAAO,MAAMC,kBAAkB;IAC7B,IAAIC,QAAQC,GAAG,CAACC,wBAAwB,EAAE;QACxC,OAAOF,QAAQC,GAAG,CAACC,wBAAwB;IAC7C;IAEA,MAAMC,OAAOH,QAAQC,GAAG,CAACG,IAAI,IAAI;IACjC,MAAMC,WAAWL,QAAQC,GAAG,CAACK,SAAS,KAAK,UAAUN,QAAQO,IAAI,CAACC,QAAQ,CAAC;IAC3E,MAAMC,WAAWJ,WAAW,QAAQ;IACpC,2GAA2G;IAC3G,MAAMK,SAASV,QAAQC,GAAG,CAACU,mBAAmB,IAAI;IAElD,OAAO,GAAGF,SAAS,aAAa,EAAEN,OAAOO,SAASE,cAAc;AAClE,EAAC;AAED;;;;CAIC,GACD,MAAMA,aAAa;IACjB,MAAMC,cAAclB;IAEpB,IAAI,CAACkB,aAAa;QAChB,OAAOjB;IACT;IAEA,MAAMkB,cAAcpB,aAAamB,aAAaE,KAAK,CAACC,IAAI,CAAC;IAEzD,OAAOvB,gBAAgBqB,aAAahB,+BAA+B,UAC/DD,gBACAD;AACN"}

package/dist/utilities/getNextJsHMRURL.spec.js

@@ -0,0 +1,60 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+vi.mock('./getNextVersion.js', ()=>({
+        getNextVersion: vi.fn()
+    }));
+const { getNextVersion } = await import('./getNextVersion.js');
+const { getNextJsHMRURL } = await import('./getNextJsHMRURL.js');
+const modernURL = 'ws://localhost:3000/_next/hmr';
+const legacyURL = 'ws://localhost:3000/_next/webpack-hmr';
+describe('getNextJsHMRURL', ()=>{
+    beforeEach(()=>{
+        vi.mocked(getNextVersion).mockReturnValue('16.3.0');
+        vi.stubEnv('PAYLOAD_HMR_URL_OVERRIDE', undefined);
+        vi.stubEnv('PORT', '3000');
+    });
+    afterEach(()=>{
+        vi.unstubAllEnvs();
+    });
+    it('should use the current HMR path on Next.js 16.3', ()=>{
+        expect(getNextJsHMRURL()).toBe(modernURL);
+    });
+    it('should use the current HMR path on Next.js versions above 16.3', ()=>{
+        vi.mocked(getNextVersion).mockReturnValue('17.0.1');
+        expect(getNextJsHMRURL()).toBe(modernURL);
+    });
+    it('should use the legacy HMR path on Next.js below 16.3', ()=>{
+        vi.mocked(getNextVersion).mockReturnValue('16.2.7');
+        expect(getNextJsHMRURL()).toBe(legacyURL);
+    });
+    it('should use the legacy HMR path on a Next.js 15 install', ()=>{
+        vi.mocked(getNextVersion).mockReturnValue('15.5.0');
+        expect(getNextJsHMRURL()).toBe(legacyURL);
+    });
+    it('should ignore pre-release identifiers when choosing the path', ()=>{
+        vi.mocked(getNextVersion).mockReturnValue('16.3.0-canary.12');
+        expect(getNextJsHMRURL()).toBe(modernURL);
+    });
+    it('should use the legacy HMR path on a pre-release below 16.3', ()=>{
+        vi.mocked(getNextVersion).mockReturnValue('16.2.0-canary.5');
+        expect(getNextJsHMRURL()).toBe(legacyURL);
+    });
+    it('should use the current HMR path when the Next.js version is unknown', ()=>{
+        vi.mocked(getNextVersion).mockReturnValue(undefined);
+        expect(getNextJsHMRURL()).toBe(modernURL);
+    });
+    it('should use PAYLOAD_HMR_URL_OVERRIDE whatever the version', ()=>{
+        vi.mocked(getNextVersion).mockReturnValue(undefined);
+        vi.stubEnv('PAYLOAD_HMR_URL_OVERRIDE', 'ws://localhost:4000/custom-hmr');
+        expect(getNextJsHMRURL()).toBe('ws://localhost:4000/custom-hmr');
+    });
+    it('should use the wss protocol when HTTPS is enabled', ()=>{
+        vi.stubEnv('USE_HTTPS', 'true');
+        expect(getNextJsHMRURL()).toBe('wss://localhost:3000/_next/hmr');
+    });
+    it('should include the Next.js asset prefix', ()=>{
+        vi.stubEnv('__NEXT_ASSET_PREFIX', '/base');
+        expect(getNextJsHMRURL()).toBe('ws://localhost:3000/base/_next/hmr');
+    });
+});
+
+//# sourceMappingURL=getNextJsHMRURL.spec.js.map

package/dist/utilities/getNextJsHMRURL.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getNextJsHMRURL.spec.ts"],"sourcesContent":["import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'\n\nvi.mock('./getNextVersion.js', () => ({ getNextVersion: vi.fn() }))\n\nconst { getNextVersion } = await import('./getNextVersion.js')\nconst { getNextJsHMRURL } = await import('./getNextJsHMRURL.js')\n\nconst modernURL = 'ws://localhost:3000/_next/hmr'\nconst legacyURL = 'ws://localhost:3000/_next/webpack-hmr'\n\ndescribe('getNextJsHMRURL', () => {\n  beforeEach(() => {\n    vi.mocked(getNextVersion).mockReturnValue('16.3.0')\n    vi.stubEnv('PAYLOAD_HMR_URL_OVERRIDE', undefined)\n    vi.stubEnv('PORT', '3000')\n  })\n\n  afterEach(() => {\n    vi.unstubAllEnvs()\n  })\n\n  it('should use the current HMR path on Next.js 16.3', () => {\n    expect(getNextJsHMRURL()).toBe(modernURL)\n  })\n\n  it('should use the current HMR path on Next.js versions above 16.3', () => {\n    vi.mocked(getNextVersion).mockReturnValue('17.0.1')\n\n    expect(getNextJsHMRURL()).toBe(modernURL)\n  })\n\n  it('should use the legacy HMR path on Next.js below 16.3', () => {\n    vi.mocked(getNextVersion).mockReturnValue('16.2.7')\n\n    expect(getNextJsHMRURL()).toBe(legacyURL)\n  })\n\n  it('should use the legacy HMR path on a Next.js 15 install', () => {\n    vi.mocked(getNextVersion).mockReturnValue('15.5.0')\n\n    expect(getNextJsHMRURL()).toBe(legacyURL)\n  })\n\n  it('should ignore pre-release identifiers when choosing the path', () => {\n    vi.mocked(getNextVersion).mockReturnValue('16.3.0-canary.12')\n\n    expect(getNextJsHMRURL()).toBe(modernURL)\n  })\n\n  it('should use the legacy HMR path on a pre-release below 16.3', () => {\n    vi.mocked(getNextVersion).mockReturnValue('16.2.0-canary.5')\n\n    expect(getNextJsHMRURL()).toBe(legacyURL)\n  })\n\n  it('should use the current HMR path when the Next.js version is unknown', () => {\n    vi.mocked(getNextVersion).mockReturnValue(undefined)\n\n    expect(getNextJsHMRURL()).toBe(modernURL)\n  })\n\n  it('should use PAYLOAD_HMR_URL_OVERRIDE whatever the version', () => {\n    vi.mocked(getNextVersion).mockReturnValue(undefined)\n    vi.stubEnv('PAYLOAD_HMR_URL_OVERRIDE', 'ws://localhost:4000/custom-hmr')\n\n    expect(getNextJsHMRURL()).toBe('ws://localhost:4000/custom-hmr')\n  })\n\n  it('should use the wss protocol when HTTPS is enabled', () => {\n    vi.stubEnv('USE_HTTPS', 'true')\n\n    expect(getNextJsHMRURL()).toBe('wss://localhost:3000/_next/hmr')\n  })\n\n  it('should include the Next.js asset prefix', () => {\n    vi.stubEnv('__NEXT_ASSET_PREFIX', '/base')\n\n    expect(getNextJsHMRURL()).toBe('ws://localhost:3000/base/_next/hmr')\n  })\n})\n"],"names":["afterEach","beforeEach","describe","expect","it","vi","mock","getNextVersion","fn","getNextJsHMRURL","modernURL","legacyURL","mocked","mockReturnValue","stubEnv","undefined","unstubAllEnvs","toBe"],"mappings":"AAAA,SAASA,SAAS,EAAEC,UAAU,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,EAAEC,EAAE,QAAQ,SAAQ;AAExEA,GAAGC,IAAI,CAAC,uBAAuB,IAAO,CAAA;QAAEC,gBAAgBF,GAAGG,EAAE;IAAG,CAAA;AAEhE,MAAM,EAAED,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC;AACxC,MAAM,EAAEE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC;AAEzC,MAAMC,YAAY;AAClB,MAAMC,YAAY;AAElBT,SAAS,mBAAmB;IAC1BD,WAAW;QACTI,GAAGO,MAAM,CAACL,gBAAgBM,eAAe,CAAC;QAC1CR,GAAGS,OAAO,CAAC,4BAA4BC;QACvCV,GAAGS,OAAO,CAAC,QAAQ;IACrB;IAEAd,UAAU;QACRK,GAAGW,aAAa;IAClB;IAEAZ,GAAG,mDAAmD;QACpDD,OAAOM,mBAAmBQ,IAAI,CAACP;IACjC;IAEAN,GAAG,kEAAkE;QACnEC,GAAGO,MAAM,CAACL,gBAAgBM,eAAe,CAAC;QAE1CV,OAAOM,mBAAmBQ,IAAI,CAACP;IACjC;IAEAN,GAAG,wDAAwD;QACzDC,GAAGO,MAAM,CAACL,gBAAgBM,eAAe,CAAC;QAE1CV,OAAOM,mBAAmBQ,IAAI,CAACN;IACjC;IAEAP,GAAG,0DAA0D;QAC3DC,GAAGO,MAAM,CAACL,gBAAgBM,eAAe,CAAC;QAE1CV,OAAOM,mBAAmBQ,IAAI,CAACN;IACjC;IAEAP,GAAG,gEAAgE;QACjEC,GAAGO,MAAM,CAACL,gBAAgBM,eAAe,CAAC;QAE1CV,OAAOM,mBAAmBQ,IAAI,CAACP;IACjC;IAEAN,GAAG,8DAA8D;QAC/DC,GAAGO,MAAM,CAACL,gBAAgBM,eAAe,CAAC;QAE1CV,OAAOM,mBAAmBQ,IAAI,CAACN;IACjC;IAEAP,GAAG,uEAAuE;QACxEC,GAAGO,MAAM,CAACL,gBAAgBM,eAAe,CAACE;QAE1CZ,OAAOM,mBAAmBQ,IAAI,CAACP;IACjC;IAEAN,GAAG,4DAA4D;QAC7DC,GAAGO,MAAM,CAACL,gBAAgBM,eAAe,CAACE;QAC1CV,GAAGS,OAAO,CAAC,4BAA4B;QAEvCX,OAAOM,mBAAmBQ,IAAI,CAAC;IACjC;IAEAb,GAAG,qDAAqD;QACtDC,GAAGS,OAAO,CAAC,aAAa;QAExBX,OAAOM,mBAAmBQ,IAAI,CAAC;IACjC;IAEAb,GAAG,2CAA2C;QAC5CC,GAAGS,OAAO,CAAC,uBAAuB;QAElCX,OAAOM,mBAAmBQ,IAAI,CAAC;IACjC;AACF"}

package/dist/utilities/getNextVersion.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Reads the version of the Next.js installed alongside the running app.
+ * Returns undefined if Next.js cannot be resolved, e.g. because Payload runs
+ * outside of Next.js or from a directory the app's dependencies are not visible from.
+ */
+export declare const getNextVersion: () => string | undefined;
+//# sourceMappingURL=getNextVersion.d.ts.map

package/dist/utilities/getNextVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNextVersion.d.ts","sourceRoot":"","sources":["../../src/utilities/getNextVersion.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,MAAM,GAAG,SAc1C,CAAA"}

package/dist/utilities/getNextVersion.js

@@ -0,0 +1,20 @@
+import { readFileSync } from 'fs';
+import { resolveFrom } from './dependencies/resolveFrom.js';
+/**
+ * Reads the version of the Next.js installed alongside the running app.
+ * Returns undefined if Next.js cannot be resolved, e.g. because Payload runs
+ * outside of Next.js or from a directory the app's dependencies are not visible from.
+ */ export const getNextVersion = ()=>{
+    try {
+        const packageJSONPath = resolveFrom(process.cwd(), 'next/package.json', true);
+        if (!packageJSONPath) {
+            return undefined;
+        }
+        const { version } = JSON.parse(readFileSync(packageJSONPath, 'utf-8'));
+        return typeof version === 'string' ? version : undefined;
+    } catch (_) {
+        return undefined;
+    }
+};
+
+//# sourceMappingURL=getNextVersion.js.map

package/dist/utilities/getNextVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getNextVersion.ts"],"sourcesContent":["import { readFileSync } from 'fs'\n\nimport { resolveFrom } from './dependencies/resolveFrom.js'\n\n/**\n * Reads the version of the Next.js installed alongside the running app.\n * Returns undefined if Next.js cannot be resolved, e.g. because Payload runs\n * outside of Next.js or from a directory the app's dependencies are not visible from.\n */\nexport const getNextVersion = (): string | undefined => {\n  try {\n    const packageJSONPath = resolveFrom(process.cwd(), 'next/package.json', true)\n\n    if (!packageJSONPath) {\n      return undefined\n    }\n\n    const { version } = JSON.parse(readFileSync(packageJSONPath, 'utf-8'))\n\n    return typeof version === 'string' ? version : undefined\n  } catch (_) {\n    return undefined\n  }\n}\n"],"names":["readFileSync","resolveFrom","getNextVersion","packageJSONPath","process","cwd","undefined","version","JSON","parse","_"],"mappings":"AAAA,SAASA,YAAY,QAAQ,KAAI;AAEjC,SAASC,WAAW,QAAQ,gCAA+B;AAE3D;;;;CAIC,GACD,OAAO,MAAMC,iBAAiB;IAC5B,IAAI;QACF,MAAMC,kBAAkBF,YAAYG,QAAQC,GAAG,IAAI,qBAAqB;QAExE,IAAI,CAACF,iBAAiB;YACpB,OAAOG;QACT;QAEA,MAAM,EAAEC,OAAO,EAAE,GAAGC,KAAKC,KAAK,CAACT,aAAaG,iBAAiB;QAE7D,OAAO,OAAOI,YAAY,WAAWA,UAAUD;IACjD,EAAE,OAAOI,GAAG;QACV,OAAOJ;IACT;AACF,EAAC"}

package/dist/utilities/getNextVersion.spec.js

@@ -0,0 +1,16 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { getNextVersion } from './getNextVersion.js';
+describe('getNextVersion', ()=>{
+    afterEach(()=>{
+        vi.restoreAllMocks();
+    });
+    it('should read the version of the installed Next.js', ()=>{
+        expect(getNextVersion()).toMatch(/^\d+\.\d+\.\d+/);
+    });
+    it('should return undefined when Next.js cannot be resolved', ()=>{
+        vi.spyOn(process, 'cwd').mockReturnValue('/');
+        expect(getNextVersion()).toBeUndefined();
+    });
+});
+
+//# sourceMappingURL=getNextVersion.spec.js.map

package/dist/utilities/getNextVersion.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getNextVersion.spec.ts"],"sourcesContent":["import { afterEach, describe, expect, it, vi } from 'vitest'\n\nimport { getNextVersion } from './getNextVersion.js'\n\ndescribe('getNextVersion', () => {\n  afterEach(() => {\n    vi.restoreAllMocks()\n  })\n\n  it('should read the version of the installed Next.js', () => {\n    expect(getNextVersion()).toMatch(/^\\d+\\.\\d+\\.\\d+/)\n  })\n\n  it('should return undefined when Next.js cannot be resolved', () => {\n    vi.spyOn(process, 'cwd').mockReturnValue('/')\n\n    expect(getNextVersion()).toBeUndefined()\n  })\n})\n"],"names":["afterEach","describe","expect","it","vi","getNextVersion","restoreAllMocks","toMatch","spyOn","process","mockReturnValue","toBeUndefined"],"mappings":"AAAA,SAASA,SAAS,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,EAAEC,EAAE,QAAQ,SAAQ;AAE5D,SAASC,cAAc,QAAQ,sBAAqB;AAEpDJ,SAAS,kBAAkB;IACzBD,UAAU;QACRI,GAAGE,eAAe;IACpB;IAEAH,GAAG,oDAAoD;QACrDD,OAAOG,kBAAkBE,OAAO,CAAC;IACnC;IAEAJ,GAAG,2DAA2D;QAC5DC,GAAGI,KAAK,CAACC,SAAS,OAAOC,eAAe,CAAC;QAEzCR,OAAOG,kBAAkBM,aAAa;IACxC;AACF"}

package/dist/utilities/parseParams/index.d.ts

@@ -1,6 +1,6 @@
 import type { JoinQuery, PopulateType, SelectType, Where } from '../../types/index.js';
 import type { JoinParams } from '../sanitizeJoinParams.js';
-type RawParams = {
+export type RawParams = {
     [key: string]: unknown;
     autosave?: string;
     data?: string;
@@ -23,7 +23,7 @@ type RawParams = {
     unpublishAllLocales?: string;
     where?: string | Where;
 };
-type ParsedParams = {
+export type ParsedParams = {
     autosave?: boolean;
     data?: Record<string, unknown>;
     depth?: number;
@@ -55,5 +55,4 @@ export declare const numberParams: string[];
  *   c. `sort` provided as a comma-separated string or array is converted to an array of strings
  */
 export declare const parseParams: (params: RawParams) => ParsedParams;
-export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/utilities/parseParams/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/parseParams/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAS1D,KAAK,SAAS,GAAG;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;CACvB,CAAA;AAED,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE3B,eAAO,MAAM,aAAa,UAOzB,CAAA;AAED,eAAO,MAAM,YAAY,UAA6B,CAAA;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,WAAY,SAAS,KAAG,YA2C/C,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/parseParams/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAS1D,MAAM,MAAM,SAAS,GAAG;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE3B,eAAO,MAAM,aAAa,UAOzB,CAAA;AAED,eAAO,MAAM,YAAY,UAA6B,CAAA;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,WAAY,SAAS,KAAG,YA2C/C,CAAA"}