import { describe, it, expect, beforeEach, afterEach, vi, type Mock } from 'vitest' import { createMockSupabase, createMockRequest, parseJsonResponse } from '@/tests/helpers' import type { ExtensionContext } from '@/lib/extensions/types' /** * Locks the tenant boundary on the unauthenticated OAuth callback * (GET /callback, skipAuth: true). * * The callback used to decode `state` as plain base64url JSON and trust * `consentId` / `provider` straight out of it. Nothing was signed and no * server-side session row was checked, so anyone who learned a victim's consent * id (it is handed to the browser in the success redirect and postMessage) * could run OAuth against their OWN provider account and call the callback with * `state=base64url({consentId: victim})`. The attacker's provider tokens landed * on the victim's consent, and the victim's next migration imported the * attacker's ledger. * * The callback now resolves everything from a server-written provider_otc row * that it consumes atomically. These tests pin that: nothing from the query * string reaches exchangeAuthToken, and every state failure looks identical * from outside. */ vi.mock('../lib/migration-orchestrator', () => ({ executeMigration: vi.fn().mockResolvedValue({}), })) // index.ts imports many helpers from provider-client at module load; stub the // whole module. The two error classes are real classes because index.ts // branches on `instanceof`. vi.mock('../lib/provider-client', () => ({ createConsent: vi.fn(), getConsent: vi.fn(), listConsents: vi.fn(), generateOtc: vi.fn(), consumeOAuthState: vi.fn(), getAuthUrl: vi.fn(), exchangeAuthToken: vi.fn(), submitProviderToken: vi.fn(), acceptConsent: vi.fn(), deleteConsent: vi.fn(), resolveConsent: vi.fn(), fetchCompanyInfoDirect: vi.fn(), ProviderTokenInvalidError: class ProviderTokenInvalidError extends Error {}, ConsentNotFoundError: class ConsentNotFoundError extends Error {}, })) // The /connect handler unconditionally imports this module (for its // pending-consent token check); the real one pulls in next/headers. vi.mock('@/lib/supabase/server', () => ({ createClient: vi.fn(), createServiceClient: vi.fn(), })) import { arcimMigrationExtension } from '../index' import { consumeOAuthState, exchangeAuthToken, getConsent, createConsent, listConsents, generateOtc, getAuthUrl, ConsentNotFoundError, } from '../lib/provider-client' type RouteHandler = (request: Request, ctx?: ExtensionContext) => Promise const findRoute = (method: string, path: string) => (arcimMigrationExtension.apiRoutes ?? []).find( (r) => r.method === method && r.path === path, )! const callbackHandler = findRoute('GET', '/callback').handler as RouteHandler const previewHandler = findRoute('GET', '/preview').handler as RouteHandler const APP_URL = 'https://app.example.test' /** The exact string the callback shows for every state failure. */ const GENERIC_REJECTION = 'Ingen giltig migrationssession hittades' function callbackRequest(params: Record) { return createMockRequest( 'http://localhost/api/extensions/ext/arcim-migration/callback', { searchParams: params }, ) } /** The forged payload the old implementation would have trusted. */ function forgedLegacyState(consentId: string, provider: string) { return Buffer.from(JSON.stringify({ consentId, provider })).toString('base64url') } describe('GET /callback: OAuth state binding', () => { beforeEach(() => { vi.clearAllMocks() vi.stubEnv('NEXT_PUBLIC_APP_URL', APP_URL) // The exchange redirect_uri now consults the per-provider override; keep // these tests on the NEXT_PUBLIC_APP_URL fallback regardless of local env. vi.stubEnv('FORTNOX_REDIRECT_URI', '') vi.stubEnv('VISMA_REDIRECT_URI', '') // The callback route is dispatched without an ExtensionContext (skipAuth // routes get no ctx), so console is the logger. Keep the output quiet. vi.spyOn(console, 'error').mockImplementation(() => {}) }) afterEach(() => { vi.unstubAllEnvs() vi.restoreAllMocks() }) it('rejects a forged state: an unknown token never reaches token exchange', async () => { ;(consumeOAuthState as Mock).mockResolvedValue(null) const res = await callbackHandler( callbackRequest({ code: 'provider-auth-code', state: forgedLegacyState('victim-consent-id', 'fortnox'), }), ) const html = await res.text() expect(exchangeAuthToken).not.toHaveBeenCalled() expect(html).toContain(GENERIC_REJECTION) // The response must not echo anything the attacker put in the state. expect(html).not.toContain('victim-consent-id') }) it('rejects an expired state with the same generic message as a forged one', async () => { // consumeOAuthState collapses expired into "no row": the expiry predicate // lives in the UPDATE's WHERE clause (see provider-client tests). ;(consumeOAuthState as Mock).mockResolvedValue(null) const res = await callbackHandler( callbackRequest({ code: 'provider-auth-code', state: 'expired-token' }), ) const html = await res.text() expect(exchangeAuthToken).not.toHaveBeenCalled() expect(html).toContain(GENERIC_REJECTION) }) it('rejects a replayed state: the second callback with the same token fails', async () => { // First delivery consumes the row, second finds nothing left to consume. ;(consumeOAuthState as Mock) .mockResolvedValueOnce({ consentId: 'consent-1', provider: 'fortnox' }) .mockResolvedValueOnce(null) const first = await callbackHandler( callbackRequest({ code: 'provider-auth-code', state: 'one-time-token' }), ) const second = await callbackHandler( callbackRequest({ code: 'provider-auth-code', state: 'one-time-token' }), ) expect(await first.text()).toContain('Anslutningen lyckades') expect(await second.text()).toContain(GENERIC_REJECTION) // Exactly one exchange: the replay bought the attacker nothing. expect(exchangeAuthToken).toHaveBeenCalledTimes(1) expect(consumeOAuthState).toHaveBeenNthCalledWith(1, 'one-time-token') expect(consumeOAuthState).toHaveBeenNthCalledWith(2, 'one-time-token') }) it('takes consent and provider from the state ROW, never from the query string', async () => { ;(consumeOAuthState as Mock).mockResolvedValue({ consentId: 'consent-owned-by-caller', provider: 'visma', }) // The token names a different consent and provider. It must be ignored: // the row wins. const res = await callbackHandler( callbackRequest({ code: 'provider-auth-code', state: forgedLegacyState('victim-consent-id', 'fortnox'), }), ) expect(exchangeAuthToken).toHaveBeenCalledTimes(1) expect(exchangeAuthToken).toHaveBeenCalledWith( 'consent-owned-by-caller', 'visma', 'provider-auth-code', `${APP_URL}/api/extensions/ext/arcim-migration/callback`, ) expect(await res.text()).toContain('consent-owned-by-caller') }) }) /** * The callback's no-opener arm used to be near-dead: the wizard only ever * reached this route through a popup, which always has a window.opener. * ArcimMigrationWorkspace now falls back to a full-page OAuth flow when the * popup is blocked (a discarded window.open return value made a blocked popup * look exactly like a successful one), so that arm is a live user path and the * only way a popup-blocked user finishes the migration. * * These pin the URL it navigates to, because the wizard reads it on the other * end: `/import?migration=...` sets mode='migration' * (app/(dashboard)/import/page.tsx:1990) and handleOAuthReturn consumes * `consentId` / `reason` from there. Dropping the arm, or renaming a param, * would strand every popup-blocked user on this HTML page. */ describe('GET /callback: full-page fallback when there is no opener', () => { beforeEach(() => { vi.clearAllMocks() vi.stubEnv('NEXT_PUBLIC_APP_URL', APP_URL) vi.spyOn(console, 'error').mockImplementation(() => {}) }) afterEach(() => { vi.unstubAllEnvs() vi.restoreAllMocks() }) /** The URL the page navigates to when window.opener is absent. */ function fallbackNavigation(html: string): URL { // Both arms are emitted; the opener arm postMessages instead of navigating. expect(html).toContain('window.opener') const match = html.match(/window\.location\.href = "([^"]+)"/) expect(match, 'callback HTML has no no-opener navigation').not.toBeNull() return new URL(match![1]) } it('sends a successful connect back to the wizard with the consent id', async () => { ;(consumeOAuthState as Mock).mockResolvedValue({ consentId: 'consent-1', provider: 'fortnox', }) const res = await callbackHandler( callbackRequest({ code: 'provider-auth-code', state: 'one-time-token' }), ) const target = fallbackNavigation(await res.text()) expect(target.origin).toBe(APP_URL) expect(target.pathname).toBe('/import') expect(target.searchParams.get('migration')).toBe('connected') expect(target.searchParams.get('consentId')).toBe('consent-1') }) it('sends a failure back to the wizard with the reason attached', async () => { ;(consumeOAuthState as Mock).mockResolvedValue(null) const res = await callbackHandler( callbackRequest({ code: 'provider-auth-code', state: 'forged-token' }), ) const target = fallbackNavigation(await res.text()) expect(target.pathname).toBe('/import') expect(target.searchParams.get('migration')).toBe('error') expect(target.searchParams.get('reason')).toContain(GENERIC_REJECTION) }) }) /** * The redirect_uri sent in the authorization request and the one sent in the * token exchange must be byte-identical (RFC 6749 ยง4.1.3) or the provider * rejects the code exchange. These broke apart once already: the authorize leg * honored the FORTNOX_REDIRECT_URI override while the exchange hardcoded the * NEXT_PUBLIC_APP_URL fallback, so when the app moved to app.accounted.se and * the env var still pointed at app.gnubok.se, every Fortnox connect died at * the exchange with no visible error (the error postMessage was then dropped * by the opener's origin check). Both legs now resolve through * resolveArcimCallbackUrl; these tests pin the symmetry. */ describe('OAuth redirect_uri symmetry between authorize and exchange', () => { const OVERRIDE_URI = 'https://dev-tunnel.example.test/api/extensions/ext/arcim-migration/callback' const connectHandler = findRoute('POST', '/connect').handler as RouteHandler function connectCtx(): ExtensionContext { const { supabase } = createMockSupabase() ;(supabase as unknown as { auth: unknown }).auth = { getUser: vi.fn().mockResolvedValue({ data: { user: { id: 'user-1' } } }), } return { supabase, companyId: 'company-1' } as unknown as ExtensionContext } beforeEach(() => { vi.clearAllMocks() vi.stubEnv('NEXT_PUBLIC_APP_URL', APP_URL) vi.stubEnv('FORTNOX_REDIRECT_URI', OVERRIDE_URI) vi.spyOn(console, 'error').mockImplementation(() => {}) ;(listConsents as Mock).mockResolvedValue([]) ;(createConsent as Mock).mockResolvedValue({ id: 'consent-new' }) ;(generateOtc as Mock).mockResolvedValue({ code: 'otc-code-1' }) ;(getAuthUrl as Mock).mockResolvedValue({ url: 'https://apps.fortnox.se/oauth-v1/auth?x=1' }) }) afterEach(() => { vi.unstubAllEnvs() vi.restoreAllMocks() }) it('authorize leg passes the env-override redirect URI to getAuthUrl', async () => { const res = await connectHandler( createMockRequest('http://localhost/api/extensions/ext/arcim-migration/connect', { method: 'POST', body: { provider: 'fortnox' }, }), connectCtx(), ) expect(res.status).toBe(200) expect(getAuthUrl).toHaveBeenCalledWith('fortnox', 'otc-code-1', OVERRIDE_URI) }) it('exchange leg passes the SAME env-override redirect URI to exchangeAuthToken', async () => { ;(consumeOAuthState as Mock).mockResolvedValue({ consentId: 'consent-new', provider: 'fortnox', }) await callbackHandler( callbackRequest({ code: 'provider-auth-code', state: 'one-time-token' }), ) expect(exchangeAuthToken).toHaveBeenCalledWith( 'consent-new', 'fortnox', 'provider-auth-code', OVERRIDE_URI, ) }) }) /** * The error page must stay open: its postMessage is dropped whenever the * popup's origin differs from the opener's, and a window.close() right after * turns that into "I approve in Fortnox and then nothing happens". The success * page still closes itself. */ describe('GET /callback: error popup stays open, success popup closes', () => { beforeEach(() => { vi.clearAllMocks() vi.stubEnv('NEXT_PUBLIC_APP_URL', APP_URL) vi.spyOn(console, 'error').mockImplementation(() => {}) }) afterEach(() => { vi.unstubAllEnvs() vi.restoreAllMocks() }) it('keeps the error popup open with the reason visible', async () => { ;(consumeOAuthState as Mock).mockResolvedValue(null) const res = await callbackHandler( callbackRequest({ code: 'provider-auth-code', state: 'bad-token' }), ) const html = await res.text() expect(html).toContain('Anslutningen misslyckades') expect(html).not.toContain('window.close') }) it('still closes the success popup', async () => { ;(consumeOAuthState as Mock).mockResolvedValue({ consentId: 'consent-1', provider: 'fortnox', }) const res = await callbackHandler( callbackRequest({ code: 'provider-auth-code', state: 'one-time-token' }), ) const html = await res.text() expect(html).toContain('Anslutningen lyckades') expect(html).toContain('window.close()') }) }) describe('GET /preview: cross-tenant consent status oracle', () => { beforeEach(() => { vi.clearAllMocks() vi.spyOn(console, 'error').mockImplementation(() => {}) }) afterEach(() => { vi.restoreAllMocks() }) function buildCtx(): ExtensionContext { const { supabase } = createMockSupabase() ;(supabase as unknown as { auth: unknown }).auth = { getUser: vi.fn().mockResolvedValue({ data: { user: { id: 'user-1' } } }), } return { supabase, companyId: 'company-1' } as unknown as ExtensionContext } it('scopes the consent read to the caller company', async () => { ;(getConsent as Mock).mockResolvedValue({ id: 'consent-1', status: 5, provider: 'fortnox' }) await previewHandler( createMockRequest('http://localhost/api/extensions/ext/arcim-migration/preview', { searchParams: { consentId: 'consent-1' }, }), buildCtx(), ) expect(getConsent).toHaveBeenCalledWith('consent-1', 'company-1') }) it('answers 404 without a status for a consent owned by another company', async () => { ;(getConsent as Mock).mockRejectedValue(new ConsentNotFoundError()) const res = await previewHandler( createMockRequest('http://localhost/api/extensions/ext/arcim-migration/preview', { searchParams: { consentId: 'other-tenants-consent' }, }), buildCtx(), ) const { status, body } = await parseJsonResponse<{ error: { code: string; details?: Record } }>(res) expect(status).toBe(404) expect(body.error.code).toBe('PROVIDER_CONSENT_NOT_FOUND') // No consent state may leak: not the numeric status, not the provider. // 404 with no state is exactly what a nonexistent consent returns too. expect(body.error.details ?? {}).not.toHaveProperty('status') expect(body.error.details ?? {}).not.toHaveProperty('provider') }) })