@hyperframes/studio-server 0.8.7 → 0.8.8

package/dist/index.d.ts

@@ -16,6 +16,27 @@ import './helpers/mediaCodecMap.js';
  */
 declare function createStudioApi(adapter: StudioApiAdapter): Hono;
 
+/**
+ * Whether a write at `changedPath` can change `createProjectSignature(projectDir)`.
+ *
+ * Owned here because it is the exact complement of what the walk below collects,
+ * and a second copy of that reasoning drifts the moment either set changes. A
+ * watcher that invalidates on everything is not merely wasteful: `.thumbnails/`
+ * is written by the thumbnail route on every capture, and each capture reads the
+ * preview, so an unfiltered watcher discards the memo on roughly every request of
+ * the one workload the memo exists for.
+ *
+ * Note this is not `WATCHER_EXCLUDED_DIRS`, which is character-identical but
+ * excludes all of `.hyperframes/` — the signature deliberately reads two manifest
+ * files from inside it, so filtering with that set would stop motion-state saves
+ * from ever invalidating.
+ *
+ * Every segment is tested, not just the parents, so a directory event on an
+ * excluded dir itself (`unlinkDir .thumbnails`) is filtered too. The cost is that
+ * a *file* literally named `dist` at the project root reads as excluded; the walk
+ * would collect it, so it is a false negative, and no real project has one.
+ */
+declare function affectsProjectSignature(projectDir: string, changedPath: string): boolean;
 /**
  * Creates a stable preview cache-busting signature for project source plus Studio manifests.
  */
@@ -97,4 +118,4 @@ type BackgroundRemovalRender = (options: {
 }>;
 declare function createBackgroundRemovalJob(opts: BackgroundRemovalJobOptions, render: BackgroundRemovalRender): MediaProcessingJobState;
 
-export { type BackgroundRemovalRender, type FileWriteReceipt, MIME_TYPES, MediaProcessingJobState, StudioApiAdapter, type ThumbnailOutputDimensions, buildSubCompositionHtml, consumeFileWriteReceipt, createBackgroundRemovalJob, createProjectSignature, createStudioApi, fileContentVersion, getMimeType, thumbnailDeviceScaleFactor, walkDir };
+export { type BackgroundRemovalRender, type FileWriteReceipt, MIME_TYPES, MediaProcessingJobState, StudioApiAdapter, type ThumbnailOutputDimensions, affectsProjectSignature, buildSubCompositionHtml, consumeFileWriteReceipt, createBackgroundRemovalJob, createProjectSignature, createStudioApi, fileContentVersion, getMimeType, thumbnailDeviceScaleFactor, walkDir };

package/dist/index.js

@@ -85,7 +85,7 @@ function walkDir(dir, prefix = "") {
 // src/helpers/projectSignature.ts
 import { createHash } from "crypto";
 import { lstatSync, readFileSync, readdirSync as readdirSync2 } from "fs";
-import { extname, isAbsolute, relative, resolve } from "path";
+import { extname, isAbsolute, relative, resolve, sep } from "path";
 var SIGNATURE_TEXT_EXTENSIONS = /* @__PURE__ */ new Set([
   ".cjs",
   ".css",
@@ -119,6 +119,15 @@ var STUDIO_SIGNATURE_MANIFEST_PATHS = [
   ".hyperframes/studio-manual-edits.json",
   ".hyperframes/studio-motion.json"
 ];
+function affectsProjectSignature(projectDir, changedPath) {
+  const relativePath = relative(resolve(projectDir), resolve(changedPath));
+  if (relativePath === "" || relativePath.startsWith("..") || isAbsolute(relativePath)) {
+    return false;
+  }
+  const segments = relativePath.split(sep);
+  if (STUDIO_SIGNATURE_MANIFEST_PATHS.includes(segments.join("/"))) return true;
+  return !segments.some((segment) => SIGNATURE_EXCLUDED_DIRS.has(segment));
+}
 var projectSignatureCache = /* @__PURE__ */ new Map();
 function isPathWithin(parentDir, childPath) {
   const childRelativePath = relative(parentDir, childPath);
@@ -679,7 +688,7 @@ import { parseHTML as parseHTML2 } from "linkedom";
 // src/helpers/compositionInsertion.ts
 import { existsSync as existsSync3, readFileSync as readFileSync4, realpathSync } from "fs";
 import { randomUUID as randomUUID2 } from "crypto";
-import { dirname, relative as relative3, resolve as resolve2, sep } from "path";
+import { dirname, relative as relative3, resolve as resolve2, sep as sep2 } from "path";
 import { parseHTML } from "linkedom";
 var CompositionInsertionError = class extends Error {
   constructor(message, status) {
@@ -807,7 +816,7 @@ function uniqueHostId(root, base) {
   return `${base}_${suffix}`;
 }
 function relativeSourcePath(targetAbs, sourceAbs) {
-  return relative3(dirname(targetAbs), sourceAbs).split(sep).join("/");
+  return relative3(dirname(targetAbs), sourceAbs).split(sep2).join("/");
 }
 function insertCompositionIntoSource(input) {
   const targetAbs = canonicalProjectFile(input.projectDir, input.targetPath);
@@ -4912,6 +4921,7 @@ export {
   MIME_TYPES,
   STUDIO_MANUAL_EDITS_PATH,
   STUDIO_MOTION_PATH,
+  affectsProjectSignature,
   buildSubCompositionHtml,
   consumeFileWriteReceipt,
   createBackgroundRemovalJob,