@studiotitta/studio-editori 0.1.0

package/dist/palvelin/github/avain.js

@@ -0,0 +1,121 @@
+/* ==========================================================================
+   GITHUB APPIN AVAIN JA TUNNISTAUTUMINEN
+   ==========================================================================
+   Editori kirjoittaa sivuston repoon GitHub Appina, ei kenenkään
+   henkilökohtaisella tunnuksella. Sovellus todistaa itsensä lyhytikäisellä
+   JWT:llä, joka on allekirjoitettu sen yksityisellä avaimella.
+
+   GitHub antaa avaimen `.pem`-tiedostona vanhassa PKCS#1-muodossa
+   ("BEGIN RSA PRIVATE KEY"), mutta selainten ja Vercelin Web Crypto osaa
+   vain uudempaa PKCS#8:aa ("BEGIN PRIVATE KEY"). Muunnos tehdään täällä,
+   jottei kenenkään tarvitse ajaa openssl-komentoja ennen käyttöönottoa.
+   ========================================================================== */
+/** DER-pituuskenttä. */
+function pituus(tavuja) {
+    if (tavuja < 0x80)
+        return [tavuja];
+    const osat = [];
+    let jaljella = tavuja;
+    while (jaljella > 0) {
+        osat.unshift(jaljella & 0xff);
+        jaljella >>= 8;
+    }
+    return [0x80 | osat.length, ...osat];
+}
+/** PKCS#1-avain PKCS#8-kuoreen, jotta Web Crypto suostuu lukemaan sen. */
+function pkcs1Pkcs8ksi(pkcs1) {
+    const versio = [0x02, 0x01, 0x00];
+    /* AlgorithmIdentifier: rsaEncryption (1.2.840.113549.1.1.1), parametrit NULL */
+    const algoritmi = [
+        0x30, 0x0d, 0x06, 0x09, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x01, 0x01, 0x05, 0x00,
+    ];
+    const avainOctetString = [0x04, ...pituus(pkcs1.length), ...pkcs1];
+    const sisalto = [...versio, ...algoritmi, ...avainOctetString];
+    const kokonaisuus = [0x30, ...pituus(sisalto.length), ...sisalto];
+    const tulos = new Uint8Array(new ArrayBuffer(kokonaisuus.length));
+    tulos.set(kokonaisuus);
+    return tulos;
+}
+function base64Tavuiksi(base64) {
+    const merkit = atob(base64.replace(/\s+/g, ""));
+    const tavut = new Uint8Array(new ArrayBuffer(merkit.length));
+    for (let i = 0; i < merkit.length; i++)
+        tavut[i] = merkit.charCodeAt(i);
+    return tavut;
+}
+function base64ksi(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("=", "");
+}
+/**
+ * Lukee avaimen ympäristömuuttujan arvosta.
+ *
+ * Hyväksyy kolme muotoa, koska kaikkia näkee käytännössä:
+ *   - PEM sellaisenaan (rivinvaihdot tallessa)
+ *   - PEM, jossa rivinvaihdot on kirjoitettu merkkeinä \n
+ *   - koko PEM base64-koodattuna yhdelle riville
+ */
+export async function lueYksityinenAvain(arvo) {
+    /* Arvoon tarttuu liitettäessä herkästi lainausmerkit tai \n-merkkijonot,
+       eikä kukaan huomaa sitä silmämääräisesti. Siivotaan ne pois. */
+    let pem = arvo.trim().replace(/^["']|["']$/g, "").replaceAll("\\n", "\n").trim();
+    if (!pem.includes("BEGIN")) {
+        /* Pelkkä base64 kelpaa kahdella tapaa: se voi olla koko PEM pakattuna
+           yhdelle riville tai suoraan avaimen sisältö ilman BEGIN-rivejä. */
+        let purettu;
+        try {
+            purettu = new TextDecoder().decode(base64Tavuiksi(pem));
+        }
+        catch {
+            purettu = undefined;
+        }
+        if (purettu?.includes("BEGIN")) {
+            pem = purettu;
+        }
+        else if (/^[A-Za-z0-9+/=\s-_]+$/.test(pem) && pem.replace(/\s+/g, "").length > 100) {
+            /* Näyttää avaimen sisällöltä ilman kuoria: kokeillaan sellaisenaan. */
+            pem = `-----BEGIN PRIVATE KEY-----\n${pem}\n-----END PRIVATE KEY-----`;
+        }
+        else {
+            throw new Error(`GitHub Appin yksityistä avainta ei voitu lukea: arvossa ei ole BEGIN-riviä eikä se ` +
+                `ole base64:ää (pituus ${pem.length} merkkiä). Kopioi .pem-tiedoston koko sisältö ` +
+                `uudelleen, BEGIN- ja END-rivit mukaan lukien.`);
+        }
+    }
+    const pkcs1 = pem.includes("BEGIN RSA PRIVATE KEY");
+    const runko = pem
+        .replace(/-----BEGIN [A-Z ]*PRIVATE KEY-----/, "")
+        .replace(/-----END [A-Z ]*PRIVATE KEY-----/, "");
+    let tavut;
+    try {
+        tavut = base64Tavuiksi(runko);
+    }
+    catch {
+        throw new Error("GitHub Appin yksityinen avain ei ole kelvollista base64:ää.");
+    }
+    if (pkcs1)
+        tavut = pkcs1Pkcs8ksi(tavut);
+    try {
+        return await crypto.subtle.importKey("pkcs8", tavut, { name: "RSASSA-PKCS1-v1_5", hash: "SHA-256" }, false, ["sign"]);
+    }
+    catch {
+        throw new Error("GitHub Appin yksityistä avainta ei kelpuutettu. Tarkista, että arvo on koko " +
+            ".pem-tiedoston sisältö BEGIN- ja END-rivit mukaan lukien.");
+    }
+}
+/**
+ * GitHub Appin JWT. Voimassa GitHubin sallimat 10 minuuttia, mutta
+ * käytämme yhdeksää: GitHub hylkää tunnuksen, jos palvelimen kello on
+ * hieman edellä.
+ */
+export async function luoAppJwt(appId, avain) {
+    const nyt = Math.floor(Date.now() / 1000);
+    const otsake = base64ksi(new TextEncoder().encode(JSON.stringify({ alg: "RS256", typ: "JWT" })));
+    const sisalto = base64ksi(new TextEncoder().encode(JSON.stringify({ iat: nyt - 60, exp: nyt + 9 * 60, iss: appId })));
+    const runko = `${otsake}.${sisalto}`;
+    const allekirjoitus = await crypto.subtle.sign("RSASSA-PKCS1-v1_5", avain, new TextEncoder().encode(runko));
+    return `${runko}.${base64ksi(allekirjoitus)}`;
+}

package/dist/palvelin/github/tiedostot.d.ts

@@ -0,0 +1,56 @@
+import { type GithubAsetukset } from "./yhteys.ts";
+export interface Tiedosto {
+    /** Polku repon juuresta, esim. "sisalto/etusivu.json". */
+    polku: string;
+    sisalto: string;
+    /** base64 kuville, utf-8 tekstille. Oletus utf-8. */
+    koodaus?: "utf-8" | "base64";
+}
+export interface Tekija {
+    nimi: string;
+    sahkoposti: string;
+}
+export declare class RistiriitaVirhe extends Error {
+    /** Repon nykyinen versio. */
+    nykyinenVersio: string;
+    /** Tiedostot, jotka ovat muuttuneet muokkauksen aikana. */
+    muuttuneet: string[];
+    constructor(nykyinenVersio: string, muuttuneet: string[]);
+}
+/** Haaran nykyinen versio (commitin tunnus). */
+export declare function lueVersio(asetukset: GithubAsetukset): Promise<string>;
+/**
+ * Lukee sisältötiedoston GitHubista. Palauttaa `undefined`, jos tiedostoa
+ * ei ole — uusi sivu on normaali tilanne, ei virhe.
+ */
+export interface TiedostonTiedot {
+    sisalto: string;
+    /** Tiedoston oma versio. Muuttuu vain, kun tämä tiedosto muuttuu. */
+    versio: string;
+}
+export declare function lueTiedostonTiedot(asetukset: GithubAsetukset, polku: string, versio?: string): Promise<TiedostonTiedot | undefined>;
+export declare function lueTiedosto(asetukset: GithubAsetukset, polku: string, versio?: string): Promise<string | undefined>;
+export interface Tallennus {
+    tiedostot: Tiedosto[];
+    viesti: string;
+    tekija: Tekija;
+    /**
+     * Tiedostokohtaiset versiot, joista muokkaus alkoi: polku → versio.
+     *
+     * Vertailu tehdään tiedostoittain eikä koko repon versiona. Muuten
+     * mikä tahansa muu muutos repossa — vaikka koodipäivitys, jolla ei ole
+     * sisällön kanssa mitään tekemistä — estäisi tallennuksen.
+     */
+    perustuu?: Record<string, string>;
+}
+/**
+ * Tallentaa tiedostot yhtenä committina.
+ *
+ * Kulku on gitin oma: sisällöt talteen, uusi puu vanhan päälle, commit ja
+ * lopuksi haaran siirto. Viimeinen askel tehdään ilman pakotusta, joten
+ * kahden yhtäaikaisen tallennuksen jälkimmäinen hylätään sen sijaan että
+ * se pyyhkisi ensimmäisen.
+ */
+export declare function tallennaTiedostot(asetukset: GithubAsetukset, tallennus: Tallennus): Promise<{
+    versio: string;
+}>;

package/dist/palvelin/github/tiedostot.js

@@ -0,0 +1,144 @@
+/* ==========================================================================
+   SISÄLTÖTIEDOSTOT GITHUBISSA
+   ==========================================================================
+   Sisältö on sivuston repossa JSON-tiedostoina, ja git on samalla
+   versiohistoria. Tallennus on **yksi commit**: kaikki muuttuneet tiedostot
+   menevät kerralla, tai ei mitään. Puolikasta tallennusta ei synny.
+
+   Ristiriita tunnistetaan versiosta, josta muokkaus alkoi. Jos joku muu on
+   tallentanut välissä, tallennus pysähtyy eikä ylikirjoita mitään.
+   ========================================================================== */
+import { onSallittuKuvapolku, onSallittuPolku } from "../../maarittely.js";
+import { github, GithubVirhe } from "./yhteys.js";
+export class RistiriitaVirhe extends Error {
+    /** Repon nykyinen versio. */
+    nykyinenVersio;
+    /** Tiedostot, jotka ovat muuttuneet muokkauksen aikana. */
+    muuttuneet;
+    constructor(nykyinenVersio, muuttuneet) {
+        super("Joku muu on tallentanut muutoksia sillä välin.");
+        this.name = "RistiriitaVirhe";
+        this.nykyinenVersio = nykyinenVersio;
+        this.muuttuneet = muuttuneet;
+    }
+}
+function varmistaPolku(polku) {
+    if (!onSallittuPolku(polku) && !onSallittuKuvapolku(polku)) {
+        throw new Error(`Polku "${polku}" ei ole sallittu sisältötiedosto.`);
+    }
+}
+/**
+ * Sisältömallin polku repon poluksi.
+ *
+ * Sivusto voi olla repon juuressa tai omassa kansiossaan. Etuliite tulee
+ * aina asetuksista, ei koskaan pyynnöstä, ja polku tarkistetaan ennen
+ * etuliitteen lisäämistä.
+ */
+function repopolku(asetukset, polku) {
+    varmistaPolku(polku);
+    return asetukset.juuri ? `${asetukset.juuri}/${polku}` : polku;
+}
+/** Haaran nykyinen versio (commitin tunnus). */
+export async function lueVersio(asetukset) {
+    const viite = await github(asetukset, `/repos/${asetukset.repo}/git/ref/heads/${asetukset.haara}`);
+    return viite.object.sha;
+}
+export async function lueTiedostonTiedot(asetukset, polku, versio) {
+    const kohde = repopolku(asetukset, polku);
+    const viite = versio ?? asetukset.haara;
+    try {
+        const vastaus = await github(asetukset, `/repos/${asetukset.repo}/contents/${kohde}?ref=${encodeURIComponent(viite)}`);
+        if (!vastaus.content || vastaus.encoding !== "base64")
+            return undefined;
+        return {
+            sisalto: new TextDecoder().decode(Uint8Array.from(atob(vastaus.content.replace(/\s+/g, "")), (merkki) => merkki.charCodeAt(0))),
+            versio: vastaus.sha ?? "",
+        };
+    }
+    catch (virhe) {
+        if (virhe instanceof GithubVirhe && virhe.tila === 404)
+            return undefined;
+        throw virhe;
+    }
+}
+export async function lueTiedosto(asetukset, polku, versio) {
+    return (await lueTiedostonTiedot(asetukset, polku, versio))?.sisalto;
+}
+/**
+ * Tallentaa tiedostot yhtenä committina.
+ *
+ * Kulku on gitin oma: sisällöt talteen, uusi puu vanhan päälle, commit ja
+ * lopuksi haaran siirto. Viimeinen askel tehdään ilman pakotusta, joten
+ * kahden yhtäaikaisen tallennuksen jälkimmäinen hylätään sen sijaan että
+ * se pyyhkisi ensimmäisen.
+ */
+export async function tallennaTiedostot(asetukset, tallennus) {
+    if (tallennus.tiedostot.length === 0)
+        throw new Error("Tallennettavia tiedostoja ei ole.");
+    const kohteet = tallennus.tiedostot.map((tiedosto) => ({
+        polku: repopolku(asetukset, tiedosto.polku),
+        sisalto: tiedosto.sisalto,
+        koodaus: tiedosto.koodaus ?? "utf-8",
+    }));
+    /*
+      Yritetään muutaman kerran: haaran kärki voi siirtyä juuri tämän
+      tallennuksen aikana (toinen muokkaaja, koodipäivitys, rinnakkainen kuvan
+      lataus). Silloin gitin oma suojaus hylkää kirjoituksen, ja oikea vastaus
+      on rakentaa commit uudelleen tuoreen kärjen päälle — ei kaataa
+      tallennusta eikä pakottaa kirjoitusta vanhan päälle.
+    */
+    let viimeisinVirhe;
+    for (let yritys = 0; yritys < 3; yritys++) {
+        try {
+            return await kirjoitaKerran(asetukset, tallennus, kohteet, yritys === 0);
+        }
+        catch (virhe) {
+            if (virhe instanceof RistiriitaVirhe)
+                throw virhe;
+            const siirtyi = virhe instanceof GithubVirhe && (virhe.tila === 422 || virhe.tila === 409);
+            if (!siirtyi)
+                throw virhe;
+            viimeisinVirhe = virhe;
+        }
+    }
+    throw viimeisinVirhe;
+}
+/** Yksi kirjoituskierros: sisällöt, puu, commit ja haaran siirto. */
+async function kirjoitaKerran(asetukset, tallennus, kohteet, tarkistaRistiriita) {
+    const nykyinen = await lueVersio(asetukset);
+    if (tarkistaRistiriita && tallennus.perustuu) {
+        const muuttuneet = [];
+        for (const [polku, alkuperainen] of Object.entries(tallennus.perustuu)) {
+            const nyt = (await lueTiedostonTiedot(asetukset, polku, nykyinen))?.versio ?? "";
+            if (nyt !== alkuperainen)
+                muuttuneet.push(polku);
+        }
+        if (muuttuneet.length > 0)
+            throw new RistiriitaVirhe(nykyinen, muuttuneet);
+    }
+    const blobit = await Promise.all(kohteet.map(async (tiedosto) => {
+        const blob = await github(asetukset, `/repos/${asetukset.repo}/git/blobs`, {
+            menetelma: "POST",
+            runko: { content: tiedosto.sisalto, encoding: tiedosto.koodaus },
+        });
+        return { path: tiedosto.polku, mode: "100644", type: "blob", sha: blob.sha };
+    }));
+    const puu = await github(asetukset, `/repos/${asetukset.repo}/git/trees`, {
+        menetelma: "POST",
+        runko: { base_tree: nykyinen, tree: blobit },
+    });
+    const commit = await github(asetukset, `/repos/${asetukset.repo}/git/commits`, {
+        menetelma: "POST",
+        runko: {
+            message: tallennus.viesti,
+            tree: puu.sha,
+            parents: [nykyinen],
+            author: { name: tallennus.tekija.nimi, email: tallennus.tekija.sahkoposti },
+        },
+    });
+    await github(asetukset, `/repos/${asetukset.repo}/git/refs/heads/${asetukset.haara}`, {
+        menetelma: "PATCH",
+        runko: { sha: commit.sha, force: false },
+    });
+    return { versio: commit.sha };
+}

package/dist/palvelin/github/yhteys.d.ts

@@ -0,0 +1,28 @@
+export interface GithubAsetukset {
+    /** GitHub Appin numerotunnus. */
+    appId: string;
+    /** Yksityinen avain PEM-muodossa (tai base64). */
+    yksityinenAvain: string;
+    /** Repo muodossa "omistaja/repo". */
+    repo: string;
+    /** Haara, johon tallennetaan. Oletuksena main. */
+    haara: string;
+    /**
+     * Sivuston kansio repossa, jos sivusto ei ole repon juuressa
+     * (esim. "esimerkki" tai "sivusto"). Tyhjä = juuri.
+     */
+    juuri: string;
+}
+export declare function lueGithubAsetukset(yliajot?: Partial<GithubAsetukset>): GithubAsetukset;
+/** Testejä varten. */
+export declare function nollaaTunnukset(): void;
+export declare class GithubVirhe extends Error {
+    /** HTTP-tila, jonka GitHub palautti. */
+    tila: number;
+    constructor(message: string, tila: number);
+}
+/** Pyyntö asennuksen tunnuksella. Tätä käyttävät tiedosto-operaatiot. */
+export declare function github<T>(asetukset: GithubAsetukset, polku: string, lisa?: {
+    menetelma?: string;
+    runko?: unknown;
+}): Promise<T>;

package/dist/palvelin/github/yhteys.js

@@ -0,0 +1,89 @@
+/* ==========================================================================
+   GITHUB-YHTEYS
+   ==========================================================================
+   Kaikki liikenne GitHubiin kulkee tämän tiedoston kautta: asennuksen
+   tunnus haetaan kerran ja pidetään muistissa, ja pyynnöt tehdään yhdellä
+   apufunktiolla, joka kääntää virheet suomeksi.
+
+   Asennuksen tunnus on voimassa tunnin. Sitä ei tallenneta mihinkään —
+   palvelimen muisti riittää, ja uudessa instanssissa haetaan uusi.
+   ========================================================================== */
+import { luoAppJwt, lueYksityinenAvain } from "./avain.js";
+export function lueGithubAsetukset(yliajot = {}) {
+    const appId = yliajot.appId ?? process.env.EDITORI_GITHUB_APP_ID ?? "";
+    const yksityinenAvain = yliajot.yksityinenAvain ?? process.env.EDITORI_GITHUB_AVAIN ?? "";
+    const repo = yliajot.repo ?? process.env.EDITORI_GITHUB_REPO ?? "";
+    const haara = yliajot.haara ?? process.env.EDITORI_GITHUB_HAARA ?? "main";
+    const juuri = (yliajot.juuri ?? process.env.EDITORI_GITHUB_JUURI ?? "").replace(/^\/+|\/+$/g, "");
+    const puuttuu = [];
+    if (!appId)
+        puuttuu.push("EDITORI_GITHUB_APP_ID");
+    if (!yksityinenAvain)
+        puuttuu.push("EDITORI_GITHUB_AVAIN");
+    if (!repo)
+        puuttuu.push("EDITORI_GITHUB_REPO");
+    if (puuttuu.length > 0) {
+        throw new Error(`Editorin GitHub-asetukset puuttuvat: ${puuttuu.join(", ")}.`);
+    }
+    if (!/^[\w.-]+\/[\w.-]+$/.test(repo)) {
+        throw new Error(`EDITORI_GITHUB_REPO pitää olla muodossa "omistaja/repo", nyt "${repo}".`);
+    }
+    if (juuri !== "" && !/^[\w.-]+(?:\/[\w.-]+)*$/.test(juuri)) {
+        throw new Error(`EDITORI_GITHUB_JUURI ei kelpaa: "${juuri}".`);
+    }
+    return { appId, yksityinenAvain, repo, haara, juuri };
+}
+const TUNNUKSET = new Map();
+/** Testejä varten. */
+export function nollaaTunnukset() {
+    TUNNUKSET.clear();
+}
+async function asennuksenTunnus(asetukset) {
+    const muistissa = TUNNUKSET.get(asetukset.repo);
+    /* Uusitaan viisi minuuttia ennen vanhenemista, jottei kesken tallennuksen
+       jäädä tunnuksen kanssa yksin. */
+    if (muistissa && muistissa.vanhenee - 5 * 60 * 1000 > Date.now())
+        return muistissa.tunnus;
+    const avain = await lueYksityinenAvain(asetukset.yksityinenAvain);
+    const jwt = await luoAppJwt(asetukset.appId, avain);
+    const asennus = await githubPyynto(`/repos/${asetukset.repo}/installation`, { tunnus: jwt });
+    const tunnus = await githubPyynto(`/app/installations/${asennus.id}/access_tokens`, { tunnus: jwt, menetelma: "POST" });
+    TUNNUKSET.set(asetukset.repo, {
+        tunnus: tunnus.token,
+        vanhenee: new Date(tunnus.expires_at).getTime(),
+    });
+    return tunnus.token;
+}
+/* ---- Pyynnöt ------------------------------------------------------------- */
+export class GithubVirhe extends Error {
+    /** HTTP-tila, jonka GitHub palautti. */
+    tila;
+    constructor(message, tila) {
+        super(message);
+        this.name = "GithubVirhe";
+        this.tila = tila;
+    }
+}
+async function githubPyynto(polku, asetukset) {
+    const vastaus = await fetch(`https://api.github.com${polku}`, {
+        method: asetukset.menetelma ?? "GET",
+        headers: {
+            Authorization: `Bearer ${asetukset.tunnus}`,
+            Accept: "application/vnd.github+json",
+            "X-GitHub-Api-Version": "2022-11-28",
+            "User-Agent": "studio-editori",
+            ...(asetukset.runko === undefined ? {} : { "Content-Type": "application/json" }),
+        },
+        ...(asetukset.runko === undefined ? {} : { body: JSON.stringify(asetukset.runko) }),
+    });
+    if (!vastaus.ok) {
+        const teksti = await vastaus.text().catch(() => "");
+        throw new GithubVirhe(`GitHub vastasi virheellä ${vastaus.status} (${polku}): ${teksti.slice(0, 300)}`, vastaus.status);
+    }
+    return (await vastaus.json());
+}
+/** Pyyntö asennuksen tunnuksella. Tätä käyttävät tiedosto-operaatiot. */
+export async function github(asetukset, polku, lisa = {}) {
+    const tunnus = await asennuksenTunnus(asetukset);
+    return githubPyynto(polku, { tunnus, ...lisa });
+}

package/dist/palvelin/index.d.ts

@@ -0,0 +1,15 @@
+export { lueSivu, type LukuAsetukset } from "./lue.ts";
+export { lueAsetukset, normalisoiOsoite, onSallittuMuokkaaja, type EditorinAsetukset, } from "./asetukset.ts";
+export { EVASTE_ISTUNTO, EVASTE_PYYNTO, evaste, kirjautunutMuokkaaja, onMuokkaustila, poistaEvaste, type EvasteenAsetukset, } from "./istunto.ts";
+export { editorinReitit, type ReittienAsetukset } from "./reitit.ts";
+export { kirjautumisenReitit, nollaaYritykset, type KirjautumisenAsetukset } from "./kirjautuminen.ts";
+export { sisallonReitit, type SisallonAsetukset } from "./tallennus.ts";
+export { tarkistaTila, tilanReitti, type Tarkistus, type TilanAsetukset } from "./tila.ts";
+export { ehdotaKuvateksti, type KuvatekstiAsetukset } from "./kuvateksti.ts";
+export { kaannaTekstit, kaannosAvain, type Kaannettava, type KaannosAsetukset } from "./kaannos.ts";
+export { kaannosReitti, type KaannoksenAsetukset } from "./kaannosreitti.ts";
+export { kuvienReitti, type Kuvankasittely, type Kuvapyynto, type KuvienAsetukset, } from "./kuvat.ts";
+export { lueGithubAsetukset, nollaaTunnukset, GithubVirhe, type GithubAsetukset, } from "./github/yhteys.ts";
+export { lueTiedosto, lueVersio, tallennaTiedostot, RistiriitaVirhe, type Tallennus, type Tiedosto, } from "./github/tiedostot.ts";
+export { lahetaKirjautumislinkki, type Kirjautumisviesti, type Lahetystulos } from "./posti.ts";
+export { luoTunnus, lueTunnus, satunnainen, tiiviste, type TunnuksenLaji, type TunnuksenSisalto, } from "./tunnus.ts";

package/dist/palvelin/index.js

@@ -0,0 +1,19 @@
+/*
+  Studio Editori — palvelinosa. Käyttää Noden ja Nextin palvelinrajapintoja,
+  joten tätä ei saa tuoda selaimessa ajettavaan koodiin.
+*/
+export { lueSivu } from "./lue.js";
+export { lueAsetukset, normalisoiOsoite, onSallittuMuokkaaja, } from "./asetukset.js";
+export { EVASTE_ISTUNTO, EVASTE_PYYNTO, evaste, kirjautunutMuokkaaja, onMuokkaustila, poistaEvaste, } from "./istunto.js";
+export { editorinReitit } from "./reitit.js";
+export { kirjautumisenReitit, nollaaYritykset } from "./kirjautuminen.js";
+export { sisallonReitit } from "./tallennus.js";
+export { tarkistaTila, tilanReitti } from "./tila.js";
+export { ehdotaKuvateksti } from "./kuvateksti.js";
+export { kaannaTekstit, kaannosAvain } from "./kaannos.js";
+export { kaannosReitti } from "./kaannosreitti.js";
+export { kuvienReitti, } from "./kuvat.js";
+export { lueGithubAsetukset, nollaaTunnukset, GithubVirhe, } from "./github/yhteys.js";
+export { lueTiedosto, lueVersio, tallennaTiedostot, RistiriitaVirhe, } from "./github/tiedostot.js";
+export { lahetaKirjautumislinkki } from "./posti.js";
+export { luoTunnus, lueTunnus, satunnainen, tiiviste, } from "./tunnus.js";

package/dist/palvelin/istunto.d.ts

@@ -0,0 +1,34 @@
+import { type EditorinAsetukset } from "./asetukset.ts";
+/** Istunnon eväste. */
+export declare const EVASTE_ISTUNTO = "editori_istunto";
+/** Kirjautumispyynnön eväste, joka sitoo linkin tähän selaimeen. */
+export declare const EVASTE_PYYNTO = "editori_pyynto";
+export interface EvasteenAsetukset {
+    maxAge: number;
+    /** Secure-lippu. Pois vain paikallisessa kehityksessä (http://localhost). */
+    suojattu: boolean;
+}
+/**
+ * Rakentaa Set-Cookie-otsakkeen.
+ *
+ * `SameSite=Lax` on tarkoituksella: kirjautumislinkki tulee sähköpostista
+ * eli toisesta ympäristöstä, ja `Strict` estäisi evästeen lähtemisen juuri
+ * siinä pyynnössä. Lax riittää, koska tallentavat pyynnöt ovat POSTeja.
+ */
+export declare function evaste(nimi: string, arvo: string, asetukset: EvasteenAsetukset): string;
+/** Tyhjentää evästeen. */
+export declare function poistaEvaste(nimi: string, suojattu: boolean): string;
+/**
+ * Kirjautuneen muokkaajan sähköpostiosoite, tai `null`. Tätä käytetään
+ * sivuston palvelinkomponenteissa: kirjautuneelle näytetään muokkaustila,
+ * muille tavallinen sivu.
+ */
+export declare function kirjautunutMuokkaaja(yliajot?: Partial<EditorinAsetukset>): Promise<string | null>;
+/**
+ * Onko selaimen muokkaustila päällä?
+ *
+ * Eri asia kuin kirjautuminen: istunto voi olla voimassa, vaikka
+ * muokkaustila on katkennut uuden julkaisun myötä. Sivuston sivu voi tämän
+ * avulla tarjota "Avaa muokkaustila" -painiketta.
+ */
+export declare function onMuokkaustila(): Promise<boolean>;

package/dist/palvelin/istunto.js

@@ -0,0 +1,86 @@
+/* ==========================================================================
+   ISTUNTO
+   ==========================================================================
+   Muokkaajan istunto on allekirjoitettu tunnus HttpOnly-evästeessä. Selain
+   ei näe sen sisältöä eikä JavaScript pääse siihen käsiksi.
+
+   Eväste on välttämätön istuntoeväste: se asetetaan vasta, kun joku
+   kirjautuu sisään, eikä tavallinen kävijä saa sitä koskaan. Suostumusta ei
+   siis tarvita, mutta **sivuston tietosuojaselosteessa se mainitaan.**
+   ========================================================================== */
+import { lueAsetukset } from "./asetukset.js";
+import { lueTunnus } from "./tunnus.js";
+/** Istunnon eväste. */
+export const EVASTE_ISTUNTO = "editori_istunto";
+/** Kirjautumispyynnön eväste, joka sitoo linkin tähän selaimeen. */
+export const EVASTE_PYYNTO = "editori_pyynto";
+/**
+ * Rakentaa Set-Cookie-otsakkeen.
+ *
+ * `SameSite=Lax` on tarkoituksella: kirjautumislinkki tulee sähköpostista
+ * eli toisesta ympäristöstä, ja `Strict` estäisi evästeen lähtemisen juuri
+ * siinä pyynnössä. Lax riittää, koska tallentavat pyynnöt ovat POSTeja.
+ */
+export function evaste(nimi, arvo, asetukset) {
+    const osat = [
+        `${nimi}=${arvo}`,
+        "Path=/",
+        "HttpOnly",
+        "SameSite=Lax",
+        `Max-Age=${asetukset.maxAge}`,
+    ];
+    if (asetukset.suojattu)
+        osat.push("Secure");
+    return osat.join("; ");
+}
+/** Tyhjentää evästeen. */
+export function poistaEvaste(nimi, suojattu) {
+    return evaste(nimi, "", { maxAge: 0, suojattu });
+}
+/**
+ * Kirjautuneen muokkaajan sähköpostiosoite, tai `null`. Tätä käytetään
+ * sivuston palvelinkomponenteissa: kirjautuneelle näytetään muokkaustila,
+ * muille tavallinen sivu.
+ */
+export async function kirjautunutMuokkaaja(yliajot = {}) {
+    let asetukset;
+    try {
+        asetukset = lueAsetukset(yliajot);
+    }
+    catch {
+        /* Puuttuva asetus ei saa kaataa julkista sivua — se tarkoittaa vain,
+           ettei kukaan voi olla kirjautuneena. */
+        return null;
+    }
+    /*
+      Next tuodaan vasta tässä, ei tiedoston alussa: `next/headers` ratkeaa
+      vain Nextin kääntäjän kautta, ja paketin palvelinosaa pitää voida lukea
+      myös tavallisessa Nodessa (testit, työkalut).
+    */
+    const { cookies } = await import("next/headers");
+    const tunnus = (await cookies()).get(EVASTE_ISTUNTO)?.value;
+    if (!tunnus)
+        return null;
+    const sisalto = await lueTunnus(tunnus, asetukset.avain, "istunto");
+    if (!sisalto)
+        return null;
+    /* Oikeuden voi poistaa milloin tahansa: jos osoite ei ole enää sallittujen
+       listassa, vanha istunto lakkaa toimimasta heti. */
+    return asetukset.sallitut.includes(sisalto.sahkoposti) ? sisalto.sahkoposti : null;
+}
+/**
+ * Onko selaimen muokkaustila päällä?
+ *
+ * Eri asia kuin kirjautuminen: istunto voi olla voimassa, vaikka
+ * muokkaustila on katkennut uuden julkaisun myötä. Sivuston sivu voi tämän
+ * avulla tarjota "Avaa muokkaustila" -painiketta.
+ */
+export async function onMuokkaustila() {
+    try {
+        const { draftMode } = await import("next/headers");
+        return (await draftMode()).isEnabled;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/palvelin/kaannos.d.ts

@@ -0,0 +1,12 @@
+export interface KaannosAsetukset {
+    /** API-avain. Oletuksena EDITORI_KAANNOS_AVAIN, EDITORI_KUVATEKSTI_AVAIN tai ANTHROPIC_API_KEY. */
+    avain?: string;
+}
+/** Käännettävä sisältö: kentän avain → teksti tai lista kappaleita. */
+export type Kaannettava = Record<string, string | string[]>;
+export declare function kaannosAvain(asetukset?: KaannosAsetukset): string | undefined;
+/**
+ * Kääntää annetut tekstit, tai palauttaa `null` jos ominaisuus ei ole
+ * käytössä tai vastaus ei ollut odotetun muotoinen.
+ */
+export declare function kaannaTekstit(tekstit: Kaannettava, lahdekieli: string, kohdekieli: string, asetukset?: KaannosAsetukset): Promise<Kaannettava | null>;