@davaux/multisite 0.8.0 → 0.8.1

package/dist/build.d.ts

@@ -0,0 +1,44 @@
+import { type DavauxPlugin } from 'davaux/config';
+import type { MultisiteConfig } from './index.js';
+export interface BuildMultisiteOptions {
+    /** Project root directory. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Output directory. Defaults to `{cwd}/dist`. */
+    outDir?: string;
+    /** Extra packages to mark as external in addition to `node:*`, `davaux`, and `@davaux/multisite`. */
+    external?: string[];
+    /**
+     * Davaux plugins to apply during the build — contributes esbuild transforms and scanner
+     * suffix extensions. Use the same plugins here as in your `davaux.config.ts`.
+     *
+     * @example
+     * import { mdx } from '@davaux/mdx'
+     * await buildMultisite(sites, { cwd: import.meta.dirname, plugins: [mdx()] })
+     */
+    plugins?: DavauxPlugin[];
+    /**
+     * tsconfig-style path aliases forwarded to esbuild `alias`. Same format as
+     * `compilerOptions.paths` — e.g. `{ '~/*': ['./src/*'] }`.
+     */
+    paths?: Record<string, string>;
+}
+/**
+ * Compile a multisite project to JavaScript.
+ *
+ * Reads route and island directories directly from the `MultisiteConfig` so the
+ * config is the single source of truth. Discovers and compiles all route, layout,
+ * middleware, and error-page files, per-site client island bundles, plus
+ * `server.ts` / `multisite.config.ts` if they exist at the project root.
+ *
+ * Requires `esbuild` to be installed (it is present in any project that
+ * depends on `davaux`).
+ *
+ * @example
+ * // build.ts
+ * import { buildMultisite } from '@davaux/multisite/build'
+ * import { sites } from './multisite.config.js'
+ *
+ * await buildMultisite(sites, { cwd: import.meta.dirname })
+ */
+export declare function buildMultisite<T>(config: MultisiteConfig<T>, options?: BuildMultisiteOptions): Promise<void>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,YAAY,EAElB,MAAM,eAAe,CAAA;AAEtB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qGAAqG;IACrG,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,EAC1B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CA8Hf"}

package/dist/build.js

@@ -0,0 +1,136 @@
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { collectCss, generateIslandsEntry, islandServerPlugin } from 'davaux/build';
+import { collectEsbuildPlugins, collectScannerSuffixes, pathsToAlias, } from 'davaux/config';
+import { scanIslands, scanRoutes } from 'davaux/scanner';
+/**
+ * Compile a multisite project to JavaScript.
+ *
+ * Reads route and island directories directly from the `MultisiteConfig` so the
+ * config is the single source of truth. Discovers and compiles all route, layout,
+ * middleware, and error-page files, per-site client island bundles, plus
+ * `server.ts` / `multisite.config.ts` if they exist at the project root.
+ *
+ * Requires `esbuild` to be installed (it is present in any project that
+ * depends on `davaux`).
+ *
+ * @example
+ * // build.ts
+ * import { buildMultisite } from '@davaux/multisite/build'
+ * import { sites } from './multisite.config.js'
+ *
+ * await buildMultisite(sites, { cwd: import.meta.dirname })
+ */
+export async function buildMultisite(config, options = {}) {
+    const { build } = await import('esbuild');
+    const cwd = options.cwd ?? process.cwd();
+    const outDir = options.outDir ?? resolve(cwd, 'dist');
+    const davauxPlugins = options.plugins ?? [];
+    const extraSuffixes = [...(config.extraSuffixes ?? []), ...collectScannerSuffixes(davauxPlugins)];
+    const userAlias = pathsToAlias(options.paths ?? {});
+    // All island directories (for the server-side island plugin)
+    const allIslandDirs = [
+        ...(config.islandsDir ? [config.islandsDir] : []),
+        ...config.sites.flatMap((s) => (s.islandsDir ? [s.islandsDir] : [])),
+    ];
+    // Collect route directories directly from config — no re-discovery needed
+    const routeDirs = [];
+    if (config.baseDir)
+        routeDirs.push(config.baseDir);
+    for (const site of config.sites) {
+        if (site.routesDir)
+            routeDirs.push(site.routesDir);
+    }
+    // Scan for compilable files in each routes directory
+    const routeFiles = [];
+    for (const dir of routeDirs) {
+        if (!existsSync(dir))
+            continue;
+        const { routes, layouts, middlewares, errorPage } = await scanRoutes(dir, extraSuffixes);
+        routeFiles.push(...routes.map((r) => r.filePath), ...layouts.map((l) => l.filePath), ...middlewares.map((m) => m.filePath), ...(errorPage ? [errorPage] : []));
+    }
+    // Include server.ts and multisite.config.ts at the project root if present
+    const entryPoints = [...routeFiles];
+    for (const name of ['server.ts', 'multisite.config.ts']) {
+        const p = resolve(cwd, name);
+        if (existsSync(p))
+            entryPoints.push(p);
+    }
+    const baseExternal = ['node:*', 'davaux', '@davaux/multisite', ...(options.external ?? [])];
+    // Include src/middleware.ts if present (app-level middleware runs before route matching)
+    const middlewareSrc = resolve(cwd, 'src', 'middleware.ts');
+    if (existsSync(middlewareSrc))
+        entryPoints.push(middlewareSrc);
+    // Compile routes (with island server wrapping + plugin transforms)
+    await build({
+        entryPoints,
+        outdir: outDir,
+        outbase: cwd,
+        format: 'esm',
+        platform: 'node',
+        target: 'node22',
+        bundle: true,
+        jsx: 'automatic',
+        jsxImportSource: 'davaux',
+        external: baseExternal,
+        sourcemap: true,
+        alias: { ...userAlias, 'davaux/client': 'davaux/signal' },
+        plugins: [
+            ...(allIslandDirs.length > 0 ? [islandServerPlugin(allIslandDirs)] : []),
+            ...collectEsbuildPlugins(davauxPlugins),
+        ],
+    });
+    // Collect CSS side-effect outputs into dist/_davaux/styles.css
+    const stylesOutFile = join(outDir, '_davaux', 'styles.css');
+    await collectCss(outDir, stylesOutFile);
+    // Compile per-site client island bundles to dist/_davaux/<name>/islands.js
+    const baseIslands = config.islandsDir ? await scanIslands(config.islandsDir) : [];
+    let islandBundles = 0;
+    for (const site of config.sites) {
+        const siteIslands = site.islandsDir ? await scanIslands(site.islandsDir) : [];
+        const allIslands = [...baseIslands, ...siteIslands];
+        if (allIslands.length === 0)
+            continue;
+        await build({
+            stdin: {
+                contents: generateIslandsEntry(allIslands),
+                loader: 'ts',
+                resolveDir: cwd,
+            },
+            outfile: join(outDir, '_davaux', site.name, 'islands.js'),
+            format: 'esm',
+            platform: 'browser',
+            target: 'es2022',
+            bundle: true,
+            jsx: 'automatic',
+            jsxImportSource: 'davaux/client',
+            sourcemap: true,
+            alias: userAlias,
+            plugins: collectEsbuildPlugins(davauxPlugins),
+        });
+        islandBundles++;
+    }
+    // Compile per-site client bundles to dist/_davaux/<name>/client.js
+    let clientBundles = 0;
+    for (const site of config.sites) {
+        const clientEntry = site.clientEntry ?? config.clientEntry;
+        if (!clientEntry || !existsSync(clientEntry))
+            continue;
+        await build({
+            entryPoints: [clientEntry],
+            outfile: join(outDir, '_davaux', site.name, 'client.js'),
+            format: 'esm',
+            platform: 'browser',
+            target: 'es2022',
+            bundle: true,
+            jsx: 'automatic',
+            jsxImportSource: 'davaux/client',
+            sourcemap: true,
+            alias: userAlias,
+            plugins: collectEsbuildPlugins(davauxPlugins),
+        });
+        clientBundles++;
+    }
+    console.log(`[davaux/multisite] Built ${routeFiles.length} route file(s), ${islandBundles} island bundle(s), ${clientBundles} client bundle(s)`);
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,202 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { createServer } from 'node:http';
+import type { RequestContext, RouteType, ScanResult } from 'davaux';
+import { type DavauxPlugin } from 'davaux/config';
+import type { CompiledApp } from 'davaux/handler';
+export interface SiteDefinition<T = Record<string, unknown>> {
+    /** Unique name for this site. Used in logging. */
+    name: string;
+    /**
+     * Hostname(s) that route to this site. Supply `'*'` as a catch-all fallback.
+     * Port is stripped before matching, so `'example.com'` matches both
+     * `example.com` and `example.com:3000`.
+     */
+    hostname: string | string[];
+    /**
+     * Absolute path to the site-specific routes directory. Routes here are
+     * overlaid on top of `baseDir`: same URL pattern + type in the overlay wins.
+     * Omit to run the base routes without any site-specific overrides.
+     */
+    routesDir?: string;
+    /**
+     * Absolute path to the site-specific islands directory. Islands here are
+     * merged with those in `MultisiteConfig.islandsDir` for this site's client bundle.
+     */
+    islandsDir?: string;
+    /**
+     * Absolute path to the site-specific public directory. Static files here are
+     * served at their URL path before route dispatch, taking priority over the
+     * shared `publicDir` when both contain a file at the same path.
+     */
+    publicDir?: string;
+    /**
+     * Absolute path to a site-specific client-side entry file. Overrides
+     * `MultisiteConfig.clientEntry` for this site when set.
+     */
+    clientEntry?: string;
+    /** Arbitrary per-site config — accessible via `getSite<T>(ctx)` in any handler, layout, or middleware. */
+    config?: T;
+}
+export interface MultisiteConfig<T = Record<string, unknown>> {
+    /** Absolute path to the shared base routes directory. */
+    baseDir?: string;
+    /** Absolute path to the shared islands directory. Islands here are included in every site's client bundle. */
+    islandsDir?: string;
+    /** Absolute path to the shared public directory. Static files are served at their URL path before route dispatch. */
+    publicDir?: string;
+    /**
+     * Absolute path to a shared client-side entry file compiled to `/_davaux/client.js` and
+     * injected into every page. Per-site `clientEntry` overrides this when set.
+     */
+    clientEntry?: string;
+    /** Site definitions — one entry per hostname (or hostname group). */
+    sites: SiteDefinition<T>[];
+    /** Extra route suffixes forwarded from plugins (e.g. `[['.page.md', 'page']]`). */
+    extraSuffixes?: [string, RouteType][];
+}
+export interface BuildOptions {
+    isDev?: boolean;
+    clientScripts?: string[];
+    clientStylesheets?: string[];
+    basePath?: string;
+    /** Absolute path to a compiled app-level middleware file (runs before route matching on every request). */
+    appMiddlewarePath?: string;
+    /**
+     * Absolute path to the `src/middleware.ts` source file. In dev mode it is
+     * compiled alongside route files and used as `appMiddlewarePath`.
+     * `startMultisite` auto-detects `<cwd>/src/middleware.ts` when `cwd` is set.
+     */
+    middlewareSrc?: string;
+    /**
+     * Absolute path to the project root — used in dev mode to locate the esbuild
+     * temp directory (`.davaux-multisite/`). Defaults to `process.cwd()`.
+     * Pass `import.meta.dirname` from your `server.ts` for reliable resolution.
+     */
+    cwd?: string;
+    /**
+     * Davaux plugins to apply — contributes esbuild transforms and scanner suffix
+     * extensions. Use the same list here as in `buildMultisite`.
+     *
+     * @example
+     * import { mdx } from '@davaux/mdx'
+     * startMultisite(sites, { plugins: [mdx()] })
+     */
+    plugins?: DavauxPlugin[];
+    /**
+     * tsconfig-style path aliases forwarded to esbuild `alias` in every build context.
+     * Same format as `compilerOptions.paths` — use `{ '~/*': ['./src/*'] }`.
+     */
+    paths?: Record<string, string>;
+    /**
+     * Extra packages to mark as external beyond the defaults (`node:*`, `davaux`,
+     * `@davaux/multisite`). Useful for native or CJS-only packages like `canvas` or
+     * `better-sqlite3`.
+     */
+    external?: string[];
+}
+export interface ServerOptions {
+    port?: number;
+    hostname?: string;
+}
+export interface StartMultisiteOptions extends BuildOptions, ServerOptions {
+}
+interface SiteEntry<T> {
+    app: CompiledApp;
+    config: T | undefined;
+    /** Absolute path to the compiled client islands bundle, if any. */
+    islandsPath?: string;
+    /** Absolute path to the compiled CSS stylesheet, if any. */
+    stylesPath?: string;
+    /** Absolute path to the compiled client entry bundle, if any. */
+    clientPath?: string;
+    /** Ordered list of public directories to serve static files from (per-site first, then shared). */
+    publicDirs: string[];
+}
+/**
+ * Merge a site-specific `ScanResult` on top of a base `ScanResult`.
+ *
+ * - **Routes**: overlay wins at the same `urlPattern + type`. The merged list
+ *   is re-sorted so static routes still precede dynamic ones.
+ * - **Layouts**: overlay wins at the same `dirPath` (directory-level override).
+ *   Layouts in directories unique to either tree are kept as-is.
+ * - **Middlewares**: overlay wins at the same `dirPath`. Middlewares unique to
+ *   the base still run; overlapping ones are replaced by the site version.
+ * - **Error page**: overlay wins if present, otherwise falls back to base.
+ */
+export declare function mergeScanResults(base: ScanResult, overlay: ScanResult): ScanResult;
+/** Identity function — returns config unchanged. Provides TypeScript inference for the site config type `T`. */
+export declare function defineSites<T = Record<string, unknown>>(config: MultisiteConfig<T>): MultisiteConfig<T>;
+/**
+ * Scan all site route directories, merge each with the shared base, and return
+ * a per-hostname map of compiled apps ready for dispatch.
+ *
+ * In dev mode (`isDev: true`), all route files are compiled with esbuild
+ * (applying plugin transforms and wrapping island imports server-side) and
+ * per-site client island bundles are built before the server starts.
+ *
+ * @example
+ * const apps = await buildMultisiteApps(sites, { isDev: true, cwd: import.meta.dirname })
+ * startMultisiteServer(apps, { port: 3000 })
+ */
+export declare function buildMultisiteApps<T = Record<string, unknown>>(config: MultisiteConfig<T>, options?: BuildOptions): Promise<Map<string, SiteEntry<T>>>;
+/**
+ * Start an HTTP server that dispatches each request to the matching site by
+ * hostname. Falls back to the `'*'` entry if the hostname is not explicitly
+ * registered. Responds 404 if neither matches.
+ *
+ * `sites` may be a `() => Map` factory so the caller can hot-swap compiled apps
+ * in dev mode without restarting the server.
+ */
+export declare function startMultisiteServer<T = Record<string, unknown>>(sites: Map<string, SiteEntry<T>> | (() => Map<string, SiteEntry<T>>), options?: ServerOptions): ReturnType<typeof createServer>;
+/**
+ * Look up the correct site by the request's `host` header, inject the site
+ * config into the WeakMap, and dispatch the request. Returns `false` if no
+ * site is registered for the host (including the `'*'` fallback).
+ *
+ * Useful for embedding multisite dispatch into a custom server or for testing
+ * without spinning up a real HTTP server.
+ *
+ * @example
+ * const server = createServer(async (req, res) => {
+ *   const handled = await dispatchToSite(sites, req, res)
+ *   if (!handled) { res.writeHead(404); res.end('No site') }
+ * })
+ */
+export declare function dispatchToSite<T = Record<string, unknown>>(sites: Map<string, SiteEntry<T>>, req: IncomingMessage, res: ServerResponse): Promise<boolean>;
+/**
+ * Start a multisite dev server with file watching, live reload, and TypeScript type checking.
+ * Called automatically by `startMultisite` when `NODE_ENV !== 'production'`.
+ */
+export declare function startMultisiteDev<T = Record<string, unknown>>(config: MultisiteConfig<T>, options?: StartMultisiteOptions): Promise<ReturnType<typeof createServer>>;
+/**
+ * Build and start a multisite server in one call.
+ *
+ * Combines `buildMultisiteApps` and `startMultisiteServer`. Automatically sets
+ * `isDev` from `NODE_ENV` unless explicitly provided — `true` in development
+ * (cache-busting for TypeScript routes), `false` in production.
+ *
+ * @example
+ * // server.ts
+ * import { startMultisite } from '@davaux/multisite'
+ * import { sites } from './multisite.config.js'
+ *
+ * startMultisite(sites, { port: 3000, hostname: 'localhost' })
+ */
+export declare function startMultisite<T = Record<string, unknown>>(config: MultisiteConfig<T>, options?: StartMultisiteOptions): Promise<ReturnType<typeof createServer>>;
+/**
+ * Retrieve the current site's config from a request context.
+ *
+ * Returns `undefined` when called outside of a multisite server (e.g. in tests
+ * using a single-site `startServer`).
+ *
+ * @example
+ * import { getSite } from '@davaux/multisite'
+ *
+ * export default definePage((ctx) => {
+ *   const site = getSite<MySiteConfig>(ctx)
+ *   return <Layout theme={site?.theme}>...</Layout>
+ * })
+ */
+export declare function getSite<T = Record<string, unknown>>(ctx: RequestContext): T | undefined;
+export {};
+//# 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":"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"}