fix(Indexes): validate index number keys/values are non-negative 32-bit integers

User-defined index number keys and values are stored as Uint32, so negative or
floating-point numbers were silently corrupted (negatives wrap, floats
truncate) with no error. CREATE_INDEX/UPDATE_INDEX now reject out-of-range
number keys/values with an IndexValidationError that reports the offending
indices, instead of accepting and corrupting them.

Closes #214

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: agviegas

packages/fragments/src/Utils/edit/edit-function.ts

@@ -318,6 +318,38 @@ export function edit(
     ) {
       // Validate index definition
       const { keys, values, end, start } = request.data;
+      // Number keys/values are stored as Uint32, so they must be non-negative
+      // integers in range. Reject negatives/floats/overflow with a clear error
+      // instead of silently corrupting them (negatives wrap, floats truncate).
+      const validateNumbers = (
+        items: (number | string)[] | undefined,
+        key: "keys" | "values",
+      ) => {
+        if (!items || items.length === 0 || typeof items[0] !== "number") {
+          return;
+        }
+        const numberErrors: { index: number; value: number }[] = [];
+        for (let index = 0; index < items.length; index++) {
+          const value = items[index] as number;
+          if (!Number.isInteger(value) || value < 0 || value > 0xffffffff) {
+            numberErrors.push({ index, value });
+          }
+        }
+        if (numberErrors.length) {
+          throw new Error(
+            `Invalid index request: ${key} must be non-negative 32-bit integers`,
+            {
+              cause: {
+                type: "invalid-number",
+                key,
+                errors: numberErrors,
+              } satisfies ET.IndexValidationError["cause"],
+            },
+          );
+        }
+      };
+      validateNumbers(keys, "keys");
+      validateNumbers(values, "values");
       // 1:1
       if (values && !end) {
         if (values.length !== keys.length) {

packages/fragments/src/Utils/edit/edit-types.ts

@@ -543,6 +543,17 @@ export interface IndexValidationError extends Error {
           start: number;
           end: number;
         }[];
+      }
+    | {
+        // Number keys/values are stored as Uint32, so they must be
+        // non-negative integers within range. Anything else would be silently
+        // corrupted (negatives wrap, floats truncate).
+        type: "invalid-number";
+        key: "keys" | "values";
+        errors: {
+          index: number;
+          value: number;
+        }[];
       };
 }