@runlot/api 0.1.0-rc.39 → 0.1.0-rc.40

package/dist/schema.d.ts

@@ -1399,10 +1399,14 @@ export interface paths {
         get: operations["listMembers"];
         put?: never;
         /**
-         * 기존 사용자를 멤버로 넣는다 (`runlot org add-member`)
-         * @description **초대가 아니다** (docs/local-mvp.md §3 — 초대 UI 제외). 사용자는 이미
-         *     한 번 로그인해 `users` 에 있어야 하고, 없으면 404 `user_not_found`.
-         *     이미 멤버면 409 `already_member` — 역할을 바꾸는 것은 PUT 이다.
+         * 기존 사용자를 멤버로 넣는다 (운영·자동화용)
+         * @description **초대가 아니다.** 사용자는 이미 한 번 로그인해 `users` 에 있어야 하고
+         *     (`provider`+`subject` 로 가리킨다), 없으면 404 `user_not_found`. 이미
+         *     멤버면 409 `already_member` — 역할을 바꾸는 것은 PUT 이다.
+         *
+         *     사람을 부르는 표면은 이것이 아니라 `POST …/invites` 다
+         *     (docs/members.md): GitHub 의 `subject` 는 숫자 id 라 관리자가 알 수
+         *     없는 값이고, 이 끝점은 그것을 이미 아는 자동화의 것이다.
          *
          *     admin 이상. 감사 `member.add`.
          */
@@ -1413,6 +1417,133 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/orgs/{orgSlug}/invites": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+            };
+            cookie?: never;
+        };
+        /**
+         * 대기 중인 초대 (`runlot member invites`)
+         * @description **admin 이상.** 멤버 목록은 member 이상이 보지만 초대 목록은 다르다 —
+         *     아직 조직에 없는 사람들의 이메일이고, 그것은 명부가 아니라 관리 작업의
+         *     상태다.
+         *
+         *     수락·폐기된 초대는 안 나온다 (이력의 자리는 감사 기록이다). 만료된
+         *     초대는 나온다 — 거기서 관리자가 할 일이 재발송이다.
+         */
+        get: operations["listInvites"];
+        put?: never;
+        /**
+         * 이메일로 초대한다 (`runlot member invite`)
+         * @description admin 이상. 메일은 즉시 나가지 않는다 — cp-core 의 발송 회차가 큐를
+         *     훑는다 (`sentAt` 이 비어 있으면 아직 큐에 있다는 뜻이다).
+         *
+         *     **같은 주소로 다시 부르면 재발송이다**: 새 초대가 아니라 같은 행이
+         *     갱신되고 (토큰·만료가 새로 서고 역할이 바뀐다) 200 으로 답한다. 새
+         *     초대는 201 이다.
+         *
+         *     이미 멤버인 주소는 409 `already_member`. 대기 중 초대가 너무 많으면
+         *     409 `too_many_invites` — 요금제 한도가 아니라 발신 남용 방지다.
+         *
+         *     수명은 이레, 한 번 쓰면 끝, 언제든 폐기할 수 있다. 감사 `member.invite`.
+         */
+        post: operations["createInvite"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orgs/{orgSlug}/invites/{inviteId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                inviteId: string;
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * 초대를 취소한다 (`runlot member uninvite`)
+         * @description admin 이상. 아직 안 나간 메일은 **안 나간다** — 폐기가 발송 큐도 비운다.
+         *     이미 수락·폐기된 초대는 404. 감사 `member.uninvite`.
+         */
+        delete: operations["revokeInvite"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/invites/{token}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                token: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * 초대 미리보기 (인증 없음)
+         * @description **인증이 없다.** 초대 링크를 받은 사람은 아직 로그인하지 않았고, 로그인
+         *     하기 전에 이것이 무엇인지 알아야 한다. 토큰은 32 바이트 난수라 열거할
+         *     수 없고, 그래서 여는 대가가 "우리가 메일을 보낸 사람이 조직 이름을
+         *     본다" 로 끝난다.
+         *
+         *     **상태는 오류가 아니라 값이다** (`state`). 만료된 초대에 404 를 주면
+         *     화면이 "링크가 틀렸다" 와 "링크가 늙었다" 를 구분하지 못한다.
+         *
+         *     모르는 토큰은 404 — 오래전에 폐기된 토큰과 같은 답이다.
+         */
+        get: operations["getInvite"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/invites/{token}/accept": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                token: string;
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 초대를 수락한다
+         * @description 로그인이 필요하다. **로그인한 계정의 이메일이 초대한 주소와 같아야
+         *     한다는 규칙은 없다** — GitHub 비공개 이메일로 로그인한 사람은
+         *     `users.email` 이 아예 없고, 그 규칙을 넣으면 그 사람은 어떤 조직에도
+         *     들어올 수 없다. 대신 수명 이레 · 한 번 쓰면 끝 · 언제든 폐기이고,
+         *     감사 기록에 초대한 주소와 수락한 계정이 **둘 다** 남는다.
+         *
+         *     **이미 멤버면 역할이 안 바뀐다** (`alreadyMember: true`). 초대장 하나가
+         *     admin 을 강등하는 표면이 되면 그 강등은 마지막-admin 검사를 지나지
+         *     않는다.
+         *
+         *     감사 `member.accept`.
+         */
+        post: operations["acceptInvite"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/orgs/{orgSlug}/members/{userId}": {
         parameters: {
             query?: never;
@@ -1434,9 +1565,14 @@ export interface paths {
         put: operations["setMemberRole"];
         post?: never;
         /**
-         * 멤버를 뺀다 (`runlot org remove-member`)
-         * @description admin 이상. 마지막 admin 은 뺄 수 없다 (409 `last_admin`). 감사
-         *     `member.remove`.
+         * 멤버를 뺀다 · 스스로 나간다 (`runlot member rm`, `runlot member leave`)
+         * @description **남을 빼는 것은 admin 이상, 자기를 빼는 것은 누구나** 할 수 있다
+         *     (`userId` 가 자기 자신이면 탈퇴다). admin 만 뺄 수 있게 두면 viewer 로
+         *     초대된 사람이 조직을 나갈 길이 아예 없다.
+         *
+         *     마지막 admin 은 뺄 수도 나갈 수도 없다 (409 `last_admin`). 감사는
+         *     제거가 `member.remove`, 탈퇴가 `member.leave` — 같은 문장이지만 다른
+         *     사건이라 이름이 갈린다.
          */
         delete: operations["removeMember"];
         options?: never;
@@ -3026,6 +3162,53 @@ export interface components {
             /** Format: date-time */
             addedAt: string;
         };
+        /**
+         * @description `expired` 는 시각 비교의 결과이지 열이 아니다 — 초대는 만료되었다고
+         *     표시되지 않고, 만료 시각이 지났을 뿐이다.
+         * @enum {string}
+         */
+        InviteState: "pending" | "expired" | "accepted" | "revoked";
+        /**
+         * @description **토큰이 없다.** 평문 토큰은 메일에만 실리고, cp-public 은 그 열을 읽지도
+         *     못한다 (마이그레이션 0043 의 열 단위 GRANT).
+         */
+        Invite: {
+            /** Format: uuid */
+            inviteId: string;
+            /** Format: email */
+            email: string;
+            role: components["schemas"]["Role"];
+            state: components["schemas"]["InviteState"];
+            /** @description 부른 사람의 이름 또는 이메일. */
+            invitedBy?: string;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            expiresAt: string;
+            /**
+             * Format: date-time
+             * @description 비어 있으면 아직 발송 큐에 있다 (발송은 cp-core 의 회차다).
+             */
+            sentAt?: string;
+            /** @description 마지막 발송 실패 이유. 성공해도 남을 수 있다. */
+            sendError?: string;
+        };
+        /** @description 토큰을 든 사람에게 보이는 초대 (인증 없이 답한다). */
+        InviteView: {
+            orgSlug: string;
+            orgName: string;
+            role: components["schemas"]["Role"];
+            /**
+             * Format: email
+             * @description **초대를 보낸 주소**다. 수락하는 계정의 주소와 다를 수 있고, 화면은
+             *     그 사실을 말해야 한다.
+             */
+            email: string;
+            invitedBy?: string;
+            state: components["schemas"]["InviteState"];
+            /** Format: date-time */
+            expiresAt: string;
+        };
         /**
          * @description 워커의 `env.<NAME>` 이 된다. `DB`·`ASSETS`(바인딩 `env.db`·`env.assets` 의 대문자 짝) 와 `RUNLOT_` 접두는 예약이다
          *     — 앞 둘은 이미 바인딩이고, 뒤는 노드가 프로세스 환경에 쓰는 이름
@@ -5954,6 +6137,169 @@ export interface operations {
             };
         };
     };
+    listInvites: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description 초대 목록 */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        invites: components["schemas"]["Invite"][];
+                    };
+                };
+            };
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    createInvite: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** Format: email */
+                    email: string;
+                    /** @description 기본값 `member`. */
+                    role?: components["schemas"]["Role"];
+                };
+            };
+        };
+        responses: {
+            /** @description 기존 초대를 다시 보냈다 */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Invite"];
+                };
+            };
+            /** @description 새 초대 */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Invite"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            /** @description 이미 멤버다 (`already_member`) · 대기 초대가 너무 많다 (`too_many_invites`) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    revokeInvite: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgSlug: components["parameters"]["OrgSlug"];
+                inviteId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description 취소했다 */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    getInvite: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                token: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description 초대 */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InviteView"];
+                };
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    acceptInvite: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                token: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description 수락했다 */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        orgSlug: string;
+                        orgName?: string;
+                        role: components["schemas"]["Role"];
+                        alreadyMember: boolean;
+                        invitedEmail?: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            /** @description 이미 수락됨 (`invite_used`) · 취소됨 (`invite_revoked`) · 만료됨 (`invite_expired`) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     setMemberRole: {
         parameters: {
             query?: never;