@studiotitta/studio-editori 0.1.0

package/dist/palvelin/kaannos.js

@@ -0,0 +1,102 @@
+/* ==========================================================================
+   KÄÄNNÖSEHDOTUKSET
+   ==========================================================================
+   Täydentää puuttuvat käännökset ehdotuksina. Kuten kuvatekstissä, kyse on
+   ehdotuksesta: teksti ilmestyy kenttiin, ja muokkaaja lukee sen ennen kuin
+   painaa Tallenna.
+
+   Automaattista käännöstä ei tehdä missään vaiheessa. Käännös, joka menee
+   julkaisuun ilman että kukaan lukee sitä, on riski juuri niillä sivustoilla,
+   joissa tekstit on kirjoitettu tarkasti — ja niitä nämä sivustot ovat.
+
+   **Tekstit lähetetään Anthropicin rajapintaan.** Sama maininta
+   tietosuojaselosteeseen kuin kuvatekstiehdotuksessa.
+   ========================================================================== */
+/** Yhdellä kerralla käännettävä määrä. Kurssi on kymmeniä rivejä, ei kirja. */
+const ENINTAAN_MERKKEJA = 20000;
+const KIELTEN_NIMET = {
+    fi: "suomi",
+    en: "englanti",
+    sv: "ruotsi",
+    de: "saksa",
+};
+function kielenNimi(koodi) {
+    return KIELTEN_NIMET[koodi] ?? koodi;
+}
+export function kaannosAvain(asetukset = {}) {
+    return (asetukset.avain ??
+        process.env.EDITORI_KAANNOS_AVAIN ??
+        process.env.EDITORI_KUVATEKSTI_AVAIN ??
+        process.env.ANTHROPIC_API_KEY);
+}
+function ohje(lahde, kohde) {
+    return [
+        `Käännä seuraavan JSON-olion arvot kielestä ${kielenNimi(lahde)} kielelle ${kielenNimi(kohde)}.`,
+        "",
+        "Säännöt:",
+        "- Säilytä rakenne täsmälleen: samat avaimet, listat listoina, yhtä monta kohtaa.",
+        "- Käännä vain arvot, älä avaimia.",
+        "- Säilytä sävy ja pituus. Älä selitä, kaunistele äläkä lisää mitään.",
+        "- Pidä numerot, hinnat, päivämäärät ja erisnimet ennallaan.",
+        "- Jos arvo on tyhjä, jätä se tyhjäksi.",
+        "- Vastaa pelkällä JSON-oliolla ilman koodilohkoa tai selityksiä.",
+    ].join("\n");
+}
+function samaMuoto(alkuperainen, tulos) {
+    if (typeof tulos !== "object" || tulos === null || Array.isArray(tulos))
+        return null;
+    const data = tulos;
+    const siistitty = {};
+    for (const [avain, arvo] of Object.entries(alkuperainen)) {
+        const kaannos = data[avain];
+        if (typeof arvo === "string") {
+            if (typeof kaannos === "string")
+                siistitty[avain] = kaannos;
+        }
+        else if (Array.isArray(kaannos)) {
+            /* Kappalemäärän on täsmättävä: muuten sivulle tulisi eri määrä
+               kappaleita kuin alkuperäisessä, ja ero jäisi huomaamatta. */
+            const rivit = kaannos.filter((rivi) => typeof rivi === "string");
+            if (rivit.length === arvo.length)
+                siistitty[avain] = rivit;
+        }
+    }
+    return Object.keys(siistitty).length > 0 ? siistitty : null;
+}
+/**
+ * Kääntää annetut tekstit, tai palauttaa `null` jos ominaisuus ei ole
+ * käytössä tai vastaus ei ollut odotetun muotoinen.
+ */
+export async function kaannaTekstit(tekstit, lahdekieli, kohdekieli, asetukset = {}) {
+    const avain = kaannosAvain(asetukset);
+    if (!avain)
+        return null;
+    if (Object.keys(tekstit).length === 0)
+        return null;
+    const sisalto = JSON.stringify(tekstit);
+    if (sisalto.length > ENINTAAN_MERKKEJA)
+        return null;
+    try {
+        const { default: Anthropic } = await import("@anthropic-ai/sdk");
+        const asiakas = new Anthropic({ apiKey: avain });
+        const vastaus = await asiakas.messages.create({
+            model: "claude-opus-5",
+            max_tokens: 8000,
+            system: ohje(lahdekieli, kohdekieli),
+            messages: [{ role: "user", content: sisalto }],
+        });
+        if (vastaus.stop_reason === "refusal")
+            return null;
+        const teksti = vastaus.content
+            .filter((osa) => osa.type === "text")
+            .map((osa) => osa.text)
+            .join("")
+            .trim()
+            .replace(/^```(?:json)?\s*|\s*```$/g, "");
+        return samaMuoto(tekstit, JSON.parse(teksti));
+    }
+    catch (virhe) {
+        console.error("[editori] Käännösehdotus epäonnistui:", virhe);
+        return null;
+    }
+}

package/dist/palvelin/kaannosreitti.d.ts

@@ -0,0 +1,9 @@
+import type { EditorinAsetukset } from "./asetukset.ts";
+import { type KaannosAsetukset } from "./kaannos.ts";
+import type { SisallonMaarittely } from "../maarittely.ts";
+export interface KaannoksenAsetukset extends Partial<EditorinAsetukset> {
+    sisalto?: SisallonMaarittely;
+    /** `false` sulkee käännösehdotukset, vaikka avain olisi asetettu. */
+    kaannos?: KaannosAsetukset | false;
+}
+export declare function kaannosReitti(yliajot: KaannoksenAsetukset): (pyynto: Request) => Promise<Response>;

package/dist/palvelin/kaannosreitti.js

@@ -0,0 +1,42 @@
+/* Käännösehdotusten reitti. Vain kirjautuneelle muokkaajalle. */
+import { asetuksetTaiNull, json, muokkaajaPyynnosta } from "./apurit.js";
+import { kaannaTekstit, kaannosAvain, } from "./kaannos.js";
+export function kaannosReitti(yliajot) {
+    return async function kaanna(pyynto) {
+        const asetukset = asetuksetTaiNull(yliajot);
+        if (!asetukset)
+            return json({ virhe: "Editori ei ole käytössä." }, 503);
+        const muokkaaja = await muokkaajaPyynnosta(pyynto, asetukset);
+        if (!muokkaaja)
+            return json({ virhe: "Kirjaudu sisään." }, 401);
+        if (yliajot.kaannos === false || !kaannosAvain(yliajot.kaannos ?? {})) {
+            return json({ virhe: "Käännösehdotukset eivät ole käytössä tällä sivustolla." }, 503);
+        }
+        let data;
+        try {
+            data = (await pyynto.json());
+        }
+        catch {
+            return json({ virhe: "Pyyntö ei ollut kelvollista JSONia." }, 400);
+        }
+        const kielet = yliajot.sisalto?.kielet ?? [];
+        const { lahdekieli, kohdekieli, tekstit } = data;
+        /* Kielet tarkistetaan sisältömallia vasten: selain ei saa pyytää
+           käännöstä kielelle, jota sivustolla ei ole. */
+        if (typeof lahdekieli !== "string" ||
+            typeof kohdekieli !== "string" ||
+            !kielet.includes(lahdekieli) ||
+            !kielet.includes(kohdekieli) ||
+            lahdekieli === kohdekieli) {
+            return json({ virhe: "Kieliä ei tunnistettu." }, 400);
+        }
+        if (!tekstit || typeof tekstit !== "object" || Array.isArray(tekstit)) {
+            return json({ virhe: "Käännettävät tekstit puuttuvat." }, 400);
+        }
+        const kaannokset = await kaannaTekstit(tekstit, lahdekieli, kohdekieli, yliajot.kaannos ?? {});
+        if (!kaannokset) {
+            return json({ virhe: "Käännöstä ei saatu. Yritä uudelleen tai kirjoita teksti itse." }, 502);
+        }
+        return json({ kaannokset });
+    };
+}

package/dist/palvelin/kirjautuminen.d.ts

@@ -0,0 +1,25 @@
+import { type EditorinAsetukset } from "./asetukset.ts";
+/** Testejä varten. */
+export declare function nollaaYritykset(): void;
+/**
+ * Kytkee Nextin Draft Moden päälle tai pois.
+ *
+ * Draft Mode on se kytkin, jonka takia kirjautunut muokkaaja saa sivun
+ * palvelimelta joka kerta uudestaan ja muut kävijät saman valmiiksi
+ * rakennetun staattisen sivun kuin ennenkin. Ilman sitä muokkaustila
+ * pakottaisi koko sivuston dynaamiseksi kaikille.
+ *
+ * Huom: Draft Mode ei ole tunnistautuminen, vaan pelkkä välimuistin ohitus.
+ * Oikeudet tarkistetaan aina editorin omasta istunnosta.
+ */
+export declare function muokkaustila(paalle: boolean): Promise<void>;
+export interface KirjautumisenAsetukset extends Partial<EditorinAsetukset> {
+    /** Sivuston nimi kirjautumisviestissä. Oletuksena pyynnön verkkotunnus. */
+    sivustonNimi?: string;
+}
+export declare function kirjautumisenReitit(yliajot?: KirjautumisenAsetukset): {
+    kirjaudu: (pyynto: Request) => Promise<Response>;
+    vahvista: (pyynto: Request) => Promise<Response>;
+    ulos: (pyynto: Request) => Promise<Response>;
+    avaaMuokkaustila: (pyynto: Request) => Promise<Response>;
+};

package/dist/palvelin/kirjautuminen.js

@@ -0,0 +1,183 @@
+/* ==========================================================================
+   KIRJAUTUMISEN REITIT
+   ==========================================================================
+   Sivusto ottaa editorin käyttöön yhdellä tiedostolla:
+
+     // app/api/editori/[...polku]/route.ts
+     import { editorinReitit } from "@studiotitta/studio-editori/palvelin";
+     export const { GET, POST } = editorinReitit();
+
+   Kulku:
+     1. Muokkaaja kirjoittaa sähköpostiosoitteensa sivulla /editori.
+     2. POST /api/editori/kirjaudu lähettää linkin, jos osoite on sallittu.
+     3. GET  /api/editori/vahvista?tunnus=… asettaa istunnon evästeen.
+     4. POST /api/editori/ulos päättää istunnon.
+
+   Periaatteet:
+   - **Vastaus on aina sama**, oli osoite sallittu tai ei. Muuten sivustolta
+     voisi kysellä, kuka sitä saa muokata.
+   - **Salasanoja ei ole.** Sähköpostilaatikko on tunnistautuminen.
+   - **Linkki on lyhytikäinen ja sidottu selaimeen**, josta se pyydettiin.
+   - **Yritysten määrä on rajattu** samasta osoitteesta ja samalta koneelta.
+   ========================================================================== */
+import { normalisoiOsoite, onSallittuMuokkaaja } from "./asetukset.js";
+import { asetuksetTaiNull, lueEvaste, muokkaajaPyynnosta, ohjaa, onSuojattu } from "./apurit.js";
+import { EVASTE_ISTUNTO, EVASTE_PYYNTO, evaste, poistaEvaste } from "./istunto.js";
+import { lahetaKirjautumislinkki } from "./posti.js";
+import { luoTunnus, lueTunnus, satunnainen, tiiviste } from "./tunnus.js";
+/* ---- Yritysten rajoitus -------------------------------------------------
+   Yksinkertainen laskuri palvelimen muistissa. Se ei ole aukoton
+   hajautetussa ympäristössä, mutta pysäyttää tavallisen yrityksen arvailla
+   osoitteita tai kuormittaa sähköpostilähetystä. Oikea suoja on se, ettei
+   linkki mene muille kuin sallituille osoitteille.
+------------------------------------------------------------------------- */
+const YRITYKSET = new Map();
+const IKKUNA_MS = 15 * 60 * 1000;
+const ENINTAAN = 5;
+function liikaaYrityksia(avain, nyt = Date.now()) {
+    const aiemmat = (YRITYKSET.get(avain) ?? []).filter((aika) => nyt - aika < IKKUNA_MS);
+    aiemmat.push(nyt);
+    YRITYKSET.set(avain, aiemmat);
+    return aiemmat.length > ENINTAAN;
+}
+/** Testejä varten. */
+export function nollaaYritykset() {
+    YRITYKSET.clear();
+}
+/**
+ * Kytkee Nextin Draft Moden päälle tai pois.
+ *
+ * Draft Mode on se kytkin, jonka takia kirjautunut muokkaaja saa sivun
+ * palvelimelta joka kerta uudestaan ja muut kävijät saman valmiiksi
+ * rakennetun staattisen sivun kuin ennenkin. Ilman sitä muokkaustila
+ * pakottaisi koko sivuston dynaamiseksi kaikille.
+ *
+ * Huom: Draft Mode ei ole tunnistautuminen, vaan pelkkä välimuistin ohitus.
+ * Oikeudet tarkistetaan aina editorin omasta istunnosta.
+ */
+export async function muokkaustila(paalle) {
+    try {
+        const { draftMode } = await import("next/headers");
+        const tila = await draftMode();
+        if (paalle)
+            tila.enable();
+        else
+            tila.disable();
+    }
+    catch {
+        /* Nextin ulkopuolella (testit) tätä ei ole — ei este. */
+    }
+}
+export function kirjautumisenReitit(yliajot = {}) {
+    async function kirjaudu(pyynto) {
+        const asetukset = asetuksetTaiNull(yliajot);
+        if (!asetukset)
+            return ohjaa(pyynto, "ei-kaytossa");
+        let osoite = "";
+        try {
+            const lomake = await pyynto.formData();
+            const arvo = lomake.get("sahkoposti");
+            osoite = typeof arvo === "string" ? normalisoiOsoite(arvo) : "";
+        }
+        catch {
+            return ohjaa(pyynto, "virhe");
+        }
+        const kone = pyynto.headers.get("x-forwarded-for")?.split(",")[0]?.trim() ?? "tuntematon";
+        if (liikaaYrityksia(`${kone}|${osoite}`))
+            return ohjaa(pyynto, "liikaa");
+        /*
+          Selainsidoksen eväste asetetaan aina, myös tuntemattomalle osoitteelle.
+          Muuten vastaukset eroaisivat toisistaan juuri sen verran, että evästeen
+          olemassaolosta voisi päätellä, kuka saa muokata sivustoa.
+        */
+        const pyynnonSatunnainen = satunnainen();
+        const evasteet = asetukset.selainsidos
+            ? [
+                evaste(EVASTE_PYYNTO, pyynnonSatunnainen, {
+                    maxAge: asetukset.linkinKestoMinuuttia * 60,
+                    suojattu: onSuojattu(pyynto),
+                }),
+            ]
+            : [];
+        /* Vastaus on sama riippumatta siitä, onko osoite sallittu. */
+        if (!osoite.includes("@") || !onSallittuMuokkaaja(osoite, asetukset)) {
+            return ohjaa(pyynto, "lahetetty", evasteet);
+        }
+        const tunnus = await luoTunnus({
+            laji: "kirjautuminen",
+            sahkoposti: osoite,
+            vanhenee: Math.floor(Date.now() / 1000) + asetukset.linkinKestoMinuuttia * 60,
+            satunnainen: satunnainen(),
+            ...(asetukset.selainsidos ? { sidos: await tiiviste(pyynnonSatunnainen) } : {}),
+        }, asetukset.avain);
+        const linkki = new URL("/api/editori/vahvista", pyynto.url);
+        linkki.searchParams.set("tunnus", tunnus);
+        await lahetaKirjautumislinkki({
+            vastaanottaja: osoite,
+            linkki: linkki.toString(),
+            sivusto: yliajot.sivustonNimi ?? new URL(pyynto.url).host,
+        }, asetukset);
+        return ohjaa(pyynto, "lahetetty", evasteet);
+    }
+    async function vahvista(pyynto) {
+        const asetukset = asetuksetTaiNull(yliajot);
+        if (!asetukset)
+            return ohjaa(pyynto, "ei-kaytossa");
+        const tunnus = new URL(pyynto.url).searchParams.get("tunnus") ?? "";
+        const sisalto = await lueTunnus(tunnus, asetukset.avain, "kirjautuminen");
+        if (!sisalto || !onSallittuMuokkaaja(sisalto.sahkoposti, asetukset)) {
+            return ohjaa(pyynto, "vanhentunut");
+        }
+        if (sisalto.sidos) {
+            const selaimessa = lueEvaste(pyynto, EVASTE_PYYNTO);
+            if (!selaimessa || (await tiiviste(selaimessa)) !== sisalto.sidos) {
+                return ohjaa(pyynto, "toinen-selain");
+            }
+        }
+        const istunto = await luoTunnus({
+            laji: "istunto",
+            sahkoposti: sisalto.sahkoposti,
+            vanhenee: Math.floor(Date.now() / 1000) + asetukset.istunnonKestoPaivaa * 24 * 60 * 60,
+            satunnainen: satunnainen(),
+        }, asetukset.avain);
+        await muokkaustila(true);
+        const suojattu = onSuojattu(pyynto);
+        return ohjaa(pyynto, "sisalla", [
+            evaste(EVASTE_ISTUNTO, istunto, {
+                maxAge: asetukset.istunnonKestoPaivaa * 24 * 60 * 60,
+                suojattu,
+            }),
+            poistaEvaste(EVASTE_PYYNTO, suojattu),
+        ]);
+    }
+    async function ulos(pyynto) {
+        await muokkaustila(false);
+        return ohjaa(pyynto, "ulkona", [poistaEvaste(EVASTE_ISTUNTO, onSuojattu(pyynto))]);
+    }
+    /**
+     * Kytkee muokkaustilan päälle ja palaa sivustolle.
+     *
+     * Tarvitaan, koska Next sitoo muokkaustilan siihen julkaisuun, jossa se
+     * kytkettiin: jokainen uusi julkaisu katkaisee sen, vaikka muokkaajan oma
+     * istunto on yhä voimassa. Ilman tätä muokkaaja luulisi, että editori
+     * katosi — ja kirjautuisi turhaan ulos ja sisään.
+     */
+    async function avaaMuokkaustila(pyynto) {
+        const asetukset = asetuksetTaiNull(yliajot);
+        if (!asetukset)
+            return ohjaa(pyynto, "ei-kaytossa");
+        const muokkaaja = await muokkaajaPyynnosta(pyynto, asetukset);
+        if (!muokkaaja)
+            return ohjaa(pyynto, "vanhentunut");
+        await muokkaustila(true);
+        /* Kohde tulee osoitteesta, joten se pitää rajata omaan sivustoon: avoin
+           uudelleenohjaus olisi valmis kalasteluväline. */
+        const pyydetty = new URL(pyynto.url).searchParams.get("kohde") ?? "/";
+        const kohde = pyydetty.startsWith("/") && !pyydetty.startsWith("//") ? pyydetty : "/";
+        return new Response(null, {
+            status: 303,
+            headers: { Location: new URL(kohde, pyynto.url).toString() },
+        });
+    }
+    return { kirjaudu, vahvista, ulos, avaaMuokkaustila };
+}

package/dist/palvelin/kuvat.d.ts

@@ -0,0 +1,29 @@
+import { type KuvatekstiAsetukset } from "./kuvateksti.ts";
+import type { EditorinAsetukset } from "./asetukset.ts";
+import type { GithubAsetukset } from "./github/yhteys.ts";
+export interface Kuvapyynto {
+    /** Kuvan tavut. */
+    tavut: Uint8Array;
+    /** Mihin kansioon kuva kuuluu, esim. "kurssit". */
+    kansio: string;
+    /** Kuvasuhde, jos kenttä on sellaisen määritellyt. */
+    suhde?: number;
+}
+export type Kuvankasittely = (pyynto: Kuvapyynto) => Promise<Uint8Array>;
+export interface KuvienAsetukset extends Partial<EditorinAsetukset> {
+    github?: Partial<GithubAsetukset>;
+    /** Sivuston oma käsittely: valotus, värit, rajaus, pienennys. */
+    kuvankasittely?: Kuvankasittely;
+    /**
+     * Ehdotus vaihtoehtoiseksi tekstiksi. `false` sulkee ominaisuuden, vaikka
+     * avain olisi asetettu. Oletuksena päällä, jos avain löytyy.
+     */
+    kuvateksti?: KuvatekstiAsetukset | false;
+    /**
+     * Sivuston mediakansio repossa, oletuksena "public/kuvat". Sivustoilla,
+     * joilla kuvat ovat jo muualla (esim. "public/media"), tämä pidetään
+     * samana kuin olemassa olevilla kuvilla.
+     */
+    kuvakansio?: string;
+}
+export declare function kuvienReitti(yliajot: KuvienAsetukset): (pyynto: Request) => Promise<Response>;

package/dist/palvelin/kuvat.js

@@ -0,0 +1,130 @@
+/* ==========================================================================
+   KUVIEN LATAUS
+   ==========================================================================
+   Kuvien lataus on editorin suurin hyökkäyspinta: haitallinen kuvatiedosto
+   voi päätyä kuvankäsittelykirjastoille, joissa on ollut vakavia aukkoja.
+   Siksi:
+
+   - **Selain piirtää kuvan uudelleen ennen lähetystä.** Palvelimelle ei
+     päädy alkuperäistä tiedostoa eikä sen metatietoja (myös GPS-sijainti
+     jää pois). Sama hoitaa iPhonen HEIC-kuvat.
+   - **Palvelin tunnistaa tiedostotyypin sisällöstä, ei nimestä.** Vain
+     JPEG ja WebP kelpaavat; koolla ja mittasuhteilla on rajat.
+   - **Vain kirjautunut muokkaaja voi ladata kuvia.**
+   - **Polku syntyy palvelimella.** Selain ei kerro, minne tiedosto menee.
+
+   Sivustokohtainen kuvankäsittely (valotus, värit, rajaus) annetaan
+   asetuksissa: `kuvankasittely`. Ilman sitä kuva tallennetaan sellaisenaan
+   kuin selain sen lähetti.
+   ========================================================================== */
+import { kuvanOsoite } from "../maarittely.js";
+import { ehdotaKuvateksti } from "./kuvateksti.js";
+import { asetuksetTaiNull, json, muokkaajaPyynnosta } from "./apurit.js";
+import { valitseVarasto } from "./varasto.js";
+/** Enintään 8 Mt. Selain pienentää kuvan jo ennen lähetystä. */
+const SUURIN_KOKO = 8 * 1024 * 1024;
+/** Tunnistaa tyypin tiedoston alkutavuista, ei nimestä eikä otsakkeesta. */
+function tunnistaTyyppi(tavut) {
+    if (tavut.length > 3 && tavut[0] === 0xff && tavut[1] === 0xd8 && tavut[2] === 0xff)
+        return "jpeg";
+    const teksti = (alku, pituus) => String.fromCharCode(...tavut.slice(alku, alku + pituus));
+    if (tavut.length > 12 && teksti(0, 4) === "RIFF" && teksti(8, 4) === "WEBP")
+        return "webp";
+    return null;
+}
+/** Mediakansio siistittynä. Kelvoton arvo palautuu oletukseen. */
+function siistiJuuri(arvo) {
+    const teksti = typeof arvo === "string" ? arvo.replace(/^\/+|\/+$/g, "") : "";
+    return /^public\/[a-z0-9][a-z0-9-]*$/.test(teksti) ? teksti : "public/kuvat";
+}
+function siistiKansio(arvo) {
+    const teksti = typeof arvo === "string" ? arvo : "";
+    const siisti = teksti.toLowerCase().replace(/[^a-z0-9-]/g, "");
+    return siisti === "" ? "yleiset" : siisti;
+}
+/** Tiedostonimi, joka ei osu vanhaan: vanha kuva jää välimuisteihin. */
+function tiedostonimi() {
+    const paiva = new Date().toISOString().slice(0, 10);
+    const satunnainen = Math.random().toString(36).slice(2, 8);
+    return `${paiva}-${satunnainen}.webp`;
+}
+export function kuvienReitti(yliajot) {
+    return async function lataa(pyynto) {
+        const asetukset = asetuksetTaiNull(yliajot);
+        if (!asetukset)
+            return json({ virhe: "Editori ei ole käytössä." }, 503);
+        const muokkaaja = await muokkaajaPyynnosta(pyynto, asetukset);
+        if (!muokkaaja)
+            return json({ virhe: "Kirjaudu sisään." }, 401);
+        let data;
+        try {
+            data = (await pyynto.json());
+        }
+        catch {
+            return json({ virhe: "Pyyntö ei ollut kelvollista JSONia." }, 400);
+        }
+        if (typeof data.tiedosto !== "string" || data.tiedosto === "") {
+            return json({ virhe: "Kuva puuttuu." }, 400);
+        }
+        let tavut;
+        try {
+            const base64 = data.tiedosto.includes(",") ? data.tiedosto.split(",")[1] : data.tiedosto;
+            tavut = Uint8Array.from(atob(base64), (merkki) => merkki.charCodeAt(0));
+        }
+        catch {
+            return json({ virhe: "Kuvaa ei voitu lukea." }, 400);
+        }
+        if (tavut.length > SUURIN_KOKO) {
+            return json({ virhe: "Kuva on liian suuri. Enintään 8 Mt." }, 413);
+        }
+        if (!tunnistaTyyppi(tavut)) {
+            return json({ virhe: "Vain JPEG- ja WebP-kuvat kelpaavat. Kokeile tallentaa kuva uudelleen." }, 415);
+        }
+        const kansio = siistiKansio(data.kansio);
+        let valmis = tavut;
+        if (yliajot.kuvankasittely) {
+            try {
+                valmis = await yliajot.kuvankasittely({
+                    tavut,
+                    kansio,
+                    ...(typeof data.suhde === "number" ? { suhde: data.suhde } : {}),
+                });
+            }
+            catch (virhe) {
+                console.error("[editori] Kuvan käsittely epäonnistui:", virhe);
+                return json({ virhe: "Kuvaa ei saatu käsiteltyä." }, 502);
+            }
+        }
+        /*
+          Ehdotus pyydetään alkuperäisestä kuvasta, ei käsitellystä: värikäsittely
+          ei muuta sitä, mitä kuvassa on, ja alkuperäinen on jo muistissa.
+          Ehdotus haetaan rinnakkain tallennuksen kanssa, jottei lataus hidastu.
+        */
+        const ehdotus = yliajot.kuvateksti === false
+            ? Promise.resolve(null)
+            : ehdotaKuvateksti(tavut, tunnistaTyyppi(tavut) ?? "jpeg", yliajot.kuvateksti ?? {});
+        /* Polku syntyy palvelimella: selain ei kerro, minne tiedosto menee.
+           Mediakansio tulee sivuston asetuksista, alikansio kentän tiedoista. */
+        const juuri = siistiJuuri(yliajot.kuvakansio);
+        const polku = `${juuri}/${kansio}/${tiedostonimi()}`;
+        try {
+            const varasto = valitseVarasto(yliajot.github ?? {});
+            await varasto.tallenna({
+                tiedostot: [
+                    {
+                        polku,
+                        sisalto: Buffer.from(valmis).toString("base64"),
+                        koodaus: "base64",
+                    },
+                ],
+                viesti: `Uusi kuva: ${kansio}\n\nLadannut ${muokkaaja} sivuston editorilla.`,
+                tekija: { nimi: muokkaaja.split("@")[0] ?? muokkaaja, sahkoposti: muokkaaja },
+            });
+        }
+        catch (virhe) {
+            console.error("[editori] Kuvan tallennus epäonnistui:", virhe);
+            return json({ virhe: "Kuvaa ei saatu tallennettua." }, 502);
+        }
+        return json({ src: kuvanOsoite(polku), ehdotus: await ehdotus });
+    };
+}

package/dist/palvelin/kuvateksti.d.ts

@@ -0,0 +1,15 @@
+export interface KuvatekstiAsetukset {
+    /** API-avain. Oletuksena EDITORI_KUVATEKSTI_AVAIN tai ANTHROPIC_API_KEY. */
+    avain?: string;
+    /** Kieli, jolla ehdotus kirjoitetaan. Oletus suomi. */
+    kieli?: string;
+}
+/**
+ * Ehdotus vaihtoehtoiseksi tekstiksi, tai `null` jos ominaisuus ei ole
+ * käytössä tai kutsu ei onnistunut.
+ *
+ * Ei koskaan heitä: kuvan lataus on tärkeämpi kuin ehdotus, eikä sen pidä
+ * kaatua siihen, että tekstipalvelu on nurin.
+ */
+export declare function kuvatekstiAvain(asetukset?: KuvatekstiAsetukset): string | undefined;
+export declare function ehdotaKuvateksti(tavut: Uint8Array, tyyppi: "jpeg" | "webp", asetukset?: KuvatekstiAsetukset): Promise<string | null>;

package/dist/palvelin/kuvateksti.js

@@ -0,0 +1,95 @@
+/* ==========================================================================
+   KUVATEKSTIEHDOTUS
+   ==========================================================================
+   Ladatusta kuvasta pyydetään ehdotus vaihtoehtoiseksi tekstiksi. Ehdotus
+   on nimenomaan ehdotus: se kirjoitetaan kenttään, jonka muokkaaja näkee ja
+   voi korjata ennen tallennusta.
+
+   Miksi ehdotus eikä valmis teksti: kone kuvaa sen, mitä kuvassa näkyy
+   ("nainen istuu matolla"), mutta harvoin sitä, miksi kuva on sivulla.
+   Ihminen tietää sen. Ilman ehdotustakin kenttä on täytettävä, ja käytäntö
+   osoittaa, että tyhjä kenttä jää helposti tyhjäksi.
+
+   **Kuva lähetetään Anthropicin rajapintaan.** Se on syytä mainita sivuston
+   tietosuojaselosteessa, ja ominaisuus on pois päältä, ellei avainta ole
+   asetettu.
+   ========================================================================== */
+/** Enintään tämän kokoinen kuva lähetetään. Suuremmasta ei ole hyötyä. */
+const SUURIN = 4 * 1024 * 1024;
+/** Ehdotus katkaistaan tähän: vaihtoehtoinen teksti on lyhyt lause. */
+const ENINTAAN_MERKKEJA = 200;
+function ohje(kieli) {
+    return [
+        `Kirjoita tälle kuvalle vaihtoehtoinen teksti (alt-teksti) kielellä ${kieli}.`,
+        "",
+        "Säännöt:",
+        "- Yksi lause, enintään noin 120 merkkiä.",
+        '- Älä aloita sanoilla "kuva", "valokuva" tai "kuvassa".',
+        "- Kerro se, minkä näkevä huomaa ensimmäisenä: kuka tai mikä, missä, mitä tapahtuu.",
+        "- Älä arvaa nimiä, paikkoja, tunteita tai tapahtuman tarkoitusta.",
+        "- Älä lisää lainausmerkkejä äläkä selityksiä. Vastaa pelkällä lauseella.",
+    ].join("\n");
+}
+/** Siistii mallin vastauksen: yksi rivi, ei lainausmerkkejä, rajattu pituus. */
+function siisti(teksti) {
+    const yksiRivi = teksti.replace(/\s+/g, " ").trim().replace(/^["'“”]|["'“”]$/g, "");
+    return yksiRivi.length > ENINTAAN_MERKKEJA
+        ? `${yksiRivi.slice(0, ENINTAAN_MERKKEJA - 1).trimEnd()}…`
+        : yksiRivi;
+}
+/**
+ * Ehdotus vaihtoehtoiseksi tekstiksi, tai `null` jos ominaisuus ei ole
+ * käytössä tai kutsu ei onnistunut.
+ *
+ * Ei koskaan heitä: kuvan lataus on tärkeämpi kuin ehdotus, eikä sen pidä
+ * kaatua siihen, että tekstipalvelu on nurin.
+ */
+export function kuvatekstiAvain(asetukset = {}) {
+    return asetukset.avain ?? process.env.EDITORI_KUVATEKSTI_AVAIN ?? process.env.ANTHROPIC_API_KEY;
+}
+export async function ehdotaKuvateksti(tavut, tyyppi, asetukset = {}) {
+    const avain = kuvatekstiAvain(asetukset);
+    if (!avain)
+        return null;
+    if (tavut.length > SUURIN)
+        return null;
+    try {
+        /* Tuonti vasta tässä: sivustot, jotka eivät käytä ehdotusta, eivät lataa
+           kirjastoa lainkaan. */
+        const { default: Anthropic } = await import("@anthropic-ai/sdk");
+        const asiakas = new Anthropic({ apiKey: avain });
+        const vastaus = await asiakas.messages.create({
+            model: "claude-opus-5",
+            /* Yksi lause riittää; katkaisua ei tarvitse pelätä. */
+            max_tokens: 300,
+            messages: [
+                {
+                    role: "user",
+                    content: [
+                        {
+                            type: "image",
+                            source: {
+                                type: "base64",
+                                media_type: tyyppi === "webp" ? "image/webp" : "image/jpeg",
+                                data: Buffer.from(tavut).toString("base64"),
+                            },
+                        },
+                        { type: "text", text: ohje(asetukset.kieli ?? "suomi") },
+                    ],
+                },
+            ],
+        });
+        if (vastaus.stop_reason === "refusal")
+            return null;
+        const teksti = vastaus.content
+            .filter((osa) => osa.type === "text")
+            .map((osa) => osa.text)
+            .join(" ");
+        const ehdotus = siisti(teksti);
+        return ehdotus === "" ? null : ehdotus;
+    }
+    catch (virhe) {
+        console.error("[editori] Kuvatekstin ehdotus epäonnistui:", virhe);
+        return null;
+    }
+}

package/dist/palvelin/lue.d.ts

@@ -0,0 +1,6 @@
+import { type SisallonMaarittely, type Sivu } from "../maarittely.ts";
+export interface LukuAsetukset {
+    /** Sivuston juurikansio. Oletuksena prosessin työhakemisto (Nextissä sivuston juuri). */
+    juuri?: string;
+}
+export declare function lueSivu<M extends SisallonMaarittely, A extends keyof M["sivut"] & string>(maarittely: M, sivunAvain: A, kieli: M["kielet"][number], asetukset?: LukuAsetukset): Promise<Sivu<M["sivut"][A]>>;