rootr-cli 0.8.0 → 0.9.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`);
   }
@@ -602,6 +651,25 @@ export class RootrClient {
     });
   }
 
+  /**
+   * 뷰를 하나 **덧붙인다**(기존 뷰는 그대로). 표를 만들 때만 뷰를 정할 수 있어서,
+   * 노션에서 뷰가 넷인 표를 옮기면 하나밖에 못 두던 문제를 푼다.
+   */
+  async createDatabaseView(databaseId, { name, type, groupBy, dateProp, endDateProp } = {}) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/views`, {
+      method: 'POST',
+      body: { name, type, groupBy, dateProp, endDateProp },
+    });
+  }
+
+  /** 뷰 하나를 지운다. 마지막 하나는 못 지운다. 행 값은 안 지워진다. */
+  async deleteDatabaseView(databaseId, viewId) {
+    return this.request(
+      `/databases/${encodeURIComponent(databaseId)}/views/${encodeURIComponent(viewId)}`,
+      { method: 'DELETE' },
+    );
+  }
+
   /**
    * 뷰 하나만 고친다(이름·감출 컬럼·그룹 기준). PATCH /databases/:id 는 views 배열을
    * 통째로 갈아끼워서 빠뜨린 뷰가 사라지는데, 여기서는 서버가 그 뷰만 병합한다.
@@ -618,25 +686,29 @@ export class RootrClient {
     return this.request(`/databases/${encodeURIComponent(databaseId)}`);
   }
 
-  /** All rows of a database, in position order. Returns the raw rows array. */
-  async listRows(databaseId) {
-    const data = await this.request(`/databases/${encodeURIComponent(databaseId)}/rows`);
+  /**
+   * All rows of a database, in position order. Returns the raw rows array.
+   * DB-BODY — `withBody` 를 주면 행마다 상세 내용(본문 메모)까지 함께 온다.
+   */
+  async listRows(databaseId, { withBody = false } = {}) {
+    const query = withBody ? '?body=1' : '';
+    const data = await this.request(`/databases/${encodeURIComponent(databaseId)}/rows${query}`);
     if (Array.isArray(data)) return data;
     if (data && Array.isArray(data.rows)) return data.rows;
     return [];
   }
 
-  async createRow(databaseId, { values, position } = {}) {
+  async createRow(databaseId, { values, position, body } = {}) {
     return this.request(`/databases/${encodeURIComponent(databaseId)}/rows`, {
       method: 'POST',
-      body: { values, position },
+      body: { values, position, body },
     });
   }
 
-  async updateRow(databaseId, rowId, { values, position } = {}) {
+  async updateRow(databaseId, rowId, { values, position, body } = {}) {
     return this.request(
       `/databases/${encodeURIComponent(databaseId)}/rows/${encodeURIComponent(rowId)}`,
-      { method: 'PATCH', body: { values, position } },
+      { method: 'PATCH', body: { values, position, body } },
     );
   }
 
@@ -651,10 +723,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 },
     });
   }
 
@@ -1132,13 +1205,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',