@memberjunction/video-studio-render-worker 0.0.1-seed.1 → 6.2.0-edge.7

package/dist/preamble.js

@@ -0,0 +1,331 @@
+/**
+ * Strict Content-Security-Policy injected into every staged HTML file (Decision 3).
+ *
+ * Blocks all external network egress (`connect-src 'none'`, `frame-src 'none'`, `worker-src 'none'`,
+ * `object-src 'none'`, `base-uri 'none'`, `form-action 'none'`) while allowing local bundle files
+ * (`'self'`), `data:` / `blob:` URIs, and inline composition scripts/styles.
+ */
+export const COMPOSITION_CSP = [
+    "default-src 'self' data: blob:",
+    "script-src 'self' 'unsafe-inline'",
+    "style-src 'self' 'unsafe-inline'",
+    "connect-src 'none'",
+    "frame-src 'none'",
+    "worker-src 'none'",
+    "object-src 'none'",
+    "base-uri 'none'",
+    "form-action 'none'",
+].join('; ');
+/**
+ * Default SIL OFL font families bundled in the RenderWorker package (`assets/fonts/`)
+ * under `MJ Sans` (`Inter-Regular.ttf`) and `MJ Mono` (`JetBrainsMono-Regular.ttf`) so
+ * HyperFrames' font compiler never maps them to Google Fonts and compositions render
+ * deterministically offline with `FontIsBundled: true` (VS-RND-5 Decision 4 / Round 1).
+ */
+export const BUNDLED_DEFAULT_FONTS = ['MJ Sans', 'MJ Mono'];
+/**
+ * Builds the `<meta http-equiv="Content-Security-Policy">` tag injected into every `.html` file.
+ */
+export function BuildCspMetaTag() {
+    return `<meta http-equiv="Content-Security-Policy" content="${COMPOSITION_CSP}">`;
+}
+/**
+ * Builds the `<style data-mj-default-fonts>` tag registering the worker's bundled `MJ Sans`
+ * (`Inter-Regular.ttf`) and `MJ Mono` (`JetBrainsMono-Regular.ttf`) `@font-face` rules served from `/__mj_fonts/`.
+ */
+export function BuildDefaultFontsStyleTag() {
+    return [
+        '<style data-mj-default-fonts>',
+        "@font-face{font-family:'MJ Sans';src:url('/__mj_fonts/Inter-Regular.ttf') format('truetype');font-weight:100 900;font-style:normal;font-display:block;}",
+        "@font-face{font-family:'MJ Mono';src:url('/__mj_fonts/JetBrainsMono-Regular.ttf') format('truetype');font-weight:100 900;font-style:normal;font-display:block;}",
+        '</style>',
+    ].join('');
+}
+/**
+ * Escapes a JSON string for safe embedding inside an HTML `<script>` element (`<`, `>`, U+2028, U+2029).
+ */
+export function EscapeJsonForInlineScript(value) {
+    const raw = JSON.stringify(value ?? {});
+    return raw
+        .replace(/</g, '\\u003c')
+        .replace(/>/g, '\\u003e')
+        .replace(/\u2028/g, '\\u2028')
+        .replace(/\u2029/g, '\\u2029');
+}
+/**
+ * Builds the inline JavaScript source that defines a frozen `window.MJVideo: MJVideoRuntime`,
+ * replaces `Math.random` with `MJVideo.Random`, and hooks HyperFrames' `window.__hf.seek`.
+ */
+export function BuildPreambleScript(options) {
+    const safeDataJson = EscapeJsonForInlineScript(options.DataSnapshot && typeof options.DataSnapshot === 'object' ? options.DataSnapshot : {});
+    const safeSeed = Number.isFinite(options.Seed) ? Math.trunc(options.Seed) : 0;
+    const safeFormat = JSON.stringify(options.Format);
+    const safeWidth = Math.trunc(options.Width);
+    const safeHeight = Math.trunc(options.Height);
+    const safeFps = Math.trunc(options.Fps);
+    const safeDuration = typeof options.DurationSeconds === 'number' && Number.isFinite(options.DurationSeconds)
+        ? String(options.DurationSeconds)
+        : 'undefined';
+    return [
+        '(function(w) {',
+        '  "use strict";',
+        '  var window = w;',
+        '  function deepFreeze(obj) {',
+        '    if (obj === null || typeof obj !== "object" || Object.isFrozen(obj)) return obj;',
+        '    Object.freeze(obj);',
+        '    var keys = Object.keys(obj);',
+        '    for (var i = 0; i < keys.length; i++) {',
+        '      deepFreeze(obj[keys[i]]);',
+        '    }',
+        '    return obj;',
+        '  }',
+        '  function mix32(h, k) {',
+        '    h = Math.imul(h ^ (k >>> 0), 0x85ebca6b) >>> 0;',
+        '    h = Math.imul(h ^ (h >>> 13), 0xc2b2ae35) >>> 0;',
+        '    return (h ^ (h >>> 16)) >>> 0;',
+        '  }',
+        '  function hashFrameSeed(seed, timeMs) {',
+        '    return mix32((seed ^ 0x9e3779b9) >>> 0, timeMs >>> 0);',
+        '  }',
+        '  function hashNoise(seed, keys) {',
+        '    var h = (seed ^ 0x9e3779b9) >>> 0;',
+        '    for (var i = 0; i < keys.length; i++) {',
+        '      var key = String(keys[i]);',
+        '      for (var j = 0; j < key.length; j++) {',
+        '        h = mix32(h, key.charCodeAt(j));',
+        '      }',
+        '      h = mix32(h, 0xff);',
+        '    }',
+        '    var t = (h + 0x6D2B79F5) >>> 0;',
+        '    t = Math.imul(t ^ (t >>> 15), t | 1);',
+        '    t ^= t + Math.imul(t ^ (t >>> 7), t | 61);',
+        '    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;',
+        '  }',
+        `  var baseSeed = ${safeSeed};`,
+        `  var frozenData = deepFreeze(${safeDataJson});`,
+        '  var prngState = baseSeed >>> 0;',
+        '  var frameCallbacks = [];',
+        '  var dispatchSeq = 0;',
+        '  function nextRandom() {',
+        '    prngState = (prngState + 0x6D2B79F5) >>> 0;',
+        '    var t = prngState;',
+        '    t = Math.imul(t ^ (t >>> 15), t | 1);',
+        '    t ^= t + Math.imul(t ^ (t >>> 7), t | 61);',
+        '    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;',
+        '  }',
+        '  function dispatchFrame(timeSeconds) {',
+        '    dispatchSeq++;',
+        '    var safeTime = typeof timeSeconds === "number" && isFinite(timeSeconds) ? timeSeconds : 0;',
+        '    var timeMs = Math.round(safeTime * 1000);',
+        '    prngState = hashFrameSeed(baseSeed, timeMs);',
+        '    for (var i = 0; i < frameCallbacks.length; i++) {',
+        '      frameCallbacks[i](safeTime);',
+        '    }',
+        '  }',
+        '  var runtimeObj = {',
+        '    Data: frozenData,',
+        '    Seed: baseSeed,',
+        `    Format: ${safeFormat},`,
+        `    Width: ${safeWidth},`,
+        `    Height: ${safeHeight},`,
+        `    Fps: ${safeFps},`,
+        `    DurationSeconds: ${safeDuration},`,
+        '    Random: function() { return nextRandom(); },',
+        '    Noise: function() {',
+        '      var args = [];',
+        '      for (var i = 0; i < arguments.length; i++) args.push(arguments[i]);',
+        '      return hashNoise(baseSeed, args);',
+        '    },',
+        '    OnFrame: function(cb) {',
+        '      if (typeof cb === "function") {',
+        '        frameCallbacks.push(cb);',
+        '      }',
+        '      ensureCompositionTimelines();',
+        '    }',
+        '  };',
+        '  var runtime = Object.freeze(runtimeObj);',
+        '  Object.defineProperty(w, "MJVideo", {',
+        '    value: runtime,',
+        '    writable: false,',
+        '    configurable: false,',
+        '    enumerable: true',
+        '  });',
+        '  Math.random = runtime.Random;',
+        '  if (w.Math && typeof w.Math === "object") {',
+        '    w.Math.random = runtime.Random;',
+        '  }',
+        '  function createSyntheticTimeline(dur) {',
+        '    var fallbackDur = typeof runtimeObj.DurationSeconds === "number" && isFinite(runtimeObj.DurationSeconds) && runtimeObj.DurationSeconds > 0 ? runtimeObj.DurationSeconds : 5;',
+        '    var safeDur = typeof dur === "number" && isFinite(dur) && dur > 0 ? dur : fallbackDur;',
+        '    var currentTime = 0;',
+        '    var tl = {',
+        '      duration: function() { return safeDur; },',
+        '      totalDuration: function() { return safeDur; },',
+        '      time: function(t) {',
+        '        if (arguments.length > 0 && typeof t === "number" && isFinite(t)) {',
+        '          currentTime = t;',
+        '          dispatchFrame(t);',
+        '        }',
+        '        return currentTime;',
+        '      },',
+        '      totalTime: function(t) {',
+        '        if (arguments.length > 0 && typeof t === "number" && isFinite(t)) {',
+        '          currentTime = t;',
+        '          dispatchFrame(t);',
+        '          return tl;',
+        '        }',
+        '        return currentTime;',
+        '      },',
+        '      seek: function(t) {',
+        '        if (arguments.length > 0 && typeof t === "number" && isFinite(t)) {',
+        '          currentTime = t;',
+        '          dispatchFrame(t);',
+        '        }',
+        '        return tl;',
+        '      },',
+        '      progress: function(p) {',
+        '        if (arguments.length > 0 && typeof p === "number" && isFinite(p)) {',
+        '          currentTime = p * safeDur;',
+        '          dispatchFrame(currentTime);',
+        '          return tl;',
+        '        }',
+        '        return safeDur > 0 ? currentTime / safeDur : 0;',
+        '      },',
+        '      pause: function() { return tl; },',
+        '      play: function() { return tl; },',
+        '      paused: function() { return true; },',
+        '      timeScale: function() { return 1; },',
+        '      getChildren: function() { return []; }',
+        '    };',
+        '    Object.defineProperty(tl, "__mjWrapped", { value: true, enumerable: false });',
+        '    Object.defineProperty(tl, "__mjSynthetic", { value: true, enumerable: false });',
+        '    return tl;',
+        '  }',
+        '  function wrapTimeline(tl) {',
+        '    if (!tl || typeof tl !== "object" || tl.__mjWrapped) return tl;',
+        '    Object.defineProperty(tl, "__mjWrapped", { value: true, enumerable: false });',
+        '    if (typeof tl.totalTime === "function") {',
+        '      var origTotalTime = tl.totalTime;',
+        '      tl.totalTime = function(t) {',
+        '        var seqBefore = dispatchSeq;',
+        '        var res = origTotalTime.apply(this, arguments);',
+        '        if (arguments.length > 0 && typeof t === "number" && isFinite(t) && dispatchSeq === seqBefore) {',
+        '          dispatchFrame(t);',
+        '        }',
+        '        return res;',
+        '      };',
+        '    }',
+        '    if (typeof tl.seek === "function") {',
+        '      var origSeek = tl.seek;',
+        '      tl.seek = function(t) {',
+        '        var seqBefore = dispatchSeq;',
+        '        var res = origSeek.apply(this, arguments);',
+        '        if (arguments.length > 0 && typeof t === "number" && isFinite(t) && dispatchSeq === seqBefore) {',
+        '          dispatchFrame(t);',
+        '        }',
+        '        return res;',
+        '      };',
+        '    }',
+        '    return tl;',
+        '  }',
+        '  window.__timelines = window.__timelines || {};',
+        '  function ensureCompositionTimelines() {',
+        '    window.__timelines = window.__timelines || {};',
+        '    if (!w.document || typeof w.document.querySelectorAll !== "function") return;',
+        '    var hosts = w.document.querySelectorAll("[data-composition-id]");',
+        '    for (var i = 0; i < hosts.length; i++) {',
+        '      var id = hosts[i].getAttribute("data-composition-id");',
+        '      if (!id) continue;',
+        '      var durAttr = parseFloat(hosts[i].getAttribute("data-duration") || "");',
+        '      var existing = window.__timelines[id];',
+        '      var tl = existing ? wrapTimeline(existing) : createSyntheticTimeline(durAttr);',
+        '      window.__timelines[id] = tl;',
+        '    }',
+        '  }',
+        '  function wrapHfObject(hfObj) {',
+        '    if (!hfObj || typeof hfObj !== "object" || hfObj.__mjWrapped) return hfObj;',
+        '    var underlyingSeek = typeof hfObj.seek === "function" ? hfObj.seek : null;',
+        '    Object.defineProperty(hfObj, "__mjWrapped", { value: true, enumerable: false });',
+        '    Object.defineProperty(hfObj, "seek", {',
+        '      configurable: true,',
+        '      enumerable: true,',
+        '      get: function() {',
+        '        return function(t, opts) {',
+        '          ensureCompositionTimelines();',
+        '          var seqBefore = dispatchSeq;',
+        '          var res = underlyingSeek ? underlyingSeek.call(this, t, opts) : undefined;',
+        '          if (dispatchSeq === seqBefore) {',
+        '            dispatchFrame(t);',
+        '          }',
+        '          return res;',
+        '        };',
+        '      },',
+        '      set: function(fn) {',
+        '        underlyingSeek = typeof fn === "function" ? fn : null;',
+        '      }',
+        '    });',
+        '    return hfObj;',
+        '  }',
+        '  var currentHf = wrapHfObject(w.__hf || {});',
+        '  Object.defineProperty(w, "__hf", {',
+        '    configurable: true,',
+        '    enumerable: true,',
+        '    get: function() { return currentHf; },',
+        '    set: function(nextHf) {',
+        '      ensureCompositionTimelines();',
+        '      currentHf = wrapHfObject(nextHf || {});',
+        '    }',
+        '  });',
+        '  if (typeof w.document !== "undefined" && typeof w.document.addEventListener === "function") {',
+        '    w.document.addEventListener("DOMContentLoaded", function() {',
+        '      ensureCompositionTimelines();',
+        '    });',
+        '  }',
+        '})(typeof window !== "undefined" ? window : globalThis);',
+    ].join('\n');
+}
+/**
+ * Injects the CSP `<meta>` tag, bundled default `@font-face` `<style>`, and the `window.MJVideo`
+ * inline `<script>` right after `<!doctype ...>` (or at byte 0 when no doctype is present).
+ * The preamble is collapsed onto a single line so line numbers in staged HTML remain unchanged.
+ */
+export function InjectPreambleIntoHtml(html, options) {
+    const metaTag = BuildCspMetaTag();
+    const fontsStyleTag = BuildDefaultFontsStyleTag();
+    const singleLineScript = BuildPreambleScript(options).replace(/\n\s*/g, ' ');
+    const scriptTag = `<script>${singleLineScript}</script>`;
+    const preamble = `${metaTag}${fontsStyleTag}${scriptTag}`;
+    const doctypeMatch = /^\s*<!doctype[^>]*>/i.exec(html);
+    if (doctypeMatch) {
+        const insertAt = doctypeMatch[0].length;
+        return `${html.slice(0, insertAt)}${preamble}${html.slice(insertAt)}`;
+    }
+    return `${preamble}${html}`;
+}
+/**
+ * Convenience helper constructing `PreambleRuntimeOptions` from a `RenderProjectBundle` plus frame geometry.
+ */
+export function BuildPreambleOptionsFromBundle(bundle, geometry) {
+    const defaults = defaultGeometryForFormat(bundle.Format);
+    return {
+        DataSnapshot: bundle.DataSnapshot ?? {},
+        Seed: bundle.Seed,
+        Format: bundle.Format,
+        Width: geometry?.Width ?? defaults.Width,
+        Height: geometry?.Height ?? defaults.Height,
+        Fps: geometry?.Fps ?? 30,
+        DurationSeconds: geometry?.DurationSeconds,
+    };
+}
+function defaultGeometryForFormat(format) {
+    switch (format) {
+        case '9:16':
+            return { Width: 1080, Height: 1920 };
+        case '1:1':
+            return { Width: 1080, Height: 1080 };
+        case '16:9':
+        default:
+            return { Width: 1920, Height: 1080 };
+    }
+}
+//# sourceMappingURL=preamble.js.map

package/dist/preamble.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,75 @@
+import * as http from 'node:http';
+import { type RenderBackend } from './backend.js';
+/** Default bind host for the render worker HTTP server. */
+export declare const DEFAULT_HOST = "127.0.0.1";
+/** Default bind port (`0` selects an ephemeral OS-assigned port). */
+export declare const DEFAULT_PORT = 0;
+/** Default maximum JSON request body size in megabytes (256 MiB). */
+export declare const DEFAULT_MAX_BODY_MB = 256;
+/** Default maximum JSON request body size in bytes (256 MiB). */
+export declare const DEFAULT_MAX_BODY_BYTES: number;
+/** Default maximum concurrent jobs (`/check`, `/render`, `/stills`, `/contact-sheet`, `/keyframes`). */
+export declare const DEFAULT_CONCURRENCY = 1;
+/** Default per-job timeout ceiling (30 minutes). */
+export declare const DEFAULT_MAX_TIMEOUT_MS: number;
+/** Default timeout for non-render jobs (`/check`, `/stills`, `/contact-sheet`, `/keyframes`, pre-render lint) (5 minutes). */
+export declare const DEFAULT_NON_RENDER_TIMEOUT_MS: number;
+/** Default heartbeat interval for streaming `/render` responses (15 seconds). */
+export declare const DEFAULT_HEARTBEAT_MS = 15000;
+/** Default TTL for unfetched rendered MP4 buffers in the video store (10 minutes). */
+export declare const DEFAULT_VIDEO_TTL_MS: number;
+/**
+ * Configuration options for `CreateRenderWorkerServer`.
+ */
+export interface RenderWorkerServerOptions {
+    /** Rendering backend (`FakeRenderBackend` in unit tests, `HyperFramesRenderBackend` in production). */
+    Backend: RenderBackend;
+    /** Default bind host when `Listen()` is called without an explicit host (defaults to `'127.0.0.1'`). */
+    Host?: string;
+    /** Default bind port when `Listen()` is called without an explicit port (defaults to `0`). */
+    Port?: number;
+    /** Optional bearer token required on every route (including `GET /health`). */
+    Token?: string;
+    /** Alias for `Token` (optional bearer token required on every route including `GET /health`). */
+    BearerToken?: string;
+    /** Maximum request body size in megabytes (defaults to 256 MiB). */
+    MaxBodyMb?: number;
+    /** Maximum request body size in bytes (if set, overrides `MaxBodyMb`). */
+    MaxBodyBytes?: number;
+    /** Maximum concurrent render/check/capture jobs (defaults to 1). */
+    Concurrency?: number;
+    /** Maximum timeout in milliseconds per job (defaults to 1,800,000 ms / 30 min). */
+    MaxTimeoutMs?: number;
+    /** Default timeout in milliseconds for non-render jobs and pre-render lint (defaults to 300,000 ms / 5 min). */
+    NonRenderTimeoutMs?: number;
+    /** Base directory for temporary bundle staging and keyframe extraction (defaults to `os.tmpdir()`). */
+    TempRoot?: string;
+    /** Interval in milliseconds for `Heartbeat` NDJSON events on `/render` (defaults to 15,000 ms). */
+    HeartbeatIntervalMs?: number;
+    /** TTL in milliseconds for unfetched MP4 entries in `/videos/<VideoID>` (defaults to 600,000 ms). */
+    VideoTtlMs?: number;
+}
+/**
+ * Running HTTP render worker server handle returned by `CreateRenderWorkerServer`.
+ */
+export interface RenderWorkerServer {
+    /** Underlying Node `http.Server`. */
+    readonly HttpServer: http.Server;
+    /** Bound TCP port after `Listen` resolves (`0` before listening). */
+    readonly Port: number;
+    /** Starts listening on `host` and `port` (defaults to `options.Host ?? '127.0.0.1'` and `options.Port ?? 0`). */
+    Listen(port?: number, host?: string): Promise<number>;
+    /** Aborts in-flight jobs, clears the video store, and closes the HTTP server. */
+    Close(): Promise<void>;
+}
+/**
+ * Returns `true` when `host` is a loopback address (`127.0.0.1`, `::1`, `::ffff:127.0.0.1`, or `localhost`).
+ */
+export declare function IsLoopbackHost(host: string): boolean;
+/**
+ * Creates an HTTP server implementing all `RENDER_WORKER_ROUTES`.
+ *
+ * Notice that this module does NOT import `hyperframes-backend.ts`; callers inject `Backend`.
+ */
+export declare function CreateRenderWorkerServer(options: RenderWorkerServerOptions): RenderWorkerServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAclC,OAAO,EAEH,KAAK,aAAa,EACrB,MAAM,cAAc,CAAC;AAetB,2DAA2D;AAC3D,eAAO,MAAM,YAAY,cAAc,CAAC;AAExC,qEAAqE;AACrE,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,qEAAqE;AACrE,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,QAAoC,CAAC;AAExE,wGAAwG;AACxG,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,QAAiB,CAAC;AAErD,8HAA8H;AAC9H,eAAO,MAAM,6BAA6B,QAAgB,CAAC;AAE3D,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C,sFAAsF;AACtF,eAAO,MAAM,oBAAoB,QAAiB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,uGAAuG;IACvG,OAAO,EAAE,aAAa,CAAC;IACvB,wGAAwG;IACxG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iGAAiG;IACjG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gHAAgH;IAChH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uGAAuG;IACvG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qGAAqG;IACrG,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;IACjC,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iHAAiH;IACjH,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,iFAAiF;IACjF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAOD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQpD;AAUD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAoc/F"}