support 64-bit bigints

lib/osc-utilities.ts

@@ -251,6 +251,14 @@ const parseOscArg = (
         rest: sliceDataView(view, 4),
       };
     }
+    case "h": {
+      const view = toView(buffer);
+      const bigint = view.getBigInt64(0, false);
+      return {
+        value: { type: "bigint", value: bigint },
+        rest: sliceDataView(view, 8),
+      };
+    }
     case "m": {
       const view = toView(buffer);
       if (view.byteLength < 4) {
@@ -293,6 +301,11 @@ const toOscArgument = (arg: OscArgWithType): ArrayBuffer => {
       ret.setFloat32(0, arg.value, false);
       return ret.buffer;
     }
+    case "bigint": {
+      const ret = new DataView(new ArrayBuffer(8));
+      ret.setBigInt64(0, arg.value, false);
+      return ret.buffer;
+    }
     case "double": {
       const ret = new DataView(new ArrayBuffer(8));
       ret.setFloat64(0, arg.value, false);
@@ -349,7 +362,8 @@ export type OscTypeCode =
   | "S"
   | "c"
   | "r"
-  | "m";
+  | "m"
+  | "h";
 
 const RepresentationToTypeCode: {
   [key in OscArgWithType["type"]]: OscTypeCode;
@@ -368,6 +382,7 @@ const RepresentationToTypeCode: {
   character: "c",
   color: "r",
   midi: "m",
+  bigint: "h",
 };
 
 export type OscMidiPacket = [number, number, number, number];
@@ -385,6 +400,10 @@ export type OscArgOutput =
       type: "integer";
       value: number;
     }
+  | {
+      type: "bigint";
+      value: bigint;
+    }
   | {
       type: "timetag";
       value: TimeTag;
@@ -454,6 +473,10 @@ export type OscArgWithType =
       type: "integer";
       value: number;
     }
+  | {
+      type: "bigint";
+      value: bigint;
+    }
   | {
       type: "timetag";
       value: TimeTag | Date;
@@ -499,6 +522,7 @@ export type OscArgInput =
   | OscArgWithType
   | string
   | number
+  | bigint
   | Date
   | OscColor
   | ArrayBuffer
@@ -541,6 +565,9 @@ const toOscArgWithType = (arg: OscArgInput): OscArgWithType => {
   if (typeof arg === "object" && "red" in arg) {
     return { type: "color", value: arg };
   }
+  if (typeof arg === "bigint") {
+    return { type: "bigint", value: arg };
+  }
   if (arg === true) {
     return { type: "true" };
   }

readme.md

@@ -114,6 +114,12 @@ Where the `type` is one of the following:
 - `string` - string value
 - `float` - numeric value
 - `integer` - numeric value
+- `color` - JS object containing `red`, `green`, `blue`, `alpha` in range 0-255
+- `midi` - four-element array of numbers representing a midi packet of data
+- `symbol` - string value
+- `character` - a single-character string
+- `double` - numeric value
+- `bigint` - 64-bit `bigint` value (watch out, this will be truncated to 64 bits!)
 - `blob` - `ArrayBuffer`, `DataView`, `TypedArray` or node.js `Buffer`
 - `true` - value is boolean true
 - `false` - value is boolean false

test/osc-utilities.test.ts

@@ -1214,6 +1214,10 @@ test("Roundtrip color works", () => {
   ]);
 });
 
+test("Roundtrip bigint works", () => {
+  roundTripMessage([1234567891234n]);
+});
+
 test("Roundtrip midi works", () => {
   roundTripMessage([
     {