@studiotitta/studio-editori 0.1.0

package/dist/palvelin/lue.js

@@ -0,0 +1,41 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { onSallittuPolku } from "../maarittely.js";
+import { kielista, tarkistaSivu } from "../tarkistus.js";
+export async function lueSivu(maarittely, sivunAvain, kieli, asetukset = {}) {
+    const sivu = maarittely.sivut[sivunAvain];
+    if (!sivu)
+        throw new Error(`Sisältömallissa ei ole sivua "${sivunAvain}".`);
+    if (!onSallittuPolku(sivu.tiedosto)) {
+        throw new Error(`Sivun "${sivunAvain}" tiedosto "${sivu.tiedosto}" ei ole sallittu polku.`);
+    }
+    if (!maarittely.kielet.includes(kieli)) {
+        throw new Error(`Sivustolla ei ole kieltä "${kieli}".`);
+    }
+    // Polku kootaan sisalto-kansiosta alkaen, jotta Next jäljittää julkaisuun
+    // vain sen kansion eikä koko projektia. onSallittuPolku takaa etuliitteen.
+    const kansionSisalla = sivu.tiedosto.slice("sisalto/".length);
+    const polku = path.join(asetukset.juuri ?? process.cwd(), "sisalto", kansionSisalla);
+    let raaka;
+    try {
+        raaka = await readFile(polku, "utf8");
+    }
+    catch {
+        throw new Error(`Sivun "${sivunAvain}" sisältötiedostoa ei löydy: ${sivu.tiedosto}`);
+    }
+    let data;
+    try {
+        data = JSON.parse(raaka);
+    }
+    catch (virhe) {
+        const syy = virhe instanceof Error ? virhe.message : String(virhe);
+        throw new Error(`Tiedosto ${sivu.tiedosto} ei ole kelvollista JSONia (${syy}). ` +
+            `Tarkista pilkut ja lainausmerkit viimeksi muokatusta kohdasta.`);
+    }
+    const { virheet } = tarkistaSivu(maarittely, sivunAvain, data);
+    if (virheet.length > 0) {
+        const rivit = virheet.map((v) => `${v.kohde}${v.kieli ? ` (${v.kieli})` : ""}: ${v.viesti}`);
+        throw new Error(`Tiedostossa ${sivu.tiedosto} on virheitä:\n- ${rivit.join("\n- ")}`);
+    }
+    return kielista(maarittely, sivu, data, kieli);
+}

package/dist/palvelin/posti.d.ts

@@ -0,0 +1,9 @@
+import type { EditorinAsetukset } from "./asetukset.ts";
+export interface Kirjautumisviesti {
+    vastaanottaja: string;
+    linkki: string;
+    /** Sivuston nimi viestissä, esim. "amritagian.fi". */
+    sivusto: string;
+}
+export type Lahetystulos = "lahetetty" | "loki";
+export declare function lahetaKirjautumislinkki(viesti: Kirjautumisviesti, asetukset: EditorinAsetukset): Promise<Lahetystulos>;

package/dist/palvelin/posti.js

@@ -0,0 +1,45 @@
+/* ==========================================================================
+   KIRJAUTUMISVIESTI
+   ==========================================================================
+   Viesti on tarkoituksella lyhyt ja tylsä: yksi linkki, voimassaoloaika ja
+   ohje siltä varalta, ettei pyyntö ollut oma. Ei logoja, ei markkinointia —
+   sellainen viesti päätyy herkemmin roskapostiin.
+
+   Ilman Resendin avainta viestiä ei lähetetä, vaan linkki tulostuu
+   palvelimen lokiin. Näin editoria voi kehittää paikallisesti ilman
+   sähköpostipalvelua, mutta tuotannossa avain on pakollinen.
+   ========================================================================== */
+export async function lahetaKirjautumislinkki(viesti, asetukset) {
+    const minuutit = asetukset.linkinKestoMinuuttia;
+    const teksti = [
+        `Tästä pääset muokkaamaan sivustoa ${viesti.sivusto}:`,
+        "",
+        viesti.linkki,
+        "",
+        `Linkki on voimassa ${minuutit} minuuttia ja toimii siinä selaimessa, josta sitä pyydettiin.`,
+        "",
+        "Jos et pyytänyt linkkiä, voit jättää viestin huomiotta. Kukaan ei pääse sivustolle tämän viestin perusteella ilman sähköpostiasi.",
+    ].join("\n");
+    if (!asetukset.postiAvain) {
+        console.warn(`\n[editori] Kirjautumislinkki osoitteelle ${viesti.vastaanottaja}:\n${viesti.linkki}\n`);
+        return "loki";
+    }
+    const vastaus = await fetch("https://api.resend.com/emails", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${asetukset.postiAvain}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            from: asetukset.lahettaja,
+            to: [viesti.vastaanottaja],
+            subject: `Kirjautumislinkki – ${viesti.sivusto}`,
+            text: teksti,
+        }),
+    });
+    if (!vastaus.ok) {
+        /* Virheen sisältö voi paljastaa osoitteita, joten lokiin vain tila. */
+        throw new Error(`Kirjautumisviestin lähetys epäonnistui (${vastaus.status}).`);
+    }
+    return "lahetetty";
+}

package/dist/palvelin/reitit.d.ts

@@ -0,0 +1,10 @@
+import { type KirjautumisenAsetukset } from "./kirjautuminen.ts";
+import { type SisallonAsetukset } from "./tallennus.ts";
+import { type KaannoksenAsetukset } from "./kaannosreitti.ts";
+import { type KuvienAsetukset } from "./kuvat.ts";
+export interface ReittienAsetukset extends KirjautumisenAsetukset, SisallonAsetukset, KuvienAsetukset, KaannoksenAsetukset {
+}
+export declare function editorinReitit(yliajot?: ReittienAsetukset): {
+    GET(pyynto: Request): Promise<Response>;
+    POST(pyynto: Request): Promise<Response>;
+};

package/dist/palvelin/reitit.js

@@ -0,0 +1,71 @@
+/* ==========================================================================
+   EDITORIN REITIT
+   ==========================================================================
+   Sivusto ottaa editorin käyttöön yhdellä tiedostolla:
+
+     // app/api/editori/[...polku]/route.ts
+     import { editorinReitit } from "@studiotitta/studio-editori/palvelin";
+     import sisalto from "@/editori.config";
+
+     export const { GET, POST } = editorinReitit({ sisalto });
+
+   Osoitteet:
+     POST /api/editori/kirjaudu    lähettää kirjautumislinkin
+     GET  /api/editori/vahvista    avaa istunnon linkistä
+     POST /api/editori/ulos        päättää istunnon
+     GET  /api/editori/sisalto     nykyinen sisältö muokkausta varten
+     GET  /api/editori/tila        toimiiko editori, ja jos ei, mikä on vialla
+     GET  /api/editori/muokkaa     kytkee muokkaustilan päälle ja palaa sivustolle
+     POST /api/editori/tallenna    muutokset yhtenä committina
+     POST /api/editori/kuva        uusi kuva mediakirjastoon
+     POST /api/editori/kaannos     ehdotukset puuttuviin käännöksiin
+   ========================================================================== */
+import { kirjautumisenReitit } from "./kirjautuminen.js";
+import { sisallonReitit } from "./tallennus.js";
+import { kaannosReitti } from "./kaannosreitti.js";
+import { kuvienReitti } from "./kuvat.js";
+import { tilanReitti } from "./tila.js";
+export function editorinReitit(yliajot = {}) {
+    const kirjautuminen = kirjautumisenReitit(yliajot);
+    const sisalto = sisallonReitit(yliajot);
+    const tila = tilanReitti(yliajot);
+    const kuvat = kuvienReitti(yliajot);
+    const kaannos = kaannosReitti(yliajot);
+    function polku(pyynto) {
+        const osat = new URL(pyynto.url).pathname.split("/").filter(Boolean);
+        return osat.at(-1) ?? "";
+    }
+    const eiLoydy = () => new Response("Tuntematon osoite", { status: 404 });
+    return {
+        async GET(pyynto) {
+            switch (polku(pyynto)) {
+                case "vahvista":
+                    return kirjautuminen.vahvista(pyynto);
+                case "sisalto":
+                    return sisalto.lue(pyynto);
+                case "tila":
+                    return tila(pyynto);
+                case "muokkaa":
+                    return kirjautuminen.avaaMuokkaustila(pyynto);
+                default:
+                    return eiLoydy();
+            }
+        },
+        async POST(pyynto) {
+            switch (polku(pyynto)) {
+                case "kirjaudu":
+                    return kirjautuminen.kirjaudu(pyynto);
+                case "ulos":
+                    return kirjautuminen.ulos(pyynto);
+                case "tallenna":
+                    return sisalto.tallenna(pyynto);
+                case "kuva":
+                    return kuvat(pyynto);
+                case "kaannos":
+                    return kaannos(pyynto);
+                default:
+                    return eiLoydy();
+            }
+        },
+    };
+}

package/dist/palvelin/tallennus.d.ts

@@ -0,0 +1,18 @@
+import type { SisallonMaarittely } from "../maarittely.ts";
+import { type KaannosAsetukset } from "./kaannos.ts";
+import { type KuvatekstiAsetukset } from "./kuvateksti.ts";
+import type { EditorinAsetukset } from "./asetukset.ts";
+import type { GithubAsetukset } from "./github/yhteys.ts";
+export interface SisallonAsetukset extends Partial<EditorinAsetukset> {
+    /** Sivuston sisältömalli. Ilman tätä tallennusreitit eivät ole käytössä. */
+    sisalto?: SisallonMaarittely;
+    github?: Partial<GithubAsetukset>;
+    /** Ehdotus kuvan kuvaukseksi. `false` tai puuttuva avain = pois käytöstä. */
+    kuvateksti?: KuvatekstiAsetukset | false;
+    /** Käännösehdotukset. `false` tai puuttuva avain = pois käytöstä. */
+    kaannos?: KaannosAsetukset | false;
+}
+export declare function sisallonReitit(yliajot?: SisallonAsetukset): {
+    lue: (pyynto: Request) => Promise<Response>;
+    tallenna: (pyynto: Request) => Promise<Response>;
+};

package/dist/palvelin/tallennus.js

@@ -0,0 +1,177 @@
+/* ==========================================================================
+   SISÄLLÖN LUKU JA TALLENNUS
+   ==========================================================================
+   Kaksi reittiä, jotka selaimen muokkaustila tarvitsee:
+
+     GET  /api/editori/sisalto   nykyinen sisältö ja versio, josta muokkaus alkaa
+     POST /api/editori/tallenna  muutokset yhtenä committina
+
+   Säännöt:
+   - **Vain kirjautunut muokkaaja.** Muut saavat 401 eikä mitään tietoa siitä,
+     mitä sivustolla on.
+   - **Palvelin tarkistaa jokaisen tallennuksen sisältömallia vasten.**
+     Selaimen tarkistus on käyttömukavuutta; tämä on se, johon luotetaan.
+   - **Vain sisältömallissa määritellyt tiedostot.** Polku tulee mallista,
+     ei koskaan selaimen lähettämästä pyynnöstä.
+   - **Ristiriita pysäyttää tallennuksen.** Mitään ei ylikirjoiteta hiljaa.
+   ========================================================================== */
+import { tarkistaSivu } from "../tarkistus.js";
+import { asetuksetTaiNull, json, muokkaajaPyynnosta } from "./apurit.js";
+import { kaannosAvain } from "./kaannos.js";
+import { kuvatekstiAvain } from "./kuvateksti.js";
+import { RistiriitaVirhe } from "./github/tiedostot.js";
+import { valitseVarasto } from "./varasto.js";
+/** Tekijän nimi commitiin. Sähköpostista ennen @-merkkiä, siistittynä. */
+function tekijanNimi(sahkoposti) {
+    const alku = sahkoposti.split("@")[0] ?? sahkoposti;
+    return alku.replace(/[._-]+/g, " ").trim() || sahkoposti;
+}
+function commitinViesti(sivujenNimet, muokkaaja) {
+    const mita = sivujenNimet.join(", ");
+    return `Sisältömuutos: ${mita}\n\nMuokannut ${muokkaaja} sivuston editorilla.`;
+}
+export function sisallonReitit(yliajot = {}) {
+    function varasto() {
+        return valitseVarasto(yliajot.github ?? {});
+    }
+    async function lue(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);
+        const malli = yliajot.sisalto;
+        if (!malli)
+            return json({ virhe: "Sivustolle ei ole määritelty sisältömallia." }, 503);
+        try {
+            const paikka = varasto();
+            const versio = await paikka.lueVersio();
+            const sivut = {};
+            /*
+              Jokaisen sivun oma versio talteen. Tallennus vertaa näitä, ei koko
+              repon versiota: muuten kuka tahansa muu muutos repossa estäisi
+              tallennuksen, vaikka se ei koskisi samaa sisältöä.
+            */
+            const versiot = {};
+            for (const [avain, sivu] of Object.entries(malli.sivut)) {
+                const raaka = await paikka.lueTiedosto(sivu.tiedosto, versio);
+                sivut[avain] = raaka ? JSON.parse(raaka) : {};
+                versiot[avain] = await paikka.lueTiedostonVersio(sivu.tiedosto, versio);
+            }
+            /*
+              Selain saa mukaan sisältömallin: sen perusteella sivupaneeli osaa
+              näyttää oikean säätimen jokaiselle kentälle ilman, että editoriin
+              kovakoodataan mitään sivustokohtaista. Tiedostopolkuja ei lähetetä —
+              ne eivät kuulu selaimelle.
+            */
+            const kentat = Object.fromEntries(Object.entries(malli.sivut).map(([avain, sivu]) => [
+                avain,
+                { nimi: sivu.nimi ?? avain, kentat: sivu.kentat },
+            ]));
+            /*
+              Selain saa tietää, mitkä valinnaiset ominaisuudet ovat käytössä, jotta
+              se ei tarjoa painiketta, joka vastaisi vain "ei käytössä".
+            */
+            const ominaisuudet = {
+                kuvateksti: yliajot.kuvateksti !== false && Boolean(kuvatekstiAvain(yliajot.kuvateksti ?? {})),
+                kaannos: yliajot.kaannos !== false && Boolean(kaannosAvain(yliajot.kaannos ?? {})),
+            };
+            return json({
+                versio,
+                versiot,
+                sivut,
+                muokkaaja,
+                kielet: malli.kielet,
+                malli: kentat,
+                ominaisuudet,
+            });
+        }
+        catch (virhe) {
+            console.error("[editori] Sisällön luku epäonnistui:", virhe);
+            return json({ virhe: "Sisältöä ei saatu haettua." }, 502);
+        }
+    }
+    async function tallenna(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);
+        const malli = yliajot.sisalto;
+        if (!malli)
+            return json({ virhe: "Sivustolle ei ole määritelty sisältömallia." }, 503);
+        let data;
+        try {
+            data = (await pyynto.json());
+        }
+        catch {
+            return json({ virhe: "Pyyntö ei ollut kelvollista JSONia." }, 400);
+        }
+        const sivut = data.sivut;
+        if (!sivut || typeof sivut !== "object" || Array.isArray(sivut)) {
+            return json({ virhe: "Pyynnöstä puuttuvat muutettavat sivut." }, 400);
+        }
+        /* Tarkistus ensin kaikille sivuille: muokkaaja saa kaikki virheet
+           kerralla eikä yhtä kerrallaan. */
+        const virheet = [];
+        const varoitukset = [];
+        for (const [avain, sivunData] of Object.entries(sivut)) {
+            if (!Object.hasOwn(malli.sivut, avain)) {
+                virheet.push({ kohde: avain, viesti: "Tuntematon sivu." });
+                continue;
+            }
+            const tulos = tarkistaSivu(malli, avain, sivunData);
+            virheet.push(...tulos.virheet);
+            varoitukset.push(...tulos.varoitukset);
+        }
+        if (virheet.length > 0) {
+            return json({ virhe: "Sisällössä on virheitä.", virheet, varoitukset }, 422);
+        }
+        const tiedostot = Object.entries(sivut).map(([avain, sivunData]) => ({
+            /* Polku tulee sisältömallista, ei koskaan pyynnöstä. */
+            polku: malli.sivut[avain].tiedosto,
+            sisalto: `${JSON.stringify(sivunData, null, 2)}\n`,
+        }));
+        const nimet = Object.keys(sivut).map((avain) => malli.sivut[avain]?.nimi ?? avain);
+        try {
+            /* Sivun avain → tiedostopolku, koska varasto puhuu poluista. */
+            const perustuu = {};
+            for (const [avain, arvo] of Object.entries(data.perustuu ?? {})) {
+                const tiedosto = malli.sivut[avain]?.tiedosto;
+                if (tiedosto && typeof arvo === "string")
+                    perustuu[tiedosto] = arvo;
+            }
+            const { versio } = await varasto().tallenna({
+                tiedostot,
+                viesti: commitinViesti(nimet, muokkaaja),
+                tekija: { nimi: tekijanNimi(muokkaaja), sahkoposti: muokkaaja },
+                ...(Object.keys(perustuu).length > 0 ? { perustuu } : {}),
+            });
+            /* Uudet tiedostoversiot mukaan, jotta seuraava tallennus samasta
+               selaimesta perustuu juuri kirjoitettuun eikä vanhaan. */
+            const uudetVersiot = {};
+            const paikka = varasto();
+            for (const avain of Object.keys(sivut)) {
+                const tiedosto = malli.sivut[avain]?.tiedosto;
+                if (tiedosto)
+                    uudetVersiot[avain] = await paikka.lueTiedostonVersio(tiedosto, versio);
+            }
+            return json({ tila: "tallennettu", versio, versiot: uudetVersiot, varoitukset });
+        }
+        catch (virhe) {
+            if (virhe instanceof RistiriitaVirhe) {
+                return json({
+                    virhe: "Joku muu on muokannut samaa sisältöä sillä välin. Muutoksiasi ei ylikirjoitettu — " +
+                        "lataa sivu uudelleen ja tee muutokset uusimpaan versioon.",
+                    nykyinenVersio: virhe.nykyinenVersio,
+                    muuttuneet: virhe.muuttuneet,
+                }, 409);
+            }
+            console.error("[editori] Tallennus epäonnistui:", virhe);
+            return json({ virhe: "Tallennus ei onnistunut. Muutoksesi ovat yhä selaimessa." }, 502);
+        }
+    }
+    return { lue, tallenna };
+}

package/dist/palvelin/tila.d.ts

@@ -0,0 +1,21 @@
+import type { EditorinAsetukset } from "./asetukset.ts";
+import type { SisallonMaarittely } from "../maarittely.ts";
+import type { GithubAsetukset } from "./github/yhteys.ts";
+export interface Tarkistus {
+    nimi: string;
+    kunnossa: boolean;
+    /** Mitä tehdä, jos ei ole kunnossa. */
+    ohje?: string;
+}
+export interface TilanAsetukset extends Partial<EditorinAsetukset> {
+    sisalto?: SisallonMaarittely;
+    github?: Partial<GithubAsetukset>;
+}
+/**
+ * Tekee tarkistukset ilman HTTP-kerrosta, jotta sivuston oma sivu voi
+ * näyttää saman tilan ilman ylimääräistä pyyntöä itselleen.
+ *
+ * Kutsuja vastaa siitä, että tila näytetään vain kirjautuneelle.
+ */
+export declare function tarkistaTila(yliajot: TilanAsetukset): Promise<Tarkistus[]>;
+export declare function tilanReitti(yliajot: TilanAsetukset): (pyynto: Request) => Promise<Response>;

package/dist/palvelin/tila.js

@@ -0,0 +1,116 @@
+/* ==========================================================================
+   EDITORIN TILA
+   ==========================================================================
+   Kertoo kirjautuneelle muokkaajalle suomeksi, toimiiko editori ja jos ei,
+   mikä on vialla ja mitä pitää tehdä.
+
+   Tämä on olemassa siksi, että käyttöönoton virheet ovat aina samoja:
+   ympäristömuuttuja on jäänyt lisäämättä, uusi julkaisu on tekemättä tai
+   GitHub Appia ei ole asennettu siihen repoon. Ilman tätä ne selviäisivät
+   vain palvelimen lokista — eikä asiakas avaa Vercelin lokeja koskaan.
+
+   **Mitään salaista ei palauteta.** Avaimia ei näytetä, ja tilan näkee vain
+   kirjautunut muokkaaja.
+   ========================================================================== */
+import { asetuksetTaiNull, json, muokkaajaPyynnosta } from "./apurit.js";
+import { valitseVarasto } from "./varasto.js";
+function githubOhje(virhe) {
+    const viesti = virhe instanceof Error ? virhe.message : String(virhe);
+    if (viesti.includes("asetukset puuttuvat") || viesti.includes("EDITORI_GITHUB")) {
+        return `${viesti} Lisää arvo sivuston asetuksiin ja julkaise sivusto uudelleen.`;
+    }
+    if (viesti.includes("404")) {
+        return ("GitHub ei löytänyt repoa tai sovellusta ei ole asennettu siihen. Tarkista repon " +
+            "nimi ja että GitHub App on asennettu juuri tälle repolle.");
+    }
+    if (viesti.includes("401") || viesti.includes("avain")) {
+        return "GitHub ei hyväksynyt avainta. Tarkista, että avain on kopioitu kokonaan, BEGIN- ja END-rivit mukaan lukien.";
+    }
+    if (viesti.includes("403")) {
+        return "GitHub epäsi oikeuden. Tarkista, että sovelluksella on Contents: Read and write.";
+    }
+    return viesti;
+}
+/**
+ * Tekee tarkistukset ilman HTTP-kerrosta, jotta sivuston oma sivu voi
+ * näyttää saman tilan ilman ylimääräistä pyyntöä itselleen.
+ *
+ * Kutsuja vastaa siitä, että tila näytetään vain kirjautuneelle.
+ */
+export async function tarkistaTila(yliajot) {
+    {
+        const tarkistukset = [
+            {
+                nimi: "Sisältömalli",
+                kunnossa: Boolean(yliajot.sisalto),
+                ohje: "Sivusto ei kerro editorille, mitä sivuilla saa muokata (editori.config).",
+            },
+        ];
+        /*
+          Varasto valitaan samalla tavalla kuin tallennuksessa: kehityksessä
+          paikalliset tiedostot kelpaavat, tuotannossa GitHub-asetusten
+          puuttuminen on virhe. Muuten tila valehtelisi kumpaankin suuntaan.
+        */
+        let varasto = null;
+        try {
+            varasto = valitseVarasto(yliajot.github ?? {});
+            tarkistukset.push({ nimi: "Tallennuspaikan asetukset", kunnossa: true });
+        }
+        catch (virhe) {
+            tarkistukset.push({
+                nimi: "Tallennuspaikan asetukset",
+                kunnossa: false,
+                ohje: githubOhje(virhe),
+            });
+        }
+        if (varasto) {
+            try {
+                const versio = await varasto.lueVersio();
+                tarkistukset.push({ nimi: `Yhteys: ${varasto.nimi}`, kunnossa: true });
+                /* Löytyvätkö sisältötiedostot sieltä, mistä niitä haetaan? Väärä
+                   kansio on helppo virhe eikä näy mitenkään muuten. */
+                const malli = yliajot.sisalto;
+                if (malli) {
+                    const puuttuvat = [];
+                    for (const sivu of Object.values(malli.sivut)) {
+                        if ((await varasto.lueTiedosto(sivu.tiedosto, versio)) === undefined) {
+                            puuttuvat.push(sivu.tiedosto);
+                        }
+                    }
+                    tarkistukset.push({
+                        nimi: "Sisältötiedostot",
+                        kunnossa: puuttuvat.length === 0,
+                        ohje: puuttuvat.length > 0
+                            ? `Ei löytynyt: ${puuttuvat.join(", ")}. Jos sivusto on repon alikansiossa, ` +
+                                "tarkista kansion nimi asetuksista."
+                            : undefined,
+                    });
+                }
+            }
+            catch (virhe) {
+                tarkistukset.push({
+                    nimi: `Yhteys: ${varasto.nimi}`,
+                    kunnossa: false,
+                    ohje: githubOhje(virhe),
+                });
+            }
+        }
+        return tarkistukset;
+    }
+}
+export function tilanReitti(yliajot) {
+    return async function tila(pyynto) {
+        const asetukset = asetuksetTaiNull(yliajot);
+        if (!asetukset)
+            return json({ virhe: "Editorin perusasetukset puuttuvat." }, 503);
+        const muokkaaja = await muokkaajaPyynnosta(pyynto, asetukset);
+        if (!muokkaaja)
+            return json({ virhe: "Kirjaudu sisään." }, 401);
+        const tarkistukset = await tarkistaTila(yliajot);
+        return json({
+            muokkaaja,
+            kunnossa: tarkistukset.every((tarkistus) => tarkistus.kunnossa),
+            tarkistukset,
+        });
+    };
+}

package/dist/palvelin/tunnus.d.ts

@@ -0,0 +1,30 @@
+/** Mihin tunnus on tarkoitettu. Kirjautumislinkkiä ei voi käyttää istuntona. */
+export type TunnuksenLaji = "kirjautuminen" | "istunto";
+export interface TunnuksenSisalto {
+    laji: TunnuksenLaji;
+    /** Muokkaajan sähköpostiosoite pienillä kirjaimilla. */
+    sahkoposti: string;
+    /** Vanhenemisaika sekunteina (Unix-aika). */
+    vanhenee: number;
+    /** Satunnaisluku, jotta kaksi samanlaista tunnusta eivät ole identtisiä. */
+    satunnainen: string;
+    /**
+     * Selainsidos: kirjautumislinkin tiiviste siitä satunnaisluvusta, joka
+     * jäi linkkiä pyytäneen selaimen evästeeseen. Linkki toimii vain siinä
+     * selaimessa, josta se pyydettiin.
+     */
+    sidos?: string;
+}
+/** Satunnainen merkkijono, esimerkiksi tunnuksen satunnaisluvuksi. */
+export declare function satunnainen(tavuja?: number): string;
+/** Yksisuuntainen tiiviste. Käytetään selainsidokseen. */
+export declare function tiiviste(arvo: string): Promise<string>;
+export declare function luoTunnus(sisalto: TunnuksenSisalto, avain: string): Promise<string>;
+/**
+ * Lukee tunnuksen ja palauttaa sen sisällön, tai `null` jos tunnus on
+ * väärennetty, rikki, vanhentunut tai väärää lajia.
+ *
+ * Kaikki epäonnistumiset palauttavat saman `null`-arvon: kutsuja ei saa
+ * kertoa käyttäjälle, kumpi meni pieleen.
+ */
+export declare function lueTunnus(tunnus: string, avain: string, laji: TunnuksenLaji, nytSekunteina?: number): Promise<TunnuksenSisalto | null>;

package/dist/palvelin/tunnus.js

@@ -0,0 +1,84 @@
+/* ==========================================================================
+   ALLEKIRJOITETUT TUNNUKSET
+   ==========================================================================
+   Editorilla ei ole tietokantaa, joten kirjautumislinkki ja istunto ovat
+   allekirjoitettuja tunnuksia: palvelin voi tarkistaa niiden aitouden
+   pelkän salaisen avaimen avulla.
+
+     tunnus = base64url(sisältö) + "." + base64url(allekirjoitus)
+
+   Allekirjoitus on HMAC-SHA-256. Sisältö on luettavissa (se ei ole salattu),
+   mutta sitä ei voi muuttaa ilman avainta. Sisällössä ei siksi koskaan ole
+   muuta kuin sähköpostiosoite, voimassaolo ja satunnaisluku.
+
+   Käytössä on Web Crypto, joka toimii sekä Nodessa että Vercelin
+   reunaympäristössä. Vertailu tehdään `crypto.subtle.verify`-kutsulla, joka
+   ei vuoda ajastuksen kautta tietoa oikeasta allekirjoituksesta.
+   ========================================================================== */
+function tekstiksi(data) {
+    const tavut = data instanceof Uint8Array ? data : new Uint8Array(data);
+    let merkit = "";
+    for (const tavu of tavut)
+        merkit += String.fromCharCode(tavu);
+    return btoa(merkit).replaceAll("+", "-").replaceAll("/", "_").replaceAll("=", "");
+}
+function tavuiksi(teksti) {
+    const täydennetty = teksti.replaceAll("-", "+").replaceAll("_", "/");
+    const merkit = atob(täydennetty.padEnd(Math.ceil(täydennetty.length / 4) * 4, "="));
+    const tavut = new Uint8Array(new ArrayBuffer(merkit.length));
+    for (let i = 0; i < merkit.length; i++)
+        tavut[i] = merkit.charCodeAt(i);
+    return tavut;
+}
+async function avainOlioksi(avain) {
+    return crypto.subtle.importKey("raw", new TextEncoder().encode(avain), { name: "HMAC", hash: "SHA-256" }, false, ["sign", "verify"]);
+}
+/** Satunnainen merkkijono, esimerkiksi tunnuksen satunnaisluvuksi. */
+export function satunnainen(tavuja = 16) {
+    return tekstiksi(crypto.getRandomValues(new Uint8Array(tavuja)));
+}
+/** Yksisuuntainen tiiviste. Käytetään selainsidokseen. */
+export async function tiiviste(arvo) {
+    return tekstiksi(await crypto.subtle.digest("SHA-256", new TextEncoder().encode(arvo)));
+}
+export async function luoTunnus(sisalto, avain) {
+    const runko = tekstiksi(new TextEncoder().encode(JSON.stringify(sisalto)));
+    const allekirjoitus = await crypto.subtle.sign("HMAC", await avainOlioksi(avain), new TextEncoder().encode(runko));
+    return `${runko}.${tekstiksi(allekirjoitus)}`;
+}
+/**
+ * Lukee tunnuksen ja palauttaa sen sisällön, tai `null` jos tunnus on
+ * väärennetty, rikki, vanhentunut tai väärää lajia.
+ *
+ * Kaikki epäonnistumiset palauttavat saman `null`-arvon: kutsuja ei saa
+ * kertoa käyttäjälle, kumpi meni pieleen.
+ */
+export async function lueTunnus(tunnus, avain, laji, nytSekunteina = Math.floor(Date.now() / 1000)) {
+    const osat = tunnus.split(".");
+    if (osat.length !== 2)
+        return null;
+    const [runko, allekirjoitus] = osat;
+    let kelpaa;
+    try {
+        kelpaa = await crypto.subtle.verify("HMAC", await avainOlioksi(avain), tavuiksi(allekirjoitus), new TextEncoder().encode(runko));
+    }
+    catch {
+        return null;
+    }
+    if (!kelpaa)
+        return null;
+    let sisalto;
+    try {
+        sisalto = JSON.parse(new TextDecoder().decode(tavuiksi(runko)));
+    }
+    catch {
+        return null;
+    }
+    if (sisalto.laji !== laji)
+        return null;
+    if (typeof sisalto.sahkoposti !== "string" || sisalto.sahkoposti === "")
+        return null;
+    if (typeof sisalto.vanhenee !== "number" || sisalto.vanhenee <= nytSekunteina)
+        return null;
+    return sisalto;
+}

package/dist/palvelin/varasto.d.ts

@@ -0,0 +1,18 @@
+import { type Tallennus } from "./github/tiedostot.ts";
+import { type GithubAsetukset } from "./github/yhteys.ts";
+export interface Varasto {
+    /** Lyhyt kuvaus lokia varten. */
+    nimi: string;
+    lueVersio(): Promise<string>;
+    lueTiedosto(polku: string, versio?: string): Promise<string | undefined>;
+    /** Tiedoston oma versio: muuttuu vain, kun tämä tiedosto muuttuu. */
+    lueTiedostonVersio(polku: string, versio?: string): Promise<string>;
+    tallenna(tallennus: Tallennus): Promise<{
+        versio: string;
+    }>;
+}
+/**
+ * Valitsee varaston: GitHub, jos asetukset ovat, muuten kehityksessä
+ * paikalliset tiedostot. Tuotannossa puuttuvat asetukset ovat virhe.
+ */
+export declare function valitseVarasto(yliajot?: Partial<GithubAsetukset>): Varasto;