UUID Write Test

1import { describe, expect, it } from "vitest";
2import { query } from "./clickhouse.js";
3import { encode } from "./encode.js";
4import { Sink } from "../src/writers/core.js";
5import {
6  writeUUID,
7  writeUUIDBigInt,
8  writeUUIDHiLo,
9  parseUUID,
10} from "../src/writers/uuid.js";
11
12const SAMPLE = "61f0c404-5cb3-11e7-907b-a6006ad3dba0";
13// ClickHouse stores a UUID as two little-endian UInt64 halves (high then low).
14const HI = 0x61f0c4045cb311e7n;
15const LO = 0x907ba6006ad3dba0n;
16// The same UUID as one 128-bit value (hi in the high 64 bits, lo in the low).
17const HI_LO_UUID: bigint = (HI << 64n) | LO;
18const WIRE = [
19  0xe7,
20  0x11,
21  0xb3,
22  0x5c,
23  0x04,
24  0xc4,
25  0xf0,
26  0x61, // high half, little-endian
27  0xa0,
28  0xdb,
29  0xd3,
30  0x6a,
31  0x00,
32  0xa6,
33  0x7b,
34  0x90, // low half, little-endian
35];
36
37describe("UUID writers", () => {
38  it("writeUUID copies the raw 16 wire bytes verbatim", async () =>
39    expect(encode(writeUUID, Buffer.from(WIRE))).toEqual(
40      await query(`SELECT toUUID('${SAMPLE}') FORMAT RowBinary`),
41    ));
42
43  it("writeUUIDBigInt splits a 128-bit bigint into the two LE halves", async () =>
44    expect(encode(writeUUIDBigInt, HI_LO_UUID)).toEqual(
45      await query(`SELECT toUUID('${SAMPLE}') FORMAT RowBinary`),
46    ));
47
48  it("writeUUIDHiLo writes the two raw [hi, lo] halves", async () =>
49    expect(encode(writeUUIDHiLo, [HI, LO])).toEqual(
50      await query(`SELECT toUUID('${SAMPLE}') FORMAT RowBinary`),
51    ));
52
53  it("parseUUID turns the canonical string into the wire bytes", () =>
54    expect([...parseUUID(SAMPLE)]).toEqual(WIRE));
55
56  it("writeUUID rejects non-16-byte input", () =>
57    expect(() =>
58      writeUUID(new Sink(Buffer.allocUnsafe(16)), Buffer.alloc(15)),
59    ).toThrow(RangeError));
60});