feat(core,extensions): 구동 에셋 자체 제공 · 자산 실패 폴백 · 운영자 추가 에셋(custom/)
공개 저장소 이슈 gnuboard/g7 (@bigmsg) 제보에서 출발한 작업이다. 브라우저가 화면을 그리려고 제3자 CDN 에 도달해야 하면, 그 도달 실패는 예외도 로그도 남기지 않고 화면 기능만 조용히 사라진다. 폐쇄망·방화벽·광고차단기에서 재현되는데 자체 서버 로그에는 흔적이 없어 운영자가 원인을 특정할 수 없다. 제보된 것은 편집기 하나였지만 같은 구조가 아이콘·글꼴·코드편집기·압축 라이브러리·설치 마법사·개발 대시보드에 똑같이 있었으므로, 번들 확장과 템플릿 전체를 자체 제공으로 옮겼다. 런타임에 외부로 나가는 것은 주소 검색 서비스 하나만 남았다. 자체 제공만으로는 부족하다 — 자기 서버에서 받는 파일도 실패할 수 있고, 종전에는 그 실패가 무음이었다. CSS 경로에 재시도 계층을 세우고(스크립트 경로와 동형), 서버가 HTML 에 직접 심는 externals 까지 실패를 붙잡아 안내 배너와 [다시 시도]로 표면화했다. 편집기·코드편집기는 확보 실패 시 평문 입력으로 내려앉되 저장 계약을 유지한다. 두 번째 축은 운영자가 CSS 를 덧붙일 자리가 없던 문제다(sir.kr 문의). 확장 디렉토리의 custom/ 을 운영자 소유로 정해, 확장 교체가 그 디렉토리만은 보존하게 했다. 출처에 의존하지 않는 서술자로 해석하므로 나중에 다른 출처가 붙어도 소비자는 바뀌지 않는다. 확장 자산과 같은 메커니즘으로 정적 게시되어 CSS 내부 상대 url 도 해석되고, 파일을 고치면 그 변경을 감지해 재게시까지 예약된다. FTP 접근이 없는 운영자에게는 그 자리도 없는 것과 같으므로 레이아웃 편집기에서 직접 넣고 고칠 수 있게 했다. 모듈·플러그인·템플릿이 한 엔드포인트를 공유한다 — 타입별로 나누면 같은 검증이 세 벌로 갈리고 그중 약한 하나가 우회로가 된다. 여기서 올린 스크립트는 그 레이아웃 한 장이 아니라 사이트 전 화면에서 실행되므로 레이아웃 편집과 분리된 전용 권한으로 연다. 운영자 CSS 가 화면을 조작 불능으로 만들면 그것을 고칠 화면에도 같은 CSS 가 실려 스스로 갇히므로, 서버가 목록을 비우는 탈출구(?custom=off)를 함께 뒀다. 동봉 자산은 재생성 경로에 버전 대조 가드를 붙였다. 선언과 다른 버전을 버전 디렉토리에 써 넣는 조용한 거짓말은 배포된 뒤에는 드러나지 않는다.
This commit is contained in:
1 parent
72f2e94c1a
commit
3945b6f1b3
1042 files changed
+107435
-947
No files matched your search
@@ -0,0 +1,187 @@
|
||||
/**
|
||||
* 설치 트리(`node_modules`)의 패키지 일부를 동봉 디렉토리(`dist/vendor/{lib}/{version}/`)로
|
||||
* 복사하는 생성기
|
||||
*
|
||||
* 하위 자산이 CSS 의 상대 `url()` 로 참조되는 라이브러리(flag-icons 등)는 인라인하지 않고
|
||||
* 파일을 그대로 동봉한다. 그 복사를 손으로 하면 어느 버전을 옮겼는지가 어디에도 남지 않아,
|
||||
* 설치 트리가 갱신된 뒤 다시 복사하는 순간 `7.2.3/` 디렉토리에 7.5.0 이 들어앉는다 —
|
||||
* 오류도 로그도 없이 배포본의 버전 라벨만 틀린다. 그래서 복사를 명령으로 고정하고,
|
||||
* 실행 전에 설치본 버전과 출력 경로의 선언 버전을 대조한다.
|
||||
*
|
||||
* 사용:
|
||||
* node scripts/vendor-copy.mjs <패키지 루트> <출력 디렉토리> <복사 대상...>
|
||||
*
|
||||
* 복사 대상은 패키지 루트 기준 상대 경로이며 파일·디렉토리 모두 가능하다. 출력 디렉토리의
|
||||
* 해당 항목은 복사 전에 지워 설치 트리에 없는 파일이 남지 않게 한다.
|
||||
*
|
||||
* 패키지 안의 자리와 동봉 위치가 다르면 `<입력>=<출력>` 으로 적는다(예: monaco 의
|
||||
* `min/vs=vs`). 동봉 경로는 브라우저가 요청하는 URL 이 되므로 패키지 내부 배치를 그대로
|
||||
* 따를 수 없는 경우가 있고, 그 차이를 손으로 옮기면 이 생성기를 두는 의미가 사라진다.
|
||||
*
|
||||
* 재생성이 저장소 안에서 재현 가능해야 하므로 항목별 파일 수와 바이트를 로그로 남긴다.
|
||||
*/
|
||||
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
|
||||
const [, , packageRoot, outputDir, ...entries] = process.argv;
|
||||
|
||||
if (!packageRoot || !outputDir || entries.length === 0) {
|
||||
console.error('사용법: node scripts/vendor-copy.mjs <패키지 루트> <출력 디렉토리> <복사 대상...>');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
/**
|
||||
* 동봉 대상 버전과 입력 패키지의 실제 버전이 어긋나면 중단합니다.
|
||||
*
|
||||
* 출력 경로의 버전 디렉토리(`.../flag-icons/7.2.3/…`)는 "여기 든 것은 7.2.3 이다" 라는
|
||||
* 배포 선언이다. 그런데 입력은 설치 트리라 선언을 고정해 두어도 오래된(또는 앞선) 트리가
|
||||
* 남을 수 있고, 그대로 쓰면 다른 버전을 그 디렉토리에 써 넣는 조용한 버전 거짓말이 된다.
|
||||
* 검증할 수 없으면 쓰지 않는다.
|
||||
*
|
||||
* @param {string} manifestPath 입력 패키지의 package.json 경로
|
||||
* @param {string} outputPath 출력 디렉토리 경로
|
||||
* @returns {void}
|
||||
*/
|
||||
function assertVendorVersion(manifestPath, outputPath) {
|
||||
const declared = path
|
||||
.resolve(outputPath)
|
||||
.split(/[\\/]+/)
|
||||
.filter((segment) => /^\d+\.\d+\.\d+$/.test(segment))
|
||||
.pop();
|
||||
|
||||
if (!declared) {
|
||||
console.error(`출력 경로에 버전 디렉토리가 없습니다: ${outputPath}`);
|
||||
console.error('동봉 자산은 `vendor/{lib}/{version}/` 규약을 따라야 합니다.');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
if (!fs.existsSync(manifestPath)) {
|
||||
console.error(`입력 패키지의 package.json 이 없어 버전을 검증할 수 없습니다: ${manifestPath}`);
|
||||
console.error(`동봉 선언은 ${declared} 입니다. 검증 없이 쓰면 배포본의 버전 라벨이 틀어지므로 중단합니다.`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
|
||||
|
||||
if (manifest.version !== declared) {
|
||||
console.error(`버전 불일치: 설치본 ${manifest.version} ≠ 동봉 선언 ${declared}`);
|
||||
console.error(` 입력: ${packageRoot}`);
|
||||
console.error(` 출력: ${outputPath}`);
|
||||
console.error('`npm ci` 로 lock 에 선언된 버전을 설치한 뒤 다시 실행하세요.');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
console.log(`[vendor] 버전 확인: ${manifest.name || '(이름 없음)'} ${manifest.version} → ${declared}`);
|
||||
}
|
||||
|
||||
/**
|
||||
* 복사된 텍스트 자산 말미의 소스맵 지시자를 제거합니다.
|
||||
*
|
||||
* 동봉물은 배포 산출물이라 `.map` 을 싣지 않는다(gitignore 대상). 지시자만 남으면 개발자
|
||||
* 도구를 연 방문자에게 404 가 뜨고, 커밋 dist 의 지시자 잔존을 막는 정적 검사에도 걸린다.
|
||||
* 손으로 지우면 재생성할 때마다 되살아나므로 생성기가 맡는다.
|
||||
*
|
||||
* 파일 **말미**의 지시자만 지운다 — monaco 의 `ts.worker` 는 TypeScript 컴파일러의 emitter
|
||||
* 코드 문자열로 같은 문구를 품고 있어(§13-5), 본문 전체를 훑으면 그 코드를 망가뜨린다.
|
||||
*
|
||||
* @param {string} target 파일 또는 디렉토리 경로
|
||||
* @returns {string[]} 지시자를 제거한 파일 경로 목록
|
||||
*/
|
||||
function stripSourceMapDirectives(target) {
|
||||
const stat = fs.statSync(target);
|
||||
|
||||
if (stat.isDirectory()) {
|
||||
return fs
|
||||
.readdirSync(target)
|
||||
.flatMap((entry) => stripSourceMapDirectives(path.join(target, entry)));
|
||||
}
|
||||
|
||||
if (!/\.(js|mjs|cjs|css)$/i.test(target)) {
|
||||
return [];
|
||||
}
|
||||
|
||||
const original = fs.readFileSync(target, 'utf8');
|
||||
// 지시자 줄만 걷어내고 앞뒤 공백은 원본 그대로 둔다 — 재생성 결과가 종전 배포본과
|
||||
// 바이트 동일해야 "다시 만들 수 있다" 가 성립한다.
|
||||
const stripped = original.replace(
|
||||
/(?:\/\/#|\/\*#)[ \t]*sourceMappingURL=[^\r\n]*?(?:\*\/)?[ \t]*\r?\n?$/,
|
||||
''
|
||||
);
|
||||
|
||||
if (stripped === original) {
|
||||
return [];
|
||||
}
|
||||
|
||||
fs.writeFileSync(target, stripped);
|
||||
|
||||
return [target];
|
||||
}
|
||||
|
||||
/**
|
||||
* 경로 아래의 파일 수와 총 바이트를 셉니다.
|
||||
*
|
||||
* @param {string} target 파일 또는 디렉토리 경로
|
||||
* @returns {{files: number, bytes: number}} 집계 결과
|
||||
*/
|
||||
function measure(target) {
|
||||
const stat = fs.statSync(target);
|
||||
|
||||
if (stat.isFile()) {
|
||||
return { files: 1, bytes: stat.size };
|
||||
}
|
||||
|
||||
let files = 0;
|
||||
let bytes = 0;
|
||||
|
||||
for (const entry of fs.readdirSync(target)) {
|
||||
const child = measure(path.join(target, entry));
|
||||
|
||||
files += child.files;
|
||||
bytes += child.bytes;
|
||||
}
|
||||
|
||||
return { files, bytes };
|
||||
}
|
||||
|
||||
assertVendorVersion(path.join(packageRoot, 'package.json'), outputDir);
|
||||
|
||||
let totalFiles = 0;
|
||||
let totalBytes = 0;
|
||||
|
||||
for (const entry of entries) {
|
||||
const separator = entry.indexOf('=');
|
||||
const sourceEntry = separator === -1 ? entry : entry.slice(0, separator);
|
||||
const destinationEntry = separator === -1 ? entry : entry.slice(separator + 1);
|
||||
|
||||
if (!sourceEntry || !destinationEntry) {
|
||||
console.error(`복사 대상 표기가 올바르지 않습니다: ${entry}`);
|
||||
console.error('`<입력>` 또는 `<입력>=<출력>` 형태여야 합니다.');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
const source = path.join(packageRoot, sourceEntry);
|
||||
const destination = path.join(outputDir, destinationEntry);
|
||||
|
||||
if (!fs.existsSync(source)) {
|
||||
console.error(`복사 대상을 찾을 수 없습니다: ${source}`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
fs.rmSync(destination, { recursive: true, force: true });
|
||||
fs.mkdirSync(path.dirname(destination), { recursive: true });
|
||||
fs.cpSync(source, destination, { recursive: true });
|
||||
|
||||
for (const stripped of stripSourceMapDirectives(destination)) {
|
||||
console.log(`[vendor-copy] 소스맵 지시자 제거: ${path.relative(outputDir, stripped)}`);
|
||||
}
|
||||
|
||||
const { files, bytes } = measure(destination);
|
||||
|
||||
totalFiles += files;
|
||||
totalBytes += bytes;
|
||||
|
||||
console.log(`[vendor-copy] ${entry} ${files}개 파일 ${bytes} bytes`);
|
||||
}
|
||||
|
||||
console.log(`[vendor-copy] 출력 : ${outputDir} (총 ${totalFiles}개 파일, ${totalBytes} bytes)`);
|
||||
@@ -0,0 +1,189 @@
|
||||
/**
|
||||
* Font Awesome 웹폰트를 CSS 에 인라인해 단일 파일로 만드는 생성기
|
||||
*
|
||||
* 자산 URL 이 `?file=` 쿼리 형태가 되는 서버(확장자를 정적 location 이 가로채는 구성)에서는
|
||||
* CSS 내부의 상대 `url()` 이 해석되지 않는다. 정적 게시가 켜져 있으면 실경로가 나가 문제가
|
||||
* 없지만, 게시를 끈 조합이 남는다. 아이콘만 있는 버튼이 다수인 화면에서 아이콘 소실은
|
||||
* 곧 조작 불능이므로, 그 조합에서도 아이콘이 뜨도록 폰트를 data: URI 로 인라인한다.
|
||||
*
|
||||
* 다만 **현행 버전(Font Awesome 6) 패밀리만** 인라인한다. `all.min.css` 는 같은 폰트를
|
||||
* 구버전 호환 패밀리(`Font Awesome 5 …` · `FontAwesome`)에서 다시 참조하므로, 전부
|
||||
* 인라인하면 같은 폰트가 3벌 실려 렌더 차단 CSS 가 1.2MB 로 부푼다. 호환 패밀리는
|
||||
* 파일 참조를 유지한다 — 저장소 전수 조사에서 레거시 클래스(`fa fa-*`) 사용은 0건이고,
|
||||
* 그 조합에서 degrade 하는 것은 편집기 팔레트 샘플뿐이다.
|
||||
*
|
||||
* `ttf` 소스는 인라인 대상에서 제거한다 — 선언 하한(Chrome 111 / Safari 16.4 / Firefox 128)이
|
||||
* 모두 woff2 를 지원하므로 같은 폰트를 두 번 싣는 것은 배포 용량 낭비다.
|
||||
*
|
||||
* 입력은 설치 트리(`node_modules`)이고 출력은 `vendor/{lib}/{version}/` 이라, 설치본이
|
||||
* 선언과 어긋나면 다른 버전을 그 디렉토리에 써 넣게 된다. 생성기는 실행 전에 두 버전을
|
||||
* 대조하고, 어긋나거나 확인할 수 없으면 중단한다.
|
||||
*
|
||||
* 사용:
|
||||
* node scripts/vendor-inline-css.mjs <입력 CSS> <웹폰트 디렉토리> <출력 CSS>
|
||||
*
|
||||
* 재생성이 저장소 안에서 재현 가능해야 하므로 입력/출력 경로와 해시를 로그로 남긴다.
|
||||
*/
|
||||
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import crypto from 'node:crypto';
|
||||
|
||||
const [, , inputCss, webfontsDir, outputCss] = process.argv;
|
||||
|
||||
if (!inputCss || !webfontsDir || !outputCss) {
|
||||
console.error('사용법: node scripts/vendor-inline-css.mjs <입력 CSS> <웹폰트 디렉토리> <출력 CSS>');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
/** 인라인 대상 패밀리 (현행 버전) */
|
||||
const INLINE_FAMILIES = ['Font Awesome 6 Free', 'Font Awesome 6 Brands'];
|
||||
|
||||
/**
|
||||
* 파일의 sha256 앞 16자를 돌려줍니다.
|
||||
*
|
||||
* @param {string} filePath 파일 경로
|
||||
* @returns {string} 해시 문자열
|
||||
*/
|
||||
function digest(filePath) {
|
||||
return crypto.createHash('sha256').update(fs.readFileSync(filePath)).digest('hex').slice(0, 16);
|
||||
}
|
||||
|
||||
/**
|
||||
* 동봉 대상 버전과 입력 패키지의 실제 버전이 어긋나면 중단합니다.
|
||||
*
|
||||
* 출력 경로의 버전 디렉토리(`.../font-awesome/6.4.0/…`)는 "여기 든 것은 6.4.0 이다" 라는
|
||||
* 배포 선언이다. 그런데 입력은 `node_modules` 라 선언을 고정해 두어도 오래된 트리가
|
||||
* 남을 수 있고, 그대로 쓰면 7.x 를 `6.4.0/` 에 써 넣는 조용한 버전 거짓말이 된다 —
|
||||
* 오류도 로그도 없이 배포본의 라벨만 틀린다. 검증할 수 없으면 쓰지 않는다.
|
||||
*
|
||||
* @param {string} inputPath 입력 파일 또는 패키지 내부 경로
|
||||
* @param {string} outputPath 출력 파일 또는 디렉토리 경로
|
||||
* @returns {void}
|
||||
*/
|
||||
function assertVendorVersion(inputPath, outputPath) {
|
||||
const declared = path
|
||||
.resolve(outputPath)
|
||||
.split(/[\\/]+/)
|
||||
.filter((segment) => /^\d+\.\d+\.\d+$/.test(segment))
|
||||
.pop();
|
||||
|
||||
if (!declared) {
|
||||
console.error(`출력 경로에 버전 디렉토리가 없습니다: ${outputPath}`);
|
||||
console.error('동봉 자산은 `vendor/{lib}/{version}/` 규약을 따라야 합니다.');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
let dir = path.resolve(path.dirname(inputPath));
|
||||
let manifest = null;
|
||||
|
||||
for (let depth = 0; depth < 8; depth++) {
|
||||
const candidate = path.join(dir, 'package.json');
|
||||
|
||||
if (fs.existsSync(candidate)) {
|
||||
manifest = JSON.parse(fs.readFileSync(candidate, 'utf8'));
|
||||
break;
|
||||
}
|
||||
|
||||
const parent = path.dirname(dir);
|
||||
|
||||
if (parent === dir) {
|
||||
break;
|
||||
}
|
||||
|
||||
dir = parent;
|
||||
}
|
||||
|
||||
if (!manifest || !manifest.version) {
|
||||
console.error(`입력 패키지의 package.json 을 찾지 못해 버전을 검증할 수 없습니다: ${inputPath}`);
|
||||
console.error(`동봉 선언은 ${declared} 입니다. 검증 없이 쓰면 배포본의 버전 라벨이 틀어지므로 중단합니다.`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
if (manifest.version !== declared) {
|
||||
console.error(`버전 불일치: 설치본 ${manifest.version} ≠ 동봉 선언 ${declared}`);
|
||||
console.error(` 입력: ${inputPath}`);
|
||||
console.error(` 출력: ${outputPath}`);
|
||||
console.error('`npm ci` 로 lock 에 선언된 버전을 설치한 뒤 다시 실행하세요.');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
console.log(`[vendor] 버전 확인: ${manifest.name || '(이름 없음)'} ${manifest.version} → ${declared}`);
|
||||
}
|
||||
|
||||
assertVendorVersion(inputCss, outputCss);
|
||||
|
||||
const source = fs.readFileSync(inputCss, 'utf8');
|
||||
const embedded = new Map();
|
||||
let inlinedBlocks = 0;
|
||||
let keptBlocks = 0;
|
||||
|
||||
/**
|
||||
* `@font-face` 블록 하나를 변환합니다.
|
||||
*
|
||||
* @param {string} block 블록 원문
|
||||
* @returns {string} 변환된 블록
|
||||
*/
|
||||
function transformFontFace(block) {
|
||||
const family = block.match(/font-family:\s*"([^"]+)"/)?.[1] ?? '';
|
||||
|
||||
if (!INLINE_FAMILIES.includes(family)) {
|
||||
keptBlocks++;
|
||||
|
||||
return block;
|
||||
}
|
||||
|
||||
inlinedBlocks++;
|
||||
|
||||
let transformed = block.replace(
|
||||
/url\(\.\.\/webfonts\/([A-Za-z0-9._-]+)\.woff2\)/g,
|
||||
(match, name) => {
|
||||
const fontPath = path.join(webfontsDir, `${name}.woff2`);
|
||||
|
||||
if (!fs.existsSync(fontPath)) {
|
||||
console.error(`웹폰트를 찾을 수 없습니다: ${fontPath}`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
if (!embedded.has(name)) {
|
||||
embedded.set(name, {
|
||||
bytes: fs.statSync(fontPath).size,
|
||||
sha256: digest(fontPath),
|
||||
});
|
||||
}
|
||||
|
||||
return `url(data:font/woff2;base64,${fs.readFileSync(fontPath).toString('base64')})`;
|
||||
}
|
||||
);
|
||||
|
||||
// woff2 를 인라인한 뒤 남는 ttf 소스 선언 제거
|
||||
transformed = transformed.replace(
|
||||
/,\s*url\(\.\.\/webfonts\/[A-Za-z0-9._-]+\.ttf\)\s*format\("truetype"\)/g,
|
||||
''
|
||||
);
|
||||
|
||||
if (/url\(\.\.\//.test(transformed)) {
|
||||
console.error(`인라인되지 않은 상대 경로가 남았습니다 (family: ${family}). 생성기를 갱신해야 합니다.`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
return transformed;
|
||||
}
|
||||
|
||||
const output = source.replace(/@font-face\{[^}]*\}/g, transformFontFace);
|
||||
|
||||
if (inlinedBlocks === 0) {
|
||||
console.error('인라인 대상 @font-face 를 찾지 못했습니다. 입력 CSS 또는 패밀리 목록을 확인하세요.');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
fs.mkdirSync(path.dirname(outputCss), { recursive: true });
|
||||
fs.writeFileSync(outputCss, output);
|
||||
|
||||
console.log('[vendor-inline-css] 입력 :', inputCss, `(${fs.statSync(inputCss).size} bytes, sha256:${digest(inputCss)})`);
|
||||
console.log('[vendor-inline-css] 폰트 :', webfontsDir);
|
||||
for (const [name, info] of embedded) {
|
||||
console.log(` - ${name}.woff2 ${info.bytes} bytes sha256:${info.sha256}`);
|
||||
}
|
||||
console.log(`[vendor-inline-css] 인라인 @font-face ${inlinedBlocks}개 / 파일 참조 유지 ${keptBlocks}개 (구버전 호환 패밀리)`);
|
||||
console.log('[vendor-inline-css] 출력 :', outputCss, `(${fs.statSync(outputCss).size} bytes, sha256:${digest(outputCss)})`);
|
||||
Reference in new issue
Block a user