mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-05 17:30:50 +00:00
* feat(media-use): core infrastructure — manifest, cache, adopt, probe Foundation for media-use — the media resolution layer for HyperFrames. - manifest.mjs: JSONL read/write/find for .media/manifest.jsonl - index-gen.mjs: regenerate agent-readable index.md from manifest - cache.mjs: content-addressed global cache at ~/.media/ (SHA-256, sentinel) - freeze.mjs: download URL or copy local file to .media/ - probe.mjs: extract duration/dimensions via ffprobe - adopt.mjs: scan assets/ directory, register existing files with metadata - 19 passing tests (manifest round-trip, cache, promote, index generation) * fix(media-use): oxfmt formatting + cap freeze download size Format adopt/cache/probe/manifest.test (CI oxfmt --check gate). Cap freezeUrl downloads at 256MB so a hostile/runaway URL can't fill the disk (addresses CodeQL #670: network data written to file). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
113 lines
3.5 KiB
JavaScript
113 lines
3.5 KiB
JavaScript
import { readdirSync, statSync, existsSync } from "node:fs";
|
|
import { join, extname, basename } from "node:path";
|
|
import { readManifest, appendRecord, nextId } from "./manifest.mjs";
|
|
import { regenerateIndex } from "./index-gen.mjs";
|
|
import { probe } from "./probe.mjs";
|
|
|
|
const AUDIO_EXT = new Set([".mp3", ".wav", ".ogg", ".m4a", ".aac"]);
|
|
const IMAGE_EXT = new Set([".jpg", ".jpeg", ".png", ".gif", ".webp", ".svg", ".ico"]);
|
|
const VIDEO_EXT = new Set([".mp4", ".webm", ".mov"]);
|
|
|
|
function inferType(filePath) {
|
|
const ext = extname(filePath).toLowerCase();
|
|
if (AUDIO_EXT.has(ext)) {
|
|
const lower = filePath.toLowerCase();
|
|
if (lower.includes("/bgm/") || lower.includes("/music/") || lower.startsWith("bgm/"))
|
|
return "bgm";
|
|
if (lower.includes("/sfx/") || lower.includes("/sound") || lower.startsWith("sfx/"))
|
|
return "sfx";
|
|
if (lower.includes("/voice/") || lower.includes("/narrat") || lower.startsWith("voice/"))
|
|
return "voice";
|
|
return "bgm";
|
|
}
|
|
if (IMAGE_EXT.has(ext)) {
|
|
if (ext === ".svg" || ext === ".ico") return "icon";
|
|
return "image";
|
|
}
|
|
if (VIDEO_EXT.has(ext)) return "video";
|
|
return null;
|
|
}
|
|
|
|
function walkDir(dir, base = "") {
|
|
const files = [];
|
|
if (!existsSync(dir)) return files;
|
|
for (const entry of readdirSync(dir, { withFileTypes: true })) {
|
|
const rel = base ? `${base}/${entry.name}` : entry.name;
|
|
if (entry.isDirectory()) {
|
|
files.push(...walkDir(join(dir, entry.name), rel));
|
|
} else {
|
|
files.push(rel);
|
|
}
|
|
}
|
|
return files;
|
|
}
|
|
|
|
export function scanExistingAssets(projectDir) {
|
|
const assetsDir = join(projectDir, "assets");
|
|
if (!existsSync(assetsDir)) return [];
|
|
|
|
const files = walkDir(assetsDir);
|
|
const found = [];
|
|
for (const rel of files) {
|
|
const type = inferType(rel);
|
|
if (!type) continue;
|
|
const fullPath = join(assetsDir, rel);
|
|
const stat = statSync(fullPath);
|
|
const meta = probe(fullPath);
|
|
found.push({
|
|
relativePath: `assets/${rel}`,
|
|
type,
|
|
size: stat.size,
|
|
name: basename(rel, extname(rel)),
|
|
...meta,
|
|
});
|
|
}
|
|
return found;
|
|
}
|
|
|
|
export function adoptExistingAssets(projectDir) {
|
|
const existing = scanExistingAssets(projectDir);
|
|
if (existing.length === 0) return [];
|
|
|
|
const manifest = readManifest(projectDir);
|
|
const knownPaths = new Set(manifest.map((r) => r.path));
|
|
|
|
const adopted = [];
|
|
for (const asset of existing) {
|
|
if (knownPaths.has(asset.relativePath)) continue;
|
|
|
|
const id = nextId(projectDir, asset.type);
|
|
const record = {
|
|
id,
|
|
type: asset.type,
|
|
path: asset.relativePath,
|
|
source: "existing",
|
|
description: asset.name.replace(/[-_]/g, " "),
|
|
...(asset.duration != null && { duration: asset.duration }),
|
|
...(asset.width != null && { width: asset.width }),
|
|
...(asset.height != null && { height: asset.height }),
|
|
provenance: { provider: "local", adopted: true },
|
|
};
|
|
appendRecord(projectDir, record);
|
|
adopted.push(record);
|
|
}
|
|
|
|
if (adopted.length > 0) regenerateIndex(projectDir);
|
|
return adopted;
|
|
}
|
|
|
|
export function findExistingAsset(projectDir, intent, type) {
|
|
const assetsDir = join(projectDir, "assets");
|
|
if (!existsSync(assetsDir)) return null;
|
|
const lower = intent.toLowerCase();
|
|
for (const rel of walkDir(assetsDir)) {
|
|
const t = inferType(rel);
|
|
if (!t || (type && t !== type)) continue;
|
|
const name = basename(rel, extname(rel)).toLowerCase().replace(/[-_]/g, " ");
|
|
if (name.includes(lower) || lower.includes(name)) {
|
|
return { relativePath: `assets/${rel}`, type: t, name: basename(rel, extname(rel)) };
|
|
}
|
|
}
|
|
return null;
|
|
}
|