@sudobility/sudojo_lib 0.0.201 → 0.0.203

package/dist/admin/jobs.js

@@ -0,0 +1,435 @@
+/**
+ * Admin batch jobs as framework-agnostic async functions over an
+ * {@link AdminApi}. The hooks in this folder wrap them with React state; the
+ * functions themselves hold the business rules (token refresh cadence, retry
+ * delays, stop conditions, technique → level search fallback).
+ *
+ * Ported from `sudojo_app/src/utils/admin/{BoardGenerator,TechniqueExtractor,
+ * ExampleCreator,boardTechniquesApi}.ts`; progress messages are unchanged.
+ */
+import { getTechniqueNameById, techniqueBitmaskOf, } from '@sudobility/sudojo_types';
+import { boardsAtLevelQuery, boardsWithoutTechniquesQuery, boardsWithTechniqueQuery, buildBoardTechniquesUpdate, buildValidatedBoard, compareExtractionWithSolver, parseGeneratedBoard, } from './boardRules';
+import { describeTechniqueMask, errorMessage, formatTechniqueMaskHex, levelToSave, shortUuid, } from './boardStrings';
+import { ADMIN_EXAMPLE_TARGET_PER_TECHNIQUE, ADMIN_TECHNIQUE_ORDER, BOARDS_PER_LEVEL_LIMIT, BOARDS_WITH_TECHNIQUE_LIMIT, buildExampleSaveRequests, buildTechniqueLevelMap, countForTechnique, hasReachedTarget, levelsToSearchForTechnique, } from './examples';
+import { extractBoardTechniques, isExtractionError, isTechniqueFound, } from './extraction';
+import { ADMIN_TOKEN_REFRESH_INTERVAL } from './types';
+/**
+ * Get the starting token. Returns null when `getToken` yields none (the job
+ * should report "Not authenticated"). Refreshes log "Token refreshed,
+ * continuing..." through `onProgress`; refresh failures only warn.
+ */
+export async function createAdminTokenManager(getToken, onProgress) {
+    const initial = await getToken();
+    if (!initial)
+        return null;
+    let current = initial;
+    return {
+        get current() {
+            return current;
+        },
+        async refresh() {
+            try {
+                const next = await getToken();
+                if (next) {
+                    current = next;
+                    onProgress('Token refreshed, continuing...');
+                }
+            }
+            catch (err) {
+                // The existing token might still be valid.
+                console.warn('[admin] Token refresh failed:', err);
+            }
+        },
+    };
+}
+/** True when the job should refresh its token before item `processed + 1`. */
+export function shouldRefreshToken(processed, interval = ADMIN_TOKEN_REFRESH_INTERVAL) {
+    return processed > 0 && processed % interval === 0;
+}
+const defaultDelay = (ms) => new Promise(resolve => setTimeout(resolve, ms));
+const techniqueName = (id) => getTechniqueNameById(id);
+// ============================================================================
+// Board API helpers (were boardTechniquesApi.ts)
+// ============================================================================
+/**
+ * Set a board's techniques bitmask (sent as an exact string) and level.
+ * Returns false on any failure.
+ */
+export async function updateBoardTechniques(api, token, boardUuid, techniques, level) {
+    try {
+        const response = await api.updateBoard(token, boardUuid, buildBoardTechniquesUpdate(techniques, level));
+        return response.success;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Boards with the technique's bit set (API `technique_bit` filter), any
+ * level. Returns [] on any failure.
+ */
+export async function fetchBoardsWithTechnique(api, token, techniqueId, limit) {
+    try {
+        const response = await api.getBoards(token, boardsWithTechniqueQuery(techniqueId, limit));
+        return response.success && response.data ? response.data : [];
+    }
+    catch {
+        return [];
+    }
+}
+/** The next board whose techniques were never extracted, or null. */
+export async function fetchBoardWithoutTechniques(api, token) {
+    try {
+        const response = await api.getBoards(token, boardsWithoutTechniquesQuery());
+        return (response.success && response.data?.[0]) || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Generate, validate and save boards until aborted or a save fails.
+ * Each board: /generate → /validate (source of truth for level, techniques,
+ * solution) → create. Generate/validate failures wait 1 s and retry.
+ * Returns the number of boards saved.
+ */
+export async function runBoardGeneration(ctx, options) {
+    const { api, token, abort, onProgress, onError } = ctx;
+    const delay = ctx.delay ?? defaultDelay;
+    onProgress('Fetching levels...');
+    try {
+        const levels = await api.getLevels();
+        if (!levels.success || !levels.data) {
+            onError(new Error('Failed to fetch levels'));
+            return 0;
+        }
+        if (levels.data.length === 0) {
+            onError(new Error('No levels found'));
+            return 0;
+        }
+    }
+    catch (err) {
+        onError(err instanceof Error ? err : new Error(String(err)));
+        return 0;
+    }
+    onProgress('Starting generation...');
+    let count = 0;
+    while (!abort.shouldAbort()) {
+        if (shouldRefreshToken(count))
+            await token.refresh();
+        try {
+            onProgress(`Generating board ${count + 1}...`);
+            const generated = await api.generate(token.current, {
+                symmetrical: options.symmetrical,
+            });
+            if (!generated.success || !generated.data) {
+                onProgress(`Error generating board: ${generated.error || 'Unknown error'}`);
+                await delay(1000);
+                continue;
+            }
+            const puzzle = parseGeneratedBoard(generated.data);
+            if (!puzzle.ok) {
+                onProgress(puzzle.reason === 'invalid'
+                    ? 'Error: Invalid response structure from solver'
+                    : 'Error: Missing puzzle data from solver');
+                await delay(1000);
+                continue;
+            }
+            onProgress(`Validating board ${count + 1}...`);
+            const validated = await api.validate(token.current, {
+                original: puzzle.original,
+            });
+            if (!validated.success || !validated.data) {
+                onProgress(`Error validating board: ${validated.error || 'Unknown error'}`);
+                await delay(1000);
+                continue;
+            }
+            const board = buildValidatedBoard(puzzle, validated.data, options.symmetrical);
+            onProgress(`Saving board ${count + 1}...`);
+            const created = await api.createBoard(token.current, board.request);
+            if (!created.success) {
+                onProgress(`Error saving board: ${created.error || 'Unknown error'}. Stopping.`);
+                break;
+            }
+            count++;
+            options.onBoardGenerated?.(count, board.level, board.techniques);
+            onProgress(`Generated ${count} boards (level ${board.level}, techniques: ${formatTechniqueMaskHex(board.techniques)})`);
+            await delay(100);
+        }
+        catch (err) {
+            onProgress(`Error: ${err instanceof Error ? err.message : 'Unknown error'}`);
+            await delay(1000);
+        }
+    }
+    onProgress(`Stopped. Generated ${count} boards.`);
+    return count;
+}
+/**
+ * Process boards without techniques one by one until none are left, aborted,
+ * or a critical error (save failure, mismatch, invalid pencilmarks).
+ * Returns the number of boards saved.
+ */
+export async function runTechniqueExtraction(ctx, options) {
+    const { api, token, abort, onProgress, onError } = ctx;
+    let extracted = 0;
+    let processed = 0;
+    /** Save; false = stop. */
+    const save = async (board, techniques, level) => {
+        const finalLevel = levelToSave(level);
+        onProgress(`Saving board ${shortUuid(board.uuid)} - ` +
+            `techniques: ${formatTechniqueMaskHex(techniques)}, level: ${finalLevel}...`);
+        const ok = await updateBoardTechniques(api, token.current, board.uuid, techniques, finalLevel);
+        if (!ok) {
+            onProgress(`Failed to save board ${shortUuid(board.uuid)}. Stopping.`);
+            return false;
+        }
+        extracted++;
+        options.onBoardExtracted?.();
+        onProgress(`Extracted ${extracted} boards. Finding next...`);
+        return true;
+    };
+    const validate = (board) => api.validate(token.current, { original: board.board });
+    const processSimple = async (board) => {
+        const id = shortUuid(board.uuid);
+        onProgress(`Validating board ${id}...`);
+        try {
+            const response = await validate(board);
+            if (!response.success || !response.data?.board) {
+                onProgress(`Validate failed for ${id}, skipping...`);
+                return true;
+            }
+            const solverBoard = response.data.board;
+            return await save(board, techniqueBitmaskOf(solverBoard), solverBoard.level);
+        }
+        catch (err) {
+            onProgress(`Validate error for ${id}: ${errorMessage(err)}`);
+            return true;
+        }
+    };
+    const compareAndSave = async (board, frontend) => {
+        const id = shortUuid(board.uuid);
+        if (frontend.techniques === 0n && frontend.level === 0) {
+            onProgress(`Skipped board ${id} (no techniques found). Finding next...`);
+            return true;
+        }
+        onProgress(`Validating board ${id}...`);
+        try {
+            const response = await validate(board);
+            if (!response.success || !response.data?.board) {
+                onProgress(`Validate failed for ${id}, skipping...`);
+                return true;
+            }
+            const solver = response.data.board;
+            const mismatch = compareExtractionWithSolver(board.uuid, frontend, solver);
+            if (mismatch) {
+                console.log('[TechniqueExtractor] MISMATCH DETECTED');
+                console.log('[TechniqueExtractor] Board UUID:', board.uuid);
+                console.log('[TechniqueExtractor] Board puzzle:', board.board);
+                console.log('[TechniqueExtractor] Frontend result:', {
+                    ...describeTechniqueMask(frontend.techniques),
+                    level: frontend.level,
+                });
+                console.log('[TechniqueExtractor] Solver (/validate) result:', {
+                    ...describeTechniqueMask(mismatch.solverTechniques),
+                    level: mismatch.solverLevel,
+                });
+                onError(new Error(mismatch.message));
+                return false; // Investigate the discrepancy.
+            }
+            return await save(board, frontend.techniques, frontend.level);
+        }
+        catch (err) {
+            onProgress(`Validate error for ${id}: ${errorMessage(err)}`);
+            return true;
+        }
+    };
+    const processWithTest = async (board) => {
+        onProgress(`Processing board ${shortUuid(board.uuid)}...`);
+        const result = await extractBoardTechniques(opts => api.solve(token.current, opts), board.board);
+        if (isExtractionError(result)) {
+            onError(new Error(`Board ${shortUuid(board.uuid)}: ${result.error}`));
+            // Invalid pencilmarks means a technique bug: stop and investigate.
+            return !result.error.includes('Invalid pencilmarks');
+        }
+        if (isTechniqueFound(result))
+            return true; // Not possible without a filter.
+        return compareAndSave(board, result);
+    };
+    const processBoard = options.testWithFrontend
+        ? processWithTest
+        : processSimple;
+    while (!abort.shouldAbort()) {
+        if (shouldRefreshToken(processed))
+            await token.refresh();
+        const board = await fetchBoardWithoutTechniques(api, token.current);
+        if (!board) {
+            onProgress(`Done! Extracted techniques for ${extracted} boards. No more boards.`);
+            break;
+        }
+        if (!(await processBoard(board)))
+            break;
+        processed++;
+    }
+    if (!abort.shouldAbort()) {
+        onProgress(`Done! Extracted techniques for ${extracted} boards.`);
+    }
+    return extracted;
+}
+/**
+ * Create technique examples (each with a linked practice). A board fetched by
+ * technique bit that turns out not to contain the technique is reset to
+ * techniques 0 so the extractor re-processes it. Any failed save stops the
+ * job (aborts). Returns the final per-technique counts.
+ */
+export async function runExampleCreation(ctx, request, callbacks = {}) {
+    const { api, token, abort, onProgress, onError } = ctx;
+    const target = request.targetPerTechnique ?? ADMIN_EXAMPLE_TARGET_PER_TECHNIQUE;
+    const counts = { ...request.currentCounts };
+    let boardsProcessed = 0;
+    onProgress('Fetching techniques...');
+    let levelMap = new Map();
+    try {
+        const response = await api.getTechniques();
+        if (response.success)
+            levelMap = buildTechniqueLevelMap(response.data);
+    }
+    catch (err) {
+        console.error('Failed to fetch techniques:', err);
+    }
+    const levelOf = (id) => levelMap.get(id) ?? null;
+    const reached = (id) => hasReachedTarget(counts, id, target);
+    /** Save example + practice; false = stop. */
+    const saveFound = async (board, found) => {
+        const name = techniqueName(found.techniqueId);
+        onProgress(`Saving ${name} example...`);
+        const requests = buildExampleSaveRequests(board, found);
+        try {
+            const example = await api.createExample(token.current, requests.example);
+            if (!example.success || !example.data) {
+                onProgress(`Failed to save example: ${example.error || 'Unknown error'}. Stopping.`);
+                return false;
+            }
+            onProgress(`Saving ${name} practice...`);
+            const practice = await api.createPractice(token.current, {
+                ...requests.practice,
+                source_example_uuid: example.data.uuid,
+            });
+            if (!practice.success) {
+                onProgress(`Failed to save practice: ${practice.error || 'Unknown error'}. Stopping.`);
+                return false;
+            }
+        }
+        catch (err) {
+            onProgress(`Error saving example/practice: ${errorMessage(err)}. Stopping.`);
+            return false;
+        }
+        const newCount = countForTechnique(counts, found.techniqueId) + 1;
+        counts[found.techniqueId] = newCount;
+        callbacks.onExampleSaved?.(found.techniqueId, newCount);
+        onProgress(`Saved ${name} (${newCount}/${target})`);
+        return true;
+    };
+    const extract = async (board, techniqueId) => {
+        boardsProcessed++;
+        if (boardsProcessed % ADMIN_TOKEN_REFRESH_INTERVAL === 0) {
+            await token.refresh();
+        }
+        return extractBoardTechniques(opts => api.solve(token.current, opts), board.board, techniqueId);
+    };
+    /** Board found by bit; resets the board when the technique is absent. */
+    const processBitBoard = async (board, techniqueId) => {
+        const result = await extract(board, techniqueId);
+        if (isTechniqueFound(result))
+            return saveFound(board, result);
+        if (isExtractionError(result)) {
+            onError(new Error(`Board ${shortUuid(board.uuid)}: ${result.error}`));
+            return true;
+        }
+        if (abort.shouldAbort())
+            return true;
+        onProgress(`Technique ${techniqueName(techniqueId)} not found in board ${shortUuid(board.uuid)}, resetting techniques...`);
+        const ok = await updateBoardTechniques(api, token.current, board.uuid, 0n, null);
+        if (!ok) {
+            onProgress(`Failed to reset board ${shortUuid(board.uuid)}. Stopping.`);
+            return false;
+        }
+        callbacks.onBoardTechniquesReset?.(board.uuid);
+        return true;
+    };
+    /** Board found by level; nothing to reset when the technique is absent. */
+    const processLevelBoard = async (board, techniqueId) => {
+        const result = await extract(board, techniqueId);
+        return isTechniqueFound(result) ? saveFound(board, result) : true;
+    };
+    const searchByLevel = async (techniqueId) => {
+        const name = techniqueName(techniqueId);
+        const techniqueLevel = levelOf(techniqueId);
+        if (techniqueLevel === null) {
+            onProgress(`No level for ${name}, skipping...`);
+            return;
+        }
+        for (const level of levelsToSearchForTechnique(techniqueLevel)) {
+            if (abort.shouldAbort() || reached(techniqueId))
+                break;
+            onProgress(`Fetching level ${level} boards for ${name}...`);
+            try {
+                const response = await api.getBoards(token.current, boardsAtLevelQuery(level, BOARDS_PER_LEVEL_LIMIT));
+                const boards = response.success ? (response.data ?? []) : [];
+                if (boards.length === 0)
+                    continue;
+                onProgress(`Found ${boards.length} level ${level} boards, searching for ${name}...`);
+                for (const board of boards) {
+                    if (abort.shouldAbort() || reached(techniqueId))
+                        break;
+                    if (!(await processLevelBoard(board, techniqueId))) {
+                        abort.abort();
+                        return;
+                    }
+                }
+            }
+            catch (err) {
+                console.error(`Failed to fetch level ${level} boards:`, err);
+            }
+        }
+    };
+    const searchByBit = async (techniqueId) => {
+        const name = techniqueName(techniqueId);
+        onProgress(`Fetching boards for ${name} (level ${levelOf(techniqueId) ?? 'any'})...`);
+        const boards = await fetchBoardsWithTechnique(api, token.current, techniqueId, BOARDS_WITH_TECHNIQUE_LIMIT);
+        if (boards.length === 0) {
+            onProgress(`No boards with ${name} bit set, searching by level...`);
+            await searchByLevel(techniqueId);
+            return;
+        }
+        for (const board of boards) {
+            if (abort.shouldAbort() || reached(techniqueId))
+                break;
+            if (!(await processBitBoard(board, techniqueId))) {
+                abort.abort();
+                return;
+            }
+        }
+    };
+    if (request.mode === 'all') {
+        for (const id of request.techniqueOrder ?? ADMIN_TECHNIQUE_ORDER) {
+            if (abort.shouldAbort())
+                break;
+            if (reached(id))
+                continue;
+            await searchByBit(id);
+        }
+    }
+    else if (!abort.shouldAbort()) {
+        if (request.mode === 'bit') {
+            await searchByBit(request.techniqueId);
+        }
+        else {
+            onProgress(`Searching by level for ${techniqueName(request.techniqueId)} (level ${levelOf(request.techniqueId) ?? 'any'})...`);
+            await searchByLevel(request.techniqueId);
+        }
+    }
+    if (!abort.shouldAbort())
+        onProgress('Done!');
+    return counts;
+}
+//# sourceMappingURL=jobs.js.map

package/dist/admin/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/admin/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,oBAAoB,EACpB,kBAAkB,GAEnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACtB,WAAW,EACX,SAAS,GACV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kCAAkC,EAClC,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,0BAA0B,GAE3B,MAAM,YAAY,CAAC;AACpB,OAAO,EAGL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,GAEjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAoB,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAazE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAAsC,EACtC,UAAqC;IAErC,MAAM,OAAO,GAAG,MAAM,QAAQ,EAAE,CAAC;IACjC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,OAAO,GAAG,OAAO,CAAC;IACtB,OAAO;QACL,IAAI,OAAO;YACT,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,OAAO;YACX,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,QAAQ,EAAE,CAAC;gBAC9B,IAAI,IAAI,EAAE,CAAC;oBACT,OAAO,GAAG,IAAI,CAAC;oBACf,UAAU,CAAC,gCAAgC,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,2CAA2C;gBAC3C,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB,CAChC,SAAiB,EACjB,WAAmB,4BAA4B;IAE/C,OAAO,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,QAAQ,KAAK,CAAC,CAAC;AACrD,CAAC;AAaD,MAAM,YAAY,GAAG,CAAC,EAAU,EAAE,EAAE,CAClC,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAExD,MAAM,aAAa,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;AAE/D,+EAA+E;AAC/E,iDAAiD;AACjD,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAa,EACb,KAAa,EACb,SAAiB,EACjB,UAAkB,EAClB,KAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,WAAW,CACpC,KAAK,EACL,SAAS,EACT,0BAA0B,CAAC,UAAU,EAAE,KAAK,CAAC,CAC9C,CAAC;QACF,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,GAAa,EACb,KAAa,EACb,WAAwB,EACxB,KAAa;IAEb,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,SAAS,CAClC,KAAK,EACL,wBAAwB,CAAC,WAAW,EAAE,KAAK,CAAC,CAC7C,CAAC;QACF,OAAO,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,GAAa,EACb,KAAa;IAEb,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,4BAA4B,EAAE,CAAC,CAAC;QAC5E,OAAO,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAYD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAoB,EACpB,OAA+B;IAE/B,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;IACvD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,YAAY,CAAC;IAExC,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;YAC7C,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACtC,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,UAAU,CAAC,wBAAwB,CAAC,CAAC;IACrC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5B,IAAI,kBAAkB,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QAErD,IAAI,CAAC;YACH,UAAU,CAAC,oBAAoB,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE;gBAClD,WAAW,EAAE,OAAO,CAAC,WAAW;aACjC,CAAC,CAAC;YACH,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;gBAC1C,UAAU,CACR,2BAA2B,SAAS,CAAC,KAAK,IAAI,eAAe,EAAE,CAChE,CAAC;gBACF,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClB,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,UAAU,CACR,MAAM,CAAC,MAAM,KAAK,SAAS;oBACzB,CAAC,CAAC,+CAA+C;oBACjD,CAAC,CAAC,wCAAwC,CAC7C,CAAC;gBACF,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClB,SAAS;YACX,CAAC;YAED,UAAU,CAAC,oBAAoB,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE;gBAClD,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YACH,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;gBAC1C,UAAU,CACR,2BAA2B,SAAS,CAAC,KAAK,IAAI,eAAe,EAAE,CAChE,CAAC;gBACF,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClB,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GAAG,mBAAmB,CAC/B,MAAM,EACN,SAAS,CAAC,IAAI,EACd,OAAO,CAAC,WAAW,CACpB,CAAC;YAEF,UAAU,CAAC,gBAAgB,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACpE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBACrB,UAAU,CACR,uBAAuB,OAAO,CAAC,KAAK,IAAI,eAAe,aAAa,CACrE,CAAC;gBACF,MAAM;YACR,CAAC;YAED,KAAK,EAAE,CAAC;YACR,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YACjE,UAAU,CACR,aAAa,KAAK,kBAAkB,KAAK,CAAC,KAAK,iBAAiB,sBAAsB,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAC5G,CAAC;YACF,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAU,CACR,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CACjE,CAAC;YACF,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,UAAU,CAAC,sBAAsB,KAAK,UAAU,CAAC,CAAC;IAClD,OAAO,KAAK,CAAC;AACf,CAAC;AAiBD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAoB,EACpB,OAAmC;IAEnC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;IACvD,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,0BAA0B;IAC1B,MAAM,IAAI,GAAG,KAAK,EAChB,KAAY,EACZ,UAAkB,EAClB,KAAa,EACK,EAAE;QACpB,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACtC,UAAU,CACR,gBAAgB,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK;YACxC,eAAe,sBAAsB,CAAC,UAAU,CAAC,YAAY,UAAU,KAAK,CAC/E,CAAC;QACF,MAAM,EAAE,GAAG,MAAM,qBAAqB,CACpC,GAAG,EACH,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,IAAI,EACV,UAAU,EACV,UAAU,CACX,CAAC;QACF,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,wBAAwB,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACvE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC7B,UAAU,CAAC,aAAa,SAAS,0BAA0B,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,KAAY,EAAE,EAAE,CAChC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAEzD,MAAM,aAAa,GAAG,KAAK,EAAE,KAAY,EAAoB,EAAE;QAC7D,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,UAAU,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;gBAC/C,UAAU,CAAC,uBAAuB,EAAE,eAAe,CAAC,CAAC;gBACrD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;YACxC,OAAO,MAAM,IAAI,CACf,KAAK,EACL,kBAAkB,CAAC,WAAW,CAAC,EAC/B,WAAW,CAAC,KAAK,CAClB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAU,CAAC,sBAAsB,EAAE,KAAK,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,cAAc,GAAG,KAAK,EAC1B,KAAY,EACZ,QAA+B,EACb,EAAE;QACpB,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,QAAQ,CAAC,UAAU,KAAK,EAAE,IAAI,QAAQ,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YACvD,UAAU,CAAC,iBAAiB,EAAE,yCAAyC,CAAC,CAAC;YACzE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,UAAU,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;gBAC/C,UAAU,CAAC,uBAAuB,EAAE,eAAe,CAAC,CAAC;gBACrD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;YACnC,MAAM,QAAQ,GAAG,2BAA2B,CAC1C,KAAK,CAAC,IAAI,EACV,QAAQ,EACR,MAAM,CACP,CAAC;YACF,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;gBACtD,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5D,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC/D,OAAO,CAAC,GAAG,CAAC,uCAAuC,EAAE;oBACnD,GAAG,qBAAqB,CAAC,QAAQ,CAAC,UAAU,CAAC;oBAC7C,KAAK,EAAE,QAAQ,CAAC,KAAK;iBACtB,CAAC,CAAC;gBACH,OAAO,CAAC,GAAG,CAAC,iDAAiD,EAAE;oBAC7D,GAAG,qBAAqB,CAAC,QAAQ,CAAC,gBAAgB,CAAC;oBACnD,KAAK,EAAE,QAAQ,CAAC,WAAW;iBAC5B,CAAC,CAAC;gBACH,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;gBACrC,OAAO,KAAK,CAAC,CAAC,+BAA+B;YAC/C,CAAC;YACD,OAAO,MAAM,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAU,CAAC,sBAAsB,EAAE,KAAK,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,KAAK,EAAE,KAAY,EAAoB,EAAE;QAC/D,UAAU,CAAC,oBAAoB,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,EACtC,KAAK,CAAC,KAAK,CACZ,CAAC;QACF,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,KAAK,CAAC,SAAS,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACtE,mEAAmE;YACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,gBAAgB,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,iCAAiC;QAC5E,OAAO,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,OAAO,CAAC,gBAAgB;QAC3C,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,aAAa,CAAC;IAElB,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5B,IAAI,kBAAkB,CAAC,SAAS,CAAC;YAAE,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QAEzD,MAAM,KAAK,GAAG,MAAM,2BAA2B,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,UAAU,CACR,kCAAkC,SAAS,0BAA0B,CACtE,CAAC;YACF,MAAM;QACR,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;YAAE,MAAM;QACxC,SAAS,EAAE,CAAC;IACd,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACzB,UAAU,CAAC,kCAAkC,SAAS,UAAU,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAiCD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAoB,EACpB,OAA+B,EAC/B,YAAsC,EAAE;IAExC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;IACvD,MAAM,MAAM,GACV,OAAO,CAAC,kBAAkB,IAAI,kCAAkC,CAAC;IACnE,MAAM,MAAM,GAA2B,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IACpE,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,UAAU,CAAC,wBAAwB,CAAC,CAAC;IACrC,IAAI,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC;QAC3C,IAAI,QAAQ,CAAC,OAAO;YAAE,QAAQ,GAAG,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,EAAe,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;IAC9D,MAAM,OAAO,GAAG,CAAC,EAAe,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IAE1E,6CAA6C;IAC7C,MAAM,SAAS,GAAG,KAAK,EACrB,KAAY,EACZ,KAA4B,EACV,EAAE;QACpB,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC9C,UAAU,CAAC,UAAU,IAAI,aAAa,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;YACzE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACtC,UAAU,CACR,2BAA2B,OAAO,CAAC,KAAK,IAAI,eAAe,aAAa,CACzE,CAAC;gBACF,OAAO,KAAK,CAAC;YACf,CAAC;YACD,UAAU,CAAC,UAAU,IAAI,cAAc,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE;gBACvD,GAAG,QAAQ,CAAC,QAAQ;gBACpB,mBAAmB,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI;aACvC,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,UAAU,CACR,4BAA4B,QAAQ,CAAC,KAAK,IAAI,eAAe,aAAa,CAC3E,CAAC;gBACF,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAU,CACR,kCAAkC,YAAY,CAAC,GAAG,CAAC,aAAa,CACjE,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAClE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC;QACrC,SAAS,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACxD,UAAU,CAAC,SAAS,IAAI,KAAK,QAAQ,IAAI,MAAM,GAAG,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,EACnB,KAAY,EACZ,WAAwB,EACS,EAAE;QACnC,eAAe,EAAE,CAAC;QAClB,IAAI,eAAe,GAAG,4BAA4B,KAAK,CAAC,EAAE,CAAC;YACzD,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC;QACD,OAAO,sBAAsB,CAC3B,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,EACtC,KAAK,CAAC,KAAK,EACX,WAAW,CACZ,CAAC;IACJ,CAAC,CAAC;IAEF,yEAAyE;IACzE,MAAM,eAAe,GAAG,KAAK,EAC3B,KAAY,EACZ,WAAwB,EACN,EAAE;QACpB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QACjD,IAAI,gBAAgB,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC9D,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,KAAK,CAAC,SAAS,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACtE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,OAAO,IAAI,CAAC;QAErC,UAAU,CACR,aAAa,aAAa,CAAC,WAAW,CAAC,uBAAuB,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAC/G,CAAC;QACF,MAAM,EAAE,GAAG,MAAM,qBAAqB,CACpC,GAAG,EACH,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,IAAI,EACV,EAAE,EACF,IAAI,CACL,CAAC;QACF,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,yBAAyB,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACxE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,SAAS,CAAC,sBAAsB,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,2EAA2E;IAC3E,MAAM,iBAAiB,GAAG,KAAK,EAC7B,KAAY,EACZ,WAAwB,EACN,EAAE;QACpB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QACjD,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,KAAK,EAAE,WAAwB,EAAiB,EAAE;QACtE,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QACxC,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QAC5C,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;YAC5B,UAAU,CAAC,gBAAgB,IAAI,eAAe,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,0BAA0B,CAAC,cAAc,CAAC,EAAE,CAAC;YAC/D,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,WAAW,CAAC;gBAAE,MAAM;YACvD,UAAU,CAAC,kBAAkB,KAAK,eAAe,IAAI,KAAK,CAAC,CAAC;YAC5D,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,SAAS,CAClC,KAAK,CAAC,OAAO,EACb,kBAAkB,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAClD,CAAC;gBACF,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;oBAAE,SAAS;gBAElC,UAAU,CACR,SAAS,MAAM,CAAC,MAAM,UAAU,KAAK,0BAA0B,IAAI,KAAK,CACzE,CAAC;gBACF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;oBAC3B,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,WAAW,CAAC;wBAAE,MAAM;oBACvD,IAAI,CAAC,CAAC,MAAM,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;wBACnD,KAAK,CAAC,KAAK,EAAE,CAAC;wBACd,OAAO;oBACT,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,yBAAyB,KAAK,UAAU,EAAE,GAAG,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,EAAE,WAAwB,EAAiB,EAAE;QACpE,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QACxC,UAAU,CACR,uBAAuB,IAAI,WAAW,OAAO,CAAC,WAAW,CAAC,IAAI,KAAK,MAAM,CAC1E,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAC3C,GAAG,EACH,KAAK,CAAC,OAAO,EACb,WAAW,EACX,2BAA2B,CAC5B,CAAC;QACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,UAAU,CAAC,kBAAkB,IAAI,iCAAiC,CAAC,CAAC;YACpE,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,WAAW,CAAC;gBAAE,MAAM;YACvD,IAAI,CAAC,CAAC,MAAM,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;gBACjD,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC3B,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,cAAc,IAAI,qBAAqB,EAAE,CAAC;YACjE,IAAI,KAAK,CAAC,WAAW,EAAE;gBAAE,MAAM;YAC/B,IAAI,OAAO,CAAC,EAAE,CAAC;gBAAE,SAAS;YAC1B,MAAM,WAAW,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;SAAM,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC3B,MAAM,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,UAAU,CACR,0BAA0B,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,KAAK,MAAM,CACnH,CAAC;YACF,MAAM,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;QAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["/**\n * Admin batch jobs as framework-agnostic async functions over an\n * {@link AdminApi}. The hooks in this folder wrap them with React state; the\n * functions themselves hold the business rules (token refresh cadence, retry\n * delays, stop conditions, technique → level search fallback).\n *\n * Ported from `sudojo_app/src/utils/admin/{BoardGenerator,TechniqueExtractor,\n * ExampleCreator,boardTechniquesApi}.ts`; progress messages are unchanged.\n */\n\nimport {\n  type Board,\n  getTechniqueNameById,\n  techniqueBitmaskOf,\n  type TechniqueId,\n} from '@sudobility/sudojo_types';\nimport type { AdminApi } from './adminApi';\nimport {\n  boardsAtLevelQuery,\n  boardsWithoutTechniquesQuery,\n  boardsWithTechniqueQuery,\n  buildBoardTechniquesUpdate,\n  buildValidatedBoard,\n  compareExtractionWithSolver,\n  parseGeneratedBoard,\n} from './boardRules';\nimport {\n  describeTechniqueMask,\n  errorMessage,\n  formatTechniqueMaskHex,\n  levelToSave,\n  shortUuid,\n} from './boardStrings';\nimport {\n  ADMIN_EXAMPLE_TARGET_PER_TECHNIQUE,\n  ADMIN_TECHNIQUE_ORDER,\n  BOARDS_PER_LEVEL_LIMIT,\n  BOARDS_WITH_TECHNIQUE_LIMIT,\n  buildExampleSaveRequests,\n  buildTechniqueLevelMap,\n  countForTechnique,\n  hasReachedTarget,\n  levelsToSearchForTechnique,\n  type TechniqueCounts,\n} from './examples';\nimport {\n  type BoardExtractionOutcome,\n  type BoardExtractionResult,\n  extractBoardTechniques,\n  isExtractionError,\n  isTechniqueFound,\n  type TechniqueExampleFound,\n} from './extraction';\nimport { type AbortHandle, ADMIN_TOKEN_REFRESH_INTERVAL } from './types';\n\n// ============================================================================\n// Shared plumbing\n// ============================================================================\n\n/** Current admin token, refreshable mid-job. */\nexport interface AdminTokenManager {\n  readonly current: string;\n  /** Ask `getToken` again; keeps the old token if it fails or returns null. */\n  refresh(): Promise<void>;\n}\n\n/**\n * Get the starting token. Returns null when `getToken` yields none (the job\n * should report \"Not authenticated\"). Refreshes log \"Token refreshed,\n * continuing...\" through `onProgress`; refresh failures only warn.\n */\nexport async function createAdminTokenManager(\n  getToken: () => Promise<string | null>,\n  onProgress: (message: string) => void\n): Promise<AdminTokenManager | null> {\n  const initial = await getToken();\n  if (!initial) return null;\n  let current = initial;\n  return {\n    get current() {\n      return current;\n    },\n    async refresh() {\n      try {\n        const next = await getToken();\n        if (next) {\n          current = next;\n          onProgress('Token refreshed, continuing...');\n        }\n      } catch (err) {\n        // The existing token might still be valid.\n        console.warn('[admin] Token refresh failed:', err);\n      }\n    },\n  };\n}\n\n/** True when the job should refresh its token before item `processed + 1`. */\nexport function shouldRefreshToken(\n  processed: number,\n  interval: number = ADMIN_TOKEN_REFRESH_INTERVAL\n): boolean {\n  return processed > 0 && processed % interval === 0;\n}\n\n/** What every job needs. */\nexport interface AdminJobContext {\n  api: AdminApi;\n  token: AdminTokenManager;\n  abort: AbortHandle;\n  onProgress: (message: string) => void;\n  onError: (error: Error) => void;\n  /** Wait between retries (default: setTimeout). Injectable for tests. */\n  delay?: (ms: number) => Promise<void>;\n}\n\nconst defaultDelay = (ms: number) =>\n  new Promise<void>(resolve => setTimeout(resolve, ms));\n\nconst techniqueName = (id: number) => getTechniqueNameById(id);\n\n// ============================================================================\n// Board API helpers (were boardTechniquesApi.ts)\n// ============================================================================\n\n/**\n * Set a board's techniques bitmask (sent as an exact string) and level.\n * Returns false on any failure.\n */\nexport async function updateBoardTechniques(\n  api: AdminApi,\n  token: string,\n  boardUuid: string,\n  techniques: bigint,\n  level: number | null\n): Promise<boolean> {\n  try {\n    const response = await api.updateBoard(\n      token,\n      boardUuid,\n      buildBoardTechniquesUpdate(techniques, level)\n    );\n    return response.success;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Boards with the technique's bit set (API `technique_bit` filter), any\n * level. Returns [] on any failure.\n */\nexport async function fetchBoardsWithTechnique(\n  api: AdminApi,\n  token: string,\n  techniqueId: TechniqueId,\n  limit: number\n): Promise<Board[]> {\n  try {\n    const response = await api.getBoards(\n      token,\n      boardsWithTechniqueQuery(techniqueId, limit)\n    );\n    return response.success && response.data ? response.data : [];\n  } catch {\n    return [];\n  }\n}\n\n/** The next board whose techniques were never extracted, or null. */\nexport async function fetchBoardWithoutTechniques(\n  api: AdminApi,\n  token: string\n): Promise<Board | null> {\n  try {\n    const response = await api.getBoards(token, boardsWithoutTechniquesQuery());\n    return (response.success && response.data?.[0]) || null;\n  } catch {\n    return null;\n  }\n}\n\n// ============================================================================\n// Board generation (was BoardGenerator.ts)\n// ============================================================================\n\nexport interface BoardGenerationOptions {\n  symmetrical: boolean;\n  /** After each saved board. `techniques` is the exact bitmask. */\n  onBoardGenerated?: (count: number, level: number, techniques: bigint) => void;\n}\n\n/**\n * Generate, validate and save boards until aborted or a save fails.\n * Each board: /generate → /validate (source of truth for level, techniques,\n * solution) → create. Generate/validate failures wait 1 s and retry.\n * Returns the number of boards saved.\n */\nexport async function runBoardGeneration(\n  ctx: AdminJobContext,\n  options: BoardGenerationOptions\n): Promise<number> {\n  const { api, token, abort, onProgress, onError } = ctx;\n  const delay = ctx.delay ?? defaultDelay;\n\n  onProgress('Fetching levels...');\n  try {\n    const levels = await api.getLevels();\n    if (!levels.success || !levels.data) {\n      onError(new Error('Failed to fetch levels'));\n      return 0;\n    }\n    if (levels.data.length === 0) {\n      onError(new Error('No levels found'));\n      return 0;\n    }\n  } catch (err) {\n    onError(err instanceof Error ? err : new Error(String(err)));\n    return 0;\n  }\n\n  onProgress('Starting generation...');\n  let count = 0;\n\n  while (!abort.shouldAbort()) {\n    if (shouldRefreshToken(count)) await token.refresh();\n\n    try {\n      onProgress(`Generating board ${count + 1}...`);\n      const generated = await api.generate(token.current, {\n        symmetrical: options.symmetrical,\n      });\n      if (!generated.success || !generated.data) {\n        onProgress(\n          `Error generating board: ${generated.error || 'Unknown error'}`\n        );\n        await delay(1000);\n        continue;\n      }\n\n      const puzzle = parseGeneratedBoard(generated.data);\n      if (!puzzle.ok) {\n        onProgress(\n          puzzle.reason === 'invalid'\n            ? 'Error: Invalid response structure from solver'\n            : 'Error: Missing puzzle data from solver'\n        );\n        await delay(1000);\n        continue;\n      }\n\n      onProgress(`Validating board ${count + 1}...`);\n      const validated = await api.validate(token.current, {\n        original: puzzle.original,\n      });\n      if (!validated.success || !validated.data) {\n        onProgress(\n          `Error validating board: ${validated.error || 'Unknown error'}`\n        );\n        await delay(1000);\n        continue;\n      }\n\n      const board = buildValidatedBoard(\n        puzzle,\n        validated.data,\n        options.symmetrical\n      );\n\n      onProgress(`Saving board ${count + 1}...`);\n      const created = await api.createBoard(token.current, board.request);\n      if (!created.success) {\n        onProgress(\n          `Error saving board: ${created.error || 'Unknown error'}. Stopping.`\n        );\n        break;\n      }\n\n      count++;\n      options.onBoardGenerated?.(count, board.level, board.techniques);\n      onProgress(\n        `Generated ${count} boards (level ${board.level}, techniques: ${formatTechniqueMaskHex(board.techniques)})`\n      );\n      await delay(100);\n    } catch (err) {\n      onProgress(\n        `Error: ${err instanceof Error ? err.message : 'Unknown error'}`\n      );\n      await delay(1000);\n    }\n  }\n\n  onProgress(`Stopped. Generated ${count} boards.`);\n  return count;\n}\n\n// ============================================================================\n// Technique extraction (was TechniqueExtractor.ts)\n// ============================================================================\n\nexport interface TechniqueExtractionOptions {\n  /**\n   * false: trust /validate and save its techniques (fast).\n   * true: walk the board with /solve, compare with /validate, stop on any\n   * mismatch, and save only matching results.\n   */\n  testWithFrontend: boolean;\n  /** After each saved board. */\n  onBoardExtracted?: () => void;\n}\n\n/**\n * Process boards without techniques one by one until none are left, aborted,\n * or a critical error (save failure, mismatch, invalid pencilmarks).\n * Returns the number of boards saved.\n */\nexport async function runTechniqueExtraction(\n  ctx: AdminJobContext,\n  options: TechniqueExtractionOptions\n): Promise<number> {\n  const { api, token, abort, onProgress, onError } = ctx;\n  let extracted = 0;\n  let processed = 0;\n\n  /** Save; false = stop. */\n  const save = async (\n    board: Board,\n    techniques: bigint,\n    level: number\n  ): Promise<boolean> => {\n    const finalLevel = levelToSave(level);\n    onProgress(\n      `Saving board ${shortUuid(board.uuid)} - ` +\n        `techniques: ${formatTechniqueMaskHex(techniques)}, level: ${finalLevel}...`\n    );\n    const ok = await updateBoardTechniques(\n      api,\n      token.current,\n      board.uuid,\n      techniques,\n      finalLevel\n    );\n    if (!ok) {\n      onProgress(`Failed to save board ${shortUuid(board.uuid)}. Stopping.`);\n      return false;\n    }\n    extracted++;\n    options.onBoardExtracted?.();\n    onProgress(`Extracted ${extracted} boards. Finding next...`);\n    return true;\n  };\n\n  const validate = (board: Board) =>\n    api.validate(token.current, { original: board.board });\n\n  const processSimple = async (board: Board): Promise<boolean> => {\n    const id = shortUuid(board.uuid);\n    onProgress(`Validating board ${id}...`);\n    try {\n      const response = await validate(board);\n      if (!response.success || !response.data?.board) {\n        onProgress(`Validate failed for ${id}, skipping...`);\n        return true;\n      }\n      const solverBoard = response.data.board;\n      return await save(\n        board,\n        techniqueBitmaskOf(solverBoard),\n        solverBoard.level\n      );\n    } catch (err) {\n      onProgress(`Validate error for ${id}: ${errorMessage(err)}`);\n      return true;\n    }\n  };\n\n  const compareAndSave = async (\n    board: Board,\n    frontend: BoardExtractionResult\n  ): Promise<boolean> => {\n    const id = shortUuid(board.uuid);\n    if (frontend.techniques === 0n && frontend.level === 0) {\n      onProgress(`Skipped board ${id} (no techniques found). Finding next...`);\n      return true;\n    }\n\n    onProgress(`Validating board ${id}...`);\n    try {\n      const response = await validate(board);\n      if (!response.success || !response.data?.board) {\n        onProgress(`Validate failed for ${id}, skipping...`);\n        return true;\n      }\n      const solver = response.data.board;\n      const mismatch = compareExtractionWithSolver(\n        board.uuid,\n        frontend,\n        solver\n      );\n      if (mismatch) {\n        console.log('[TechniqueExtractor] MISMATCH DETECTED');\n        console.log('[TechniqueExtractor] Board UUID:', board.uuid);\n        console.log('[TechniqueExtractor] Board puzzle:', board.board);\n        console.log('[TechniqueExtractor] Frontend result:', {\n          ...describeTechniqueMask(frontend.techniques),\n          level: frontend.level,\n        });\n        console.log('[TechniqueExtractor] Solver (/validate) result:', {\n          ...describeTechniqueMask(mismatch.solverTechniques),\n          level: mismatch.solverLevel,\n        });\n        onError(new Error(mismatch.message));\n        return false; // Investigate the discrepancy.\n      }\n      return await save(board, frontend.techniques, frontend.level);\n    } catch (err) {\n      onProgress(`Validate error for ${id}: ${errorMessage(err)}`);\n      return true;\n    }\n  };\n\n  const processWithTest = async (board: Board): Promise<boolean> => {\n    onProgress(`Processing board ${shortUuid(board.uuid)}...`);\n    const result = await extractBoardTechniques(\n      opts => api.solve(token.current, opts),\n      board.board\n    );\n    if (isExtractionError(result)) {\n      onError(new Error(`Board ${shortUuid(board.uuid)}: ${result.error}`));\n      // Invalid pencilmarks means a technique bug: stop and investigate.\n      return !result.error.includes('Invalid pencilmarks');\n    }\n    if (isTechniqueFound(result)) return true; // Not possible without a filter.\n    return compareAndSave(board, result);\n  };\n\n  const processBoard = options.testWithFrontend\n    ? processWithTest\n    : processSimple;\n\n  while (!abort.shouldAbort()) {\n    if (shouldRefreshToken(processed)) await token.refresh();\n\n    const board = await fetchBoardWithoutTechniques(api, token.current);\n    if (!board) {\n      onProgress(\n        `Done! Extracted techniques for ${extracted} boards. No more boards.`\n      );\n      break;\n    }\n    if (!(await processBoard(board))) break;\n    processed++;\n  }\n\n  if (!abort.shouldAbort()) {\n    onProgress(`Done! Extracted techniques for ${extracted} boards.`);\n  }\n  return extracted;\n}\n\n// ============================================================================\n// Example creation (was ExampleCreator.ts)\n// ============================================================================\n\n/**\n * - `all`: every technique in `techniqueOrder` below target, by bit then level.\n * - `bit`: one technique; boards with its bit set, else the level search.\n * - `level`: one technique; level search only (finds techniques whose bit is\n *   missing on boards).\n */\nexport type ExampleCreationRequest =\n  | {\n      mode: 'all';\n      currentCounts: TechniqueCounts;\n      targetPerTechnique?: number;\n      techniqueOrder?: readonly TechniqueId[];\n    }\n  | {\n      mode: 'bit' | 'level';\n      techniqueId: TechniqueId;\n      currentCounts: TechniqueCounts;\n      targetPerTechnique?: number;\n    };\n\nexport interface ExampleCreationCallbacks {\n  /** After an example + practice pair is saved. */\n  onExampleSaved?: (techniqueId: TechniqueId, newCount: number) => void;\n  /** After a board whose bit lied was reset to techniques 0 / level null. */\n  onBoardTechniquesReset?: (boardUuid: string) => void;\n}\n\n/**\n * Create technique examples (each with a linked practice). A board fetched by\n * technique bit that turns out not to contain the technique is reset to\n * techniques 0 so the extractor re-processes it. Any failed save stops the\n * job (aborts). Returns the final per-technique counts.\n */\nexport async function runExampleCreation(\n  ctx: AdminJobContext,\n  request: ExampleCreationRequest,\n  callbacks: ExampleCreationCallbacks = {}\n): Promise<Record<number, number>> {\n  const { api, token, abort, onProgress, onError } = ctx;\n  const target =\n    request.targetPerTechnique ?? ADMIN_EXAMPLE_TARGET_PER_TECHNIQUE;\n  const counts: Record<number, number> = { ...request.currentCounts };\n  let boardsProcessed = 0;\n\n  onProgress('Fetching techniques...');\n  let levelMap = new Map<number, number | null>();\n  try {\n    const response = await api.getTechniques();\n    if (response.success) levelMap = buildTechniqueLevelMap(response.data);\n  } catch (err) {\n    console.error('Failed to fetch techniques:', err);\n  }\n  const levelOf = (id: TechniqueId) => levelMap.get(id) ?? null;\n  const reached = (id: TechniqueId) => hasReachedTarget(counts, id, target);\n\n  /** Save example + practice; false = stop. */\n  const saveFound = async (\n    board: Board,\n    found: TechniqueExampleFound\n  ): Promise<boolean> => {\n    const name = techniqueName(found.techniqueId);\n    onProgress(`Saving ${name} example...`);\n    const requests = buildExampleSaveRequests(board, found);\n    try {\n      const example = await api.createExample(token.current, requests.example);\n      if (!example.success || !example.data) {\n        onProgress(\n          `Failed to save example: ${example.error || 'Unknown error'}. Stopping.`\n        );\n        return false;\n      }\n      onProgress(`Saving ${name} practice...`);\n      const practice = await api.createPractice(token.current, {\n        ...requests.practice,\n        source_example_uuid: example.data.uuid,\n      });\n      if (!practice.success) {\n        onProgress(\n          `Failed to save practice: ${practice.error || 'Unknown error'}. Stopping.`\n        );\n        return false;\n      }\n    } catch (err) {\n      onProgress(\n        `Error saving example/practice: ${errorMessage(err)}. Stopping.`\n      );\n      return false;\n    }\n\n    const newCount = countForTechnique(counts, found.techniqueId) + 1;\n    counts[found.techniqueId] = newCount;\n    callbacks.onExampleSaved?.(found.techniqueId, newCount);\n    onProgress(`Saved ${name} (${newCount}/${target})`);\n    return true;\n  };\n\n  const extract = async (\n    board: Board,\n    techniqueId: TechniqueId\n  ): Promise<BoardExtractionOutcome> => {\n    boardsProcessed++;\n    if (boardsProcessed % ADMIN_TOKEN_REFRESH_INTERVAL === 0) {\n      await token.refresh();\n    }\n    return extractBoardTechniques(\n      opts => api.solve(token.current, opts),\n      board.board,\n      techniqueId\n    );\n  };\n\n  /** Board found by bit; resets the board when the technique is absent. */\n  const processBitBoard = async (\n    board: Board,\n    techniqueId: TechniqueId\n  ): Promise<boolean> => {\n    const result = await extract(board, techniqueId);\n    if (isTechniqueFound(result)) return saveFound(board, result);\n    if (isExtractionError(result)) {\n      onError(new Error(`Board ${shortUuid(board.uuid)}: ${result.error}`));\n      return true;\n    }\n    if (abort.shouldAbort()) return true;\n\n    onProgress(\n      `Technique ${techniqueName(techniqueId)} not found in board ${shortUuid(board.uuid)}, resetting techniques...`\n    );\n    const ok = await updateBoardTechniques(\n      api,\n      token.current,\n      board.uuid,\n      0n,\n      null\n    );\n    if (!ok) {\n      onProgress(`Failed to reset board ${shortUuid(board.uuid)}. Stopping.`);\n      return false;\n    }\n    callbacks.onBoardTechniquesReset?.(board.uuid);\n    return true;\n  };\n\n  /** Board found by level; nothing to reset when the technique is absent. */\n  const processLevelBoard = async (\n    board: Board,\n    techniqueId: TechniqueId\n  ): Promise<boolean> => {\n    const result = await extract(board, techniqueId);\n    return isTechniqueFound(result) ? saveFound(board, result) : true;\n  };\n\n  const searchByLevel = async (techniqueId: TechniqueId): Promise<void> => {\n    const name = techniqueName(techniqueId);\n    const techniqueLevel = levelOf(techniqueId);\n    if (techniqueLevel === null) {\n      onProgress(`No level for ${name}, skipping...`);\n      return;\n    }\n\n    for (const level of levelsToSearchForTechnique(techniqueLevel)) {\n      if (abort.shouldAbort() || reached(techniqueId)) break;\n      onProgress(`Fetching level ${level} boards for ${name}...`);\n      try {\n        const response = await api.getBoards(\n          token.current,\n          boardsAtLevelQuery(level, BOARDS_PER_LEVEL_LIMIT)\n        );\n        const boards = response.success ? (response.data ?? []) : [];\n        if (boards.length === 0) continue;\n\n        onProgress(\n          `Found ${boards.length} level ${level} boards, searching for ${name}...`\n        );\n        for (const board of boards) {\n          if (abort.shouldAbort() || reached(techniqueId)) break;\n          if (!(await processLevelBoard(board, techniqueId))) {\n            abort.abort();\n            return;\n          }\n        }\n      } catch (err) {\n        console.error(`Failed to fetch level ${level} boards:`, err);\n      }\n    }\n  };\n\n  const searchByBit = async (techniqueId: TechniqueId): Promise<void> => {\n    const name = techniqueName(techniqueId);\n    onProgress(\n      `Fetching boards for ${name} (level ${levelOf(techniqueId) ?? 'any'})...`\n    );\n    const boards = await fetchBoardsWithTechnique(\n      api,\n      token.current,\n      techniqueId,\n      BOARDS_WITH_TECHNIQUE_LIMIT\n    );\n    if (boards.length === 0) {\n      onProgress(`No boards with ${name} bit set, searching by level...`);\n      await searchByLevel(techniqueId);\n      return;\n    }\n    for (const board of boards) {\n      if (abort.shouldAbort() || reached(techniqueId)) break;\n      if (!(await processBitBoard(board, techniqueId))) {\n        abort.abort();\n        return;\n      }\n    }\n  };\n\n  if (request.mode === 'all') {\n    for (const id of request.techniqueOrder ?? ADMIN_TECHNIQUE_ORDER) {\n      if (abort.shouldAbort()) break;\n      if (reached(id)) continue;\n      await searchByBit(id);\n    }\n  } else if (!abort.shouldAbort()) {\n    if (request.mode === 'bit') {\n      await searchByBit(request.techniqueId);\n    } else {\n      onProgress(\n        `Searching by level for ${techniqueName(request.techniqueId)} (level ${levelOf(request.techniqueId) ?? 'any'})...`\n      );\n      await searchByLevel(request.techniqueId);\n    }\n  }\n\n  if (!abort.shouldAbort()) onProgress('Done!');\n  return counts;\n}\n"]}

package/dist/admin/regenerateHints.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Status line for the admin "Regenerate hints" action (web AdminPage).
+ */
+import type { BaseResponse, PracticesRegenerateHintsData } from '@sudobility/sudojo_types';
+/**
+ * Describe a regenerate-hints result, e.g.
+ * `Done: Examples: 10/12, Practices: 5/5 (15/17 total), 2 failed (examples/technique 4: 2).`
+ * Failures are grouped by table and technique.
+ */
+export declare function describeRegenerateHintsResult(data: PracticesRegenerateHintsData): string;
+/**
+ * Describe a regenerate-hints response: the result line on success,
+ * otherwise `Error: Failed to regenerate hints`.
+ */
+export declare function describeRegenerateHintsResponse(response: BaseResponse<PracticesRegenerateHintsData>): string;
+//# sourceMappingURL=regenerateHints.d.ts.map

package/dist/admin/regenerateHints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regenerateHints.d.ts","sourceRoot":"","sources":["../../src/admin/regenerateHints.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,4BAA4B,EAC7B,MAAM,0BAA0B,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,4BAA4B,GACjC,MAAM,CAwBR;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,YAAY,CAAC,4BAA4B,CAAC,GACnD,MAAM,CAIR"}

package/dist/admin/regenerateHints.js

@@ -0,0 +1,43 @@
+/**
+ * Status line for the admin "Regenerate hints" action (web AdminPage).
+ */
+/**
+ * Describe a regenerate-hints result, e.g.
+ * `Done: Examples: 10/12, Practices: 5/5 (15/17 total), 2 failed (examples/technique 4: 2).`
+ * Failures are grouped by table and technique.
+ */
+export function describeRegenerateHintsResult(data) {
+    const { examples, practices, updated, failed, total, failures } = data;
+    const parts = [];
+    if (examples)
+        parts.push(`Examples: ${examples.updated}/${examples.total}`);
+    if (practices) {
+        parts.push(`Practices: ${practices.updated}/${practices.total}`);
+    }
+    let msg = parts.length > 0
+        ? `Done: ${parts.join(', ')} (${updated}/${total} total)`
+        : `Done: ${updated}/${total} updated`;
+    if (failed > 0) {
+        msg += `, ${failed} failed`;
+        const byTableTechnique = new Map();
+        for (const f of failures ?? []) {
+            const key = `${f.table ?? 'unknown'}/technique ${f.technique ?? 0}`;
+            byTableTechnique.set(key, (byTableTechnique.get(key) ?? 0) + 1);
+        }
+        const details = Array.from(byTableTechnique.entries())
+            .map(([k, c]) => `${k}: ${c}`)
+            .join(', ');
+        msg += ` (${details})`;
+    }
+    return `${msg}.`;
+}
+/**
+ * Describe a regenerate-hints response: the result line on success,
+ * otherwise `Error: Failed to regenerate hints`.
+ */
+export function describeRegenerateHintsResponse(response) {
+    return response.success && response.data
+        ? describeRegenerateHintsResult(response.data)
+        : 'Error: Failed to regenerate hints';
+}
+//# sourceMappingURL=regenerateHints.js.map

package/dist/admin/regenerateHints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regenerateHints.js","sourceRoot":"","sources":["../../src/admin/regenerateHints.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAC3C,IAAkC;IAElC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACvE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5E,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,cAAc,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,GAAG,GACL,KAAK,CAAC,MAAM,GAAG,CAAC;QACd,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,OAAO,IAAI,KAAK,SAAS;QACzD,CAAC,CAAC,SAAS,OAAO,IAAI,KAAK,UAAU,CAAC;IAC1C,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,GAAG,IAAI,KAAK,MAAM,SAAS,CAAC;QAC5B,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,SAAS,cAAc,CAAC,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;YACpE,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;aACnD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;aAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,GAAG,IAAI,KAAK,OAAO,GAAG,CAAC;IACzB,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAAoD;IAEpD,OAAO,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI;QACtC,CAAC,CAAC,6BAA6B,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC9C,CAAC,CAAC,mCAAmC,CAAC;AAC1C,CAAC","sourcesContent":["/**\n * Status line for the admin \"Regenerate hints\" action (web AdminPage).\n */\n\nimport type {\n  BaseResponse,\n  PracticesRegenerateHintsData,\n} from '@sudobility/sudojo_types';\n\n/**\n * Describe a regenerate-hints result, e.g.\n * `Done: Examples: 10/12, Practices: 5/5 (15/17 total), 2 failed (examples/technique 4: 2).`\n * Failures are grouped by table and technique.\n */\nexport function describeRegenerateHintsResult(\n  data: PracticesRegenerateHintsData\n): string {\n  const { examples, practices, updated, failed, total, failures } = data;\n  const parts: string[] = [];\n  if (examples) parts.push(`Examples: ${examples.updated}/${examples.total}`);\n  if (practices) {\n    parts.push(`Practices: ${practices.updated}/${practices.total}`);\n  }\n  let msg =\n    parts.length > 0\n      ? `Done: ${parts.join(', ')} (${updated}/${total} total)`\n      : `Done: ${updated}/${total} updated`;\n  if (failed > 0) {\n    msg += `, ${failed} failed`;\n    const byTableTechnique = new Map<string, number>();\n    for (const f of failures ?? []) {\n      const key = `${f.table ?? 'unknown'}/technique ${f.technique ?? 0}`;\n      byTableTechnique.set(key, (byTableTechnique.get(key) ?? 0) + 1);\n    }\n    const details = Array.from(byTableTechnique.entries())\n      .map(([k, c]) => `${k}: ${c}`)\n      .join(', ');\n    msg += ` (${details})`;\n  }\n  return `${msg}.`;\n}\n\n/**\n * Describe a regenerate-hints response: the result line on success,\n * otherwise `Error: Failed to regenerate hints`.\n */\nexport function describeRegenerateHintsResponse(\n  response: BaseResponse<PracticesRegenerateHintsData>\n): string {\n  return response.success && response.data\n    ? describeRegenerateHintsResult(response.data)\n    : 'Error: Failed to regenerate hints';\n}\n"]}

package/dist/admin/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Shared types for the admin batch jobs (board generation, technique
+ * extraction, example creation).
+ *
+ * Ported from `sudojo_app/src/utils/admin/types.ts`.
+ */
+import type { NetworkClient } from '@sudobility/types';
+/** Options every admin job hook takes. */
+export interface AdminJobOptions {
+    networkClient: NetworkClient;
+    baseUrl: string;
+    /**
+     * Returns a valid admin ID token, or null when signed out. Called once when a
+     * job starts and again every {@link ADMIN_TOKEN_REFRESH_INTERVAL} boards, so
+     * a long job survives token expiry. Pass a function that forces a refresh
+     * (e.g. Firebase `getIdToken(true)`) or that falls back to the current token.
+     */
+    getToken: () => Promise<string | null>;
+}
+/** Cooperative cancellation flag shared by a running job. */
+export interface AbortHandle {
+    shouldAbort: () => boolean;
+    abort: () => void;
+}
+/** Create a fresh, not-yet-aborted {@link AbortHandle}. */
+export declare function createAbortHandle(): AbortHandle;
+/** Refresh the admin token every N boards during a long job. */
+export declare const ADMIN_TOKEN_REFRESH_INTERVAL = 50;
+/** Most recent log lines a job hook keeps (older lines are dropped). */
+export declare const ADMIN_JOB_LOG_LIMIT = 200;
+/** State every admin job hook exposes. */
+export interface AdminJobState {
+    /** True from `start` until the job finishes or is cancelled. */
+    isRunning: boolean;
+    /** Latest progress line ('' before the first run). */
+    progress: string;
+    /** Progress lines of the current run, oldest first, capped at {@link ADMIN_JOB_LOG_LIMIT}. */
+    log: string[];
+    /** Last error message of the current run, or null. */
+    error: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/admin/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/admin/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACxC;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,IAAI,WAAW,CAQ/C;AAED,gEAAgE;AAChE,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,SAAS,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,sDAAsD;IACtD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB"}