@fusebase/fusebase-gate-sdk 2.3.6 → 2.3.10

package/dist/apis/AppApisApi.d.ts

@@ -5,7 +5,7 @@
  * Domain: app-apis
  */
 import type { Client } from "../runtime/transport";
-import type { AppApiOperationContract, AppApiOperationListResponseContract, CallAppApiRequestContract, CallAppApiResponseContract, orgIdInPathRequired, VerifyAppApiContractsRequestContract, VerifyAppApiContractsResponseContract } from "../types";
+import type { AppApiOperationContract, AppApiOperationListResponseContract, CallAppApiRequestContract, CallAppApiResponseContract, orgIdInPathRequired, PublishedAppListResponseContract, VerifyAppApiContractsRequestContract, VerifyAppApiContractsResponseContract } from "../types";
 export declare class AppApisApi {
     private client;
     constructor(client: Client);
@@ -22,6 +22,20 @@ export declare class AppApisApi {
         headers?: Record<string, string>;
         body?: CallAppApiRequestContract;
     }): Promise<CallAppApiResponseContract>;
+    /**
+     * Find apps by name
+     * Resolves an app name into the productId/appId pair needed by addPortalAppPage. Returns the organization's apps, optionally filtered by a case-insensitive substring of the app or product title (name). status is 'published' when the app has a deployed version, otherwise 'draft'. When several apps match, all candidates are returned so the agent can disambiguate. Requires org.read access.
+     */
+    findPublishedApps(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+        };
+        query?: {
+            name?: string;
+            limit?: number;
+        };
+        headers?: Record<string, string>;
+    }): Promise<PublishedAppListResponseContract>;
     /**
      * Describe app API operation
      * Returns one published app API operation for the requested app and operation id.

package/dist/apis/AppApisApi.js

@@ -26,6 +26,21 @@ class AppApisApi {
             expectedContentType: "application/json",
         });
     }
+    /**
+     * Find apps by name
+     * Resolves an app name into the productId/appId pair needed by addPortalAppPage. Returns the organization's apps, optionally filtered by a case-insensitive substring of the app or product title (name). status is 'published' when the app has a deployed version, otherwise 'draft'. When several apps match, all candidates are returned so the agent can disambiguate. Requires org.read access.
+     */
+    async findPublishedApps(params) {
+        return this.client.request({
+            method: "GET",
+            path: "/:orgId/apps",
+            pathParams: params.path,
+            query: params.query,
+            headers: params.headers,
+            opId: "findPublishedApps",
+            expectedContentType: "application/json",
+        });
+    }
     /**
      * Describe app API operation
      * Returns one published app API operation for the requested app and operation id.

package/dist/apis/PortalsApi.d.ts

@@ -5,13 +5,37 @@
  * Domain: portals
  */
 import type { Client } from "../runtime/transport";
-import type { CreatePortalRequestContract, CreatePortalResponseContract, DuplicatePortalRequestContract, globalIdInPathRequired, InviteToPortalRequestContract, InviteToPortalResponseContract, ListPortalContentResponseContract, orgIdInPathRequired, OrgPortalListResponseContract, PortalDetailContract } from "../types";
+import type { AddPortalAppPageRequestContract, AddPortalAppPageResponseContract, AddPortalNoteBlockRequestContract, AddPortalNoteBlockResponseContract, 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);
+    /**
+     * Add a published app as a portal page (embed)
+     * Creates a new sidebar page in the portal that embeds a published Fusebase app (a flexible block with an app-feature brick). Pass productId (the product that owns the app) and appId (the app to embed) — typically the app you just built and published via the CLI. The app's URL is resolved by the portal at render time from these ids; nothing is hard-coded. Pass parentId to nest the page under an existing folder. The page is staged in the portal's customizer draft (not published immediately): the portal owner opens the customizer, reviews the pending page, and publishes it. Returns the page/menu-item/block ids, the page url, and the draft branch/seqs. Requires portals.write access.
+     */
+    addPortalAppPage(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            portalId: globalIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: AddPortalAppPageRequestContract;
+    }): Promise<AddPortalAppPageResponseContract>;
+    /**
+     * 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.
+     */
+    addPortalNoteBlock(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            portalId: globalIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: AddPortalNoteBlockRequestContract;
+    }): Promise<AddPortalNoteBlockResponseContract>;
     /**
      * Create a new portal
-     * Creates a new portal under the given org and workspace. Returns portal details and one-time admin credentials for the portal customizer. Requires org.write and org access.
+     * Creates a new portal under the given org and workspace. Optionally pass accessMode to set the initial access mode at creation: 'open' (anyone), 'invite-only' (invited users only), 'email' (visitor enters an email, no verification), or 'email-verified' (email with confirmation); when omitted the portal keeps the template's default access. Returns portal details and one-time admin credentials for the portal customizer. Requires org.write and org access.
      */
     createPortal(params: {
         path: {
@@ -20,6 +44,30 @@ export declare class PortalsApi {
         headers?: Record<string, string>;
         body: CreatePortalRequestContract;
     }): Promise<CreatePortalResponseContract>;
+    /**
+     * Create a root folder in a portal
+     * Creates a new empty root folder (a portalSection) in the portal's sidebar navigation. The folder is staged in the portal's customizer draft (not published immediately): the portal owner opens the customizer, reviews the pending folder, and publishes it. Returns the created folder/page ids, its url, and the draft branch/seqs. Requires portals.write access.
+     */
+    createPortalFolder(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            portalId: globalIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: CreatePortalFolderRequestContract;
+    }): Promise<CreatePortalFolderResponseContract>;
+    /**
+     * Create a portal page backed by a Fusebase note
+     * Creates a new sidebar page in the portal backed by a freshly created Fusebase note. The note is created in the portal's workspace and shared into the portal; optional initial text or html can be appended to it. The page (page node + note menu item + note content block) is staged in the portal's customizer draft (not published immediately): the portal owner opens the customizer, reviews the pending page, and publishes it. Pass parentId to nest the page under an existing folder. Returns the note/page/menu-item ids, the page url, and the draft branch/seqs. Requires portals.write access.
+     */
+    createPortalPageWithNote(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            portalId: globalIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: CreatePortalPageWithNoteRequestContract;
+    }): Promise<CreatePortalPageWithNoteResponseContract>;
     /**
      * Duplicate an existing portal
      * Creates a new portal as a full copy of an existing portal: settings, theme, menu structure, pages, and content blocks are all copied. Returns portal details. Status is 'ready' immediately for P_SUB domains; 'pending' for custom/CNAME domains or if content copy is still in progress. Requires org.write access.
@@ -32,6 +80,19 @@ export declare class PortalsApi {
         headers?: Record<string, string>;
         body: DuplicatePortalRequestContract;
     }): Promise<CreatePortalResponseContract>;
+    /**
+     * Duplicate a folder or page within a portal
+     * Duplicates a menu item (folder, note page, portal page, or link) inside the same portal. For a folder the whole subtree of copyable child items is copied, with their page content blocks. Inner Fusebase notes are deep-cloned (each gets a fresh noteId, not reused). Pass itemId (the source menu item id from listPortalContent); optionally pass name to rename the copied root and parentId to place it under a different folder (default: next to the source). Unlike the staged content ops, the copy is applied to the published portal immediately. Returns the new root item id. Requires portals.write access.
+     */
+    duplicatePortalItem(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            portalId: globalIdInPathRequired;
+            itemId: globalIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: DuplicatePortalItemRequestContract;
+    }): Promise<DuplicatePortalItemResponseContract>;
     /**
      * Get portal details
      * Returns detailed information for a single portal by ID. Requires portals.read access.
@@ -43,6 +104,18 @@ export declare class PortalsApi {
         };
         headers?: Record<string, string>;
     }): Promise<PortalDetailContract>;
+    /**
+     * Invite a portal manager (customizer access)
+     * Invites a user as a PORTAL MANAGER via a magic link. A manager has access to the portal customizer and can build, edit, and publish the portal (layout, settings, widgets, custom code); they always get full access to all portal pages. This is a dedicated shortcut for inviteToPortal with orgRole='manager' — no access question is needed (managers are always full access). Returns a magic link for direct portal/customizer access without email confirmation. Requires portals.manage access.
+     */
+    invitePortalManager(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            portalId: globalIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: InvitePortalManagerRequestContract;
+    }): Promise<InvitePortalManagerResponseContract>;
     /**
      * Invite a user to a portal
      * Invites a user (client, member, or manager) to a portal via a magic link. For orgRole='client' (default): isFullAccess controls access to private pages (default true). For orgRole='member' or 'manager': always full access, isFullAccess is ignored. Returns a magic link for direct portal access without email confirmation. Invarian — before calling this operation for a client invite (orgRole='client' or unspecified): ALWAYS ask the user 'Full access (all pages) or Shared only (public pages)?' and wait for their answer before proceeding. Do NOT silently assume a default.
@@ -76,4 +149,28 @@ export declare class PortalsApi {
         };
         headers?: Record<string, string>;
     }): Promise<OrgPortalListResponseContract>;
+    /**
+     * Update portal access mode
+     * Sets the portal access mode: 'open' (anyone), 'invite-only' (invited users only), 'email' (visitor enters an email, no verification), or 'email-verified' (email with confirmation). The change is staged in the portal's customizer draft (not published immediately): the portal owner opens the customizer, reviews the pending change, and publishes it. Returns the staged access mode and the draft branch/seq. Requires portals.write access.
+     */
+    updatePortalAccess(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            portalId: globalIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: UpdatePortalAccessRequestContract;
+    }): Promise<UpdatePortalAccessResponseContract>;
+    /**
+     * Update portal custom CSS/JS code
+     * Sets custom code for the portal: css (custom styles), headCode (HTML/JS at the start of <head>), and bodyCode (HTML/JS at the end of <body>). Only the provided fields change; omitted fields keep their current value, and an empty string clears a field. At least one field is required. Custom code only renders on portals served from a custom CNAME domain. The change is staged in the portal's customizer draft (not published immediately): the portal owner opens the customizer, reviews the pending change, and publishes it. Returns the draft branch/seq. Requires portals.write access.
+     */
+    updatePortalCustomCode(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            portalId: globalIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: UpdatePortalCustomCodeRequestContract;
+    }): Promise<UpdatePortalCustomCodeResponseContract>;
 }

package/dist/apis/PortalsApi.js

@@ -11,9 +11,39 @@ class PortalsApi {
     constructor(client) {
         this.client = client;
     }
+    /**
+     * Add a published app as a portal page (embed)
+     * Creates a new sidebar page in the portal that embeds a published Fusebase app (a flexible block with an app-feature brick). Pass productId (the product that owns the app) and appId (the app to embed) — typically the app you just built and published via the CLI. The app's URL is resolved by the portal at render time from these ids; nothing is hard-coded. Pass parentId to nest the page under an existing folder. The page is staged in the portal's customizer draft (not published immediately): the portal owner opens the customizer, reviews the pending page, and publishes it. Returns the page/menu-item/block ids, the page url, and the draft branch/seqs. Requires portals.write access.
+     */
+    async addPortalAppPage(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/portals/:portalId/pages/app",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "addPortalAppPage",
+            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.
+     */
+    async addPortalNoteBlock(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/portals/:portalId/blocks/note",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "addPortalNoteBlock",
+            expectedContentType: "application/json",
+        });
+    }
     /**
      * Create a new portal
-     * Creates a new portal under the given org and workspace. Returns portal details and one-time admin credentials for the portal customizer. Requires org.write and org access.
+     * Creates a new portal under the given org and workspace. Optionally pass accessMode to set the initial access mode at creation: 'open' (anyone), 'invite-only' (invited users only), 'email' (visitor enters an email, no verification), or 'email-verified' (email with confirmation); when omitted the portal keeps the template's default access. Returns portal details and one-time admin credentials for the portal customizer. Requires org.write and org access.
      */
     async createPortal(params) {
         return this.client.request({
@@ -26,6 +56,36 @@ class PortalsApi {
             expectedContentType: "application/json",
         });
     }
+    /**
+     * Create a root folder in a portal
+     * Creates a new empty root folder (a portalSection) in the portal's sidebar navigation. The folder is staged in the portal's customizer draft (not published immediately): the portal owner opens the customizer, reviews the pending folder, and publishes it. Returns the created folder/page ids, its url, and the draft branch/seqs. Requires portals.write access.
+     */
+    async createPortalFolder(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/portals/:portalId/folders",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "createPortalFolder",
+            expectedContentType: "application/json",
+        });
+    }
+    /**
+     * Create a portal page backed by a Fusebase note
+     * Creates a new sidebar page in the portal backed by a freshly created Fusebase note. The note is created in the portal's workspace and shared into the portal; optional initial text or html can be appended to it. The page (page node + note menu item + note content block) is staged in the portal's customizer draft (not published immediately): the portal owner opens the customizer, reviews the pending page, and publishes it. Pass parentId to nest the page under an existing folder. Returns the note/page/menu-item ids, the page url, and the draft branch/seqs. Requires portals.write access.
+     */
+    async createPortalPageWithNote(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/portals/:portalId/pages/note",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "createPortalPageWithNote",
+            expectedContentType: "application/json",
+        });
+    }
     /**
      * Duplicate an existing portal
      * Creates a new portal as a full copy of an existing portal: settings, theme, menu structure, pages, and content blocks are all copied. Returns portal details. Status is 'ready' immediately for P_SUB domains; 'pending' for custom/CNAME domains or if content copy is still in progress. Requires org.write access.
@@ -41,6 +101,21 @@ class PortalsApi {
             expectedContentType: "application/json",
         });
     }
+    /**
+     * Duplicate a folder or page within a portal
+     * Duplicates a menu item (folder, note page, portal page, or link) inside the same portal. For a folder the whole subtree of copyable child items is copied, with their page content blocks. Inner Fusebase notes are deep-cloned (each gets a fresh noteId, not reused). Pass itemId (the source menu item id from listPortalContent); optionally pass name to rename the copied root and parentId to place it under a different folder (default: next to the source). Unlike the staged content ops, the copy is applied to the published portal immediately. Returns the new root item id. Requires portals.write access.
+     */
+    async duplicatePortalItem(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/portals/:portalId/items/:itemId/duplicate",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "duplicatePortalItem",
+            expectedContentType: "application/json",
+        });
+    }
     /**
      * Get portal details
      * Returns detailed information for a single portal by ID. Requires portals.read access.
@@ -55,6 +130,21 @@ class PortalsApi {
             expectedContentType: "application/json",
         });
     }
+    /**
+     * Invite a portal manager (customizer access)
+     * Invites a user as a PORTAL MANAGER via a magic link. A manager has access to the portal customizer and can build, edit, and publish the portal (layout, settings, widgets, custom code); they always get full access to all portal pages. This is a dedicated shortcut for inviteToPortal with orgRole='manager' — no access question is needed (managers are always full access). Returns a magic link for direct portal/customizer access without email confirmation. Requires portals.manage access.
+     */
+    async invitePortalManager(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/portals/:portalId/invite-manager",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "invitePortalManager",
+            expectedContentType: "application/json",
+        });
+    }
     /**
      * Invite a user to a portal
      * Invites a user (client, member, or manager) to a portal via a magic link. For orgRole='client' (default): isFullAccess controls access to private pages (default true). For orgRole='member' or 'manager': always full access, isFullAccess is ignored. Returns a magic link for direct portal access without email confirmation. Invarian — before calling this operation for a client invite (orgRole='client' or unspecified): ALWAYS ask the user 'Full access (all pages) or Shared only (public pages)?' and wait for their answer before proceeding. Do NOT silently assume a default.
@@ -98,5 +188,35 @@ class PortalsApi {
             expectedContentType: "application/json",
         });
     }
+    /**
+     * Update portal access mode
+     * Sets the portal access mode: 'open' (anyone), 'invite-only' (invited users only), 'email' (visitor enters an email, no verification), or 'email-verified' (email with confirmation). The change is staged in the portal's customizer draft (not published immediately): the portal owner opens the customizer, reviews the pending change, and publishes it. Returns the staged access mode and the draft branch/seq. Requires portals.write access.
+     */
+    async updatePortalAccess(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/portals/:portalId/access",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "updatePortalAccess",
+            expectedContentType: "application/json",
+        });
+    }
+    /**
+     * Update portal custom CSS/JS code
+     * Sets custom code for the portal: css (custom styles), headCode (HTML/JS at the start of <head>), and bodyCode (HTML/JS at the end of <body>). Only the provided fields change; omitted fields keep their current value, and an empty string clears a field. At least one field is required. Custom code only renders on portals served from a custom CNAME domain. The change is staged in the portal's customizer draft (not published immediately): the portal owner opens the customizer, reviews the pending change, and publishes it. Returns the draft branch/seq. Requires portals.write access.
+     */
+    async updatePortalCustomCode(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/portals/:portalId/custom-code",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "updatePortalCustomCode",
+            expectedContentType: "application/json",
+        });
+    }
 }
 exports.PortalsApi = PortalsApi;

package/dist/types/app-api/app-api.d.ts

@@ -22,6 +22,17 @@ export interface AppApiOperationContract {
 export interface AppApiOperationListResponseContract {
     operations: AppApiOperationContract[];
 }
+export interface PublishedAppContract {
+    productId: string;
+    appId: string;
+    title: string;
+    productTitle: string;
+    status: "published" | "draft";
+}
+export interface PublishedAppListResponseContract {
+    apps: PublishedAppContract[];
+    total: number;
+}
 export interface CallAppApiRequestContract {
     path?: Record<string, string>;
     query?: Record<string, string | number | boolean>;

package/dist/types/index.d.ts

@@ -5,7 +5,7 @@
  * Generated by SDK codegen
  */
 export type { AuthenticatedUserSummaryContract, MyOrgAccessResponseContract } from "./access/access";
-export type { AppApiOperationContract, AppApiOperationListResponseContract, CallAppApiRequestContract, CallAppApiResponseContract, VerifyAppApiContractsRequestContract, VerifyAppApiContractsResponseContract, VerifyCaseResultContract } from "./app-api/app-api";
+export type { AppApiOperationContract, AppApiOperationListResponseContract, CallAppApiRequestContract, CallAppApiResponseContract, PublishedAppContract, PublishedAppListResponseContract, VerifyAppApiContractsRequestContract, VerifyAppApiContractsResponseContract, VerifyCaseResultContract } from "./app-api/app-api";
 export type { AppPortalEmbedContract, ListAppPortalEmbedsResponseContract } from "./app-embed-targets/app-embed-targets";
 export type { ActivateAppMagicLinkResponseContract, CreateAppMagicLinkRequestContract, CreateAppMagicLinkResponseContract, RequestAppMagicLinkRequestContract, RequestAppMagicLinkResponseContract } from "./app-magic-link/app-magic-link";
 export * from "./billing/billing";
@@ -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 { CreatePortalRequestContract, CreatePortalResponseContract, DuplicatePortalRequestContract, InviteToPortalRequestContract, InviteToPortalResponseContract, ListPortalContentResponseContract, PortalContentItemContract, PortalDetailContract, globalIdInPathRequired } from "./portals/portals";
+export type { AddPortalAppPageRequestContract, AddPortalAppPageResponseContract, AddPortalNoteBlockRequestContract, AddPortalNoteBlockResponseContract, 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/portals/portals.d.ts

@@ -1,3 +1,4 @@
+import type { WorkspaceNoteContentFormatContract } from "../note/note";
 export type globalIdInPathRequired = string;
 export type PortalThemeKey = "light_purple" | "soft_light" | "quite_green" | "space_gray" | "carbon" | "oxford" | "ultramarine" | "milky_blue" | "shades_of_green" | "savvy_red" | "light_orange" | "light_blue" | "lemon_drop";
 export interface DuplicatePortalRequestContract {
@@ -11,10 +12,220 @@ export interface CreatePortalRequestContract {
     name?: string;
     /** Color theme key for the portal. When provided, applied via updateThemeSettings changeEvent. */
     theme?: PortalThemeKey;
+    /**
+     * Initial access mode (who may open the portal). When provided, applied at
+     * creation via an updateAccessSettings changeEvent; when omitted the portal
+     * keeps the template's default access. One of: "open" (anyone), "invite-only"
+     * (invited users only), "email" (visitor enters an email, no verification),
+     * "email-verified" (email with confirmation).
+     */
+    accessMode?: PortalAccessMode;
 }
 export interface CreatePortalResponseContract {
     portal: PortalDetailContract;
 }
+/**
+ * Portal access mode (who may open the portal):
+ * - "open": anyone can view, no email required.
+ * - "invite-only": only invited users (clients/members/managers); no public access.
+ * - "email": visitor must enter an email, no verification.
+ * - "email-verified": visitor must enter an email and confirm it.
+ */
+export type PortalAccessMode = "open" | "invite-only" | "email" | "email-verified";
+export interface UpdatePortalAccessRequestContract {
+    /** Desired access mode for the portal. */
+    accessMode: PortalAccessMode;
+}
+export interface UpdatePortalAccessResponseContract {
+    /** The access mode that was staged. */
+    accessMode: PortalAccessMode;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence number assigned to the staged change event. */
+    seq: number;
+    /**
+     * Always true: the change 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 CreatePortalFolderRequestContract {
+    /** Display name of the new root folder. */
+    name: string;
+    /** Optional icon key for the folder (default: "folder"). */
+    icon?: string;
+}
+export interface CreatePortalFolderResponseContract {
+    /** Id of the created folder (the portalSection menu item). */
+    folderId: string;
+    /** Id of the backing page node created for the folder. */
+    pageId: string;
+    /** URL path assigned to the folder (e.g. "/support"). */
+    url: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addPage, addMenuItem). */
+    seqs: number[];
+    /**
+     * Always true: the folder 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 CreatePortalPageWithNoteRequestContract {
+    /** Title for the new page (also used as the backing Fusebase note title). */
+    title: string;
+    /**
+     * Optional id of an existing menu item (e.g. a folder) to nest the page under
+     * in the sidebar. When omitted the page is created at the portal root.
+     */
+    parentId?: string;
+    /** Optional icon key for the menu item (default: "page"). */
+    icon?: string;
+    /** Optional initial text or html appended to the note after creation. */
+    content?: string;
+    /** Content format used with `content`. Defaults to `text`. */
+    format?: WorkspaceNoteContentFormatContract;
+}
+export interface CreatePortalPageWithNoteResponseContract {
+    /** Global id of the created Fusebase note backing the page. */
+    noteId: string;
+    /** Id of the created note menu item (the sidebar entry). */
+    menuItemId: string;
+    /** Id of the backing portal page node created for the note. */
+    pageId: string;
+    /** URL path assigned to the page (e.g. "/welcome"). */
+    url: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addPage, addMenuItem, addBlock). */
+    seqs: number[];
+    /**
+     * Always true: the page 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 AddPortalNoteBlockRequestContract {
+    /** Id of the existing portal page node to add the note block to. */
+    pageId: string;
+    /** Global id of the existing Fusebase note to embed as a block. */
+    noteId: string;
+    /** Optional block title (defaults to the page's current title). */
+    title?: string;
+}
+export interface AddPortalNoteBlockResponseContract {
+    /** Id of the created note content 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
+     * shown in the apps catalog). Persisted on the portal block as `appId`.
+     */
+    productId: string;
+    /**
+     * Global id of the published app (feature) to embed. Persisted on the portal
+     * block as `featureId`. The app's URL is resolved by the portal at render
+     * time from these ids — nothing is hard-coded here.
+     */
+    appId: string;
+    /** Title for the new page and its sidebar entry (default: "App"). */
+    title?: string;
+    /**
+     * Optional id of an existing menu item (e.g. a folder) to nest the page under
+     * in the sidebar. When omitted the page is created at the portal root.
+     */
+    parentId?: string;
+    /** Optional icon key for the menu item (default: "note"). */
+    icon?: string;
+}
+export interface AddPortalAppPageResponseContract {
+    /** Id of the created portal page node hosting the app embed. */
+    pageId: string;
+    /** Id of the created page menu item (the sidebar entry). */
+    menuItemId: string;
+    /** Id of the created flexible block carrying the app-feature embed. */
+    blockId: string;
+    /** URL path assigned to the page (e.g. "/my-app"). */
+    url: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addPage, addMenuItem, addBlock). */
+    seqs: number[];
+    /**
+     * Always true: the page 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 UpdatePortalCustomCodeRequestContract {
+    /**
+     * Custom CSS applied to every published portal page (portal-service
+     * `customStyle`). Pass an empty string to clear it.
+     */
+    css?: string;
+    /**
+     * Custom HTML/JS injected at the start of the `<head>` tag on every published
+     * portal page (portal-service `customScript`). Pass an empty string to clear it.
+     */
+    headCode?: string;
+    /**
+     * Custom HTML/JS injected at the end of the `<body>` tag on every published
+     * portal page (portal-service `customCode`). Pass an empty string to clear it.
+     */
+    bodyCode?: string;
+}
+export interface UpdatePortalCustomCodeResponseContract {
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence number assigned to the staged change event. */
+    seq: number;
+    /**
+     * Always true: the change 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 DuplicatePortalItemRequestContract {
+    /**
+     * Id of the menu item to duplicate (a folder, note page, portal page, or link),
+     * as returned by listPortalContent. For a folder, the whole subtree of
+     * copyable child items (folders, note pages, portal pages, links) is copied.
+     */
+    itemId: string;
+    /**
+     * Optional name for the copied root item. When omitted the copy is named
+     * "<source name> copy".
+     */
+    name?: string;
+    /**
+     * Optional id of an existing menu item (e.g. a folder) to place the copy under.
+     * When omitted the copy is placed next to the source (same parent).
+     */
+    parentId?: string;
+}
+export interface DuplicatePortalItemResponseContract {
+    /** Id of the new root menu item (the copied folder/page/link). */
+    itemId: string;
+    /**
+     * Always true: unlike the staged content ops, a duplicate is applied to the
+     * published portal immediately (portal-service /menus/copy has no draft mode
+     * and the inner notes are truly cloned).
+     */
+    published: boolean;
+}
 export interface PortalDetailContract {
     id: string;
     orgId: string;
@@ -55,6 +266,20 @@ export interface InviteToPortalResponseContract {
     /** User ID in the system. */
     userId: number;
 }
+export interface InvitePortalManagerRequestContract {
+    /** Email of the user to invite as a portal manager. */
+    email: string;
+    /** Optional display name for the invitee. */
+    fullName?: string;
+}
+export interface InvitePortalManagerResponseContract {
+    /** Magic link for direct portal/customizer access (no email confirmation needed). */
+    magicLink: string;
+    /** Portal URL. */
+    url: string;
+    /** User ID in the system. */
+    userId: number;
+}
 export type PortalMenuItemType = "home" | "link" | "notesFolder" | "note" | "portalSection" | "portalProcess" | "portalPage" | "unknown" | "allPages" | "tasks" | "chat" | "folders" | "tags" | "portalFilesDashboard" | "filesManager" | "portalTasksDashboard" | "portalChatsDashboard";
 export type PortalContentPositionType = "top" | "sidebar" | "footer";
 export interface PortalContentItemContract {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusebase/fusebase-gate-sdk",
-  "version": "2.3.6",
+  "version": "2.3.10",
   "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.10.md

@@ -0,0 +1,9 @@
+# Release Notes 2.3.10
+
+- Current ref: `HEAD`
+- Previous tag: `v2.3.10`
+- Generated at: 2026-06-26T10:19:00.857Z
+
+## Included Drafts
+
+- None

package/release-notes/latest.md

@@ -1,8 +1,8 @@
-# Release Notes 2.3.6
+# Release Notes 2.3.10
 
 - Current ref: `HEAD`
-- Previous tag: `v2.3.6`
-- Generated at: 2026-06-25T11:36:27.060Z
+- Previous tag: `v2.3.10`
+- Generated at: 2026-06-26T10:19:00.857Z
 
 ## Included Drafts
 

package/release-notes/2.3.6.md

@@ -1,9 +0,0 @@
-# Release Notes 2.3.6
-
-- Current ref: `HEAD`
-- Previous tag: `v2.3.6`
-- Generated at: 2026-06-25T11:36:27.060Z
-
-## Included Drafts
-
-- None