sfora-cli 0.6.0 → 0.8.0

package/dist/api-client.js

@@ -26,14 +26,18 @@ function routeBase(kind) {
 export class SforaApiClient {
     #baseUrl;
     #apiKey;
+    #actAs;
     constructor(config) {
         this.#baseUrl = config.baseUrl.replace(/\/+$/, "");
         this.#apiKey = config.apiKey;
+        this.#actAs = config.actAs;
     }
     // ─── HTTP plumbing ──────────────────────────────────────────────
     async #request(method, path, body) {
         const headers = Object.create(null);
         headers.Authorization = `Bearer ${this.#apiKey}`;
+        if (this.#actAs)
+            headers["X-Sfora-Act-As"] = this.#actAs;
         if (body !== undefined)
             headers["Content-Type"] = "text/markdown";
         let res;
@@ -135,12 +139,47 @@ export class SforaApiClient {
         const file = encodeURIComponent(filename);
         await this.#request("DELETE", `/v1/fs/projects/${slug}/${base}/${file}`);
     }
+    // ─── Notes (docs) ────────────────────────────────────────────────
+    /** `GET …/docs` — the project's notes, most-recently-edited first. */
+    async listNotes(projectSlug) {
+        const slug = encodeURIComponent(projectSlug);
+        const data = await this.#json(`/v1/fs/projects/${slug}/docs`);
+        return data.docs ?? [];
+    }
+    /** `GET …/docs/:filename.md`. Returns the raw markdown body. */
+    async readNote(projectSlug, filename) {
+        const slug = encodeURIComponent(projectSlug);
+        const file = encodeURIComponent(filename);
+        return this.#text(`/v1/fs/projects/${slug}/docs/${file}`);
+    }
+    // ─── Pull requests (read-only) ───────────────────────────────────
+    /** `GET …/pulls` — the project's synced pull requests, open first. */
+    async listPulls(projectSlug) {
+        const slug = encodeURIComponent(projectSlug);
+        const data = await this.#json(`/v1/fs/projects/${slug}/pulls`);
+        return data.pulls ?? [];
+    }
+    /**
+     * `GET …/pulls/:number` — one PR as markdown: metadata, the cards it resolves,
+     * and the unified diff. Returns the raw markdown body.
+     */
+    async readPull(projectSlug, number) {
+        const slug = encodeURIComponent(projectSlug);
+        return this.#text(`/v1/fs/projects/${slug}/pulls/${number}`);
+    }
     // ─── Kanban board ────────────────────────────────────────────────
-    /** `GET …/board` — list the project's columns (auto-creates the board on first call). */
-    async listColumns(projectSlug) {
+    /**
+     * `GET …/board` — board sharing state + columns (auto-creates the board on
+     * first call). `publicSlug` is null unless the board is shared publicly.
+     */
+    async getBoardMeta(projectSlug) {
         const slug = encodeURIComponent(projectSlug);
         const data = await this.#json(`/v1/fs/projects/${slug}/board`);
-        return data.columns;
+        return { publicSlug: data.publicSlug ?? null, columns: data.columns };
+    }
+    /** `GET …/board` — list the project's columns (auto-creates the board on first call). */
+    async listColumns(projectSlug) {
+        return (await this.getBoardMeta(projectSlug)).columns;
     }
     /** `GET …/board/:column` — list cards in a column. `column` is the `NN-slug` dirname. */
     async listCards(projectSlug, columnDir) {
@@ -239,6 +278,40 @@ export class SforaApiClient {
             throw await this.#toError(res);
         return (await res.json());
     }
+    // ─── Post actions (comment / react) ─────────────────────────────
+    /** `POST /v1/posts/:postId/comments` — add a comment to a post. */
+    async createComment(postId, body) {
+        const res = await fetch(`${this.#baseUrl}/v1/posts/${encodeURIComponent(postId)}/comments`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.#apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ body }),
+        });
+        if (!res.ok)
+            throw await this.#toError(res);
+        const data = (await res.json());
+        return { id: data.comment?._id ?? "" };
+    }
+    /**
+     * `POST /v1/posts/:postId/reactions` — toggle an emoji reaction on a post.
+     * Returns whether the reaction is now on (`reacted: true`) or off.
+     */
+    async reactToPost(postId, emoji) {
+        const res = await fetch(`${this.#baseUrl}/v1/posts/${encodeURIComponent(postId)}/reactions`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.#apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ emoji }),
+        });
+        if (!res.ok)
+            throw await this.#toError(res);
+        const data = (await res.json());
+        return data.reaction ?? { content: emoji, reacted: true };
+    }
     /** `GET /v1/fs/inbox/mentions.md` — markdown summary of unread mentions. */
     async readInbox() {
         return this.#text("/v1/fs/inbox/mentions.md");