@remotion/studio-server 4.0.503 → 4.0.504

package/dist/helpers/open-in-editor.d.ts

@@ -11,6 +11,7 @@ export type ProcessAndCommand = {
     process: string;
     command: Editor;
 };
+export declare const findMacOsEditorsFromProcessOutput: (output: string) => ProcessAndCommand[];
 export declare function guessEditor(): Promise<ProcessAndCommand[]>;
 export declare function launchEditor({ colNumber, editor, fileName, lineNumber, vsCodeNewWindow, logLevel }: {
     fileName: string;

package/dist/helpers/open-in-editor.js

@@ -37,7 +37,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDisplayNameForEditor = void 0;
+exports.findMacOsEditorsFromProcessOutput = exports.getDisplayNameForEditor = void 0;
 exports.guessEditor = guessEditor;
 exports.launchEditor = launchEditor;
 const node_child_process_1 = __importStar(require("node:child_process"));
@@ -167,6 +167,7 @@ const COMMON_EDITORS_OSX = {
     '/Applications/Sublime Text.app/Contents/MacOS/Sublime Text': '/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl',
     '/Applications/Sublime Text Dev.app/Contents/MacOS/Sublime Text': '/Applications/Sublime Text Dev.app/Contents/SharedSupport/bin/subl',
     '/Applications/Sublime Text 2.app/Contents/MacOS/Sublime Text 2': '/Applications/Sublime Text 2.app/Contents/SharedSupport/bin/subl',
+    '/Applications/Visual Studio Code.app/Contents/MacOS/Code': 'code',
     '/Applications/Visual Studio Code.app/Contents/MacOS/Electron': 'code',
     '/Applications/Visual Studio Code - Insiders.app/Contents/MacOS/Electron': 'code-insiders',
     '/Applications/VSCodium.app/Contents/MacOS/Electron': 'vscodium',
@@ -323,6 +324,21 @@ function getArgumentsForLineNumber(editor, fileName, lineNumber, colNumber) {
             return [fileName];
     }
 }
+const findMacOsEditorsFromProcessOutput = (output) => {
+    const availableEditors = [];
+    const processNames = Object.keys(COMMON_EDITORS_OSX);
+    for (let i = 0; i < processNames.length; i++) {
+        const processName = processNames[i];
+        if (output.includes(processName)) {
+            availableEditors.push({
+                process: processName,
+                command: COMMON_EDITORS_OSX[processName],
+            });
+        }
+    }
+    return availableEditors;
+};
+exports.findMacOsEditorsFromProcessOutput = findMacOsEditorsFromProcessOutput;
 async function guessEditor() {
     // We can find out which editor is currently running by:
     // `ps x` on macOS and Linux
@@ -331,17 +347,7 @@ async function guessEditor() {
     try {
         if (process.platform === 'darwin') {
             const output = (await execProm('ps x')).stdout.toString();
-            const processNames = Object.keys(COMMON_EDITORS_OSX);
-            for (let i = 0; i < processNames.length; i++) {
-                const processName = processNames[i];
-                if (output.indexOf(processName) !== -1) {
-                    availableEditors.push({
-                        process: processName,
-                        command: COMMON_EDITORS_OSX[processName],
-                    });
-                }
-            }
-            return availableEditors;
+            return (0, exports.findMacOsEditorsFromProcessOutput)(output);
         }
         if (process.platform === 'win32') {
             // Some processes need elevated rights to get its executable path.

package/dist/preview-server/element-install-state.d.ts

@@ -11,23 +11,27 @@ export type ElementInstallTarget = {
     studioUrl: string;
     updatedAt: number;
 };
+export type StudioProtocolTargetPurpose = 'install-element' | 'set-license-key';
 type StudioProtocolTarget = {
     readonly id: string;
     readonly origin: string;
+    readonly purpose: StudioProtocolTargetPurpose;
     readonly target: ElementInstallTarget;
     readonly expiresAt: number;
 };
 export declare const updateElementInstallTarget: (newTarget: Omit<ElementInstallTarget, "updatedAt">) => void;
 export declare const getElementInstallTargetByClientId: (clientId: string) => ElementInstallTarget | null;
 export declare const getElementInstallTarget: (requestId: string | null) => ElementInstallTarget | null;
-export declare const issueStudioProtocolTarget: ({ now, origin, target, }: {
+export declare const issueStudioProtocolTarget: ({ now, origin, purpose, target, }: {
     readonly now: number;
     readonly origin: string;
+    readonly purpose: StudioProtocolTargetPurpose;
     readonly target: ElementInstallTarget;
 }) => StudioProtocolTarget;
-export declare const consumeStudioProtocolTarget: ({ now, origin, targetId, }: {
+export declare const consumeStudioProtocolTarget: ({ now, origin, purpose, targetId, }: {
     readonly now: number;
     readonly origin: string;
+    readonly purpose: StudioProtocolTargetPurpose;
     readonly targetId: string;
 }) => ElementInstallTarget | null;
 export declare const clearElementInstallStateForTests: () => void;

package/dist/preview-server/element-install-state.js

@@ -45,7 +45,7 @@ const getElementInstallTarget = (requestId) => {
     return bestTarget;
 };
 exports.getElementInstallTarget = getElementInstallTarget;
-const issueStudioProtocolTarget = ({ now, origin, target, }) => {
+const issueStudioProtocolTarget = ({ now, origin, purpose, target, }) => {
     for (const [id, existing] of studioProtocolTargets) {
         if (existing.expiresAt <= now) {
             studioProtocolTargets.delete(id);
@@ -54,6 +54,7 @@ const issueStudioProtocolTarget = ({ now, origin, target, }) => {
     const issued = {
         id: (0, node_crypto_1.randomUUID)(),
         origin,
+        purpose,
         target: { ...target },
         expiresAt: now + exports.STUDIO_PROTOCOL_TARGET_MAX_AGE,
     };
@@ -61,19 +62,25 @@ const issueStudioProtocolTarget = ({ now, origin, target, }) => {
     return issued;
 };
 exports.issueStudioProtocolTarget = issueStudioProtocolTarget;
-const consumeStudioProtocolTarget = ({ now, origin, targetId, }) => {
+const consumeStudioProtocolTarget = ({ now, origin, purpose, targetId, }) => {
     const issued = studioProtocolTargets.get(targetId);
     studioProtocolTargets.delete(targetId);
     if (issued === undefined ||
         issued.expiresAt <= now ||
-        issued.origin !== origin) {
+        issued.origin !== origin ||
+        issued.purpose !== purpose) {
         return null;
     }
     const current = (0, exports.getElementInstallTargetByClientId)(issued.target.clientId);
     if (current === null ||
         now - current.updatedAt >= exports.ELEMENT_INSTALL_TARGET_MAX_AGE ||
-        !current.canInstall ||
-        current.readOnly ||
+        current.readOnly) {
+        return null;
+    }
+    if (purpose === 'set-license-key') {
+        return issued.target;
+    }
+    if (!current.canInstall ||
         current.compositionFile !== issued.target.compositionFile ||
         current.compositionId !== issued.target.compositionId) {
         return null;

package/dist/preview-server/routes/element-install-plan.d.ts

@@ -3,7 +3,8 @@ export declare const normalizeElementSourceForComparison: (source: string) => st
 export declare const getElementSourceHash: (source: string) => string;
 export declare const validateElementInstallPosition: (position: import("@remotion/studio-shared").InsertableCompositionElementPosition | null) => void;
 export declare const validateElementForInstallation: (element: {
-    dependencies: string[];
+    dependencies: import("@remotion/studio-protocol").ElementDependency[];
+    durationInFrames?: number | undefined;
     slug: string;
     displayName: string;
     sourceCode: string;

package/dist/preview-server/routes/insert-element.js

@@ -22,6 +22,7 @@ const hasExpectedFileState = ({ expected, actual, }) => {
     return actual.sourceHash === expected.sourceHash;
 };
 const insertElementHandler = ({ input: { compositionFile, compositionId, element, expectedFileState, from, position, overwriteExisting, }, remotionRoot, logLevel, }) => (0, source_file_write_queue_1.withSourceFileWriteQueue)(async () => {
+    var _a;
     try {
         (0, element_install_plan_1.validateElementInstallPosition)(position);
         if (from !== null &&
@@ -87,6 +88,7 @@ const insertElementHandler = ({ input: { compositionFile, compositionId, element
             prettierConfigOverride: null,
             wrapInSequence: {
                 dimensions: element.dimensions,
+                durationInFrames: (_a = element.durationInFrames) !== null && _a !== void 0 ? _a : null,
                 from,
                 name: element.displayName,
                 position,

package/dist/preview-server/routes/install-dependency.d.ts

@@ -1,4 +1,5 @@
+import type { ElementDependency } from '@remotion/studio-protocol';
 import { type InstallPackageRequest, type InstallPackageResponse } from '@remotion/studio-shared';
 import type { ApiHandler } from '../api-types';
-export declare const getPackageInstallSpec: (packageName: string) => string;
+export declare const getPackageInstallSpec: (dependency: string | ElementDependency) => string;
 export declare const handleInstallPackage: ApiHandler<InstallPackageRequest, InstallPackageResponse>;

package/dist/preview-server/routes/install-dependency.js

@@ -12,21 +12,26 @@ const getExtraPackageVersion = (packageName) => {
     const pkg = studio_shared_1.extraPackages.find((p) => p.name === packageName);
     return pkg ? pkg.version : null;
 };
-const getPackageInstallSpec = (packageName) => {
-    const extraVersion = getExtraPackageVersion(packageName);
-    if (extraVersion) {
-        return `${packageName}@${extraVersion}`;
-    }
-    if (packageName === 'remotion' || packageName.startsWith('@remotion/')) {
-        return `${packageName}@${version_1.VERSION}`;
-    }
-    return packageName;
+const getPackageInstallSpec = (dependency) => {
+    const { name, version } = typeof dependency === 'string'
+        ? { name: dependency, version: null }
+        : dependency;
+    const extraVersion = getExtraPackageVersion(name);
+    if (extraVersion)
+        return `${name}@${extraVersion}`;
+    if (name === 'remotion' || name.startsWith('@remotion/'))
+        return `${name}@${version_1.VERSION}`;
+    return version === null ? name : `${name}@${version}`;
 };
 exports.getPackageInstallSpec = getPackageInstallSpec;
-const handleInstallPackage = async ({ logLevel, remotionRoot, input: { packageNames } }) => {
-    for (const packageName of packageNames) {
-        if (!(0, studio_shared_1.isValidPackageName)(packageName)) {
-            return Promise.reject(new Error(`Package name ${JSON.stringify(packageName)} is invalid.`));
+const handleInstallPackage = async ({ logLevel, remotionRoot, input: { dependencies } }) => {
+    for (const dependency of dependencies) {
+        if (!(0, studio_shared_1.isValidPackageName)(dependency.name)) {
+            return Promise.reject(new Error(`Package name ${JSON.stringify(dependency.name)} is invalid.`));
+        }
+        if (dependency.version !== null &&
+            !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(dependency.version)) {
+            return Promise.reject(new Error(`Package version ${JSON.stringify(dependency.version)} is invalid.`));
         }
     }
     const manager = (0, get_package_manager_1.getPackageManager)({
@@ -36,13 +41,9 @@ const handleInstallPackage = async ({ logLevel, remotionRoot, input: { packageNa
         logLevel,
     });
     if (manager === 'unknown') {
-        throw new Error(`No lockfile was found in your project (one of ${get_package_manager_1.lockFilePaths
-            .map((p) => p.path)
-            .join(', ')}). Install dependencies using your favorite manager!`);
+        throw new Error(`No lockfile was found in your project (one of ${get_package_manager_1.lockFilePaths.map((p) => p.path).join(', ')}). Install dependencies using your favorite manager!`);
     }
-    // Remotion packages must match the Studio version and catalogued extra
-    // packages use their supported version. Other packages resolve normally.
-    const packagesWithVersions = packageNames.map(exports.getPackageInstallSpec);
+    const packagesWithVersions = dependencies.map(exports.getPackageInstallSpec);
     const command = (0, install_command_1.getInstallCommand)({
         manager: manager.manager,
         packages: packagesWithVersions,
@@ -54,34 +55,22 @@ const handleInstallPackage = async ({ logLevel, remotionRoot, input: { packageNa
     try {
         await new Promise((resolve, reject) => {
             const cmd = (0, node_child_process_1.spawn)(manager.manager, command, (0, package_manager_spawn_options_1.getPackageManagerSpawnOptions)());
-            cmd.on('error', (err) => {
-                reject(err);
-            });
-            cmd.stdout.on('data', (d) => {
-                const splitted = d.toString().trim().split('\n');
-                splitted.forEach((line) => {
-                    renderer_1.RenderInternals.Log.info({ indent: true, logLevel }, line);
-                });
-            });
-            cmd.stdout.on('end', () => {
-                resolve();
-            });
-            cmd.on('close', (code, signal) => {
-                if (code === 0) {
-                    resolve();
-                }
-                else {
-                    reject(new Error(`Command exited with code ${code} and signal ${signal}`));
-                }
-            });
+            cmd.on('error', reject);
+            cmd.stdout.on('data', (d) => d
+                .toString()
+                .trim()
+                .split('\n')
+                .forEach((line) => renderer_1.RenderInternals.Log.info({ indent: true, logLevel }, line)));
+            cmd.stdout.on('end', resolve);
+            cmd.on('close', (code, signal) => code === 0
+                ? resolve()
+                : reject(new Error(`Command exited with code ${code} and signal ${signal}`)));
         });
-        const timeEnd = Date.now();
-        renderer_1.RenderInternals.Log.info({ indent: false, logLevel }, renderer_1.RenderInternals.chalk.gray('╰─ '), `Done in ${timeEnd - time}ms`);
-        return Promise.resolve({});
+        renderer_1.RenderInternals.Log.info({ indent: false, logLevel }, renderer_1.RenderInternals.chalk.gray('╰─ '), `Done in ${Date.now() - time}ms`);
+        return {};
     }
     catch (err) {
-        const timeEnd = Date.now();
-        renderer_1.RenderInternals.Log.info({ indent: false, logLevel }, renderer_1.RenderInternals.chalk.gray('╰─ '), renderer_1.RenderInternals.chalk.red(`Errored in ${timeEnd - time}ms`));
+        renderer_1.RenderInternals.Log.info({ indent: false, logLevel }, renderer_1.RenderInternals.chalk.gray('╰─ '), renderer_1.RenderInternals.chalk.red(`Errored in ${Date.now() - time}ms`));
         return Promise.reject(err);
     }
 };

package/dist/preview-server/routes/update-public-license.d.ts

@@ -4,4 +4,8 @@ export declare const updatePublicLicenseInConfig: ({ configContents, publicLicen
     configContents: string;
     publicLicenseKey: string;
 }) => string;
+export declare const setPublicLicenseKeyInConfigFile: ({ configFile, publicLicenseKey, }: {
+    readonly configFile: string;
+    readonly publicLicenseKey: string;
+}) => void;
 export declare const updatePublicLicenseHandler: ApiHandler<UpdatePublicLicenseRequest, UpdatePublicLicenseResponse>;

package/dist/preview-server/routes/update-public-license.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.updatePublicLicenseHandler = exports.updatePublicLicenseInConfig = void 0;
+exports.updatePublicLicenseHandler = exports.setPublicLicenseKeyInConfigFile = exports.updatePublicLicenseInConfig = void 0;
 const node_fs_1 = require("node:fs");
 const recast = __importStar(require("recast"));
 const parse_ast_1 = require("../../codemods/parse-ast");
@@ -70,6 +70,11 @@ const updatePublicLicenseInConfig = ({ configContents, publicLicenseKey, }) => {
     return `${configWithoutExistingCalls}${separator}Config.setPublicLicenseKey('${escapedPublicLicenseKey}');\n`;
 };
 exports.updatePublicLicenseInConfig = updatePublicLicenseInConfig;
+const setPublicLicenseKeyInConfigFile = ({ configFile, publicLicenseKey, }) => {
+    const configContents = (0, node_fs_1.readFileSync)(configFile, 'utf8');
+    (0, file_watcher_1.writeFileAndNotifyFileWatchers)(configFile, (0, exports.updatePublicLicenseInConfig)({ configContents, publicLicenseKey }), undefined);
+};
+exports.setPublicLicenseKeyInConfigFile = setPublicLicenseKeyInConfigFile;
 const updatePublicLicenseHandler = ({ input, configFile }) => {
     if (configFile === null || configFile === undefined) {
         return Promise.resolve({
@@ -83,11 +88,10 @@ const updatePublicLicenseHandler = ({ input, configFile }) => {
             reason: 'The public license key must not be empty.',
         });
     }
-    const configContents = (0, node_fs_1.readFileSync)(configFile, 'utf8');
-    (0, file_watcher_1.writeFileAndNotifyFileWatchers)(configFile, (0, exports.updatePublicLicenseInConfig)({
-        configContents,
+    (0, exports.setPublicLicenseKeyInConfigFile)({
+        configFile,
         publicLicenseKey: input.publicLicenseKey,
-    }), undefined);
+    });
     return Promise.resolve({ success: true });
 };
 exports.updatePublicLicenseHandler = updatePublicLicenseHandler;

package/dist/preview-server/studio-protocol/handle-discovery.js

@@ -10,7 +10,7 @@ const version_1 = require("remotion/version");
 const element_install_state_1 = require("../element-install-state");
 const origin_policy_1 = require("./origin-policy");
 const protocol_response_1 = require("./protocol-response");
-const ELEMENT_INSTALL_FOCUS_MAX_AGE = 5 * 60 * 1000;
+const STUDIO_PROTOCOL_FOCUS_MAX_AGE = 5 * 60 * 1000;
 exports.ELEMENT_INSTALL_TARGET_RESPONSE_WAIT = 250;
 const requestInstallTarget = ({ liveEventsServer, }) => {
     const requestId = `${Date.now()}-${Math.random().toString(16).slice(2)}`;
@@ -20,28 +20,30 @@ const requestInstallTarget = ({ liveEventsServer, }) => {
     });
     return requestId;
 };
-const getLiveInstallableTarget = (requestId) => {
+const getLiveStudioTarget = (requestId) => {
     const target = (0, element_install_state_1.getElementInstallTarget)(requestId);
     const now = Date.now();
     if (target === null ||
         now - target.updatedAt >= element_install_state_1.ELEMENT_INSTALL_TARGET_MAX_AGE ||
         target.lastFocusedAt === null ||
-        now - target.lastFocusedAt >= ELEMENT_INSTALL_FOCUS_MAX_AGE ||
-        !target.canInstall ||
-        target.readOnly ||
-        target.compositionFile === null ||
-        target.compositionId === null) {
+        now - target.lastFocusedAt >= STUDIO_PROTOCOL_FOCUS_MAX_AGE ||
+        target.readOnly) {
         return null;
     }
     return target;
 };
+const isInstallableTarget = (target) => target !== null &&
+    target.canInstall &&
+    target.compositionFile !== null &&
+    target.compositionId !== null &&
+    target.lastFocusedAt !== null;
 const getProject = ({ gitSource, remotionRoot, }) => (0, studio_shared_1.getProjectName)({
     basename: node_path_1.default.basename,
     gitSource,
     resolvedRemotionRoot: remotionRoot,
 });
 const handleStudioProtocolDiscovery = ({ gitSource, liveEventsServer, remotionRoot, request, response, }) => {
-    (0, origin_policy_1.setStudioProtocolCorsHeaders)({ request, response });
+    (0, origin_policy_1.setStudioProtocolCorsHeaders)({ licenseKey: false, request, response });
     const requestOrigin = (0, origin_policy_1.getAllowedStudioProtocolOrigin)(request.headers.origin);
     if (requestOrigin === null) {
         (0, protocol_response_1.writeStudioProtocolError)({
@@ -65,12 +67,23 @@ const handleStudioProtocolDiscovery = ({ gitSource, liveEventsServer, remotionRo
     return new Promise((resolve) => {
         setTimeout(() => {
             const now = Date.now();
-            const target = getLiveInstallableTarget(requestId);
-            const issued = target === null
+            const target = getLiveStudioTarget(requestId);
+            const installTarget = isInstallableTarget(target) ? target : null;
+            const issuedInstallTarget = installTarget === null
                 ? null
                 : (0, element_install_state_1.issueStudioProtocolTarget)({
                     now,
                     origin: requestOrigin,
+                    purpose: 'install-element',
+                    target: installTarget,
+                });
+            const licenseKeyOrigin = (0, origin_policy_1.getAllowedLicenseKeyOrigin)(request.headers.origin);
+            const issuedLicenseKeyTarget = target === null || licenseKeyOrigin === null
+                ? null
+                : (0, element_install_state_1.issueStudioProtocolTarget)({
+                    now,
+                    origin: licenseKeyOrigin,
+                    purpose: 'set-license-key',
                     target,
                 });
             response.writeHead(200, {
@@ -81,23 +94,34 @@ const handleStudioProtocolDiscovery = ({ gitSource, liveEventsServer, remotionRo
                 protocol: 'remotion-studio-protocol',
                 protocolVersion: 1,
                 studioVersion: version_1.VERSION,
-                capabilities: {
-                    install: [
-                        {
-                            payloadType: 'remotion-element',
-                            payloadVersions: [1],
-                        },
-                    ],
-                },
                 projectName: getProject({ gitSource, remotionRoot }),
-                installTarget: issued === null || target === null
-                    ? null
-                    : {
-                        id: issued.id,
-                        expiresAt: issued.expiresAt,
-                        compositionId: target.compositionId,
-                        lastFocusedAt: target.lastFocusedAt,
+                capabilities: [
+                    {
+                        type: 'install-element',
+                        payloadType: 'remotion-element',
+                        payloadVersions: [1],
+                        target: issuedInstallTarget === null || installTarget === null
+                            ? null
+                            : {
+                                id: issuedInstallTarget.id,
+                                expiresAt: issuedInstallTarget.expiresAt,
+                                compositionId: installTarget.compositionId,
+                                lastFocusedAt: installTarget.lastFocusedAt,
+                            },
+                    },
+                    {
+                        type: 'set-license-key',
+                        target: issuedLicenseKeyTarget === null ||
+                            target === null ||
+                            target.lastFocusedAt === null
+                            ? null
+                            : {
+                                id: issuedLicenseKeyTarget.id,
+                                expiresAt: issuedLicenseKeyTarget.expiresAt,
+                                lastFocusedAt: target.lastFocusedAt,
+                            },
                     },
+                ],
             }));
             resolve();
         }, exports.ELEMENT_INSTALL_TARGET_RESPONSE_WAIT);

package/dist/preview-server/studio-protocol/handle-install.js

@@ -8,6 +8,7 @@ const parse_body_1 = require("../parse-body");
 const origin_policy_1 = require("./origin-policy");
 const protocol_response_1 = require("./protocol-response");
 const studioProtocolInstallRequestSchema = zod_1.z.object({
+    operation: zod_1.z.literal('install-element'),
     protocol: zod_1.z.literal('remotion-studio-protocol'),
     protocolVersion: zod_1.z.literal(1),
     targetId: zod_1.z.string(),
@@ -44,7 +45,7 @@ const deliverElementInstall = ({ element, focusStudioTab, liveEventsServer, orig
     return delivered;
 };
 const handleStudioProtocolInstall = async ({ focusStudioTab, liveEventsServer, request, response, }) => {
-    (0, origin_policy_1.setStudioProtocolCorsHeaders)({ request, response });
+    (0, origin_policy_1.setStudioProtocolCorsHeaders)({ licenseKey: false, request, response });
     const requestOrigin = (0, origin_policy_1.getAllowedStudioProtocolOrigin)(request.headers.origin);
     if (requestOrigin === null) {
         (0, protocol_response_1.writeStudioProtocolError)({
@@ -111,6 +112,7 @@ const handleStudioProtocolInstall = async ({ focusStudioTab, liveEventsServer, r
     const target = (0, element_install_state_1.consumeStudioProtocolTarget)({
         now: Date.now(),
         origin: requestOrigin,
+        purpose: 'install-element',
         targetId: parsedRequest.data.targetId,
     });
     if (target === null) {

package/dist/preview-server/studio-protocol/handle-license-key.d.ts

@@ -0,0 +1,6 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+export declare const handleStudioProtocolLicenseKey: ({ configFile, request, response, }: {
+    readonly configFile: string | null;
+    readonly request: IncomingMessage;
+    readonly response: ServerResponse<IncomingMessage>;
+}) => Promise<void>;

package/dist/preview-server/studio-protocol/handle-license-key.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleStudioProtocolLicenseKey = void 0;
+const studio_protocol_1 = require("@remotion/studio-protocol");
+const zod_1 = require("zod");
+const element_install_state_1 = require("../element-install-state");
+const parse_body_1 = require("../parse-body");
+const update_public_license_1 = require("../routes/update-public-license");
+const origin_policy_1 = require("./origin-policy");
+const protocol_response_1 = require("./protocol-response");
+const studioProtocolLicenseKeyRequestSchema = zod_1.z.object({
+    operation: zod_1.z.literal('set-license-key'),
+    protocol: zod_1.z.literal('remotion-studio-protocol'),
+    protocolVersion: zod_1.z.literal(1),
+    targetId: zod_1.z.string().min(1),
+    licenseKey: zod_1.z.string(),
+});
+const MAX_STUDIO_PROTOCOL_LICENSE_KEY_BODY_SIZE = 4096;
+const handleStudioProtocolLicenseKey = async ({ configFile, request, response, }) => {
+    (0, origin_policy_1.setStudioProtocolCorsHeaders)({ licenseKey: true, request, response });
+    const requestOrigin = (0, origin_policy_1.getAllowedLicenseKeyOrigin)(request.headers.origin);
+    if (requestOrigin === null) {
+        (0, protocol_response_1.writeStudioProtocolError)({
+            code: 'unsupported-origin',
+            message: 'Origin not allowed',
+            response,
+            status: 403,
+        });
+        return;
+    }
+    if (request.method !== 'POST') {
+        (0, protocol_response_1.writeStudioProtocolError)({
+            code: 'method-not-allowed',
+            message: 'Use POST to set a public license key.',
+            response,
+            status: 405,
+        });
+        return;
+    }
+    let body;
+    try {
+        body = await (0, parse_body_1.parseRequestBody)(request, {
+            maxBytes: MAX_STUDIO_PROTOCOL_LICENSE_KEY_BODY_SIZE,
+        });
+    }
+    catch (error) {
+        if (error instanceof parse_body_1.RequestBodyTooLargeError) {
+            (0, protocol_response_1.writeStudioProtocolError)({
+                code: 'request-too-large',
+                message: 'The request body is too large.',
+                response,
+                status: 413,
+            });
+            return;
+        }
+        (0, protocol_response_1.writeStudioProtocolError)({
+            code: 'invalid-request',
+            message: 'The request body is not valid JSON.',
+            response,
+            status: 400,
+        });
+        return;
+    }
+    const parsedRequest = studioProtocolLicenseKeyRequestSchema.safeParse(body);
+    if (!parsedRequest.success) {
+        (0, protocol_response_1.writeStudioProtocolError)({
+            code: 'unsupported-protocol',
+            message: 'Invalid Remotion Studio Protocol request.',
+            response,
+            status: 400,
+        });
+        return;
+    }
+    if (!studio_protocol_1.StudioProtocolInternals.isValidPublicLicenseKey(parsedRequest.data.licenseKey)) {
+        (0, protocol_response_1.writeStudioProtocolError)({
+            code: 'invalid-license-key',
+            message: 'The license key is not a valid public Remotion license key.',
+            response,
+            status: 400,
+        });
+        return;
+    }
+    const target = (0, element_install_state_1.consumeStudioProtocolTarget)({
+        now: Date.now(),
+        origin: requestOrigin,
+        purpose: 'set-license-key',
+        targetId: parsedRequest.data.targetId,
+    });
+    if (target === null) {
+        (0, protocol_response_1.writeStudioProtocolError)({
+            code: 'target-expired',
+            message: 'The selected Studio target is no longer available.',
+            response,
+            status: 409,
+        });
+        return;
+    }
+    if (configFile === null) {
+        (0, protocol_response_1.writeStudioProtocolError)({
+            code: 'no-config-file',
+            message: 'The selected Studio did not load a Remotion config file.',
+            response,
+            status: 409,
+        });
+        return;
+    }
+    try {
+        (0, update_public_license_1.setPublicLicenseKeyInConfigFile)({
+            configFile,
+            publicLicenseKey: parsedRequest.data.licenseKey,
+        });
+    }
+    catch (_a) {
+        (0, protocol_response_1.writeStudioProtocolError)({
+            code: 'config-write-failed',
+            message: 'Could not update the Remotion config file.',
+            response,
+            status: 500,
+        });
+        return;
+    }
+    response.writeHead(200, { 'Content-Type': 'application/json' });
+    response.end(JSON.stringify({
+        protocol: 'remotion-studio-protocol',
+        protocolVersion: 1,
+        status: 'license-key-set',
+    }));
+};
+exports.handleStudioProtocolLicenseKey = handleStudioProtocolLicenseKey;

package/dist/preview-server/studio-protocol/origin-policy.d.ts

@@ -1,11 +1,13 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
 export declare const getAllowedStudioProtocolOrigin: (origin: string | undefined) => string | null;
-export declare const isAllowedStudioProtocolOrigin: (origin: string | undefined) => boolean;
-export declare const setStudioProtocolCorsHeaders: ({ request, response, }: {
+export declare const getAllowedLicenseKeyOrigin: (origin: string | undefined) => string | null;
+export declare const setStudioProtocolCorsHeaders: ({ licenseKey, request, response, }: {
+    readonly licenseKey: boolean;
     readonly request: IncomingMessage;
     readonly response: ServerResponse<IncomingMessage>;
 }) => void;
-export declare const handleStudioProtocolOptions: ({ request, response, }: {
+export declare const handleStudioProtocolOptions: ({ licenseKey, request, response, }: {
+    readonly licenseKey: boolean;
     readonly request: IncomingMessage;
     readonly response: ServerResponse<IncomingMessage>;
 }) => Promise<void>;

package/dist/preview-server/studio-protocol/origin-policy.js

@@ -1,15 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleStudioProtocolOptions = exports.setStudioProtocolCorsHeaders = exports.isAllowedStudioProtocolOrigin = exports.getAllowedStudioProtocolOrigin = void 0;
+exports.handleStudioProtocolOptions = exports.setStudioProtocolCorsHeaders = exports.getAllowedLicenseKeyOrigin = exports.getAllowedStudioProtocolOrigin = void 0;
+const isLoopbackHttp = (url) => url.protocol === 'http:' &&
+    (url.hostname === 'localhost' || url.hostname === '127.0.0.1');
 const getAllowedStudioProtocolOrigin = (origin) => {
     if (!origin) {
         return null;
     }
     try {
         const url = new URL(origin);
-        const isLoopbackHttp = url.protocol === 'http:' &&
-            (url.hostname === 'localhost' || url.hostname === '127.0.0.1');
-        if (url.protocol !== 'https:' && !isLoopbackHttp) {
+        if (url.protocol !== 'https:' && !isLoopbackHttp(url)) {
             return null;
         }
         return url.origin;
@@ -19,10 +19,30 @@ const getAllowedStudioProtocolOrigin = (origin) => {
     }
 };
 exports.getAllowedStudioProtocolOrigin = getAllowedStudioProtocolOrigin;
-const isAllowedStudioProtocolOrigin = (origin) => (0, exports.getAllowedStudioProtocolOrigin)(origin) !== null;
-exports.isAllowedStudioProtocolOrigin = isAllowedStudioProtocolOrigin;
-const setStudioProtocolCorsHeaders = ({ request, response, }) => {
-    const origin = (0, exports.getAllowedStudioProtocolOrigin)(request.headers.origin);
+const getAllowedLicenseKeyOrigin = (origin) => {
+    if (!origin) {
+        return null;
+    }
+    try {
+        const url = new URL(origin);
+        if (isLoopbackHttp(url)) {
+            return url.origin;
+        }
+        if (url.origin === 'https://remotion.pro' ||
+            url.origin === 'https://www.remotion.pro') {
+            return url.origin;
+        }
+        return null;
+    }
+    catch (_a) {
+        return null;
+    }
+};
+exports.getAllowedLicenseKeyOrigin = getAllowedLicenseKeyOrigin;
+const setStudioProtocolCorsHeaders = ({ licenseKey, request, response, }) => {
+    const origin = licenseKey
+        ? (0, exports.getAllowedLicenseKeyOrigin)(request.headers.origin)
+        : (0, exports.getAllowedStudioProtocolOrigin)(request.headers.origin);
     if (origin === null) {
         return;
     }
@@ -34,9 +54,12 @@ const setStudioProtocolCorsHeaders = ({ request, response, }) => {
     response.setHeader('Access-Control-Allow-Private-Network', 'true');
 };
 exports.setStudioProtocolCorsHeaders = setStudioProtocolCorsHeaders;
-const handleStudioProtocolOptions = ({ request, response, }) => {
-    (0, exports.setStudioProtocolCorsHeaders)({ request, response });
-    response.writeHead((0, exports.getAllowedStudioProtocolOrigin)(request.headers.origin) === null ? 403 : 204);
+const handleStudioProtocolOptions = ({ licenseKey, request, response, }) => {
+    (0, exports.setStudioProtocolCorsHeaders)({ licenseKey, request, response });
+    const origin = licenseKey
+        ? (0, exports.getAllowedLicenseKeyOrigin)(request.headers.origin)
+        : (0, exports.getAllowedStudioProtocolOrigin)(request.headers.origin);
+    response.writeHead(origin === null ? 403 : 204);
     response.end();
     return Promise.resolve();
 };

package/dist/routes.js

@@ -55,6 +55,7 @@ const open_in_editor_1 = require("./preview-server/routes/open-in-editor");
 const serve_static_1 = require("./preview-server/serve-static");
 const handle_discovery_1 = require("./preview-server/studio-protocol/handle-discovery");
 const handle_install_1 = require("./preview-server/studio-protocol/handle-install");
+const handle_license_key_1 = require("./preview-server/studio-protocol/handle-license-key");
 const origin_policy_1 = require("./preview-server/studio-protocol/origin-policy");
 const validate_same_origin_1 = require("./preview-server/validate-same-origin");
 const watch_ignore_next_change_1 = require("./preview-server/watch-ignore-next-change");
@@ -279,9 +280,14 @@ const handleRoutes = ({ staticHash, staticHashPrefix, outputHash, outputHashPref
         });
     }
     if (url.pathname === '/api/studio-protocol' ||
-        url.pathname === '/api/studio-protocol/install') {
+        url.pathname === '/api/studio-protocol/install' ||
+        url.pathname === '/api/studio-protocol/license-key') {
         if (request.method === 'OPTIONS') {
-            return (0, origin_policy_1.handleStudioProtocolOptions)({ request, response });
+            return (0, origin_policy_1.handleStudioProtocolOptions)({
+                licenseKey: url.pathname === '/api/studio-protocol/license-key',
+                request,
+                response,
+            });
         }
         if (url.pathname === '/api/studio-protocol') {
             return (0, handle_discovery_1.handleStudioProtocolDiscovery)({
@@ -292,6 +298,9 @@ const handleRoutes = ({ staticHash, staticHashPrefix, outputHash, outputHashPref
                 response,
             });
         }
+        if (url.pathname === '/api/studio-protocol/license-key') {
+            return (0, handle_license_key_1.handleStudioProtocolLicenseKey)({ configFile, request, response });
+        }
         return (0, handle_install_1.handleStudioProtocolInstall)({
             focusStudioTab: (studioUrl) => {
                 (0, better_opn_1.focusBrowserTab)({ url: studioUrl }).catch(() => undefined);

package/package.json

@@ -3,7 +3,7 @@
 		"url": "https://github.com/remotion-dev/remotion/tree/main/packages/studio-server"
 	},
 	"name": "@remotion/studio-server",
-	"version": "4.0.503",
+	"version": "4.0.504",
 	"description": "Run a Remotion Studio with a server backend",
 	"main": "dist",
 	"scripts": {
@@ -23,7 +23,7 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"@remotion/studio-protocol": "4.0.503",
+		"@remotion/studio-protocol": "4.0.504",
 		"@babel/types": "7.24.0",
 		"@babel/parser": "7.24.1",
 		"@svgr/core": "8.1.0",
@@ -32,12 +32,12 @@
 		"semver": "7.5.3",
 		"zod": "4.4.3",
 		"prettier": "3.8.1",
-		"remotion": "4.0.503",
+		"remotion": "4.0.504",
 		"recast": "0.23.11",
-		"@remotion/bundler": "4.0.503",
-		"@remotion/renderer": "4.0.503",
-		"@remotion/studio-codemods": "4.0.503",
-		"@remotion/studio-shared": "4.0.503",
+		"@remotion/bundler": "4.0.504",
+		"@remotion/renderer": "4.0.504",
+		"@remotion/studio-codemods": "4.0.504",
+		"@remotion/studio-shared": "4.0.504",
 		"memfs": "3.4.3",
 		"open": "8.4.2"
 	},
@@ -45,7 +45,7 @@
 		"ast-types": "0.16.1",
 		"react": "19.2.3",
 		"@types/semver": "7.5.3",
-		"@remotion/eslint-config-internal": "4.0.503",
+		"@remotion/eslint-config-internal": "4.0.504",
 		"eslint": "9.19.0",
 		"@types/node": "20.12.14",
 		"@typescript/native-preview": "7.0.0-dev.20260217.1"