100 lines
4.4 KiB
TypeScript
100 lines
4.4 KiB
TypeScript
/**
|
|
* Playwright 인증 fixture (코어 영역).
|
|
*
|
|
* `php artisan playwright:issue-token` 커맨드를 호출하여 Sanctum 토큰을 발급하고,
|
|
* 브라우저 페이지의 localStorage 에 주입해 G7Core 부트스트랩 시 자동 인증되도록 한다.
|
|
*
|
|
* 환경 가드 (PlaywrightIssueToken 3중 가드 통과 조건):
|
|
* ① CLI 한정 — `php_sapi_name() === 'cli'` (execSync 호출이므로 자동 충족)
|
|
* ② G7_PLAYWRIGHT_BYPASS=1 환경변수 — 본 헬퍼가 자동 부착
|
|
* ③ APP_DEBUG=true 강제 — 커맨드 내부에서 inline override
|
|
*
|
|
* `--env=testing` 옵션은 부착하지 않는다. 이는 호출자가 활성 환경의 DB 에 토큰을 발급할 수 있도록
|
|
* 하기 위함이다 (예: PLAYWRIGHT_BASE_URL 이 production 호스트를 가리키면 production DB 에,
|
|
* testing 호스트를 가리키면 testing DB 에 토큰 발급).
|
|
*
|
|
* 확장(모듈/플러그인/템플릿) 은 본 모듈에서 `issueToken` / `authenticatePage` 헬퍼만 import 하여
|
|
* 자체 fixture 를 구성한다. 권한 식별자는 임의 string 이므로 코어/모듈/플러그인 공통 API.
|
|
*/
|
|
import { test as base, type Page } from '@playwright/test';
|
|
import { execSync } from 'node:child_process';
|
|
|
|
/**
|
|
* 임의 권한 식별자(코어/모듈/플러그인) 로 Sanctum 토큰을 발급한다.
|
|
*
|
|
* @param permissions 권한 식별자 가변 인자 (예: 'core.templates.layouts.edit')
|
|
* @returns 발급된 plainText Sanctum 토큰 (커맨드 stdout 의 마지막 비어있지 않은 줄)
|
|
*/
|
|
export function issueToken(...permissions: string[]): string {
|
|
const args = permissions.map((p) => `--permissions=${p}`).join(' ');
|
|
const command = `php artisan playwright:issue-token ${args}`.trim();
|
|
// 다수 워커가 동시에 PHP 아티즌을 부팅하면 일시적 부팅 경합으로 커맨드가
|
|
// 드물게 실패한다(테스트 정합성 문제 아님 — 토큰 발급 인프라의 병렬 부팅 경합).
|
|
// 짧은 백오프로 최대 3회 재시도해 6 워커 병렬에서도 안정화한다.
|
|
let lastError: unknown;
|
|
for (let attempt = 0; attempt < 3; attempt += 1) {
|
|
try {
|
|
const stdout = execSync(command, {
|
|
cwd: process.env.G7_ROOT || process.cwd(),
|
|
encoding: 'utf-8',
|
|
env: {
|
|
...process.env,
|
|
// PlaywrightIssueToken 의 ② 옵트인 가드를 통과시킨다.
|
|
// .env 영구 수정 없이 자식 프로세스에만 부여 — 운영 환경 격리 보존.
|
|
G7_PLAYWRIGHT_BYPASS: '1',
|
|
},
|
|
});
|
|
const lines = stdout.split(/\r?\n/).filter((line) => line.trim().length > 0);
|
|
if (lines.length === 0) {
|
|
throw new Error(`playwright:issue-token 가 빈 응답을 반환했습니다. 출력: ${JSON.stringify(stdout)}`);
|
|
}
|
|
return lines[lines.length - 1].trim();
|
|
} catch (error) {
|
|
lastError = error;
|
|
// 마지막 시도가 아니면 짧게 대기 후 재시도(동기 블로킹 — 경합 해소용).
|
|
// 자식 프로세스 spawn 없이 Atomics.wait 로 메인 스레드만 블로킹한다
|
|
// (sleep 커맨드를 execSync 하면 워커 teardown 이 그 자식에 묶여 hang).
|
|
if (attempt < 2) {
|
|
Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 400);
|
|
}
|
|
}
|
|
}
|
|
throw lastError instanceof Error ? lastError : new Error(String(lastError));
|
|
}
|
|
|
|
/**
|
|
* 브라우저 세션에 Sanctum 토큰을 주입한다.
|
|
*
|
|
* `page.goto` 호출 전에 실행해야 한다. `addInitScript` 는 모든 navigation 마다
|
|
* 동일하게 실행되므로 페이지 새로고침/이동 후에도 인증 상태가 유지된다.
|
|
*/
|
|
export async function authenticatePage(page: Page, token: string): Promise<void> {
|
|
await page.addInitScript((t) => {
|
|
localStorage.setItem('auth_token', t);
|
|
}, token);
|
|
}
|
|
|
|
/**
|
|
* 코어 권한 토큰 fixture.
|
|
*
|
|
* - editToken : core.templates.layouts.edit (위지윅 편집 권한)
|
|
* - readOnlyToken : core.templates.read (읽기 전용 — 편집 차단 검증용)
|
|
*
|
|
* 토큰은 spec 별로 lazy 발급되어 격리된 testRole 에 첨부된다 (uniqid 접미사).
|
|
*/
|
|
type AuthFixtures = {
|
|
editToken: string;
|
|
readOnlyToken: string;
|
|
};
|
|
|
|
export const test = base.extend<AuthFixtures>({
|
|
editToken: async ({}, use) => {
|
|
await use(issueToken('core.templates.layouts.edit'));
|
|
},
|
|
readOnlyToken: async ({}, use) => {
|
|
await use(issueToken('core.templates.read'));
|
|
},
|
|
});
|
|
|
|
export { expect } from '@playwright/test';
|