@gentbajko/slopify 3.25.9 → 4.1.0

package/dist/slices/social/text.js

@@ -0,0 +1,149 @@
+// A post's words: counted the way each site counts them, cut to fit at a sentence, with the
+// hashtags and link at the end. Pure and browser-safe: Prepare upload's live counter uses it.
+import { parseTimestamp } from "../youtube/timestamps.js";
+const urlPattern = /https?:\/\/[^\s]+/gu;
+// X counts a link as 23 characters, whatever its length.
+const xUrlWeight = 23;
+// X counts these code points once; every other (CJK, emoji) twice.
+const xLightRanges = [
+    [0, 4351],
+    [8192, 8205],
+    [8208, 8223],
+    [8242, 8247],
+];
+const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+const pictographic = /\p{Extended_Pictographic}/u;
+function xWeight(text) {
+    let total = 0;
+    for (const { segment } of segmenter.segment(text)) {
+        if (pictographic.test(segment)) {
+            total += 2;
+            continue;
+        }
+        for (const char of segment) {
+            const code = char.codePointAt(0) ?? 0;
+            total += xLightRanges.some(([low, high]) => code >= low && code <= high) ? 1 : 2;
+        }
+    }
+    return total;
+}
+export function countFor(text, unit) {
+    switch (unit) {
+        case "weighted": {
+            const links = text.match(urlPattern) ?? [];
+            return xWeight(text.replace(urlPattern, "")) + links.length * xUrlWeight;
+        }
+        case "graphemes":
+            return [...segmenter.segment(text)].length;
+        case "characters":
+            return text.length;
+    }
+}
+// The body, then the link and hashtags, each part on its own paragraph. A body too long is cut
+// at the last sentence that still fits, else at the last word with "…"; the link and hashtags
+// are never cut, but dropped (hashtags first) when even they don't fit.
+export function fitText(input, limits, siteName) {
+    const body = input.body.trim();
+    const tagLine = input.hashtags.join(" ");
+    const join = (parts) => parts.filter((part) => part !== "").join("\n\n");
+    const count = (text) => countFor(text, limits.unit);
+    const whole = join([body, input.link ?? "", tagLine]);
+    if (count(whole) <= limits.text)
+        return { text: whole, used: count(whole) };
+    for (const tail of [[input.link ?? "", tagLine], [input.link ?? ""], []]) {
+        const tailText = join(tail);
+        const room = limits.text - (tailText === "" ? 0 : count(`\n\n${tailText}`));
+        if (room <= 0)
+            continue;
+        const cut = cutBody(body, room, count);
+        if (cut === "" && body !== "")
+            continue;
+        const text = join([cut, ...tail]);
+        const dropped = tail.length === 2
+            ? ""
+            : tail.length === 1
+                ? " and its hashtags"
+                : ", its hashtags and the link";
+        return {
+            text,
+            used: count(text),
+            notice: `The text was cut to fit ${siteName}'s ${String(limits.text)} characters${dropped}. Shorten it in the post's text box, or pick a shorter text source.`,
+        };
+    }
+    const text = cutBody(body, limits.text, count);
+    return {
+        text,
+        used: count(text),
+        notice: `The text was cut to fit ${siteName}'s ${String(limits.text)} characters. Shorten it in the post's text box.`,
+    };
+}
+function cutBody(body, room, count) {
+    if (count(body) <= room)
+        return body;
+    const sentences = body.match(/[^.!?\n]+(?:[.!?]+["')\]]*|\n+|$)/gu) ?? [body];
+    let kept = "";
+    for (const sentence of sentences) {
+        const next = kept + sentence;
+        if (count(next.trimEnd()) > room)
+            break;
+        kept = next;
+    }
+    if (kept.trim() !== "")
+        return kept.trim();
+    const words = body.split(/\s+/u);
+    let line = "";
+    for (const word of words) {
+        const next = line === "" ? word : `${line} ${word}`;
+        if (count(`${next}…`) > room)
+            break;
+        line = next;
+    }
+    return line === "" ? "" : `${line}…`;
+}
+// Hashtags for a post: the description's tags, then the shorts' hashtags, each written once as
+// a #Word without spaces or punctuation, at most `count`.
+export function hashtagsFor(sources, count) {
+    if (count <= 0)
+        return [];
+    const seen = new Set();
+    const tags = [];
+    for (const raw of sources.flat()) {
+        const word = raw
+            .replace(/^#+/u, "")
+            .split(/[^\p{L}\p{N}_]+/u)
+            .map((part, index) => (index === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1)))
+            .join("");
+        if (word === "" || /^\d+$/u.test(word))
+            continue;
+        const key = word.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        tags.push(`#${word}`);
+        if (tags.length >= count)
+            break;
+    }
+    return tags;
+}
+// The YouTube description without what only YouTube uses: its chapter lines and their heading,
+// and the hashtag lines at the end (the post gets its own).
+export function stripChapters(description) {
+    const lines = description.replace(/\r\n?/gu, "\n").split("\n");
+    const isChapter = (line) => {
+        const match = /^(\S+)\s+\S/u.exec(line.trim());
+        return match !== null && parseTimestamp(match[1] ?? "") !== undefined;
+    };
+    const kept = lines.filter((line, index) => {
+        if (isChapter(line))
+            return false;
+        const heading = /^(?:chapters|timestamps|contents)\s*:?\s*$/iu.test(line.trim());
+        return !(heading && isChapter(lines[index + 1] ?? ""));
+    });
+    const trailing = (line) => line.trim() === "" || /^(?:\s*#[\p{L}\p{N}_]+\s*)+$/u.test(line);
+    while (kept.length > 0 && trailing(kept.at(-1) ?? ""))
+        kept.pop();
+    return kept
+        .join("\n")
+        .replace(/\n{3,}/gu, "\n\n")
+        .trim();
+}

package/dist/slices/storage/arrange.js

@@ -1,6 +1,7 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmdirSync, statSync, writeFileSync, } from "node:fs";
 import { basename, dirname, extname, join } from "node:path";
 import { pickedShortsOf } from "../shorts/clips.js";
+import { notTemplateSample } from "../template-studio/repo.js";
 import { backupsFolderName, projectDir, renderCacheFolder } from "./layout.js";
 // The file in each project folder that says which project it is, for when the database and
 // the folders disagree (a restored database, a folder renamed by hand). Reconcile keeps it.
@@ -20,7 +21,8 @@ export function arrangeKeys(db) {
         (SELECT count(*)||':'||COALESCE(max(a.id),'') FROM project_assets a WHERE a.project_id=p.id) AS assets,
         (SELECT count(*)||':'||COALESCE(max(o.id),'') FROM outputs o WHERE o.project_id=p.id) AS legacy,
         (SELECT count(*)||':'||COALESCE(max(r.id),'') FROM revision_outputs r WHERE r.project_id=p.id AND r.selected=1 AND r.revision_id=h.revision_id) AS current
-       FROM projects p LEFT JOIN project_heads h ON h.project_id=p.id`)
+       FROM projects p LEFT JOIN project_heads h ON h.project_id=p.id
+       WHERE ${notTemplateSample("p")}`)
         .all())
         keys.set(String(row.id), [
             `layout ${layoutVersion}`,

package/dist/slices/storage/assets.js

@@ -1,5 +1,6 @@
 import { closeSync, fchmodSync, fstatSync, fsyncSync, mkdirSync, openSync, rmSync, writeFileSync, } from "node:fs";
 import { basename, dirname, isAbsolute, relative, sep } from "node:path";
+import { errorText, internalError } from "../../kernel/errors.js";
 import { redact } from "../../kernel/log.js";
 import { outputPath } from "./layout.js";
 export function allocateAsset(deps, projectId, filename) {
@@ -10,7 +11,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("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.");
+        throw new Error(internalError("a file name to save is not a plain file name"));
     mkdirSync(outputPath(deps.paths, projectId, "assets"), { recursive: true, mode: 0o700 });
     mkdirSync(directory, { mode: 0o700 });
     return { id, projectId, path, absolutePath };
@@ -20,7 +21,7 @@ export function sealAsset(deps, pending) {
     try {
         const stats = fstatSync(file);
         if (!stats.isFile())
-            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.");
+            throw new Error(internalError("a saved file is not a regular file"));
         fchmodSync(file, 0o600);
         fsyncSync(file);
         return {
@@ -58,7 +59,7 @@ export function discardPreparedAssets(deps, assets) {
             const filename = basename(asset.path);
             requireBasename(filename);
             if (asset.path !== `assets/${asset.id}/${filename}`) {
-                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.");
+                throw new Error(internalError("a prepared file is not in its allocated directory"));
             }
             const directory = outputPath(deps.paths, asset.projectId, `assets/${asset.id}`);
             const registered = deps.db
@@ -68,7 +69,7 @@ export function discardPreparedAssets(deps, assets) {
                 if (row.id === asset.id)
                     return true;
                 if (typeof row.path !== "string")
-                    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.");
+                    throw new Error(internalError("a saved file has no path"));
                 const inside = relative(directory, outputPath(deps.paths, asset.projectId, row.path));
                 return (inside === "" ||
                     (inside !== ".." && !inside.startsWith(`..${sep}`) && !isAbsolute(inside)));
@@ -92,17 +93,14 @@ function requireBasename(filename) {
         }) ||
         /[. ]$/.test(filename) ||
         /^(?:con|prn|aux|nul|conin\$|conout\$|com[1-9¹²³]|lpt[1-9¹²³])(?:\.|$)/i.test(filename))
-        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);
+        throw new Error(internalError("a file name to save is not allowed on every system"));
 }
 function warnCleanup(deps, projectId, error) {
     try {
-        deps.log.write("warn", "asset.cleanup", { projectId, detail: messageOf(error) });
+        deps.log.write("warn", "asset.cleanup", { projectId, detail: errorText(error) });
     }
     catch (loggingError) {
         // A full disk can prevent both cleanup and file logging; preserve the write error.
-        process.emitWarning(redact(`asset.cleanup ${projectId}: ${messageOf(error)}; logging failed: ${messageOf(loggingError)}`));
+        process.emitWarning(redact(`asset.cleanup ${projectId}: ${errorText(error)}; logging failed: ${errorText(loggingError)}`));
     }
 }

package/dist/slices/storage/backup-designs.js

@@ -0,0 +1,74 @@
+import { rowsOf } from "./backup-export.js";
+// Designs and design templates in a backup's library part. Their pictures travel with every
+// other picture in image_blobs; the files drawn from them are a cache and never travel.
+export const designTables = [
+    "designs",
+    "design_steps",
+    "design_templates",
+    "design_template_revisions",
+    "design_template_samples",
+];
+export function exportDesigns(db, put) {
+    put("designs", rowsOf(db, "SELECT * FROM designs ORDER BY rowid"));
+    put("design_steps", rowsOf(db, "SELECT * FROM design_steps ORDER BY design_id, n"));
+    put("design_templates", rowsOf(db, "SELECT * FROM design_templates ORDER BY rowid"));
+    put("design_template_revisions", rowsOf(db, "SELECT * FROM design_template_revisions ORDER BY template_id, version"));
+    put("design_template_samples", rowsOf(db, "SELECT * FROM design_template_samples ORDER BY rowid"));
+}
+// The project a design links to, when the one here is the backup's own (it came in with this
+// import, or with an earlier one: same id, same creation time); a different project that only
+// shares the id is not linked.
+function sameProject(db, scratch, id) {
+    if (typeof id !== "string")
+        return null;
+    const here = db.prepare("SELECT created_at FROM projects WHERE id=?").get(id);
+    const there = scratch.prepare("SELECT created_at FROM projects WHERE id=?").get(id);
+    return here !== undefined && there !== undefined && here.created_at === there.created_at
+        ? id
+        : null;
+}
+// Added beside what is here: a design or template this install already has (same id) is kept
+// as it is. A picture the other install was still making never lands here; a sample job it was
+// running starts over.
+export function mergeDesigns(db, scratch, insert) {
+    const has = (sql, id) => db.prepare(sql).get(id) !== undefined;
+    const templates = { added: 0, skipped: 0 };
+    for (const row of rowsOf(scratch, "SELECT * FROM design_templates ORDER BY rowid")) {
+        const id = String(row.id);
+        if (has("SELECT 1 FROM design_templates WHERE id=?", id)) {
+            templates.skipped += 1;
+            continue;
+        }
+        insert("design_templates", row);
+        for (const revision of rowsOf(scratch, "SELECT * FROM design_template_revisions WHERE template_id=? ORDER BY version", id))
+            insert("design_template_revisions", revision);
+        templates.added += 1;
+    }
+    const designs = { added: 0, skipped: 0 };
+    for (const row of rowsOf(scratch, "SELECT * FROM designs ORDER BY rowid")) {
+        const id = String(row.id);
+        // A template's hidden sample is not one of the person's designs, so it isn't counted.
+        if (has("SELECT 1 FROM designs WHERE id=?", id)) {
+            if (row.sample_of === null)
+                designs.skipped += 1;
+            continue;
+        }
+        insert("designs", { ...row, project_id: sameProject(db, scratch, row.project_id) });
+        for (const step of rowsOf(scratch, "SELECT * FROM design_steps WHERE design_id=? ORDER BY n", id))
+            insert("design_steps", step.state === "making"
+                ? {
+                    ...step,
+                    state: "failed",
+                    error: "Stopped by the backup. Press Try again.",
+                    settled_at: step.created_at ?? null,
+                }
+                : step);
+        if (row.sample_of === null)
+            designs.added += 1;
+    }
+    for (const row of rowsOf(scratch, "SELECT * FROM design_template_samples ORDER BY rowid"))
+        if (has("SELECT 1 FROM design_templates WHERE id=?", String(row.template_id)) &&
+            !has("SELECT 1 FROM design_template_samples WHERE template_id=?", String(row.template_id)))
+            insert("design_template_samples", row.state === "making" ? { ...row, state: "queued" } : row);
+    return { designs, templates };
+}

package/dist/slices/storage/backup-export.js

@@ -3,7 +3,10 @@ import { constants, lstatSync, readdirSync } from "node:fs";
 import { open } from "node:fs/promises";
 import { join } from "node:path";
 import { transact } from "../../kernel/db/tx.js";
+import { hasErrnoCode } from "../../kernel/errors.js";
+import { notTemplateSample } from "../template-studio/repo.js";
 import { projectMarker } from "./arrange.js";
+import { exportDesigns } from "./backup-designs.js";
 import { backupFormat, backupSchemaVersion, checksumsMember, fontMember, imageMember, libraryMember, manifestMember, projectFileMember, projectMember, projectTables, safeRelativePath, stagedMember, usageMember, } from "./backup-format.js";
 import { outputPath, projectDir, stagingPath } from "./layout.js";
 import { exportableSettings, installedUploadedFontFiles } from "./portable.js";
@@ -36,7 +39,7 @@ export function busyProjects(deps) {
          OR EXISTS(SELECT 1 FROM revision_work w WHERE w.project_id=p.id AND w.state='running')
          OR EXISTS(SELECT 1 FROM project_queue q WHERE q.project_id=p.id AND q.state='queued')
          AS busy
-       FROM projects p ORDER BY p.created_at, p.id`)
+       FROM projects p WHERE ${notTemplateSample("p")} ORDER BY p.created_at, p.id`)
         .all()
         .flatMap((row) => {
         const id = String(row.id);
@@ -60,7 +63,7 @@ export function planBackup(deps) {
             },
         },
         projects: deps.db
-            .prepare("SELECT id,title FROM projects ORDER BY created_at,id")
+            .prepare(`SELECT id,title FROM projects WHERE ${notTemplateSample()} ORDER BY created_at,id`)
             .all()
             .map((row) => projectSnapshot(deps, String(row.id), String(row.title))),
     }));
@@ -238,7 +241,7 @@ function projectFiles(root) {
             entries = readdirSync(join(root, relative), { withFileTypes: true });
         }
         catch (error) {
-            if (error instanceof Error && "code" in error && error.code === "ENOENT")
+            if (hasErrnoCode(error, "ENOENT"))
                 return;
             throw error;
         }
@@ -271,6 +274,7 @@ function librarySnapshot(deps) {
     put("narration_aliases", rowsOf(db, "SELECT * FROM narration_aliases ORDER BY position,rowid"));
     put("project_templates", rowsOf(db, "SELECT * FROM project_templates ORDER BY rowid"));
     put("project_template_revisions", rowsOf(db, "SELECT * FROM project_template_revisions ORDER BY template_id,version"));
+    put("template_gates", rowsOf(db, "SELECT * FROM template_gates ORDER BY template_id,version"));
     put("schedules", rowsOf(db, "SELECT * FROM schedules ORDER BY rowid"));
     put("schedule_runs", rowsOf(db, "SELECT * FROM schedule_runs ORDER BY rowid"));
     put("schedule_topics", rowsOf(db, "SELECT * FROM schedule_topics ORDER BY rowid"));
@@ -281,6 +285,7 @@ function librarySnapshot(deps) {
     put("episode_memories", rowsOf(db, "SELECT * FROM episode_memories ORDER BY rowid"));
     put("channel_videos", rowsOf(db, "SELECT * FROM channel_videos ORDER BY rowid"));
     put("standalone_usage", rowsOf(db, "SELECT * FROM standalone_usage ORDER BY rowid"));
+    exportDesigns(db, put);
     // Every picture, not only the cast's: a project's config names the pictures it was started
     // with by hash, and a Rebuild reads them from here.
     const images = db

package/dist/slices/storage/backup-format.js

@@ -75,6 +75,8 @@ export const projectTables = [
     "plan_limit_readings",
     "project_channels",
     "project_trash",
+    // Since 4.0.0: each project's posts to other sites, their hand edits and links.
+    "social_posts",
 ];
 export const libraryTables = [
     "settings",
@@ -103,6 +105,14 @@ export const libraryTables = [
     // Since 3.0.0: what topic generation, episode summaries and cast pictures cost, which
     // belongs to a schedule or channel rather than a project.
     "standalone_usage",
+    // Since 4.0.0: which template versions the template studio marked ready.
+    "template_gates",
+    // Since 4.0.0: designs with every version of their picture, and design templates.
+    "designs",
+    "design_steps",
+    "design_templates",
+    "design_template_revisions",
+    "design_template_samples",
 ];
 export const usageTables = ["telemetry_events"];
 // Ceilings a well-formed backup of a real install stays far below. They bound what a hostile

package/dist/slices/storage/backup-import.js

@@ -16,6 +16,7 @@ import { projectTemplateSchema } from "../project-templates/schema.js";
 import { revisionById } from "../revisions/repo.js";
 import { runsForSchedule, scheduleRows } from "../schedules/repo.js";
 import { allTelemetryEvents } from "../telemetry/repo.js";
+import { mergeDesigns } from "./backup-designs.js";
 import { projectRows, rowsOf } from "./backup-export.js";
 import { backupMaxJsonBytes, backupMaxManifestBytes, backupSchemaVersion, checksumsMember, checksumsSchema, fontMember, imageMember, libraryMember, libraryPartSchema, libraryTables, manifestHead, manifestMember, manifestSchema, projectFileMember, projectMember, projectPartSchema, projectTables, stagedMember, usageMember, usagePartSchema, usageTables, } from "./backup-format.js";
 import { outputPath, projectDir, stagingPath } from "./layout.js";
@@ -382,6 +383,8 @@ function loadScratch(clock, manifest, library, usage, parts) {
             // broken fails there, and the upgrade's own message would talk about downgrading.
             throw damaged("some of its records point at records it doesn't hold.");
         }
+        // A design only links to a project; one whose project didn't travel stays, unlinked.
+        scratch.exec("UPDATE designs SET project_id=NULL WHERE project_id NOT IN (SELECT id FROM projects)");
         if (scratch.prepare("PRAGMA foreign_key_check").all().length > 0)
             throw damaged("some of its records point at records it doesn't hold.");
         return scratch;
@@ -433,7 +436,7 @@ function checkScratch(deps, scratch, library, parts) {
         }
     }
     catch {
-        throw unreadable("a PDF theme");
+        throw unreadable("a PDF look");
     }
     try {
         for (const row of rowsOf(scratch, "SELECT id FROM channels")) {
@@ -462,7 +465,7 @@ function checkScratch(deps, scratch, library, parts) {
             throw new Error("staged files");
     }
     catch {
-        throw unreadable("a Play draft");
+        throw unreadable("a draft on Create");
     }
     try {
         allTelemetryEvents(scratch);
@@ -633,6 +636,8 @@ function commit(deps, work, manifest, prepared) {
                     }
                     insertRow(db, "project_template_revisions", next);
                 }
+                for (const gate of rowsOf(scratch, "SELECT * FROM template_gates WHERE template_id=? ORDER BY version", id))
+                    insertRow(db, "template_gates", gate);
                 if (renamed)
                     templates.renamed += 1;
                 else
@@ -640,8 +645,15 @@ function commit(deps, work, manifest, prepared) {
             }
             const schedules = { added: 0, renamed: 0, skipped: 0, paused: 0 };
             for (const schedule of rowsOf(scratch, "SELECT * FROM schedules ORDER BY rowid")) {
-                if (has("SELECT 1 FROM schedules WHERE id=?", String(schedule.id)) ||
-                    !has("SELECT 1 FROM project_template_revisions WHERE template_id=? AND version=?", String(schedule.template_id), Number(schedule.template_version))) {
+                // A design schedule's template comes in with the designs, further down.
+                const design = schedule.template_kind === "design";
+                const templateHere = design
+                    ? scratch
+                        .prepare("SELECT 1 FROM design_templates WHERE id=?")
+                        .get(String(schedule.template_id)) !== undefined ||
+                        has("SELECT 1 FROM design_templates WHERE id=?", String(schedule.template_id))
+                    : has("SELECT 1 FROM project_template_revisions WHERE template_id=? AND version=?", String(schedule.template_id), Number(schedule.template_version));
+                if (has("SELECT 1 FROM schedules WHERE id=?", String(schedule.id)) || !templateHere) {
                     schedules.skipped += 1;
                     continue;
                 }
@@ -732,6 +744,10 @@ function commit(deps, work, manifest, prepared) {
                 move(folder, projectDir(paths, listed.id));
                 imported.push({ id: listed.id, title: listed.title });
             }
+            // After the projects, so a design keeps its link to one that came in with it.
+            const merged = mergeDesigns(db, scratch, (table, row) => {
+                insertRow(db, table, row);
+            });
             const summary = {
                 backup: {
                     id: manifest.backupId,
@@ -748,6 +764,8 @@ function commit(deps, work, manifest, prepared) {
                 schedules,
                 voices: { added: voicesAdded, renamed: 0, skipped: voicesSkipped },
                 drafts,
+                designs: { ...merged.designs, renamed: 0 },
+                designTemplates: { ...merged.templates, renamed: 0 },
                 settings: { added: settingsAdded, kept: settingsKept },
                 fonts,
                 usage: { events, alreadyImported },

package/dist/slices/storage/delete-project.js

@@ -1,6 +1,8 @@
 import { rmSync } from "node:fs";
+import { errorText } from "../../kernel/errors.js";
 import { derive } from "../../kernel/runner/graph.js";
 import { stagesOf } from "../admission/repo.js";
+import { dropReshaped } from "../social/reshape.js";
 import { projectDir, renderCacheDir } from "./layout.js";
 // A run in flight: a call the runner holds, or a stage running or waiting out a retry.
 export function projectBusy(deps, projectId) {
@@ -19,13 +21,15 @@ export function deleteProject(deps, projectId) {
     try {
         rmSync(dir, { recursive: true, force: true });
         rmSync(renderCacheDir(deps.paths, projectId), { recursive: true, force: true });
+        // The pictures cut for its posts (`slices/social/reshape.ts`).
+        dropReshaped(deps.paths, projectId);
     }
     catch (error) {
         deps.log.write("warn", "project.delete", {
             projectId,
-            detail: messageOf(error),
+            detail: errorText(error),
         });
-        return { ok: false, reason: "files", detail: messageOf(error) };
+        return { ok: false, reason: "files", detail: errorText(error) };
     }
     // Stages, attempts, pieces and outputs go with it: every one of those tables declares
     // ON DELETE CASCADE on the project, and the connection runs with foreign keys on
@@ -36,6 +40,3 @@ export function deleteProject(deps, projectId) {
         places.forget(projectId);
     return { ok: true };
 }
-function messageOf(error) {
-    return error instanceof Error ? error.message : String(error);
-}

package/dist/slices/storage/files-location.js

@@ -3,8 +3,9 @@ import { createReadStream, lstatSync, readdirSync } from "node:fs";
 import { access, constants, copyFile, lstat, mkdir, readdir, rename, statfs, utimes, } from "node:fs/promises";
 import { dirname, isAbsolute, join, parse, relative, resolve, sep } from "node:path";
 import { z } from "zod";
+import { errorText, hasErrnoCode } from "../../kernel/errors.js";
 import { repoint } from "../../kernel/paths.js";
-import { readSetting, writeSetting } from "../settings/repo.js";
+import { deleteSetting, readSetting, writeSetting } from "../settings/repo.js";
 import { backupsFolderName, renderCacheFolder } from "./layout.js";
 // Where the files a user looks at live: project folders, scheduled backups and anything else
 // Slopify saves for them. New installs keep them in <Documents>/Slopify; installs from before
@@ -73,7 +74,7 @@ export async function ensureFilesFolders(layout) {
 }
 async function emptyOrMissing(path) {
     const entries = await readdir(path).catch((error) => {
-        if (hasCode(error, "ENOENT"))
+        if (hasErrnoCode(error, "ENOENT"))
             return [];
         throw error;
     });
@@ -172,7 +173,7 @@ export function createFilesService(deps) {
             finished = {
                 ...current.progress,
                 phase: "failed",
-                error: error instanceof Error ? error.message : String(error),
+                error: errorText(error),
             };
         })
             .finally(() => {
@@ -294,7 +295,7 @@ function sourceFiles(pair) {
             entries = readdirSync(dir, { withFileTypes: true });
         }
         catch (error) {
-            if (hasCode(error, "ENOENT"))
+            if (hasErrnoCode(error, "ENOENT"))
                 return;
             throw error;
         }
@@ -383,7 +384,7 @@ async function runMove(deps, from, target, pairs, update) {
     }
     const to = { kind: "root", root: target };
     writeSetting(deps.db, filesLocationKey, JSON.stringify(to));
-    deps.db.prepare("DELETE FROM settings WHERE key=?").run(filesMoveKey);
+    deleteSetting(deps.db, filesMoveKey);
     const old = from.kind === "root" ? from.root : deps.paths.projects;
     repoint(deps.paths, filesLayoutOf(to, deps.paths.dataDir));
     return old;
@@ -514,9 +515,6 @@ function within(root, path) {
 function samePath(a, b) {
     return relative(resolve(a), resolve(b)) === "";
 }
-function hasCode(error, code) {
-    return typeof error === "object" && error !== null && "code" in error && error.code === code;
-}
 function formatBytes(bytes) {
     if (!Number.isFinite(bytes))
         return "unknown";

package/dist/slices/storage/layout.js

@@ -1,6 +1,11 @@
 import { extname, isAbsolute, relative, resolve } from "node:path";
-// A project's folder: its readable name once it has one (`places.ts`), its id until then.
+import { internalError } from "../../kernel/errors.js";
+import { templateSamplesDir } from "../../kernel/paths.js";
+// A project's folder: its readable name once it has one (`places.ts`), its id until then. A
+// template's studio sample is kept in the data dir by its id, out of the user's Projects folder.
 export function projectDir(paths, projectId) {
+    if (paths.samples?.has(projectId) === true)
+        return contained(templateSamplesDir(paths), projectId);
     return contained(paths.projects, paths.places?.folderOf(projectId) ?? projectId);
 }
 // The clips of each project's last render (`slices/video/clip-cache.ts`). Hidden, so
@@ -8,10 +13,14 @@ export function projectDir(paths, projectId) {
 // files leaves it behind and a render simply encodes its clips again.
 export const renderCacheFolder = ".render-cache";
 export function renderCacheDir(paths, projectId) {
+    if (paths.samples?.has(projectId) === true)
+        return contained(templateSamplesDir(paths), `${renderCacheFolder}/${projectId}`);
     return contained(paths.projects, `${renderCacheFolder}/${projectId}`);
 }
 // A stored path on disk: where it was moved to (`places.ts`), or the stored path itself.
 export function outputPath(paths, projectId, relativePath) {
+    if (paths.samples?.has(projectId) === true)
+        return contained(projectDir(paths, projectId), relativePath);
     return contained(projectDir(paths, projectId), paths.places?.placeOf(projectId, relativePath) ?? relativePath);
 }
 // Scheduled backups (slices/backups) land in paths.backups unless the user picks another
@@ -31,7 +40,7 @@ function contained(root, path) {
     const target = resolve(root, path);
     const inside = relative(root, target);
     if (inside === "" || inside.startsWith("..") || isAbsolute(inside)) {
-        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.`);
+        throw new Error(internalError(`the saved file path ${path} resolves outside ${root}`));
     }
     return target;
 }
@@ -111,6 +120,8 @@ export function outputFileName(role, index, extension, stageKind) {
             return `audio-levelled${extension}`;
         case "reference":
             return `reference${extension}`;
+        case "social_post":
+            return `social/post-${String(index).padStart(2, "0")}.txt`;
         case "image":
             return `images/${String(index).padStart(3, "0")}${extension}`;
     }

package/dist/slices/storage/model.js

@@ -52,5 +52,8 @@ export const outputRoles = [
     // Level the volume: a narration segment joined again from its pieces, each brought to one
     // loudness first (`meta.segment` says which). The exports play it in place of the plain join.
     "audio_levelled",
+    // A post for another site written by a Library prompt of kind "post" (`slices/social`);
+    // `meta.platform` says which site.
+    "social_post",
 ];
 export const stagedFileStates = ["copying", "staged"];