koppler 0.0.0-stage → 0.0.1

package/dist/cli/running.js

@@ -0,0 +1,270 @@
+// The commands about what Koppler runs: stop, the canvas, logs and status.
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { readClones, readData, readStack } from "../data.js";
+import { alive, listener, NAME, readRecord, records, sh, sleep, stopOne, uptime } from "../engine/processes.js";
+import { run } from "../engine/run.js";
+import { appendNote, live } from "../engine/history.js";
+import { runLog } from "../engine/run-logs.js";
+import { CODE, logsDir, tempDir } from "../paths.js";
+import { redact, scrub } from "../scrub.js";
+import { confirm, flagValue, positional, table } from "./output.js";
+import { fail } from "../failure.js";
+import { newToken } from "../server/token.js";
+const notAName = (name) => `${name} is not a name Koppler gives its processes`;
+export async function stop(args) {
+    // --all: every app, API and tunnel Koppler runs, but not the canvas; code changes and branches stay as they are.
+    const all = args.includes('--all');
+    const names = args.filter(arg => !arg.startsWith('-'));
+    if (!all && !names.length)
+        fail('usage: koppler stop <name...> | --all [--yes]');
+    for (const name of names)
+        if (!NAME.test(name))
+            fail(notAName(name));
+    const targets = all
+        ? records().filter(record => record.name !== 'canvas')
+        : names.map(name => readRecord(name) ?? fail(`${name} is not started by koppler`));
+    if (!targets.length) {
+        console.log('nothing to stop');
+        return;
+    }
+    const asked = `Stop ${targets.map(record => record.name).join(', ')}?`;
+    if (all && !(await confirm(asked, args)))
+        fail('nothing stopped (in a script, add --yes)');
+    for (const line of await Promise.all(targets.map(stopOne)))
+        console.log(line);
+    // Stopping in bulk is not a run, so the history gets a note of it: later it says why nothing runs any more.
+    const stopped = targets.map(record => record.name);
+    if (all)
+        appendNote('stop-apps', stopped);
+}
+/** The canvas: started when it is not running, then opened in the browser. */
+export async function canvas(args) {
+    if (args[0] === 'stop') {
+        await stop(['canvas']);
+        return;
+    }
+    const record = readRecord('canvas');
+    const urlFile = path.join(tempDir(), 'canvas-url');
+    // A new address: a running canvas switches to it, so every address given out before stops working.
+    if (args.includes('--new-address')) {
+        if (record && alive(record)) {
+            const old = new URL(fs.readFileSync(urlFile, 'utf8').trim());
+            const token = old.pathname.split('/')[2] ?? '';
+            const answer = await fetch(`${old.origin}/new-address?token=${encodeURIComponent(token)}`, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({ port: old.port }),
+            }).catch(() => null);
+            if (!answer?.ok)
+                fail('the canvas did not take a new address; koppler canvas stop, then koppler canvas --new-address');
+        }
+        else
+            newToken();
+        console.log('The canvas has a new address; every address given out before no longer works.');
+    }
+    if (!record || !alive(record)) {
+        const port = String(Number(process.env['KOPPLER_PORT']) || 4747);
+        await run(['canvas', '--port', port, '--', process.execPath, path.join(CODE, 'status-watch.mjs')]);
+    }
+    for (let tries = 0; tries < 40 && !fs.existsSync(urlFile); tries++)
+        await sleep(250);
+    if (!fs.existsSync(urlFile))
+        fail('the canvas did not start; see koppler logs canvas');
+    // The address carries the page's access token, so it goes to the browser and is not printed.
+    const board = flagValue(args, '--board');
+    const hash = args.includes('--pick') ? '#pick' : board ? `#board=${encodeURIComponent(board)}` : '';
+    const url = fs.readFileSync(urlFile, 'utf8').trim() + hash;
+    if (args.includes('--no-open') || process.platform !== 'darwin') {
+        console.log(`The canvas runs on port ${new URL(url).port}; its address is in ${urlFile}`);
+        return;
+    }
+    sh('open', [url]);
+    console.log('The canvas is open in your browser.');
+}
+/** A log, with secrets masked as on the card; `-f` follows it. */
+export function logs(args) {
+    const [want] = positional(args, ['-n', '--run']);
+    const lines = Number(flagValue(args, '-n')) || 50;
+    if (!want)
+        fail('usage: koppler logs <name> [-f] [-n <lines>] [--run <id>]');
+    if (!NAME.test(want))
+        fail(notAName(want));
+    const run = flagValue(args, '--run');
+    const kept = run ? runLog(run, want) : null;
+    if (run && !kept)
+        fail(`${run} is not a run id; koppler history lists them`);
+    const file = kept ?? path.join(logsDir(), `${want}.log`);
+    if (!fs.existsSync(file))
+        fail(run ? `run ${run} kept no log of ${want}` : `no log for ${want}; koppler status lists what runs`);
+    const last = fs.readFileSync(file, 'utf8').trimEnd().split('\n').slice(-lines);
+    process.stdout.write(redact(last.join('\n')) + '\n');
+    if (!args.includes('-f') && !args.includes('--follow'))
+        return;
+    let at = fs.statSync(file).size;
+    // Shown a whole line at a time: a secret is masked by the name before it, which may come in an earlier read.
+    let held = Buffer.alloc(0);
+    fs.watchFile(file, { interval: 500 }, now => {
+        if (now.size < at)
+            at = 0;
+        if (now.size === at)
+            return;
+        const fd = fs.openSync(file, 'r');
+        const added = Buffer.alloc(now.size - at);
+        fs.readSync(fd, added, 0, added.length, at);
+        fs.closeSync(fd);
+        at = now.size;
+        const all = Buffer.concat([held, added]);
+        const end = all.lastIndexOf(10) + 1;
+        held = all.subarray(end);
+        if (end)
+            process.stdout.write(redact(all.subarray(0, end).toString('utf8')));
+    });
+}
+const tail = (file, lines) => {
+    try {
+        return fs.readFileSync(file, 'utf8').trimEnd().split('\n').slice(-lines).join('\n');
+    }
+    catch {
+        return null;
+    }
+};
+const read = (file) => {
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+};
+const newestRunLog = () => {
+    try {
+        const logs = fs.readdirSync(tempDir()).filter(file => /^up-.*\.log$/.test(file));
+        const age = (file) => fs.statSync(path.join(tempDir(), file)).mtimeMs;
+        const [newest] = logs.sort((a, b) => age(b) - age(a));
+        return newest ? path.join(tempDir(), newest) : null;
+    }
+    catch {
+        return null;
+    }
+};
+/** A board's name says nothing about a bug and may name a project, even one no stack lists any more. */
+const unnamed = (line) => {
+    try {
+        const entry = JSON.parse(line);
+        if (entry.board?.name)
+            entry.board.name = 'board';
+        return JSON.stringify(entry);
+    }
+    catch {
+        return line;
+    }
+};
+/**
+ * What a bug report needs, ready to paste into a public issue: versions, then the tails of the canvas debug log, the
+ * latest run log and each named log, all scrubbed of secrets and of everything that names the user or their stack.
+ */
+async function debugReport(names) {
+    const { stacksHere } = await import("../engine/stacks.js");
+    const stacks = stacksHere().map(stack => read(path.join(stack.dir, 'stack.json')));
+    let commit = null;
+    try {
+        const git = ['-C', CODE, 'rev-parse', '--short', 'HEAD'];
+        commit = execFileSync('git', git, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+    }
+    catch {
+        // An installed copy is not a clone.
+    }
+    const parts = [`Koppler ${commit ?? 'installed copy'}, Node ${process.version}, ${os.type()} ${os.release()}`];
+    const add = (title, text) => {
+        if (text)
+            parts.push(`## ${title}\n\n\`\`\`text\n${text}\n\`\`\``);
+    };
+    add('Canvas debug log', tail(path.join(tempDir(), 'debug.jsonl'), 40)?.split('\n').map(unnamed).join('\n'));
+    const runLog = newestRunLog();
+    add(`Latest run (${runLog ? path.basename(runLog) : ''})`, runLog && tail(runLog, 60));
+    for (const name of names)
+        add(`${name} log`, NAME.test(name) ? (tail(path.join(logsDir(), `${name}.log`), 80) ?? 'no log') : 'not a log name');
+    console.log(scrub(parts.join('\n\n'), [readData('registry'), readData('state'), ...stacks]));
+}
+/** What runs; --apps adds every app in the stack with its clone; --debug is for a bug report. */
+export async function status(args = []) {
+    if (args.includes('--debug')) {
+        await debugReport(positional(args));
+        return;
+    }
+    const { processState, stateOf } = await import("../engine/app-state.js");
+    const processes = records().map(record => {
+        const up = alive(record);
+        return {
+            name: record.name,
+            state: up ? 'running' : 'exited',
+            pid: record.pid,
+            up: up ? uptime(record.startedAt) : null,
+            port: record.port ?? null,
+            open: !!(record.port && up && listener(record.port, record.bind)),
+            command: record.command,
+        };
+    });
+    const stack = args.includes('--apps') ? (readStack() ?? fail('no stack loaded (koppler init)')) : null;
+    const clones = readClones();
+    const apps = stack &&
+        Object.entries(stack.apps).map(([id, app]) => {
+            const clone = clones[id];
+            return {
+                id,
+                name: app.name,
+                kind: app.kind,
+                clone: clone ? { branch: clone.branch ?? null, changed: clone.dirty ?? 0 } : null,
+                state: processes.find(one => one.name === id)?.state ?? null,
+            };
+        });
+    if (args.includes('--json')) {
+        const steps = read(path.join(tempDir(), 'progress.json'))?.apps ?? {};
+        const detailed = await Promise.all(processes.map(async (one) => ({ ...one, status: stateOf(await processState(one.name), steps[one.name]) })));
+        let missing = {};
+        if (stack) {
+            const { secretsStatus } = await import("../server/secrets.js");
+            const env = live()?.env ?? stack.envs[0] ?? '';
+            const declared = await secretsStatus().catch(() => ({}));
+            missing = Object.fromEntries(Object.entries(declared).map(([id, envs]) => [
+                id,
+                (envs[env] ?? []).filter(secret => !secret.stored).map(secret => secret.name),
+            ]));
+        }
+        const withState = await Promise.all((apps ?? []).map(async (app) => ({
+            ...app,
+            status: stateOf(await processState(app.id), steps[app.id], missing[app.id]),
+        })));
+        console.log(JSON.stringify({ processes: detailed, ...(apps && { stack: stack.name ?? null, apps: withState }) }, null, 2));
+        return;
+    }
+    if (stack && apps) {
+        console.log(`${stack.name ?? 'stack'}: ${stack.source ?? ''}`);
+        const cloneOf = ({ clone }) => clone ? `${clone.branch ?? 'detached'}${clone.changed ? ` (${String(clone.changed)} changed)` : ''}` : 'missing';
+        table([
+            ['APP', 'NAME', 'KIND', 'CLONE', 'KOPPLER'],
+            ...apps.map(app => [app.id, app.name, app.kind, cloneOf(app), app.state ?? '-']),
+        ]);
+        console.log('');
+    }
+    if (!processes.length) {
+        console.log('nothing started by koppler');
+        return;
+    }
+    const short = (command) => (command.length > 70 ? command.slice(0, 67) + '...' : command);
+    table([
+        ['NAME', 'STATE', 'PID', 'UP', 'PORT', 'COMMAND'],
+        ...processes.map(one => [
+            one.name,
+            one.state,
+            one.pid,
+            one.up ?? '-',
+            one.port ? `${String(one.port)} ${one.open ? 'open' : 'closed'}` : '-',
+            short(one.command),
+        ]),
+    ]);
+}
+//# sourceMappingURL=running.js.map

package/dist/cli/running.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"running.js","sourceRoot":"","sources":["../../src/cli/running.ts"],"names":[],"mappings":"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"}

package/dist/cli/shell.js

@@ -0,0 +1,43 @@
+// `koppler shell <app>`: a shell in the app's clone with the settings its run starts it with (where the apps it calls
+// answer), never its secrets. `--query` opens psql on its database instead, through the stored connection.
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import { appOn, storeOf } from "../core/stack.js";
+import { readClones, readStack } from "../data.js";
+import { live } from "../engine/history.js";
+import { readRecord } from "../engine/processes.js";
+import { fail } from "../failure.js";
+import { CODE } from "../paths.js";
+import { flagValue, positional } from "./output.js";
+const USAGE = 'usage: koppler shell <app> [--env <env>] [--query]';
+export function shellCommand(args) {
+    const [id = ''] = positional(args, ['--env']);
+    const stack = readStack() ?? fail('no stack loaded (koppler init)');
+    const app = (Object.hasOwn(stack.apps, id) ? stack.apps[id] : undefined) ?? fail(USAGE);
+    const env = flagValue(args, '--env') ?? live()?.env ?? stack.envs[0] ?? '';
+    if (!stack.envs.includes(env))
+        fail(`unknown env ${env}; the stack has ${stack.envs.join(', ')}`);
+    if (args.includes('--query')) {
+        const secret = (appOn(stack, id, env)?.secrets ?? []).find(one => one.env && one.type === 'postgres');
+        if (!secret?.env)
+            fail(`${app.name} has no Postgres connection among its secrets on ${env.toUpperCase()}; for one query: koppler query ${id} --env ${env} "<sql>"`);
+        const store = storeOf(stack, id, env);
+        const ran = spawnSync(process.execPath, [path.join(CODE, 'koppler.mjs'), 'secret', 'psql', store, secret.env], {
+            stdio: 'inherit',
+        });
+        process.exit(ran.status ?? 1);
+    }
+    const repo = readClones()[id]?.path ?? fail(`${id} is not cloned (koppler sync --rescan after cloning)`);
+    // Only what the run gave it beside its own environment: the addresses of what it calls, never a stored value.
+    const given = readRecord(id)?.start?.setEnv ?? {};
+    const names = Object.keys(given);
+    console.log(`${app.name}, in ${repo}${names.length ? `, with ${names.join(', ')} as its run sets them` : ''}. Its secrets are not here. Type exit to leave.`);
+    const shell = process.env['SHELL'] || '/bin/sh';
+    const ran = spawnSync(shell, ['-i'], {
+        cwd: repo,
+        stdio: 'inherit',
+        env: { ...process.env, ...given, KOPPLER_APP: id, KOPPLER_ENV: env },
+    });
+    process.exit(ran.status ?? 0);
+}
+//# sourceMappingURL=shell.js.map

package/dist/cli/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/cli/shell.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,2GAA2G;AAC3G,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,KAAK,GAAG,oDAAoD,CAAC;AAEnE,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,SAAS,EAAE,IAAI,IAAI,CAAC,gCAAgC,CAAC,CAAC;IACpE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACxF,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3E,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,IAAI,CAAC,eAAe,GAAG,mBAAmB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClG,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QACtG,IAAI,CAAC,MAAM,EAAE,GAAG;YACd,IAAI,CACF,GAAG,GAAG,CAAC,IAAI,oDAAoD,GAAG,CAAC,WAAW,EAAE,kCAAkC,EAAE,UAAU,GAAG,UAAU,CAC5I,CAAC;QACJ,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE;YAC7G,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,sDAAsD,CAAC,CAAC;IACzG,8GAA8G;IAC9G,MAAM,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CACT,GAAG,GAAG,CAAC,IAAI,QAAQ,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,iDAAiD,CACjJ,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC;IAChD,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE;QACnC,GAAG,EAAE,IAAI;QACT,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE;KACrE,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/dist/cli/wait.js

@@ -0,0 +1,59 @@
+// `koppler wait`: blocks until apps Koppler runs are up, healthy or down, for agents and scripts.
+import { processState } from "../engine/app-state.js";
+import { NAME, readRecord, sleep, tailOf } from "../engine/processes.js";
+import { fail } from "../failure.js";
+import { flagValue, positional } from "./output.js";
+const USAGE = 'usage: koppler wait <app...> --healthy|--up|--down [--timeout <seconds>] [--json]';
+const GOALS = ['healthy', 'up', 'down'];
+const waitState = async (name) => {
+    const now = await processState(name);
+    return now?.state ?? 'not started';
+};
+const met = (goal, state) => goal === 'down'
+    ? state === 'not started' || state === 'exited'
+    : goal === 'up'
+        ? state !== 'not started' && state !== 'exited'
+        : state === 'running';
+/** Waits for every named app to reach the goal; exits 1 on a timeout or an app that exits, naming each app's state. */
+export async function wait(args) {
+    const goals = GOALS.filter(goal => args.includes(`--${goal}`));
+    const [goal] = goals;
+    const names = positional(args, ['--timeout']);
+    if (!goal || goals.length > 1 || !names.length)
+        fail(USAGE);
+    for (const name of names)
+        if (!NAME.test(name))
+            fail(`${name} is not an app or process name`);
+    const seconds = Number(flagValue(args, '--timeout') ?? 120);
+    if (!Number.isFinite(seconds) || seconds <= 0)
+        fail(`--timeout takes seconds, more than 0 (${USAGE})`);
+    const until = Date.now() + seconds * 1000;
+    let states = [];
+    let why = '';
+    for (;;) {
+        states = await Promise.all(names.map(async (name) => [name, await waitState(name)]));
+        if (states.every(([, state]) => met(goal, state)))
+            break;
+        const gone = goal !== 'down' && states.find(([, state]) => state === 'exited');
+        if (gone) {
+            why = `${gone[0]} exited`;
+            break;
+        }
+        if (Date.now() >= until) {
+            why = `timed out after ${String(seconds)}s`;
+            break;
+        }
+        await sleep(500);
+    }
+    if (args.includes('--json'))
+        console.log(JSON.stringify({ goal, met: !why, why: why || null, apps: Object.fromEntries(states) }));
+    else
+        for (const [name, state] of states)
+            console.log(`${name}: ${state}`);
+    if (!why)
+        return;
+    const exited = states.find(([, state]) => state === 'exited' && goal !== 'down');
+    const record = exited && readRecord(exited[0]);
+    fail(`not ${goal}: ${why}${record ? `; last lines of ${record.log}:\n${tailOf(record.log, 15)}` : ''}`);
+}
+//# sourceMappingURL=wait.js.map

package/dist/cli/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/cli/wait.ts"],"names":[],"mappings":"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"}

package/dist/core/addresses.js

@@ -0,0 +1,55 @@
+/**
+ * The host a device uses to reach this machine: the iOS simulator shares its network, the Android emulator sees it as
+ * 10.0.2.2, and a real phone reaches it over Wi-Fi at the machine's network address (null when it has none).
+ */
+export function deviceHost(device, lanIp) {
+    if (!device || (device.platform === 'ios' && !device.physical))
+        return 'localhost';
+    if (device.platform === 'android' && !device.physical)
+        return '10.0.2.2';
+    return lanIp ?? null;
+}
+/**
+ * The address a caller on `device` uses for a local callee. A phone cannot trust this machine's development
+ * certificate, so it gets the callee's plain http address, and the callee has to listen on the network.
+ */
+export function localAddress(callee, device, options = {}) {
+    const phone = !!device?.physical;
+    const base = phone && options.httpUrl ? options.httpUrl : callee.url;
+    if (!base)
+        return { error: 'the callee has no url in stack.json' };
+    const host = deviceHost(device, options.lanIp);
+    if (!host)
+        return { error: "no network address for this Mac; connect to Wi-Fi, or pass the phone's reachable host" };
+    const address = new URL(base);
+    address.hostname = host;
+    const slash = (options.like ?? callee.url ?? '').endsWith('/');
+    const url = slash ? address.toString() : address.toString().replace(/\/$/, '');
+    const untrusted = phone && !options.httpUrl && address.protocol === 'https:';
+    const note = untrusted
+        ? 'the callee has no http address; a phone will reject its development certificate'
+        : undefined;
+    return { url, needsLan: phone, note };
+}
+/**
+ * What a browser front end needs from an API it calls locally: its own origin allowed (CORS), and no https page
+ * calling http. `slot` numbers each browser caller of the same API, for settings written as `Origins__{n}`.
+ */
+export function browserChecks(callee, callerUrl, slot = 0) {
+    const origin = callerUrl && URL.canParse(callerUrl) ? new URL(callerUrl).origin : null;
+    const out = { settings: [], warnings: [] };
+    const allow = callee.cors?.env;
+    if (allow && origin)
+        for (const env of [allow].flat())
+            out.settings.push({ app: 'callee', env: env.replace('{n}', String(slot)), value: origin });
+    else if (origin)
+        out.warnings.push(`${callee.name ?? 'the API'} has no recorded CORS setting; the browser may block calls from ${origin}. Record it with: koppler stack set apps.<app>.cors.env <setting>`);
+    if (callerUrl?.startsWith('https:') && callee.url?.startsWith('http:'))
+        out.warnings.push("an https page cannot call an http API; use the API's https address or serve the page over http");
+    return out;
+}
+/** The lines to put in a git-ignored local env file, which the framework reads on top of its .env. */
+export function envFileChange(call, value) {
+    return { file: call.file ?? '.env.local', lines: [call.env ?? []].flat().map(name => `${name}=${value}`) };
+}
+//# sourceMappingURL=addresses.js.map

package/dist/core/addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.js","sourceRoot":"","sources":["../../src/core/addresses.ts"],"names":[],"mappings":"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"}