@gentbajko/slopify 2.0.1 → 2.0.3

package/dist/slices/settings/playback.js

@@ -19,11 +19,11 @@ export function saveSettings(deps, settings) {
     if (!silenceGapValue.safeParse(settings.silenceGapSeconds).success) {
         fields.push({
             field: "silenceGapSeconds",
-            message: `The silence gap is a whole number of seconds between 0 and ${String(silenceGapSecondsMax)}.`,
+            message: `Enter a whole number of seconds between 0 and ${String(silenceGapSecondsMax)}.`,
         });
     }
     if (!appearanceValue.safeParse(settings.appearance).success) {
-        fields.push({ field: "appearance", message: "Pick System, Light or Dark." });
+        fields.push({ field: "appearance", message: "Choose System, Light or Dark." });
     }
     if (fields.length > 0) {
         return { ok: false, fields };

package/dist/slices/storage/assets.js

@@ -10,7 +10,7 @@ export function allocateAsset(deps, projectId, filename) {
     const absolutePath = outputPath(deps.paths, projectId, path);
     const directory = outputPath(deps.paths, projectId, `assets/${id}`);
     if (dirname(absolutePath) !== directory)
-        throw new Error("Asset filenames must be basenames.");
+        throw new Error("Slopify hit an internal error (a file name to save is not a plain file name). Try again; if it happens again, use Download diagnostics in Settings and report it.");
     mkdirSync(outputPath(deps.paths, projectId, "assets"), { recursive: true, mode: 0o700 });
     mkdirSync(directory, { mode: 0o700 });
     return { id, projectId, path, absolutePath };
@@ -20,7 +20,7 @@ export function sealAsset(deps, pending) {
     try {
         const stats = fstatSync(file);
         if (!stats.isFile())
-            throw new Error("An asset must be a regular file.");
+            throw new Error("Slopify hit an internal error (a saved file is not a regular file). Try again; if it happens again, use Download diagnostics in Settings and report it.");
         fchmodSync(file, 0o600);
         fsyncSync(file);
         return {
@@ -58,7 +58,7 @@ export function discardPreparedAssets(deps, assets) {
             const filename = basename(asset.path);
             requireBasename(filename);
             if (asset.path !== `assets/${asset.id}/${filename}`) {
-                throw new Error("A prepared asset must belong to its allocated directory.");
+                throw new Error("Slopify hit an internal error (a prepared file is not in its allocated directory). Try again; if it happens again, use Download diagnostics in Settings and report it.");
             }
             const directory = outputPath(deps.paths, asset.projectId, `assets/${asset.id}`);
             const registered = deps.db
@@ -68,7 +68,7 @@ export function discardPreparedAssets(deps, assets) {
                 if (row.id === asset.id)
                     return true;
                 if (typeof row.path !== "string")
-                    throw new Error("A registered asset must name a path.");
+                    throw new Error("Slopify hit an internal error (a saved file has no path). Try again; if it happens again, use Download diagnostics in Settings and report it.");
                 const inside = relative(directory, outputPath(deps.paths, asset.projectId, row.path));
                 return (inside === "" ||
                     (inside !== ".." && !inside.startsWith(`..${sep}`) && !isAbsolute(inside)));
@@ -92,7 +92,7 @@ function requireBasename(filename) {
         }) ||
         /[. ]$/.test(filename) ||
         /^(?:con|prn|aux|nul|conin\$|conout\$|com[1-9¹²³]|lpt[1-9¹²³])(?:\.|$)/i.test(filename))
-        throw new Error("Asset filenames must be portable basenames.");
+        throw new Error("Slopify hit an internal error (a file name to save is not allowed on every system). Try again; if it happens again, use Download diagnostics in Settings and report it.");
 }
 function messageOf(error) {
     return error instanceof Error ? error.message : String(error);

package/dist/slices/storage/layout.js

@@ -14,7 +14,7 @@ function contained(root, path) {
     const target = resolve(root, path);
     const inside = relative(root, target);
     if (inside === "" || inside.startsWith("..") || isAbsolute(inside)) {
-        throw new Error(`${path} resolves outside ${root}`);
+        throw new Error(`Slopify hit an internal error (the saved file path ${path} resolves outside ${root}). Try again; if it happens again, use Download diagnostics in Settings and report it.`);
     }
     return target;
 }

package/dist/slices/subtitles/captions.js

@@ -21,7 +21,7 @@ export function captionCues(words) {
             !Number.isFinite(word.end) ||
             word.start < previousEnd - 0.001 ||
             word.end <= word.start) {
-            throw new Error("The subtitle word timing is invalid; regenerate alignment.");
+            throw new Error("The saved caption timing is damaged. Use Re-run section on Video to time them again, then Retry stage.");
         }
         const first = pending[0];
         if (first !== undefined &&

package/dist/slices/subtitles/prepare.js

@@ -2,6 +2,7 @@ import { createHash } from "node:crypto";
 import { copyFileSync, createReadStream, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
 import { join, relative, sep } from "node:path";
 import { z } from "zod";
+import { subtitleModelDir } from "../../kernel/paths.js";
 import { projectById, setStageProgress } from "../admission/repo.js";
 import { resolveFont } from "../fonts/index.js";
 import { outputPath, projectDir } from "../storage/layout.js";
@@ -42,7 +43,7 @@ export async function prepareSubtitles(deps, context, audio, frame) {
     const { projectId } = context.stage;
     const project = projectById(deps.db, projectId);
     if (project === undefined)
-        throw new Error("The project no longer exists.");
+        throw new Error("This project no longer exists; it may have been deleted while it was running.");
     const config = project.config.subtitles ?? defaultSubtitles;
     if (config.mode === "off")
         return undefined;
@@ -50,7 +51,7 @@ export async function prepareSubtitles(deps, context, audio, frame) {
     setStageProgress(deps.db, context.stage.id, 0, 100);
     context.emit({ type: "stage.progress", projectId, stage: "video", current: 0, total: 100 });
     if (audio.length === 0)
-        throw new Error("Subtitles need narration audio.");
+        throw new Error("Captions need narration audio, but this project has none. Turn captions off in Edit project → Subtitles, or turn narration on, then Retry stage.");
     const outputs = outputsOf(deps.db, projectId);
     const segments = audio.map((segment) => ({
         ...segment,
@@ -67,7 +68,7 @@ export async function prepareSubtitles(deps, context, audio, frame) {
         context.signal.throwIfAborted();
         const cues = captionCues(words);
         if (cues.length === 0)
-            throw new Error("No spoken words could be aligned. Check that the English article matches the audio.");
+            throw new Error("None of the narration could be matched to the article text, so captions can't be timed. Captions only work for English narration; if you uploaded your own audio, make sure it reads the article text, then Retry stage.");
         writeFileSync(join(directory, "subtitles.srt"), serializeSrt(cues), { mode: 0o600 });
         writeFileSync(join(directory, "subtitles.vtt"), serializeVtt(cues), { mode: 0o600 });
         writeFileSync(join(directory, "subtitles.ass"), serializeAss(cues, {
@@ -117,7 +118,7 @@ async function timingKey(segments, signal) {
 }
 async function alignSegments(deps, context, segments, omissions) {
     if (deps.alignSubtitles === undefined)
-        throw new Error("Local subtitle alignment is unavailable in this build.");
+        throw new Error("Slopify hit an internal error (the caption timing tool is missing from this build). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     const words = [];
     const total = segments.reduce((sum, segment) => sum + segment.seconds, 0);
     let offset = 0;
@@ -128,7 +129,7 @@ async function alignSegments(deps, context, segments, omissions) {
                 audioPath: segment.path,
                 onOmission: (omission) => omissions.push({ ...omission, start: omission.start + offset }),
                 text: segment.text,
-                cacheDir: join(deps.paths.dataDir, "models", "english-subtitles"),
+                cacheDir: subtitleModelDir(deps.paths.dataDir),
                 ffmpeg: deps.ffmpeg,
                 signal: context.signal,
                 onProgress: (current, maximum) => {
@@ -145,7 +146,7 @@ async function alignSegments(deps, context, segments, omissions) {
             });
             for (const word of aligned) {
                 if (word.end > segment.seconds + 0.1)
-                    throw new Error("Subtitle timing exceeds the narration duration.");
+                    throw new Error("Caption timing came out longer than the narration audio. Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
                 words.push({
                     ...word,
                     start: word.start + offset,

package/dist/slices/subtitles/transcript.js

@@ -27,7 +27,7 @@ export function spokenText(deps, projectId, kind, outputs) {
                 return segment.text;
         }
     }
-    throw new Error(`The saved ${kind} narration text is missing. Subtitles need the text spoken in the audio.`);
+    throw new Error(`The saved text of the ${kind === "body" ? "article" : kind} is missing, and captions need the text spoken in the narration. Use Re-run section on Article, then Retry stage.`);
 }
 function payload(raw) {
     return textPayload.parse(JSON.parse(raw ?? "null"));

package/dist/slices/thumbnail/run.js

@@ -16,19 +16,19 @@ export async function runThumbnail(deps, context, providers) {
     const { projectId } = context.stage;
     const project = projectById(deps.db, projectId);
     if (project === undefined) {
-        throw new Error(`project ${projectId} has no row`);
+        throw new Error("This project no longer exists; it may have been deleted while it was running.");
     }
     const source = project.config.sources.thumbnail;
     if (source !== "from_prompt" && source !== "prompt_by_llm") {
         // Off is `skipped` and Provide is `provided` at project creation,
         // so the runner never starts this stage for either.
-        throw new Error(`the thumbnail stage cannot run with its source set to ${source}`);
+        throw new Error(`Slopify hit an internal error (the thumbnail stage cannot run with its source set to ${source}). Retry stage; if it happens again, use Download diagnostics in Settings and report it.`);
     }
     const choice = project.config.images;
     if (choice === undefined) {
         // Admission requires the image provider whenever the thumbnail is generated, so reaching
         // here is a bug in admission rather than the user's.
-        throw new Error("the run has no image provider or model");
+        throw new Error("No image model is set for the thumbnail. Choose one in Edit project → Providers, then Retry stage.");
     }
     const result = source === "from_prompt" ? undefined : await byLlm(deps, context, providers, project);
     if (result !== undefined && !result.ok)
@@ -60,7 +60,7 @@ export async function runThumbnail(deps, context, providers) {
 function fromTemplate(project) {
     const rendered = project.config.rendered.thumbnailPrompt;
     if (rendered === undefined) {
-        throw new Error("the run has no rendered thumbnail prompt");
+        throw new Error("Slopify hit an internal error (the thumbnail prompt was never filled in). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return rendered;
 }
@@ -83,7 +83,7 @@ async function byLlm(deps, context, providers, project) {
     }
     if (llm === undefined) {
         // Admission requires the LLM row when the thumbnail source is Prompt by LLM.
-        throw new Error("the run has no LLM provider or model");
+        throw new Error("No AI model is set for writing the thumbnail prompt. Choose one in Edit project → Providers, then Retry stage.");
     }
     const messages = thumbnailMessages(brief(deps, project));
     const answer = await providers.llm({
@@ -117,7 +117,7 @@ function named(choice) {
 function brief(deps, project) {
     const instruction = project.config.rendered.thumbnailPrompt;
     if (instruction === undefined) {
-        throw new Error("the run has no rendered thumbnail prompt");
+        throw new Error("Slopify hit an internal error (the thumbnail prompt was never filled in). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return {
         instruction,
@@ -133,7 +133,7 @@ function brief(deps, project) {
 function articleText(deps, projectId) {
     const article = outputsOf(deps.db, projectId).find((output) => output.role === "article_txt");
     if (article === undefined) {
-        throw new Error("the project has no article for the thumbnail prompt to be written from");
+        throw new Error("The thumbnail prompt is written from the article, but the article isn't ready. Let the Article stage finish, then Retry stage.");
     }
     return readFileSync(outputPath(deps.paths, projectId, article.path), "utf8");
 }
@@ -212,7 +212,7 @@ function instructionsText(messages) {
 }
 function payloadOf(piece) {
     if (piece.payload === null) {
-        throw new Error(`the written thumbnail prompt ${piece.id} has no payload`);
+        throw new Error("Slopify hit an internal error (the saved thumbnail prompt is empty). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return writtenPayload.parse(JSON.parse(piece.payload));
 }

package/dist/slices/video/audio-inputs.js

@@ -5,9 +5,9 @@ export async function audioInputs(deps, projectId, outputs, signal) {
     const dir = projectDir(deps.paths, projectId);
     const body = await audio(deps, outputs, "audio_body", dir, signal);
     if (!body)
-        throw new Error("the project has no narration audio to render against");
+        throw new Error("The video has no narration audio to play. Let the Narration stage finish, then Retry stage.");
     if (body.seconds <= 0)
-        throw new Error("the narration audio decodes to no sound");
+        throw new Error("The narration audio contains no sound; the file may be damaged or empty. Regenerate the narration (or upload a different audio file in Edit project → Narration), then Retry stage.");
     const intro = await audio(deps, outputs, "audio_intro", dir, signal);
     const outro = await audio(deps, outputs, "audio_outro", dir, signal);
     return { body, intro, outro };

package/dist/slices/video/ffmpeg.js

@@ -24,8 +24,9 @@ export function resolveFfmpeg(env, bundled) {
     }
     // Never PATH: a Slopify that quietly rendered with whichever ffmpeg the machine
     // happens to carry would not be testing the binary it ships with.
-    throw new Error("No ffmpeg binary is available. Slopify ships one through ffmpeg-static; if this " +
-        "platform has no build, point SLOPIFY_FFMPEG at an ffmpeg executable.");
+    throw new Error("Slopify can't find ffmpeg, the tool it uses to make audio and video: its bundled copy is " +
+        "missing for this computer. Reinstall Slopify, or set the SLOPIFY_FFMPEG environment " +
+        "variable to the path of an ffmpeg program.");
 }
 export function renderArgs(plan, burnSubtitles = false) {
     const inputs = [];
@@ -180,7 +181,7 @@ export function runFfmpeg(run) {
         run.signal.addEventListener("abort", stop, { once: true });
         child.on("error", (error) => {
             run.signal.removeEventListener("abort", stop);
-            reject(new Error(`ffmpeg could not be started: ${error.message}`));
+            reject(new Error(`Slopify could not start ffmpeg, the tool it uses to make audio and video (${error.message}). Reinstall Slopify, or if you set SLOPIFY_FFMPEG, check that it points to a working ffmpeg program.`));
         });
         child.on("close", (code, signal) => {
             run.signal.removeEventListener("abort", stop);
@@ -240,7 +241,8 @@ function messageOf(error) {
 }
 function failure(code, signal, errors) {
     const ended = code === null ? `killed by ${signal ?? "a signal"}` : `exited with code ${code}`;
-    return errors.length === 0
+    const said = errors.length === 0
         ? `ffmpeg ${ended} and wrote nothing to its error stream`
         : `ffmpeg ${ended}: ${errors.join(" / ")}`;
+    return `The audio/video export failed (${said}). Retry stage; if it fails again, make sure your disk has free space (see Settings → Backup & storage), then use Download diagnostics in Settings and report it.`;
 }

package/dist/slices/video/plan.js

@@ -13,7 +13,7 @@ export const zoomBy = 0.225;
 export function planRender(input) {
     if (input.images.length === 0) {
         // Admission permits Video only with an image source, so an empty set is a bug upstream.
-        throw new Error("a render needs at least one image");
+        throw new Error("The video needs at least one image, but there are none. Check the Images section in Edit project, then Retry stage.");
     }
     const frame = frames[input.format];
     const audio = input.body === undefined ? [] : audioTimeline({ ...input, body: input.body });

package/dist/slices/video/run.js

@@ -12,10 +12,10 @@ export async function renderVideo(deps, context) {
     const { projectId } = context.stage;
     const project = projectById(deps.db, projectId);
     if (!project)
-        throw new Error(`project ${projectId} has no row`);
+        throw new Error("This project no longer exists; it may have been deleted while it was running.");
     if (project.config.sources.video === "off") {
         if (project.config.sources.audio === "off")
-            throw new Error("the project has no media export enabled");
+            throw new Error("There is nothing to export because both video and narration are turned off for this project. Turn one on in Edit project, then Retry stage.");
         await exportAudioWav(deps, context, project.config.silenceGapSeconds);
         return;
     }

package/dist/updater/plan.js

@@ -147,7 +147,7 @@ export async function npmCommand() {
             /* PATH can include directories without npm. */
         }
     }
-    throw new Error("npm is unavailable. Install Node.js with npm to use in-app updates.");
+    throw new Error("npm was not found, so in-app updates are off. Install Node.js with npm (https://nodejs.org), or update from the terminal: npx @gentbajko/slopify@latest");
 }
 export async function updateCommitted(dataDir, version, token) {
     try {

package/dist/updater/service.js

@@ -7,7 +7,7 @@ export function createUpdater(deps) {
     let status = deps.candidate?.pending === true ? "restarting" : "idle";
     let activated = deps.candidate?.pending !== true;
     let installError = deps.previousUpdateFailed
-        ? "The update did not start. The previous version and database were restored. You can try again."
+        ? "The new version did not start, so Slopify put back the previous version and database. You can try again; the reason is in logs/updates.log inside your Slopify data folder."
         : undefined;
     let error = installError;
     let checking;
@@ -56,7 +56,8 @@ export function createUpdater(deps) {
             }
             catch {
                 status = "error";
-                error = "Could not check for updates. Check your connection and try again.";
+                error =
+                    "Could not check for updates: the npm registry (registry.npmjs.org) did not answer properly. Check your internet connection and try again.";
                 deps.report(error);
             }
             finally {
@@ -143,7 +144,7 @@ export function createUpdater(deps) {
                 .catch(() => {
                 status = "error";
                 error =
-                    "The update could not be completed. Your current installation is still available. Try again or restart Slopify.";
+                    "The update could not be installed, so Slopify kept your current version. Check your internet connection and try again; the reason is in logs/updates.log inside your Slopify data folder.";
                 installError = error;
                 deps.report(error);
             });

package/dist/updater/worker.js

@@ -111,15 +111,17 @@ function installPackage(plan, directory) {
             timeout: 15 * 60_000,
             env: { ...process.env, npm_config_update_notifier: "false" },
         });
-        child.once("error", () => reject(new Error("npm could not be started.")));
-        child.once("close", (code) => code === 0 ? resolve() : reject(new Error("npm could not install the update.")));
+        child.once("error", () => reject(new Error(`npm (${plan.npm.file}) could not be started. Check that Node.js and npm are installed.`)));
+        child.once("close", (code) => code === 0
+            ? resolve()
+            : reject(new Error(`npm could not install Slopify ${plan.version} (exit code ${code}). Check your internet connection (npm must reach registry.npmjs.org) and try again.`)));
     });
 }
 async function waitForServer(plan, version, exited) {
     const until = Date.now() + 60_000;
     while (Date.now() < until) {
         if (exited())
-            throw new Error("Slopify stopped during startup.");
+            throw new Error(`Slopify ${version} stopped while starting up, so the previous version was kept.`);
         try {
             if (await candidateReady(serverOrigin(plan), version, plan.token, exited, globalThis.fetch))
                 return;
@@ -129,7 +131,7 @@ async function waitForServer(plan, version, exited) {
         }
         await delay(250);
     }
-    throw new Error("Slopify did not restart in time.");
+    throw new Error(`Slopify ${version} did not answer within 60 seconds of starting.`);
 }
 function serverOrigin(plan) {
     const host = plan.host === "0.0.0.0" ? "127.0.0.1" : plan.host === "::" ? "::1" : plan.host;