@fairgarden/monolith 0.1.0-0.canary.0

package/Readme.md

@@ -0,0 +1,84 @@
+# FairGarden Monolith
+
+<!-- fg:version -->
+
+Version **0.1.0-alpha.1**
+
+<!-- /fg:version -->
+
+<!-- fg:releasing -->
+
+## Releasing
+
+This module releases on its own. `0.1.0-alpha.1` is what main is working towards,
+not what is published — the version here is always the next one.
+
+1. **Publish it.** Run the *Publish* workflow from the Actions tab, picking the
+   dist tag. It refuses if that version is already on npm.
+2. **Move it on.** `pnpm release` — opens a pull request bumping this branch
+   to `0.1.0-alpha.2`, or `pnpm release --id rc` to change
+   identifier. A prerelease gets no maintenance branch; there is no released
+   line behind it yet.
+
+Every push to main publishes `@fairgarden/monolith@canary`. A canary is not a release and
+carries no promise; it is there so main can be tried without a checkout.
+
+<!-- /fg:releasing -->
+
+Compose several Next.js apps into one deployable app.
+
+```ts
+// apps/monolith/next.config.ts
+import { withMonolith } from '@fairgarden/monolith'
+
+export default withMonolith(
+  {},
+  {
+    www: { package: '@fairgarden/www', prefix: '/' },
+    id: '@fairgarden/id',
+  }
+)
+```
+
+`id`'s routes are served from `/id`, its assets from `public/id`, and its Pages
+Router API from `/api/id`. `www` takes the site root.
+
+## Documentation
+
+The docs are a site in this repository. Run them with:
+
+```bash
+pnpm --filter @fairgarden/monolith-docs dev
+```
+
+- **Overview** — what mounting an app actually does
+- **Mounting** — symlinks, and why `next dev` needs different treatment
+- **Routing** — how rewrites, redirects and headers are merged
+- **What a monolith can serve** — root mounts, and when apps collide
+- **Next versions** — which versions can be mounted together
+- **Dependencies** — what the monolith has to install
+- **Portability** — keeping an app mountable
+- **Functions** — `withMonolith`, `createLink`, `prefixPath` and the rest
+
+## Install
+
+```bash
+pnpm add @fairgarden/monolith
+```
+
+| Import | For |
+| --- | --- |
+| `@fairgarden/monolith` | the monolith's `next.config.ts`, and an app's portability check |
+| `@fairgarden/monolith/link` | an app's own components |
+| `@fairgarden/monolith/eslint` | an app's `eslint.config.mjs` |
+
+It also installs `fg-monolith`, for the things that happen around a build:
+
+```bash
+fg-monolith link                 # mount without starting Next
+fg-monolith merge-package-json   # fold each app's dependencies in
+fg-monolith list                 # print the apps it composes
+```
+
+Submodules, versions and scaffolding are a separate concern, handled by
+`fg-dist` in `@fairgarden/distribution`.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { statSync } from 'node:fs';
+import { linkApps } from "./link.js";
+import { mergeAppDependencies, writePackageJson } from "./package-json.js";
+import { getRegisteredApps } from "./index.js";
+// Piping into `head` closes stdout early; that is ordinary use, not a failure.
+for (const stream of [process.stdout, process.stderr]) {
+    stream.on('error', (error) => {
+        if (error.code === 'EPIPE')
+            process.exit(0);
+        throw error;
+    });
+}
+const USAGE = `Usage: fg-monolith <command> [options]
+
+Commands:
+  link                 Mount every app's routes and assets into the monolith
+  merge-package-json   Fold every app's dependencies into the monolith's package.json
+  list                 Print the apps the monolith composes
+
+Options:
+  --cwd <dir>          Monolith directory (default: the working directory)
+  --strategy <name>    source | mirror | hardlink | copy (default: source)
+  --check              Report what would change without writing (merge-package-json)
+  --all                Take every app dependency, not only what its pages need
+
+Submodules, versions and scaffolding are handled by \`fg-dist\`, in
+@fairgarden/distribution.
+`;
+const CONFIG_FILES = [
+    'next.config.ts',
+    'next.config.mts',
+    'next.config.js',
+    'next.config.mjs',
+    'next.config.cjs',
+];
+const parseArgs = (argv) => {
+    const args = {
+        command: undefined,
+        cwd: process.cwd(),
+        strategy: 'source',
+        check: false,
+        all: false,
+    };
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === '--cwd') {
+            args.cwd = path.resolve(argv[++index] ?? '.');
+        }
+        else if (arg === '--strategy') {
+            args.strategy = (argv[++index] ?? 'source');
+        }
+        else if (arg === '--check') {
+            args.check = true;
+        }
+        else if (arg === '--all') {
+            args.all = true;
+        }
+        else if (!arg.startsWith('-') && !args.command) {
+            args.command = arg;
+        }
+        else {
+            throw new Error(`Unrecognized argument: ${arg}`);
+        }
+    }
+    return args;
+};
+/**
+ * The monolith's own Next config is the single source of truth for which apps
+ * it composes, so load it — with linking disabled — and read back what it
+ * registered.
+ */
+const loadApps = async (cwd) => {
+    const configPath = CONFIG_FILES.map((file) => path.join(cwd, file)).find((file) => {
+        try {
+            return statSync(file).isFile();
+        }
+        catch {
+            return false;
+        }
+    });
+    if (!configPath) {
+        throw new Error(`No Next config found in ${cwd}.`);
+    }
+    process.env.FG_MONOLITH_SKIP_LINK = '1';
+    const loaded = (await import(__rewriteRelativeImportExtension(pathToFileURL(configPath).href))).default;
+    if (typeof loaded === 'function')
+        await loaded('phase-production-build');
+    const apps = getRegisteredApps();
+    if (apps.length === 0) {
+        throw new Error(`${configPath} did not register any apps. Is it using withMonolith()?`);
+    }
+    return apps;
+};
+const main = async () => {
+    const args = parseArgs(process.argv.slice(2));
+    if (!args.command || args.command === 'help') {
+        process.stdout.write(USAGE);
+        return args.command ? 0 : 1;
+    }
+    if (args.command === 'list') {
+        for (const app of await loadApps(args.cwd)) {
+            process.stdout.write(`${app.prefix}\t${app.source}\t${app.root}\n`);
+        }
+        return 0;
+    }
+    if (args.command === 'link') {
+        const apps = await loadApps(args.cwd);
+        const mounted = await linkApps(args.cwd, apps, {
+            strategy: args.strategy,
+            sourceDir: path.resolve(args.cwd, 'src', 'app'),
+            sourcePagesDir: path.resolve(args.cwd, 'src', 'pages'),
+            watch: false,
+        });
+        for (const target of mounted) {
+            process.stdout.write(`${path.relative(args.cwd, target)}\n`);
+        }
+        return 0;
+    }
+    if (args.command === 'merge-package-json') {
+        const apps = await loadApps(args.cwd);
+        const file = path.join(args.cwd, 'package.json');
+        const { packageJson, changed, taken } = await mergeAppDependencies(file, apps, {
+            all: args.all,
+        });
+        if (!changed) {
+            process.stdout.write('package.json is already up to date.\n');
+            return 0;
+        }
+        if (args.check) {
+            process.stderr.write('package.json is out of date; run without --check.\n');
+            return 1;
+        }
+        await writePackageJson(file, packageJson);
+        for (const [name, packages] of taken) {
+            process.stdout.write(`${name}: ${packages.join(', ')}\n`);
+        }
+        process.stdout.write(`Updated ${path.relative(process.cwd(), file)}.\n`);
+        return 0;
+    }
+    process.stderr.write(`Unknown command: ${args.command}\n\n${USAGE}`);
+    return 1;
+};
+main().then((code) => {
+    process.exitCode = code;
+}, (error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/compat.d.ts

@@ -0,0 +1,4 @@
+import type { NextConfig } from 'next';
+import type { ResolvedApp } from './types.ts';
+export declare const assertCompatible: (base: NextConfig, apps: ResolvedApp[], monolithRoot?: string) => void;
+//# sourceMappingURL=compat.d.ts.map

package/dist/compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../src/compat.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAiK7C,eAAO,MAAM,gBAAgB,GAC3B,MAAM,UAAU,EAChB,MAAM,WAAW,EAAE,EACnB,eAAe,MAAM,KACpB,IA6CF,CAAA"}

package/dist/compat.js

@@ -0,0 +1,174 @@
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import semver from 'semver';
+import { inspectExtends, describeViolations } from '@fairgarden/distribution';
+/**
+ * Options that change how every route is served. An app cannot have its own
+ * value for these, because the monolith serves all of them from one server.
+ */
+const SHARED_OPTIONS = [
+    'i18n',
+    'trailingSlash',
+    'skipTrailingSlashRedirect',
+    'skipMiddlewareUrlNormalize',
+    'output',
+    'assetPrefix',
+];
+/**
+ * Options an app can never set, because the monolith owns them and an app's
+ * value would silently apply to the whole deployment.
+ */
+const OWNED_OPTIONS = ['basePath', 'distDir'];
+const describe = (value) => JSON.stringify(value) ?? String(value);
+/** Config this merges. Everything else an app sets is dropped. */
+const MERGED_OPTIONS = ['rewrites', 'redirects', 'headers'];
+/**
+ * Lists an app may set when the monolith already carries every entry: moving
+ * them to the monolith, as the error asks, is then visibly done, and the app
+ * still builds the same on its own.
+ */
+const CARRIED_OPTIONS = ['serverExternalPackages'];
+const missingFromBase = (option, app, base) => {
+    const carried = new Set(base[option] ?? []);
+    return (app.nextConfig[option] ?? []).filter((entry) => !carried.has(entry));
+};
+/**
+ * An app setting anything this cannot merge.
+ *
+ * Dropping it silently is the failure this is meant to avoid: the app builds
+ * alone with the option applied and inside a monolith without it, and nothing
+ * says so.
+ */
+const droppedOptions = (apps, base) => {
+    const problems = [];
+    for (const app of apps) {
+        for (const option of Object.keys(app.nextConfig)) {
+            if (MERGED_OPTIONS.includes(option))
+                continue;
+            if (SHARED_OPTIONS.includes(option))
+                continue;
+            if (OWNED_OPTIONS.includes(option))
+                continue;
+            if (CARRIED_OPTIONS.includes(option)) {
+                const missing = missingFromBase(option, app, base);
+                if (missing.length === 0)
+                    continue;
+                problems.push(`"${app.name}" sets ${option} to include ${describe(missing)}, which the ` +
+                    `monolith does not. Add them to the monolith's own ${option}.`);
+                continue;
+            }
+            problems.push(`"${app.name}" sets ${option}, which a monolith cannot merge. Move it ` +
+                'to the monolith, or pass `nextConfig: false` for this app to say it ' +
+                'is deliberate.');
+        }
+    }
+    return problems;
+};
+/**
+ * The Next a package would actually load, rather than the range it asks for.
+ *
+ * Returns undefined when it cannot be resolved, which is the case while tooling
+ * loads a config outside an install. Nothing can be compared then.
+ */
+const installedNext = (root) => {
+    try {
+        const require = createRequire(path.join(root, 'package.json'));
+        const version = require('next/package.json').version;
+        return typeof version === 'string' ? version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * The monolith compiles every app with its own Next, so an app can never need
+ * a newer one than the monolith has.
+ *
+ * Exact agreement is not required — an app pinned to 16.3.0 is fine inside a
+ * monolith on 16.3.5 — but the majors have to match, and the monolith has to be
+ * at least as new as the newest app.
+ */
+const nextVersionProblems = (monolithRoot, apps) => {
+    const monolithVersion = installedNext(monolithRoot);
+    if (!monolithVersion)
+        return [];
+    const problems = [];
+    for (const app of apps) {
+        const appVersion = installedNext(app.root);
+        if (!appVersion)
+            continue;
+        if (semver.major(appVersion) !== semver.major(monolithVersion)) {
+            problems.push(`"${app.name}" is built for Next ${appVersion} but the monolith runs ` +
+                `${monolithVersion}. A mounted app is compiled by the monolith's Next, ` +
+                'so their major versions have to match.');
+            continue;
+        }
+        if (semver.lt(monolithVersion, appVersion)) {
+            problems.push(`"${app.name}" is built for Next ${appVersion} but the monolith runs ` +
+                `${monolithVersion}. The monolith compiles every app, so it has to be ` +
+                'at least as new as the newest one.');
+        }
+    }
+    return problems;
+};
+/**
+ * Reject app configs the monolith cannot honour, rather than dropping them
+ * quietly and leaving a deployment that half-works.
+ */
+/**
+ * A distribution that extends another may not ship anything older than it.
+ *
+ * Checked here as well as by `fg-dist sync`, because shipping a regression is
+ * the kind of thing that should stop a build rather than wait to be noticed.
+ */
+const extendsProblems = (monolithRoot) => {
+    // The manifest is the repository root's, which is above the monolith app.
+    for (const root of [monolithRoot, path.join(monolithRoot, '..', '..')]) {
+        try {
+            const report = inspectExtends(path.resolve(root));
+            if (report.violations.length > 0)
+                return [describeViolations(report)];
+            if (report.parent)
+                return [];
+        }
+        catch {
+            continue;
+        }
+    }
+    return [];
+};
+export const assertCompatible = (base, apps, monolithRoot) => {
+    const problems = [
+        ...(monolithRoot
+            ? [...nextVersionProblems(monolithRoot, apps), ...extendsProblems(monolithRoot)]
+            : []),
+        ...droppedOptions(apps, base),
+    ];
+    for (const app of apps) {
+        for (const option of OWNED_OPTIONS) {
+            if (app.nextConfig[option] !== undefined) {
+                problems.push(`"${app.name}" sets ${option}, which only the monolith may set. ` +
+                    `Routes are mounted at ${app.prefix} instead.`);
+            }
+        }
+        for (const option of SHARED_OPTIONS) {
+            const appValue = app.nextConfig[option];
+            if (appValue === undefined)
+                continue;
+            const baseValue = base[option];
+            if (baseValue === undefined) {
+                problems.push(`"${app.name}" sets ${option} to ${describe(appValue)}, but the monolith ` +
+                    'does not. Set it on the monolith so every app shares it, or remove it.');
+                continue;
+            }
+            if (JSON.stringify(baseValue) !== JSON.stringify(appValue)) {
+                problems.push(`"${app.name}" sets ${option} to ${describe(appValue)}, but the monolith ` +
+                    `uses ${describe(baseValue)}. These must match.`);
+            }
+        }
+    }
+    if (problems.length > 0) {
+        throw new Error(`Incompatible Next config in the monolith:\n  - ${problems.join('\n  - ')}`);
+    }
+};
+//# sourceMappingURL=compat.js.map

package/dist/compat.js.map

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

package/dist/eslint.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Minimal shapes from ESLint's rule API.
+ *
+ * Declared here rather than depending on `@types/eslint`, which would pull a
+ * whole toolchain into a package apps install to run their own builds.
+ */
+interface SourceNode {
+    value?: unknown;
+    range?: [number, number];
+}
+interface ImportNode {
+    source?: SourceNode | null;
+    arguments?: SourceNode[];
+    callee?: {
+        type?: string;
+        name?: string;
+    };
+    type?: string;
+}
+interface RuleContext {
+    filename?: string;
+    getFilename?: () => string;
+    options: unknown[];
+    report: (descriptor: {
+        node: unknown;
+        message: string;
+        fix?: (fixer: {
+            replaceText: (node: unknown, text: string) => unknown;
+        }) => unknown;
+    }) => void;
+}
+type Visitor = Record<string, ((node: ImportNode) => void) | undefined>;
+interface Rule {
+    meta: Record<string, unknown>;
+    create: (context: RuleContext) => Visitor;
+}
+export declare const rules: {
+    'no-escaping-relative-imports': Rule;
+    'no-next-link': Rule;
+};
+/**
+ * ESLint plugin keeping an app's routes mountable.
+ *
+ * ```js
+ * // eslint.config.mjs
+ * import monolith from '@fairgarden/monolith/eslint'
+ *
+ * export default [...monolith.configs.recommended]
+ * ```
+ */
+declare const plugin: {
+    meta: {
+        name: string;
+    };
+    rules: {
+        'no-escaping-relative-imports': Rule;
+        'no-next-link': Rule;
+    };
+    configs: Record<string, unknown[]>;
+};
+export default plugin;
+//# sourceMappingURL=eslint.d.ts.map

package/dist/eslint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint.d.ts","sourceRoot":"","sources":["../src/eslint.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,UAAU,UAAU;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACzB;AACD,UAAU,UAAU;IAClB,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAC1B,SAAS,CAAC,EAAE,UAAU,EAAE,CAAA;IACxB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AACD,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,MAAM,CAAA;IAC1B,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,MAAM,EAAE,CAAC,UAAU,EAAE;QACnB,IAAI,EAAE,OAAO,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;QACf,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE;YAAE,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;SAAE,KAAK,OAAO,CAAA;KACpF,KAAK,IAAI,CAAA;CACX;AACD,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;AACvE,UAAU,IAAI;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAA;CAC1C;AAwLD,eAAO,MAAM,KAAK;;;CAGjB,CAAA;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,MAAM;;;;;;;;aAGK,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;CACzC,CAAA;AAaD,eAAe,MAAM,CAAA"}