@bitmagic/cli 0.1.70-dev.0 → 0.1.70-dev.2

package/dist/trailer/beat-cut.js

@@ -1,232 +0,0 @@
-/**
- * Snap a shot list onto a beat grid (or plain seconds) and emit an EDL.
- *
- * A shot says WHICH source frame to start on and HOW LONG to hold, in beats when there is music
- * and in seconds when there is not; this turns that into the frame-exact `edl.json` the renderer
- * consumes. It is the TypeScript port of the make-trailer skill's `beat-edl.py`, so creators need
- * no Python.
- *
- * Each cut's target time comes straight from the beat grid, and the frame count is the difference
- * against the frames ACTUALLY emitted so far — not against the previous target. That matters for
- * speed-ramped clips: at 0.5x the output length is forced to an even number of frames, so a clip
- * whose beat-target is odd lands one frame long. Measuring from actual output makes the next clip
- * absorb that frame instead of every later cut inheriting it.
- *
- * A title cue with `"at": "last-clip"` is resolved to cover the final clip (the end card), so it
- * survives regeneration without hand-editing output times.
- */
-import * as fs from 'fs';
-import { CliError } from '../errors.js';
-import { warn } from './io.js';
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function finiteNumber(value, ctx) {
-    if (typeof value !== 'number' || !Number.isFinite(value)) {
-        throw new CliError(`${ctx}: expected a number, got ${JSON.stringify(value)}`);
-    }
-    return value;
-}
-function parseShot(raw, index) {
-    const ctx = `shots[${index}]`;
-    if (!isRecord(raw))
-        throw new CliError(`${ctx}: expected an object`);
-    const shot = {
-        in: finiteNumber(raw.in, `${ctx}.in`),
-        label: typeof raw.label === 'string' && raw.label.length > 0 ? raw.label : `shot ${index + 1}`,
-    };
-    if (shot.in < 0 || !Number.isInteger(shot.in))
-        throw new CliError(`${ctx}.in: expected a frame index >= 0`);
-    if (raw.beats !== undefined) {
-        shot.beats = finiteNumber(raw.beats, `${ctx}.beats`);
-        if (shot.beats <= 0)
-            throw new CliError(`${ctx}.beats: must be > 0`);
-    }
-    if (raw.seconds !== undefined) {
-        shot.seconds = finiteNumber(raw.seconds, `${ctx}.seconds`);
-        if (shot.seconds <= 0)
-            throw new CliError(`${ctx}.seconds: must be > 0`);
-    }
-    if (shot.beats === undefined && shot.seconds === undefined) {
-        throw new CliError(`${ctx} ("${shot.label}"): needs "beats" (with music) or "seconds"`);
-    }
-    if (raw.speed !== undefined)
-        shot.speed = finiteNumber(raw.speed, `${ctx}.speed`);
-    if (raw.ui !== undefined) {
-        if (typeof raw.ui !== 'boolean')
-            throw new CliError(`${ctx}.ui: expected true or false`);
-        shot.ui = raw.ui;
-    }
-    if (raw.transition !== undefined) {
-        if (raw.transition !== 'cut' && raw.transition !== 'crossfade') {
-            throw new CliError(`${ctx}.transition: expected "cut" or "crossfade"`);
-        }
-        shot.transition = raw.transition;
-    }
-    if (raw.transitionDuration !== undefined) {
-        shot.transitionDuration = finiteNumber(raw.transitionDuration, `${ctx}.transitionDuration`);
-    }
-    return shot;
-}
-function parseTitle(raw, index) {
-    const ctx = `titles[${index}]`;
-    if (!isRecord(raw))
-        throw new CliError(`${ctx}: expected an object`);
-    if (typeof raw.text !== 'string')
-        throw new CliError(`${ctx}.text: expected a string`);
-    const title = { text: raw.text, at: 0 };
-    if (raw.at === 'last-clip')
-        title.at = 'last-clip';
-    else
-        title.at = finiteNumber(raw.at, `${ctx}.at`);
-    if (raw.dur !== undefined)
-        title.dur = finiteNumber(raw.dur, `${ctx}.dur`);
-    if (typeof raw.sub === 'string')
-        title.sub = raw.sub;
-    if (typeof raw.note === 'string')
-        title.note = raw.note;
-    if (raw.style === 'title' || raw.style === 'line' || raw.style === 'card')
-        title.style = raw.style;
-    return title;
-}
-/** Parse a shots document: either a bare array of shots or `{ version, shots, titles? }`. */
-export function parseShots(raw, source) {
-    const shotsRaw = Array.isArray(raw) ? raw : isRecord(raw) ? raw.shots : undefined;
-    if (!Array.isArray(shotsRaw))
-        throw new CliError(`${source}: expected a "shots" array`);
-    if (shotsRaw.length === 0)
-        throw new CliError(`${source}: "shots" is empty — nothing to cut`);
-    const file = { version: 1, shots: shotsRaw.map(parseShot) };
-    if (isRecord(raw)) {
-        if (raw.version !== undefined && raw.version !== 1) {
-            throw new CliError(`${source}: unsupported version ${JSON.stringify(raw.version)} (this CLI writes version 1)`);
-        }
-        if (typeof raw.recording === 'string')
-            file.recording = raw.recording;
-        if (typeof raw.notes === 'string')
-            file.notes = raw.notes;
-        if (raw.titles !== undefined) {
-            if (!Array.isArray(raw.titles))
-                throw new CliError(`${source}: "titles" must be an array`);
-            file.titles = raw.titles.map(parseTitle);
-        }
-    }
-    return file;
-}
-export function loadShots(filePath) {
-    if (!fs.existsSync(filePath))
-        throw new CliError(`Shots file not found: ${filePath}`);
-    let raw;
-    try {
-        raw = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-    }
-    catch (err) {
-        throw new CliError(`Invalid JSON in ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
-    }
-    return parseShots(raw, filePath);
-}
-/**
- * Turn shots into frame-exact clips. With `beats` every cut lands on the grid counted from the
- * downbeat; without, each shot's `seconds` decides its length. Returns the EDL plus the numbers
- * the command prints so the author can judge the fit.
- */
-export function cutShots(shots, beats, fps, options = {}) {
-    if (!Number.isFinite(fps) || fps <= 0)
-        throw new CliError(`invalid fps: ${fps}`);
-    const grid = beats?.beatTimes ?? null;
-    const start = beats?.downbeatIndex ?? 0;
-    const t0 = grid !== null ? grid[start] : 0;
-    if (grid !== null && (t0 === undefined || grid.length < 2)) {
-        throw new CliError('The beat grid has too few beats to cut on — check the music file or pass --bpm.');
-    }
-    const clips = [];
-    let cum = start;
-    let emitted = 0;
-    let worst = 0;
-    let truncatedAt;
-    for (const shot of shots.shots) {
-        const speed = shot.speed ?? 1.0;
-        let need;
-        let suffix;
-        if (grid !== null && shot.beats !== undefined) {
-            const next = cum + shot.beats;
-            if (next >= grid.length) {
-                truncatedAt = shot.label;
-                break;
-            }
-            const target = Math.round((grid[next] - t0) * fps);
-            need = target - emitted;
-            cum = next;
-            suffix = `[${shot.beats}b]`;
-        }
-        else if (shot.seconds !== undefined) {
-            need = Math.round(shot.seconds * fps);
-            suffix = `[${shot.seconds}s]`;
-        }
-        else {
-            throw new CliError(`Shot "${shot.label}" is timed in beats but there is no beat grid — pass --music (or --beats), or give it "seconds".`);
-        }
-        const src = Math.max(1, Math.round(need * speed));
-        const actual = Math.round(src / speed);
-        emitted += actual;
-        if (grid !== null && shot.beats !== undefined) {
-            const target = Math.round((grid[cum] - t0) * fps);
-            worst = Math.max(worst, (Math.abs(emitted - target) / fps) * 1000);
-        }
-        let inFrame = shot.in;
-        if (options.frameCount !== undefined && inFrame + src > options.frameCount) {
-            const shifted = Math.max(0, options.frameCount - src);
-            warn(`shot "${shot.label}" runs past the recording's last frame — starting it at ${shifted} instead of ${inFrame}`);
-            inFrame = shifted;
-        }
-        const clip = {
-            in: inFrame,
-            out: inFrame + src,
-            speed,
-            transition: shot.transition ?? 'cut',
-            label: `${shot.label} ${suffix}`,
-        };
-        if (shot.transitionDuration !== undefined)
-            clip.transitionDuration = shot.transitionDuration;
-        if (shot.ui !== undefined)
-            clip.ui = shot.ui;
-        clips.push(clip);
-    }
-    if (clips.length === 0) {
-        throw new CliError(`Not a single shot fits the music: "${truncatedAt ?? shots.shots[0].label}" already runs past the end of the track.`);
-    }
-    const totalSec = emitted / fps;
-    const edl = { version: 1, targetDuration: Math.round(totalSec * 100) / 100, clips };
-    if (shots.titles !== undefined && shots.titles.length > 0) {
-        const last = clips[clips.length - 1];
-        const lastDur = Math.round(last.out - last.in) / ((last.speed ?? 1) * fps);
-        edl.titles = shots.titles.map((title) => {
-            const { at, dur, ...rest } = title;
-            if (at === 'last-clip') {
-                return { ...rest, at: Math.round((totalSec - lastDur) * 1000) / 1000, dur: Math.round(lastDur * 1000) / 1000 };
-            }
-            return { ...rest, at, dur: dur ?? 2.5 };
-        });
-    }
-    const result = {
-        edl,
-        beatsUsed: grid !== null ? cum - start : 0,
-        totalSec,
-        worstCutErrorMs: worst,
-    };
-    if (truncatedAt !== undefined)
-        result.truncatedAt = truncatedAt;
-    return result;
-}
-/** The one-line summary `bitmagic trailer cut` prints, mirroring the Python script's. */
-export function describeCut(result, beats) {
-    const parts = [
-        beats !== null ? `bpm=${beats.bpm.toFixed(2)}` : 'no beat grid',
-        `clips=${result.edl.clips.length}`,
-        beats !== null ? `beats=${result.beatsUsed}` : null,
-        `total=${result.totalSec.toFixed(3)}s`,
-        beats !== null ? `worst cut error=${result.worstCutErrorMs.toFixed(1)} ms` : null,
-    ].filter((p) => p !== null);
-    return parts.join('  ');
-}
-//# sourceMappingURL=beat-cut.js.map

package/dist/trailer/beat-cut.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"beat-cut.js","sourceRoot":"","sources":["../../src/trailer/beat-cut.ts"],"names":[],"mappings":"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"}

package/dist/trailer/edl-time.d.ts

@@ -1,61 +0,0 @@
-/**
- * Pure EDL time mapping: source frames -> output-timeline seconds.
- *
- * Crossfades OVERLAP the previous clip, so every clip after a crossfade
- * starts (and ends) earlier on the output timeline than a cut-only chain
- * would place it. All render math (xfade offsets, sound delays, total
- * duration) derives from this module so it can be unit-tested without ffmpeg.
- */
-import type { EdlClip, TimelineSound } from './timeline-types.js';
-export declare const DEFAULT_CROSSFADE_SEC = 0.25;
-export declare const DEFAULT_TAIL_PAD_FRAMES = 30;
-export declare const MIN_SPEED = 0.25;
-export declare const MAX_SPEED = 2;
-export interface ClipTiming {
-    index: number;
-    in: number;
-    out: number;
-    speed: number;
-    /** Resolved transition INTO this clip; first clip is always 'cut'. */
-    transition: 'cut' | 'crossfade';
-    /** Seconds; 0 for cuts. Also the xfade offset shortfall vs a plain concat. */
-    transitionDuration: number;
-    /** Seconds on the output timeline where this clip's first frame lands. */
-    outputStart: number;
-    /** Seconds this clip occupies on the output timeline (source frames / fps / speed). */
-    outputDuration: number;
-    label?: string;
-    /** Per-clip UI-overlay override; undefined means "follow the global --ui flag". */
-    ui?: boolean;
-}
-export interface ClipTimelineResult {
-    timings: ClipTiming[];
-    totalDuration: number;
-    warnings: string[];
-}
-export declare function computeClipTimeline(clips: EdlClip[], fps: number): ClipTimelineResult;
-/**
- * Output-timeline seconds where a source frame inside `timing` lands. Frames
- * before the clip's first frame (sound tail pad) clamp to the clip start.
- */
-export declare function sourceFrameToOutputSec(timing: ClipTiming, sourceFrame: number, fps: number): number;
-/**
- * Output time at which a clip stops being the only source on screen. A
- * crossfade INTO the next clip begins at that clip's outputStart — before this
- * clip's last frame — so anything that must not double up (UI overlays) hands
- * over there rather than at this clip's own end.
- */
-export declare function exclusiveOutputEnd(timings: readonly ClipTiming[], index: number): number;
-export interface PlacedSound {
-    sound: TimelineSound;
-    clipIndex: number;
-    /** Seconds on the output timeline where this sound instance starts. */
-    outputTimeSec: number;
-}
-/**
- * Place timeline sounds onto the output timeline. A clip picks up sounds with
- * frame in [in - tailPadFrames, out); sounds from the tail pad (before the
- * clip's first frame) clamp to the clip's output start. The same sound can be
- * placed once per clip whose source range covers it.
- */
-export declare function placeSounds(timings: ClipTiming[], sounds: TimelineSound[], fps: number, tailPadFrames?: number): PlacedSound[];

package/dist/trailer/edl-time.js

@@ -1,105 +0,0 @@
-import { CliError } from '../errors.js';
-export const DEFAULT_CROSSFADE_SEC = 0.25;
-export const DEFAULT_TAIL_PAD_FRAMES = 30;
-export const MIN_SPEED = 0.25;
-export const MAX_SPEED = 2.0;
-export function computeClipTimeline(clips, fps) {
-    if (clips.length === 0)
-        throw new CliError('EDL has no clips');
-    if (!Number.isFinite(fps) || fps <= 0)
-        throw new Error(`invalid fps: ${fps}`);
-    const warnings = [];
-    const timings = [];
-    let cursor = 0; // output-timeline end of the previous clip
-    clips.forEach((clip, index) => {
-        if (!Number.isInteger(clip.in) || !Number.isInteger(clip.out) || clip.in < 0 || clip.out <= clip.in) {
-            throw new Error(`clip ${index}: invalid frame range in=${clip.in} out=${clip.out}`);
-        }
-        let speed = clip.speed ?? 1;
-        if (speed < MIN_SPEED || speed > MAX_SPEED) {
-            const clamped = Math.min(MAX_SPEED, Math.max(MIN_SPEED, speed));
-            warnings.push(`clip ${index}: speed ${speed} outside [${MIN_SPEED}, ${MAX_SPEED}], clamped to ${clamped}`);
-            speed = clamped;
-        }
-        const outputDuration = (clip.out - clip.in) / fps / speed;
-        let transition = 'cut';
-        let transitionDuration = 0;
-        if (index === 0) {
-            if (clip.transition === 'crossfade')
-                warnings.push('clip 0: transition on the first clip is ignored');
-        }
-        else if (clip.transition === 'crossfade') {
-            transition = 'crossfade';
-            transitionDuration = clip.transitionDuration ?? DEFAULT_CROSSFADE_SEC;
-            if (transitionDuration <= 0) {
-                warnings.push(`clip ${index}: non-positive transitionDuration ${transitionDuration}, treating as cut`);
-                transition = 'cut';
-                transitionDuration = 0;
-            }
-            else {
-                const maxFade = Math.min(timings[index - 1].outputDuration, outputDuration);
-                if (transitionDuration > maxFade) {
-                    warnings.push(`clip ${index}: transitionDuration ${transitionDuration} longer than an adjacent clip, clamped to ${maxFade}`);
-                    transitionDuration = maxFade;
-                }
-            }
-        }
-        const outputStart = index === 0 ? 0 : cursor - transitionDuration;
-        const timing = {
-            index,
-            in: clip.in,
-            out: clip.out,
-            speed,
-            transition,
-            transitionDuration,
-            outputStart,
-            outputDuration
-        };
-        if (clip.label !== undefined)
-            timing.label = clip.label;
-        if (clip.ui !== undefined)
-            timing.ui = clip.ui;
-        timings.push(timing);
-        cursor = outputStart + outputDuration;
-    });
-    return { timings, totalDuration: cursor, warnings };
-}
-/**
- * Output-timeline seconds where a source frame inside `timing` lands. Frames
- * before the clip's first frame (sound tail pad) clamp to the clip start.
- */
-export function sourceFrameToOutputSec(timing, sourceFrame, fps) {
-    return timing.outputStart + Math.max(0, sourceFrame - timing.in) / fps / timing.speed;
-}
-/**
- * Output time at which a clip stops being the only source on screen. A
- * crossfade INTO the next clip begins at that clip's outputStart — before this
- * clip's last frame — so anything that must not double up (UI overlays) hands
- * over there rather than at this clip's own end.
- */
-export function exclusiveOutputEnd(timings, index) {
-    const timing = timings[index];
-    const ownEnd = timing.outputStart + timing.outputDuration;
-    const next = timings[index + 1];
-    return next === undefined ? ownEnd : Math.min(ownEnd, next.outputStart);
-}
-/**
- * Place timeline sounds onto the output timeline. A clip picks up sounds with
- * frame in [in - tailPadFrames, out); sounds from the tail pad (before the
- * clip's first frame) clamp to the clip's output start. The same sound can be
- * placed once per clip whose source range covers it.
- */
-export function placeSounds(timings, sounds, fps, tailPadFrames = DEFAULT_TAIL_PAD_FRAMES) {
-    const placements = [];
-    for (const timing of timings) {
-        for (const sound of sounds) {
-            if (sound.frame < timing.in - tailPadFrames || sound.frame >= timing.out)
-                continue;
-            const outputTimeSec = sourceFrameToOutputSec(timing, sound.frame, fps);
-            placements.push({ sound, clipIndex: timing.index, outputTimeSec });
-        }
-    }
-    placements.sort((a, b) => a.outputTimeSec - b.outputTimeSec);
-    return placements;
-}
-//# sourceMappingURL=edl-time.js.map

package/dist/trailer/edl-time.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"edl-time.js","sourceRoot":"","sources":["../../src/trailer/edl-time.ts"],"names":[],"mappings":"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"}

package/dist/trailer/ffmpeg.d.ts

@@ -1,18 +0,0 @@
-export type FfmpegTool = 'ffmpeg' | 'ffprobe';
-export declare function missingFfmpegMessage(tool?: FfmpegTool): string;
-/**
- * Refuse up front when a tool is missing, before any frames are read or sparks spent. `spawnSync`
- * with `-version` is the cheapest probe that also proves the binary actually runs.
- */
-export declare function ensureFfmpeg(tools?: readonly FfmpegTool[]): void;
-/**
- * The first of `tools` that is not on PATH, or null when they all are — the non-throwing half of
- * {@link ensureFfmpeg}, for callers that skip a step rather than fail when ffmpeg is absent.
- */
-export declare function missingFfmpegTool(tools?: readonly FfmpegTool[]): FfmpegTool | null;
-export declare function runFfmpeg(args: string[]): Promise<void>;
-/**
- * Run a tool and keep stdout. {@link runFfmpeg} discards it — everything in the trailer pipeline
- * writes files — so the PCM decode and every ffprobe query come through here instead.
- */
-export declare function captureFfmpegTool(tool: FfmpegTool, args: string[]): Promise<Buffer>;

package/dist/trailer/ffmpeg.js

@@ -1,100 +0,0 @@
-/**
- * Thin ffmpeg process wrapper. Always argument arrays, never shell strings.
- *
- * ffmpeg is the one external tool this CLI needs and the one a creator's machine is least likely to
- * have, so its absence is reported as a sentence with the install command rather than as an ENOENT
- * stack trace from deep inside a filtergraph.
- *
- * Two callers with opposite stakes, hence both `ensureFfmpeg` and `missingFfmpegTool`: the trailer
- * lane cannot do its job at all without ffmpeg and refuses up front, while `generate video`'s clip
- * review is a nicety on top of an already-paid generation and must degrade to a note.
- */
-import { spawn, spawnSync } from 'child_process';
-import { CliError, errnoCode } from '../errors.js';
-const STDERR_KEEP_BYTES = 65536;
-const STDERR_REPORT_LINES = 30;
-export function missingFfmpegMessage(tool = 'ffmpeg') {
-    return (`${tool} was not found on PATH. \`bitmagic trailer\` cuts and encodes with ffmpeg (and ffprobe) — ` +
-        'install it (macOS: brew install ffmpeg · Debian/Ubuntu: sudo apt install ffmpeg · ' +
-        'Windows: winget install Gyan.FFmpeg) and run the command again.');
-}
-/**
- * Refuse up front when a tool is missing, before any frames are read or sparks spent. `spawnSync`
- * with `-version` is the cheapest probe that also proves the binary actually runs.
- */
-export function ensureFfmpeg(tools = ['ffmpeg']) {
-    const missing = missingFfmpegTool(tools);
-    if (missing !== null)
-        throw new CliError(missingFfmpegMessage(missing), 1, 'ffmpeg_missing');
-}
-/**
- * The first of `tools` that is not on PATH, or null when they all are — the non-throwing half of
- * {@link ensureFfmpeg}, for callers that skip a step rather than fail when ffmpeg is absent.
- */
-export function missingFfmpegTool(tools = ['ffmpeg']) {
-    for (const tool of tools) {
-        const probe = spawnSync(tool, ['-version'], { stdio: 'ignore' });
-        if (probe.error !== undefined && errnoCode(probe.error) === 'ENOENT')
-            return tool;
-    }
-    return null;
-}
-export async function runFfmpeg(args) {
-    return new Promise((resolve, reject) => {
-        const child = spawn('ffmpeg', args, { stdio: ['ignore', 'ignore', 'pipe'] });
-        let stderr = '';
-        child.stderr.on('data', (chunk) => {
-            stderr += chunk.toString('utf-8');
-            if (stderr.length > STDERR_KEEP_BYTES)
-                stderr = stderr.slice(-STDERR_KEEP_BYTES / 2);
-        });
-        child.on('error', (err) => {
-            if (errnoCode(err) === 'ENOENT')
-                reject(new CliError(missingFfmpegMessage('ffmpeg'), 1, 'ffmpeg_missing'));
-            else
-                reject(new Error(`failed to start ffmpeg: ${err.message}`));
-        });
-        child.on('close', (code) => {
-            if (code === 0) {
-                resolve();
-            }
-            else {
-                const tail = stderr.trim().split('\n').slice(-STDERR_REPORT_LINES).join('\n');
-                reject(new CliError(`ffmpeg exited with code ${code}:\n${tail}`));
-            }
-        });
-    });
-}
-/**
- * Run a tool and keep stdout. {@link runFfmpeg} discards it — everything in the trailer pipeline
- * writes files — so the PCM decode and every ffprobe query come through here instead.
- */
-export async function captureFfmpegTool(tool, args) {
-    return new Promise((resolve, reject) => {
-        const child = spawn(tool, args, { stdio: ['ignore', 'pipe', 'pipe'] });
-        const chunks = [];
-        let stderr = '';
-        child.stdout.on('data', (chunk) => chunks.push(chunk));
-        child.stderr.on('data', (chunk) => {
-            stderr += chunk.toString('utf-8');
-            if (stderr.length > STDERR_KEEP_BYTES)
-                stderr = stderr.slice(-STDERR_KEEP_BYTES / 2);
-        });
-        child.on('error', (err) => {
-            if (errnoCode(err) === 'ENOENT')
-                reject(new CliError(missingFfmpegMessage(tool), 1, 'ffmpeg_missing'));
-            else
-                reject(new Error(`failed to start ${tool}: ${err.message}`));
-        });
-        child.on('close', (code) => {
-            if (code === 0) {
-                resolve(Buffer.concat(chunks));
-            }
-            else {
-                const tail = stderr.trim().split('\n').slice(-STDERR_REPORT_LINES).join('\n');
-                reject(new Error(`${tool} exited with code ${code}:\n${tail}`));
-            }
-        });
-    });
-}
-//# sourceMappingURL=ffmpeg.js.map

package/dist/trailer/ffmpeg.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ffmpeg.js","sourceRoot":"","sources":["../../src/trailer/ffmpeg.ts"],"names":[],"mappings":"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"}