@milcho0604/velog-mcp 0.4.0

package/dist/ratelimit.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 공개 발행 속도 제한.
+ *
+ * ★ 적용 대상은 **공개 발행뿐**이다. 초안과 비공개 발행은 카운터를 올리지 않아
+ *   상한을 걸지 않는다 (다만 카운터를 올리지 않는 것과 파괴 동작을 유발하지 않는
+ *   것은 다르다 — src/capabilities.ts 주석 참고).
+ *
+ * ★ 이건 예의가 아니라 안전장치다. 벨로그는 최근 5분의 `is_private:false` 글을
+ *   `is_temp` 구분 없이 세고, 10개를 넘으면 **최근 5분의 글을 전부**
+ *   `is_private:true` 로 바꾼다 (apps/server/src/services/PostApiService/index.mts).
+ *   글은 Prisma 기본값으로 `released_at = now()` 를 받으므로 발행 즉시 계수에 들어간다.
+ *
+ *   결과: 공개 글을 몰아 올리면 **방금 올린 글들이 한꺼번에 비공개가 된다.**
+ *   되돌리려면 사용자가 글마다 공개 설정을 다시 손대야 한다.
+ *
+ * 그래서 벨로그 한계(10)보다 낮은 선에서 우리가 먼저 멈춘다. 여유를 두는 이유는
+ * 사용자가 같은 시간대에 벨로그 웹에서 직접 글을 쓸 수도 있어서다 — 우리 카운터는
+ * 그걸 못 본다.
+ */
+/** 벨로그가 파괴적 조치를 취하는 임계. 넘기면 안 된다. */
+export declare const VELOG_DESTRUCTIVE_THRESHOLD = 10;
+/** 우리 상한. 사용자가 웹에서 직접 쓴 글 몫을 남겨둔다. */
+export declare const PUBLIC_PUBLISH_LIMIT = 5;
+/** 벨로그가 보는 창과 같다. */
+export declare const WINDOW_MS: number;
+export declare class PublishRateLimitError extends Error {
+    readonly retryAfterMs: number;
+    constructor(retryAfterMs: number);
+}
+/**
+ * 슬라이딩 윈도우 카운터. 프로세스 메모리에만 있다.
+ *
+ * 한계를 분명히 해둔다 — 이 카운터는 **이 서버가 발행한 것만** 센다.
+ * 사용자가 벨로그 웹에서 직접 쓴 글은 안 보인다. 그래서 상한을 10이 아니라
+ * 5로 잡아 여유를 남긴다.
+ */
+export declare class PublishRateLimiter {
+    #private;
+    constructor(options?: {
+        limit?: number;
+        windowMs?: number;
+        now?: () => number;
+    });
+    /** 한도를 넘었으면 던진다. 통과하면 이번 생성을 기록한다. */
+    check(): void;
+    /** 창 안의 현재 건수. */
+    get count(): number;
+}

package/dist/ratelimit.js

@@ -0,0 +1,79 @@
+/**
+ * 공개 발행 속도 제한.
+ *
+ * ★ 적용 대상은 **공개 발행뿐**이다. 초안과 비공개 발행은 카운터를 올리지 않아
+ *   상한을 걸지 않는다 (다만 카운터를 올리지 않는 것과 파괴 동작을 유발하지 않는
+ *   것은 다르다 — src/capabilities.ts 주석 참고).
+ *
+ * ★ 이건 예의가 아니라 안전장치다. 벨로그는 최근 5분의 `is_private:false` 글을
+ *   `is_temp` 구분 없이 세고, 10개를 넘으면 **최근 5분의 글을 전부**
+ *   `is_private:true` 로 바꾼다 (apps/server/src/services/PostApiService/index.mts).
+ *   글은 Prisma 기본값으로 `released_at = now()` 를 받으므로 발행 즉시 계수에 들어간다.
+ *
+ *   결과: 공개 글을 몰아 올리면 **방금 올린 글들이 한꺼번에 비공개가 된다.**
+ *   되돌리려면 사용자가 글마다 공개 설정을 다시 손대야 한다.
+ *
+ * 그래서 벨로그 한계(10)보다 낮은 선에서 우리가 먼저 멈춘다. 여유를 두는 이유는
+ * 사용자가 같은 시간대에 벨로그 웹에서 직접 글을 쓸 수도 있어서다 — 우리 카운터는
+ * 그걸 못 본다.
+ */
+/** 벨로그가 파괴적 조치를 취하는 임계. 넘기면 안 된다. */
+export const VELOG_DESTRUCTIVE_THRESHOLD = 10;
+/** 우리 상한. 사용자가 웹에서 직접 쓴 글 몫을 남겨둔다. */
+export const PUBLIC_PUBLISH_LIMIT = 5;
+/** 벨로그가 보는 창과 같다. */
+export const WINDOW_MS = 5 * 60 * 1000;
+export class PublishRateLimitError extends Error {
+    retryAfterMs;
+    constructor(retryAfterMs) {
+        const seconds = Math.ceil(retryAfterMs / 1000);
+        super(`공개 발행을 잠시 멈춥니다. 최근 5분에 이미 ${PUBLIC_PUBLISH_LIMIT}건을 발행했습니다.\n\n` +
+            `이유: 벨로그는 최근 5분의 공개 글이 ${VELOG_DESTRUCTIVE_THRESHOLD}건을 넘으면 ` +
+            '그 시간대 글을 **전부 비공개로 바꿉니다**. 계속하면 방금 올리신 글들이 ' +
+            '한꺼번에 비공개가 될 수 있습니다.\n\n' +
+            `약 ${seconds}초 뒤에 다시 시도하세요. ` +
+            '급하지 않다면 비공개로 발행해두고 나중에 공개로 바꾸는 편이 안전합니다.');
+        this.name = 'PublishRateLimitError';
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+/**
+ * 슬라이딩 윈도우 카운터. 프로세스 메모리에만 있다.
+ *
+ * 한계를 분명히 해둔다 — 이 카운터는 **이 서버가 발행한 것만** 센다.
+ * 사용자가 벨로그 웹에서 직접 쓴 글은 안 보인다. 그래서 상한을 10이 아니라
+ * 5로 잡아 여유를 남긴다.
+ */
+export class PublishRateLimiter {
+    #timestamps = [];
+    #limit;
+    #windowMs;
+    #now;
+    constructor(options = {}) {
+        this.#limit = options.limit ?? PUBLIC_PUBLISH_LIMIT;
+        this.#windowMs = options.windowMs ?? WINDOW_MS;
+        this.#now = options.now ?? (() => Date.now());
+    }
+    /** 한도를 넘었으면 던진다. 통과하면 이번 생성을 기록한다. */
+    check() {
+        const now = this.#now();
+        const cutoff = now - this.#windowMs;
+        // 창 밖으로 나간 기록을 버린다. shift() 의 반환으로 판정하면
+        // non-null 단언 없이 첫 원소를 다룰 수 있다.
+        for (let head = this.#timestamps[0]; head !== undefined && head <= cutoff;) {
+            this.#timestamps.shift();
+            head = this.#timestamps[0];
+        }
+        const oldest = this.#timestamps[0];
+        if (oldest !== undefined && this.#timestamps.length >= this.#limit) {
+            throw new PublishRateLimitError(oldest + this.#windowMs - now);
+        }
+        this.#timestamps.push(now);
+    }
+    /** 창 안의 현재 건수. */
+    get count() {
+        const cutoff = this.#now() - this.#windowMs;
+        return this.#timestamps.filter((t) => t > cutoff).length;
+    }
+}
+//# sourceMappingURL=ratelimit.js.map

package/dist/ratelimit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratelimit.js","sourceRoot":"","sources":["../src/ratelimit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,qCAAqC;AACrC,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAE9C,sCAAsC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAEtC,qBAAqB;AACrB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvC,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACtC,YAAY,CAAS;IAE9B,YAAY,YAAoB;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;QAC/C,KAAK,CACJ,6BAA6B,oBAAoB,gBAAgB;YAChE,yBAAyB,2BAA2B,SAAS;YAC7D,6CAA6C;YAC7C,yBAAyB;YACzB,KAAK,OAAO,iBAAiB;YAC7B,0CAA0C,CAC3C,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IAClC,CAAC;CACD;AAED;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IACrB,WAAW,GAAa,EAAE,CAAC;IAC3B,MAAM,CAAS;IACf,SAAS,CAAS;IAClB,IAAI,CAAe;IAE5B,YACC,UAAqE,EAAE;QAEvE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,oBAAoB,CAAC;QACpD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,sCAAsC;IACtC,KAAK;QACJ,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QACpC,wCAAwC;QACxC,gCAAgC;QAChC,KAAK,IAAI,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,SAAS,IAAI,IAAI,IAAI,MAAM,GAAI,CAAC;YAC7E,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;YACzB,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACpE,MAAM,IAAI,qBAAqB,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,kBAAkB;IAClB,IAAI,KAAK;QACR,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;QAC5C,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;IAC1D,CAAC;CACD"}

package/dist/render/chrome.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 헤드리스 크롬 실행기.
+ *
+ * ★ 왜 puppeteer 를 안 쓰나
+ *   이 저장소는 런타임 의존성을 2개(MCP SDK, zod)로 묶어두고 그걸 테스트(A6)로
+ *   강제한다. puppeteer 는 크로미움을 통째로 내려받아 설치 용량이 수백 MB 늘고,
+ *   MCP 서버는 사용자 기기에서 도는 물건이라 그 비용이 그대로 사용자에게 간다.
+ *   우리가 필요한 건 '스크린샷 한 장'뿐이라 이미 깔린 크롬을 CLI 로 부른다.
+ *
+ * ★ 렌더 페이지가 밖으로 나갈 수 없는 이유 — 순서가 중요하다
+ *   **1차 방어는 '나갈 구멍이 없다'는 것이다.** 페이지에는 URL 을 받는 자리가 하나도
+ *   없다 — 아이콘은 내장 도형이고, `href`·`src`·`fetch` 를 쓰지 않으며, `url(...)` 은
+ *   문서 안 marker 참조(`url(#arr-…)`) 뿐이다. 이건 테스트가 강제한다.
+ *   **2차 방어가 `--host-resolver-rules=MAP * ~NOTFOUND` 다.** 나중에 누가 실수로
+ *   원격 리소스를 넣어도 막힌다.
+ *   실측(2026-07-31): 로컬 서버를 표적으로 두고 재보니 플래그 없이는 요청이 서버에
+ *   도달(1건)하고 플래그를 주면 도달하지 않는다(0건). 표적이 `127.0.0.1` 이므로
+ *   **IP 를 직접 적은 주소도 막힌다** — 한때 "이름 풀이만 막으니 IP 는 통과한다"고
+ *   적었는데 그건 틀렸다. 다만 `file:`·`data:`·`blob:` 처럼 이름 풀이를 안 쓰는
+ *   스킴은 이 플래그의 대상이 아니다. 그러니 순서는 그대로다 — 1차가 본질이다.
+ *
+ * ★ 사용자의 크롬 프로필을 건드리지 않는다
+ *   `--user-data-dir` 을 임시 폴더로 지정한다. 지정하지 않으면 기본 프로필을
+ *   열려다 이미 떠 있는 크롬과 충돌하고, 로그인 세션이 있는 프로필에서 렌더하게 된다.
+ *
+ * ★★ 서버가 죽으면 크롬도 같이 죽인다
+ *   실제로 고아를 만들었다. MCP 클라이언트가 60초 타임아웃으로 연결을 끊자 서버
+ *   프로세스가 죽었는데, 그때 렌더 중이던 크롬이 PPID=1 로 살아남아 23분을 돌고 있었다
+ *   (`ps` 로 확인). POSIX 에서 부모가 죽어도 자식은 안 죽는다 — 아무도 안 죽인다.
+ *   그래서 띄운 크롬을 들고 있다가 프로세스 종료 시 정리한다.
+ *   ⚠️ 서버 자신이 SIGKILL 당하면 이 정리도 못 돈다. 그 경우는 남은 프로필 폴더를
+ *   다음 렌더의 청소(render/index.ts)가 하루 뒤 거둬간다.
+ *
+ * ★★ 크롬이 끝나기를 기다리지 않는다 — 안 끝나기 때문이다
+ *   Chrome 150 의 새 헤드리스는 `--dump-dom` 결과를 **1.7초 만에 stdout 으로 내놓고도
+ *   프로세스를 유지한다** (실측: 30초를 더 기다려도 종료 안 함). 종료를 기다리는
+ *   구현이었을 때 그림 한 장에 90초가 걸렸다 — 실제 작업은 2초인데 나머지는 전부
+ *   기다림이었다.
+ *   그래서 **산출물이 완성됐는지 직접 보고** 확인되면 프로세스를 끝낸다.
+ *   PNG 는 크기가 아니라 마지막 IEND 청크로 판정한다. 크기 비교는 쓰다 만 파일을
+ *   완성으로 오인할 수 있다.
+ */
+import { spawn } from 'node:child_process';
+export declare class ChromeNotFoundError extends Error {
+    constructor();
+}
+/** 크롬 실행 파일을 찾는다. 결과는 프로세스 수명 동안 재사용한다. */
+export declare function findChrome(): Promise<string>;
+/** 테스트에서 탐색 결과를 되돌리기 위한 것. 운영 경로에서는 부르지 않는다. */
+export declare function resetChromeCache(): void;
+interface RunOptions {
+    readonly profileDir: string;
+    readonly timeoutMs?: number;
+    /**
+     * 프로세스 생성기. **테스트에서만** 바꾼다.
+     *
+     * 실제 크롬으로는 '결과가 늦게 도착하는 종료' 같은 타이밍을 안정적으로 만들 수
+     * 없어서, 그 불변식(‘exit’ 이 아니라 ‘close’ 를 본다)이 오래 안 묶여 있었다.
+     * 가짜 자식 프로세스를 넣으면 벽시계 대기 없이 정확히 재현된다.
+     */
+    readonly spawnImpl?: typeof spawn;
+    /** 테스트에서 작은 값으로 낮춰 stdout 상한 동작을 확인한다. */
+    readonly maxStdoutBytes?: number;
+}
+/** 산출물이 다 나왔는지 판정한다. true 가 되는 순간 크롬을 끝낸다. */
+type Ready = (stdout: string) => boolean | Promise<boolean>;
+export declare function runForTest(chrome: string, args: readonly string[], options: RunOptions, ready: Ready): Promise<string>;
+/** 스크립트가 다 돈 뒤의 DOM 을 문자열로 받는다. 자가감사 결과를 읽는 데 쓴다. */
+export declare function dumpDom(fileUrl: string, options: RunOptions): Promise<string>;
+export interface ShotOptions extends RunOptions {
+    readonly width: number;
+    readonly height: number;
+    /** 2 = 레티나 배율. 블로그에 올릴 그림은 2배로 뽑아야 글자가 안 흐리다. */
+    readonly scale?: number;
+}
+export declare function screenshot(fileUrl: string, outPath: string, options: ShotOptions): Promise<void>;
+export {};

package/dist/render/chrome.js

@@ -0,0 +1,287 @@
+/**
+ * 헤드리스 크롬 실행기.
+ *
+ * ★ 왜 puppeteer 를 안 쓰나
+ *   이 저장소는 런타임 의존성을 2개(MCP SDK, zod)로 묶어두고 그걸 테스트(A6)로
+ *   강제한다. puppeteer 는 크로미움을 통째로 내려받아 설치 용량이 수백 MB 늘고,
+ *   MCP 서버는 사용자 기기에서 도는 물건이라 그 비용이 그대로 사용자에게 간다.
+ *   우리가 필요한 건 '스크린샷 한 장'뿐이라 이미 깔린 크롬을 CLI 로 부른다.
+ *
+ * ★ 렌더 페이지가 밖으로 나갈 수 없는 이유 — 순서가 중요하다
+ *   **1차 방어는 '나갈 구멍이 없다'는 것이다.** 페이지에는 URL 을 받는 자리가 하나도
+ *   없다 — 아이콘은 내장 도형이고, `href`·`src`·`fetch` 를 쓰지 않으며, `url(...)` 은
+ *   문서 안 marker 참조(`url(#arr-…)`) 뿐이다. 이건 테스트가 강제한다.
+ *   **2차 방어가 `--host-resolver-rules=MAP * ~NOTFOUND` 다.** 나중에 누가 실수로
+ *   원격 리소스를 넣어도 막힌다.
+ *   실측(2026-07-31): 로컬 서버를 표적으로 두고 재보니 플래그 없이는 요청이 서버에
+ *   도달(1건)하고 플래그를 주면 도달하지 않는다(0건). 표적이 `127.0.0.1` 이므로
+ *   **IP 를 직접 적은 주소도 막힌다** — 한때 "이름 풀이만 막으니 IP 는 통과한다"고
+ *   적었는데 그건 틀렸다. 다만 `file:`·`data:`·`blob:` 처럼 이름 풀이를 안 쓰는
+ *   스킴은 이 플래그의 대상이 아니다. 그러니 순서는 그대로다 — 1차가 본질이다.
+ *
+ * ★ 사용자의 크롬 프로필을 건드리지 않는다
+ *   `--user-data-dir` 을 임시 폴더로 지정한다. 지정하지 않으면 기본 프로필을
+ *   열려다 이미 떠 있는 크롬과 충돌하고, 로그인 세션이 있는 프로필에서 렌더하게 된다.
+ *
+ * ★★ 서버가 죽으면 크롬도 같이 죽인다
+ *   실제로 고아를 만들었다. MCP 클라이언트가 60초 타임아웃으로 연결을 끊자 서버
+ *   프로세스가 죽었는데, 그때 렌더 중이던 크롬이 PPID=1 로 살아남아 23분을 돌고 있었다
+ *   (`ps` 로 확인). POSIX 에서 부모가 죽어도 자식은 안 죽는다 — 아무도 안 죽인다.
+ *   그래서 띄운 크롬을 들고 있다가 프로세스 종료 시 정리한다.
+ *   ⚠️ 서버 자신이 SIGKILL 당하면 이 정리도 못 돈다. 그 경우는 남은 프로필 폴더를
+ *   다음 렌더의 청소(render/index.ts)가 하루 뒤 거둬간다.
+ *
+ * ★★ 크롬이 끝나기를 기다리지 않는다 — 안 끝나기 때문이다
+ *   Chrome 150 의 새 헤드리스는 `--dump-dom` 결과를 **1.7초 만에 stdout 으로 내놓고도
+ *   프로세스를 유지한다** (실측: 30초를 더 기다려도 종료 안 함). 종료를 기다리는
+ *   구현이었을 때 그림 한 장에 90초가 걸렸다 — 실제 작업은 2초인데 나머지는 전부
+ *   기다림이었다.
+ *   그래서 **산출물이 완성됐는지 직접 보고** 확인되면 프로세스를 끝낸다.
+ *   PNG 는 크기가 아니라 마지막 IEND 청크로 판정한다. 크기 비교는 쓰다 만 파일을
+ *   완성으로 오인할 수 있다.
+ */
+import { spawn } from 'node:child_process';
+import { access, constants, readFile, stat } from 'node:fs/promises';
+import { platform } from 'node:process';
+const CANDIDATES = {
+    darwin: [
+        '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+        '/Applications/Chromium.app/Contents/MacOS/Chromium',
+        '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+        '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser',
+    ],
+    linux: [
+        '/usr/bin/google-chrome',
+        '/usr/bin/google-chrome-stable',
+        '/usr/bin/chromium',
+        '/usr/bin/chromium-browser',
+        '/usr/bin/microsoft-edge',
+        '/snap/bin/chromium',
+    ],
+    win32: [
+        'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+        'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
+        'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe',
+    ],
+};
+export class ChromeNotFoundError extends Error {
+    constructor() {
+        super('그림을 그리려면 크롬(또는 크로미움 계열 브라우저)이 필요한데 찾지 못했습니다.\n' +
+            '설치돼 있다면 VELOG_CHROME_PATH 환경변수에 실행 파일 경로를 지정하세요.\n' +
+            '예) VELOG_CHROME_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"');
+        this.name = 'ChromeNotFoundError';
+    }
+}
+let cached;
+/**
+ * 실행할 수 있는 **일반 파일**인지 본다.
+ *
+ * ★ `access(X_OK)` 만으로는 부족하다 — 디렉터리도 통과한다
+ *   POSIX 에서 디렉터리의 `X_OK` 는 '실행 가능'이 아니라 '탐색 가능'이라는 뜻이다.
+ *   실측: `/Applications/Google Chrome.app` 은 `X_OK` 를 통과하지만 `isFile()` 은
+ *   false 다. 플러그인 설정의 크롬 경로가 `file` 타입이라 macOS 파일 선택기가
+ *   앱 번들 자체를 돌려주면 딱 이 경우가 된다 — 기동 로그는 "사용 가능"이라
+ *   말해놓고 정작 그리려 할 때 `spawn` 이 실패한다.
+ */
+async function isExecutableFile(path) {
+    const info = await stat(path).catch(() => null);
+    if (!info?.isFile())
+        return false;
+    return await access(path, constants.X_OK).then(() => true, () => false);
+}
+/**
+ * macOS 앱 번들을 지정했으면 안쪽 실행 파일로 바꿔준다.
+ *
+ * 번들을 고르는 건 사용자 실수가 아니라 파일 선택기의 자연스러운 결과다.
+ * 고칠 수 있는 실수는 고쳐주고, 못 고치면 그때 분명히 말한다.
+ */
+async function resolveAppBundle(path) {
+    if (!path.endsWith('.app'))
+        return undefined;
+    const name = path.slice(path.lastIndexOf('/') + 1, -'.app'.length);
+    const inner = `${path}/Contents/MacOS/${name}`;
+    return (await isExecutableFile(inner)) ? inner : undefined;
+}
+/** 크롬 실행 파일을 찾는다. 결과는 프로세스 수명 동안 재사용한다. */
+export async function findChrome() {
+    if (cached)
+        return cached;
+    const override = process.env['VELOG_CHROME_PATH'];
+    if (override) {
+        // 지정했는데 못 쓰면 조용히 다른 걸 쓰지 않는다 — 의도한 브라우저로 그려야 한다.
+        const resolved = (await isExecutableFile(override))
+            ? override
+            : await resolveAppBundle(override);
+        if (!resolved) {
+            throw new Error(`VELOG_CHROME_PATH 로 지정한 파일을 실행할 수 없습니다: ${override}\n` +
+                '실행 파일 자체를 지정해야 합니다. macOS 앱 번들(.app)을 골랐다면 그 안쪽 경로입니다.\n' +
+                '예) /Applications/Google Chrome.app/Contents/MacOS/Google Chrome');
+        }
+        cached = resolved;
+        return resolved;
+    }
+    for (const path of CANDIDATES[platform] ?? []) {
+        if (await isExecutableFile(path)) {
+            cached = path;
+            return path;
+        }
+    }
+    throw new ChromeNotFoundError();
+}
+/** 테스트에서 탐색 결과를 되돌리기 위한 것. 운영 경로에서는 부르지 않는다. */
+export function resetChromeCache() {
+    cached = undefined;
+}
+/**
+ * 지금 살아 있는 크롬들. 서버가 내려갈 때 같이 정리하려고 들고 있는다.
+ * 훅은 실제로 하나라도 띄운 뒤에만 건다 — 아무것도 안 그리는 프로세스(테스트 등)의
+ * 시그널 동작을 바꾸지 않기 위해서다.
+ */
+const live = new Set();
+let hooked = false;
+function killAll() {
+    for (const child of live) {
+        try {
+            child.kill('SIGKILL');
+        }
+        catch {
+            // 이미 죽었으면 그만이다.
+        }
+    }
+    live.clear();
+}
+function hookProcessExit() {
+    if (hooked)
+        return;
+    hooked = true;
+    // exit 핸들러에서는 동기 작업만 된다. kill 은 동기라 여기서 충분하다.
+    process.on('exit', killAll);
+    for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+        process.on(signal, () => {
+            killAll();
+            process.exit(0);
+        });
+    }
+}
+const BASE_FLAGS = [
+    '--headless',
+    '--disable-gpu',
+    '--no-first-run',
+    '--no-default-browser-check',
+    '--disable-extensions',
+    '--disable-background-networking',
+    '--disable-component-update',
+    '--disable-sync',
+    '--disable-default-apps',
+    '--mute-audio',
+    '--hide-scrollbars',
+    // 네트워크 원천 차단. 이 페이지는 외부를 볼 일이 없다.
+    '--host-resolver-rules=MAP * ~NOTFOUND',
+];
+function tail(text, lines = 4) {
+    return text.trim().split('\n').slice(-lines).join('\n');
+}
+export function runForTest(chrome, args, options, ready) {
+    return run(chrome, args, options, ready);
+}
+function run(chrome, args, options, ready) {
+    const full = [...BASE_FLAGS, `--user-data-dir=${options.profileDir}`, ...args];
+    const limit = options.timeoutMs ?? 30_000;
+    return new Promise((resolve, reject) => {
+        hookProcessExit();
+        const child = (options.spawnImpl ?? spawn)(chrome, full, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        live.add(child);
+        let out = '';
+        let err = '';
+        let settled = false;
+        // ★ stdout 을 무제한으로 모으면 페이지가 큰 문자열을 뱉을 때 그대로 따라 커진다.
+        //   DOM 은 우리가 만든 것이라 정상이면 수백 KB 다. 상한을 넘으면 비정상이다.
+        // ★ 붙이기 **전에** 검사하면 마지막 청크는 상한을 넘긴 채로 들어간다.
+        //   그리고 문자열 길이는 UTF-16 단위라 바이트가 아니다. 바이트로 세고,
+        //   더한 뒤에 판정한다.
+        const MAX_STDOUT = options.maxStdoutBytes ?? 32 * 1024 * 1024;
+        let outBytes = 0;
+        child.stdout.on('data', (chunk) => {
+            outBytes += chunk.length;
+            if (outBytes > MAX_STDOUT) {
+                finish(() => {
+                    reject(new Error(`크롬 출력이 ${MAX_STDOUT / 1024 / 1024}MB 를 넘었습니다 — 입력이 비정상입니다.`));
+                });
+                return;
+            }
+            out += chunk.toString('utf8');
+        });
+        child.stderr.on('data', (chunk) => {
+            // ★ 크롬은 정상 동작 중에도 stderr 에 경고를 쏟는다. 실패 판정에 쓰지 않고
+            //   오류 메시지에 붙일 꼬리만 남긴다. 무한정 모으지 않는다.
+            if (err.length < 8000)
+                err += chunk.toString('utf8');
+        });
+        const finish = (action) => {
+            if (settled)
+                return;
+            settled = true;
+            clearInterval(poll);
+            clearTimeout(deadline);
+            live.delete(child);
+            child.kill('SIGKILL');
+            action();
+        };
+        const check = (onNotReady) => {
+            void (async () => {
+                const ok = await Promise.resolve(ready(out)).catch(() => false);
+                if (ok)
+                    finish(() => { resolve(out); });
+                else
+                    onNotReady?.();
+            })();
+        };
+        const poll = setInterval(() => { check(); }, 120);
+        const deadline = setTimeout(() => {
+            finish(() => {
+                reject(new Error(`크롬이 ${limit}ms 안에 결과를 내지 못했습니다.\n${tail(err)}`));
+            });
+        }, limit);
+        child.on('error', (cause) => {
+            finish(() => { reject(new Error(`크롬을 실행하지 못했습니다: ${cause.message}`)); });
+        });
+        // ★ 'exit' 이 아니라 'close' 를 본다. Node 는 'exit' 시점에 stdio 가 아직
+        //   열려 있을 수 있다고 명시한다 — 마지막 </html> 이 그 뒤에 도착하면
+        //   멀쩡한 결과를 실패로 처리하게 된다. 'close' 는 stdio 까지 닫힌 뒤다.
+        child.on('close', (code) => {
+            // 스스로 끝난 경우. 산출물이 있으면 성공, 없으면 진짜 실패다.
+            check(() => {
+                finish(() => {
+                    reject(new Error(`크롬이 결과 없이 종료했습니다 (code ${String(code)})\n${tail(err)}`));
+                });
+            });
+        });
+    });
+}
+/** PNG 가 끝까지 쓰였는지 — 마지막 IEND 청크로 확인한다. */
+async function pngComplete(path) {
+    const buf = await readFile(path).catch(() => null);
+    if (!buf || buf.length < 16)
+        return false;
+    const end = buf.subarray(buf.length - 8);
+    return (end[0] === 0x49 && end[1] === 0x45 && end[2] === 0x4e && end[3] === 0x44 &&
+        end[4] === 0xae && end[5] === 0x42 && end[6] === 0x60 && end[7] === 0x82);
+}
+/** 스크립트가 다 돈 뒤의 DOM 을 문자열로 받는다. 자가감사 결과를 읽는 데 쓴다. */
+export async function dumpDom(fileUrl, options) {
+    const chrome = await findChrome();
+    // 스크립트가 동기라 load 시점이면 이미 끝나 있다. </html> 이 오면 그만 기다린다.
+    return run(chrome, ['--dump-dom', fileUrl], options, (out) => out.includes('</html>'));
+}
+export async function screenshot(fileUrl, outPath, options) {
+    const chrome = await findChrome();
+    await run(chrome, [
+        `--window-size=${options.width},${options.height}`,
+        `--force-device-scale-factor=${options.scale ?? 2}`,
+        `--screenshot=${outPath}`,
+        fileUrl,
+    ], options, () => pngComplete(outPath));
+}
+//# sourceMappingURL=chrome.js.map

package/dist/render/chrome.js.map

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

package/dist/render/cover.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 글 표지(썸네일) 카드.
+ *
+ * 벨로그는 글 목록·SNS 공유에서 `thumbnail` 을 쓴다. 없으면 본문 첫 이미지를 쓰거나
+ * 그냥 비어 보인다. 제목만 있는 글이라도 표지 한 장이 있으면 목록에서 확실히 다르다.
+ *
+ * 크기는 1200×630 — OG 이미지 표준 비율이라 트위터·슬랙 미리보기에서 잘리지 않는다.
+ * 줄바꿈은 여기서도 브라우저 실측으로 한다. 글자수로 자르면 한글에서 반드시 틀린다.
+ */
+export interface CoverSpec {
+    title: string;
+    subtitle?: string | undefined;
+    /** 상단 작은 라벨 (예: '디버깅 기록', 'OSS 기여') */
+    kicker?: string | undefined;
+    tags?: string[] | undefined;
+    tone?: string | undefined;
+    /** 우하단 서명 (예: 'velog.io/@milcho0604') */
+    footer?: string | undefined;
+}
+export interface CoverAudit {
+    w: number;
+    h: number;
+    /** 넘쳐서 잘라낸 줄 */
+    truncated: string[];
+    /** 실제로 쓰인 제목 글자 크기 — 줄어들었으면 제목이 길다는 뜻 */
+    titleSize: number;
+}
+export declare function buildCoverHtml(spec: CoverSpec): string;
+export declare function formatCoverAudit(a: CoverAudit): string;