@kieransimkin/dancemoves 3.1.23 → 3.3.0

package/lib/react.cjs

@@ -115,7 +115,11 @@ function Rudiment({ runtime, options, children, ...attributes }) {
 }
 function PageMetadataEditor({ value = EMPTY, onSave }) {
   const [draft, setDraft] = (0, import_react.useState)(() => ({ ...value })), [message, setMessage] = (0, import_react.useState)(""), [busy, setBusy] = (0, import_react.useState)(false);
-  (0, import_react.useEffect)(() => setDraft({ ...value }), [value]);
+  const [alignmentText, setAlignmentText] = (0, import_react.useState)(() => value.beatAlignment ? JSON.stringify(value.beatAlignment, null, 2) : "");
+  (0, import_react.useEffect)(() => {
+    setDraft({ ...value });
+    setAlignmentText(value.beatAlignment ? JSON.stringify(value.beatAlignment, null, 2) : "");
+  }, [value]);
   const input = (key, label, type = "text") => (0, import_react.createElement)("label", { key }, label, (0, import_react.createElement)("input", {
     type,
     value: draft[key] ?? "",
@@ -129,7 +133,7 @@ function PageMetadataEditor({ value = EMPTY, onSave }) {
       setBusy(true);
       setMessage("");
       try {
-        await onSave((0, import_index.validatePageConfig)(draft));
+        await onSave((0, import_index.validatePageConfig)({ ...draft, beatAlignment: alignmentText.trim() ? JSON.parse(alignmentText) : null }));
         setMessage("Saved");
       } catch (error) {
         setMessage(error.message);
@@ -140,6 +144,7 @@ function PageMetadataEditor({ value = EMPTY, onSave }) {
     input("bpm", "BPM", "number"),
     input("lyricTimingUrl", "Lyric timing URL"),
     input("cueTimingUrl", "Cue timing URL"),
+    (0, import_react.createElement)("label", null, "Beat alignment reading (JSON)", (0, import_react.createElement)("textarea", { rows: 7, value: alignmentText, onChange: (e) => setAlignmentText(e.target.value) })),
     input("masterDurationMilliseconds", "Master duration (milliseconds)", "number"),
     (0, import_react.createElement)("label", null, (0, import_react.createElement)("input", { type: "checkbox", checked: !!draft.lyricPopupsEnabled, onChange: (e) => setDraft({ ...draft, lyricPopupsEnabled: e.target.checked }) }), "Timed lyric pop-ups"),
     (0, import_react.createElement)("label", null, "Ambient effect", (0, import_react.createElement)(

package/lib/react.mjs

@@ -86,7 +86,11 @@ function Rudiment({ runtime, options, children, ...attributes }) {
 }
 function PageMetadataEditor({ value = EMPTY, onSave }) {
   const [draft, setDraft] = useState(() => ({ ...value })), [message, setMessage] = useState(""), [busy, setBusy] = useState(false);
-  useEffect(() => setDraft({ ...value }), [value]);
+  const [alignmentText, setAlignmentText] = useState(() => value.beatAlignment ? JSON.stringify(value.beatAlignment, null, 2) : "");
+  useEffect(() => {
+    setDraft({ ...value });
+    setAlignmentText(value.beatAlignment ? JSON.stringify(value.beatAlignment, null, 2) : "");
+  }, [value]);
   const input = (key, label, type = "text") => h("label", { key }, label, h("input", {
     type,
     value: draft[key] ?? "",
@@ -100,7 +104,7 @@ function PageMetadataEditor({ value = EMPTY, onSave }) {
       setBusy(true);
       setMessage("");
       try {
-        await onSave(validatePageConfig(draft));
+        await onSave(validatePageConfig({ ...draft, beatAlignment: alignmentText.trim() ? JSON.parse(alignmentText) : null }));
         setMessage("Saved");
       } catch (error) {
         setMessage(error.message);
@@ -111,6 +115,7 @@ function PageMetadataEditor({ value = EMPTY, onSave }) {
     input("bpm", "BPM", "number"),
     input("lyricTimingUrl", "Lyric timing URL"),
     input("cueTimingUrl", "Cue timing URL"),
+    h("label", null, "Beat alignment reading (JSON)", h("textarea", { rows: 7, value: alignmentText, onChange: (e) => setAlignmentText(e.target.value) })),
     input("masterDurationMilliseconds", "Master duration (milliseconds)", "number"),
     h("label", null, h("input", { type: "checkbox", checked: !!draft.lyricPopupsEnabled, onChange: (e) => setDraft({ ...draft, lyricPopupsEnabled: e.target.checked }) }), "Timed lyric pop-ups"),
     h("label", null, "Ambient effect", h(

package/lib/server.cjs

@@ -48,6 +48,35 @@ var import_node_fs = require("node:fs");
 var import_node_path = __toESM(require("node:path"), 1);
 var import_node_stream = require("node:stream");
 
+// .build/modules/beat-alignment.mjs
+var hash = (value) => typeof value === "string" && /^[a-f0-9]{64}$/.test(value);
+function rational(value, label) {
+  if (typeof value !== "string" || !/^-?\d{1,80}(?:\/[1-9]\d{0,79})?$/.test(value)) throw new TypeError(`Invalid exact ${label}`);
+  const [n, d = "1"] = value.split("/");
+  return [BigInt(n), BigInt(d)];
+}
+function numeric(value, label, min, max) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < min || value > max) throw new RangeError(`Invalid ${label}`);
+  return value;
+}
+function validateBeatAlignment(input) {
+  if (input === void 0 || input === null || input === "") return null;
+  if (!input || typeof input !== "object" || Array.isArray(input) || input.schema !== "stemlab.beat-alignment.v1" || input.pips_per_beat !== 64 || input.canonical_first_beat_pip !== 0 || !hash(input.source_sha256) || !hash(input.evidence_sha256) || !hash(input.report_sha256)) throw new TypeError("Invalid source-bound StemLab beat alignment");
+  const bpm = numeric(input.bpm, "alignment BPM", 20, 400);
+  const first = numeric(input.first_beat_seconds, "first beat", 0, 86400);
+  const offset = numeric(input.offset_pips, "pip offset", -36864e3, 0);
+  const [bn, bd] = rational(input.exact_bpm, "BPM"), [fn, fd] = rational(input.first_beat_exact_seconds, "first beat"), [pn, pd] = rational(input.exact_offset_pips, "pip offset");
+  if (fn * bn * 64n * pd + pn * fd * bd * 60n !== 0n || bn <= 0n || fn < 0n || Math.abs(Number(bn) / Number(bd) - bpm) > 1e-9 || Math.abs(Number(fn) / Number(fd) - first) > 1e-9 || Math.abs(Number(pn) / Number(pd) - offset) > 1e-7) throw new RangeError("Exact beat alignment and numeric clock disagree");
+  if (!["canonical", "estimated"].includes(input.bpm_status) || !["estimated", "confirmed", "synthetic"].includes(input.phase_status)) throw new TypeError("Alignment authority is required");
+  for (const key of ["analysis_id", "bpm_basis"]) if (typeof input[key] !== "string" || !/^[a-zA-Z0-9_.-]{1,128}$/.test(input[key])) throw new TypeError(`Invalid ${key}`);
+  if (input.source_audio_verified !== true || !input.source_audio || !Number.isSafeInteger(input.source_audio.num_frames) || input.source_audio.num_frames < 1 || !Number.isSafeInteger(input.source_audio.sample_rate) || input.source_audio.sample_rate < 1 || first >= input.source_audio.num_frames / input.source_audio.sample_rate) throw new TypeError("Verified source audio frame bounds are required");
+  const sourceUrl = input.source_url;
+  if (typeof sourceUrl !== "string" || sourceUrl.length > 4096 || /[\u0000-\u001f]/.test(sourceUrl)) throw new TypeError("An exact verified master URL is required");
+  const parsed = new URL(sourceUrl);
+  if (!["http:", "https:"].includes(parsed.protocol) || parsed.username || parsed.password || parsed.hash) throw new TypeError("Invalid verified master URL");
+  return Object.freeze({ ...input, bpm, first_beat_seconds: first, offset_pips: offset, source_audio: Object.freeze({ ...input.source_audio }) });
+}
+
 // .build/modules/config.mjs
 var PAGE_META_KEYS = Object.freeze({
   bpm: "_dance_moves_bpm",
@@ -55,7 +84,9 @@ var PAGE_META_KEYS = Object.freeze({
   cue: "_dance_moves_cue_timing_id",
   popups: "_dance_moves_lyric_popups_enabled",
   duration: "_dance_moves_master_duration_ms",
-  effect: "_dance_moves_effect"
+  effect: "_dance_moves_effect",
+  alignment: "_dance_moves_beat_alignment",
+  alignmentAudio: "_dance_moves_beat_alignment_audio_id"
 });
 var object = (value) => value && typeof value === "object" && !Array.isArray(value);
 function finite(value, name, min, max) {
@@ -74,7 +105,11 @@ function url(value, name) {
 function validatePageConfig(input = {}) {
   if (!object(input)) throw new TypeError("Page configuration must be an object");
   const explicit = input.bpm !== void 0 && input.bpm !== null && input.bpm !== "";
-  const bpm = explicit ? Math.round(finite(input.bpm, "bpm", 20, 400) * 1e3) / 1e3 : 120;
+  const beatAlignment = validateBeatAlignment(input.beatAlignment);
+  const canonicalExplicit = explicit && !["fallback", "analysis"].includes(input.bpmSource);
+  if (canonicalExplicit && beatAlignment && Math.abs(input.bpm - beatAlignment.bpm) > 500001e-9) throw new RangeError("Stored BPM and selected beat alignment disagree; select a matching BPM basis");
+  const bpm = beatAlignment ? beatAlignment.bpm : explicit ? Math.round(finite(input.bpm, "bpm", 20, 400) * 1e3) / 1e3 : 120;
+  if (explicit) finite(input.bpm, "bpm", 20, 400);
   const effect = input.effect ?? "";
   if (!["", "paper-planes"].includes(effect)) throw new RangeError("effect must be empty or paper-planes");
   if (input.lyricPopupsEnabled !== void 0 && typeof input.lyricPopupsEnabled !== "boolean") throw new TypeError("lyricPopupsEnabled must be boolean");
@@ -86,8 +121,9 @@ function validatePageConfig(input = {}) {
   return Object.freeze({
     pageId,
     bpm,
-    bpmSource: explicit && input.bpmSource !== "fallback" ? "explicit" : "fallback",
+    bpmSource: canonicalExplicit ? "explicit" : beatAlignment ? "analysis" : "fallback",
     fallbackBpm: 120,
+    beatAlignment,
     ticksPerBeat: 16,
     tickDefinition: "sixteenth-of-beat",
     longDurationQuantumTicks: 16,
@@ -103,9 +139,9 @@ function validatePageConfig(input = {}) {
 }
 async function fromWordPressMeta(meta, resolveAttachment) {
   if (!object(meta)) throw new TypeError("meta must be an object");
-  const numeric2 = (value) => value !== "" && value !== null && value !== void 0 && Number.isFinite(Number(value));
+  const numeric3 = (value) => value !== "" && value !== null && value !== void 0 && Number.isFinite(Number(value));
   const b = meta[PAGE_META_KEYS.bpm];
-  const bpm = numeric2(b) && Number(b) >= 20 && Number(b) <= 400 ? Number(b) : void 0;
+  const bpm = numeric3(b) && Number(b) >= 20 && Number(b) <= 400 ? Number(b) : void 0;
   const resolve = async (key) => {
     const value = Number(meta[key] || 0);
     if (!Number.isSafeInteger(value)) throw new RangeError("Attachment ID must be a safe integer");
@@ -115,8 +151,15 @@ async function fromWordPressMeta(meta, resolveAttachment) {
     return await resolveAttachment(id) || "";
   };
   const duration = Number(meta[PAGE_META_KEYS.duration]);
+  let beatAlignment = meta[PAGE_META_KEYS.alignment] || null;
+  if (typeof beatAlignment === "string") {
+    if (beatAlignment.length > 16384) throw new RangeError("Beat alignment exceeds 16 KiB");
+    beatAlignment = JSON.parse(beatAlignment);
+  }
+  if (beatAlignment) beatAlignment = { ...beatAlignment, source_url: await resolve(PAGE_META_KEYS.alignmentAudio) };
   return validatePageConfig({
     bpm,
+    beatAlignment,
     lyricTimingUrl: await resolve(PAGE_META_KEYS.lyric),
     cueTimingUrl: await resolve(PAGE_META_KEYS.cue),
     lyricPopupsEnabled: meta[PAGE_META_KEYS.popups] === true || String(meta[PAGE_META_KEYS.popups]) === "1",
@@ -286,7 +329,7 @@ function createDownloadService({ rootDirectory, secret, origin, route = "/api/do
   }
   return Object.freeze({ sign, handle });
 }
-var numeric = (v, min, max) => typeof v === "number" && Number.isFinite(v) && v >= min && v <= max;
+var numeric2 = (v, min, max) => typeof v === "number" && Number.isFinite(v) && v >= min && v <= max;
 function boundedText(value, max = 500) {
   return String(value ?? "").replace(/[\u0000-\u001f\u007f]/g, "").slice(0, max);
 }
@@ -294,13 +337,13 @@ function validateMotionCapture(payload) {
   if (!payload || payload.schema !== "ks-epk-motion-recording/v1") fail("ks_motion_schema", "Unsupported capture schema");
   if (!Array.isArray(payload.samples) || payload.samples.length < 1 || payload.samples.length > 500) fail("ks_motion_samples", "A capture must contain 1..500 samples");
   const samples = payload.samples.map((sample) => {
-    if (!sample || !numeric(sample.milliseconds, 0, 12e4) || !numeric(sample.beta, -180, 180) || !numeric(sample.gamma, -90, 90)) fail("ks_motion_invalid_samples", "Invalid motion sample");
+    if (!sample || !numeric2(sample.milliseconds, 0, 12e4) || !numeric2(sample.beta, -180, 180) || !numeric2(sample.gamma, -90, 90)) fail("ks_motion_invalid_samples", "Invalid motion sample");
     return {
       milliseconds: sample.milliseconds,
       beta: sample.beta,
       gamma: sample.gamma,
-      alpha: sample.alpha === null || sample.alpha === void 0 ? null : numeric(sample.alpha, 0, 360) ? sample.alpha : null,
-      screenAngle: numeric(sample.screenAngle ?? 0, -360, 360) ? sample.screenAngle || 0 : null,
+      alpha: sample.alpha === null || sample.alpha === void 0 ? null : numeric2(sample.alpha, 0, 360) ? sample.alpha : null,
+      screenAngle: numeric2(sample.screenAngle ?? 0, -360, 360) ? sample.screenAngle || 0 : null,
       ...Object.fromEntries(["absolute", "nativeTrusted", "simulatedTrusted", "fieldParity", "dispatchParity", "mapperParity"].map((k) => [k, !!sample[k]]))
     };
   });
@@ -309,7 +352,7 @@ function validateMotionCapture(payload) {
     capturedAt: boundedText(payload.capturedAt, 100),
     userAgent: boundedText(payload.userAgent),
     samples,
-    screenAngle: numeric(payload.screenAngle ?? 0, -360, 360) ? payload.screenAngle || 0 : null,
+    screenAngle: numeric2(payload.screenAngle ?? 0, -360, 360) ? payload.screenAngle || 0 : null,
     storedSampleCount: samples.length,
     sampleStrategy: boundedText(payload.sampleStrategy || "legacy", 80).toLowerCase().replace(/[^a-z0-9_-]/g, ""),
     fullWindowObserved: !!payload.fullWindowObserved,
@@ -321,7 +364,7 @@ function validateMotionCapture(payload) {
       validPairs: Number.isFinite(Number(v.validPairs)) ? Math.abs(Math.trunc(Number(v.validPairs))) : null
     }))
   };
-  for (const key of ["targetDurationMilliseconds", "captureDurationMilliseconds", "sampledDurationMilliseconds", "storageIntervalMilliseconds"]) clean[key] = numeric(payload[key] ?? 0, 0, 12e4) ? payload[key] || 0 : null;
+  for (const key of ["targetDurationMilliseconds", "captureDurationMilliseconds", "sampledDurationMilliseconds", "storageIntervalMilliseconds"]) clean[key] = numeric2(payload[key] ?? 0, 0, 12e4) ? payload[key] || 0 : null;
   for (const key of ["processedPairCount", "failureCount"]) clean[key] = Math.min(1e5, Math.abs(Math.trunc(Number(payload[key]) || (key === "processedPairCount" ? samples.length : clean.failures.length))));
   if (Buffer.byteLength(JSON.stringify(clean)) > 262144) fail("ks_motion_size", "Capture too large", 413);
   return clean;

package/lib/server.mjs

@@ -5,6 +5,35 @@ import { constants as fsConstants } from "node:fs";
 import path from "node:path";
 import { Readable } from "node:stream";
 
+// .build/modules/beat-alignment.mjs
+var hash = (value) => typeof value === "string" && /^[a-f0-9]{64}$/.test(value);
+function rational(value, label) {
+  if (typeof value !== "string" || !/^-?\d{1,80}(?:\/[1-9]\d{0,79})?$/.test(value)) throw new TypeError(`Invalid exact ${label}`);
+  const [n, d = "1"] = value.split("/");
+  return [BigInt(n), BigInt(d)];
+}
+function numeric(value, label, min, max) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < min || value > max) throw new RangeError(`Invalid ${label}`);
+  return value;
+}
+function validateBeatAlignment(input) {
+  if (input === void 0 || input === null || input === "") return null;
+  if (!input || typeof input !== "object" || Array.isArray(input) || input.schema !== "stemlab.beat-alignment.v1" || input.pips_per_beat !== 64 || input.canonical_first_beat_pip !== 0 || !hash(input.source_sha256) || !hash(input.evidence_sha256) || !hash(input.report_sha256)) throw new TypeError("Invalid source-bound StemLab beat alignment");
+  const bpm = numeric(input.bpm, "alignment BPM", 20, 400);
+  const first = numeric(input.first_beat_seconds, "first beat", 0, 86400);
+  const offset = numeric(input.offset_pips, "pip offset", -36864e3, 0);
+  const [bn, bd] = rational(input.exact_bpm, "BPM"), [fn, fd] = rational(input.first_beat_exact_seconds, "first beat"), [pn, pd] = rational(input.exact_offset_pips, "pip offset");
+  if (fn * bn * 64n * pd + pn * fd * bd * 60n !== 0n || bn <= 0n || fn < 0n || Math.abs(Number(bn) / Number(bd) - bpm) > 1e-9 || Math.abs(Number(fn) / Number(fd) - first) > 1e-9 || Math.abs(Number(pn) / Number(pd) - offset) > 1e-7) throw new RangeError("Exact beat alignment and numeric clock disagree");
+  if (!["canonical", "estimated"].includes(input.bpm_status) || !["estimated", "confirmed", "synthetic"].includes(input.phase_status)) throw new TypeError("Alignment authority is required");
+  for (const key of ["analysis_id", "bpm_basis"]) if (typeof input[key] !== "string" || !/^[a-zA-Z0-9_.-]{1,128}$/.test(input[key])) throw new TypeError(`Invalid ${key}`);
+  if (input.source_audio_verified !== true || !input.source_audio || !Number.isSafeInteger(input.source_audio.num_frames) || input.source_audio.num_frames < 1 || !Number.isSafeInteger(input.source_audio.sample_rate) || input.source_audio.sample_rate < 1 || first >= input.source_audio.num_frames / input.source_audio.sample_rate) throw new TypeError("Verified source audio frame bounds are required");
+  const sourceUrl = input.source_url;
+  if (typeof sourceUrl !== "string" || sourceUrl.length > 4096 || /[\u0000-\u001f]/.test(sourceUrl)) throw new TypeError("An exact verified master URL is required");
+  const parsed = new URL(sourceUrl);
+  if (!["http:", "https:"].includes(parsed.protocol) || parsed.username || parsed.password || parsed.hash) throw new TypeError("Invalid verified master URL");
+  return Object.freeze({ ...input, bpm, first_beat_seconds: first, offset_pips: offset, source_audio: Object.freeze({ ...input.source_audio }) });
+}
+
 // .build/modules/config.mjs
 var PAGE_META_KEYS = Object.freeze({
   bpm: "_dance_moves_bpm",
@@ -12,7 +41,9 @@ var PAGE_META_KEYS = Object.freeze({
   cue: "_dance_moves_cue_timing_id",
   popups: "_dance_moves_lyric_popups_enabled",
   duration: "_dance_moves_master_duration_ms",
-  effect: "_dance_moves_effect"
+  effect: "_dance_moves_effect",
+  alignment: "_dance_moves_beat_alignment",
+  alignmentAudio: "_dance_moves_beat_alignment_audio_id"
 });
 var object = (value) => value && typeof value === "object" && !Array.isArray(value);
 function finite(value, name, min, max) {
@@ -31,7 +62,11 @@ function url(value, name) {
 function validatePageConfig(input = {}) {
   if (!object(input)) throw new TypeError("Page configuration must be an object");
   const explicit = input.bpm !== void 0 && input.bpm !== null && input.bpm !== "";
-  const bpm = explicit ? Math.round(finite(input.bpm, "bpm", 20, 400) * 1e3) / 1e3 : 120;
+  const beatAlignment = validateBeatAlignment(input.beatAlignment);
+  const canonicalExplicit = explicit && !["fallback", "analysis"].includes(input.bpmSource);
+  if (canonicalExplicit && beatAlignment && Math.abs(input.bpm - beatAlignment.bpm) > 500001e-9) throw new RangeError("Stored BPM and selected beat alignment disagree; select a matching BPM basis");
+  const bpm = beatAlignment ? beatAlignment.bpm : explicit ? Math.round(finite(input.bpm, "bpm", 20, 400) * 1e3) / 1e3 : 120;
+  if (explicit) finite(input.bpm, "bpm", 20, 400);
   const effect = input.effect ?? "";
   if (!["", "paper-planes"].includes(effect)) throw new RangeError("effect must be empty or paper-planes");
   if (input.lyricPopupsEnabled !== void 0 && typeof input.lyricPopupsEnabled !== "boolean") throw new TypeError("lyricPopupsEnabled must be boolean");
@@ -43,8 +78,9 @@ function validatePageConfig(input = {}) {
   return Object.freeze({
     pageId,
     bpm,
-    bpmSource: explicit && input.bpmSource !== "fallback" ? "explicit" : "fallback",
+    bpmSource: canonicalExplicit ? "explicit" : beatAlignment ? "analysis" : "fallback",
     fallbackBpm: 120,
+    beatAlignment,
     ticksPerBeat: 16,
     tickDefinition: "sixteenth-of-beat",
     longDurationQuantumTicks: 16,
@@ -60,9 +96,9 @@ function validatePageConfig(input = {}) {
 }
 async function fromWordPressMeta(meta, resolveAttachment) {
   if (!object(meta)) throw new TypeError("meta must be an object");
-  const numeric2 = (value) => value !== "" && value !== null && value !== void 0 && Number.isFinite(Number(value));
+  const numeric3 = (value) => value !== "" && value !== null && value !== void 0 && Number.isFinite(Number(value));
   const b = meta[PAGE_META_KEYS.bpm];
-  const bpm = numeric2(b) && Number(b) >= 20 && Number(b) <= 400 ? Number(b) : void 0;
+  const bpm = numeric3(b) && Number(b) >= 20 && Number(b) <= 400 ? Number(b) : void 0;
   const resolve = async (key) => {
     const value = Number(meta[key] || 0);
     if (!Number.isSafeInteger(value)) throw new RangeError("Attachment ID must be a safe integer");
@@ -72,8 +108,15 @@ async function fromWordPressMeta(meta, resolveAttachment) {
     return await resolveAttachment(id) || "";
   };
   const duration = Number(meta[PAGE_META_KEYS.duration]);
+  let beatAlignment = meta[PAGE_META_KEYS.alignment] || null;
+  if (typeof beatAlignment === "string") {
+    if (beatAlignment.length > 16384) throw new RangeError("Beat alignment exceeds 16 KiB");
+    beatAlignment = JSON.parse(beatAlignment);
+  }
+  if (beatAlignment) beatAlignment = { ...beatAlignment, source_url: await resolve(PAGE_META_KEYS.alignmentAudio) };
   return validatePageConfig({
     bpm,
+    beatAlignment,
     lyricTimingUrl: await resolve(PAGE_META_KEYS.lyric),
     cueTimingUrl: await resolve(PAGE_META_KEYS.cue),
     lyricPopupsEnabled: meta[PAGE_META_KEYS.popups] === true || String(meta[PAGE_META_KEYS.popups]) === "1",
@@ -243,7 +286,7 @@ function createDownloadService({ rootDirectory, secret, origin, route = "/api/do
   }
   return Object.freeze({ sign, handle });
 }
-var numeric = (v, min, max) => typeof v === "number" && Number.isFinite(v) && v >= min && v <= max;
+var numeric2 = (v, min, max) => typeof v === "number" && Number.isFinite(v) && v >= min && v <= max;
 function boundedText(value, max = 500) {
   return String(value ?? "").replace(/[\u0000-\u001f\u007f]/g, "").slice(0, max);
 }
@@ -251,13 +294,13 @@ function validateMotionCapture(payload) {
   if (!payload || payload.schema !== "ks-epk-motion-recording/v1") fail("ks_motion_schema", "Unsupported capture schema");
   if (!Array.isArray(payload.samples) || payload.samples.length < 1 || payload.samples.length > 500) fail("ks_motion_samples", "A capture must contain 1..500 samples");
   const samples = payload.samples.map((sample) => {
-    if (!sample || !numeric(sample.milliseconds, 0, 12e4) || !numeric(sample.beta, -180, 180) || !numeric(sample.gamma, -90, 90)) fail("ks_motion_invalid_samples", "Invalid motion sample");
+    if (!sample || !numeric2(sample.milliseconds, 0, 12e4) || !numeric2(sample.beta, -180, 180) || !numeric2(sample.gamma, -90, 90)) fail("ks_motion_invalid_samples", "Invalid motion sample");
     return {
       milliseconds: sample.milliseconds,
       beta: sample.beta,
       gamma: sample.gamma,
-      alpha: sample.alpha === null || sample.alpha === void 0 ? null : numeric(sample.alpha, 0, 360) ? sample.alpha : null,
-      screenAngle: numeric(sample.screenAngle ?? 0, -360, 360) ? sample.screenAngle || 0 : null,
+      alpha: sample.alpha === null || sample.alpha === void 0 ? null : numeric2(sample.alpha, 0, 360) ? sample.alpha : null,
+      screenAngle: numeric2(sample.screenAngle ?? 0, -360, 360) ? sample.screenAngle || 0 : null,
       ...Object.fromEntries(["absolute", "nativeTrusted", "simulatedTrusted", "fieldParity", "dispatchParity", "mapperParity"].map((k) => [k, !!sample[k]]))
     };
   });
@@ -266,7 +309,7 @@ function validateMotionCapture(payload) {
     capturedAt: boundedText(payload.capturedAt, 100),
     userAgent: boundedText(payload.userAgent),
     samples,
-    screenAngle: numeric(payload.screenAngle ?? 0, -360, 360) ? payload.screenAngle || 0 : null,
+    screenAngle: numeric2(payload.screenAngle ?? 0, -360, 360) ? payload.screenAngle || 0 : null,
     storedSampleCount: samples.length,
     sampleStrategy: boundedText(payload.sampleStrategy || "legacy", 80).toLowerCase().replace(/[^a-z0-9_-]/g, ""),
     fullWindowObserved: !!payload.fullWindowObserved,
@@ -278,7 +321,7 @@ function validateMotionCapture(payload) {
       validPairs: Number.isFinite(Number(v.validPairs)) ? Math.abs(Math.trunc(Number(v.validPairs))) : null
     }))
   };
-  for (const key of ["targetDurationMilliseconds", "captureDurationMilliseconds", "sampledDurationMilliseconds", "storageIntervalMilliseconds"]) clean[key] = numeric(payload[key] ?? 0, 0, 12e4) ? payload[key] || 0 : null;
+  for (const key of ["targetDurationMilliseconds", "captureDurationMilliseconds", "sampledDurationMilliseconds", "storageIntervalMilliseconds"]) clean[key] = numeric2(payload[key] ?? 0, 0, 12e4) ? payload[key] || 0 : null;
   for (const key of ["processedPairCount", "failureCount"]) clean[key] = Math.min(1e5, Math.abs(Math.trunc(Number(payload[key]) || (key === "processedPairCount" ? samples.length : clean.failures.length))));
   if (Buffer.byteLength(JSON.stringify(clean)) > 262144) fail("ks_motion_size", "Capture too large", 413);
   return clean;