@hyperframes/producer 0.4.16 → 0.4.17

package/dist/logger.d.ts

@@ -13,6 +13,25 @@ export interface ProducerLogger {
     warn(message: string, meta?: Record<string, unknown>): void;
     info(message: string, meta?: Record<string, unknown>): void;
     debug(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Optional fast level check used to skip expensive metadata construction
+     * at the call site. When the call site needs to build a non-trivial meta
+     * object (e.g. snapshot a struct, format numbers, run `Array.find` over
+     * scene state) just to attach to a debug log, gate it with this method:
+     *
+     * ```ts
+     * if (log.isLevelEnabled?.("debug") ?? true) {
+     *   const meta = buildExpensiveMeta();
+     *   log.debug("hot-path event", meta);
+     * }
+     * ```
+     *
+     * The default coalescence (`?? true`) preserves today's behavior for
+     * loggers that omit this method — they keep building the meta object as
+     * before. Custom integrations (Pino, Winston, structured loggers) should
+     * implement this to enable the optimization.
+     */
+    isLevelEnabled?(level: LogLevel): boolean;
 }
 /**
  * Create a console-based logger with level filtering.

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9D;AASD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,GAAE,QAAiB,GAAG,cAAc,CA8B5E;AAED,gDAAgD;AAChD,eAAO,MAAM,aAAa,EAAE,cAA4C,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE7D;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,CAAC,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC3C;AASD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,GAAE,QAAiB,GAAG,cAAc,CAiC5E;AAED,gDAAgD;AAChD,eAAO,MAAM,aAAa,EAAE,cAA4C,CAAC"}

package/dist/public-server.js

@@ -109666,6 +109666,9 @@ function createConsoleLogger(level = "info") {
       if (shouldLog("debug")) {
         console.log(`[DEBUG] ${message}${formatMeta(meta)}`);
       }
+    },
+    isLevelEnabled(msgLevel) {
+      return shouldLog(msgLevel);
     }
   };
 }
@@ -110147,6 +110150,19 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
   const enableChunkedEncode = cfg.enableChunkedEncode;
   const chunkedEncodeSize = cfg.chunkSizeFrames;
   const enableStreamingEncode = cfg.enableStreamingEncode;
+  let peakRssBytes = 0;
+  let peakHeapUsedBytes = 0;
+  const sampleMemory = () => {
+    try {
+      const m = process.memoryUsage();
+      if (m.rss > peakRssBytes) peakRssBytes = m.rss;
+      if (m.heapUsed > peakHeapUsedBytes) peakHeapUsedBytes = m.heapUsed;
+    } catch {
+    }
+  };
+  sampleMemory();
+  const memSamplerInterval = setInterval(sampleMemory, 250);
+  memSamplerInterval.unref?.();
   try {
     const assertNotAborted = () => {
       if (abortSignal?.aborted) {
@@ -110850,7 +110866,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
             const activeTransition = transitionRanges.find(
               (t) => i >= t.startFrame && i <= t.endFrame
             );
-            if (i % 30 === 0) {
+            if (i % 30 === 0 && (log.isLevelEnabled?.("debug") ?? true)) {
               const hdrEl = stackingInfo.find((e) => e.isHdr);
               log.debug("[Render] HDR layer composite frame", {
                 frame: i,
@@ -111293,6 +111309,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     job.outputPath = outputPath;
     updateJobStatus(job, "complete", "Render complete", 100, onProgress);
     const totalElapsed = Date.now() - pipelineStart;
+    sampleMemory();
     const perfSummary = {
       renderId: job.id,
       totalElapsedMs: totalElapsed,
@@ -111308,7 +111325,9 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       audioCount: composition.audios.length,
       stages: perfStages,
       hdrDiagnostics: hdrDiagnostics.videoExtractionFailures > 0 || hdrDiagnostics.imageDecodeFailures > 0 ? { ...hdrDiagnostics } : void 0,
-      captureAvgMs: totalFrames > 0 ? Math.round((perfStages.captureMs ?? 0) / totalFrames) : void 0
+      captureAvgMs: totalFrames > 0 ? Math.round((perfStages.captureMs ?? 0) / totalFrames) : void 0,
+      peakRssMb: Math.round(peakRssBytes / (1024 * 1024)),
+      peakHeapUsedMb: Math.round(peakHeapUsedBytes / (1024 * 1024))
     };
     job.perfSummary = perfSummary;
     if (job.config.debug) {
@@ -111416,6 +111435,8 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     }
     if (restoreLogger) restoreLogger();
     throw error;
+  } finally {
+    clearInterval(memSamplerInterval);
   }
 }