hammerkit 1.27.0-next.13 → 1.27.0-next.15

package/dist/server/endpoints.js

@@ -0,0 +1,612 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ownPath = exports.EndpointGateway = exports.LOGIN_HOST = void 0;
+const crypto_1 = require("crypto");
+const promises_1 = require("fs/promises");
+const http_1 = require("http");
+const net_1 = require("net");
+const path_1 = require("path");
+const oauth_1 = require("./oauth");
+const policy_1 = require("./policy");
+const service_runs_1 = require("./service-runs");
+const units_1 = require("../utils/units");
+// The cookie of a sign-in at one endpoint host. `__Host-` keeps a page on another host of the
+// domain from setting or overwriting it; it needs https, so plain http (on the loopback
+// interface, for testing) goes without the prefix.
+const SESSION_COOKIE = '__Host-hammerkit-session';
+const PLAIN_SESSION_COOKIE = 'hammerkit-session';
+// the host of the domain that signs people in, the one redirect URI registered at the issuer
+exports.LOGIN_HOST = 'login';
+// the paths of an endpoint host that are the server's, never the app's
+const OWN_PATH = '/.hammerkit/';
+// how long a sign-in may take at the issuer, and how long its one-time code holds
+const LOGIN_TIMEOUT_MS = 10 * 60 * 1000;
+const CODE_TIMEOUT_MS = 60 * 1000;
+const MAX_PENDING_LOGINS = 1000;
+const DISCOVERY_TTL_MS = 10 * 60 * 1000;
+const FETCH_TIMEOUT_MS = 10000;
+/**
+ * Publishes the endpoints of service runs: every host `<label>.<domain>` is answered here
+ * and nowhere else. A caller is known by a session cookie of that host, which the sign-in
+ * at `login.<domain>` gives a person, or by a token in `Hammerkit-Authorization`. Who may
+ * open it (the run's owner, or an `open` level for its repository) is decided with the
+ * entitlements of the moment on every request, then the request goes to the service's port.
+ */
+class EndpointGateway {
+    constructor(config, registry, options) {
+        this.config = config;
+        this.registry = registry;
+        this.options = options;
+        this.pending = new Map();
+        this.codes = new Map();
+        this.base = { scheme: 'https', port: '' };
+        this.fetcher = options.fetch ?? fetch;
+        this.now = options.now ?? Date.now;
+        const login = config.endpoints?.login;
+        const issuer = login ? config.issuers.find((candidate) => candidate.issuer === login.issuer) : undefined;
+        if (login && issuer) {
+            // an ID token is meant for the client that signed in, not for the API
+            this.loginVerifier = new oauth_1.TokenVerifier([{ ...issuer, audience: login.clientId }], {
+                ...(options.fetch ? { fetch: options.fetch } : {}),
+                ...(options.now ? { now: options.now } : {}),
+            });
+        }
+    }
+    async load() {
+        try {
+            const key = await (0, promises_1.readFile)(this.options.keyFile);
+            if (key.length >= 32) {
+                this.key = key;
+                return;
+            }
+        }
+        catch {
+            // made below
+        }
+        this.key = (0, crypto_1.randomBytes)(32);
+        await (0, promises_1.mkdir)((0, path_1.dirname)(this.options.keyFile), { recursive: true, mode: 0o700 });
+        await (0, promises_1.writeFile)(this.options.keyFile, this.key, { mode: 0o600 });
+    }
+    // Where the server listens, for the addresses of endpoints: https unless it serves plain
+    // http on the loopback interface; no port behind a proxy or on the default one.
+    listening(port, secure) {
+        const scheme = secure || this.config.behindTlsProxy ? 'https' : 'http';
+        const standard = this.config.behindTlsProxy || (scheme === 'https' ? port === 443 : port === 80);
+        this.base = { scheme, port: standard ? '' : `:${port}` };
+    }
+    url(host, path = '/') {
+        return `${this.base.scheme}://${host}.${this.config.endpoints?.domain}${this.base.port}${path}`;
+    }
+    // The label of an endpoint host the request is for, or null when it is for the API.
+    hostOf(req) {
+        const domain = this.config.endpoints?.domain;
+        const host = (req.headers.host ?? '').toLowerCase().replace(/:\d+$/, '');
+        if (!domain || !host.endsWith(`.${domain}`)) {
+            return null;
+        }
+        return host.slice(0, -domain.length - 1);
+    }
+    async handle(label, req, res) {
+        const url = new URL(req.url ?? '/', 'http://endpoint');
+        if (label === exports.LOGIN_HOST) {
+            return this.handleLogin(req, res, url);
+        }
+        const found = /^[a-z0-9-]+$/.test(label) ? this.registry.endpoint(label) : undefined;
+        if (url.pathname === `${OWN_PATH}session`) {
+            return this.takeCode(label, req, res, url);
+        }
+        if (url.pathname === `${OWN_PATH}logout`) {
+            res.writeHead(303, { location: '/', 'set-cookie': this.clearCookie(), 'cache-control': 'no-store' });
+            res.end();
+            return;
+        }
+        if (!found) {
+            return page(res, 404, 'Not found', '<p>There is no endpoint at this address.</p>');
+        }
+        const principal = await this.caller(label, req);
+        if (!principal) {
+            if (this.loginVerifier && req.method === 'GET' && acceptsHtml(req.headers)) {
+                const start = new URL(this.url(exports.LOGIN_HOST, '/start'));
+                start.searchParams.set('host', label);
+                start.searchParams.set('path', url.pathname + url.search);
+                res.writeHead(302, { location: start.toString(), 'cache-control': 'no-store' });
+                res.end();
+                return;
+            }
+            res.writeHead(401, {
+                'content-type': 'text/plain; charset=utf-8',
+                'www-authenticate': 'Bearer realm="hammerkit"',
+                'cache-control': 'no-store',
+            });
+            res.end('sign in: send a token in Hammerkit-Authorization: Bearer <token>\n');
+            return;
+        }
+        if (!this.mayOpen(principal, found.run)) {
+            this.options.log(`deny endpoint ${label} iss=${principal.iss} sub=${principal.sub}`);
+            return page(res, 403, 'Not allowed', `<p>You are signed in as <code>${escape(principal.sub)}</code> of <code>${escape(principal.iss)}</code>, which may not open this endpoint.</p><p><a href="${OWN_PATH}logout">Sign out</a></p>`);
+        }
+        if (url.pathname === `${OWN_PATH}status` || url.pathname === `${OWN_PATH}extend`) {
+            return this.status(label, found.run, found.endpoint, principal, req, res, url);
+        }
+        if (url.pathname.startsWith(OWN_PATH)) {
+            return page(res, 404, 'Not found', '<p>There is no such page.</p>');
+        }
+        // a request keeps the services up, or wakes them
+        const refused = this.registry.visit(found.run.id, this.options.mayWake);
+        if (!found.target) {
+            return this.notUp(res, this.registry.endpoint(label)?.run ?? found.run, refused);
+        }
+        this.forward(found.target, principal, req, res);
+    }
+    // A WebSocket (or any upgrade) to an endpoint, after the same checks as a request.
+    async upgrade(label, req, socket, head) {
+        const refuse = (status, text) => {
+            socket.end(`HTTP/1.1 ${status} ${text}\r\nconnection: close\r\ncontent-length: 0\r\n\r\n`);
+        };
+        const found = label !== exports.LOGIN_HOST && /^[a-z0-9-]+$/.test(label) ? this.registry.endpoint(label) : undefined;
+        if (!found) {
+            return refuse(404, 'Not Found');
+        }
+        const principal = await this.caller(label, req);
+        if (!principal) {
+            return refuse(401, 'Unauthorized');
+        }
+        if (!this.mayOpen(principal, found.run)) {
+            this.options.log(`deny endpoint ${label} iss=${principal.iss} sub=${principal.sub}`);
+            return refuse(403, 'Forbidden');
+        }
+        if (new URL(req.url ?? '/', 'http://endpoint').pathname.startsWith(OWN_PATH)) {
+            return refuse(404, 'Not Found');
+        }
+        this.registry.visit(found.run.id, this.options.mayWake);
+        const target = found.target;
+        if (!target) {
+            return refuse(503, 'Service Unavailable');
+        }
+        const upstream = (0, net_1.connect)(target.address.port, target.address.host);
+        const headers = this.forwardedHeaders(req, principal);
+        upstream.once('connect', () => {
+            const lines = [`${req.method} ${req.url} HTTP/1.1`];
+            for (const [name, value] of Object.entries(headers)) {
+                for (const item of Array.isArray(value) ? value : [value]) {
+                    if (item !== undefined) {
+                        lines.push(`${name}: ${item}`);
+                    }
+                }
+            }
+            upstream.write(`${lines.join('\r\n')}\r\n\r\n`);
+            if (head.length > 0) {
+                upstream.write(head);
+            }
+            upstream.pipe(socket);
+            socket.pipe(upstream);
+        });
+        upstream.on('error', () => socket.destroy());
+        socket.on('error', () => upstream.destroy());
+        socket.on('close', () => upstream.destroy());
+        upstream.on('close', () => socket.destroy());
+    }
+    // The owner of the run, or who has an `open` level for its repository, with the
+    // entitlements as they are now.
+    mayOpen(principal, run) {
+        if (run.owner.iss === principal.iss && run.owner.sub === principal.sub) {
+            return true;
+        }
+        return (0, service_runs_1.mayOpenEndpoints)((0, policy_1.getGrant)(this.config.entitlements, principal), run);
+    }
+    async caller(label, req) {
+        const header = req.headers['hammerkit-authorization'];
+        const token = typeof header === 'string' ? /^Bearer ([A-Za-z0-9._~+/-]+=*)$/.exec(header)?.[1] : undefined;
+        if (token) {
+            try {
+                return await this.options.verifier.verify(token);
+            }
+            catch (e) {
+                this.options.log(`deny endpoint ${label}: ${e instanceof oauth_1.TokenError ? e.message : 'token could not be checked'}`);
+                return null;
+            }
+        }
+        // the cookie is sent along when a page of another endpoint asks: the endpoints share
+        // one site, and the app of one is not to act as its visitor on another
+        if (this.fromElsewhere(label, req)) {
+            return null;
+        }
+        const session = this.readSession(label, req.headers.cookie);
+        return session ? { iss: session.iss, sub: session.sub, groups: session.groups, claims: session.claims } : null;
+    }
+    // Whether the browser sends the request for another page than the endpoint's own: an
+    // upgrade from another origin, or a request a page of another site makes (a frame too),
+    // but a link followed to the endpoint. Without Sec-Fetch-Site, by its Origin.
+    fromElsewhere(label, req) {
+        const origin = req.headers.origin;
+        const own = this.url(label, '/').slice(0, -1);
+        if (req.headers.upgrade) {
+            return origin !== own;
+        }
+        const site = req.headers['sec-fetch-site'];
+        if (site === 'same-site' || site === 'cross-site') {
+            // a page of its own the person goes to, not one framed by another site
+            const dest = req.headers['sec-fetch-dest'];
+            return !(req.headers['sec-fetch-mode'] === 'navigate' &&
+                (dest === undefined || dest === 'document') &&
+                (req.method === 'GET' || req.method === 'HEAD'));
+        }
+        return site === undefined && origin !== undefined && origin !== own;
+    }
+    forward(target, principal, req, res) {
+        const upstream = (0, http_1.request)({
+            host: target.address.host,
+            port: target.address.port,
+            method: req.method,
+            path: req.url,
+            headers: this.forwardedHeaders(req, principal),
+        }, (answer) => {
+            const headers = { ...answer.headers, 'x-robots-tag': 'noindex' };
+            res.writeHead(answer.statusCode ?? 502, answer.statusMessage, headers);
+            answer.pipe(res);
+        });
+        upstream.on('error', (e) => {
+            this.options.log(`endpoint ${target.service}:${target.port}: ${e.message}`);
+            if (!res.headersSent) {
+                page(res, 502, 'Not reachable', `<p>${escape(target.service)} did not answer on port ${target.port}.</p>`);
+            }
+            else {
+                res.destroy();
+            }
+        });
+        res.on('close', () => upstream.destroy());
+        req.pipe(upstream);
+    }
+    // What reaches the app: the request without the server's cookie and headers, with who asked.
+    forwardedHeaders(req, principal) {
+        const headers = {};
+        for (const [name, value] of Object.entries(req.headers)) {
+            if (name.startsWith('hammerkit-') || name.startsWith('x-hammerkit-') || name.startsWith('x-forwarded-')) {
+                continue;
+            }
+            headers[name] = value;
+        }
+        const cookies = (req.headers.cookie ?? '')
+            .split(/;\s*/)
+            .filter((cookie) => cookie && !cookie.startsWith(`${SESSION_COOKIE}=`) && !cookie.startsWith(`${PLAIN_SESSION_COOKIE}=`));
+        if (cookies.length > 0) {
+            headers.cookie = cookies.join('; ');
+        }
+        else {
+            delete headers.cookie;
+        }
+        headers['x-forwarded-proto'] = this.base.scheme;
+        headers['x-forwarded-host'] = req.headers.host ?? '';
+        headers['x-forwarded-for'] = req.socket.remoteAddress ?? '';
+        headers['x-hammerkit-caller'] = `${principal.iss} ${principal.sub}`;
+        return headers;
+    }
+    notUp(res, run, refused) {
+        if (run.state === 'queued' || run.state === 'running' || run.state === 'awaiting-approval') {
+            res.setHeader('refresh', '5');
+            res.setHeader('retry-after', '5');
+            return page(res, 503, 'Starting', `<p>The services of this endpoint are ${run.wakes ? 'waking up' : 'starting'} (${escape(run.state)}), this page reloads until they are up.</p>`);
+        }
+        if (run.state === 'asleep') {
+            return page(res, 503, 'Asleep', `<p>The services of this endpoint sleep and can not wake now: ${escape(refused ?? 'try again')}.</p>`);
+        }
+        const why = run.stoppedBy === 'ttl'
+            ? 'its time ran out'
+            : run.stoppedBy === 'replaced'
+                ? 'a newer run of the same name replaced it'
+                : run.stoppedBy
+                    ? `${escape(run.stoppedBy.sub)} stopped it`
+                    : escape(run.error ?? run.state);
+        return page(res, 410, 'Ended', `<p>This endpoint ended${run.finishedAt ? ` at ${escape(run.finishedAt)}` : ''}: ${why}.</p><p>Ask <code>${escape(run.owner.sub)}</code> to start it again.</p>`);
+    }
+    async status(label, run, endpoint, principal, req, res, url) {
+        const csrf = this.sign(`csrf\0${label}\0${principal.iss}\0${principal.sub}`);
+        if (url.pathname === `${OWN_PATH}extend`) {
+            if (req.method !== 'POST') {
+                return page(res, 405, 'Not allowed', '<p>Extend with the form of the status page.</p>');
+            }
+            const form = new URLSearchParams(await readText(req, 4096));
+            if (!safeEqual(form.get('csrf') ?? '', csrf)) {
+                return page(res, 403, 'Not allowed', '<p>The form is out of date, open the status page again.</p>');
+            }
+            let ttl;
+            try {
+                ttl = (0, units_1.parseDuration)(form.get('ttl') ?? '');
+                if (!(ttl > 0)) {
+                    throw new Error('no time');
+                }
+            }
+            catch {
+                return page(res, 400, 'Not a duration', '<p>Pick how long it should stay.</p>');
+            }
+            const result = this.registry.extend(principal, run.id, ttl, () => this.mayOpen(principal, run));
+            this.options.log(`extend iss=${principal.iss} sub=${principal.sub} run=${run.id} result=${result.status}`);
+            res.writeHead(303, { location: `${OWN_PATH}status`, 'cache-control': 'no-store' });
+            res.end();
+            return;
+        }
+        const source = run.source.type === 'ref'
+            ? `${run.source.repo} ${run.source.ref} at ${run.source.commit.slice(0, 12)}`
+            : run.source.type === 'sandbox'
+                ? `sandbox ${run.source.id} of ${run.source.repo} at ${run.source.commit.slice(0, 12)}${run.source.clean === false ? ' with changes' : ''}`
+                : 'an upload';
+        const options = ['1h', '8h', '24h', '72h']
+            .map((ttl) => `<option value="${ttl}"${ttl === '8h' ? ' selected' : ''}>${ttl}</option>`)
+            .join('');
+        return page(res, 200, run.up?.name ?? 'Endpoint', `<dl>
+<dt>Service</dt><dd>${escape(endpoint.service)}, port ${endpoint.port}</dd>
+<dt>Run</dt><dd><code>${escape(run.id)}</code> of <code>${escape(run.owner.sub)}</code>, ${escape(run.state)}</dd>
+<dt>Source</dt><dd>${escape(source)}</dd>
+<dt>Ends</dt><dd>${escape(run.expiresAt ?? 'when it is up and its time ran out')}</dd>
+${run.up?.sleepTtl
+            ? `<dt>Sleeps</dt><dd>after ${escape((0, units_1.formatDuration)(run.up.sleepTtl))} without a request${run.sleepsAt ? `, next at ${escape(run.sleepsAt)}` : ''}; a request wakes it</dd>\n`
+            : ''}<dt>Signed in</dt><dd><code>${escape(principal.sub)}</code></dd>
+</dl>
+${run.state === 'up'
+            ? `<form method="post" action="${OWN_PATH}extend"><input type="hidden" name="csrf" value="${csrf}"><label>Keep it for <select name="ttl">${options}</select> from now</label> <button>Extend</button></form>`
+            : ''}
+<p><a href="/">Open the app</a> · <a href="${OWN_PATH}logout">Sign out</a></p>`);
+    }
+    // ---- sign-in, on login.<domain> ----
+    async handleLogin(req, res, url) {
+        const login = this.config.endpoints?.login;
+        if (!login || !this.loginVerifier || req.method !== 'GET') {
+            return page(res, 404, 'Not found', '<p>There is nothing here.</p>');
+        }
+        if (url.pathname === '/start') {
+            const host = url.searchParams.get('host') ?? '';
+            const path = url.searchParams.get('path') ?? '/';
+            if (!/^[a-z0-9-]+$/.test(host) || host === exports.LOGIN_HOST || !this.registry.endpoint(host)) {
+                return page(res, 404, 'Not found', '<p>There is no endpoint at this address.</p>');
+            }
+            const endpoints = await this.endpointsOf(login.issuer);
+            this.sweep();
+            if (this.pending.size >= MAX_PENDING_LOGINS) {
+                return page(res, 503, 'Busy', '<p>Too many sign-ins at once, try again in a minute.</p>');
+            }
+            const state = (0, crypto_1.randomBytes)(24).toString('base64url');
+            const verifier = (0, crypto_1.randomBytes)(32).toString('base64url');
+            const nonce = (0, crypto_1.randomBytes)(24).toString('base64url');
+            this.pending.set(state, {
+                host,
+                path: ownPath(path),
+                verifier,
+                nonce,
+                expires: this.now() + LOGIN_TIMEOUT_MS,
+            });
+            const authorize = new URL(endpoints.authorize);
+            authorize.searchParams.set('response_type', 'code');
+            authorize.searchParams.set('client_id', login.clientId);
+            authorize.searchParams.set('redirect_uri', this.url(exports.LOGIN_HOST, '/callback'));
+            authorize.searchParams.set('scope', login.scope);
+            authorize.searchParams.set('state', state);
+            authorize.searchParams.set('nonce', nonce);
+            authorize.searchParams.set('code_challenge', (0, crypto_1.createHash)('sha256').update(verifier).digest('base64url'));
+            authorize.searchParams.set('code_challenge_method', 'S256');
+            res.writeHead(302, { location: authorize.toString(), 'cache-control': 'no-store' });
+            res.end();
+            return;
+        }
+        if (url.pathname === '/callback') {
+            const state = url.searchParams.get('state') ?? '';
+            const pending = this.pending.get(state);
+            this.pending.delete(state);
+            if (!pending || pending.expires < this.now()) {
+                return page(res, 400, 'Sign-in expired', '<p>The sign-in took too long or was used already, open the endpoint again.</p>');
+            }
+            const code = url.searchParams.get('code');
+            if (!code) {
+                const error = url.searchParams.get('error') ?? 'no code';
+                return page(res, 400, 'Not signed in', `<p>The sign-in did not succeed: ${escape(error.slice(0, 200))}.</p>`);
+            }
+            let principal;
+            try {
+                principal = await this.exchange(code, pending);
+            }
+            catch (e) {
+                this.options.log(`endpoint sign-in failed: ${e instanceof Error ? e.message : String(e)}`);
+                return page(res, 400, 'Not signed in', '<p>The sign-in could not be checked, open the endpoint again.</p>');
+            }
+            const found = this.registry.endpoint(pending.host);
+            if (!found || !this.mayOpen(principal, found.run)) {
+                this.options.log(`deny endpoint ${pending.host} iss=${principal.iss} sub=${principal.sub}`);
+                return page(res, 403, 'Not allowed', `<p>You signed in as <code>${escape(principal.sub)}</code>, which may not open this endpoint.</p>`);
+            }
+            const issued = (0, crypto_1.randomBytes)(24).toString('base64url');
+            this.codes.set(issued, {
+                host: pending.host,
+                path: pending.path,
+                principal,
+                expires: this.now() + CODE_TIMEOUT_MS,
+            });
+            const target = new URL(this.url(pending.host, `${OWN_PATH}session`));
+            target.searchParams.set('code', issued);
+            this.options.log(`endpoint sign-in ${pending.host} iss=${principal.iss} sub=${principal.sub}`);
+            res.writeHead(302, { location: target.toString(), 'cache-control': 'no-store' });
+            res.end();
+            return;
+        }
+        return page(res, 404, 'Not found', '<p>There is nothing here.</p>');
+    }
+    // The code of the issuer for its tokens, and the ID token for who signed in.
+    async exchange(code, pending) {
+        const login = this.config.endpoints?.login;
+        if (!login || !this.loginVerifier) {
+            throw new Error('no sign-in configured');
+        }
+        const endpoints = await this.endpointsOf(login.issuer);
+        const body = new URLSearchParams({
+            grant_type: 'authorization_code',
+            code,
+            redirect_uri: this.url(exports.LOGIN_HOST, '/callback'),
+            client_id: login.clientId,
+            code_verifier: pending.verifier,
+        });
+        if (this.options.clientSecret) {
+            body.set('client_secret', await this.options.clientSecret());
+        }
+        const response = await this.fetcher(endpoints.token, {
+            method: 'POST',
+            headers: { 'content-type': 'application/x-www-form-urlencoded', accept: 'application/json' },
+            body: body.toString(),
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+        });
+        const answer = (await response.json().catch(() => ({})));
+        if (!response.ok || typeof answer.id_token !== 'string') {
+            throw new Error(`the token endpoint answered ${response.status}${answer.error ? ` ${String(answer.error)}` : ''}`);
+        }
+        const principal = await this.loginVerifier.verify(answer.id_token);
+        if (principal.claims.nonce !== pending.nonce) {
+            throw new oauth_1.TokenError('the ID token is not of this sign-in (nonce)');
+        }
+        return principal;
+    }
+    async endpointsOf(issuer) {
+        if (this.discovery && this.now() - this.discovery.at < DISCOVERY_TTL_MS) {
+            return this.discovery;
+        }
+        const response = await this.fetcher(`${issuer.replace(/\/+$/, '')}/.well-known/openid-configuration`, {
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+        });
+        const metadata = (await response.json());
+        if (typeof metadata.authorization_endpoint !== 'string' || typeof metadata.token_endpoint !== 'string') {
+            throw new Error(`${issuer} names no authorization or token endpoint`);
+        }
+        this.discovery = { at: this.now(), authorize: metadata.authorization_endpoint, token: metadata.token_endpoint };
+        return this.discovery;
+    }
+    // `/.hammerkit/session?code=` on the endpoint host: the one-time code of the sign-in
+    // becomes the cookie of this host.
+    takeCode(label, req, res, url) {
+        const code = url.searchParams.get('code') ?? '';
+        const issued = this.codes.get(code);
+        this.codes.delete(code);
+        if (!issued || issued.host !== label || issued.expires < this.now()) {
+            return page(res, 400, 'Sign-in expired', '<p>The sign-in took too long or was used already, open the endpoint again.</p>');
+        }
+        const found = this.registry.endpoint(label);
+        const ends = Date.parse(found?.run.expiresAt ?? '');
+        const session = this.now() + (0, units_1.parseDuration)(this.config.endpoints?.session ?? '8h');
+        const exp = Number.isFinite(ends) ? Math.min(session, Math.max(ends, this.now() + LOGIN_TIMEOUT_MS)) : session;
+        res.writeHead(303, {
+            location: issued.path,
+            'set-cookie': this.sessionCookie({
+                host: label,
+                iss: issued.principal.iss,
+                sub: issued.principal.sub,
+                groups: issued.principal.groups,
+                claims: this.matchedClaims(issued.principal),
+                exp,
+            }),
+            'cache-control': 'no-store',
+        });
+        res.end();
+    }
+    // Only the claims an entitlement matches on go into the cookie, which stays small.
+    matchedClaims(principal) {
+        const names = new Set(this.config.entitlements.flatMap((entitlement) => Object.keys(entitlement.claims?.match ?? {})));
+        return Object.fromEntries(Object.entries(principal.claims).filter(([name]) => names.has(name)));
+    }
+    cookieName() {
+        return this.base.scheme === 'https' ? SESSION_COOKIE : PLAIN_SESSION_COOKIE;
+    }
+    sessionCookie(session) {
+        const payload = Buffer.from(JSON.stringify(session)).toString('base64url');
+        const value = `${payload}.${this.sign(payload)}`;
+        const maxAge = Math.max(0, Math.floor((session.exp - this.now()) / 1000));
+        return `${this.cookieName()}=${value}; Path=/; HttpOnly; SameSite=Lax; Max-Age=${maxAge}${this.base.scheme === 'https' ? '; Secure' : ''}`;
+    }
+    clearCookie() {
+        return `${this.cookieName()}=; Path=/; HttpOnly; SameSite=Lax; Max-Age=0${this.base.scheme === 'https' ? '; Secure' : ''}`;
+    }
+    readSession(label, header) {
+        const name = this.cookieName();
+        const value = (header ?? '')
+            .split(/;\s*/)
+            .find((cookie) => cookie.startsWith(`${name}=`))
+            ?.slice(name.length + 1);
+        const [payload, signature] = (value ?? '').split('.');
+        if (!payload || !signature || !safeEqual(signature, this.sign(payload))) {
+            return null;
+        }
+        try {
+            const session = JSON.parse(Buffer.from(payload, 'base64url').toString('utf8'));
+            if (session.host !== label || !(session.exp > this.now()) || !session.iss || !session.sub) {
+                return null;
+            }
+            return {
+                ...session,
+                groups: Array.isArray(session.groups) ? session.groups : [],
+                claims: session.claims ?? {},
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    sign(value) {
+        if (!this.key) {
+            throw new Error('the endpoints were not loaded');
+        }
+        return (0, crypto_1.createHmac)('sha256', this.key).update(value).digest('base64url');
+    }
+    sweep() {
+        const now = this.now();
+        for (const [state, login] of this.pending) {
+            if (login.expires < now) {
+                this.pending.delete(state);
+            }
+        }
+        for (const [code, issued] of this.codes) {
+            if (issued.expires < now) {
+                this.codes.delete(code);
+            }
+        }
+    }
+}
+exports.EndpointGateway = EndpointGateway;
+function safeEqual(a, b) {
+    const left = Buffer.from(a);
+    const right = Buffer.from(b);
+    return left.length === right.length && (0, crypto_1.timingSafeEqual)(left, right);
+}
+function acceptsHtml(headers) {
+    return (headers.accept ?? '').includes('text/html');
+}
+function escape(text) {
+    return text.replace(/[&<>"']/g, (char) => `&#${char.charCodeAt(0)};`);
+}
+async function readText(req, limit) {
+    let text = '';
+    for await (const chunk of req) {
+        text += chunk.toString('utf8');
+        if (text.length > limit) {
+            break;
+        }
+    }
+    return text.slice(0, limit);
+}
+// A page of the server's own on an endpoint host: nothing of it is the app's.
+function page(res, status, title, body) {
+    res.writeHead(status, {
+        'content-type': 'text/html; charset=utf-8',
+        'cache-control': 'no-store',
+        'x-robots-tag': 'noindex',
+        'content-security-policy': "default-src 'none'; style-src 'unsafe-inline'; form-action 'self'",
+        'x-frame-options': 'DENY',
+    });
+    res.end(`<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>${escape(title)}</title><style>body{font:16px/1.5 system-ui,sans-serif;max-width:40rem;margin:3rem auto;padding:0 1rem;color:#222}code{background:#f2f2f2;padding:0 .2em}dt{font-weight:600}dd{margin:0 0 .5rem}</style></head><body><h1>${escape(title)}</h1>${body}<p><small>hammerkit</small></p></body></html>`);
+}
+// Where on its own host a person goes back to after the sign-in: a path, never an address a
+// browser reads as another host (`//x`, `/\\x`, control characters).
+function ownPath(path) {
+    if (!path.startsWith('/') ||
+        [...path].some((char) => char === '\\' || char.charCodeAt(0) < 0x20 || char === '\u007f')) {
+        return '/';
+    }
+    const base = 'http://endpoint.invalid';
+    const target = new URL(path, base);
+    return target.origin === base ? target.pathname + target.search : '/';
+}
+exports.ownPath = ownPath;
+//# sourceMappingURL=endpoints.js.map

package/dist/server/executor.js

@@ -127,7 +127,9 @@ class HostExecutor {
                 const credentials = await repos.credentials(repo);
                 let commit;
                 try {
-                    commit = await (0, git_checkout_1.checkoutRef)(repos.url(repo), ref, cwd, credentials.env, abortCtrl.signal, pinned);
+                    // a woken service run starts the commit it started first, where the ref is now or not
+                    const fetched = run.wakes ? pinned : ref;
+                    commit = await (0, git_checkout_1.checkoutRef)(repos.url(repo), fetched, cwd, credentials.env, abortCtrl.signal, pinned);
                 }
                 catch (e) {
                     throw repos.scrub(e, credentials.values);
@@ -189,6 +191,14 @@ class HostExecutor {
                     accounts: run.accounts,
                     volumeScope: volumeScope(run),
                     catalog: planning.environment.hosted?.catalog,
+                    ...(run.up
+                        ? {
+                            up: {
+                                services: run.up.services,
+                                endpoints: run.up.endpoints.map(({ service, port }) => ({ service, port })),
+                            },
+                        }
+                        : {}),
                     ...(placed ? { kubernetes: placed.kubernetes } : {}),
                 }, cwd, { ...this.processEnvironment(home, cache), ...placed?.env }, context, abortCtrl.signal);
             }
@@ -282,6 +292,9 @@ class HostExecutor {
                     if (message.kind === 'event') {
                         context.emit(message.event);
                     }
+                    else if (message.kind === 'up') {
+                        context.up?.(message.targets);
+                    }
                     else if (message.kind === 'result') {
                         result = message;
                         // nothing left to tell the process