@multiplayer-app/agent 0.1.20 → 0.1.22

package/dist/app/rules.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileRules = compileRules;
+exports.redirectFor = redirectFor;
+exports.rewriteFor = rewriteFor;
+exports.headersFor = headersFor;
+// A service's routing rules, in vercel.json's order: clean URLs, trailing slash and redirects answer
+// first, headers go on whatever answers, and rewrites come after a static site's files (or, for a
+// server, right before it gets the request). Paths here are as the request spells them: percent-
+// encoded values stay encoded in what they are filled into.
+const route_pattern_1 = require("./route-pattern");
+const PERMANENT_REDIRECT = 308;
+const TEMPORARY_REDIRECT = 307;
+function compileRules(settings) {
+    var _a, _b, _c, _d;
+    return {
+        redirects: ((_a = settings.redirects) !== null && _a !== void 0 ? _a : []).map((rule) => {
+            var _a;
+            return ({
+                pattern: (0, route_pattern_1.compileRoute)(rule.source),
+                destination: rule.destination,
+                status: (_a = rule.statusCode) !== null && _a !== void 0 ? _a : (rule.permanent === false ? TEMPORARY_REDIRECT : PERMANENT_REDIRECT),
+            });
+        }),
+        rewrites: ((_b = settings.rewrites) !== null && _b !== void 0 ? _b : []).map((rule) => ({ pattern: (0, route_pattern_1.compileRoute)(rule.source), destination: rule.destination })),
+        headers: ((_c = settings.headers) !== null && _c !== void 0 ? _c : []).map((rule) => ({ pattern: (0, route_pattern_1.compileRoute)(rule.source), headers: rule.headers })),
+        cleanUrls: (_d = settings.cleanUrls) !== null && _d !== void 0 ? _d : false,
+        trailingSlash: settings.trailingSlash,
+    };
+}
+/** `path` on this site: leading slashes collapsed, so `//evil.example` can never become another host. */
+function localPath(path) {
+    return `/${path.replace(/^[/\\]+/, '')}`;
+}
+function withSearch(location, search) {
+    if (!search)
+        return location;
+    return location.includes('?') ? `${location}&${search.slice(1)}` : `${location}${search}`;
+}
+function canonicalPath(rules, pathname) {
+    var _a;
+    if (rules.cleanUrls) {
+        const index = /^\/(?:(.+)\/)?index(?:\.html)?\/?$/.exec(pathname);
+        if (index)
+            return `/${(_a = index[1]) !== null && _a !== void 0 ? _a : ''}`;
+        const page = /^\/(.+)\.html\/?$/.exec(pathname);
+        if (page)
+            return `/${page[1]}`;
+    }
+    if (rules.trailingSlash === true) {
+        // A path naming a file keeps none: /app.js, not /app.js/.
+        const file = /^\/((?:[^/]+\/)*[^/]+\.\w+)\/$/.exec(pathname);
+        if (file)
+            return `/${file[1]}`;
+        if (/^\/(?:[^/]+\/)*[^/.]+$/.test(pathname))
+            return `${pathname}/`;
+    }
+    else if (rules.trailingSlash === false && pathname !== '/' && pathname.endsWith('/')) {
+        return pathname.replace(/\/+$/, '');
+    }
+    return undefined;
+}
+/** The redirect that answers `pathname`, if any; `search` (with its `?`) carries over to it. */
+function redirectFor(rules, pathname, search) {
+    const canonical = canonicalPath(rules, pathname);
+    if (canonical !== undefined)
+        return { status: PERMANENT_REDIRECT, location: withSearch(localPath(canonical), search) };
+    for (const rule of rules.redirects) {
+        const values = (0, route_pattern_1.matchRoute)(rule.pattern, pathname);
+        if (!values)
+            continue;
+        const filled = (0, route_pattern_1.fillDestination)(rule.destination, values);
+        return { status: rule.status, location: withSearch(/^https?:\/\//i.test(filled) ? filled : localPath(filled), search) };
+    }
+    return undefined;
+}
+/** The URL a rewrite turns `pathname` into, `search` included; undefined when none matches. */
+function rewriteFor(rules, pathname, search = '') {
+    for (const rule of rules.rewrites) {
+        const values = (0, route_pattern_1.matchRoute)(rule.pattern, pathname);
+        if (values)
+            return withSearch(localPath((0, route_pattern_1.fillDestination)(rule.destination, values)), search);
+    }
+    return undefined;
+}
+/** The headers every matching rule sets on the answer to `pathname`. */
+function headersFor(rules, pathname) {
+    return rules.headers.flatMap((rule) => ((0, route_pattern_1.matchRoute)(rule.pattern, pathname) ? rule.headers : []));
+}
+//# sourceMappingURL=rules.js.map

package/dist/app/rules.js.map

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

package/dist/app/rules.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rules.test.d.ts.map

package/dist/app/rules.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.test.d.ts","sourceRoot":"","sources":["../../src/app/rules.test.ts"],"names":[],"mappings":""}

package/dist/app/rules.test.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = require("node:test");
+const rules_1 = require("./rules");
+(0, node_test_1.describe)('routing rules', () => {
+    (0, node_test_1.it)('redirects as vercel.json does: permanent 308 by default, with parameters and the query carried over', () => {
+        const rules = (0, rules_1.compileRules)({
+            redirects: [
+                { source: '/old/:slug', destination: '/new/:slug' },
+                { source: '/temp', destination: '/there', permanent: false },
+                { source: '/moved', destination: '/here', statusCode: 301 },
+                { source: '/docs/(.*)', destination: 'https://docs.example.com/$1?from=app' },
+            ],
+        });
+        strict_1.default.deepEqual((0, rules_1.redirectFor)(rules, '/old/a', '?x=1'), { status: 308, location: '/new/a?x=1' });
+        strict_1.default.deepEqual((0, rules_1.redirectFor)(rules, '/temp', ''), { status: 307, location: '/there' });
+        strict_1.default.deepEqual((0, rules_1.redirectFor)(rules, '/moved', ''), { status: 301, location: '/here' });
+        strict_1.default.deepEqual((0, rules_1.redirectFor)(rules, '/docs/a/b', '?x=1'), { status: 308, location: 'https://docs.example.com/a/b?from=app&x=1' });
+        strict_1.default.equal((0, rules_1.redirectFor)(rules, '/other', ''), undefined);
+    });
+    (0, node_test_1.it)('makes clean URLs canonical', () => {
+        var _a, _b, _c;
+        const rules = (0, rules_1.compileRules)({ cleanUrls: true });
+        strict_1.default.equal((_a = (0, rules_1.redirectFor)(rules, '/about.html', '')) === null || _a === void 0 ? void 0 : _a.location, '/about');
+        strict_1.default.equal((_b = (0, rules_1.redirectFor)(rules, '/index.html', '?a=1')) === null || _b === void 0 ? void 0 : _b.location, '/?a=1');
+        strict_1.default.equal((_c = (0, rules_1.redirectFor)(rules, '/blog/index.html', '')) === null || _c === void 0 ? void 0 : _c.location, '/blog');
+        strict_1.default.equal((0, rules_1.redirectFor)(rules, '/about', ''), undefined);
+        strict_1.default.equal((0, rules_1.redirectFor)(rules, '/', ''), undefined);
+    });
+    (0, node_test_1.it)('adds or removes the trailing slash, leaving files alone', () => {
+        var _a, _b, _c;
+        const add = (0, rules_1.compileRules)({ trailingSlash: true });
+        strict_1.default.equal((_a = (0, rules_1.redirectFor)(add, '/about', '')) === null || _a === void 0 ? void 0 : _a.location, '/about/');
+        strict_1.default.equal((0, rules_1.redirectFor)(add, '/app.js', ''), undefined);
+        strict_1.default.equal((_b = (0, rules_1.redirectFor)(add, '/app.js/', '')) === null || _b === void 0 ? void 0 : _b.location, '/app.js');
+        strict_1.default.equal((0, rules_1.redirectFor)(add, '/about/', ''), undefined);
+        strict_1.default.equal((0, rules_1.redirectFor)(add, '/', ''), undefined);
+        const remove = (0, rules_1.compileRules)({ trailingSlash: false });
+        strict_1.default.equal((_c = (0, rules_1.redirectFor)(remove, '/about/', '')) === null || _c === void 0 ? void 0 : _c.location, '/about');
+        strict_1.default.equal((0, rules_1.redirectFor)(remove, '/about', ''), undefined);
+        strict_1.default.equal((0, rules_1.redirectFor)(remove, '/', ''), undefined);
+    });
+    (0, node_test_1.it)('never redirects to another site through the path someone asked for', () => {
+        var _a, _b, _c, _d;
+        strict_1.default.equal((_a = (0, rules_1.redirectFor)((0, rules_1.compileRules)({ trailingSlash: false }), '//evil.example/', '')) === null || _a === void 0 ? void 0 : _a.location, '/evil.example');
+        strict_1.default.equal((_b = (0, rules_1.redirectFor)((0, rules_1.compileRules)({ cleanUrls: true }), '//evil.example/x.html', '')) === null || _b === void 0 ? void 0 : _b.location, '/evil.example/x');
+        const rules = (0, rules_1.compileRules)({ redirects: [{ source: '/go/(.*)', destination: '/$1' }] });
+        strict_1.default.equal((_c = (0, rules_1.redirectFor)(rules, '/go//evil.example', '')) === null || _c === void 0 ? void 0 : _c.location, '/evil.example');
+        strict_1.default.equal((_d = (0, rules_1.redirectFor)(rules, '/go/\\evil.example', '')) === null || _d === void 0 ? void 0 : _d.location, '/evil.example');
+    });
+    (0, node_test_1.it)('rewrites and sets headers by the path asked for', () => {
+        const rules = (0, rules_1.compileRules)({
+            rewrites: [{ source: '/v1/(.*)', destination: '/api/$1?version=1' }],
+            headers: [
+                { source: '/(.*)', headers: [{ key: 'X-Frame-Options', value: 'DENY' }] },
+                { source: '/v1/(.*)', headers: [{ key: 'Cache-Control', value: 'no-store' }] },
+            ],
+        });
+        strict_1.default.equal((0, rules_1.rewriteFor)(rules, '/v1/users', '?a=1'), '/api/users?version=1&a=1');
+        strict_1.default.equal((0, rules_1.rewriteFor)(rules, '/other'), undefined);
+        strict_1.default.deepEqual((0, rules_1.headersFor)(rules, '/v1/users').map((header) => header.key), ['X-Frame-Options', 'Cache-Control']);
+        strict_1.default.deepEqual((0, rules_1.headersFor)(rules, '/').map((header) => header.key), ['X-Frame-Options']);
+    });
+});
+//# sourceMappingURL=rules.test.js.map

package/dist/app/rules.test.js.map

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

package/dist/app/runner.d.ts

@@ -0,0 +1,109 @@
+import { spawn as spawnProcess } from 'node:child_process';
+import { type AgentAppProcess, type AgentAppStatus } from '../transport/protocol';
+import { type AppConfig, type AppMode } from './config';
+import { type RoutingRules } from './rules';
+import { type StaticSite } from './static-server';
+/** Where the app's logs go, relative to its directory (kept out of snapshots and commits). */
+export declare const APP_LOG_DIR = ".builder/logs";
+export interface AppRunnerOptions {
+    /** The app's directory: the workspace, or a deployment's. */
+    dir: string;
+    mode: AppMode;
+    /** The processes' environment; the runner adds PORT. */
+    env: NodeJS.ProcessEnv;
+    /** Copy process output to the guest's own stdout too (a deployment's only log). */
+    echoOutput?: boolean;
+    /** A deployment's build: once done, a marker by this name lets a restart on the same disk skip install and build. */
+    buildId?: string;
+    /** The release was built ahead of time and brought its output and dependencies: only start it. */
+    prebuilt?: boolean;
+    onStatus?: (status: AgentAppStatus) => void;
+    spawn?: typeof spawnProcess;
+    isListening?: (port: number) => Promise<boolean>;
+    backoff?: {
+        initialMs: number;
+        maxMs: number;
+        resetAfterMs: number;
+    };
+    readyPollMs?: number;
+}
+/** Where a request path goes. */
+export type AppRoute = {
+    kind: 'port';
+    port: number;
+    rules: RoutingRules;
+} | {
+    kind: 'static';
+    site: StaticSite;
+    rules: RoutingRules;
+}
+/** The service that would answer isn't up (or the app never got that far): say so. */
+ | {
+    kind: 'unavailable';
+    process?: AgentAppProcess;
+} | {
+    kind: 'none';
+};
+export declare class AppRunner {
+    private readonly config;
+    private readonly options;
+    private readonly processes;
+    private readonly rewrites;
+    private phase;
+    /** Its processes are all known: until then, none running doesn't mean all of them are. */
+    private launched;
+    private error?;
+    private stopped;
+    private readonly spawn;
+    private readonly isListening;
+    private readonly backoff;
+    private readonly readyPollMs;
+    private readonly logs;
+    /** The install or build running now, so stop() ends it too. */
+    private step?;
+    constructor(config: AppConfig, options: AppRunnerOptions);
+    status(): AgentAppStatus;
+    private currentPhase;
+    /**
+     * A service is on its first start, so what a page calls may not be there yet. One that has
+     * crashed and is restarting doesn't count: it might never come up.
+     */
+    firstStartPending(): boolean;
+    private changed;
+    private logPath;
+    private relativeLog;
+    private openLog;
+    private launch;
+    /** The processes' env in `cwd`: its own installed tools (node_modules/.bin, a .venv) come first. */
+    private envFor;
+    /** Runs a one-off step (an install or a build) to completion: its exit code (null when it couldn't run). */
+    private runStep;
+    private resolveDir;
+    /** Ports for services that name none: DEFAULT_APP_PORT upward, past reserved and busy ones. */
+    private assignPorts;
+    private buildMarker;
+    /** Installs and builds as this mode does, starting nothing. False when a step failed (status says why) or it was stopped. */
+    prepare(): Promise<boolean>;
+    /** Installs (and builds, deployed), then starts every process. Resolves once they're launched. */
+    start(): Promise<void>;
+    private fail;
+    private install;
+    private build;
+    private startProcess;
+    private pollReady;
+    private exited;
+    private routeTo;
+    /**
+     * Where a request for `pathname` goes: a service's port, its static files, or nowhere yet, for
+     * every rewrite that matches, in order. A static service without the file passes it to the next.
+     */
+    routes(pathname: string): AppRoute[];
+    /** Resolves once every service is running or has crashed (or the app failed), or after `timeoutMs`. */
+    settled(timeoutMs: number): Promise<AgentAppStatus>;
+    private kill;
+    /** Stops every process (SIGTERM, then SIGKILL after a grace period). */
+    stop(): Promise<void>;
+}
+/** A log's last `lines` lines, for telling the model or a person why something failed. */
+export declare function logTail(dir: string, relativeLog: string, lines?: number): Promise<string>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/app/runner.d.ts.map

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