familysync/apps/api/tests/routes/me.test.ts

/**
 * GET /api/me — regression tests for dev-auth bypass path.
 *
 * Covers:
 *   1. DEV_AUTH_BYPASS=true (non-production): GET /api/me returns 200 with the injected
 *      DEV_USER identity (id=1, displayName='Dev User', color='#4A90D9').
 *      The OIDC guard must NOT be enforced — no Authelia env vars needed.
 *   2. Without DEV_AUTH_BYPASS: the OIDC middleware is still wired on /api/*.
 *      Verified structurally by asserting oidcAuthMiddleware is called during app init
 *      (the mock intercepts it and acts as a passthrough, confirming the mount path).
 *
 * Architecture note:
 *   devAuthBypass() and devBypassActive in index.ts both evaluate env vars at module
 *   load time. Tests must set process.env BEFORE importing the app module.
 *   vitest.resetModules() ensures each test gets a fresh module registry.
 */

import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';

// ---------------------------------------------------------------------------
// Shared mock: DB — avoids real DB connections across all tests in this file.
// This mock is hoisted by Vitest and applies to every dynamic import below.
// ---------------------------------------------------------------------------
vi.mock('../../src/db/client.js', () => ({
  db: {
    execute: vi.fn().mockResolvedValue([[{ '1': 1 }]]),
    select: vi.fn().mockReturnValue({
      from: vi.fn().mockReturnValue({
        where: vi.fn().mockResolvedValue([]),
        innerJoin: vi.fn().mockReturnValue({
          innerJoin: vi.fn().mockReturnValue({
            where: vi.fn().mockResolvedValue([]),
          }),
        }),
      }),
    }),
  },
}));

// ---------------------------------------------------------------------------
// Track whether oidcAuthMiddleware was registered on the app.
// The spy is set up fresh per test via beforeEach/afterEach.
// ---------------------------------------------------------------------------
const oidcMiddlewareSpy = vi.fn(() => async (_c: unknown, next: () => Promise<void>) => next());

vi.mock('@hono/oidc-auth', () => ({
  oidcAuthMiddleware: () => oidcMiddlewareSpy(),
  processOAuthCallback: () => async (c: { json: (v: unknown) => unknown }) => c.json({ ok: true }),
  getAuth: vi.fn().mockResolvedValue(null),
}));

// ---------------------------------------------------------------------------
// Env snapshot — restored after each test to avoid cross-test pollution.
// ---------------------------------------------------------------------------
const originalNodeEnv = process.env.NODE_ENV;
const originalBypassFlag = process.env.DEV_AUTH_BYPASS;

afterEach(() => {
  process.env.NODE_ENV = originalNodeEnv;
  if (originalBypassFlag === undefined) {
    delete process.env.DEV_AUTH_BYPASS;
  } else {
    process.env.DEV_AUTH_BYPASS = originalBypassFlag;
  }
  vi.resetModules();
  oidcMiddlewareSpy.mockClear();
});

// ---------------------------------------------------------------------------

describe('GET /api/me — dev-auth bypass (DEV_AUTH_BYPASS=true)', () => {
  beforeEach(() => {
    process.env.NODE_ENV = 'test';
    process.env.DEV_AUTH_BYPASS = 'true';
  });

  it('returns 200 with the injected dev user identity', async () => {
    // Import AFTER setting env — index.ts reads env at module load time.
    const { app } = await import('../../src/index.js');
    const { DEV_USER } = await import('../../src/auth/devBypass.js');

    const res = await app.request('/api/me');
    expect(res.status).toBe(200);

    const body = (await res.json()) as { user: { id: number; displayName: string; color: string } };
    expect(body).toHaveProperty('user');
    expect(body.user.id).toBe(DEV_USER.id);
    expect(body.user.displayName).toBe(DEV_USER.displayName);
    expect(body.user.color).toBe(DEV_USER.color);
  });

  it('returns id=1 and color=#4A90D9 (first palette slot)', async () => {
    const { app } = await import('../../src/index.js');

    const res = await app.request('/api/me');
    expect(res.status).toBe(200);

    const body = (await res.json()) as { user: { id: number; color: string } };
    expect(body.user.id).toBe(1);
    expect(body.user.color).toBe('#4A90D9');
  });

  it('does not invoke oidcAuthMiddleware on /api/* when bypass is active', async () => {
    const { app } = await import('../../src/index.js');

    // Hit any /api/* route to trigger the middleware stack.
    await app.request('/api/me');

    // oidcAuthMiddleware() factory must NOT have been called — index.ts skips it.
    expect(oidcMiddlewareSpy).not.toHaveBeenCalled();
  });
});

describe('GET /api/me — OIDC path (no DEV_AUTH_BYPASS)', () => {
  beforeEach(() => {
    process.env.NODE_ENV = 'test';
    delete process.env.DEV_AUTH_BYPASS;
  });

  it('wires oidcAuthMiddleware on /api/* when bypass is not active', async () => {
    // Import app — devBypassActive will be false, so oidcAuthMiddleware() is called
    // during app construction (index.ts registers it via app.use('/api/*', ...)).
    await import('../../src/index.js');

    // The spy wraps the oidcAuthMiddleware() factory call in index.ts.
    // It must have been called exactly once (one app.use registration).
    expect(oidcMiddlewareSpy).toHaveBeenCalledTimes(1);
  });

  it('returns 401 when no OIDC session is present (getAuth returns null)', async () => {
    const { app } = await import('../../src/index.js');

    // oidcAuthMiddleware is mocked as a passthrough; getAuth is mocked to return null.
    // me.ts falls through to the getAuth path and returns 401.
    const res = await app.request('/api/me');
    expect(res.status).toBe(401);
    const body = (await res.json()) as { error: string };
    expect(body.error).toBe('Unauthorized');
  });
});