Function upsertSectionContent

extensions/site-studio/extension.mjs:714–739

(sectionId, field, value, mark = "draft", author = "agent")

}

function upsertSectionContent(sectionId, field, value, mark = "draft", author = "agent") {
    const section = findSectionOrThrow(sectionId);
    const normalizedField = safeString(field).trim();
    if (!normalizedField) {
        throw new CanvasError("invalid_field", "Field name is required.");
    }
    if (isUnsafeFieldName(normalizedField)) {
        throw new CanvasError("invalid_field", `Field name "${normalizedField}" is not allowed.`);
    }
    const normalizedValue = safeString(value, "");
    validateFieldValue(section.id, normalizedField, normalizedValue, mark);
    const current = safeString(section.content[normalizedField], "");
    section.content[normalizedField] = normalizedValue;
    section.lastModified = nowIso();
    stateCache.lastUpdated = section.lastModified;
    addChange({
        type: "file_modified",
        summary: `Content updated for ${section.name}.${normalizedField} (${mark}).`,
        timestamp: section.lastModified,
        sectionId: section.id,
    });
    if (author === "human") {
        addNote(sectionId, `Updated field "${normalizedField}" (${mark}).`, "human");
    }
    return { section, field: normalizedField, current, value: normalizedValue };
}

function isSamplePlaceholder(value) {
    return /^\[sample:/i.test(safeString(value).trim());