rootr-cli 0.8.1 → 0.10.0

package/lib/client.js

@@ -348,6 +348,55 @@ export class RootrClient {
     });
   }
 
+  // ── DB-PERM-001 / DB-WATCH — 표에 거는 자물쇠와 알림 규칙 ──────────────
+  //
+  // 노션에 없는 것들이라, 에이전트가 표를 만들어 놓고도 "지원서는 서로 못 보게" 같은
+  // 요구를 못 들어주는 일이 있었다. 만들 수 있으면 잠글 수도 있어야 한다.
+
+  async getDatabasePermissions(databaseId) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/permissions`);
+  }
+
+  async setDatabasePermissions(databaseId, permissions) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/permissions`, {
+      method: 'PATCH',
+      body: permissions,
+    });
+  }
+
+  async getDatabaseNotifications(databaseId) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/notifications`);
+  }
+
+  async setDatabaseNotifications(databaseId, watchers) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/notifications`, {
+      method: 'PUT',
+      body: { watchers },
+    });
+  }
+
+  // ── PUBLIC-DOCS — 발행한 문서에 올라온 변경 제안 ────────────────────────
+
+  async listDocumentCommits(documentId, status = 'OPEN') {
+    return this.request(
+      `/documents/${encodeURIComponent(documentId)}/commits?status=${encodeURIComponent(status)}`,
+    );
+  }
+
+  async mergeDocumentCommit(documentId, commitId, force = false) {
+    return this.request(
+      `/documents/${encodeURIComponent(documentId)}/commits/${encodeURIComponent(commitId)}/merge`,
+      { method: 'POST', body: force ? { force: true } : {} },
+    );
+  }
+
+  async rejectDocumentCommit(documentId, commitId, reason) {
+    return this.request(
+      `/documents/${encodeURIComponent(documentId)}/commits/${encodeURIComponent(commitId)}/reject`,
+      { method: 'POST', body: reason ? { reason } : {} },
+    );
+  }
+
   async getDocumentPublicStatus(documentId) {
     return this.request(`/documents/${encodeURIComponent(documentId)}/public-status`);
   }
@@ -595,13 +644,46 @@ export class RootrClient {
    * building a table by adding columns one at a time made the order depend on
    * the order of the calls, which is how migrated tables came out scrambled.
    */
-  async createDatabase(workspace, { name, parentId, path, createParents, autoRename, icon, properties, views, rows } = {}) {
+  async createDatabase(workspace, { name, parentId, path, createParents, autoRename, icon, properties, views, rows, rowPageType } = {}) {
     return this.request(`/workspaces/${encodeURIComponent(workspace)}/databases`, {
       method: 'POST',
-      body: { name, parentId, path, createParents, autoRename, icon, properties, views, rows },
+      body: { name, parentId, path, createParents, autoRename, icon, properties, views, rows, rowPageType },
+    });
+  }
+
+  /**
+   * SIGN-001 — 이 표의 행을 열었을 때 나오는 상세 문서를 서명문서로 바꾼다.
+   * 그 뒤로 만들어지는 행마다 서명문서(연구노트)가 붙는다.
+   */
+  async setDatabaseRowPageType(databaseId, rowPageType) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}`, {
+      method: 'PATCH',
+      body: { rowPageType },
+    });
+  }
+
+  /**
+   * 뷰를 하나 **덧붙인다**(기존 뷰는 그대로). 표를 만들 때만 뷰를 정할 수 있어서,
+   * 노션에서 뷰가 넷인 표를 옮기면 하나밖에 못 두던 문제를 푼다.
+   */
+  async createDatabaseView(
+    databaseId,
+    { name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths } = {},
+  ) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/views`, {
+      method: 'POST',
+      body: { name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths },
     });
   }
 
+  /** 뷰 하나를 지운다. 마지막 하나는 못 지운다. 행 값은 안 지워진다. */
+  async deleteDatabaseView(databaseId, viewId) {
+    return this.request(
+      `/databases/${encodeURIComponent(databaseId)}/views/${encodeURIComponent(viewId)}`,
+      { method: 'DELETE' },
+    );
+  }
+
   /**
    * 뷰 하나만 고친다(이름·감출 컬럼·그룹 기준). PATCH /databases/:id 는 views 배열을
    * 통째로 갈아끼워서 빠뜨린 뷰가 사라지는데, 여기서는 서버가 그 뷰만 병합한다.
@@ -655,10 +737,11 @@ export class RootrClient {
   // PATCH /databases/:id replaces the whole properties array, so rebuilding it
   // client-side drops any column left out. These merge server-side instead.
 
-  async addColumn(databaseId, { name, type, options } = {}) {
+  async addColumn(databaseId, { name, type, options, relationDatabaseId, formula, rollup, prefix } = {}) {
     return this.request(`/databases/${encodeURIComponent(databaseId)}/columns`, {
       method: 'POST',
-      body: { name, type, options },
+      // 계산 칸(수식·롤업·번호)은 설정이 곧 그 칸이라 같이 보내야 한다.
+      body: { name, type, options, relationDatabaseId, formula, rollup, prefix },
     });
   }
 
@@ -1136,13 +1219,75 @@ export class RootrClient {
     });
   }
 
-  /** Submitted responses, most recent first. */
-  async listFormResponses(formId) {
-    const data = await this.request(`/forms/${encodeURIComponent(formId)}/responses`);
+  // ── 문서·폴더 접근 권한(공개범위) ────────────────────────────────
+  // 화면의 "공개범위"·"권한" 창이 하는 일을 그대로 연다. 관리 권한이 있는
+  // 사람만 부를 수 있고, 없으면 서버가 403으로 막는다.
+
+  /** 이 노드의 공개범위와 직접·상속 권한을 함께 읽는다. */
+  async getNodeAccess(nodeId) {
+    return this.request(`/nodes/${encodeURIComponent(nodeId)}/permissions`);
+  }
+
+  /** 공개범위를 정한다. null이면 상위 폴더/워크스페이스 기본값을 따른다. */
+  async setNodeVisibility(nodeId, visibility) {
+    return this.request(`/nodes/${encodeURIComponent(nodeId)}/visibility`, {
+      method: 'POST',
+      body: { visibility: visibility ?? null },
+    });
+  }
+
+  /** 특정 사람/그룹에게 이 노드의 권한을 준다(이미 있으면 등급만 바뀐다). */
+  async grantNodePermission(nodeId, { subjectType = 'USER', subjectId, level }) {
+    return this.request(`/nodes/${encodeURIComponent(nodeId)}/permissions`, {
+      method: 'POST',
+      body: { subjectType, subjectId, level },
+    });
+  }
+
+  /** 준 권한을 거둔다. */
+  async revokeNodePermission(nodeId, { subjectType = 'USER', subjectId }) {
+    return this.request(`/nodes/${encodeURIComponent(nodeId)}/permissions`, {
+      method: 'DELETE',
+      body: { subjectType, subjectId },
+    });
+  }
+
+  /**
+   * Submitted responses, most recent first.
+   * `latestPerRespondent`이면 같은 사람이 여러 번 낸 것 중 마지막 것만 남긴다
+   * (누가 냈는지 모르는 익명 제출은 합치지 않는다 — 합칠 근거가 없다).
+   */
+  async listFormResponses(formId, { latestPerRespondent } = {}) {
+    const qs = latestPerRespondent ? '?latestPerRespondent=true' : '';
+    const data = await this.request(`/forms/${encodeURIComponent(formId)}/responses${qs}`);
     if (data && Array.isArray(data.responses)) return data.responses;
     return [];
   }
 
+  /**
+   * 응답 모을 곳을 새로 만들어 연결한다. 'database'면 폼 질문 그대로 칸이 생기고,
+   * 'spreadsheet'면 응답이 깔리는 시트가 한 장 생긴다. 미리 만들어 둘 필요가 없다.
+   */
+  async createFormCollector(formId, target) {
+    return this.request(`/forms/${encodeURIComponent(formId)}/collect`, {
+      method: 'POST',
+      body: { target },
+    });
+  }
+
+  /** 이미 낸 응답의 내용을 고친다(폼의 검사 규칙을 그대로 다시 통과해야 한다). */
+  async updateFormResponse(responseId, values) {
+    return this.request(`/form-responses/${encodeURIComponent(responseId)}`, {
+      method: 'PATCH',
+      body: { values },
+    });
+  }
+
+  /** 응답 한 건을 지운다. */
+  async deleteFormResponse(responseId) {
+    return this.request(`/form-responses/${encodeURIComponent(responseId)}`, { method: 'DELETE' });
+  }
+
   async createFormResponse(formId, values) {
     return this.request(`/forms/${encodeURIComponent(formId)}/responses`, {
       method: 'POST',
@@ -1160,4 +1305,123 @@ export class RootrClient {
     if (data && Array.isArray(data.links)) return data.links;
     return [];
   }
+
+  // ── SIGN-001: 서명문서 · 연구노트 ────────────────────────────────────
+  //
+  // 마크다운 문서인데 올리는 순간 본문이 얼고, 결재라인에 적힌 사람들이 차례로
+  // 서명하면 서명마다 시점확인(TSA)과 해시 체이닝이 붙는다. 서명·올리기·반려는
+  // 메일로 받은 6자리 확인 코드를 함께 보내야 한다 — 서버가 개인키를 보관하는
+  // 구조에서 "본인이 눌렀다"의 유일한 증거라, 코드 없이 대신 눌러 줄 수는 없다.
+
+  /** 서명문서 만들기 — 본문·모드·결재라인까지 한 번에. */
+  async createSignedDoc(workspaceId, body = {}) {
+    return this.request(`/workspaces/${encodeURIComponent(workspaceId)}/signed-docs`, {
+      method: 'POST',
+      body,
+    });
+  }
+
+  /** 지금 상태: 결재라인·단계별 진행·서명 목록·본문이 그대로인지. */
+  async getSignedDoc(nodeId) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}`);
+  }
+
+  /** 결재라인 다시 짜기(올리기 전에만). steps 순서가 곧 서명 순서다. */
+  async setApprovalLine(nodeId, steps) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/approval-line`, {
+      method: 'PUT',
+      body: { steps },
+    });
+  }
+
+  /** 연구노트 프리셋: 기재자(나) → 점검자 두 단계. */
+  async applyResearchNotePreset(nodeId, { reviewerUserId, noteMeta } = {}) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/research-note-preset`, {
+      method: 'POST',
+      body: { reviewerUserId, noteMeta },
+    });
+  }
+
+  /** 확인 코드를 본인 메일로 보낸다. 문서 하나용. */
+  async requestSigningCode(nodeId) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/request-code`, {
+      method: 'POST',
+      body: {},
+    });
+  }
+
+  /** 확인 코드 — 묶음 서명용(워크스페이스 단위로 한 번). */
+  async requestBulkSigningCode(workspaceId) {
+    return this.request(`/workspaces/${encodeURIComponent(workspaceId)}/signed-docs/request-code`, {
+      method: 'POST',
+      body: {},
+    });
+  }
+
+  /** 올리기 = 본문을 얼리고 기안자가 첫 도장을 찍는다. */
+  async submitSignedDoc(nodeId, { code } = {}) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/submit`, {
+      method: 'POST',
+      body: { code },
+    });
+  }
+
+  /** 내 차례에 서명한다. */
+  async signSignedDoc(nodeId, { code } = {}) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/sign`, {
+      method: 'POST',
+      body: { code },
+    });
+  }
+
+  /** 반려 — 사유는 필수다. 반려되면 다시 고칠 수 있게 풀린다. */
+  async rejectSignedDoc(nodeId, { comment, code } = {}) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/reject`, {
+      method: 'POST',
+      body: { comment, code },
+    });
+  }
+
+  /** 아직 아무도 서명하지 않은 초안을 다시 열어 고칠 수 있게 한다. */
+  async reopenSignedDoc(nodeId) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/reopen`, { method: 'POST' });
+  }
+
+  /** 개정본 만들기 — 서명된 문서는 고치는 게 아니라 새 판을 낸다. */
+  async reviseSignedDoc(nodeId, note) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/revise`, {
+      method: 'POST',
+      body: { note },
+    });
+  }
+
+  /** 위변조 검증. 로그인 없이도 열려 있다(본문은 안 내려온다). */
+  async verifySignedDoc(nodeId) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/verify`);
+  }
+
+  /** 워크스페이스 서명문서 목록. pendingMine이면 "내 차례인 것"만. */
+  async listSignedDocs(workspaceId, { status, mode, pendingMine } = {}) {
+    const qs = new URLSearchParams();
+    if (status) qs.set('status', status);
+    if (mode) qs.set('mode', mode);
+    if (pendingMine) qs.set('pendingMine', 'true');
+    const q = qs.toString();
+    return this.request(
+      `/workspaces/${encodeURIComponent(workspaceId)}/signed-docs${q ? `?${q}` : ''}`,
+    );
+  }
+
+  /** 묶음 서명 — "이번 주 미점검 12건"을 한 번에. 코드 하나로 전부. */
+  async bulkSignSignedDocs(workspaceId, { nodeIds, code } = {}) {
+    return this.request(`/workspaces/${encodeURIComponent(workspaceId)}/signed-docs/bulk-sign`, {
+      method: 'POST',
+      body: { nodeIds, code },
+    });
+  }
+
+  /** 워크스페이스 원장(해시 체인) 전체 검증. */
+  async verifyLedger(workspaceId) {
+    return this.request(`/workspaces/${encodeURIComponent(workspaceId)}/ledger/verify`);
+  }
 }