@burdenoff/microfe-buildmyiq 2026.1029.3 → 2026.1029.5

package/README.md

@@ -10,3 +10,21 @@ See `AGENTS.md` for development commands and architecture details.
 ## License
 
 Proprietary — Copyright Burdenoff Consultancy Services Pvt. Ltd.
+
+## AI proctoring assets (app shells)
+
+AI-monitored exams run a face detector in the learner's browser. Its
+WebAssembly runtime and model are served by the app shell from its own origin,
+never from a public CDN. Every shell that mounts this microfrontend must add
+the plugin below to its Vite config; it emits the files under
+`/static/vendor/mediapipe/` at build time and serves them in `vite dev`:
+
+```ts
+import { buildmyiqProctoringAssets } from '@burdenoff/microfe-buildmyiq/vite';
+
+export default defineConfig({ plugins: [buildmyiqProctoringAssets() /* , … */] });
+```
+
+`@mediapipe/tasks-vision` is pinned to 0.10.35 because 1.0.0 and later send
+usage metrics to Google with no opt-out. `proctoringAssets.test.ts` fails if an
+upgrade reintroduces a third-party endpoint.

package/assets/mediapipe/NOTICE.md

@@ -0,0 +1,17 @@
+# Third-party model: BlazeFace short-range
+
+`blaze_face_short_range.tflite` is the MediaPipe BlazeFace short-range face
+detector (float16, model version 1), published by Google under the Apache
+License 2.0.
+
+- Source: https://storage.googleapis.com/mediapipe-models/face_detector/blaze_face_short_range/float16/1/blaze_face_short_range.tflite
+- Model card: https://storage.googleapis.com/mediapipe-assets/MediaPipe%20BlazeFace%20Model%20Card%20(Short%20Range).pdf
+- Size: 229,746 bytes
+- SHA-256: `b4578f35940bf5a1a655214a1cce5cab13eba73c1297cd78e1a04c2380b0152f`
+- MD5 (matches the bucket's `x-goog-hash`): `a3dd6ec31725290770b97cec0cbf94c9`
+
+It is vendored here so that BuildMyIQ app shells can serve it from their own
+origin (BOFF-10118) through the `buildmyiqProctoringAssets()` Vite plugin in
+`vite/proctoring-assets.mjs`. To replace it, download the new model, update the
+URL path in both `vite/proctoring-assets.mjs` and
+`src/buildmyiq/pages/assessments/proctoringAssetPaths.ts`, and update this file.

package/dist/buildmyiq/hooks/aiProctoringSignals.d.ts

@@ -0,0 +1,84 @@
+import { BuiProctoringSignalInput, BuiProctoringSignalType } from '../types';
+/** Lockdown monitor signal names (see `useLockdownMonitor`) mapped to backend types. */
+export declare const LOCKDOWN_SIGNAL_TYPE: {
+    readonly 'tab-hidden': "TAB_HIDDEN";
+    readonly 'window-blur': "WINDOW_BLUR";
+    readonly 'fullscreen-exit': "FULLSCREEN_EXIT";
+    readonly clipboard: "CLIPBOARD";
+};
+/** The conditions the AI monitor tracks as episodes. */
+export type AiCondition = 'FACE_ABSENT' | 'MULTIPLE_FACES' | 'GAZE_AWAY' | 'VOICE_DETECTED';
+/** How long a condition must last before it counts as an episode. */
+export declare const EPISODE_MIN_MS: Record<AiCondition, number>;
+/** A condition must stay clear this long before its episode closes (absorbs flicker). */
+export declare const EPISODE_RELEASE_MS = 1500;
+/** |yaw ratio| above this means the head is turned well away from the screen. */
+export declare const GAZE_AWAY_YAW_RATIO = 0.5;
+/** Speech must be this many dB above the calibrated noise floor... */
+export declare const SPEECH_MARGIN_DB = 12;
+/** ...and never quieter than this absolute level. */
+export declare const SPEECH_MIN_LEVEL_DB = -65;
+export interface EpisodeSample {
+    confidence?: number | null;
+    faceCount?: number | null;
+    levelDb?: number | null;
+}
+/**
+ * Turns per-sample condition flags into closed episodes. Call `update` on
+ * every sample; it returns any episodes that closed on that sample. Call
+ * `flush` when monitoring stops to close whatever is still open.
+ */
+export declare class EpisodeTracker {
+    private open;
+    update(condition: AiCondition, active: boolean, now: number, sample?: EpisodeSample): BuiProctoringSignalInput[];
+    /** True while the condition has an episode in progress that already meets its minimum. */
+    isOngoing(condition: AiCondition, now: number): boolean;
+    /** Close every open episode (monitoring stopped). */
+    flush(): BuiProctoringSignalInput[];
+}
+export interface Keypoint {
+    x: number;
+    y: number;
+}
+/**
+ * Head-turn estimate from BlazeFace keypoints (0 right eye, 1 left eye,
+ * 2 nose tip): how far the nose sits from the midpoint of the eyes, in units
+ * of the distance between the eyes. About 0 when facing the screen; beyond
+ * ±0.5 the head is turned roughly 40° or more. Null when the keypoints are
+ * missing or degenerate.
+ */
+export declare function estimateYawRatio(keypoints: readonly Keypoint[] | undefined): number | null;
+export declare function isLookingAway(yawRatio: number | null): boolean;
+/**
+ * Average level (dBFS) of the speech band (300–3400 Hz) from an
+ * AnalyserNode's `getFloatFrequencyData` output. Averages in the power
+ * domain, so a loud voice is not drowned out by quiet bins.
+ */
+export declare function speechBandLevelDb(frequencyDb: ArrayLike<number>, sampleRate: number, fftSize: number, lowHz?: number, highHz?: number): number;
+/**
+ * Tracks the room's noise floor: the 20th-percentile of recent levels. Needs
+ * a few seconds of samples before it will call anything speech.
+ */
+export declare class NoiseFloor {
+    private readonly windowSize;
+    private readonly minSamples;
+    private samples;
+    constructor(windowSize?: number, minSamples?: number);
+    add(levelDb: number): void;
+    /** Current floor, or null while still calibrating. */
+    value(): number | null;
+    isSpeech(levelDb: number): boolean;
+}
+/** Human summary of a signal type for reviewers and the learner banner. */
+export declare const SIGNAL_LABELS: Record<BuiProctoringSignalType, string>;
+/** AI-derived signal types (shown with an "AI" marker to reviewers). */
+export declare const AI_SIGNAL_TYPES: readonly BuiProctoringSignalType[];
+/** Published retention period for proctoring signals (matches the backend). */
+export declare const PROCTORING_SIGNAL_RETENTION_DAYS = 60;
+/** The backend accepts at most this many signals per call. */
+export declare const MAX_SIGNALS_PER_BATCH = 50;
+/** Split a queue into backend-sized batches. */
+export declare function toBatches<T>(items: readonly T[], size?: number): T[][];
+/** "1 min 05 s" style duration for reviewer timelines. */
+export declare function formatEpisodeDuration(ms: number): string;
+//# sourceMappingURL=aiProctoringSignals.d.ts.map

package/dist/buildmyiq/hooks/aiProctoringSignals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiProctoringSignals.d.ts","sourceRoot":"","sources":["../../../src/buildmyiq/hooks/aiProctoringSignals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAElF,wFAAwF;AACxF,eAAO,MAAM,oBAAoB;;;;;CAK2B,CAAC;AAE7D,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,gBAAgB,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE5F,qEAAqE;AACrE,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAKtD,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AAExC,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAeD;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAuC;IAEnD,MAAM,CACJ,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,aAAkB,GACzB,wBAAwB,EAAE;IAyB7B,0FAA0F;IAC1F,SAAS,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAKvD,qDAAqD;IACrD,KAAK,IAAI,wBAAwB,EAAE;CASpC;AAuBD,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAO1F;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,EAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,SAAM,EACX,MAAM,SAAO,GACZ,MAAM,CAcR;AAED;;;GAGG;AACH,qBAAa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ7B,OAAO,CAAC,OAAO,CAAgB;gBAGZ,UAAU,SAAK,EACf,UAAU,SAAI;IAGjC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM1B,sDAAsD;IACtD,KAAK,IAAI,MAAM,GAAG,IAAI;IAMtB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAKnC;AAED,2EAA2E;AAC3E,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAWjE,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,eAAe,EAAE,SAAS,uBAAuB,EAO7D,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAEnD,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,gDAAgD;AAChD,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,SAAwB,GAAG,CAAC,EAAE,EAAE,CAIrF;AAED,0DAA0D;AAC1D,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAOxD"}

package/dist/buildmyiq/hooks/aiProctoringSignals.js

@@ -0,0 +1,133 @@
+//#region src/buildmyiq/hooks/aiProctoringSignals.ts
+var e = {
+	"tab-hidden": "TAB_HIDDEN",
+	"window-blur": "WINDOW_BLUR",
+	"fullscreen-exit": "FULLSCREEN_EXIT",
+	clipboard: "CLIPBOARD"
+}, t = {
+	FACE_ABSENT: 3e3,
+	MULTIPLE_FACES: 2e3,
+	GAZE_AWAY: 4e3,
+	VOICE_DETECTED: 3e3
+}, n = 1500, r = .5;
+function i(e, t) {
+	return t == null || !Number.isFinite(t) ? e : e == null ? t : Math.max(e, t);
+}
+var a = class {
+	open = /* @__PURE__ */ new Map();
+	update(e, t, n, r = {}) {
+		let a = this.open.get(e);
+		if (t) {
+			let t = a ?? {
+				startedAt: n,
+				lastActiveAt: n,
+				confidence: null,
+				faceCount: null,
+				peakLevelDb: null
+			};
+			return t.lastActiveAt = n, t.confidence = i(t.confidence, r.confidence), t.faceCount = i(t.faceCount, r.faceCount), t.peakLevelDb = i(t.peakLevelDb, r.levelDb), this.open.set(e, t), [];
+		}
+		if (a && n - a.lastActiveAt >= 1500) {
+			this.open.delete(e);
+			let t = o(e, a);
+			return t ? [t] : [];
+		}
+		return [];
+	}
+	isOngoing(e, n) {
+		let r = this.open.get(e);
+		return r != null && n - r.startedAt >= t[e];
+	}
+	flush() {
+		let e = [];
+		for (let [t, n] of this.open) {
+			let r = o(t, n);
+			r && e.push(r);
+		}
+		return this.open.clear(), e;
+	}
+};
+function o(e, n) {
+	let r = Math.round(n.lastActiveAt - n.startedAt);
+	if (r < t[e]) return null;
+	let i = {
+		type: e,
+		startedAt: new Date(n.startedAt).toISOString(),
+		durationMs: r
+	};
+	return n.confidence != null && (i.confidence = Math.min(1, Math.max(0, s(n.confidence, 3)))), n.faceCount != null && (i.faceCount = Math.min(20, Math.round(n.faceCount))), n.peakLevelDb != null && (i.peakLevelDb = Math.min(0, Math.max(-160, s(n.peakLevelDb, 1)))), i;
+}
+function s(e, t) {
+	let n = 10 ** t;
+	return Math.round(e * n) / n;
+}
+function c(e) {
+	if (!e || e.length < 3) return null;
+	let [t, n, r] = e, i = Math.abs(n.x - t.x);
+	if (!Number.isFinite(i) || i < .001) return null;
+	let a = (n.x + t.x) / 2;
+	return (r.x - a) / i;
+}
+function l(e) {
+	return e != null && Math.abs(e) > .5;
+}
+function u(e, t, n, r = 300, i = 3400) {
+	let a = t / n, o = Math.max(0, Math.floor(r / a)), s = Math.min(e.length - 1, Math.ceil(i / a)), c = 0, l = 0;
+	for (let t = o; t <= s; t++) {
+		let n = e[t];
+		n == null || !Number.isFinite(n) || (c += 10 ** (n / 10), l += 1);
+	}
+	return l === 0 || c <= 0 ? -160 : 10 * Math.log10(c / l);
+}
+var d = class {
+	windowSize;
+	minSamples;
+	samples = [];
+	constructor(e = 60, t = 5) {
+		this.windowSize = e, this.minSamples = t;
+	}
+	add(e) {
+		Number.isFinite(e) && (this.samples.push(e), this.samples.length > this.windowSize && this.samples.shift());
+	}
+	value() {
+		if (this.samples.length < this.minSamples) return null;
+		let e = [...this.samples].sort((e, t) => e - t);
+		return e[Math.floor(e.length * .2)] ?? null;
+	}
+	isSpeech(e) {
+		let t = this.value();
+		return t == null ? !1 : e >= -65 && e - t >= 12;
+	}
+}, f = {
+	TAB_HIDDEN: "Switched tab or app",
+	WINDOW_BLUR: "Exam window lost focus",
+	FULLSCREEN_EXIT: "Left fullscreen",
+	CLIPBOARD: "Copy, cut or paste",
+	FACE_ABSENT: "No face in camera view",
+	MULTIPLE_FACES: "More than one face",
+	GAZE_AWAY: "Looking away from the screen",
+	VOICE_DETECTED: "Sustained speech or voices",
+	CAMERA_UNAVAILABLE: "Camera stopped",
+	MICROPHONE_UNAVAILABLE: "Microphone stopped"
+}, p = [
+	"FACE_ABSENT",
+	"MULTIPLE_FACES",
+	"GAZE_AWAY",
+	"VOICE_DETECTED",
+	"CAMERA_UNAVAILABLE",
+	"MICROPHONE_UNAVAILABLE"
+];
+function m(e, t = 50) {
+	let n = [];
+	for (let r = 0; r < e.length; r += t) n.push(e.slice(r, r + t));
+	return n;
+}
+function h(e) {
+	if (e <= 0) return "";
+	let t = Math.round(e / 1e3), n = Math.floor(t / 60), r = t % 60;
+	return n === 0 ? `${r} s` : `${n} min ${String(r).padStart(2, "0")} s`;
+}
+//#endregion
+export { p as AI_SIGNAL_TYPES, t as EPISODE_MIN_MS, n as EPISODE_RELEASE_MS, a as EpisodeTracker, r as GAZE_AWAY_YAW_RATIO, e as LOCKDOWN_SIGNAL_TYPE, d as NoiseFloor, f as SIGNAL_LABELS, c as estimateYawRatio, h as formatEpisodeDuration, l as isLookingAway, u as speechBandLevelDb, m as toBatches };
+
+//# sourceMappingURL=aiProctoringSignals.js.map

package/dist/buildmyiq/hooks/aiProctoringSignals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiProctoringSignals.js","names":[],"sources":["../../../src/buildmyiq/hooks/aiProctoringSignals.ts"],"sourcesContent":["/**\n * Pure rules for in-browser AI proctoring signals (BOFF-9690).\n * @module buildmyiq/hooks/aiProctoringSignals\n *\n * The AI monitor samples the learner's camera and microphone on their own\n * device and turns sustained conditions into signal episodes:\n *\n *   - FACE_ABSENT     no face in frame for at least 3 s\n *   - MULTIPLE_FACES  more than one face for at least 2 s\n *   - GAZE_AWAY       head turned well away from the screen for at least 4 s\n *   - VOICE_DETECTED  speech-band audio well above the room's noise floor for at least 3 s\n *\n * Nothing here touches images or audio buffers beyond a single number per\n * sample (face count, a head-turn ratio, a level in dBFS); the episodes are\n * the only thing sent to the backend. Everything is pure so it can be unit\n * tested without a camera.\n */\n\nimport type { BuiProctoringSignalInput, BuiProctoringSignalType } from '../types';\n\n/** Lockdown monitor signal names (see `useLockdownMonitor`) mapped to backend types. */\nexport const LOCKDOWN_SIGNAL_TYPE = {\n  'tab-hidden': 'TAB_HIDDEN',\n  'window-blur': 'WINDOW_BLUR',\n  'fullscreen-exit': 'FULLSCREEN_EXIT',\n  clipboard: 'CLIPBOARD',\n} as const satisfies Record<string, BuiProctoringSignalType>;\n\n/** The conditions the AI monitor tracks as episodes. */\nexport type AiCondition = 'FACE_ABSENT' | 'MULTIPLE_FACES' | 'GAZE_AWAY' | 'VOICE_DETECTED';\n\n/** How long a condition must last before it counts as an episode. */\nexport const EPISODE_MIN_MS: Record<AiCondition, number> = {\n  FACE_ABSENT: 3_000,\n  MULTIPLE_FACES: 2_000,\n  GAZE_AWAY: 4_000,\n  VOICE_DETECTED: 3_000,\n};\n\n/** A condition must stay clear this long before its episode closes (absorbs flicker). */\nexport const EPISODE_RELEASE_MS = 1_500;\n\n/** |yaw ratio| above this means the head is turned well away from the screen. */\nexport const GAZE_AWAY_YAW_RATIO = 0.5;\n\n/** Speech must be this many dB above the calibrated noise floor... */\nexport const SPEECH_MARGIN_DB = 12;\n/** ...and never quieter than this absolute level. */\nexport const SPEECH_MIN_LEVEL_DB = -65;\n\nexport interface EpisodeSample {\n  confidence?: number | null;\n  faceCount?: number | null;\n  levelDb?: number | null;\n}\n\ninterface OpenEpisode {\n  startedAt: number;\n  lastActiveAt: number;\n  confidence: number | null;\n  faceCount: number | null;\n  peakLevelDb: number | null;\n}\n\nfunction maxOrNull(a: number | null, b: number | null | undefined): number | null {\n  if (b == null || !Number.isFinite(b)) return a;\n  return a == null ? b : Math.max(a, b);\n}\n\n/**\n * Turns per-sample condition flags into closed episodes. Call `update` on\n * every sample; it returns any episodes that closed on that sample. Call\n * `flush` when monitoring stops to close whatever is still open.\n */\nexport class EpisodeTracker {\n  private open = new Map<AiCondition, OpenEpisode>();\n\n  update(\n    condition: AiCondition,\n    active: boolean,\n    now: number,\n    sample: EpisodeSample = {}\n  ): BuiProctoringSignalInput[] {\n    const current = this.open.get(condition);\n    if (active) {\n      const episode = current ?? {\n        startedAt: now,\n        lastActiveAt: now,\n        confidence: null,\n        faceCount: null,\n        peakLevelDb: null,\n      };\n      episode.lastActiveAt = now;\n      episode.confidence = maxOrNull(episode.confidence, sample.confidence);\n      episode.faceCount = maxOrNull(episode.faceCount, sample.faceCount);\n      episode.peakLevelDb = maxOrNull(episode.peakLevelDb, sample.levelDb);\n      this.open.set(condition, episode);\n      return [];\n    }\n    if (current && now - current.lastActiveAt >= EPISODE_RELEASE_MS) {\n      this.open.delete(condition);\n      const closed = toSignal(condition, current);\n      return closed ? [closed] : [];\n    }\n    return [];\n  }\n\n  /** True while the condition has an episode in progress that already meets its minimum. */\n  isOngoing(condition: AiCondition, now: number): boolean {\n    const episode = this.open.get(condition);\n    return episode != null && now - episode.startedAt >= EPISODE_MIN_MS[condition];\n  }\n\n  /** Close every open episode (monitoring stopped). */\n  flush(): BuiProctoringSignalInput[] {\n    const out: BuiProctoringSignalInput[] = [];\n    for (const [condition, episode] of this.open) {\n      const closed = toSignal(condition, episode);\n      if (closed) out.push(closed);\n    }\n    this.open.clear();\n    return out;\n  }\n}\n\nfunction toSignal(condition: AiCondition, episode: OpenEpisode): BuiProctoringSignalInput | null {\n  const durationMs = Math.round(episode.lastActiveAt - episode.startedAt);\n  if (durationMs < EPISODE_MIN_MS[condition]) return null;\n  const signal: BuiProctoringSignalInput = {\n    type: condition,\n    startedAt: new Date(episode.startedAt).toISOString(),\n    durationMs,\n  };\n  if (episode.confidence != null)\n    signal.confidence = Math.min(1, Math.max(0, round(episode.confidence, 3)));\n  if (episode.faceCount != null) signal.faceCount = Math.min(20, Math.round(episode.faceCount));\n  if (episode.peakLevelDb != null)\n    signal.peakLevelDb = Math.min(0, Math.max(-160, round(episode.peakLevelDb, 1)));\n  return signal;\n}\n\nfunction round(value: number, digits: number): number {\n  const f = 10 ** digits;\n  return Math.round(value * f) / f;\n}\n\nexport interface Keypoint {\n  x: number;\n  y: number;\n}\n\n/**\n * Head-turn estimate from BlazeFace keypoints (0 right eye, 1 left eye,\n * 2 nose tip): how far the nose sits from the midpoint of the eyes, in units\n * of the distance between the eyes. About 0 when facing the screen; beyond\n * ±0.5 the head is turned roughly 40° or more. Null when the keypoints are\n * missing or degenerate.\n */\nexport function estimateYawRatio(keypoints: readonly Keypoint[] | undefined): number | null {\n  if (!keypoints || keypoints.length < 3) return null;\n  const [rightEye, leftEye, nose] = keypoints as [Keypoint, Keypoint, Keypoint];\n  const eyeDistance = Math.abs(leftEye.x - rightEye.x);\n  if (!Number.isFinite(eyeDistance) || eyeDistance < 1e-3) return null;\n  const mid = (leftEye.x + rightEye.x) / 2;\n  return (nose.x - mid) / eyeDistance;\n}\n\nexport function isLookingAway(yawRatio: number | null): boolean {\n  return yawRatio != null && Math.abs(yawRatio) > GAZE_AWAY_YAW_RATIO;\n}\n\n/**\n * Average level (dBFS) of the speech band (300–3400 Hz) from an\n * AnalyserNode's `getFloatFrequencyData` output. Averages in the power\n * domain, so a loud voice is not drowned out by quiet bins.\n */\nexport function speechBandLevelDb(\n  frequencyDb: ArrayLike<number>,\n  sampleRate: number,\n  fftSize: number,\n  lowHz = 300,\n  highHz = 3400\n): number {\n  const binHz = sampleRate / fftSize;\n  const from = Math.max(0, Math.floor(lowHz / binHz));\n  const to = Math.min(frequencyDb.length - 1, Math.ceil(highHz / binHz));\n  let power = 0;\n  let bins = 0;\n  for (let i = from; i <= to; i++) {\n    const db = frequencyDb[i];\n    if (db == null || !Number.isFinite(db)) continue;\n    power += 10 ** (db / 10);\n    bins += 1;\n  }\n  if (bins === 0 || power <= 0) return -160;\n  return 10 * Math.log10(power / bins);\n}\n\n/**\n * Tracks the room's noise floor: the 20th-percentile of recent levels. Needs\n * a few seconds of samples before it will call anything speech.\n */\nexport class NoiseFloor {\n  private samples: number[] = [];\n\n  constructor(\n    private readonly windowSize = 60,\n    private readonly minSamples = 5\n  ) {}\n\n  add(levelDb: number): void {\n    if (!Number.isFinite(levelDb)) return;\n    this.samples.push(levelDb);\n    if (this.samples.length > this.windowSize) this.samples.shift();\n  }\n\n  /** Current floor, or null while still calibrating. */\n  value(): number | null {\n    if (this.samples.length < this.minSamples) return null;\n    const sorted = [...this.samples].sort((a, b) => a - b);\n    return sorted[Math.floor(sorted.length * 0.2)] ?? null;\n  }\n\n  isSpeech(levelDb: number): boolean {\n    const floor = this.value();\n    if (floor == null) return false;\n    return levelDb >= SPEECH_MIN_LEVEL_DB && levelDb - floor >= SPEECH_MARGIN_DB;\n  }\n}\n\n/** Human summary of a signal type for reviewers and the learner banner. */\nexport const SIGNAL_LABELS: Record<BuiProctoringSignalType, string> = {\n  TAB_HIDDEN: 'Switched tab or app',\n  WINDOW_BLUR: 'Exam window lost focus',\n  FULLSCREEN_EXIT: 'Left fullscreen',\n  CLIPBOARD: 'Copy, cut or paste',\n  FACE_ABSENT: 'No face in camera view',\n  MULTIPLE_FACES: 'More than one face',\n  GAZE_AWAY: 'Looking away from the screen',\n  VOICE_DETECTED: 'Sustained speech or voices',\n  CAMERA_UNAVAILABLE: 'Camera stopped',\n  MICROPHONE_UNAVAILABLE: 'Microphone stopped',\n};\n\n/** AI-derived signal types (shown with an \"AI\" marker to reviewers). */\nexport const AI_SIGNAL_TYPES: readonly BuiProctoringSignalType[] = [\n  'FACE_ABSENT',\n  'MULTIPLE_FACES',\n  'GAZE_AWAY',\n  'VOICE_DETECTED',\n  'CAMERA_UNAVAILABLE',\n  'MICROPHONE_UNAVAILABLE',\n];\n\n/** Published retention period for proctoring signals (matches the backend). */\nexport const PROCTORING_SIGNAL_RETENTION_DAYS = 60;\n\n/** The backend accepts at most this many signals per call. */\nexport const MAX_SIGNALS_PER_BATCH = 50;\n\n/** Split a queue into backend-sized batches. */\nexport function toBatches<T>(items: readonly T[], size = MAX_SIGNALS_PER_BATCH): T[][] {\n  const out: T[][] = [];\n  for (let i = 0; i < items.length; i += size) out.push(items.slice(i, i + size));\n  return out;\n}\n\n/** \"1 min 05 s\" style duration for reviewer timelines. */\nexport function formatEpisodeDuration(ms: number): string {\n  if (ms <= 0) return '';\n  const totalSeconds = Math.round(ms / 1000);\n  const minutes = Math.floor(totalSeconds / 60);\n  const seconds = totalSeconds % 60;\n  if (minutes === 0) return `${seconds} s`;\n  return `${minutes} min ${String(seconds).padStart(2, '0')} s`;\n}\n"],"mappings":"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"}

package/dist/buildmyiq/hooks/index.d.ts

@@ -10,6 +10,7 @@ export * from './useBuiTags';
 export * from './useBuiPermissions';
 export * from './useBuiProctoring';
 export * from './proctoringState';
+export * from './aiProctoringSignals';
 export * from './useBuiCredentials';
 export * from './useBuiAccessibility';
 //# sourceMappingURL=index.d.ts.map

package/dist/buildmyiq/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/buildmyiq/hooks/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/buildmyiq/hooks/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC"}

package/dist/buildmyiq/hooks/index.js

@@ -6,6 +6,7 @@ import "./useBuiTags.js";
 import "./useBuiPermissions.js";
 import "./useBuiProctoring.js";
 import "./proctoringState.js";
+import "./aiProctoringSignals.js";
 import "./useBuiCredentials.js";
 import "./accessibilityDraft.js";
 import "./useBuiAccessibility.js";

package/dist/buildmyiq/hooks/useBuiProctoring.d.ts

@@ -1,4 +1,4 @@
-import { BuiConnection, BuiProctoringIdentityFile, BuiProctoringSession, BuiProctoringStatus, BuiReviewProctoringSessionInput, BuiSubmitProctoringIdentityInput } from '../types';
+import { BuiConnection, BuiProctoringIdentityFile, BuiProctoringSession, BuiProctoringSignal, BuiProctoringSignalInput, BuiProctoringStatus, BuiReviewProctoringSessionInput, BuiSubmitProctoringIdentityInput } from '../types';
 /**
  * The calling learner's most recent proctoring session for an assessment
  * (null when they have never started one). Polls while a reviewer decision
@@ -12,6 +12,17 @@ export declare const useBuiSubmitProctoringIdentity: () => import('@tanstack/rea
 }, unknown>;
 /** Records one lockdown violation (tab switch, window blur, fullscreen exit, copy/paste). */
 export declare const useBuiReportProctoringViolation: () => import('@tanstack/react-query').UseMutationResult<BuiProctoringSession, Error, string, unknown>;
+/**
+ * BOFF-9690: records a batch (max 50) of signal episodes on the learner's own
+ * approved session — lockdown events and, when the assessment opted in and
+ * the learner consented, in-browser AI signals.
+ */
+export declare const useBuiRecordProctoringSignals: () => import('@tanstack/react-query').UseMutationResult<BuiProctoringSession, Error, {
+    id: string;
+    signals: BuiProctoringSignalInput[];
+}, unknown>;
+/** BOFF-9690: reviewer timeline of one session's signals, oldest first, 100 per page. */
+export declare const useBuiProctoringSessionSignals: (sessionId: string | undefined, enabled?: boolean) => import('@tanstack/react-query').UseInfiniteQueryResult<import('@tanstack/query-core').InfiniteData<BuiConnection<BuiProctoringSignal>, unknown>, Error>;
 /** Reviewer queue: proctoring sessions in the workspace, optionally filtered by status. */
 export declare const useBuiProctoringSessions: (args: {
     status?: BuiProctoringStatus;

package/dist/buildmyiq/hooks/useBuiProctoring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBuiProctoring.d.ts","sourceRoot":"","sources":["../../../src/buildmyiq/hooks/useBuiProctoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EACV,aAAa,EACb,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,+BAA+B,EAC/B,gCAAgC,EACjC,MAAM,UAAU,CAAC;AA6BlB;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GAAI,cAAc,MAAM,GAAG,SAAS,EAAE,iBAAc,gGAwBzF,CAAC;AAEF,eAAO,MAAM,4BAA4B,uGAkBxC,CAAC;AAEF,eAAO,MAAM,8BAA8B;QAIR,MAAM;WAAS,gCAAgC;WAejF,CAAC;AAEF,6FAA6F;AAC7F,eAAO,MAAM,+BAA+B,uGAkB3C,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,wBAAwB,GACnC,MAAM;IAAE,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7E,iBAAc,wGAuBf,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GAAI,WAAW,MAAM,GAAG,SAAS,EAAE,iBAAc,qGAuBzF,CAAC;AAEF,eAAO,MAAM,6BAA6B;QAIP,MAAM;WAAS,+BAA+B;WAYhF,CAAC"}
+{"version":3,"file":"useBuiProctoring.d.ts","sourceRoot":"","sources":["../../../src/buildmyiq/hooks/useBuiProctoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,KAAK,EACV,aAAa,EACb,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,+BAA+B,EAC/B,gCAAgC,EACjC,MAAM,UAAU,CAAC;AAkClB;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GAAI,cAAc,MAAM,GAAG,SAAS,EAAE,iBAAc,gGAwBzF,CAAC;AAEF,eAAO,MAAM,4BAA4B,uGAkBxC,CAAC;AAEF,eAAO,MAAM,8BAA8B;QAIR,MAAM;WAAS,gCAAgC;WAejF,CAAC;AAEF,6FAA6F;AAC7F,eAAO,MAAM,+BAA+B,uGAkB3C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B;QAIP,MAAM;aAAW,wBAAwB,EAAE;WAc7E,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,8BAA8B,GAAI,WAAW,MAAM,GAAG,SAAS,EAAE,iBAAc,4JA2B3F,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,wBAAwB,GACnC,MAAM;IAAE,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7E,iBAAc,wGAuBf,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GAAI,WAAW,MAAM,GAAG,SAAS,EAAE,iBAAc,qGAuBzF,CAAC;AAEF,eAAO,MAAM,6BAA6B;QAIP,MAAM;WAAS,+BAA+B;WAYhF,CAAC"}

package/dist/buildmyiq/hooks/useBuiProctoring.js

@@ -1,9 +1,9 @@
 import { useBuildmyiq as e } from "../context/BuildmyiqContext.js";
 import "../context/index.js";
 import { wspaceFetch as t } from "./useBuiFiles.js";
-import { useMutation as n, useQuery as r, useQueryClient as i } from "@tanstack/react-query";
+import { useInfiniteQuery as n, useMutation as r, useQuery as i, useQueryClient as a } from "@tanstack/react-query";
 //#region src/buildmyiq/hooks/useBuiProctoring.ts
-var a = "\n  id workspaceId assessmentId learnerId status lockdownAcknowledgedAt violationCount\n  reviewedById reviewedAt reviewNotes expiresAt createdAt updatedAt\n  identityFile { id }\n", o = {
+var o = "\n  id workspaceId assessmentId learnerId status lockdownAcknowledgedAt violationCount\n  aiMonitoringConsentAt signalCount reviewedById reviewedAt reviewNotes expiresAt createdAt updatedAt\n  identityFile { id }\n", s = {
 	mine: (e) => [
 		"buildmyiq",
 		"proctoring",
@@ -20,96 +20,128 @@ var a = "\n  id workspaceId assessmentId learnerId status lockdownAcknowledgedAt
 		"proctoring",
 		"identity-file",
 		e
+	],
+	signals: (e) => [
+		"buildmyiq",
+		"proctoring",
+		"signals",
+		e
 	]
-}, s = 4 * 6e4, c = 15e3, l = (n, i = !0) => {
-	let { apiGatewayUrl: s } = e();
-	return r({
-		queryKey: n ? o.mine(n) : [
+}, c = 4 * 6e4, l = "\n  id sessionId type startedAt durationMs confidence faceCount peakLevelDb createdAt\n", u = 15e3, d = (n, r = !0) => {
+	let { apiGatewayUrl: a } = e();
+	return i({
+		queryKey: n ? s.mine(n) : [
 			"buildmyiq",
 			"proctoring",
 			"mine",
 			"nil"
 		],
-		enabled: !!n && i,
+		enabled: !!n && r,
 		queryFn: async () => (await t(`query BuiMyProctoringSession($assessmentId: ID!) {
-          buiMyProctoringSession(assessmentId: $assessmentId) { ${a} }
-        }`, { assessmentId: n }, s)).buiMyProctoringSession,
+          buiMyProctoringSession(assessmentId: $assessmentId) { ${o} }
+        }`, { assessmentId: n }, a)).buiMyProctoringSession,
 		refetchInterval: (e) => {
 			let t = e.state.data?.status;
-			return t === "UNDER_REVIEW" || t === "IDENTITY_SUBMITTED" ? c : !1;
+			return t === "UNDER_REVIEW" || t === "IDENTITY_SUBMITTED" ? u : !1;
 		}
 	});
-}, u = () => {
-	let { apiGatewayUrl: r } = e(), s = i();
-	return n({
+}, f = () => {
+	let { apiGatewayUrl: n } = e(), i = a();
+	return r({
 		mutationFn: async (e) => (await t(`mutation BuiStartProctoringSession($assessmentId: ID!) {
-          buiStartProctoringSession(assessmentId: $assessmentId) { ${a} }
-        }`, { assessmentId: e }, r)).buiStartProctoringSession,
+          buiStartProctoringSession(assessmentId: $assessmentId) { ${o} }
+        }`, { assessmentId: e }, n)).buiStartProctoringSession,
 		onSuccess: (e) => {
-			s.setQueryData(o.mine(e.assessmentId), e);
+			i.setQueryData(s.mine(e.assessmentId), e);
 		}
 	});
-}, d = () => {
-	let { apiGatewayUrl: r } = e(), s = i();
-	return n({
+}, p = () => {
+	let { apiGatewayUrl: n } = e(), i = a();
+	return r({
 		mutationFn: async (e) => (await t(`mutation BuiSubmitProctoringIdentity($id: ID!, $input: BuiSubmitProctoringIdentityInput!) {
-          buiSubmitProctoringIdentity(id: $id, input: $input) { ${a} }
-        }`, e, r)).buiSubmitProctoringIdentity,
+          buiSubmitProctoringIdentity(id: $id, input: $input) { ${o} }
+        }`, e, n)).buiSubmitProctoringIdentity,
 		onSuccess: (e) => {
-			s.setQueryData(o.mine(e.assessmentId), e), s.invalidateQueries({ queryKey: o.queue });
+			i.setQueryData(s.mine(e.assessmentId), e), i.invalidateQueries({ queryKey: s.queue });
 		}
 	});
-}, f = () => {
-	let { apiGatewayUrl: r } = e(), s = i();
-	return n({
-		mutationFn: async (e) => (await t(`mutation BuiReportProctoringViolation($id: ID!) {
-          buiReportProctoringViolation(id: $id) { ${a} }
-        }`, { id: e }, r)).buiReportProctoringViolation,
+}, m = () => {
+	let { apiGatewayUrl: n } = e(), i = a();
+	return r({
+		mutationFn: async (e) => (await t(`mutation BuiRecordProctoringSignals($id: ID!, $signals: [BuiProctoringSignalInput!]!) {
+          buiRecordProctoringSignals(id: $id, signals: $signals) { ${o} }
+        }`, e, n)).buiRecordProctoringSignals,
 		onSuccess: (e) => {
-			s.setQueryData(o.mine(e.assessmentId), e);
+			i.setQueryData(s.mine(e.assessmentId), e);
 		}
 	});
-}, p = (n, i = !0) => {
-	let { apiGatewayUrl: s } = e(), { status: c, assessmentId: l, limit: u = 50 } = n;
-	return r({
+}, h = (r, i = !0) => {
+	let { apiGatewayUrl: a } = e();
+	return n({
+		queryKey: r ? s.signals(r) : [
+			"buildmyiq",
+			"proctoring",
+			"signals",
+			"nil"
+		],
+		enabled: !!r && i,
+		initialPageParam: void 0,
+		queryFn: async ({ pageParam: e }) => (await t(`query BuiProctoringSessionSignals($sessionId: ID!, $limit: Int, $after: ID) {
+          buiProctoringSessionSignals(sessionId: $sessionId, limit: $limit, after: $after) {
+            items { ${l} }
+            pageInfo { cursor hasMore }
+          }
+        }`, e ? {
+			sessionId: r,
+			limit: 100,
+			after: e
+		} : {
+			sessionId: r,
+			limit: 100
+		}, a)).buiProctoringSessionSignals,
+		getNextPageParam: (e) => e.pageInfo.hasMore ? e.pageInfo.cursor ?? void 0 : void 0
+	});
+}, g = (n, r = !0) => {
+	let { apiGatewayUrl: a } = e(), { status: c, assessmentId: l, limit: u = 50 } = n;
+	return i({
 		queryKey: [
-			...o.queue,
+			...s.queue,
 			c ?? "ALL",
 			l ?? "ALL",
 			u
 		],
-		enabled: i,
+		enabled: r,
 		queryFn: async () => (await t(`query BuiListProctoringSessions($assessmentId: ID, $status: BuiProctoringStatus, $pagination: PaginationInput) {
           buiListProctoringSessions(assessmentId: $assessmentId, status: $status, pagination: $pagination) {
-            items { ${a} }
+            items { ${o} }
             pageInfo { cursor hasMore }
           }
         }`, {
 			assessmentId: l,
 			status: c,
 			pagination: { limit: u }
-		}, s)).buiListProctoringSessions
+		}, a)).buiListProctoringSessions
 	});
-}, m = (n, i = !0) => {
+}, _ = (n, r = !0) => {
 	let { apiGatewayUrl: a } = e();
-	return r({
-		queryKey: o.identityFile(n ?? "nil"),
-		enabled: !!n && i,
-		staleTime: s,
-		refetchInterval: s,
+	return i({
+		queryKey: s.identityFile(n ?? "nil"),
+		enabled: !!n && r,
+		staleTime: c,
+		refetchInterval: c,
 		retry: !1,
 		queryFn: async () => (await t("query BuiProctoringIdentityFile($sessionId: ID!) {\n          buiProctoringIdentityFile(sessionId: $sessionId) {\n            fileId name mimeType size downloadUrl expiresAt\n          }\n        }", { sessionId: n }, a)).buiProctoringIdentityFile
 	});
-}, h = () => {
-	let { apiGatewayUrl: r } = e(), s = i();
-	return n({
+}, v = () => {
+	let { apiGatewayUrl: n } = e(), i = a();
+	return r({
 		mutationFn: async (e) => (await t(`mutation BuiReviewProctoringSession($id: ID!, $input: BuiReviewProctoringSessionInput!) {
-          buiReviewProctoringSession(id: $id, input: $input) { ${a} }
-        }`, e, r)).buiReviewProctoringSession,
-		onSuccess: () => s.invalidateQueries({ queryKey: o.queue })
+          buiReviewProctoringSession(id: $id, input: $input) { ${o} }
+        }`, e, n)).buiReviewProctoringSession,
+		onSuccess: () => i.invalidateQueries({ queryKey: s.queue })
 	});
 };
 //#endregion
-export { l as useBuiMyProctoringSession, m as useBuiProctoringIdentityFile, p as useBuiProctoringSessions, f as useBuiReportProctoringViolation, h as useBuiReviewProctoringSession, u as useBuiStartProctoringSession, d as useBuiSubmitProctoringIdentity };
+export { d as useBuiMyProctoringSession, _ as useBuiProctoringIdentityFile, h as useBuiProctoringSessionSignals, g as useBuiProctoringSessions, m as useBuiRecordProctoringSignals, v as useBuiReviewProctoringSession, f as useBuiStartProctoringSession, p as useBuiSubmitProctoringIdentity };
 
 //# sourceMappingURL=useBuiProctoring.js.map

package/dist/buildmyiq/hooks/useBuiProctoring.js.map

@@ -1 +1 @@
-{"version":3,"file":"useBuiProctoring.js","names":[],"sources":["../../../src/buildmyiq/hooks/useBuiProctoring.ts"],"sourcesContent":["/**\n * Buildmyiq — high-stakes exam proctoring hooks (BOFF-4431).\n * @module buildmyiq/hooks/useBuiProctoring\n *\n * Wired to the `wspace-buildmyiq-svc` proctoring contract:\n *   - learner (self-scoped): `buiMyProctoringSession`, `buiStartProctoringSession`,\n *     `buiSubmitProctoringIdentity`, `buiReportProctoringViolation`\n *   - reviewer (workspace-scoped): `buiListProctoringSessions`,\n *     `buiReviewProctoringSession`, `buiProctoringIdentityFile`\n *\n * The backend is the gate: `buiSubmitAssessment` refuses a `requiresProctoring`\n * assessment unless the learner's latest session is APPROVED and unexpired.\n * These hooks only drive the UI through that lifecycle.\n */\n\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';\n\nimport { useBuildmyiq } from '../context';\nimport { wspaceFetch } from './useBuiFiles';\nimport type {\n  BuiConnection,\n  BuiProctoringIdentityFile,\n  BuiProctoringSession,\n  BuiProctoringStatus,\n  BuiReviewProctoringSessionInput,\n  BuiSubmitProctoringIdentityInput,\n} from '../types';\n\n// `identityFile` selects ONLY `id`: wspace-files-svc's File entity has no\n// __resolveReference, so any other field on a federated File stub fails the\n// whole operation. The learner's photo ID is PRIVATE in the file store\n// (BOFF-9691), so the reviewer page opens it through `buiProctoringIdentityFile`\n// (useBuiProctoringIdentityFile), never through the files graph.\nconst PROCTORING_SESSION_FIELDS = `\n  id workspaceId assessmentId learnerId status lockdownAcknowledgedAt violationCount\n  reviewedById reviewedAt reviewNotes expiresAt createdAt updatedAt\n  identityFile { id }\n`;\n\nconst PROCTORING_KEY = {\n  mine: (assessmentId: string) => ['buildmyiq', 'proctoring', 'mine', assessmentId] as const,\n  queue: ['buildmyiq', 'proctoring', 'queue'] as const,\n  identityFile: (sessionId: string) =>\n    ['buildmyiq', 'proctoring', 'identity-file', sessionId] as const,\n};\n\n/**\n * The backend presigns the identity URL for about five minutes; re-fetch well\n * before that so an open review page never holds a dead link.\n */\nconst IDENTITY_URL_REFRESH_MS = 4 * 60_000;\n\n/** How often the learner's waiting screen re-checks for a reviewer decision. */\nconst AWAITING_REVIEW_POLL_MS = 15_000;\n\n/**\n * The calling learner's most recent proctoring session for an assessment\n * (null when they have never started one). Polls while a reviewer decision\n * is pending so the exam unlocks without a manual refresh.\n */\nexport const useBuiMyProctoringSession = (assessmentId: string | undefined, enabled = true) => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  return useQuery({\n    queryKey: assessmentId\n      ? PROCTORING_KEY.mine(assessmentId)\n      : ['buildmyiq', 'proctoring', 'mine', 'nil'],\n    enabled: Boolean(assessmentId) && enabled,\n    queryFn: async () => {\n      const data = await wspaceFetch<{ buiMyProctoringSession: BuiProctoringSession | null }>(\n        `query BuiMyProctoringSession($assessmentId: ID!) {\n          buiMyProctoringSession(assessmentId: $assessmentId) { ${PROCTORING_SESSION_FIELDS} }\n        }`,\n        { assessmentId },\n        apiGatewayUrl\n      );\n      return data.buiMyProctoringSession;\n    },\n    refetchInterval: (query) => {\n      const status = query.state.data?.status;\n      return status === 'UNDER_REVIEW' || status === 'IDENTITY_SUBMITTED'\n        ? AWAITING_REVIEW_POLL_MS\n        : false;\n    },\n  });\n};\n\nexport const useBuiStartProctoringSession = () => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  const qc = useQueryClient();\n  return useMutation({\n    mutationFn: async (assessmentId: string) => {\n      const data = await wspaceFetch<{ buiStartProctoringSession: BuiProctoringSession }>(\n        `mutation BuiStartProctoringSession($assessmentId: ID!) {\n          buiStartProctoringSession(assessmentId: $assessmentId) { ${PROCTORING_SESSION_FIELDS} }\n        }`,\n        { assessmentId },\n        apiGatewayUrl\n      );\n      return data.buiStartProctoringSession;\n    },\n    onSuccess: (session) => {\n      qc.setQueryData(PROCTORING_KEY.mine(session.assessmentId), session);\n    },\n  });\n};\n\nexport const useBuiSubmitProctoringIdentity = () => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  const qc = useQueryClient();\n  return useMutation({\n    mutationFn: async (args: { id: string; input: BuiSubmitProctoringIdentityInput }) => {\n      const data = await wspaceFetch<{ buiSubmitProctoringIdentity: BuiProctoringSession }>(\n        `mutation BuiSubmitProctoringIdentity($id: ID!, $input: BuiSubmitProctoringIdentityInput!) {\n          buiSubmitProctoringIdentity(id: $id, input: $input) { ${PROCTORING_SESSION_FIELDS} }\n        }`,\n        args,\n        apiGatewayUrl\n      );\n      return data.buiSubmitProctoringIdentity;\n    },\n    onSuccess: (session) => {\n      qc.setQueryData(PROCTORING_KEY.mine(session.assessmentId), session);\n      void qc.invalidateQueries({ queryKey: PROCTORING_KEY.queue });\n    },\n  });\n};\n\n/** Records one lockdown violation (tab switch, window blur, fullscreen exit, copy/paste). */\nexport const useBuiReportProctoringViolation = () => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  const qc = useQueryClient();\n  return useMutation({\n    mutationFn: async (id: string) => {\n      const data = await wspaceFetch<{ buiReportProctoringViolation: BuiProctoringSession }>(\n        `mutation BuiReportProctoringViolation($id: ID!) {\n          buiReportProctoringViolation(id: $id) { ${PROCTORING_SESSION_FIELDS} }\n        }`,\n        { id },\n        apiGatewayUrl\n      );\n      return data.buiReportProctoringViolation;\n    },\n    onSuccess: (session) => {\n      qc.setQueryData(PROCTORING_KEY.mine(session.assessmentId), session);\n    },\n  });\n};\n\n/** Reviewer queue: proctoring sessions in the workspace, optionally filtered by status. */\nexport const useBuiProctoringSessions = (\n  args: { status?: BuiProctoringStatus; assessmentId?: string; limit?: number },\n  enabled = true\n) => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  const { status, assessmentId, limit = 50 } = args;\n  return useQuery({\n    queryKey: [...PROCTORING_KEY.queue, status ?? 'ALL', assessmentId ?? 'ALL', limit],\n    enabled,\n    queryFn: async () => {\n      const data = await wspaceFetch<{\n        buiListProctoringSessions: BuiConnection<BuiProctoringSession>;\n      }>(\n        `query BuiListProctoringSessions($assessmentId: ID, $status: BuiProctoringStatus, $pagination: PaginationInput) {\n          buiListProctoringSessions(assessmentId: $assessmentId, status: $status, pagination: $pagination) {\n            items { ${PROCTORING_SESSION_FIELDS} }\n            pageInfo { cursor hasMore }\n          }\n        }`,\n        { assessmentId, status, pagination: { limit } },\n        apiGatewayUrl\n      );\n      return data.buiListProctoringSessions;\n    },\n  });\n};\n\n/**\n * Reviewer-only: the learner's identity photo/ID for one session, with a\n * short-lived download URL (BOFF-9691). Null when the session has none.\n */\nexport const useBuiProctoringIdentityFile = (sessionId: string | undefined, enabled = true) => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  return useQuery({\n    queryKey: PROCTORING_KEY.identityFile(sessionId ?? 'nil'),\n    enabled: Boolean(sessionId) && enabled,\n    staleTime: IDENTITY_URL_REFRESH_MS,\n    refetchInterval: IDENTITY_URL_REFRESH_MS,\n    retry: false,\n    queryFn: async () => {\n      const data = await wspaceFetch<{\n        buiProctoringIdentityFile: BuiProctoringIdentityFile | null;\n      }>(\n        `query BuiProctoringIdentityFile($sessionId: ID!) {\n          buiProctoringIdentityFile(sessionId: $sessionId) {\n            fileId name mimeType size downloadUrl expiresAt\n          }\n        }`,\n        { sessionId },\n        apiGatewayUrl\n      );\n      return data.buiProctoringIdentityFile;\n    },\n  });\n};\n\nexport const useBuiReviewProctoringSession = () => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  const qc = useQueryClient();\n  return useMutation({\n    mutationFn: async (args: { id: string; input: BuiReviewProctoringSessionInput }) => {\n      const data = await wspaceFetch<{ buiReviewProctoringSession: BuiProctoringSession }>(\n        `mutation BuiReviewProctoringSession($id: ID!, $input: BuiReviewProctoringSessionInput!) {\n          buiReviewProctoringSession(id: $id, input: $input) { ${PROCTORING_SESSION_FIELDS} }\n        }`,\n        args,\n        apiGatewayUrl\n      );\n      return data.buiReviewProctoringSession;\n    },\n    onSuccess: () => qc.invalidateQueries({ queryKey: PROCTORING_KEY.queue }),\n  });\n};\n"],"mappings":";;;;;AAiCA,IAAM,IAA4B,wLAM5B,IAAiB;CACrB,OAAO,MAAyB;EAAC;EAAa;EAAc;EAAQ;CAAY;CAChF,OAAO;EAAC;EAAa;EAAc;CAAO;CAC1C,eAAe,MACb;EAAC;EAAa;EAAc;EAAiB;CAAS;AAC1D,GAMM,IAA0B,IAAI,KAG9B,IAA0B,MAOnB,KAA6B,GAAkC,IAAU,OAAS;CAC7F,IAAM,EAAE,qBAAkB,EAAa;CACvC,OAAO,EAAS;EACd,UAAU,IACN,EAAe,KAAK,CAAY,IAChC;GAAC;GAAa;GAAc;GAAQ;EAAK;EAC7C,SAAS,EAAQ,KAAiB;EAClC,SAAS,aAQA,MAPY,EACjB;kEAC0D,EAA0B;YAEpF,EAAE,gBAAa,GACf,CACF,GACY;EAEd,kBAAkB,MAAU;GAC1B,IAAM,IAAS,EAAM,MAAM,MAAM;GACjC,OAAO,MAAW,kBAAkB,MAAW,uBAC3C,IACA;EACN;CACF,CAAC;AACH,GAEa,UAAqC;CAChD,IAAM,EAAE,qBAAkB,EAAa,GACjC,IAAK,EAAe;CAC1B,OAAO,EAAY;EACjB,YAAY,OAAO,OAQV,MAPY,EACjB;qEAC6D,EAA0B;YAEvF,EAAE,gBAAa,GACf,CACF,GACY;EAEd,YAAY,MAAY;GACtB,EAAG,aAAa,EAAe,KAAK,EAAQ,YAAY,GAAG,CAAO;EACpE;CACF,CAAC;AACH,GAEa,UAAuC;CAClD,IAAM,EAAE,qBAAkB,EAAa,GACjC,IAAK,EAAe;CAC1B,OAAO,EAAY;EACjB,YAAY,OAAO,OAQV,MAPY,EACjB;kEAC0D,EAA0B;YAEpF,GACA,CACF,GACY;EAEd,YAAY,MAAY;GAEtB,AADA,EAAG,aAAa,EAAe,KAAK,EAAQ,YAAY,GAAG,CAAO,GAClE,EAAQ,kBAAkB,EAAE,UAAU,EAAe,MAAM,CAAC;EAC9D;CACF,CAAC;AACH,GAGa,UAAwC;CACnD,IAAM,EAAE,qBAAkB,EAAa,GACjC,IAAK,EAAe;CAC1B,OAAO,EAAY;EACjB,YAAY,OAAO,OAQV,MAPY,EACjB;oDAC4C,EAA0B;YAEtE,EAAE,MAAG,GACL,CACF,GACY;EAEd,YAAY,MAAY;GACtB,EAAG,aAAa,EAAe,KAAK,EAAQ,YAAY,GAAG,CAAO;EACpE;CACF,CAAC;AACH,GAGa,KACX,GACA,IAAU,OACP;CACH,IAAM,EAAE,qBAAkB,EAAa,GACjC,EAAE,WAAQ,iBAAc,WAAQ,OAAO;CAC7C,OAAO,EAAS;EACd,UAAU;GAAC,GAAG,EAAe;GAAO,KAAU;GAAO,KAAgB;GAAO;EAAK;EACjF;EACA,SAAS,aAaA,MAZY,EAGjB;;sBAEc,EAA0B;;;YAIxC;GAAE;GAAc;GAAQ,YAAY,EAAE,SAAM;EAAE,GAC9C,CACF,GACY;CAEhB,CAAC;AACH,GAMa,KAAgC,GAA+B,IAAU,OAAS;CAC7F,IAAM,EAAE,qBAAkB,EAAa;CACvC,OAAO,EAAS;EACd,UAAU,EAAe,aAAa,KAAa,KAAK;EACxD,SAAS,EAAQ,KAAc;EAC/B,WAAW;EACX,iBAAiB;EACjB,OAAO;EACP,SAAS,aAYA,MAXY,EAGjB,yMAKA,EAAE,aAAU,GACZ,CACF,GACY;CAEhB,CAAC;AACH,GAEa,UAAsC;CACjD,IAAM,EAAE,qBAAkB,EAAa,GACjC,IAAK,EAAe;CAC1B,OAAO,EAAY;EACjB,YAAY,OAAO,OAQV,MAPY,EACjB;iEACyD,EAA0B;YAEnF,GACA,CACF,GACY;EAEd,iBAAiB,EAAG,kBAAkB,EAAE,UAAU,EAAe,MAAM,CAAC;CAC1E,CAAC;AACH"}
+{"version":3,"file":"useBuiProctoring.js","names":[],"sources":["../../../src/buildmyiq/hooks/useBuiProctoring.ts"],"sourcesContent":["/**\n * Buildmyiq — high-stakes exam proctoring hooks (BOFF-4431).\n * @module buildmyiq/hooks/useBuiProctoring\n *\n * Wired to the `wspace-buildmyiq-svc` proctoring contract:\n *   - learner (self-scoped): `buiMyProctoringSession`, `buiStartProctoringSession`,\n *     `buiSubmitProctoringIdentity`, `buiReportProctoringViolation`\n *   - reviewer (workspace-scoped): `buiListProctoringSessions`,\n *     `buiReviewProctoringSession`, `buiProctoringIdentityFile`\n *   - BOFF-9690 signals: `buiRecordProctoringSignals` (learner, own session)\n *     and the reviewer timeline `buiProctoringSessionSignals`\n *\n * The backend is the gate: `buiSubmitAssessment` refuses a `requiresProctoring`\n * assessment unless the learner's latest session is APPROVED and unexpired.\n * These hooks only drive the UI through that lifecycle.\n */\n\nimport { useInfiniteQuery, useMutation, useQuery, useQueryClient } from '@tanstack/react-query';\n\nimport { useBuildmyiq } from '../context';\nimport { wspaceFetch } from './useBuiFiles';\nimport type {\n  BuiConnection,\n  BuiProctoringIdentityFile,\n  BuiProctoringSession,\n  BuiProctoringSignal,\n  BuiProctoringSignalInput,\n  BuiProctoringStatus,\n  BuiReviewProctoringSessionInput,\n  BuiSubmitProctoringIdentityInput,\n} from '../types';\n\n// `identityFile` selects ONLY `id`: wspace-files-svc's File entity has no\n// __resolveReference, so any other field on a federated File stub fails the\n// whole operation. The learner's photo ID is PRIVATE in the file store\n// (BOFF-9691), so the reviewer page opens it through `buiProctoringIdentityFile`\n// (useBuiProctoringIdentityFile), never through the files graph.\nconst PROCTORING_SESSION_FIELDS = `\n  id workspaceId assessmentId learnerId status lockdownAcknowledgedAt violationCount\n  aiMonitoringConsentAt signalCount reviewedById reviewedAt reviewNotes expiresAt createdAt updatedAt\n  identityFile { id }\n`;\n\nconst PROCTORING_KEY = {\n  mine: (assessmentId: string) => ['buildmyiq', 'proctoring', 'mine', assessmentId] as const,\n  queue: ['buildmyiq', 'proctoring', 'queue'] as const,\n  identityFile: (sessionId: string) =>\n    ['buildmyiq', 'proctoring', 'identity-file', sessionId] as const,\n  signals: (sessionId: string) => ['buildmyiq', 'proctoring', 'signals', sessionId] as const,\n};\n\n/**\n * The backend presigns the identity URL for about five minutes; re-fetch well\n * before that so an open review page never holds a dead link.\n */\nconst IDENTITY_URL_REFRESH_MS = 4 * 60_000;\n\nconst PROCTORING_SIGNAL_FIELDS = `\n  id sessionId type startedAt durationMs confidence faceCount peakLevelDb createdAt\n`;\n\n/** How often the learner's waiting screen re-checks for a reviewer decision. */\nconst AWAITING_REVIEW_POLL_MS = 15_000;\n\n/**\n * The calling learner's most recent proctoring session for an assessment\n * (null when they have never started one). Polls while a reviewer decision\n * is pending so the exam unlocks without a manual refresh.\n */\nexport const useBuiMyProctoringSession = (assessmentId: string | undefined, enabled = true) => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  return useQuery({\n    queryKey: assessmentId\n      ? PROCTORING_KEY.mine(assessmentId)\n      : ['buildmyiq', 'proctoring', 'mine', 'nil'],\n    enabled: Boolean(assessmentId) && enabled,\n    queryFn: async () => {\n      const data = await wspaceFetch<{ buiMyProctoringSession: BuiProctoringSession | null }>(\n        `query BuiMyProctoringSession($assessmentId: ID!) {\n          buiMyProctoringSession(assessmentId: $assessmentId) { ${PROCTORING_SESSION_FIELDS} }\n        }`,\n        { assessmentId },\n        apiGatewayUrl\n      );\n      return data.buiMyProctoringSession;\n    },\n    refetchInterval: (query) => {\n      const status = query.state.data?.status;\n      return status === 'UNDER_REVIEW' || status === 'IDENTITY_SUBMITTED'\n        ? AWAITING_REVIEW_POLL_MS\n        : false;\n    },\n  });\n};\n\nexport const useBuiStartProctoringSession = () => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  const qc = useQueryClient();\n  return useMutation({\n    mutationFn: async (assessmentId: string) => {\n      const data = await wspaceFetch<{ buiStartProctoringSession: BuiProctoringSession }>(\n        `mutation BuiStartProctoringSession($assessmentId: ID!) {\n          buiStartProctoringSession(assessmentId: $assessmentId) { ${PROCTORING_SESSION_FIELDS} }\n        }`,\n        { assessmentId },\n        apiGatewayUrl\n      );\n      return data.buiStartProctoringSession;\n    },\n    onSuccess: (session) => {\n      qc.setQueryData(PROCTORING_KEY.mine(session.assessmentId), session);\n    },\n  });\n};\n\nexport const useBuiSubmitProctoringIdentity = () => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  const qc = useQueryClient();\n  return useMutation({\n    mutationFn: async (args: { id: string; input: BuiSubmitProctoringIdentityInput }) => {\n      const data = await wspaceFetch<{ buiSubmitProctoringIdentity: BuiProctoringSession }>(\n        `mutation BuiSubmitProctoringIdentity($id: ID!, $input: BuiSubmitProctoringIdentityInput!) {\n          buiSubmitProctoringIdentity(id: $id, input: $input) { ${PROCTORING_SESSION_FIELDS} }\n        }`,\n        args,\n        apiGatewayUrl\n      );\n      return data.buiSubmitProctoringIdentity;\n    },\n    onSuccess: (session) => {\n      qc.setQueryData(PROCTORING_KEY.mine(session.assessmentId), session);\n      void qc.invalidateQueries({ queryKey: PROCTORING_KEY.queue });\n    },\n  });\n};\n\n/** Records one lockdown violation (tab switch, window blur, fullscreen exit, copy/paste). */\nexport const useBuiReportProctoringViolation = () => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  const qc = useQueryClient();\n  return useMutation({\n    mutationFn: async (id: string) => {\n      const data = await wspaceFetch<{ buiReportProctoringViolation: BuiProctoringSession }>(\n        `mutation BuiReportProctoringViolation($id: ID!) {\n          buiReportProctoringViolation(id: $id) { ${PROCTORING_SESSION_FIELDS} }\n        }`,\n        { id },\n        apiGatewayUrl\n      );\n      return data.buiReportProctoringViolation;\n    },\n    onSuccess: (session) => {\n      qc.setQueryData(PROCTORING_KEY.mine(session.assessmentId), session);\n    },\n  });\n};\n\n/**\n * BOFF-9690: records a batch (max 50) of signal episodes on the learner's own\n * approved session — lockdown events and, when the assessment opted in and\n * the learner consented, in-browser AI signals.\n */\nexport const useBuiRecordProctoringSignals = () => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  const qc = useQueryClient();\n  return useMutation({\n    mutationFn: async (args: { id: string; signals: BuiProctoringSignalInput[] }) => {\n      const data = await wspaceFetch<{ buiRecordProctoringSignals: BuiProctoringSession }>(\n        `mutation BuiRecordProctoringSignals($id: ID!, $signals: [BuiProctoringSignalInput!]!) {\n          buiRecordProctoringSignals(id: $id, signals: $signals) { ${PROCTORING_SESSION_FIELDS} }\n        }`,\n        args,\n        apiGatewayUrl\n      );\n      return data.buiRecordProctoringSignals;\n    },\n    onSuccess: (session) => {\n      qc.setQueryData(PROCTORING_KEY.mine(session.assessmentId), session);\n    },\n  });\n};\n\n/** BOFF-9690: reviewer timeline of one session's signals, oldest first, 100 per page. */\nexport const useBuiProctoringSessionSignals = (sessionId: string | undefined, enabled = true) => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  return useInfiniteQuery({\n    queryKey: sessionId\n      ? PROCTORING_KEY.signals(sessionId)\n      : ['buildmyiq', 'proctoring', 'signals', 'nil'],\n    enabled: Boolean(sessionId) && enabled,\n    initialPageParam: undefined as string | undefined,\n    queryFn: async ({ pageParam }) => {\n      const data = await wspaceFetch<{\n        buiProctoringSessionSignals: BuiConnection<BuiProctoringSignal>;\n      }>(\n        `query BuiProctoringSessionSignals($sessionId: ID!, $limit: Int, $after: ID) {\n          buiProctoringSessionSignals(sessionId: $sessionId, limit: $limit, after: $after) {\n            items { ${PROCTORING_SIGNAL_FIELDS} }\n            pageInfo { cursor hasMore }\n          }\n        }`,\n        // Explicit limit/after: the composed PaginationInput carries only `limit`.\n        pageParam ? { sessionId, limit: 100, after: pageParam } : { sessionId, limit: 100 },\n        apiGatewayUrl\n      );\n      return data.buiProctoringSessionSignals;\n    },\n    getNextPageParam: (last) =>\n      last.pageInfo.hasMore ? (last.pageInfo.cursor ?? undefined) : undefined,\n  });\n};\n\n/** Reviewer queue: proctoring sessions in the workspace, optionally filtered by status. */\nexport const useBuiProctoringSessions = (\n  args: { status?: BuiProctoringStatus; assessmentId?: string; limit?: number },\n  enabled = true\n) => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  const { status, assessmentId, limit = 50 } = args;\n  return useQuery({\n    queryKey: [...PROCTORING_KEY.queue, status ?? 'ALL', assessmentId ?? 'ALL', limit],\n    enabled,\n    queryFn: async () => {\n      const data = await wspaceFetch<{\n        buiListProctoringSessions: BuiConnection<BuiProctoringSession>;\n      }>(\n        `query BuiListProctoringSessions($assessmentId: ID, $status: BuiProctoringStatus, $pagination: PaginationInput) {\n          buiListProctoringSessions(assessmentId: $assessmentId, status: $status, pagination: $pagination) {\n            items { ${PROCTORING_SESSION_FIELDS} }\n            pageInfo { cursor hasMore }\n          }\n        }`,\n        { assessmentId, status, pagination: { limit } },\n        apiGatewayUrl\n      );\n      return data.buiListProctoringSessions;\n    },\n  });\n};\n\n/**\n * Reviewer-only: the learner's identity photo/ID for one session, with a\n * short-lived download URL (BOFF-9691). Null when the session has none.\n */\nexport const useBuiProctoringIdentityFile = (sessionId: string | undefined, enabled = true) => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  return useQuery({\n    queryKey: PROCTORING_KEY.identityFile(sessionId ?? 'nil'),\n    enabled: Boolean(sessionId) && enabled,\n    staleTime: IDENTITY_URL_REFRESH_MS,\n    refetchInterval: IDENTITY_URL_REFRESH_MS,\n    retry: false,\n    queryFn: async () => {\n      const data = await wspaceFetch<{\n        buiProctoringIdentityFile: BuiProctoringIdentityFile | null;\n      }>(\n        `query BuiProctoringIdentityFile($sessionId: ID!) {\n          buiProctoringIdentityFile(sessionId: $sessionId) {\n            fileId name mimeType size downloadUrl expiresAt\n          }\n        }`,\n        { sessionId },\n        apiGatewayUrl\n      );\n      return data.buiProctoringIdentityFile;\n    },\n  });\n};\n\nexport const useBuiReviewProctoringSession = () => {\n  const { apiGatewayUrl } = useBuildmyiq();\n  const qc = useQueryClient();\n  return useMutation({\n    mutationFn: async (args: { id: string; input: BuiReviewProctoringSessionInput }) => {\n      const data = await wspaceFetch<{ buiReviewProctoringSession: BuiProctoringSession }>(\n        `mutation BuiReviewProctoringSession($id: ID!, $input: BuiReviewProctoringSessionInput!) {\n          buiReviewProctoringSession(id: $id, input: $input) { ${PROCTORING_SESSION_FIELDS} }\n        }`,\n        args,\n        apiGatewayUrl\n      );\n      return data.buiReviewProctoringSession;\n    },\n    onSuccess: () => qc.invalidateQueries({ queryKey: PROCTORING_KEY.queue }),\n  });\n};\n"],"mappings":"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"}

package/dist/buildmyiq/hooks/useBuildmyiqApi.d.ts

@@ -71,6 +71,7 @@ export declare const useBuiAssessments: (courseId: string | undefined, status?:
     timeLimitMin: number;
     isGraded: boolean;
     requiresProctoring: boolean;
+    aiProctoringEnabled: boolean;
 }[]>, Error>;
 export declare const useBuiAssessment: (id: string | undefined) => import('@tanstack/react-query').UseQueryResult<NoInfer<BuiAssessment | null>, Error>;
 export declare const useBuiCreateAssessment: () => import('@tanstack/react-query').UseMutationResult<BuiAssessment, Error, BuiCreateAssessmentInput, unknown>;