@runlot/api 0.1.0-rc.31 → 0.1.0-rc.32

package/dist/schema.d.ts

@@ -75,6 +75,31 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/hooks/ses": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * SES 바운스·불만·배달 웹훅 (SNS 가 부른다, docs/email.md §6.2)
+         * @description 사용자가 부르는 경로가 아니다. Amazon SNS 가 HTTPS 구독으로 여기에 SES 사건을
+         *     배달한다. 인증은 토큰이 아니라 **SNS 서명**이다 — 인증서 URL 이
+         *     `sns.<region>.amazonaws.com` 의 https 이고 토픽이 서버의
+         *     `RUNLOT_SES_SNS_TOPIC_ARN` 과 같을 때만 받는다 (아니면 403).
+         *     `SubscriptionConfirmation` 은 `SubscribeURL` 을 GET 해 자동으로 끝낸다.
+         *     서버에 토픽 ARN 이 없으면 501. 클라이언트 라이브러리는 부르지 않는다.
+         */
+        post: operations["sesHook"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/me": {
         parameters: {
             query?: never;
@@ -761,6 +786,129 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/orgs/{orgSlug}/projects/{projectName}/email": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        /**
+         * 이메일 상태 (`runlot email`)
+         * @description 부여 여부·주소·발신자·시간당 상한·최근 발신/수신 계수 (docs/email.md §5).
+         *     부여가 없어도 `address`·`from` 은 채워 온다 — "켜면 이런 주소가 됩니다"
+         *     의 재료다. `granted` 가 진짜 상태다.
+         *
+         *     viewer 이상.
+         */
+        get: operations["getEmail"];
+        put?: never;
+        /**
+         * 이메일을 켠다 (배포가 `"email": true` 를 읽고 부른다)
+         * @description **멱등이다.** 요청 본문이 없다 — 주소는 우리가 정하고 (`<project>.<org>.<mail-domain>`),
+         *     상한은 요금제가 정한다. 주소는 부여 시점의 이름으로 굳는다.
+         *
+         *     켜지면 노드가 다음 수렴에서 `env.email` 을 연결하고, 그 주소로 오는
+         *     메일이 워커의 `email()` 에 닿는다. 발신과 수신은 같이 켜진다 — 도메인
+         *     하나가 두 방향의 이름이다.
+         *
+         *     member 이상. 감사 `email.grant`.
+         */
+        post: operations["grantEmail"];
+        /**
+         * 이메일을 끈다 (`runlot email delete`)
+         * @description 그 주소로 오는 메일은 이제 550 이다 — 보낸 쪽 MTA 는 바운스를 받고
+         *     다시 안 보낸다. 멱등이다.
+         *
+         *     admin 이상. 감사 `email.revoke`.
+         */
+        delete: operations["revokeEmail"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orgs/{orgSlug}/projects/{projectName}/email/log": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        /**
+         * 메일 로그 (`runlot email log`)
+         * @description 보낸 것과 받은 것 한 통마다 한 줄, 시각 역순 (docs/email.md §6.1). 봉투·결말·
+         *     크기·SPF 결과. 원문은 `…/log/{mailId}/raw`.
+         *
+         *     보관은 요금제의 지금 값이다 — 무료 30 일, 프로 365 일 (`keepDays`).
+         *
+         *     viewer 이상.
+         */
+        get: operations["listMailLog"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orgs/{orgSlug}/projects/{projectName}/email/log/{mailId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+                mailId: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * 메일 한 통의 메타
+         * @description 프로젝트 밖의 id 는 404 다 — 다른 프로젝트의 로그를 id 로 더듬을 수 없다. viewer 이상.
+         */
+        get: operations["getMailLog"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orgs/{orgSlug}/projects/{projectName}/email/log/{mailId}/raw": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+                mailId: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * 메일 원문 (`message/rfc822`)
+         * @description 헤더 포함 원문 그대로. 받은 메일은 우리가 붙인 `Received`·`Authentication-Results`
+         *     까지, 보낸 메일은 릴레이에 넘긴 내용으로 조립한 것이다. `.eml` 로 내려받는다.
+         *     원문이 없는 줄(`hasRaw: false`)은 404. viewer 이상.
+         */
+        get: operations["getMailLogRaw"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/orgs/{orgSlug}/projects/{projectName}/auth": {
         parameters: {
             query?: never;
@@ -2539,6 +2687,12 @@ export interface components {
              */
             framework?: "next";
             triggers?: components["schemas"]["ManifestTriggers"];
+            /**
+             * @description 이메일 발신·수신 선언 (docs/email.md). `true` 면 워커가 `env.email`
+             *     을 받고 `export default { email() }` 이 수신 핸들러가 된다. `main`
+             *     이 있어야 뜻이 있다 — 정적 자산만으로는 보낼 코드도 받을 코드도 없다.
+             */
+            email?: boolean;
         };
         /**
          * @description 예약 실행 (docs/cron.md). 사용자가 `runlot.json` 에 적은 그대로 번들에
@@ -2657,6 +2811,16 @@ export interface components {
                  * @description 오브젝트 작업 수. 누적값이므로 합계에 포함된다
                  */
                 objOps: number;
+                /**
+                 * Format: int64
+                 * @description 보낸 메일 통 (docs/email.md §2.2)
+                 */
+                mailOut: number;
+                /**
+                 * Format: int64
+                 * @description 받은 메일 통
+                 */
+                mailIn: number;
             };
             /**
              * Format: int64
@@ -2692,6 +2856,86 @@ export interface components {
              * @description 누적 (델타의 합)
              */
             objOps: number;
+            /**
+             * Format: int64
+             * @description 누적 (델타의 합)
+             */
+            mailOut: number;
+            /**
+             * Format: int64
+             * @description 누적 (델타의 합)
+             */
+            mailIn: number;
+        };
+        /** @description 프로젝트의 이메일 상태다 (docs/email.md §5). */
+        EmailStatus: {
+            /** @description 켜졌는가. `project_email` 행의 존재가 유일한 표현이다 (0038). */
+            granted: boolean;
+            /**
+             * @description 프로젝트의 메일 도메인. 수신은 `*@<address>` 전부다.
+             * @example matzip.wickedev.runlot.email
+             */
+            address: string;
+            /**
+             * @description 발신자 주소. `env.email.send` 가 보내는 메일의 From 이다.
+             * @example matzip@matzip.wickedev.runlot.email
+             */
+            from: string;
+            /** @description 시간당 발신 상한. 인증 메일과 같은 통이다. */
+            perHour: number;
+            /**
+             * Format: int64
+             * @description 지금 시간대에 보낸 통
+             */
+            sentLastHour: number;
+            /**
+             * Format: int64
+             * @description 지금 시간대에 받은 통
+             */
+            receivedLastHour: number;
+            /**
+             * Format: int64
+             * @description 최근 24 시간에 보낸 통
+             */
+            sent24h: number;
+            /**
+             * Format: int64
+             * @description 최근 24 시간에 받은 통
+             */
+            received24h: number;
+            /** @description 이 배치의 메일 도메인 접미사. 비면 이메일을 켤 수 없다. */
+            mailDomain: string;
+        };
+        /** @description 메일 로그 한 줄 (docs/email.md §6.1). */
+        MailLogEntry: {
+            /** Format: uuid */
+            mailId: string;
+            /** Format: uuid */
+            projectId: string;
+            /** @enum {string} */
+            direction: "in" | "out";
+            /** Format: date-time */
+            at: string;
+            from: string;
+            to: string[];
+            subject: string;
+            /** @description 발신: `sent` → `delivered`·`bounced`·`complained` (릴레이 피드백, docs/email.md §6.2) 또는 `failed` / 수신: `ok`·`rejected`·`no_handler`·`exception` */
+            outcome: string;
+            /** @description 거절 문장·오류 문장 — 사람이 읽는 한 줄 */
+            detail?: string;
+            /** @description 수신의 Authentication-Results */
+            authResults?: string;
+            /** Format: int64 */
+            sizeBytes: number;
+            /** @description 원문이 있는가 */
+            hasRaw: boolean;
+        };
+        MailLogPage: {
+            entries: components["schemas"]["MailLogEntry"][];
+            /** @description 다음 장. 없으면 끝 */
+            cursor?: string;
+            /** @description 이 org 의 보관 일수 */
+            keepDays: number;
         };
         /**
          * @description 프로젝트 전용 오브젝트 스토리지 상태다 (docs/storage.md §7).
@@ -3278,6 +3522,43 @@ export interface operations {
             400: components["responses"]["BadRequest"];
         };
     };
+    sesHook: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "text/plain": string;
+            };
+        };
+        responses: {
+            /** @description 받았다 (모르는 사건 종류·모르는 id 도 200) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            400: components["responses"]["BadRequest"];
+            /** @description SNS 서명이 맞지 않는다 */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description 웹훅이 꺼져 있다 */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getMe: {
         parameters: {
             query?: never;
@@ -4313,6 +4594,198 @@ export interface operations {
             };
         };
     };
+    getEmail: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description 이메일 상태 */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EmailStatus"];
+                };
+            };
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            /** @description `no_core` */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    grantEmail: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description 부여 상태 (이미 있었으면 기존 값) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EmailStatus"];
+                };
+            };
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            /** @description `email_unavailable` — 이 배치에 메일 도메인이 없다. `email_address_taken` — 다른 프로젝트가 같은 주소를 쥐고 있다 */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description `no_core` */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    revokeEmail: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description 껐다 */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            /** @description `no_core` */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    listMailLog: {
+        parameters: {
+            query?: {
+                /** @description 비면 둘 다 */
+                direction?: "in" | "out";
+                /** @description 앞 장의 `cursor` */
+                cursor?: string;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description 한 장 */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MailLogPage"];
+                };
+            };
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    getMailLog: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+                mailId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description 한 통 */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MailLogEntry"];
+                };
+            };
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    getMailLogRaw: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                projectName: components["parameters"]["ProjectName"];
+                mailId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description 원문 */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "message/rfc822": string;
+                };
+            };
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
     getAuth: {
         parameters: {
             query?: never;