@fusebase/fusebase-gate-sdk 2.3.16 → 2.3.17

package/dist/apis/NotesApi.d.ts

@@ -5,7 +5,7 @@
  * Domain: notes
  */
 import type { Client } from "../runtime/transport";
-import type { AddWorkspaceNoteAttachmentRequestContract, AddWorkspaceNoteAttachmentResponseContract, CreateWorkspaceNoteFolderRequestContract, CreateWorkspaceNoteFolderResponseContract, CreateWorkspaceNoteRequestContract, CreateWorkspaceNoteResponseContract, orgIdInPathRequired, WorkspaceIdInPathRequired, WorkspaceNoteContentResponseContract, WorkspaceNoteFolderListResponseContract, WorkspaceNoteIdInPathRequired, WorkspaceNoteListResponseContract, WorkspaceNoteParentIdInQueryOptional } from "../types";
+import type { AddWorkspaceNoteAttachmentRequestContract, AddWorkspaceNoteAttachmentResponseContract, AppendWorkspaceNoteContentRequestContract, CreateWorkspaceNoteFolderRequestContract, CreateWorkspaceNoteFolderResponseContract, CreateWorkspaceNoteRequestContract, CreateWorkspaceNoteResponseContract, orgIdInPathRequired, WorkspaceIdInPathRequired, WorkspaceNoteContentResponseContract, WorkspaceNoteFolderListResponseContract, WorkspaceNoteIdInPathRequired, WorkspaceNoteListResponseContract, WorkspaceNoteParentIdInQueryOptional } from "../types";
 export declare class NotesApi {
     private client;
     constructor(client: Client);
@@ -22,6 +22,19 @@ export declare class NotesApi {
         headers?: Record<string, string>;
         body: AddWorkspaceNoteAttachmentRequestContract;
     }): Promise<AddWorkspaceNoteAttachmentResponseContract>;
+    /**
+     * Append content to workspace note
+     * Appends text or html to the end of an existing workspace note without replacing current content, then returns the refreshed note md. Prefer a real workspace id; when the path workspaceId is `default`, gate resolves it to the organization's default workspace before calling note-service and editor-server. For markdown sources, apps should render markdown to html before calling this operation when formatting fidelity matters; otherwise send markdown-like text as `format: text`.
+     */
+    appendWorkspaceNoteContent(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            workspaceId: WorkspaceIdInPathRequired;
+            noteId: WorkspaceNoteIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: AppendWorkspaceNoteContentRequestContract;
+    }): Promise<WorkspaceNoteContentResponseContract>;
     /**
      * Create workspace note
      * Creates a note in the requested workspace. Prefer a real workspace id; when the path workspaceId is `default`, gate resolves it to the organization's default workspace before calling note-service and editor-server. When parentId is omitted, gate uses `default`. Optional initial text or html can be appended after creation.

package/dist/apis/NotesApi.js

@@ -26,6 +26,21 @@ class NotesApi {
             expectedContentType: "application/json",
         });
     }
+    /**
+     * Append content to workspace note
+     * Appends text or html to the end of an existing workspace note without replacing current content, then returns the refreshed note md. Prefer a real workspace id; when the path workspaceId is `default`, gate resolves it to the organization's default workspace before calling note-service and editor-server. For markdown sources, apps should render markdown to html before calling this operation when formatting fidelity matters; otherwise send markdown-like text as `format: text`.
+     */
+    async appendWorkspaceNoteContent(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/workspaces/:workspaceId/notes/:noteId/content",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "appendWorkspaceNoteContent",
+            expectedContentType: "application/json",
+        });
+    }
     /**
      * Create workspace note
      * Creates a note in the requested workspace. Prefer a real workspace id; when the path workspaceId is `default`, gate resolves it to the organization's default workspace before calling note-service and editor-server. When parentId is omitted, gate uses `default`. Optional initial text or html can be appended after creation.

package/dist/apis/PortalsApi.d.ts

@@ -5,7 +5,7 @@
  * Domain: portals
  */
 import type { Client } from "../runtime/transport";
-import type { AddPortalAppPageRequestContract, AddPortalAppPageResponseContract, AddPortalNoteBlockRequestContract, AddPortalNoteBlockResponseContract, BulkInviteToPortalRequestContract, BulkInviteToPortalResponseContract, CreatePortalFolderRequestContract, CreatePortalFolderResponseContract, CreatePortalPageWithNoteRequestContract, CreatePortalPageWithNoteResponseContract, CreatePortalRequestContract, CreatePortalResponseContract, DuplicatePortalItemRequestContract, DuplicatePortalItemResponseContract, DuplicatePortalRequestContract, globalIdInPathRequired, InvitePortalManagerRequestContract, InvitePortalManagerResponseContract, InviteToPortalRequestContract, InviteToPortalResponseContract, ListPortalContentResponseContract, orgIdInPathRequired, OrgPortalListResponseContract, PortalDetailContract, UpdatePortalAccessRequestContract, UpdatePortalAccessResponseContract, UpdatePortalCustomCodeRequestContract, UpdatePortalCustomCodeResponseContract } from "../types";
+import type { AddPortalAppPageRequestContract, AddPortalAppPageResponseContract, AddPortalBlockRequestContract, AddPortalBlockResponseContract, AddPortalNoteBlockRequestContract, AddPortalNoteBlockResponseContract, BulkInviteToPortalRequestContract, BulkInviteToPortalResponseContract, CreatePortalFolderRequestContract, CreatePortalFolderResponseContract, CreatePortalPageWithNoteRequestContract, CreatePortalPageWithNoteResponseContract, CreatePortalRequestContract, CreatePortalResponseContract, DuplicatePortalItemRequestContract, DuplicatePortalItemResponseContract, DuplicatePortalRequestContract, globalIdInPathRequired, InvitePortalManagerRequestContract, InvitePortalManagerResponseContract, InviteToPortalRequestContract, InviteToPortalResponseContract, ListPortalContentResponseContract, orgIdInPathRequired, OrgPortalListResponseContract, PortalDetailContract, UpdatePortalAccessRequestContract, UpdatePortalAccessResponseContract, UpdatePortalCustomCodeRequestContract, UpdatePortalCustomCodeResponseContract } from "../types";
 export declare class PortalsApi {
     private client;
     constructor(client: Client);
@@ -21,6 +21,18 @@ export declare class PortalsApi {
         headers?: Record<string, string>;
         body: AddPortalAppPageRequestContract;
     }): Promise<AddPortalAppPageResponseContract>;
+    /**
+     * Add a block of any palette type to a portal page
+     * Stages a single block of any supported type onto an existing portal page — the universal building block behind the customizer's 'Add new block' palette (no new page or sidebar item is created). Pass pageId (the target page node id from listPortalContent) and type. Supported types: note, content, embed, chat, info, docs, help, request, meetings, links, task-list, projection, files-dashboard, tasks-dashboard, chats-dashboard, files-recent, files-bucket, flexible. Type-specific fields: note/content require noteId; flexible requires template (e.g. {type:'text'|'image'|'title'|'code'|'form'|'dashboard'|'ai-agent'|'app-feature'|...}) and may carry bricks; embed/info/projection/task-list and others take their fields via the free-form `properties` object (e.g. embedType/content/contentUrl, image/link, sourcePortalId/sourcePageId/sourceBlockId, taskListIds). Use addPortalNoteBlock for the common note case or addPortalAppPage for an app on its own page. Note: a `content` block renames the page to its title, so leave title empty for content blocks. The block is staged in the portal's customizer draft (not published immediately); the owner reviews and publishes it. Returns the block id and the draft branch/seqs. Requires portals.write access.
+     */
+    addPortalBlock(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            portalId: globalIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: AddPortalBlockRequestContract;
+    }): Promise<AddPortalBlockResponseContract>;
     /**
      * Add an existing Fusebase note as a block to a portal page
      * Embeds an existing Fusebase note as a content block on an existing portal page (no new page or sidebar item is created). The note must already exist in the portal's workspace and be shared into the portal (e.g. created via createPortalPageWithNote). Pass pageId (the target page node id, obtained from listPortalContent) and noteId. The block is staged in the portal's customizer draft (not published immediately): the portal owner opens the customizer, reviews the pending block, and publishes it. Returns the created block id and the draft branch/seqs. Requires portals.write access.

package/dist/apis/PortalsApi.js

@@ -26,6 +26,21 @@ class PortalsApi {
             expectedContentType: "application/json",
         });
     }
+    /**
+     * Add a block of any palette type to a portal page
+     * Stages a single block of any supported type onto an existing portal page — the universal building block behind the customizer's 'Add new block' palette (no new page or sidebar item is created). Pass pageId (the target page node id from listPortalContent) and type. Supported types: note, content, embed, chat, info, docs, help, request, meetings, links, task-list, projection, files-dashboard, tasks-dashboard, chats-dashboard, files-recent, files-bucket, flexible. Type-specific fields: note/content require noteId; flexible requires template (e.g. {type:'text'|'image'|'title'|'code'|'form'|'dashboard'|'ai-agent'|'app-feature'|...}) and may carry bricks; embed/info/projection/task-list and others take their fields via the free-form `properties` object (e.g. embedType/content/contentUrl, image/link, sourcePortalId/sourcePageId/sourceBlockId, taskListIds). Use addPortalNoteBlock for the common note case or addPortalAppPage for an app on its own page. Note: a `content` block renames the page to its title, so leave title empty for content blocks. The block is staged in the portal's customizer draft (not published immediately); the owner reviews and publishes it. Returns the block id and the draft branch/seqs. Requires portals.write access.
+     */
+    async addPortalBlock(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/portals/:portalId/blocks",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "addPortalBlock",
+            expectedContentType: "application/json",
+        });
+    }
     /**
      * Add an existing Fusebase note as a block to a portal page
      * Embeds an existing Fusebase note as a content block on an existing portal page (no new page or sidebar item is created). The note must already exist in the portal's workspace and be shared into the portal (e.g. created via createPortalPageWithNote). Pass pageId (the target page node id, obtained from listPortalContent) and noteId. The block is staged in the portal's customizer draft (not published immediately): the portal owner opens the customizer, reviews the pending block, and publishes it. Returns the created block id and the draft branch/seqs. Requires portals.write access.

package/dist/types/index.d.ts

@@ -20,7 +20,7 @@ export * from "./org-group/org-group";
 export type { CreateWorkspaceRequestContract, OrgInviteContract, OrgMagicLinkContract, OrgPortalContract, OrgPortalListResponseContract, OrgUserAddRequestContract, OrgUserAddResponseContract, OrgUserContract, OrgUserListResponseContract, OrgWorkspaceContract, OrgWorkspaceInviteContract, OrgWorkspaceListResponseContract, OrgWorkspaceMemberContract } from "./org-user/org-user";
 export * from "./orgs/orgs";
 export type { VerifyPortalFeatureContextTokenRequestContract, VerifyPortalFeatureContextTokenResponseContract } from "./portal-feature-context/portal-feature-context";
-export type { AddPortalAppPageRequestContract, AddPortalAppPageResponseContract, AddPortalNoteBlockRequestContract, AddPortalNoteBlockResponseContract, BulkInviteResultItemContract, BulkInviteToPortalRequestContract, BulkInviteToPortalResponseContract, BulkPortalInvitationContract, CreatePortalFolderRequestContract, CreatePortalFolderResponseContract, CreatePortalPageWithNoteRequestContract, CreatePortalPageWithNoteResponseContract, CreatePortalRequestContract, CreatePortalResponseContract, DuplicatePortalItemRequestContract, DuplicatePortalItemResponseContract, DuplicatePortalRequestContract, InvitePortalManagerRequestContract, InvitePortalManagerResponseContract, InviteToPortalRequestContract, InviteToPortalResponseContract, ListPortalContentResponseContract, PortalContentItemContract, PortalDetailContract, UpdatePortalAccessRequestContract, UpdatePortalAccessResponseContract, UpdatePortalCustomCodeRequestContract, UpdatePortalCustomCodeResponseContract, globalIdInPathRequired } from "./portals/portals";
+export type { AddPortalAppPageRequestContract, AddPortalAppPageResponseContract, AddPortalBlockRequestContract, AddPortalBlockResponseContract, AddPortalNoteBlockRequestContract, AddPortalNoteBlockResponseContract, BulkInviteResultItemContract, BulkInviteToPortalRequestContract, BulkInviteToPortalResponseContract, BulkPortalInvitationContract, CreatePortalFolderRequestContract, CreatePortalFolderResponseContract, CreatePortalPageWithNoteRequestContract, CreatePortalPageWithNoteResponseContract, CreatePortalRequestContract, CreatePortalResponseContract, DuplicatePortalItemRequestContract, DuplicatePortalItemResponseContract, DuplicatePortalRequestContract, InvitePortalManagerRequestContract, InvitePortalManagerResponseContract, InviteToPortalRequestContract, InviteToPortalResponseContract, ListPortalContentResponseContract, PortalContentItemContract, PortalDetailContract, UpdatePortalAccessRequestContract, UpdatePortalAccessResponseContract, UpdatePortalCustomCodeRequestContract, UpdatePortalCustomCodeResponseContract, globalIdInPathRequired } from "./portals/portals";
 export * from "./shared/common";
 export * from "./shared/enums";
 export type { GetHealth200ResponseContract } from "./shared/health";

package/dist/types/note/note.d.ts

@@ -53,6 +53,16 @@ export interface CreateWorkspaceNoteRequestContract {
 export interface CreateWorkspaceNoteResponseContract {
     note: WorkspaceNoteSummaryContract;
 }
+export interface AppendWorkspaceNoteContentRequestContract {
+    /**
+     * Text or html to append to the end of the existing note.
+     */
+    content: string;
+    /**
+     * Content format used with `content`. Defaults to `text`.
+     */
+    format?: WorkspaceNoteContentFormatContract | null;
+}
 export interface AddWorkspaceNoteAttachmentRequestContract {
     /**
      * Stored-file UUID returned by completeMultipartFileUpload.

package/dist/types/portals/portals.d.ts

@@ -129,6 +129,52 @@ export interface AddPortalNoteBlockResponseContract {
      */
     staged: boolean;
 }
+/**
+ * Block types the portal-service draft reducer (`blockFromDto`) understands.
+ * Any other value is rejected with 400 (the reducer throws on unknown types,
+ * which would otherwise fail the whole draft at publish time).
+ */
+export type PortalBlockType = "note" | "content" | "embed" | "chat" | "info" | "docs" | "help" | "request" | "meetings" | "links" | "task-list" | "projection" | "files-dashboard" | "tasks-dashboard" | "chats-dashboard" | "files-recent" | "files-bucket" | "flexible";
+export interface AddPortalBlockRequestContract {
+    /** Id of the existing portal page node to add the block to. */
+    pageId: string;
+    /** Block type to stage (see the op description for per-type fields). */
+    type: PortalBlockType;
+    /** Optional block title (defaults to the page's current title). */
+    title?: string;
+    /** Required for `note`/`content` blocks: the Fusebase note to embed. */
+    noteId?: string;
+    /** Required for `flexible` blocks: the flexible template, e.g. `{type:"text"}`. */
+    template?: {
+        type: string;
+        view?: string;
+    };
+    /** Optional bricks for `flexible` blocks. */
+    bricks?: unknown[];
+    /**
+     * Optional type-specific fields merged into the staged block verbatim, e.g.
+     * `embedType`/`content`/`contentUrl` for embed, `image`/`link` for info,
+     * `sourcePortalId`/`sourcePageId`/`sourceBlockId` for projection,
+     * `taskListIds` for task-list. Also overrides scaffold defaults (colspan,
+     * rowspan, …) when provided.
+     */
+    properties?: Record<string, unknown>;
+}
+export interface AddPortalBlockResponseContract {
+    /** Id of the created block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /**
+     * Always true: the block is staged in the portal's customizer draft, not yet
+     * live. The portal owner reviews and publishes it from the customizer.
+     */
+    staged: boolean;
+}
 export interface AddPortalAppPageRequestContract {
     /**
      * Global id of the published Fusebase product that owns the app (the product

package/dist/types/token/token.d.ts

@@ -43,6 +43,7 @@ export interface TokenListPaginationContract {
     limit: number;
     total: number;
     total_pages: number;
+    total_is_approximate?: boolean;
 }
 export interface RevokeTokenResponseContract {
     success: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusebase/fusebase-gate-sdk",
-  "version": "2.3.16",
+  "version": "2.3.17",
   "description": "TypeScript SDK for Fusebase Gate APIs - Generated from contract introspection",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/release-notes/2.3.16-sdk.2.md

@@ -0,0 +1,49 @@
+# Release Notes 2.3.16-sdk.2
+
+- Current ref: `HEAD`
+- Previous tag: `v2.3.16`
+- Generated at: 2026-06-30T20:37:18.064Z
+
+## Included Drafts
+
+- `docs/release-notes/2026-06-30-append-workspace-note-content.md` - Append workspace note content
+
+## Summary
+
+### Append workspace note content
+
+Add an append-only workspace note content operation for apps that need to add content to an existing note without replacing the note body.
+
+
+## API / SDK Changes
+
+### Append workspace note content
+
+- Added `appendWorkspaceNoteContent`.
+- The operation accepts a workspace note id plus non-empty `content`, with optional `format: "text" | "html"`.
+- The operation appends to the end of the note and returns the refreshed note metadata plus `note.md`.
+- Regenerated SDK/OpenAPI artifacts include the new Notes API method and request contract.
+
+
+## Consumer Impact
+
+### Append workspace note content
+
+Apps can now update existing notes by appending text or HTML instead of creating a new note. For Markdown sources, apps should render Markdown to HTML before calling the operation when formatting fidelity matters; otherwise send the content as text.
+
+
+## Verification
+
+### Append workspace note content
+
+- `npm run build:sdk`
+- `npm run mcp:skills:generate`
+- `npm run mcp:skills:validate`
+- `npm run mcp:skills:copy-to-apps-cli:local`
+
+
+## Follow-ups
+
+### Append workspace note content
+
+- Full note replacement/editing remains a separate product/API decision because it needs a canonical Markdown-to-editor-content conversion path.

package/release-notes/2.3.17.md

@@ -0,0 +1,9 @@
+# Release Notes 2.3.17
+
+- Current ref: `HEAD`
+- Previous tag: `v2.3.17`
+- Generated at: 2026-07-01T12:10:32.061Z
+
+## Included Drafts
+
+- None

package/release-notes/latest.md

@@ -1,8 +1,8 @@
-# Release Notes 2.3.16
+# Release Notes 2.3.17
 
 - Current ref: `HEAD`
-- Previous tag: `v2.3.16`
-- Generated at: 2026-06-30T11:57:52.659Z
+- Previous tag: `v2.3.17`
+- Generated at: 2026-07-01T12:10:32.061Z
 
 ## Included Drafts
 

package/release-notes/2.3.16-sdk.1.md

@@ -1,9 +0,0 @@
-# Release Notes 2.3.16-sdk.1
-
-- Current ref: `HEAD`
-- Previous tag: `v2.3.16-sdk.0`
-- Generated at: 2026-06-30T03:25:33.572Z
-
-## Included Drafts
-
-- None

package/release-notes/2.3.16.md

@@ -1,9 +0,0 @@
-# Release Notes 2.3.16
-
-- Current ref: `HEAD`
-- Previous tag: `v2.3.16`
-- Generated at: 2026-06-30T11:57:52.659Z
-
-## Included Drafts
-
-- None