@hyperframes/studio-server 0.8.91 → 0.8.92

package/dist/index.js

@@ -153,7 +153,7 @@ import {
   existsSync as existsSync3,
   lstatSync as lstatSync2,
   openSync,
-  readFileSync as readFileSync4,
+  readFileSync as readFileSync3,
   readlinkSync,
   writeFileSync as writeFileSync4,
   writeSync,
@@ -591,7 +591,8 @@ import { parseHTML as parseHTML2 } from "linkedom";
 import { ensureHfIds } from "@hyperframes/parsers/hf-ids";
 
 // src/helpers/compositionInsertion.ts
-import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
+import { existsSync as existsSync2 } from "fs";
+import { readProjectFile } from "@hyperframes/parsers/asset-resolution";
 import { randomUUID } from "crypto";
 import { dirname as dirname2, relative as relative2, resolve, sep } from "path";
 import { parseHTML } from "linkedom";
@@ -637,6 +638,16 @@ function canonicalProjectPath(projectDir, candidate) {
   }
   return canonical;
 }
+function readCompositionSource(file) {
+  const read = readProjectFile(file);
+  if (read.kind === "folder") {
+    throw new CompositionInsertionError("Composition source is a folder, not an HTML file", 400);
+  }
+  if (read.kind === "missing") {
+    throw new CompositionInsertionError("Composition source was not found", 404);
+  }
+  return read.text;
+}
 function validateSourcePath(sourcePath) {
   if (!sourcePath.trim() || sourcePath.includes("\0") || /^[a-z]+:/i.test(sourcePath)) {
     throw new CompositionInsertionError("Invalid composition source path", 400);
@@ -665,7 +676,7 @@ function validateDependencyGraph(projectDir, targetAbs, sourceAbs) {
     }
     if (visited.has(file)) return;
     visiting.add(file);
-    const source = readFileSync3(file, "utf-8");
+    const source = readCompositionSource(file);
     const { document } = compositionRoot(source);
     for (const host of descendants(document, "[data-composition-src]")) {
       const dependency = host.getAttribute("data-composition-src");
@@ -729,7 +740,7 @@ function insertCompositionIntoSource(input) {
   const targetAbs = canonicalProjectFile(input.projectDir, input.targetPath);
   const sourceAbs = canonicalProjectFile(input.projectDir, input.sourcePath);
   validateDependencyGraph(input.projectDir, targetAbs, sourceAbs);
-  const source = readFileSync3(sourceAbs, "utf-8");
+  const source = readCompositionSource(sourceAbs);
   const sourceComposition = compositionRoot(source).root;
   const duration = positiveAttribute(
     sourceComposition,
@@ -972,7 +983,7 @@ function foldAndCommitElementPatchBatches(projectDir, batches, writeFile, reques
     resolvedPaths.add(absPath);
     let before;
     try {
-      before = readFileSync4(absPath, "utf-8");
+      before = readFileSync3(absPath, "utf-8");
     } catch {
       return { error: "not-found", sourceFile: batch.sourceFile };
     }
@@ -1028,7 +1039,7 @@ function commitElementPatchBatchesWithReceipts(c, projectDir, batches) {
   );
 }
 function writeFileWithReceipt(c, filePath, absPath, html) {
-  const overwrote = readFileSync4(absPath);
+  const overwrote = readFileSync3(absPath);
   replaceFileAtomically(absPath, html, statSync3(absPath).mode);
   const version = fileContentVersion(html);
   const writeToken = createWriteToken(c.req.header("X-Hyperframes-Write-Token"));
@@ -1038,7 +1049,7 @@ function writeFileWithReceipt(c, filePath, absPath, html) {
 function writeMutationResult(c, projectDir, filePath, absPath, html, original) {
   const backup = snapshotBeforeWrite(projectDir, absPath);
   if (backup.error) return c.json({ error: `backup failed: ${backup.error}` }, 500);
-  if (readFileSync4(absPath, "utf-8") !== original) {
+  if (readFileSync3(absPath, "utf-8") !== original) {
     return c.json({ error: "file changed", conflict: true, path: filePath }, 409);
   }
   const { version } = writeFileWithReceipt(c, filePath, absPath, html);
@@ -1121,7 +1132,7 @@ function updateReferences(projectDir, oldPath, newPath) {
   let updatedCount = 0;
   for (const file of textFiles) {
     if (!isSafePath(projectDir, file)) continue;
-    const content = readFileSync4(file, "utf-8");
+    const content = readFileSync3(file, "utf-8");
     if (!content.includes(oldPath)) continue;
     const updated = content.split(oldPath).join(newPath);
     if (updated !== content) {
@@ -1395,7 +1406,7 @@ function containsRawGsapExpression(value) {
   return Object.values(value).some(containsRawGsapExpression);
 }
 async function prepareGsapMutationScript(c, res, firstMutation) {
-  const beforeHtml = readFileSync4(res.absPath, "utf-8");
+  const beforeHtml = readFileSync3(res.absPath, "utf-8");
   let html = beforeHtml;
   let block = extractGsapScriptBlock(html);
   if (!block && (firstMutation.type === "add" || firstMutation.type === "add-with-keyframes")) {
@@ -1462,7 +1473,7 @@ async function applyGsapMutations(c, res, mutations) {
   const changed = block.scriptText !== initialScript;
   const newHtml = changed ? block.replaceScript(block.scriptText) : html;
   let backupPath = null;
-  if (readFileSync4(res.absPath, "utf-8") !== beforeHtml) {
+  if (readFileSync3(res.absPath, "utf-8") !== beforeHtml) {
     return c.json({ error: "file changed during GSAP mutation", conflict: true }, 409);
   }
   if (changed) {
@@ -2299,7 +2310,7 @@ function registerFileRoutes(api, adapter) {
       if (stat2.size > MAX_TEXT_READ_BYTES) {
         return c.json({ error: "too large to read as text", why: "too_large" }, 413);
       }
-      const content = readFileSync4(fd);
+      const content = readFileSync3(fd);
       const version = fileContentVersion(content);
       c.header("ETag", version);
       if (content.subarray(0, GIT_BINARY_SNIFF_BYTES).includes(0)) {
@@ -2324,7 +2335,7 @@ function registerFileRoutes(api, adapter) {
     if (expectedVersion === null && !createOnly) {
       let currentContent = null;
       try {
-        currentContent = readFileSync4(res.absPath);
+        currentContent = readFileSync3(res.absPath);
       } catch (error) {
         if (!error || typeof error !== "object" || !("code" in error) || error.code !== "ENOENT") {
           throw error;
@@ -2351,7 +2362,7 @@ function registerFileRoutes(api, adapter) {
         if (!error || typeof error !== "object" || !("code" in error) || error.code !== "EEXIST") {
           throw error;
         }
-        const currentContent = readFileSync4(res.absPath);
+        const currentContent = readFileSync3(res.absPath);
         return c.json(
           {
             error: "file conflict",
@@ -2386,7 +2397,7 @@ function registerFileRoutes(api, adapter) {
         );
       }
       try {
-        const currentContent = readFileSync4(fd);
+        const currentContent = readFileSync3(fd);
         overwrote = currentContent;
         const currentVersion = fileContentVersion(currentContent);
         if (expectedVersion !== currentVersion) {
@@ -2462,7 +2473,7 @@ function registerFileRoutes(api, adapter) {
     }
     let before;
     try {
-      before = readFileSync4(ctx.absPath, "utf-8");
+      before = readFileSync3(ctx.absPath, "utf-8");
     } catch (error) {
       if (!error || typeof error !== "object" || !("code" in error) || error.code !== "ENOENT") {
         throw error;
@@ -2491,7 +2502,7 @@ function registerFileRoutes(api, adapter) {
     }
     const backup = snapshotBeforeWrite(ctx.project.dir, ctx.absPath);
     if (backup.error) return c.json({ error: `backup failed: ${backup.error}` }, 500);
-    const current = readFileSync4(ctx.absPath, "utf-8");
+    const current = readFileSync3(ctx.absPath, "utf-8");
     if (current !== before) {
       const currentVersion2 = fileContentVersion(current);
       return c.json({ error: "file conflict", currentVersion: currentVersion2, currentContent: current }, 409);
@@ -2524,7 +2535,7 @@ function registerFileRoutes(api, adapter) {
     }
     const parsed = await parseMutationBody(c);
     if ("error" in parsed) return parsed.error;
-    const originalContent = readFileSync4(ctx.absPath, "utf-8");
+    const originalContent = readFileSync3(ctx.absPath, "utf-8");
     return writeIfChanged(
       c,
       ctx.project.dir,
@@ -2545,7 +2556,7 @@ function registerFileRoutes(api, adapter) {
     if (!Array.isArray(targets) || targets.length === 0) {
       return c.json({ error: "targets required" }, 400);
     }
-    const originalContent = readFileSync4(ctx.absPath, "utf-8");
+    const originalContent = readFileSync3(ctx.absPath, "utf-8");
     let next = originalContent;
     for (const target of targets) {
       next = removeElementFromHtml(next, target);
@@ -2578,7 +2589,7 @@ function registerFileRoutes(api, adapter) {
         seen.add(absPath);
         let before;
         try {
-          before = readFileSync4(absPath, "utf-8");
+          before = readFileSync3(absPath, "utf-8");
         } catch {
           return c.json({ error: `not found: ${file.path}` }, 404);
         }
@@ -2605,7 +2616,7 @@ function registerFileRoutes(api, adapter) {
         prepared.push(folded);
       }
       for (const file of prepared) {
-        const current = readFileSync4(file.absPath, "utf-8");
+        const current = readFileSync3(file.absPath, "utf-8");
         if (current !== file.before) {
           return c.json(
             {
@@ -2648,7 +2659,7 @@ function registerFileRoutes(api, adapter) {
         const conflicts = [];
         for (const file of written.reverse()) {
           try {
-            const current = readFileSync4(file.absPath, "utf-8");
+            const current = readFileSync3(file.absPath, "utf-8");
             if (current !== file.after) {
               conflicts.push(file.path);
               continue;
@@ -2696,7 +2707,7 @@ function registerFileRoutes(api, adapter) {
     const fallbackTiming = typeof parsed.body.elementStart === "number" && typeof parsed.body.elementDuration === "number" ? { start: parsed.body.elementStart, duration: parsed.body.elementDuration } : void 0;
     let originalContent;
     try {
-      originalContent = readFileSync4(ctx.absPath, "utf-8");
+      originalContent = readFileSync3(ctx.absPath, "utf-8");
     } catch {
       return c.json({ error: "not found" }, 404);
     }
@@ -2754,7 +2765,7 @@ function registerFileRoutes(api, adapter) {
     for (let attempt = 1; ; attempt += 1) {
       let originalContent;
       try {
-        originalContent = readFileSync4(ctx.absPath, "utf-8");
+        originalContent = readFileSync3(ctx.absPath, "utf-8");
       } catch {
         return c.json({ error: "not found" }, 404);
       }
@@ -2860,7 +2871,7 @@ function registerFileRoutes(api, adapter) {
     }
     let originalContent;
     try {
-      originalContent = readFileSync4(ctx.absPath, "utf-8");
+      originalContent = readFileSync3(ctx.absPath, "utf-8");
     } catch {
       return c.json({ error: "not found" }, 404);
     }
@@ -2916,7 +2927,7 @@ function registerFileRoutes(api, adapter) {
     ).map((entry) => ({ target: entry.target, track: entry.track }));
     let originalContent;
     try {
-      originalContent = readFileSync4(ctx.absPath, "utf-8");
+      originalContent = readFileSync3(ctx.absPath, "utf-8");
     } catch {
       return c.json({ error: "not found" }, 404);
     }
@@ -2945,7 +2956,7 @@ function registerFileRoutes(api, adapter) {
     if ("error" in parsed) return parsed.error;
     let content;
     try {
-      content = readFileSync4(ctx.absPath, "utf-8");
+      content = readFileSync3(ctx.absPath, "utf-8");
     } catch {
       return c.json({ exists: false });
     }
@@ -2989,7 +3000,7 @@ function registerFileRoutes(api, adapter) {
     }
     ensureDir(project.dir, destAbs);
     try {
-      writeFileSync4(destAbs, readFileSync4(srcAbs), { flag: "wx" });
+      writeFileSync4(destAbs, readFileSync3(srcAbs), { flag: "wx" });
     } catch (error) {
       if (!error || typeof error !== "object" || !("code" in error) || error.code !== "EEXIST") {
         throw error;
@@ -3033,7 +3044,7 @@ function registerFileRoutes(api, adapter) {
       mustExist: true
     });
     if ("error" in res) return res.error;
-    const html = readFileSync4(res.absPath, "utf-8");
+    const html = readFileSync3(res.absPath, "utf-8");
     const block = extractGsapScriptBlock(html);
     if (!block) {
       return c.json({
@@ -3089,7 +3100,7 @@ function registerFileRoutes(api, adapter) {
     if (!body || typeof body.expected !== "string" || typeof body.restore !== "string") {
       return c.json({ error: "expected and restore contents required" }, 400);
     }
-    const current = readFileSync4(res.absPath, "utf-8");
+    const current = readFileSync3(res.absPath, "utf-8");
     if (current !== body.expected) {
       return c.json({ ok: true, restored: false, conflict: true });
     }
@@ -3099,7 +3110,7 @@ function registerFileRoutes(api, adapter) {
 }
 
 // src/routes/preview.ts
-import { createReadStream, existsSync as existsSync5, readFileSync as readFileSync6, statSync as statSync4 } from "fs";
+import { createReadStream, existsSync as existsSync5, readFileSync as readFileSync5, statSync as statSync4 } from "fs";
 import { Readable } from "stream";
 import { join as join8, resolve as resolve4 } from "path";
 import { createHash } from "crypto";
@@ -3114,7 +3125,7 @@ import { injectTagsAtHeadStart } from "@hyperframes/core/compiler/html-document"
 import { isWithinProjectRoot } from "@hyperframes/parsers/asset-resolution";
 
 // src/helpers/subComposition.ts
-import { existsSync as existsSync4, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
 import { join as join6 } from "path";
 import { parseHTML as parseHTML3 } from "linkedom";
 import {
@@ -3224,7 +3235,7 @@ function tagRootCompositionFile(bodyHtml, compPath) {
 function buildSubCompositionHtml(projectDir, compPath, runtimeUrl, baseHref, rawOverride) {
   const compFile = join6(projectDir, compPath);
   if (!existsSync4(compFile)) return null;
-  const rawComp = rawOverride ?? readFileSync5(compFile, "utf-8");
+  const rawComp = rawOverride ?? readFileSync4(compFile, "utf-8");
   let compHeadContent = "";
   let rewrittenContent;
   let htmlAttrs = "";
@@ -3257,7 +3268,7 @@ function buildSubCompositionHtml(projectDir, compPath, runtimeUrl, baseHref, raw
   const indexPath = join6(projectDir, "index.html");
   let headContent = "";
   if (existsSync4(indexPath)) {
-    const indexHtml = readFileSync5(indexPath, "utf-8");
+    const indexHtml = readFileSync4(indexPath, "utf-8");
     const headMatch = indexHtml.match(/<head[^>]*>([\s\S]*?)<\/head>/i);
     headContent = headMatch?.[1] ?? "";
   }
@@ -3445,7 +3456,7 @@ function readStudioMotionManifestContent(projectDir) {
   const manifestPath = join8(projectDir, STUDIO_MOTION_PATH);
   if (!existsSync5(manifestPath)) return "";
   try {
-    return readFileSync6(manifestPath, "utf-8");
+    return readFileSync5(manifestPath, "utf-8");
   } catch {
     return "";
   }
@@ -3596,13 +3607,13 @@ function resolveProjectMainHtml(projectDir, projectId) {
   recordPreviewRead(projectDir, blockHtmlPath);
   if (existsSync5(indexPath)) {
     return {
-      html: readFileSync6(indexPath, "utf-8"),
+      html: readFileSync5(indexPath, "utf-8"),
       compositionPath: "index.html"
     };
   }
   if (existsSync5(blockHtmlPath)) {
     return {
-      html: readFileSync6(blockHtmlPath, "utf-8"),
+      html: readFileSync5(blockHtmlPath, "utf-8"),
       compositionPath: `${projectId}.html`
     };
   }
@@ -3737,7 +3748,7 @@ ${etag}`;
   function pinSubCompHfIds(compFile, compPath) {
     if (!/\.html?$/i.test(compPath)) return void 0;
     try {
-      return ensureHfIds2(readFileSync6(compFile, "utf-8"));
+      return ensureHfIds2(readFileSync5(compFile, "utf-8"));
     } catch {
       return null;
     }
@@ -3848,7 +3859,7 @@ ${etag}`;
       recordProxyRequest();
       servedContentType = PROXY_VARIANT_CONFIG[proxyVariant].contentType;
     }
-    const textBuffer = isText ? Buffer.from(readFileSync6(file, "utf-8"), "utf-8") : null;
+    const textBuffer = isText ? Buffer.from(readFileSync5(file, "utf-8"), "utf-8") : null;
     const totalSize = textBuffer ? textBuffer.length : statSync4(servedPath).size;
     const bodyFor = (start, end) => textBuffer ? new Uint8Array(textBuffer.subarray(start, end + 1)) : (
       // Node's web stream type and the DOM one do not overlap for tsc on
@@ -3892,7 +3903,7 @@ ${etag}`;
 }
 
 // src/routes/lint.ts
-import { readFileSync as readFileSync7 } from "fs";
+import { readFileSync as readFileSync6 } from "fs";
 import { join as join9 } from "path";
 async function collectProjectFindings(adapter, projectDir) {
   const findings = [];
@@ -3911,7 +3922,7 @@ async function lintUncoveredHtml(adapter, projectDir, htmlFiles, coveredFiles) {
   const findings = [];
   for (const file of htmlFiles) {
     if (coveredFiles.has(file)) continue;
-    const content = readFileSync7(join9(projectDir, file), "utf-8");
+    const content = readFileSync6(join9(projectDir, file), "utf-8");
     const result = await adapter.lint(content, { filePath: file, isSubComposition: true });
     for (const finding of result?.findings ?? []) {
       findings.push({ ...finding, file });
@@ -3944,7 +3955,7 @@ function registerLintRoutes(api, adapter) {
 
 // src/routes/render.ts
 import { streamSSE } from "hono/streaming";
-import { existsSync as existsSync6, readFileSync as readFileSync8, unlinkSync as unlinkSync3, readdirSync as readdirSync3, statSync as statSync5 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync7, unlinkSync as unlinkSync3, readdirSync as readdirSync3, statSync as statSync5 } from "fs";
 import { join as join10 } from "path";
 import { VALID_CANVAS_RESOLUTIONS } from "@hyperframes/parsers";
 import { formatRenderOutputTimestamp, parseFps } from "@hyperframes/core";
@@ -4083,7 +4094,7 @@ function registerRenderRoutes(api, adapter) {
     }
     const contentType = renderContentType(job.outputPath);
     const filename = job.outputPath.split("/").pop() ?? `render.mp4`;
-    const content = readFileSync8(job.outputPath);
+    const content = readFileSync7(job.outputPath);
     return new Response(content, {
       headers: {
         "Content-Type": contentType,
@@ -4101,7 +4112,7 @@ function registerRenderRoutes(api, adapter) {
     }
     const contentType = renderContentType(job.outputPath);
     const filename = job.outputPath.split("/").pop() ?? `render.mp4`;
-    const content = readFileSync8(job.outputPath);
+    const content = readFileSync7(job.outputPath);
     return new Response(content, {
       headers: {
         "Content-Type": contentType,
@@ -4134,7 +4145,7 @@ function registerRenderRoutes(api, adapter) {
     if (!fp) return c.json({ error: "forbidden" }, 403);
     if (!existsSync6(fp)) return c.json({ error: "not found" }, 404);
     const contentType = renderContentType(fp);
-    const content = readFileSync8(fp);
+    const content = readFileSync7(fp);
     return new Response(content, {
       headers: {
         "Content-Type": contentType,
@@ -4158,7 +4169,7 @@ function registerRenderRoutes(api, adapter) {
       let durationMs;
       if (existsSync6(metaPath)) {
         try {
-          const meta = JSON.parse(readFileSync8(metaPath, "utf-8"));
+          const meta = JSON.parse(readFileSync7(metaPath, "utf-8"));
           if (meta.status === "failed" && !existsSync6(fp)) status = "failed";
           if (meta.durationMs) durationMs = meta.durationMs;
         } catch {
@@ -4404,7 +4415,7 @@ import {
   closeSync as closeSync2,
   fstatSync as fstatSync2,
   openSync as openSync2,
-  readFileSync as readFileSync10,
+  readFileSync as readFileSync9,
   readdirSync as readdirSync4,
   renameSync as renameSync3,
   rmSync as rmSync4,
@@ -4416,7 +4427,7 @@ import { join as join11 } from "path";
 import { createHash as createHash3, randomUUID as randomUUID2 } from "crypto";
 
 // src/helpers/compositionInputs.ts
-import { readFileSync as readFileSync9 } from "fs";
+import { readFileSync as readFileSync8 } from "fs";
 var ROOT_COMPOSITION = "index.html";
 var COMPOSITION_SRC = /\bdata-composition-src\s*=\s*(["'])(.*?)\1/g;
 function projectReader(projectDir) {
@@ -4426,7 +4437,7 @@ function projectReader(projectDir) {
       const file = resolveWithinProject(projectDir, compPath);
       let source = null;
       try {
-        source = file ? readFileSync9(file, "utf-8") : null;
+        source = file ? readFileSync8(file, "utf-8") : null;
       } catch {
       }
       sources.set(compPath, source);
@@ -4538,7 +4549,7 @@ function readFileOnce(file) {
   try {
     const stat2 = fstatSync2(fd);
     if (!stat2.isFile()) return "not-a-file";
-    return { data: readFileSync10(fd), mtimeMs: stat2.mtimeMs };
+    return { data: readFileSync9(fd), mtimeMs: stat2.mtimeMs };
   } finally {
     closeSync2(fd);
   }
@@ -4676,7 +4687,7 @@ function registerThumbnailRoutes(api, adapter) {
 }
 
 // src/routes/waveform.ts
-import { existsSync as existsSync7, readFileSync as readFileSync11, statSync as statSync7 } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync10, statSync as statSync7 } from "fs";
 import { join as join12, resolve as resolve5 } from "path";
 import { isWithinProjectRoot as isWithinProjectRoot2 } from "@hyperframes/parsers/asset-resolution";
 function registerWaveformRoutes(api, adapter) {
@@ -4694,7 +4705,7 @@ function registerWaveformRoutes(api, adapter) {
     const cachePath = join12(cacheDir, buildWaveformCacheKey(assetPath, stats));
     try {
       if (isWaveformCacheDirectory(cacheDir) && existsSync7(cachePath)) {
-        const peaks2 = JSON.parse(readFileSync11(cachePath, "utf-8"));
+        const peaks2 = JSON.parse(readFileSync10(cachePath, "utf-8"));
         return c.json({ peaks: peaks2 });
       }
     } catch {
@@ -5194,14 +5205,14 @@ function registerMediaRoutes(api, adapter, options = {}) {
 }
 
 // src/routes/globalAssets.ts
-import { existsSync as existsSync9, readFileSync as readFileSync12 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync11 } from "fs";
 import { homedir } from "os";
 import { join as join14 } from "path";
 function readGlobalAssets(home = homedir()) {
   const manifestPath = join14(home, ".media", "manifest.jsonl");
   if (!existsSync9(manifestPath)) return [];
   const out = [];
-  for (const line of readFileSync12(manifestPath, "utf8").split("\n")) {
+  for (const line of readFileSync11(manifestPath, "utf8").split("\n")) {
     if (!line.trim()) continue;
     try {
       const rec = JSON.parse(line);
@@ -5450,7 +5461,7 @@ function numericAttribute(element, name) {
 
 // src/helpers/previewDocumentStore.ts
 import { createHash as createHash4 } from "crypto";
-import { readFileSync as readFileSync13, readdirSync as readdirSync5, rmSync as rmSync5 } from "fs";
+import { readFileSync as readFileSync12, readdirSync as readdirSync5, rmSync as rmSync5 } from "fs";
 import { join as join15 } from "path";
 function createPreviewDocumentStore(projectDir, salt) {
   const dir = join15(projectDir, ".hyperframes", "preview");
@@ -5459,7 +5470,7 @@ ${key}`).digest("hex").slice(0, 32)}.html`);
   return {
     read(key) {
       try {
-        return readFileSync13(fileFor(key), "utf-8");
+        return readFileSync12(fileFor(key), "utf-8");
       } catch {
         return null;
       }