@nexus_js/router 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nexus Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @nexus_js/router
+
+Nexus file-based router with nested layouts and dynamic segments.
+
+## Documentation
+
+All guides, API reference, and examples live on **[nexusjs.dev](https://nexusjs.dev)**.
+
+## Links
+
+- **Website:** [https://nexusjs.dev](https://nexusjs.dev)
+- **Repository:** [github.com/bierfor/nexus](https://github.com/bierfor/nexus) (see `packages/router/`)
+- **Issues:** [github.com/bierfor/nexus/issues](https://github.com/bierfor/nexus/issues)
+
+## License
+
+MIT © Nexus contributors

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import type { RouteManifest, RouteEntry } from '@nexus_js/compiler';
+export type { RouteManifest, RouteEntry };
+export { extractTenant, scopeTenantKey, tenantHeaders, tenantVaryHeader, } from './tenant.js';
+export type { TenantInfo, TenantConfig, TenantMode } from './tenant.js';
+export interface MatchedRoute {
+    route: RouteEntry;
+    params: Record<string, string>;
+    layouts: RouteEntry[];
+}
+/**
+ * Scans a directory tree and builds a route manifest.
+ *
+ * File conventions:
+ *   routes/
+ *   ├── +layout.nx          → root layout
+ *   ├── +page.nx            → /
+ *   ├── about/
+ *   │   └── +page.nx        → /about
+ *   ├── blog/
+ *   │   ├── +layout.nx      → nested layout for all /blog/* routes
+ *   │   ├── +page.nx        → /blog
+ *   │   └── [slug]/
+ *   │       └── +page.nx    → /blog/:slug
+ *   └── api/
+ *       └── users/
+ *           └── +server.nx  → GET/POST /api/users (API route)
+ */
+export declare function buildRouteManifest(routesDir: string): Promise<RouteManifest>;
+/**
+ * Matches an incoming URL pathname against the route manifest.
+ * Returns the matched route + resolved params + layout chain.
+ */
+export declare function matchRoute(pathname: string, manifest: RouteManifest): MatchedRoute | null;
+//# 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":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEpE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;AAG1C,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAmClF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,aAAa,GACtB,YAAY,GAAG,IAAI,CAYrB"}

package/dist/index.js

@@ -0,0 +1,163 @@
+import { readdir, stat } from 'node:fs/promises';
+import { join, relative, extname, basename, dirname } from 'node:path';
+// Re-export Multi-Tenant support
+export { extractTenant, scopeTenantKey, tenantHeaders, tenantVaryHeader, } from './tenant.js';
+/**
+ * Scans a directory tree and builds a route manifest.
+ *
+ * File conventions:
+ *   routes/
+ *   ├── +layout.nx          → root layout
+ *   ├── +page.nx            → /
+ *   ├── about/
+ *   │   └── +page.nx        → /about
+ *   ├── blog/
+ *   │   ├── +layout.nx      → nested layout for all /blog/* routes
+ *   │   ├── +page.nx        → /blog
+ *   │   └── [slug]/
+ *   │       └── +page.nx    → /blog/:slug
+ *   └── api/
+ *       └── users/
+ *           └── +server.nx  → GET/POST /api/users (API route)
+ */
+export async function buildRouteManifest(routesDir) {
+    const files = await collectFiles(routesDir);
+    const routes = [];
+    for (const file of files) {
+        const rel = relative(routesDir, file);
+        const ext = extname(file);
+        const base = basename(file, ext);
+        if (!['.nx', '.ts', '.js'].includes(ext))
+            continue;
+        if (!base.startsWith('+'))
+            continue;
+        const isLayout = base === '+layout';
+        const isServerRoute = base === '+server';
+        const isPage = base === '+page';
+        if (!isLayout && !isServerRoute && !isPage)
+            continue;
+        const pattern = filePathToRoutePattern(rel, routesDir);
+        const params = extractParams(pattern);
+        routes.push({
+            pattern,
+            filepath: file,
+            params,
+            isDynamic: params.length > 0,
+            isLayout,
+            serverActions: [],
+        });
+    }
+    // Link layouts to their children
+    linkLayouts(routes);
+    return { routes };
+}
+/**
+ * Matches an incoming URL pathname against the route manifest.
+ * Returns the matched route + resolved params + layout chain.
+ */
+export function matchRoute(pathname, manifest) {
+    const pageRoutes = manifest.routes.filter((r) => !r.isLayout);
+    for (const route of pageRoutes) {
+        const params = matchPattern(pathname, route.pattern);
+        if (params !== null) {
+            const layouts = resolveLayoutChain(route, manifest);
+            return { route, params, layouts };
+        }
+    }
+    return null;
+}
+/**
+ * Converts a file system path to a URL pattern.
+ *
+ * routes/blog/[slug]/+page.nx → /blog/:slug
+ * routes/+page.nx             → /
+ * routes/about/+page.nx       → /about
+ */
+function filePathToRoutePattern(filepath, _routesDir) {
+    const parts = filepath.split('/').filter(Boolean);
+    const segments = [];
+    for (const part of parts) {
+        if (part.startsWith('+'))
+            continue; // skip +page, +layout
+        if (part.startsWith('[') && part.endsWith(']')) {
+            // Dynamic segment [slug] → :slug
+            segments.push(':' + part.slice(1, -1));
+        }
+        else if (part.startsWith('(') && part.endsWith(')')) {
+            // Route group (auth) — invisible in URL
+            continue;
+        }
+        else {
+            segments.push(part);
+        }
+    }
+    return '/' + segments.join('/');
+}
+function extractParams(pattern) {
+    return [...pattern.matchAll(/:(\w+)/g)].map((m) => m[1] ?? '');
+}
+function matchPattern(pathname, pattern) {
+    const patternParts = pattern.split('/').filter(Boolean);
+    const pathParts = pathname.split('/').filter(Boolean);
+    if (patternParts.length !== pathParts.length)
+        return null;
+    const params = {};
+    for (let i = 0; i < patternParts.length; i++) {
+        const pp = patternParts[i] ?? '';
+        const path = pathParts[i] ?? '';
+        if (pp.startsWith(':')) {
+            params[pp.slice(1)] = decodeURIComponent(path);
+        }
+        else if (pp !== path) {
+            return null;
+        }
+    }
+    return params;
+}
+function resolveLayoutChain(route, manifest) {
+    const layouts = [];
+    const layoutRoutes = manifest.routes.filter((r) => r.isLayout);
+    // Walk up the path tree to find applicable layouts
+    const parts = route.pattern.split('/').filter(Boolean);
+    const prefixes = ['/', ...parts.map((_, i) => '/' + parts.slice(0, i + 1).join('/'))];
+    for (const prefix of prefixes) {
+        const layout = layoutRoutes.find((l) => l.pattern === prefix);
+        if (layout)
+            layouts.push(layout);
+    }
+    return layouts;
+}
+function linkLayouts(routes) {
+    const layouts = routes.filter((r) => r.isLayout);
+    for (const route of routes) {
+        if (route.isLayout)
+            continue;
+        const parentDir = dirname(route.pattern);
+        const parentLayout = layouts.find((l) => l.pattern === parentDir);
+        if (parentLayout) {
+            route.parentLayout = parentLayout.filepath;
+        }
+    }
+}
+async function collectFiles(dir) {
+    const results = [];
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        const fullPath = join(dir, entry);
+        const info = await stat(fullPath);
+        if (info.isDirectory()) {
+            results.push(...(await collectFiles(fullPath)));
+        }
+        else {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+//# 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/tenant.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Nexus Multi-Tenant — First-Class Tenant Isolation.
+ *
+ * Detects the tenant from the incoming request (subdomain or custom domain)
+ * and provides a typed TenantContext that's automatically available in every
+ * .nx file via $context().tenant.
+ *
+ * Modes:
+ *   'subdomain'     → empresa-a.nexus.app → tenant.id = 'empresa-a'
+ *   'custom-domain' → empresa-b.com       → tenant.id resolved by resolver fn
+ *   'path'          → nexus.app/t/empresa-a/dashboard → tenant.id = 'empresa-a'
+ *
+ * The router automatically:
+ *   - Isolates Cache-Control per tenant (x-nexus-tenant-id header)
+ *   - Scopes Shield Cache keys: `${tenantId}:${routeKey}`
+ *   - Passes tenant to every Server Action via ctx.tenant
+ *   - Prevents cross-tenant data leaks by design
+ */
+export type TenantMode = 'subdomain' | 'custom-domain' | 'path' | 'disabled';
+export interface TenantInfo {
+    /** Unique identifier for this tenant (e.g. 'empresa-a') */
+    id: string;
+    /** Full hostname as received (empresa-a.nexus.app or empresa-b.com) */
+    domain: string;
+    /** true if tenant is using a custom domain (not the base domain) */
+    isCustomDomain: boolean;
+    /** Subdomain portion (only set in subdomain mode) */
+    subdomain?: string | undefined;
+    /** Resolved metadata from your resolver function */
+    meta?: Record<string, unknown> | undefined;
+}
+export interface TenantConfig<TMeta = Record<string, unknown>> {
+    mode: TenantMode;
+    /** Your app's base domain (e.g. 'nexus.app') */
+    baseDomain?: string;
+    /** Path prefix for path-based tenancy (e.g. '/t/') */
+    pathPrefix?: string;
+    /**
+     * Optional async resolver — fetch tenant metadata (name, plan, logo, etc.)
+     * from your DB when a tenant is identified. Result is cached per request.
+     */
+    resolve?: (tenantId: string, request: Request) => Promise<TMeta | null>;
+    /** Tenant to use when no tenant is detected (e.g. your main marketing site) */
+    fallback?: TenantInfo;
+}
+/**
+ * Extracts tenant information from a Web-standard Request.
+ * Returns null if the request doesn't map to any tenant
+ * (e.g. the root marketing site).
+ */
+export declare function extractTenant<TMeta = Record<string, unknown>>(request: Request, config: TenantConfig<TMeta>): Promise<TenantInfo | null>;
+/**
+ * Scopes a Shield Cache key to a specific tenant.
+ * Prevents data from tenant A being served to tenant B.
+ *
+ * @example
+ * const cacheKey = scopeTenantKey(tenant, `list:${page}`);
+ * // → 'empresa-a:list:1'
+ */
+export declare function scopeTenantKey(tenant: TenantInfo | null, key: string): string;
+/**
+ * Middleware-style helper — reads or injects the tenant into request headers.
+ * Useful for logging and downstream cache isolation.
+ */
+export declare function tenantHeaders(tenant: TenantInfo | null): Record<string, string>;
+/**
+ * Helper: builds a tenant-aware Cache-Control vary header.
+ * CDNs that respect Vary will automatically serve different cache entries
+ * per tenant when using subdomain routing.
+ */
+export declare function tenantVaryHeader(mode: TenantMode): string;
+//# sourceMappingURL=tenant.d.ts.map

package/dist/tenant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant.d.ts","sourceRoot":"","sources":["../src/tenant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,eAAe,GAAG,MAAM,GAAG,UAAU,CAAC;AAE7E,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,EAAE,EAAe,MAAM,CAAC;IACxB,uEAAuE;IACvE,MAAM,EAAW,MAAM,CAAC;IACxB,oEAAoE;IACpE,cAAc,EAAG,OAAO,CAAC;IACzB,qDAAqD;IACrD,SAAS,CAAC,EAAO,MAAM,GAAG,SAAS,CAAC;IACpC,oDAAoD;IACpD,IAAI,CAAC,EAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACtD;AAED,MAAM,WAAW,YAAY,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,IAAI,EAAQ,UAAU,CAAC;IACvB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC1E,+EAA+E;IAC/E,QAAQ,CAAC,EAAG,UAAU,CAAC;CACxB;AAuBD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,GAC1B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA4D5B;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO/E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAOzD"}

package/dist/tenant.js

@@ -0,0 +1,140 @@
+/**
+ * Nexus Multi-Tenant — First-Class Tenant Isolation.
+ *
+ * Detects the tenant from the incoming request (subdomain or custom domain)
+ * and provides a typed TenantContext that's automatically available in every
+ * .nx file via $context().tenant.
+ *
+ * Modes:
+ *   'subdomain'     → empresa-a.nexus.app → tenant.id = 'empresa-a'
+ *   'custom-domain' → empresa-b.com       → tenant.id resolved by resolver fn
+ *   'path'          → nexus.app/t/empresa-a/dashboard → tenant.id = 'empresa-a'
+ *
+ * The router automatically:
+ *   - Isolates Cache-Control per tenant (x-nexus-tenant-id header)
+ *   - Scopes Shield Cache keys: `${tenantId}:${routeKey}`
+ *   - Passes tenant to every Server Action via ctx.tenant
+ *   - Prevents cross-tenant data leaks by design
+ */
+// ── Extraction helpers ────────────────────────────────────────────────────────
+function extractSubdomain(host, baseDomain) {
+    // empresa-a.nexus.app → empresa-a  (baseDomain = 'nexus.app')
+    // nexus.app → null (it's the root domain)
+    // empresa-b.com → null (not a subdomain of baseDomain)
+    if (!host.endsWith(`.${baseDomain}`))
+        return null;
+    const sub = host.slice(0, host.length - baseDomain.length - 1);
+    return sub.length > 0 && !sub.includes('.') ? sub : null;
+}
+function extractPathTenant(pathname, prefix) {
+    // /t/empresa-a/dashboard → empresa-a  (prefix = '/t/')
+    if (!pathname.startsWith(prefix))
+        return null;
+    const rest = pathname.slice(prefix.length);
+    const id = rest.split('/')[0];
+    return id?.length ? id : null;
+}
+// ── Public API ────────────────────────────────────────────────────────────────
+/**
+ * Extracts tenant information from a Web-standard Request.
+ * Returns null if the request doesn't map to any tenant
+ * (e.g. the root marketing site).
+ */
+export async function extractTenant(request, config) {
+    if (config.mode === 'disabled')
+        return config.fallback ?? null;
+    const url = new URL(request.url);
+    const host = request.headers.get('host') ?? url.hostname;
+    let tenantId = null;
+    let isCustomDomain = false;
+    let subdomain;
+    switch (config.mode) {
+        case 'subdomain': {
+            const base = config.baseDomain ?? url.hostname.split('.').slice(1).join('.');
+            subdomain = extractSubdomain(host, base) ?? undefined;
+            if (!subdomain)
+                return config.fallback ?? null;
+            tenantId = subdomain;
+            break;
+        }
+        case 'custom-domain': {
+            const base = config.baseDomain ?? '';
+            // If it matches the base domain → not a custom domain
+            if (base && (host === base || host.endsWith(`.${base}`))) {
+                subdomain = extractSubdomain(host, base) ?? undefined;
+                tenantId = subdomain ?? null;
+            }
+            else {
+                // Fully custom domain
+                isCustomDomain = true;
+                tenantId = host;
+            }
+            if (!tenantId)
+                return config.fallback ?? null;
+            break;
+        }
+        case 'path': {
+            const prefix = config.pathPrefix ?? '/t/';
+            tenantId = extractPathTenant(url.pathname, prefix);
+            if (!tenantId)
+                return config.fallback ?? null;
+            break;
+        }
+    }
+    const tenant = {
+        id: tenantId,
+        domain: host,
+        isCustomDomain,
+        subdomain,
+    };
+    // Resolve optional metadata (plan, logo, DB row, etc.)
+    if (config.resolve) {
+        try {
+            const meta = await config.resolve(tenantId, request);
+            if (meta)
+                tenant.meta = meta;
+        }
+        catch {
+            // Resolver failure → still return tenant with no meta (don't 500)
+        }
+    }
+    return tenant;
+}
+/**
+ * Scopes a Shield Cache key to a specific tenant.
+ * Prevents data from tenant A being served to tenant B.
+ *
+ * @example
+ * const cacheKey = scopeTenantKey(tenant, `list:${page}`);
+ * // → 'empresa-a:list:1'
+ */
+export function scopeTenantKey(tenant, key) {
+    return tenant ? `${tenant.id}:${key}` : key;
+}
+/**
+ * Middleware-style helper — reads or injects the tenant into request headers.
+ * Useful for logging and downstream cache isolation.
+ */
+export function tenantHeaders(tenant) {
+    if (!tenant)
+        return {};
+    return {
+        'x-nexus-tenant': tenant.id,
+        'x-nexus-tenant-domain': tenant.domain,
+        ...(tenant.isCustomDomain ? { 'x-nexus-custom-domain': '1' } : {}),
+    };
+}
+/**
+ * Helper: builds a tenant-aware Cache-Control vary header.
+ * CDNs that respect Vary will automatically serve different cache entries
+ * per tenant when using subdomain routing.
+ */
+export function tenantVaryHeader(mode) {
+    switch (mode) {
+        case 'subdomain':
+        case 'custom-domain': return 'host';
+        case 'path': return 'x-nexus-tenant';
+        default: return '';
+    }
+}
+//# sourceMappingURL=tenant.js.map

package/dist/tenant.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@nexus_js/router",
+  "version": "0.6.0",
+  "description": "Nexus file-based router with nested layouts and dynamic segments",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@nexus_js/compiler": "0.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "license": "MIT",
+  "homepage": "https://nexusjs.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bierfor/nexus.git",
+    "directory": "packages/router"
+  },
+  "bugs": {
+    "url": "https://github.com/bierfor/nexus/issues"
+  },
+  "keywords": [
+    "nexus",
+    "framework",
+    "full-stack",
+    "svelte",
+    "islands",
+    "ssr",
+    "vite",
+    "server-actions"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist"
+  }
+}