screenci 0.0.74 → 0.0.76

package/dist/cli.d.ts

@@ -32,6 +32,7 @@ type PreparedUploadAsset = {
     name?: string;
     fileBuffer?: Buffer;
     contentType?: string;
+    alwaysUpload?: boolean;
 };
 export type UploadStudioInfo = {
     held: true;
@@ -79,6 +80,16 @@ export declare function ensureScreenciSecret(resolvedConfigPath?: string, opts?:
     pollAuth?: boolean;
     noPollAuth?: boolean;
 }): Promise<string | undefined>;
+/**
+ * `screenci login`: get a sign-in link in front of a human as early as
+ * possible. It reuses the link `init` (or a prior run) persisted, or creates a
+ * fresh one, tries to open it in the browser best-effort, and always prints it
+ * as a fallback. It does NOT wait for sign-in to finish: the agent can run this,
+ * keep authoring and `test`ing, then `record` (which blocks for sign-in) once
+ * the script is green. If sign-in already completed, it saves the secret and
+ * exits.
+ */
+export declare function runLogin(configPath?: string): Promise<void>;
 export declare function main(): Promise<void>;
 export declare function parseRecordCliArgs(args: string[]): {
     configPath: string | undefined;

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -14,6 +14,7 @@ import { SCREENCI_DISABLE_RECORDING_TIMINGS_ENV, SCREENCI_MOCK_RECORD_ENV, SCREE
 import { DEFAULT_RECORD_UPLOAD_POLICY } from './src/defaults.js';
 import { findDuplicateTitles, formatDuplicateTitlesMessage, } from './src/titleValidation.js';
 import { createLinkSessionSpec, deletePersistedLinkSessionSpec, getCliLinkSessionApiUrl, getDevBackendUrl, getDevFrontendUrl, getLinkSessionFilePath, getScreenCIEnvironment, isStoredLinkSessionReusable, readPersistedLinkSessionSpec, SCREENCI_LINK_SESSION_FILE, writePersistedLinkSessionSpec, } from './src/linkSession.js';
+import { openUrlInBrowser } from './src/openBrowser.js';
 // Re-export the environment-aware URL helpers so existing importers (and tests)
 // can keep importing them from the CLI entrypoint.
 export { getCliLinkSessionApiUrl, getDevBackendUrl, getDevFrontendUrl };
@@ -214,6 +215,9 @@ function contentTypeForPath(filePath) {
         mp4: 'video/mp4',
         webm: 'video/webm',
         mp3: 'audio/mpeg',
+        wav: 'audio/wav',
+        m4a: 'audio/mp4',
+        aac: 'audio/aac',
         svg: 'image/svg+xml',
     };
     return contentTypeMap[ext] ?? 'application/octet-stream';
@@ -352,7 +356,7 @@ async function loadUploadCandidate(screenciDir, entry, verbose) {
         preparedUploadAssets,
     };
 }
-async function uploadRecordingCandidate(candidate, screenciDir, projectName, apiUrl, secret, elevenLabsApiKey, verbose, uploadAbort, progressReporter, progressIndex, recordId) {
+async function uploadRecordingCandidate(candidate, screenciDir, projectName, apiUrl, secret, elevenLabsApiKey, verbose, uploadAbort, progressReporter, progressIndex, recordId, expectedScreenshotCount) {
     const { entry, videoName, data, preparedUploadAssets } = candidate;
     let projectId = null;
     let videoId = null;
@@ -395,6 +399,7 @@ async function uploadRecordingCandidate(candidate, screenciDir, projectName, api
                 data,
                 recordingHash,
                 recordId,
+                ...(isScreenshot ? { expectedScreenshotCount } : {}),
                 expectedAssets: preparedUploadAssets.map((asset) => ({
                     fileHash: asset.fileHash,
                     size: asset.size,
@@ -879,6 +884,27 @@ export async function collectUploadAssets(data, configDir) {
             });
             continue;
         }
+        if (event.type === 'audioStart') {
+            // Studio audio tracks have no local file.
+            if ('studio' in event && event.studio === true)
+                continue;
+            if (!event.fileHash || assets.has(`hash:${event.fileHash}`))
+                continue;
+            const resolvedFile = await readRecordingFile(event.path, configDir, sourceFilePath);
+            if (resolvedFile === null) {
+                logger.warn(`Audio file not found, skipping upload: ${event.path}`);
+                continue;
+            }
+            assets.set(`hash:${event.fileHash}`, {
+                fileHash: event.fileHash,
+                path: event.path,
+                size: resolvedFile.buffer.byteLength,
+                fileBuffer: resolvedFile.buffer,
+                contentType: contentTypeForPath(resolvedFile.resolvedPath),
+                ...(event.name === '__screen' && { alwaysUpload: true }),
+            });
+            continue;
+        }
         if (event.type === 'videoCueStart') {
             // Single-language: hash already computed during recording, use assetPath to read file
             if (typeof event.assetHash === 'string' &&
@@ -999,7 +1025,7 @@ function hint401(status, secret) {
     if (status !== 401 || !secret)
         return '';
     const frontendUrl = getDevFrontendUrl();
-    return `\nThe secret may have been deleted or belongs to a different organisation. Check your secrets at ${frontendUrl}/secrets`;
+    return `\nThe secret may have been deleted. Check your secrets at ${frontendUrl}/secrets`;
 }
 export function formatUploadStartFailureMessage(videoName, status, responseText, secret) {
     if (responseText.trim().length > 0) {
@@ -1053,49 +1079,53 @@ async function uploadAssets(assets, apiUrl, secret, recordingId, signal, throwIf
     for (const asset of assets) {
         throwIfAborted();
         try {
-            const checkRes = await withUploadRetry(() => fetch(`${apiUrl}/cli/upload/${recordingId}/asset/check`, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    'X-ScreenCI-Secret': secret,
-                },
-                body: JSON.stringify({
-                    fileHash: asset.fileHash,
-                    contentType: asset.contentType,
-                    size: asset.size,
-                    path: asset.path,
-                    ...(typeof asset.name === 'string' ? { name: asset.name } : {}),
-                }),
-                signal,
-            }), signal);
-            if (!checkRes.ok) {
-                const text = await checkRes.text();
-                throw new UploadAssetError(`Failed to check asset ${asset.path}: ${checkRes.status} ${text}${hint401(checkRes.status, secret)}`);
-            }
-            const checkBody = (await checkRes.json());
-            if (checkBody.exists) {
-                logInfo(`${pc.green('✔')} Asset already exists: ${displayAssetPath(asset.path)}`);
-                continue;
+            if (!asset.alwaysUpload) {
+                const checkRes = await withUploadRetry(() => fetch(`${apiUrl}/cli/upload/${recordingId}/asset/check`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-ScreenCI-Secret': secret,
+                    },
+                    body: JSON.stringify({
+                        fileHash: asset.fileHash,
+                        contentType: asset.contentType,
+                        size: asset.size,
+                        path: asset.path,
+                        ...(typeof asset.name === 'string' ? { name: asset.name } : {}),
+                    }),
+                    signal,
+                }), signal);
+                if (!checkRes.ok) {
+                    const text = await checkRes.text();
+                    throw new UploadAssetError(`Failed to check asset ${asset.path}: ${checkRes.status} ${text}${hint401(checkRes.status, secret)}`);
+                }
+                const checkBody = (await checkRes.json());
+                if (checkBody.exists) {
+                    logInfo(`${pc.green('✔')} Asset already exists: ${displayAssetPath(asset.path)}`);
+                    continue;
+                }
             }
             if (!asset.fileBuffer || !asset.contentType) {
                 throw new UploadAssetError(`Asset bytes not available for upload and backend does not have it yet: ${asset.path}`);
             }
             const fileBuffer = asset.fileBuffer;
+            const contentType = asset.contentType;
             throwIfAborted();
-            const res = await withUploadRetry(() => fetch(`${apiUrl}/cli/upload/${recordingId}/asset`, {
+            const res = await withUploadRetry(() => 
+            // Send the raw bytes, not base64-in-JSON: base64 builds a string that
+            // exceeds Node's max string length (~536MB) for large assets. Metadata
+            // travels in headers (URI-encoded so non-ASCII paths stay header-safe).
+            fetch(`${apiUrl}/cli/upload/${recordingId}/asset/stream`, {
                 method: 'PUT',
                 headers: {
-                    'Content-Type': 'application/json',
+                    'Content-Type': contentType,
+                    'Content-Length': String(fileBuffer.byteLength),
                     'X-ScreenCI-Secret': secret,
+                    'X-ScreenCI-File-Hash': asset.fileHash,
+                    'X-ScreenCI-Asset-Size': String(asset.size),
+                    'X-ScreenCI-Asset-Path': encodeURIComponent(asset.path),
                 },
-                body: JSON.stringify({
-                    fileHash: asset.fileHash,
-                    fileBase64: fileBuffer.toString('base64'),
-                    contentType: asset.contentType,
-                    size: asset.size,
-                    path: asset.path,
-                    ...(typeof asset.name === 'string' ? { name: asset.name } : {}),
-                }),
+                body: fileBuffer,
                 signal,
             }), signal);
             if (!res.ok) {
@@ -1163,7 +1193,11 @@ export async function uploadRecordings(screenciDir, projectName, apiUrl, secret,
             };
         }
         const progressReporter = createUploadProgressReporter(candidates.map((candidate) => candidate.videoName), verbose);
-        const results = await Promise.all(candidates.map(async (candidate, index) => await uploadRecordingCandidate(candidate, screenciDir, projectName, apiUrl, secret, elevenLabsApiKey, verbose, uploadAbort, progressReporter, index, recordId)));
+        // Screenshots from this run render together on one machine; the backend
+        // waits for all of them to land before dispatching the batch, so it needs
+        // to know how many to expect.
+        const screenshotCount = candidates.filter((candidate) => candidate.data.output === 'screenshot').length;
+        const results = await Promise.all(candidates.map(async (candidate, index) => await uploadRecordingCandidate(candidate, screenciDir, projectName, apiUrl, secret, elevenLabsApiKey, verbose, uploadAbort, progressReporter, index, recordId, screenshotCount)));
         firstProjectId =
             results.find((result) => result.projectId !== null)?.projectId ?? null;
         const resolvedPlan = results.find((result) => result.plan !== undefined)?.plan ?? null;
@@ -1757,10 +1791,82 @@ export async function ensureScreenciSecret(resolvedConfigPath, opts = {}) {
         return undefined;
     }
 }
+/**
+ * `screenci login`: get a sign-in link in front of a human as early as
+ * possible. It reuses the link `init` (or a prior run) persisted, or creates a
+ * fresh one, tries to open it in the browser best-effort, and always prints it
+ * as a fallback. It does NOT wait for sign-in to finish: the agent can run this,
+ * keep authoring and `test`ing, then `record` (which blocks for sign-in) once
+ * the script is green. If sign-in already completed, it saves the secret and
+ * exits.
+ */
+export async function runLogin(configPath) {
+    const { resolvedConfigPath } = await loadScreenCIConfigAndEnv(configPath);
+    if (process.env.SCREENCI_SECRET) {
+        logger.info(`Already signed in (SCREENCI_SECRET is set). Run ${pc.cyan(getSuggestedScreenciCommand('record'))} to record.`);
+        return;
+    }
+    const environment = getScreenCIEnvironment();
+    const apiUrl = getCliLinkSessionApiUrl();
+    const appUrl = getDevFrontendUrl();
+    const envFilePath = await resolveProjectEnvFilePath(resolvedConfigPath);
+    const projectDir = dirname(resolvedConfigPath);
+    const specPath = getLinkSessionFilePath(projectDir);
+    const linkSessionContext = { environment, envFilePath, resolvedConfigPath };
+    const createSpec = async () => {
+        const created = await createLinkSessionSpec({
+            apiUrl,
+            appUrl,
+            ...linkSessionContext,
+        });
+        await writePersistedLinkSessionSpec(specPath, created);
+        return created;
+    };
+    try {
+        // Reuse a still-valid persisted session so login and a later record share
+        // the same link; otherwise create and persist a fresh one.
+        const stored = await readPersistedLinkSessionSpec(specPath);
+        let spec = stored && isStoredLinkSessionReusable(stored, linkSessionContext)
+            ? stored
+            : await createSpec();
+        // If sign-in already completed (e.g. between runs) save the secret and stop:
+        // there is nothing left to open. Recreate a stale session before opening so
+        // the link we hand off is valid.
+        const result = await pollLinkSessionOnce(spec);
+        if (result.status === 'completed' && result.secret) {
+            process.env.SCREENCI_SECRET = result.secret;
+            await persistScreenCISecret(envFilePath, result.secret);
+            deletePersistedLinkSessionSpec(specPath);
+            logger.info(`Already signed in. Saved SCREENCI_SECRET to ${envFilePath}.`);
+            return;
+        }
+        if (result.status === 'expired' ||
+            result.status === 'consumed' ||
+            result.status === 'invalid') {
+            deletePersistedLinkSessionSpec(specPath);
+            spec = await createSpec();
+        }
+        const opened = await openUrlInBrowser(spec.appUrl);
+        if (opened.opened) {
+            logger.info(`Opening the sign-in link in your browser:\n${pc.cyan(spec.appUrl)}`);
+        }
+        else {
+            logger.info(`Could not open a browser automatically (${opened.reason}). Open this link to sign in:\n${pc.cyan(spec.appUrl)}`);
+        }
+        logger.info(`The link stays valid for 24 hours. You can keep authoring and run ${pc.cyan(getSuggestedScreenciCommand('test'))} while you sign in. Then run ${pc.cyan(getSuggestedScreenciCommand('record'))}, which waits for sign-in and records once you finish.`);
+    }
+    catch (err) {
+        // Login is a best-effort convenience: never fail the run on a network or
+        // browser hiccup. record can still create and wait on the link later.
+        const msg = err instanceof Error ? err.message : String(err);
+        logger.warn(`Could not start sign-in: ${msg}`);
+        logger.info(`You can sign in later: ${pc.cyan(getSuggestedScreenciCommand('record'))} prints a link and waits for sign-in. In CI, set SCREENCI_SECRET (from ${getScreenCISecretsUrl()}).`);
+    }
+}
 export async function main() {
     if (process.argv.length <= 2) {
         logger.error('Error: No command provided');
-        logger.error('Available commands: record, test, info, make-public, make-private, init');
+        logger.error('Available commands: record, test, login, info, make-public, make-private, init');
         process.exit(1);
     }
     const program = new Command();
@@ -1948,6 +2054,13 @@ export async function main() {
         const recordCommand = getSuggestedScreenciCommand('record');
         logger.info(`Tests passed. Run ${pc.cyan(recordCommand)} to render the videos.`);
     });
+    program
+        .command('login')
+        .description('Open the sign-in link in your browser (best-effort) so recording can finish later')
+        .option('-c, --config <path>', 'path to screenci.config.ts')
+        .action(async (options) => {
+        await runLogin(options['config']);
+    });
     program
         .command('info')
         .description("Print the latest record run's video URLs and render status as JSON")