@fairgarden/monolith 0.1.0-0.canary.0

package/dist/package-json.js

@@ -0,0 +1,156 @@
+import { readFile, readdir, writeFile } from 'node:fs/promises';
+import { isBuiltin } from 'node:module';
+import path from 'node:path';
+import mergePackageJson from 'merge-package.json';
+const DEPENDENCY_KEYS = [
+    'dependencies',
+    'devDependencies',
+    'optionalDependencies',
+    'peerDependencies',
+];
+const SOURCE_EXTENSIONS = new Set([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+]);
+/** `import x from 'y'`, `import 'y'`, `import('y')` and `require('y')`. */
+const SPECIFIER = /(?:from|import|require)\s*\(?\s*['"]([^'"]+)['"]/g;
+const read = async (file) => JSON.parse(await readFile(file, 'utf8'));
+/** `@scope/name/sub` -> `@scope/name`, `name/sub` -> `name`. */
+const packageOf = (specifier) => {
+    const segments = specifier.split('/');
+    return specifier.startsWith('@') ? segments.slice(0, 2).join('/') : segments[0];
+};
+const sourceFiles = async (dir) => {
+    const found = [];
+    const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+        if (entry.name === 'node_modules')
+            continue;
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            found.push(...(await sourceFiles(full)));
+        }
+        else if (SOURCE_EXTENSIONS.has(path.extname(entry.name))) {
+            found.push(full);
+        }
+    }
+    return found;
+};
+/**
+ * Packages the app's route files import directly.
+ *
+ * Both route trees need these from the monolith, for different reasons. Pages
+ * Router files are copied, so their real path is inside the monolith and the
+ * app's `node_modules` is no longer above them. App Router files are only
+ * symlinked, and Turbopack does resolve those against the app — but TypeScript
+ * resolves from where the file sits in the monolith, so it needs them too.
+ *
+ * Only *direct* imports matter. Anything an app reaches through its own package
+ * name resolves via the monolith's link to the app and carries on from there.
+ */
+export const routeImports = async (app) => {
+    const imported = new Set();
+    const roots = [app.appDir, app.pagesDir].filter((root) => root !== undefined);
+    for (const file of (await Promise.all(roots.map(sourceFiles))).flat()) {
+        const contents = await readFile(file, 'utf8').catch(() => '');
+        for (const [, specifier] of contents.matchAll(SPECIFIER)) {
+            if (specifier.startsWith('.') || isBuiltin(specifier))
+                continue;
+            const name = packageOf(specifier);
+            // Resolves through the monolith's link to the app, not its own deps.
+            if (name === app.packageName)
+                continue;
+            imported.add(name);
+        }
+    }
+    return imported;
+};
+/** `@scope/name` -> `@types/scope__name`, matching DefinitelyTyped's layout. */
+const typesPackageOf = (name) => name.startsWith('@')
+    ? `@types/${name.slice(1).replace('/', '__')}`
+    : `@types/${name}`;
+/**
+ * Workspace siblings are linked, not installed, so carrying their version
+ * ranges into the monolith would pin it against its own workspace.
+ */
+const isInstallable = (range) => typeof range === 'string' &&
+    !range.startsWith('workspace:') &&
+    !range.startsWith('link:');
+const pick = (pkg, wanted) => {
+    const picked = {};
+    for (const key of DEPENDENCY_KEYS) {
+        const deps = pkg[key];
+        if (!deps)
+            continue;
+        const taken = Object.entries(deps).filter(([name, range]) => wanted.has(name) && isInstallable(range));
+        if (taken.length > 0)
+            picked[key] = Object.fromEntries(taken);
+    }
+    return picked;
+};
+const everything = (pkg) => {
+    const picked = {};
+    for (const key of DEPENDENCY_KEYS) {
+        const deps = pkg[key];
+        if (!deps)
+            continue;
+        const taken = Object.entries(deps).filter(([, range]) => isInstallable(range));
+        if (taken.length > 0)
+            picked[key] = Object.fromEntries(taken);
+    }
+    return picked;
+};
+/**
+ * Fold what each app needs from the monolith into its package.json.
+ *
+ * Uses a three-way merge against an empty base so conflicting ranges are
+ * resolved by semver rather than by whichever app happens to be last.
+ */
+export const mergeAppDependencies = async (monolithPackageJsonPath, apps, options = {}) => {
+    const original = await read(monolithPackageJsonPath);
+    let merged = JSON.stringify(original);
+    const taken = new Map();
+    for (const app of apps) {
+        const appPkg = await read(path.join(app.root, 'package.json'));
+        let incoming;
+        if (options.all) {
+            incoming = everything(appPkg);
+        }
+        else {
+            const wanted = await routeImports(app);
+            // Type declarations are resolved from the monolith too.
+            for (const name of [...wanted])
+                wanted.add(typesPackageOf(name));
+            incoming = pick(appPkg, wanted);
+        }
+        const names = DEPENDENCY_KEYS.flatMap((key) => Object.keys(incoming[key] ?? {}));
+        if (names.length === 0)
+            continue;
+        taken.set(app.name, names);
+        merged = mergePackageJson(merged, JSON.stringify({}), JSON.stringify(incoming));
+    }
+    const packageJson = JSON.parse(merged);
+    return {
+        packageJson,
+        // Compared by content, not by key order: the merge re-sorts, and a
+        // monolith whose dependencies sit in any other order would otherwise fail
+        // `--check` on every run with nothing to actually change.
+        changed: !sameDependencies(original, packageJson),
+        taken,
+    };
+};
+/** Whether two manifests declare the same dependencies, order aside. */
+const sameDependencies = (a, b) => DEPENDENCY_KEYS.every((key) => {
+    const left = (a[key] ?? {});
+    const right = (b[key] ?? {});
+    const names = new Set([...Object.keys(left), ...Object.keys(right)]);
+    return [...names].every((name) => left[name] === right[name]);
+});
+export const writePackageJson = async (file, packageJson) => {
+    await writeFile(file, `${JSON.stringify(packageJson, null, 2)}\n`);
+};
+//# sourceMappingURL=package-json.js.map

package/dist/package-json.js.map

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

package/dist/portability.d.ts

@@ -0,0 +1,41 @@
+import type { NextConfig } from 'next';
+export interface PortabilityOptions {
+    /**
+     * The app to check. Defaults to the directory of the config that called
+     * this, not the working directory — a monolith loading an app's config
+     * would otherwise have the app checked against the monolith's own files.
+     */
+    root?: string;
+    /** `warn` reports and continues, `error` refuses to build. Defaults to `warn`. */
+    level?: 'warn' | 'error';
+    /** Findings to accept, by the text before the colon. */
+    ignore?: string[];
+}
+/**
+ * Everything about this app that would not survive being mounted in a monolith.
+ *
+ * Exported separately so a test or a CI check can assert on the list rather
+ * than scrape log output.
+ */
+export declare const findPortabilityProblems: (nextConfig: NextConfig, root: string) => string[];
+/**
+ * Write a report once per build, however many processes load the config:
+ * each build worker inherits the environment this marks.
+ */
+export declare const reportOnce: (key: string, report: string) => void;
+/**
+ * Check that an app can be mounted into a monolith, from the app's own config.
+ *
+ * Wrap the app's config with this and it reports, on every build, whatever
+ * would not survive being served under a prefix alongside other apps. It
+ * changes nothing about how the app runs on its own.
+ *
+ * ```ts
+ * // apps/id/next.config.ts
+ * export default withMonolithicPortability({ redirects: async () => [...] })
+ * ```
+ *
+ * Set `level: 'error'` in CI to make it a gate rather than a reminder.
+ */
+export declare const withMonolithicPortability: (nextConfig?: NextConfig, options?: PortabilityOptions) => NextConfig;
+//# sourceMappingURL=portability.d.ts.map

package/dist/portability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portability.d.ts","sourceRoot":"","sources":["../src/portability.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAyEtC,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACxB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,YAAY,UAAU,EACtB,MAAM,MAAM,KACX,MAAM,EAqCR,CAAA;AA0CD;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,EAAE,QAAQ,MAAM,KAAG,IAIxD,CAAA;AASD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,yBAAyB,GACpC,aAAY,UAAe,EAC3B,UAAS,kBAAuB,KAC/B,UAcF,CAAA"}

package/dist/portability.js

@@ -0,0 +1,171 @@
+import { statSync } from 'node:fs';
+import path from 'node:path';
+import { isLocaleProxy } from "./proxies.js";
+/**
+ * Options the monolith owns for the whole deployment. An app that sets one is
+ * either fighting the monolith or silently changing every other app.
+ */
+const OWNED_OPTIONS = ['basePath', 'distDir'];
+/** Options that have to agree across every app, because one server serves all. */
+const SHARED_OPTIONS = [
+    'i18n',
+    'trailingSlash',
+    'skipTrailingSlashRedirect',
+    'skipMiddlewareUrlNormalize',
+    'output',
+    'assetPrefix',
+];
+/**
+ * Conventions Next allows exactly one of per deployment. An app can use them on
+ * its own, but mounting several apps means only one could ever win — so rather
+ * than let one app's copy silently disappear, say so.
+ */
+const SINGLETON_FILES = [
+    {
+        names: ['proxy', 'middleware', 'src/proxy', 'src/middleware'],
+        why: 'a deployment has one proxy; the monolith would have to run it and strip the mount prefix itself',
+        // The locale proxy from @fairgarden/indicators takes each app by its
+        // mount, so the monolith's own proxy runs it for this app too.
+        portable: isLocaleProxy,
+    },
+    {
+        names: ['instrumentation', 'src/instrumentation'],
+        why: 'a deployment has one instrumentation hook',
+    },
+    {
+        names: ['pages/_app', 'src/pages/_app'],
+        why: 'a deployment has one Pages Router app shell',
+    },
+    {
+        names: ['pages/_document', 'src/pages/_document'],
+        why: 'a deployment has one Pages Router document',
+    },
+];
+/**
+ * Files that generate a route which only means anything at the site root.
+ * Mounted, they end up at `/<name>/robots.txt`, where nothing looks for them.
+ */
+const ROOT_ONLY_ROUTES = ['robots', 'sitemap', 'manifest'];
+const EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs'];
+const exists = (candidate) => {
+    try {
+        statSync(candidate);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const findFile = (root, name) => EXTENSIONS.map((extension) => `${name}${extension}`).find((file) => exists(path.join(root, file)));
+/**
+ * Everything about this app that would not survive being mounted in a monolith.
+ *
+ * Exported separately so a test or a CI check can assert on the list rather
+ * than scrape log output.
+ */
+export const findPortabilityProblems = (nextConfig, root) => {
+    const problems = [];
+    for (const option of OWNED_OPTIONS) {
+        if (nextConfig[option] !== undefined) {
+            problems.push(`${option}: only the monolith may set this; mounted apps are served from their mount point instead`);
+        }
+    }
+    for (const option of SHARED_OPTIONS) {
+        if (nextConfig[option] !== undefined) {
+            problems.push(`${option}: has to match every other app in the monolith, so it belongs on the monolith`);
+        }
+    }
+    for (const { names, why, portable } of SINGLETON_FILES) {
+        const found = names.map((name) => findFile(root, name)).find(Boolean);
+        if (found && portable?.(path.join(root, found)))
+            continue;
+        if (found)
+            problems.push(`${found}: ${why}`);
+    }
+    for (const name of ROOT_ONLY_ROUTES) {
+        const found = findFile(root, path.join('app', name)) ??
+            findFile(root, path.join('src', 'app', name));
+        if (found) {
+            problems.push(`${found}: serves a route that only works at the site root, and would be mounted under the app's prefix`);
+        }
+    }
+    return problems;
+};
+/**
+ * Next reads the config in the main process and again in a build worker.
+ * Marking the environment keeps the report to one, since the worker inherits it.
+ */
+/**
+ * The directory of the config that called this.
+ *
+ * A monolith loads each app's own config, so the working directory is the
+ * monolith's and would attribute its files to whichever app is being loaded.
+ */
+const callerDirectory = () => {
+    const original = Error.prepareStackTrace;
+    try {
+        Error.prepareStackTrace = (_, stack) => stack;
+        const stack = new Error().stack;
+        for (const frame of stack ?? []) {
+            const file = frame.getFileName?.();
+            if (!file || file.includes('node_modules') || !file.includes('next.config')) {
+                continue;
+            }
+            return path.dirname(file.replace(/^file:\/\//, ''));
+        }
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        Error.prepareStackTrace = original;
+    }
+    return undefined;
+};
+const REPORTED_ENV = '__FG_MONOLITH_PORTABILITY_REPORTED';
+const alreadyReported = (root) => (process.env[REPORTED_ENV] ?? '').split(path.delimiter).includes(root);
+const markReported = (root) => {
+    const seen = (process.env[REPORTED_ENV] ?? '').split(path.delimiter).filter(Boolean);
+    process.env[REPORTED_ENV] = [...seen, root].join(path.delimiter);
+};
+/**
+ * Write a report once per build, however many processes load the config:
+ * each build worker inherits the environment this marks.
+ */
+export const reportOnce = (key, report) => {
+    if (alreadyReported(key))
+        return;
+    markReported(key);
+    process.stderr.write(`${report}\n`);
+};
+const describe = (problems) => [
+    `This app would not port cleanly into a monolith:`,
+    ...problems.map((problem) => `  - ${problem}`),
+    `See @fairgarden/monolith for what a mounted app can rely on.`,
+].join('\n');
+/**
+ * Check that an app can be mounted into a monolith, from the app's own config.
+ *
+ * Wrap the app's config with this and it reports, on every build, whatever
+ * would not survive being served under a prefix alongside other apps. It
+ * changes nothing about how the app runs on its own.
+ *
+ * ```ts
+ * // apps/id/next.config.ts
+ * export default withMonolithicPortability({ redirects: async () => [...] })
+ * ```
+ *
+ * Set `level: 'error'` in CI to make it a gate rather than a reminder.
+ */
+export const withMonolithicPortability = (nextConfig = {}, options = {}) => {
+    const root = options.root ?? callerDirectory() ?? process.cwd();
+    const ignore = new Set(options.ignore ?? []);
+    const problems = findPortabilityProblems(nextConfig, root).filter((problem) => !ignore.has(problem.slice(0, problem.indexOf(':'))));
+    if (problems.length > 0) {
+        if (options.level === 'error')
+            throw new Error(describe(problems));
+        reportOnce(root, describe(problems));
+    }
+    return nextConfig;
+};
+//# sourceMappingURL=portability.js.map

package/dist/portability.js.map

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

package/dist/portable-link.d.ts

@@ -0,0 +1,22 @@
+import NextLink from 'next/link';
+import type { ComponentProps } from 'react';
+export { createHref, mountPrefix, prefixHref, MOUNTS_ENV } from './mounts.ts';
+type NextLinkProps = ComponentProps<typeof NextLink>;
+/**
+ * A `next/link` that knows where its app is mounted.
+ *
+ * The monolith does not use `basePath`, so nothing prefixes an app's own hrefs
+ * for it. Build one of these per app and use it in place of `next/link`:
+ *
+ * ```tsx
+ * // lib/link.ts
+ * export const Link = createLink('@fairgarden/id')
+ * ```
+ *
+ * Standalone the prefix is empty and this is `next/link` with an extra call.
+ */
+export declare const createLink: (packageName: string) => {
+    ({ href, ...props }: NextLinkProps): import("react").JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=portable-link.d.ts.map

package/dist/portable-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-link.d.ts","sourceRoot":"","sources":["../src/portable-link.tsx"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,WAAW,CAAA;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAG3C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7E,KAAK,aAAa,GAAG,cAAc,CAAC,OAAO,QAAQ,CAAC,CAAA;AAEpD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,GAAI,aAAa,MAAM;yBAGF,aAAa;;CAKxD,CAAA"}

package/dist/portable-link.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import NextLink from 'next/link';
+import { mountPrefix, prefixHref } from "./mounts.js";
+export { createHref, mountPrefix, prefixHref, MOUNTS_ENV } from "./mounts.js";
+/**
+ * A `next/link` that knows where its app is mounted.
+ *
+ * The monolith does not use `basePath`, so nothing prefixes an app's own hrefs
+ * for it. Build one of these per app and use it in place of `next/link`:
+ *
+ * ```tsx
+ * // lib/link.ts
+ * export const Link = createLink('@fairgarden/id')
+ * ```
+ *
+ * Standalone the prefix is empty and this is `next/link` with an extra call.
+ */
+export const createLink = (packageName) => {
+    const prefix = mountPrefix(packageName);
+    const MonolithLink = ({ href, ...props }) => (_jsx(NextLink, { href: prefixHref(href, prefix), ...props }));
+    MonolithLink.displayName = `MonolithLink(${packageName})`;
+    return MonolithLink;
+};
+//# sourceMappingURL=portable-link.js.map

package/dist/portable-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-link.js","sourceRoot":"","sources":["../src/portable-link.tsx"],"names":[],"mappings":";AAAA,OAAO,QAAQ,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAErD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAI7E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,WAAmB,EAAE,EAAE;IAChD,MAAM,MAAM,GAAG,WAAW,CAAC,WAAW,CAAC,CAAA;IAEvC,MAAM,YAAY,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,KAAK,EAAiB,EAAE,EAAE,CAAC,CAC1D,KAAC,QAAQ,IAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,KAAM,KAAK,GAAI,CACxD,CAAA;IACD,YAAY,CAAC,WAAW,GAAG,gBAAgB,WAAW,GAAG,CAAA;IACzD,OAAO,YAAY,CAAA;AACrB,CAAC,CAAA"}

package/dist/proxies.d.ts

@@ -0,0 +1,33 @@
+import type { ResolvedApp } from './types.ts';
+/** A project's proxy, at its root or under `src/`, as Next looks for one. */
+export declare const findProxy: (root: string) => string | undefined;
+/**
+ * Whether a proxy file is only the locale proxy: `proxy` (or `middleware`, or
+ * the default export) is a call to `createLocaleProxy`, and the only other
+ * export is `config`.
+ *
+ * Anything it cannot read that plainly — a wrapper around the call, a
+ * re-export, another export — counts as a proxy of the app's own, which is
+ * the safe answer: that one does need moving to the monolith.
+ */
+export declare const isLocaleProxy: (file: string) => boolean;
+/**
+ * The paths a proxy file's `config.matcher` names, read from the source as
+ * Next reads it. Undefined when there is no literal matcher to read, in which
+ * case the proxy runs for every path.
+ */
+export declare const proxyMatcher: (file: string) => string[] | undefined;
+export interface UnservedProxy {
+    app: ResolvedApp;
+    message: string;
+}
+/**
+ * Mounted apps with a locale proxy that the monolith's own proxy does not run
+ * at their mount, so nobody arriving at that app's root is offered their
+ * language.
+ *
+ * Only an app root counts: that is the one path the locale proxy acts on. A
+ * monolith proxy with no literal matcher runs everywhere and is taken on trust.
+ */
+export declare const unservedLocaleProxies: (monolithRoot: string, apps: ResolvedApp[]) => UnservedProxy[];
+//# sourceMappingURL=proxies.d.ts.map

package/dist/proxies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxies.d.ts","sourceRoot":"","sources":["../src/proxies.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAoC7C,6EAA6E;AAC7E,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SAUjD,CAAA;AAcD;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,OA6C5C,CAAA;AASD;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAAM,EAAE,GAAG,SA0BtD,CAAA;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,WAAW,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,cAAc,MAAM,EACpB,MAAM,WAAW,EAAE,KAClB,aAAa,EAyBf,CAAA"}

package/dist/proxies.js

@@ -0,0 +1,177 @@
+import { readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { parse } from '@babel/parser';
+const LOCALE_PROXY_MODULE = '@fairgarden/indicators/proxy';
+const LOCALE_PROXY = 'createLocaleProxy';
+/** What Next reads as a proxy, `middleware` being its older name. */
+const PROXY_NAMES = ['proxy', 'middleware'];
+const EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs'];
+const isFile = (candidate) => {
+    try {
+        return statSync(candidate).isFile();
+    }
+    catch {
+        return false;
+    }
+};
+/** A project's proxy, at its root or under `src/`, as Next looks for one. */
+export const findProxy = (root) => {
+    for (const dir of ['', 'src']) {
+        for (const name of PROXY_NAMES) {
+            for (const extension of EXTENSIONS) {
+                const candidate = path.join(root, dir, `${name}${extension}`);
+                if (isFile(candidate))
+                    return candidate;
+            }
+        }
+    }
+    return undefined;
+};
+const statementsOf = (file) => {
+    try {
+        const ast = parse(readFileSync(file, 'utf8'), {
+            sourceType: 'module',
+            plugins: ['typescript', 'jsx'],
+        });
+        return ast.program.body;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Whether a proxy file is only the locale proxy: `proxy` (or `middleware`, or
+ * the default export) is a call to `createLocaleProxy`, and the only other
+ * export is `config`.
+ *
+ * Anything it cannot read that plainly — a wrapper around the call, a
+ * re-export, another export — counts as a proxy of the app's own, which is
+ * the safe answer: that one does need moving to the monolith.
+ */
+export const isLocaleProxy = (file) => {
+    const statements = statementsOf(file);
+    if (!statements)
+        return false;
+    // What the import is called here, which it may have been renamed to.
+    const names = new Set();
+    for (const statement of statements) {
+        if (statement.type !== 'ImportDeclaration')
+            continue;
+        if (statement.source.value !== LOCALE_PROXY_MODULE)
+            continue;
+        for (const specifier of statement.specifiers) {
+            if (specifier.type === 'ImportSpecifier' &&
+                specifier.imported.type === 'Identifier' &&
+                specifier.imported.name === LOCALE_PROXY) {
+                names.add(specifier.local.name);
+            }
+        }
+    }
+    if (names.size === 0)
+        return false;
+    const isCall = (node) => node?.type === 'CallExpression' &&
+        node.callee.type === 'Identifier' &&
+        names.has(node.callee.name);
+    let proxies = 0;
+    for (const statement of statements) {
+        if (statement.type === 'ExportAllDeclaration')
+            return false;
+        if (statement.type === 'ExportDefaultDeclaration') {
+            if (!isCall(statement.declaration))
+                return false;
+            proxies += 1;
+            continue;
+        }
+        if (statement.type !== 'ExportNamedDeclaration')
+            continue;
+        if (statement.specifiers.length > 0)
+            return false;
+        if (statement.declaration?.type !== 'VariableDeclaration')
+            return false;
+        for (const declarator of statement.declaration.declarations) {
+            if (declarator.id.type !== 'Identifier')
+                return false;
+            if (declarator.id.name === 'config')
+                continue;
+            if (!PROXY_NAMES.includes(declarator.id.name) || !isCall(declarator.init))
+                return false;
+            proxies += 1;
+        }
+    }
+    return proxies === 1;
+};
+const keyName = (node) => node.type === 'Identifier' && typeof node.name === 'string'
+    ? node.name
+    : node.type === 'StringLiteral' && typeof node.value === 'string'
+        ? node.value
+        : undefined;
+/**
+ * The paths a proxy file's `config.matcher` names, read from the source as
+ * Next reads it. Undefined when there is no literal matcher to read, in which
+ * case the proxy runs for every path.
+ */
+export const proxyMatcher = (file) => {
+    for (const statement of statementsOf(file) ?? []) {
+        if (statement.type !== 'ExportNamedDeclaration')
+            continue;
+        if (statement.declaration?.type !== 'VariableDeclaration')
+            continue;
+        for (const declarator of statement.declaration.declarations) {
+            if (declarator.id.type !== 'Identifier' || declarator.id.name !== 'config')
+                continue;
+            if (declarator.init?.type !== 'ObjectExpression')
+                return undefined;
+            for (const property of declarator.init.properties) {
+                if (property.type !== 'ObjectProperty' || keyName(property.key) !== 'matcher')
+                    continue;
+                const entries = property.value.type === 'ArrayExpression' ? property.value.elements : [property.value];
+                return entries.flatMap((entry) => {
+                    if (entry?.type === 'StringLiteral')
+                        return [entry.value];
+                    if (entry?.type !== 'ObjectExpression')
+                        return [];
+                    const source = entry.properties.find((field) => field.type === 'ObjectProperty' && keyName(field.key) === 'source');
+                    return source?.type === 'ObjectProperty' && source.value.type === 'StringLiteral'
+                        ? [source.value.value]
+                        : [];
+                });
+            }
+            return undefined;
+        }
+    }
+    return undefined;
+};
+/**
+ * Mounted apps with a locale proxy that the monolith's own proxy does not run
+ * at their mount, so nobody arriving at that app's root is offered their
+ * language.
+ *
+ * Only an app root counts: that is the one path the locale proxy acts on. A
+ * monolith proxy with no literal matcher runs everywhere and is taken on trust.
+ */
+export const unservedLocaleProxies = (monolithRoot, apps) => {
+    const withLocaleProxy = apps.flatMap((app) => {
+        const file = findProxy(app.root);
+        return file && isLocaleProxy(file) ? [{ app, file }] : [];
+    });
+    if (withLocaleProxy.length === 0)
+        return [];
+    const own = findProxy(monolithRoot);
+    const matcher = own ? proxyMatcher(own) : [];
+    if (matcher === undefined)
+        return [];
+    const where = own ? path.relative(monolithRoot, own) : 'proxy.ts';
+    return withLocaleProxy
+        .filter(({ app }) => !matcher.includes(app.prefix || '/'))
+        .map(({ app, file }) => {
+        const mount = app.prefix || '/';
+        return {
+            app,
+            message: `"${app.name}" negotiates its locale in ${path.basename(file)}, which a ` +
+                `monolith does not mount; its own ${where} has to do it at ${mount}. ` +
+                `Add the app to createLocaleProxy({ '${mount}': ... }) there, and '${mount}' ` +
+                'to its config.matcher.',
+        };
+    });
+};
+//# sourceMappingURL=proxies.js.map