@fairgarden/monolith 0.1.0-alpha.0

package/dist/eslint.js

@@ -0,0 +1,198 @@
+import { existsSync } from 'node:fs';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+/** Directory names Next treats as a route tree. */
+const ROUTE_DIRS = ['app', 'pages'];
+const filenameOf = (context) => context.filename ?? context.getFilename?.() ?? '';
+const packageRootCache = new Map();
+/** Nearest directory above `from` holding a package.json. */
+const packageRoot = (from) => {
+    const cached = packageRootCache.get(from);
+    if (cached !== undefined || packageRootCache.has(from))
+        return cached;
+    let current = from;
+    let found;
+    for (;;) {
+        if (existsSync(path.join(current, 'package.json'))) {
+            found = current;
+            break;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    packageRootCache.set(from, found);
+    return found;
+};
+const packageNameOf = (root) => {
+    try {
+        const pkg = JSON.parse(readFileSync(path.join(root, 'package.json'), 'utf8'));
+        return typeof pkg.name === 'string' ? pkg.name : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * The route tree this file belongs to, if any.
+ *
+ * Looks for `app/` or `pages/` directly under the package root, or under
+ * `src/`, which is where Next looks too.
+ */
+const routeRootOf = (filename, root) => {
+    const relative = path.relative(root, filename);
+    if (relative.startsWith('..'))
+        return undefined;
+    const segments = relative.split(path.sep);
+    const [first, second] = segments;
+    if (ROUTE_DIRS.includes(first))
+        return path.join(root, first);
+    if (first === 'src' && ROUTE_DIRS.includes(second)) {
+        return path.join(root, 'src', second);
+    }
+    return undefined;
+};
+const isRelative = (request) => request === '.' || request === '..' || /^\.\.?\//.test(request);
+const sourcesOf = (node) => {
+    if (node.source)
+        return [node.source];
+    // `import()` is an ImportExpression, whose argument list is `arguments`;
+    // `require()` is a CallExpression whose callee is the identifier.
+    if (node.type === 'ImportExpression' && node.arguments)
+        return node.arguments;
+    if (node.type === 'CallExpression' &&
+        node.callee?.type === 'Identifier' &&
+        node.callee.name === 'require' &&
+        node.arguments) {
+        return node.arguments;
+    }
+    return [];
+};
+const escapingImports = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Disallow relative imports that reach outside a route tree, which do not survive being mounted in a monolith',
+        },
+        fixable: 'code',
+        schema: [
+            {
+                type: 'object',
+                properties: { packageName: { type: 'string' } },
+                additionalProperties: false,
+            },
+        ],
+    },
+    create(context) {
+        const filename = filenameOf(context);
+        const root = packageRoot(path.dirname(filename));
+        if (!root)
+            return {};
+        const routeRoot = routeRootOf(filename, root);
+        if (!routeRoot)
+            return {};
+        const option = (context.options[0] ?? {});
+        const packageName = option.packageName ?? packageNameOf(root);
+        const check = (node) => {
+            for (const source of sourcesOf(node)) {
+                const request = source.value;
+                if (typeof request !== 'string' || !isRelative(request))
+                    continue;
+                const resolved = path.resolve(path.dirname(filename), request);
+                const inside = path.relative(routeRoot, resolved);
+                if (!inside.startsWith('..'))
+                    continue;
+                const fromRoot = path.relative(root, resolved).split(path.sep).join('/');
+                // An import that climbs out of the package has no package-name form;
+                // offering one would fix working code into `@scope/name/../outside`.
+                const insidePackage = !fromRoot.startsWith('..');
+                const replacement = packageName && insidePackage ? `${packageName}/${fromRoot}` : undefined;
+                context.report({
+                    node: source,
+                    message: replacement
+                        ? `Relative import reaches outside ${path.basename(routeRoot)}/ and breaks once this app is mounted. Use '${replacement}'.`
+                        : `Relative import reaches outside ${path.basename(routeRoot)}/ and breaks once this app is mounted. Import it by package name.`,
+                    ...(replacement && source.range
+                        ? {
+                            fix: (fixer) => fixer.replaceText(source, `'${replacement}'`),
+                        }
+                        : {}),
+                });
+            }
+        };
+        return {
+            ImportDeclaration: check,
+            ExportNamedDeclaration: check,
+            ExportAllDeclaration: check,
+            ImportExpression: check,
+            CallExpression: check,
+        };
+    },
+};
+const nextLink = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Disallow next/link in route trees, whose hrefs are not prefixed when the app is mounted',
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: { replacement: { type: 'string' } },
+                additionalProperties: false,
+            },
+        ],
+    },
+    create(context) {
+        const filename = filenameOf(context);
+        const root = packageRoot(path.dirname(filename));
+        if (!root || !routeRootOf(filename, root))
+            return {};
+        const option = (context.options[0] ?? {});
+        const check = (node) => {
+            for (const source of sourcesOf(node)) {
+                if (source.value !== 'next/link')
+                    continue;
+                context.report({
+                    node: source,
+                    message: option.replacement
+                        ? `next/link does not prefix hrefs with the app's mount point. Use '${option.replacement}'.`
+                        : "next/link does not prefix hrefs with the app's mount point. Use a Link built with createLink() from '@fairgarden/monolith/link'.",
+                });
+            }
+        };
+        return { ImportDeclaration: check, ImportExpression: check };
+    },
+};
+export const rules = {
+    'no-escaping-relative-imports': escapingImports,
+    'no-next-link': nextLink,
+};
+/**
+ * ESLint plugin keeping an app's routes mountable.
+ *
+ * ```js
+ * // eslint.config.mjs
+ * import monolith from '@fairgarden/monolith/eslint'
+ *
+ * export default [...monolith.configs.recommended]
+ * ```
+ */
+const plugin = {
+    meta: { name: '@fairgarden/monolith' },
+    rules,
+    configs: {},
+};
+plugin.configs.recommended = [
+    {
+        name: '@fairgarden/monolith/recommended',
+        plugins: { '@fairgarden/monolith': plugin },
+        rules: {
+            '@fairgarden/monolith/no-escaping-relative-imports': 'error',
+            '@fairgarden/monolith/no-next-link': 'warn',
+        },
+    },
+];
+export default plugin;
+//# sourceMappingURL=eslint.js.map

package/dist/eslint.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import type { NextConfig } from 'next';
+import type { MonolithApps, MonolithOptions, ResolvedApp } from './types.ts';
+export type { LinkStrategy, MonolithApp, MonolithApps, MonolithOptions, ResolvedApp, } from './types.ts';
+export { prefixPath } from './routes.ts';
+export { MOUNTS_ENV } from './mounts.ts';
+export { withMonolithicPortability, findPortabilityProblems, type PortabilityOptions, } from './portability.ts';
+export declare const getRegisteredApps: () => ResolvedApp[];
+/**
+ * Compose several Next.js apps into one deployable app.
+ *
+ * Each app's routes are mounted at `/<name>` and its assets at
+ * `public/<name>`, and its rewrites, redirects and headers are merged into the
+ * monolith's with that same prefix.
+ *
+ * ```ts
+ * export default withMonolith(
+ *   { reactStrictMode: true },
+ *   { id: '@fairgarden/id', membership: '@fairgarden/membership' }
+ * )
+ * ```
+ *
+ * Apps may live in the surrounding monorepo or be plain dependencies. Because
+ * `basePath` is not used, links inside an app are not prefixed automatically —
+ * see the package README.
+ */
+export declare const withMonolith: (nextConfig?: NextConfig, apps?: MonolithApps, options?: MonolithOptions) => ((phase: string) => Promise<NextConfig>);
+export default withMonolith;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAMtC,OAAO,KAAK,EAEV,YAAY,EACZ,eAAe,EACf,WAAW,EACZ,MAAM,YAAY,CAAA;AAEnB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAA;AAazB,eAAO,MAAM,iBAAiB,QAAO,WAAW,EAAgB,CAAA;AAehE;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,YAAY,GACvB,aAAY,UAAe,EAC3B,OAAM,YAAiB,EACvB,UAAS,eAAoB,KAC5B,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAwCzC,CAAA;AAED,eAAe,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,77 @@
+import path from 'node:path';
+import { assertCompatible } from "./compat.js";
+import { linkApps } from "./link.js";
+import { resolveApps } from "./resolve.js";
+import { mergeHeaders, mergeRedirects, mergeRewrites } from "./routes.js";
+import { MOUNTS_ENV } from "./mounts.js";
+export { prefixPath } from "./routes.js";
+export { MOUNTS_ENV } from "./mounts.js";
+export { withMonolithicPortability, findPortabilityProblems, } from "./portability.js";
+const PHASE_DEVELOPMENT_SERVER = 'phase-development-server';
+/**
+ * Set by the CLI, which loads the monolith's config only to discover which apps
+ * it composes and must not touch the file tree while doing so.
+ */
+const skipLinking = () => process.env.FG_MONOLITH_SKIP_LINK === '1';
+/** Apps seen by the most recent `withMonolith` evaluation, for the CLI. */
+let registered = [];
+export const getRegisteredApps = () => registered;
+/**
+ * `next build` follows the committed symlinks, so it reads the source tree as
+ * it stands. `next dev` does not discover routes through a symlinked
+ * directory, so it gets a derived tree with the files symlinked individually.
+ */
+const pickStrategy = (strategy, phase) => {
+    if (strategy && strategy !== 'auto')
+        return strategy;
+    return phase === PHASE_DEVELOPMENT_SERVER ? 'mirror' : 'source';
+};
+/**
+ * Compose several Next.js apps into one deployable app.
+ *
+ * Each app's routes are mounted at `/<name>` and its assets at
+ * `public/<name>`, and its rewrites, redirects and headers are merged into the
+ * monolith's with that same prefix.
+ *
+ * ```ts
+ * export default withMonolith(
+ *   { reactStrictMode: true },
+ *   { id: '@fairgarden/id', membership: '@fairgarden/membership' }
+ * )
+ * ```
+ *
+ * Apps may live in the surrounding monorepo or be plain dependencies. Because
+ * `basePath` is not used, links inside an app are not prefixed automatically —
+ * see the package README.
+ */
+export const withMonolith = (nextConfig = {}, apps = {}, options = {}) => {
+    return async (phase) => {
+        const root = options.root ?? process.cwd();
+        const resolved = await resolveApps(root, apps, phase);
+        assertCompatible(nextConfig, resolved, root);
+        registered = resolved;
+        if (!skipLinking()) {
+            const strategy = pickStrategy(options.strategy, phase);
+            const sourceDir = path.resolve(root, options.sourceDir ?? path.join('src', 'app'));
+            await linkApps(root, resolved, {
+                strategy,
+                sourceDir,
+                sourcePagesDir: path.join(path.dirname(sourceDir), 'pages'),
+                selfReference: options.selfReference,
+                // Only needed to notice routes being added or removed.
+                watch: options.watch ??
+                    (strategy !== 'source' && phase === PHASE_DEVELOPMENT_SERVER),
+            });
+        }
+        const mounts = Object.fromEntries(resolved.flatMap((app) => app.packageName ? [[app.packageName, app.prefix]] : []));
+        return {
+            ...nextConfig,
+            env: { ...nextConfig.env, [MOUNTS_ENV]: JSON.stringify(mounts) },
+            rewrites: await mergeRewrites(nextConfig, resolved),
+            redirects: await mergeRedirects(nextConfig, resolved),
+            headers: await mergeHeaders(nextConfig, resolved),
+        };
+    };
+};
+export default withMonolith;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/link.d.ts

@@ -0,0 +1,24 @@
+import type { LinkStrategy, ResolvedApp } from './types.ts';
+export interface LinkOptions {
+    strategy: LinkStrategy;
+    watch: boolean;
+    /** Committed App Router directory, absolute. */
+    sourceDir: string;
+    /** Committed Pages Router directory, absolute. */
+    sourcePagesDir: string;
+    selfReference?: boolean;
+}
+/**
+ * Make an app resolvable by its own package name from inside its own tree.
+ *
+ * Apps import their own modules by package name, because relative imports stop
+ * working once the routes are mounted elsewhere. Turbopack resolves a mounted
+ * file from its real location, so the monolith's `node_modules` is not on the
+ * lookup path and the app has to be able to find itself.
+ *
+ * Leaves a real installed package alone, and only replaces a symlink it would
+ * have created itself.
+ */
+export declare const linkSelfReference: (app: ResolvedApp) => Promise<void>;
+export declare const linkApps: (monolithRoot: string, apps: ResolvedApp[], options: LinkOptions) => Promise<string[]>;
+//# sourceMappingURL=link.d.ts.map

package/dist/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../src/link.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE3D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,YAAY,CAAA;IACtB,KAAK,EAAE,OAAO,CAAA;IACd,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAmND;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAAU,KAAK,WAAW,KAAG,OAAO,CAAC,IAAI,CActE,CAAA;AAwND,eAAO,MAAM,QAAQ,GACnB,cAAc,MAAM,EACpB,MAAM,WAAW,EAAE,EACnB,SAAS,WAAW,KACnB,OAAO,CAAC,MAAM,EAAE,CAiJlB,CAAA"}