@memberjunction/server 6.2.0-edge.5 → 6.2.0-edge.7

package/dist/auth/initializeProviders.js.map

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

package/dist/auth/localDevAuth.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview Local Development Mock/Test JWT Authentication (`local`).
+ *
+ * Provides a zero-external-IdP local development login flow backed by MJ's
+ * in-memory RS256 `MagicLinkKeyManager` and JWKS endpoint.
+ *
+ * HARD SECURITY INVARIANTS:
+ * 1. Fail loud in production: If `MJ_DEV_AUTH_ENABLED` (or `configInfo.devAuth?.enabled`)
+ *    is enabled while `NODE_ENV === 'production'`, server startup throws a fatal error
+ *    and refuses to boot.
+ * 2. Strict localhost-only guard: Every request to `/auth/dev-login` and `/auth/dev-users`
+ *    verifies that:
+ *    - `NODE_ENV !== 'production'` and local dev auth is enabled.
+ *    - `X-Forwarded-For` (if present) contains only loopback addresses.
+ *    - `Host` header is `localhost`, `127.0.0.1`, or `::1`.
+ *    - `Origin` / `Referer` headers (if present) resolve to `localhost`, `127.0.0.1`, or `::1`.
+ *    - Socket remote address is loopback (`127.0.0.1`, `::1`, `::ffff:127.0.0.1`) or local
+ *      Docker bridge/host-gateway when no external `X-Forwarded-For` is present.
+ *    Any request failing these checks is denied with `403 Forbidden` and logged.
+ *
+ * @module @memberjunction/server/auth/localDevAuth
+ */
+import { Router, type Request } from 'express';
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { AssertLocalDevAuthAllowed, IsLocalDevAuthEnabled } from './initializeProviders.js';
+export { AssertLocalDevAuthAllowed, IsLocalDevAuthEnabled };
+/** Claims embedded in a local development JWT. */
+interface LocalDevJWTClaims extends Record<string, unknown> {
+    iss: string;
+    aud: string;
+    sub: string;
+    email: string;
+    given_name: string;
+    family_name: string;
+    name: string;
+    preferred_username: string;
+    iat: number;
+    exp: number;
+}
+/** Result of the localhost-only request guard. */
+export interface LocalhostGuardResult {
+    Allowed: boolean;
+    Reason?: string;
+}
+/**
+ * Checks whether an IP address is a loopback address, or (when `allowDockerBridge` is true)
+ * a local Docker bridge / Docker Desktop host-gateway address.
+ */
+export declare function IsLoopbackAddress(rawIp: string | undefined, allowDockerBridge: boolean): boolean;
+/**
+ * Verifies that an incoming HTTP request to a local-dev auth endpoint originated
+ * strictly from localhost (`localhost`, `127.0.0.1`, or `::1`).
+ */
+export declare function VerifyLocalhostRequest(req: Request, env?: NodeJS.ProcessEnv): LocalhostGuardResult;
+/**
+ * Registers the `local` auth provider in `AuthProviderFactory` and `configInfo.authProviders`
+ * using the server's configured public URL and the shared `MagicLinkKeyManager` JWKS endpoint.
+ */
+export declare function RegisterLocalDevAuthProvider(publicUrl?: string): void;
+/**
+ * Resolves the active local MJ user to sign in as for local development.
+ */
+export declare function ResolveLocalDevUser(requestedEmail?: string, provider?: IMetadataProvider): Promise<UserInfo | null>;
+/**
+ * Mints a signed RS256 local-dev JWT for the given `UserInfo`.
+ */
+export declare function MintLocalDevJwt(user: UserInfo, publicUrl?: string, ttlSeconds?: number): {
+    token: string;
+    expiresAt: string;
+    claims: LocalDevJWTClaims;
+};
+/**
+ * Attaches `/dev-login` and `/dev-users` routes onto the `/auth` router.
+ *
+ * When local dev auth is disabled, these routes respond with `404`.
+ * When enabled, every request is gated by {@link VerifyLocalhostRequest}.
+ */
+export declare function AttachLocalDevAuthRoutes(router: Router): void;
+//# sourceMappingURL=localDevAuth.d.ts.map

package/dist/auth/localDevAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localDevAuth.d.ts","sourceRoot":"","sources":["../../src/auth/localDevAuth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,MAAM,EAAQ,KAAK,OAAO,EAAiB,MAAM,SAAS,CAAC;AAEpE,OAAO,EAGL,iBAAiB,EAIjB,QAAQ,EACT,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAE5F,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,CAAC;AAE5D,kDAAkD;AAClD,UAAU,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,kDAAkD;AAClD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAYD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,iBAAiB,EAAE,OAAO,GAAG,OAAO,CA0BhG;AAoCD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,oBAAoB,CA6GtB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAqCrE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,cAAc,CAAC,EAAE,MAAM,EACvB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA4D1B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,SAAW,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAkCjE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA2G7D"}

package/dist/auth/localDevAuth.js

@@ -0,0 +1,439 @@
+/**
+ * @fileoverview Local Development Mock/Test JWT Authentication (`local`).
+ *
+ * Provides a zero-external-IdP local development login flow backed by MJ's
+ * in-memory RS256 `MagicLinkKeyManager` and JWKS endpoint.
+ *
+ * HARD SECURITY INVARIANTS:
+ * 1. Fail loud in production: If `MJ_DEV_AUTH_ENABLED` (or `configInfo.devAuth?.enabled`)
+ *    is enabled while `NODE_ENV === 'production'`, server startup throws a fatal error
+ *    and refuses to boot.
+ * 2. Strict localhost-only guard: Every request to `/auth/dev-login` and `/auth/dev-users`
+ *    verifies that:
+ *    - `NODE_ENV !== 'production'` and local dev auth is enabled.
+ *    - `X-Forwarded-For` (if present) contains only loopback addresses.
+ *    - `Host` header is `localhost`, `127.0.0.1`, or `::1`.
+ *    - `Origin` / `Referer` headers (if present) resolve to `localhost`, `127.0.0.1`, or `::1`.
+ *    - Socket remote address is loopback (`127.0.0.1`, `::1`, `::ffff:127.0.0.1`) or local
+ *      Docker bridge/host-gateway when no external `X-Forwarded-For` is present.
+ *    Any request failing these checks is denied with `403 Forbidden` and logged.
+ *
+ * @module @memberjunction/server/auth/localDevAuth
+ */
+import * as fs from 'node:fs';
+import { json } from 'express';
+import { rateLimit } from 'express-rate-limit';
+import { LogError, LogStatusEx, Metadata, } from '@memberjunction/core';
+import { UUIDsEqual } from '@memberjunction/global';
+import { AuthProviderFactory, LocalDevProvider } from '@memberjunction/auth-providers';
+import { UserCache } from '@memberjunction/generic-database-provider';
+import { configInfo } from '../config.js';
+import { ApiRoute } from '../apiRoot.js';
+import { MagicLinkKeyManager } from './magicLink/MagicLinkKeys.js';
+import { MAGIC_LINK_JWKS_PATH } from './magicLink/MagicLinkRouter.js';
+import { AssertLocalDevAuthAllowed, IsLocalDevAuthEnabled } from './initializeProviders.js';
+export { AssertLocalDevAuthAllowed, IsLocalDevAuthEnabled };
+const LOCALHOST_HOSTNAMES = new Set(['localhost', '127.0.0.1', '::1', '[::1]']);
+function TrimTrailingSlashes(value) {
+    let end = value.length;
+    while (end > 0 && value.charCodeAt(end - 1) === 47) {
+        end--;
+    }
+    return value.slice(0, end);
+}
+/**
+ * Checks whether an IP address is a loopback address, or (when `allowDockerBridge` is true)
+ * a local Docker bridge / Docker Desktop host-gateway address.
+ */
+export function IsLoopbackAddress(rawIp, allowDockerBridge) {
+    if (!rawIp) {
+        return false;
+    }
+    const normalized = rawIp.trim().toLowerCase().replace(/^::ffff:/, '');
+    if (normalized === '127.0.0.1' || normalized === '::1' || normalized === 'localhost') {
+        return true;
+    }
+    if (/^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(normalized)) {
+        return true;
+    }
+    if (allowDockerBridge) {
+        // Docker Desktop macOS/Windows host-gateway IPs (192.168.65.0/24) and local
+        // Docker bridge gateway (.1) addresses when a host browser connects to a
+        // port-forwarded container bound to 127.0.0.1 on the host.
+        if (/^192\.168\.65\.\d{1,3}$/.test(normalized)) {
+            return true;
+        }
+        if (/^172\.(1[6-9]|2\d|3[0-1])\.\d{1,3}\.1$/.test(normalized)) {
+            return true;
+        }
+        if (normalized === '10.0.2.2') {
+            return true;
+        }
+    }
+    return false;
+}
+function isRunningInsideContainer(env) {
+    if (env.MJ_DEV_AUTH_ALLOW_DOCKER_BRIDGE === 'true') {
+        return true;
+    }
+    if (env.MJ_DEV_AUTH_ALLOW_DOCKER_BRIDGE === 'false') {
+        return false;
+    }
+    return fs.existsSync('/.dockerenv') || fs.existsSync('/run/.containerenv');
+}
+/** Extracts the hostname (without port) from a raw HTTP `Host` header value. */
+function extractHostnameFromHostHeader(hostHeader) {
+    if (!hostHeader) {
+        return '';
+    }
+    const trimmed = hostHeader.trim().toLowerCase();
+    if (trimmed.startsWith('[')) {
+        const closeIdx = trimmed.indexOf(']');
+        return closeIdx >= 0 ? trimmed.slice(1, closeIdx) : trimmed;
+    }
+    const colonIdx = trimmed.indexOf(':');
+    return colonIdx >= 0 ? trimmed.slice(0, colonIdx) : trimmed;
+}
+/** Extracts the hostname from an `Origin` or `Referer` URL header. */
+function extractHostnameFromUrlHeader(urlHeader) {
+    try {
+        const parsed = new URL(urlHeader);
+        return parsed.hostname.toLowerCase().replace(/^\[|\]$/g, '');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Verifies that an incoming HTTP request to a local-dev auth endpoint originated
+ * strictly from localhost (`localhost`, `127.0.0.1`, or `::1`).
+ */
+export function VerifyLocalhostRequest(req, env = process.env) {
+    if (env.NODE_ENV?.trim().toLowerCase() === 'production') {
+        return {
+            Allowed: false,
+            Reason: 'Local dev auth is strictly forbidden when NODE_ENV=production.',
+        };
+    }
+    // 1. Inspect X-Forwarded-For / Forwarded / X-Real-IP / CF-Connecting-IP if present — every hop must be pure loopback
+    const xffRaw = req.headers['x-forwarded-for'];
+    const xffValue = Array.isArray(xffRaw) ? xffRaw.join(',') : xffRaw;
+    if (xffValue && xffValue.trim().length > 0) {
+        const hops = xffValue.split(',').map((h) => h.trim()).filter(Boolean);
+        for (const hop of hops) {
+            if (!IsLoopbackAddress(hop, false)) {
+                return {
+                    Allowed: false,
+                    Reason: `Non-loopback X-Forwarded-For address '${hop}' rejected.`,
+                };
+            }
+        }
+    }
+    for (const proxyHeader of ['x-real-ip', 'cf-connecting-ip']) {
+        const rawHeader = req.headers[proxyHeader];
+        const headerVal = Array.isArray(rawHeader) ? rawHeader[0] : rawHeader;
+        if (headerVal && headerVal.trim().length > 0 && !IsLoopbackAddress(headerVal, false)) {
+            return {
+                Allowed: false,
+                Reason: `Non-loopback ${proxyHeader} address '${headerVal}' rejected.`,
+            };
+        }
+    }
+    const forwardedHeader = req.headers['forwarded'];
+    const forwardedVal = Array.isArray(forwardedHeader) ? forwardedHeader.join(',') : forwardedHeader;
+    if (forwardedVal && forwardedVal.trim().length > 0) {
+        const forMatches = forwardedVal.matchAll(/for=\s*"?\[?([^;,"\]]+)\]?"?/gi);
+        for (const match of forMatches) {
+            const candidateIp = match[1]?.split(':')[0]?.trim();
+            if (candidateIp && !IsLoopbackAddress(candidateIp, false)) {
+                return {
+                    Allowed: false,
+                    Reason: `Non-loopback Forwarded address '${candidateIp}' rejected.`,
+                };
+            }
+        }
+    }
+    // 1b. Reject browser cross-site requests via Sec-Fetch-Site
+    const secFetchSite = typeof req.headers['sec-fetch-site'] === 'string' ? req.headers['sec-fetch-site'].trim().toLowerCase() : undefined;
+    if (secFetchSite === 'cross-site') {
+        return {
+            Allowed: false,
+            Reason: `Cross-site request (Sec-Fetch-Site: ${secFetchSite}) rejected.`,
+        };
+    }
+    // 2. Inspect Host header — must be localhost, 127.0.0.1, or ::1
+    const hostHeader = typeof req.headers.host === 'string' ? req.headers.host : req.hostname;
+    const hostName = extractHostnameFromHostHeader(hostHeader);
+    if (!hostName || !LOCALHOST_HOSTNAMES.has(hostName)) {
+        return {
+            Allowed: false,
+            Reason: `Non-localhost Host header '${hostHeader ?? 'missing'}' rejected.`,
+        };
+    }
+    // 3. Inspect Origin header if present
+    const originHeader = typeof req.headers.origin === 'string' ? req.headers.origin : undefined;
+    if (originHeader) {
+        const originHost = extractHostnameFromUrlHeader(originHeader);
+        if (!originHost || !LOCALHOST_HOSTNAMES.has(originHost)) {
+            return {
+                Allowed: false,
+                Reason: `Non-localhost Origin header '${originHeader}' rejected.`,
+            };
+        }
+    }
+    // 4. Inspect Referer header if present
+    const refererHeader = typeof req.headers.referer === 'string' ? req.headers.referer : undefined;
+    if (refererHeader) {
+        const refererHost = extractHostnameFromUrlHeader(refererHeader);
+        if (!refererHost || !LOCALHOST_HOSTNAMES.has(refererHost)) {
+            return {
+                Allowed: false,
+                Reason: `Non-localhost Referer header '${refererHeader}' rejected.`,
+            };
+        }
+    }
+    // 5. Inspect socket remote address (allow Docker local bridge ONLY when running in a container and no proxy header is present)
+    const hasProxyHeader = Boolean((xffValue && xffValue.trim().length > 0) ||
+        (forwardedVal && forwardedVal.trim().length > 0) ||
+        req.headers['x-real-ip'] ||
+        req.headers['cf-connecting-ip']);
+    const allowDockerBridge = !hasProxyHeader && isRunningInsideContainer(env);
+    const remoteAddress = req.socket?.remoteAddress || req.ip;
+    if (!IsLoopbackAddress(remoteAddress, allowDockerBridge)) {
+        return {
+            Allowed: false,
+            Reason: `Non-loopback socket remote address '${remoteAddress ?? 'unknown'}' rejected.`,
+        };
+    }
+    return { Allowed: true };
+}
+/**
+ * Registers the `local` auth provider in `AuthProviderFactory` and `configInfo.authProviders`
+ * using the server's configured public URL and the shared `MagicLinkKeyManager` JWKS endpoint.
+ */
+export function RegisterLocalDevAuthProvider(publicUrl) {
+    AssertLocalDevAuthAllowed();
+    MagicLinkKeyManager.Instance.Initialize(configInfo.magicLink?.rsaPrivateKey);
+    const base = publicUrl ? TrimTrailingSlashes(publicUrl) : undefined;
+    const issuer = base ? `${base}/local-dev` : ApiRoute('/local-dev', { absolute: true });
+    const jwksUri = base ? `${base}${MAGIC_LINK_JWKS_PATH}` : ApiRoute(MAGIC_LINK_JWKS_PATH, { absolute: true });
+    const providerConfig = {
+        name: 'local',
+        type: 'local',
+        issuer,
+        audience: LocalDevProvider.DEFAULT_AUDIENCE,
+        jwksUri,
+    };
+    try {
+        const factory = AuthProviderFactory.Instance;
+        const existingProvider = factory.getByName('local');
+        if (existingProvider && existingProvider.issuer === issuer && existingProvider.jwksUri === jwksUri) {
+            return;
+        }
+        configInfo.authProviders = configInfo.authProviders ?? [];
+        const existingIdx = configInfo.authProviders.findIndex((p) => p.type === 'local' || p.name === 'local');
+        if (existingIdx >= 0) {
+            configInfo.authProviders[existingIdx] = providerConfig;
+        }
+        else {
+            configInfo.authProviders.push(providerConfig);
+        }
+        factory.register(AuthProviderFactory.createProvider(providerConfig));
+        LogStatusEx({
+            message: `[LocalDevAuth] Registered local dev auth provider (issuer: ${providerConfig.issuer}, jwks: ${providerConfig.jwksUri})`,
+            verboseOnly: true,
+        });
+    }
+    catch (e) {
+        LogError(`[LocalDevAuth] Failed to register local dev auth provider: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+/**
+ * Resolves the active local MJ user to sign in as for local development.
+ */
+export async function ResolveLocalDevUser(requestedEmail, provider) {
+    const effectiveProvider = provider ?? Metadata.Provider;
+    if ((!UserCache.Instance.Users || UserCache.Instance.Users.length === 0) && effectiveProvider) {
+        try {
+            await UserCache.Instance.Refresh(effectiveProvider);
+        }
+        catch (err) {
+            LogError(`[LocalDevAuth] Failed to refresh UserCache: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const allUsers = UserCache.Instance.Users ?? [];
+    const activeUsers = allUsers.filter((u) => u.IsActive &&
+        !UUIDsEqual(u.ID, UserCache.Instance.SYSTEM_USER_ID) &&
+        u.Name?.trim().toLowerCase() !== 'system');
+    const targetEmail = requestedEmail?.trim() ||
+        process.env.MJ_DEV_AUTH_DEFAULT_EMAIL?.trim() ||
+        configInfo?.devAuth?.defaultEmail?.trim();
+    if (targetEmail) {
+        const matched = activeUsers.find((u) => u.Email?.trim().toLowerCase() === targetEmail.toLowerCase());
+        if (matched) {
+            return matched;
+        }
+        // If an explicit email was requested on the call and doesn't exist, return null
+        if (requestedEmail?.trim()) {
+            return null;
+        }
+    }
+    // 1. Default MJ installer admin email
+    const defaultAdmin = activeUsers.find((u) => u.Email?.trim().toLowerCase() === 'admin@memberjunction.org');
+    if (defaultAdmin) {
+        return defaultAdmin;
+    }
+    // 2. First active user holding the Developer role
+    const developerUser = activeUsers.find((u) => u.Email?.trim().toLowerCase() !== 'not.set@nowhere.com' &&
+        u.UserRoles?.some((r) => r.Role?.trim().toLowerCase() === 'developer'));
+    if (developerUser) {
+        return developerUser;
+    }
+    // 3. First active Owner user with a real email
+    const ownerUser = activeUsers.find((u) => u.Email?.trim().toLowerCase() !== 'not.set@nowhere.com' &&
+        u.Type?.trim().toLowerCase() === 'owner');
+    if (ownerUser) {
+        return ownerUser;
+    }
+    return activeUsers[0] ?? null;
+}
+/**
+ * Mints a signed RS256 local-dev JWT for the given `UserInfo`.
+ */
+export function MintLocalDevJwt(user, publicUrl, ttlSeconds = 8 * 3600) {
+    AssertLocalDevAuthAllowed();
+    MagicLinkKeyManager.Instance.Initialize(configInfo.magicLink?.rsaPrivateKey);
+    const base = publicUrl ? TrimTrailingSlashes(publicUrl) : undefined;
+    const issuer = base ? `${base}/local-dev` : ApiRoute('/local-dev', { absolute: true });
+    const nowSeconds = Math.floor(Date.now() / 1000);
+    const expSeconds = nowSeconds + ttlSeconds;
+    const firstName = user.FirstName?.trim() || 'Admin';
+    const lastName = user.LastName?.trim() || 'User';
+    const fullName = [user.FirstName?.trim(), user.LastName?.trim()].filter(Boolean).join(' ') ||
+        user.Name?.trim() ||
+        user.Email;
+    const claims = {
+        iss: issuer,
+        aud: LocalDevProvider.DEFAULT_AUDIENCE,
+        sub: `local-dev|${user.ID}`,
+        email: user.Email,
+        given_name: firstName,
+        family_name: lastName,
+        name: fullName,
+        preferred_username: user.Email,
+        iat: nowSeconds,
+        exp: expSeconds,
+    };
+    const token = MagicLinkKeyManager.Instance.Sign(claims);
+    return {
+        token,
+        expiresAt: new Date(expSeconds * 1000).toISOString(),
+        claims,
+    };
+}
+/**
+ * Attaches `/dev-login` and `/dev-users` routes onto the `/auth` router.
+ *
+ * When local dev auth is disabled, these routes respond with `404`.
+ * When enabled, every request is gated by {@link VerifyLocalhostRequest}.
+ */
+export function AttachLocalDevAuthRoutes(router) {
+    const devAuthLimiter = rateLimit({
+        windowMs: 60_000,
+        limit: 60,
+        standardHeaders: 'draft-7',
+        legacyHeaders: false,
+    });
+    router.post('/dev-login', devAuthLimiter, json(), async (req, res) => {
+        if (!IsLocalDevAuthEnabled()) {
+            res.status(404).json({
+                success: false,
+                error: 'Local dev auth is not enabled. Set MJ_DEV_AUTH_ENABLED=true in local development.',
+            });
+            return;
+        }
+        const guard = VerifyLocalhostRequest(req);
+        if (!guard.Allowed) {
+            LogError(`[SECURITY] Blocked /auth/dev-login request: ${guard.Reason}`);
+            res.status(403).json({
+                success: false,
+                error: 'Forbidden: /auth/dev-login is restricted to localhost only.',
+            });
+            return;
+        }
+        try {
+            RegisterLocalDevAuthProvider();
+            const body = (req.body ?? {});
+            const requestedEmail = typeof body.email === 'string' ? body.email.trim() : undefined;
+            const user = await ResolveLocalDevUser(requestedEmail);
+            if (!user) {
+                const availableEmails = (UserCache.Instance.Users ?? [])
+                    .filter((u) => u.IsActive && !UUIDsEqual(u.ID, UserCache.Instance.SYSTEM_USER_ID))
+                    .map((u) => u.Email);
+                res.status(404).json({
+                    success: false,
+                    error: requestedEmail
+                        ? `No active MJ user found matching email '${requestedEmail}'.`
+                        : 'No active non-System MJ user found in UserCache.',
+                    availableUsers: availableEmails,
+                });
+                return;
+            }
+            const { token, expiresAt, claims } = MintLocalDevJwt(user);
+            res.set('Cache-Control', 'no-store');
+            res.status(200).json({
+                success: true,
+                token,
+                expiresAt,
+                user: {
+                    id: user.ID,
+                    email: user.Email,
+                    name: claims.name,
+                    firstName: claims.given_name,
+                    lastName: claims.family_name,
+                    roles: (user.UserRoles ?? []).map((r) => r.Role),
+                },
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            LogError(`[LocalDevAuth] /auth/dev-login error: ${message}`);
+            res.status(500).json({
+                success: false,
+                error: message,
+            });
+        }
+    });
+    router.get('/dev-users', devAuthLimiter, async (req, res) => {
+        if (!IsLocalDevAuthEnabled()) {
+            res.status(404).json({
+                success: false,
+                error: 'Local dev auth is not enabled.',
+            });
+            return;
+        }
+        const guard = VerifyLocalhostRequest(req);
+        if (!guard.Allowed) {
+            LogError(`[SECURITY] Blocked /auth/dev-users request: ${guard.Reason}`);
+            res.status(403).json({
+                success: false,
+                error: 'Forbidden: /auth/dev-users is restricted to localhost only.',
+            });
+            return;
+        }
+        const users = (UserCache.Instance.Users ?? [])
+            .filter((u) => u.IsActive && !UUIDsEqual(u.ID, UserCache.Instance.SYSTEM_USER_ID) && u.Name?.trim().toLowerCase() !== 'system')
+            .map((u) => ({
+            id: u.ID,
+            email: u.Email,
+            name: u.Name,
+            firstName: u.FirstName,
+            lastName: u.LastName,
+            type: u.Type,
+            roles: (u.UserRoles ?? []).map((r) => r.Role),
+        }));
+        res.set('Cache-Control', 'no-store');
+        res.status(200).json({ success: true, users });
+    });
+}
+//# sourceMappingURL=localDevAuth.js.map

package/dist/auth/localDevAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localDevAuth.js","sourceRoot":"","sources":["../../src/auth/localDevAuth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAU,IAAI,EAA+B,MAAM,SAAS,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAIL,QAAQ,EACR,WAAW,EACX,QAAQ,GAET,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAE5F,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,CAAC;AAsB5D,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AAEhF,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,OAAO,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QACnD,GAAG,EAAE,CAAC;IACR,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAyB,EAAE,iBAA0B;IACrF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACtE,IAAI,UAAU,KAAK,WAAW,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;QACrF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,kCAAkC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,iBAAiB,EAAE,CAAC;QACtB,4EAA4E;QAC5E,yEAAyE;QACzE,2DAA2D;QAC3D,IAAI,yBAAyB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,wCAAwC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,wBAAwB,CAAC,GAAsB;IACtD,IAAI,GAAG,CAAC,+BAA+B,KAAK,MAAM,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,CAAC,+BAA+B,KAAK,OAAO,EAAE,CAAC;QACpD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAC7E,CAAC;AAED,gFAAgF;AAChF,SAAS,6BAA6B,CAAC,UAA8B;IACnE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,OAAO,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9D,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,OAAO,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9D,CAAC;AAED,sEAAsE;AACtE,SAAS,4BAA4B,CAAC,SAAiB;IACrD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAY,EACZ,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,YAAY,EAAE,CAAC;QACxD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,gEAAgE;SACzE,CAAC;IACJ,CAAC;IAED,qHAAqH;IACrH,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACnE,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;gBACnC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,yCAAyC,GAAG,aAAa;iBAClE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,WAAW,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAU,EAAE,CAAC;QACrE,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtE,IAAI,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC;YACrF,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,gBAAgB,WAAW,aAAa,SAAS,aAAa;aACvE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;IAClG,IAAI,YAAY,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CAAC;QAC3E,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;YACpD,IAAI,WAAW,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC;gBAC1D,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,mCAAmC,WAAW,aAAa;iBACpE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,MAAM,YAAY,GAAG,OAAO,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACxI,IAAI,YAAY,KAAK,YAAY,EAAE,CAAC;QAClC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,uCAAuC,YAAY,aAAa;SACzE,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,MAAM,UAAU,GAAG,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC1F,MAAM,QAAQ,GAAG,6BAA6B,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,CAAC,QAAQ,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,8BAA8B,UAAU,IAAI,SAAS,aAAa;SAC3E,CAAC;IACJ,CAAC;IAED,sCAAsC;IACtC,MAAM,YAAY,GAAG,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7F,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,UAAU,GAAG,4BAA4B,CAAC,YAAY,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACxD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,gCAAgC,YAAY,aAAa;aAClE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,MAAM,aAAa,GAAG,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAChG,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,WAAW,GAAG,4BAA4B,CAAC,aAAa,CAAC,CAAC;QAChE,IAAI,CAAC,WAAW,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,iCAAiC,aAAa,aAAa;aACpE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,+HAA+H;IAC/H,MAAM,cAAc,GAAG,OAAO,CAC5B,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;QACxC,CAAC,YAAY,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;QAChD,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC;QACxB,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAChC,CAAC;IACF,MAAM,iBAAiB,GAAG,CAAC,cAAc,IAAI,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC3E,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,IAAI,GAAG,CAAC,EAAE,CAAC;IAC1D,IAAI,CAAC,iBAAiB,CAAC,aAAa,EAAE,iBAAiB,CAAC,EAAE,CAAC;QACzD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,uCAAuC,aAAa,IAAI,SAAS,aAAa;SACvF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,SAAkB;IAC7D,yBAAyB,EAAE,CAAC;IAC5B,mBAAmB,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAE7E,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACvF,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,oBAAoB,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7G,MAAM,cAAc,GAAuB;QACzC,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,OAAO;QACb,MAAM;QACN,QAAQ,EAAE,gBAAgB,CAAC,gBAAgB;QAC3C,OAAO;KACR,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC;QAC7C,MAAM,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,KAAK,MAAM,IAAI,gBAAgB,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YACnG,OAAO;QACT,CAAC;QAED,UAAU,CAAC,aAAa,GAAG,UAAU,CAAC,aAAa,IAAI,EAAE,CAAC;QAC1D,MAAM,WAAW,GAAG,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QACxG,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;YACrB,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,GAAG,cAAc,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC;QACrE,WAAW,CAAC;YACV,OAAO,EAAE,8DAA8D,cAAc,CAAC,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG;YAChI,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,QAAQ,CAAC,8DAA8D,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACvH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,cAAuB,EACvB,QAA4B;IAE5B,MAAM,iBAAiB,GAAG,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;IACxD,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAC9F,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAyC,CAAC,CAAC;QAC9E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,+CAA+C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9G,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;IAChD,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CACjC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,QAAQ;QACV,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC;QACpD,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,QAAQ,CAC5C,CAAC;IAEF,MAAM,WAAW,GACf,cAAc,EAAE,IAAI,EAAE;QACtB,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,EAAE;QAC7C,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC5C,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;QACrG,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,gFAAgF;QAChF,IAAI,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,0BAA0B,CAAC,CAAC;IAC3G,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,kDAAkD;IAClD,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CACpC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,qBAAqB;QACvD,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,CACzE,CAAC;IACF,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,+CAA+C;IAC/C,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,qBAAqB;QACvD,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,OAAO,CAC3C,CAAC;IACF,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAc,EACd,SAAkB,EAClB,UAAU,GAAG,CAAC,GAAG,IAAI;IAErB,yBAAyB,EAAE,CAAC;IAC5B,mBAAmB,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAE7E,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACvF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC;IACjD,MAAM,QAAQ,GACZ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACzE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE;QACjB,IAAI,CAAC,KAAK,CAAC;IAEb,MAAM,MAAM,GAAsB;QAChC,GAAG,EAAE,MAAM;QACX,GAAG,EAAE,gBAAgB,CAAC,gBAAgB;QACtC,GAAG,EAAE,aAAa,IAAI,CAAC,EAAE,EAAE;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,QAAQ;QACrB,IAAI,EAAE,QAAQ;QACd,kBAAkB,EAAE,IAAI,CAAC,KAAK;QAC9B,GAAG,EAAE,UAAU;QACf,GAAG,EAAE,UAAU;KAChB,CAAC;IAEF,MAAM,KAAK,GAAG,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxD,OAAO;QACL,KAAK;QACL,SAAS,EAAE,IAAI,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;QACpD,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,MAAM,cAAc,GAAG,SAAS,CAAC;QAC/B,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,EAAE;QACT,eAAe,EAAE,SAAS;QAC1B,aAAa,EAAE,KAAK;KACrB,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACtF,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;YAC7B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,mFAAmF;aAC3F,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,QAAQ,CAAC,+CAA+C,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACxE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,6DAA6D;aACrE,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,4BAA4B,EAAE,CAAC;YAE/B,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAuB,CAAC;YACpD,MAAM,cAAc,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YACtF,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,cAAc,CAAC,CAAC;YAEvD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,eAAe,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;qBACrD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;qBACjF,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACvB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,cAAc;wBACnB,CAAC,CAAC,2CAA2C,cAAc,IAAI;wBAC/D,CAAC,CAAC,kDAAkD;oBACtD,cAAc,EAAE,eAAe;iBAChC,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;YACrC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,IAAI;gBACb,KAAK;gBACL,SAAS;gBACT,IAAI,EAAE;oBACJ,EAAE,EAAE,IAAI,CAAC,EAAE;oBACX,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,SAAS,EAAE,MAAM,CAAC,UAAU;oBAC5B,QAAQ,EAAE,MAAM,CAAC,WAAW;oBAC5B,KAAK,EAAE,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBACjD;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,QAAQ,CAAC,yCAAyC,OAAO,EAAE,CAAC,CAAC;YAC7D,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,OAAO;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAC7E,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;YAC7B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,gCAAgC;aACxC,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,QAAQ,CAAC,+CAA+C,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACxE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,6DAA6D;aACrE,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;aAC3C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC;aAC9H,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAC9C,CAAC,CAAC,CAAC;QAEN,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QACrC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/auth/loginEmailResolution.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Which email a verified login is matched to a User record by, and whether that differs from the
+ * identity the token carries.
+ *
+ * The server links a login to a User row by email alone. `USER_EMAIL_MAP` can rewrite that email
+ * before the lookup, which makes a login run as a different person's record. That is a legitimate
+ * development aid, but it is silent, so a misconfigured map on a shared machine looks exactly like
+ * an authentication bug. These helpers keep the token's identity next to the one actually used, so
+ * the session audit and the server log can say when the two differ.
+ */
+/** The identity fields of a verified token that the lookup can use. */
+export interface LoginIdentityClaims {
+    email?: string;
+    preferredUsername?: string;
+}
+/** The email the token carries and the email the User lookup will use. */
+export interface LoginEmailResolution {
+    /** The identity from the verified token: its email claim, or its preferred username when it has none. */
+    TokenEmail: string | undefined;
+    /** The email the User record is looked up by, after any `USER_EMAIL_MAP` rewrite. */
+    LookupEmail: string | undefined;
+    /** True when `USER_EMAIL_MAP` replaced the token's email with a different one. */
+    Remapped: boolean;
+}
+/**
+ * Resolves the lookup email for a verified token. The map applies only to the email claim, with an
+ * exact (case-sensitive) key match, as it always has; a preferred username is never remapped.
+ *
+ * Named without "login"/"auth"/"verify": CodeQL treats calls with those words as authentication
+ * actions and reports the `if (!token)` guard above this call in GetUserPayload as a user-controlled
+ * bypass. This is a plain lookup, not an authentication step.
+ */
+export declare function ResolveUserLookupEmail(claims: LoginIdentityClaims, emailMap: Record<string, string> | undefined): LoginEmailResolution;
+/** Case-insensitive, whitespace-trimmed comparison, matching how the User lookup compares emails. */
+export declare function EmailsMatch(a: string | undefined, b: string | undefined): boolean;
+/**
+ * The startup warning for a configured `USER_EMAIL_MAP`, or null when the map is absent or rewrites
+ * nothing. Lists every entry so whoever starts the server can see whose record each login will use.
+ */
+export declare function DescribeUserEmailMap(emailMap: Record<string, string> | undefined): string | null;
+//# sourceMappingURL=loginEmailResolution.d.ts.map

package/dist/auth/loginEmailResolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loginEmailResolution.d.ts","sourceRoot":"","sources":["../../src/auth/loginEmailResolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,yGAAyG;IACzG,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,qFAAqF;IACrF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,kFAAkF;IAClF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,oBAAoB,CAOtI;AAED,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAKjF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAUhG"}