@fusebase/fusebase-gate-sdk 2.3.34-sdk.8 → 2.4.0

package/dist/types/org-user/org-user.d.ts

@@ -112,6 +112,29 @@ export interface OrgWorkspaceMemberContract {
     type?: string | null;
     privileges?: string[] | null;
     magicLink?: string | null;
+    /**
+     * Organization role of this member, joined from org membership by `userId`
+     * (one of `guest`|`client`|`member`|`manager`|`owner`). `null` when no org
+     * membership record resolves for the user. Lets callers tell portal clients
+     * (`client`) from portal managers without a separate listOrgUsers call.
+     */
+    orgRole?: string | null;
+    /** Member email from the org user profile. `null` when unknown. */
+    email?: string | null;
+    /** Member first name from the org user profile. `null` when unknown. */
+    firstname?: string | null;
+    /** Member last name from the org user profile. `null` when unknown. */
+    lastname?: string | null;
+    /**
+     * Whether this member is a portal manager, per the official platform
+     * contract: a portal manager is a member whose org role is `manager` (which
+     * is exactly what `invitePortalManager` grants) or `owner` (who outranks a
+     * manager and has full authority over every portal). Rely on this flag
+     * instead of re-deriving the formula in app code, so the check does not
+     * silently break if the internal representation of a portal manager ever
+     * changes. `false` when the org role cannot be resolved.
+     */
+    isPortalManager?: boolean;
 }
 export interface OrgWorkspaceMemberListResponseContract {
     members: OrgWorkspaceMemberContract[];
@@ -146,6 +169,17 @@ export interface OrgUserAddResponseContract {
     workspaceMember?: OrgWorkspaceMemberContract;
     magicLink?: OrgMagicLinkContract;
 }
+/**
+ * Optional CAS guard for removeOrgMember: the membership is only removed when
+ * its current org role still equals this value.
+ */
+export type OrgMemberExpectedRoleInQueryOptional = string;
+/**
+ * Optional provenance guard for removeOrgMember (unix timestamp in seconds):
+ * the membership is only removed when it was created at or after this moment,
+ * so cancelling an invite can never drop a pre-existing member.
+ */
+export type OrgMemberExpectedJoinedAfterInQueryOptional = number;
 export interface OrgMemberRemoveResponseContract {
     ok: true;
     userId: number;

package/dist/types/portal-feature-context/portal-feature-context.d.ts

@@ -7,6 +7,12 @@ export interface VerifyPortalFeatureContextTokenRequestContract {
 }
 /**
  * Trusted portal/workspace context extracted from a verified embed token.
+ *
+ * `userId`/`orgRole` describe WHO is calling and come from the live,
+ * user-bound session token that authenticated the request (not from the
+ * static per-brick `portalFeatureContextToken`), so one verify yields the
+ * trusted "user × portal × app" triple. Absent for unauthenticated/visitor
+ * (open/email) portal sessions.
  */
 export interface VerifyPortalFeatureContextTokenResponseContract {
     portalId: string;
@@ -15,4 +21,8 @@ export interface VerifyPortalFeatureContextTokenResponseContract {
     productId: string;
     /** App (feature) id (legacy payload field `featureId`). */
     appId: string;
+    /** Native id of the authenticated caller. Absent for visitor sessions. */
+    userId?: number;
+    /** Org role of the authenticated caller at verify time. */
+    orgRole?: string;
 }

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

@@ -84,8 +84,41 @@ export interface PublishPortalDraftResponseContract {
     /** Always true: the staged draft is now live on the portal. */
     published: boolean;
 }
+export interface CreatePortalPageRequestContract {
+    /**
+     * Title for the new empty page (also used as its sidebar item name).
+     * @maxLength 100
+     */
+    title: string;
+    /**
+     * Optional id of an existing published or active-draft 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;
+}
+export interface CreatePortalPageResponseContract {
+    /** Id of the created sidebar menu item. */
+    menuItemId: string;
+    /** Id of the created portal page node. */
+    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). */
+    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 CreatePortalPageWithNoteRequestContract {
-    /** Title for the new page (also used as the backing Fusebase note title). */
+    /**
+     * Title for the new page (also used as the backing Fusebase note title).
+     * @maxLength 100
+     */
     title: string;
     /**
      * Optional id of an existing menu item (e.g. a folder) to nest the page under
@@ -126,6 +159,27 @@ export interface AddPortalNoteBlockRequestContract {
     /** Optional block title (defaults to the page's current title). */
     title?: string;
 }
+export interface AddPortalBlankNoteBlockRequestContract {
+    /** Optional block title (defaults to "New Document"). */
+    title?: string;
+}
+export interface AddPortalBlankNoteBlockResponseContract {
+    /** Global id of the newly created Fusebase note backing the block. */
+    noteId: string;
+    /** Id of the created note 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 AddPortalNoteBlockResponseContract {
     /** Id of the created note content block. */
     blockId: string;
@@ -141,12 +195,132 @@ export interface AddPortalNoteBlockResponseContract {
      */
     staged: boolean;
 }
+/**
+ * The 11 Customizer "Embeds & Integrations" chooser variants. The internal
+ * legacy `unknown` is intentionally excluded — it is not a create option.
+ */
+export type PortalEmbedType = "custom" | "youtube" | "google-drive" | "ms-doc" | "calendly" | "hubspot" | "airtable" | "loom" | "data-studio" | "figma" | "miro";
+export interface AddPortalEmbedBlockRequestContract {
+    /** Required non-empty block title. */
+    title: string;
+    /** Customizer Embed variant. `unknown` is not accepted. */
+    embedType: PortalEmbedType;
+    /** Required for named variants, forbidden for `custom`: the URL to embed. */
+    url?: string;
+    /** Required for `custom`, forbidden for named variants: the embed code/URL. */
+    content?: string;
+    /** Whether to show the "open in new tab" link on the block. Default: true. */
+    showEmbedLink?: boolean;
+    /** Block width in grid columns. Default: 3. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /** Block height in grid rows. Default: 1. */
+    rowspan?: 1 | 2 | 3 | 4;
+    /** Fixed pixel height, or null to auto-size. Default: null. */
+    height?: number | null;
+}
+export interface AddPortalEmbedBlockResponseContract {
+    /** Id of the created embed 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;
+}
+/** Which chat target a Chat block points at. */
+export type PortalChatBlockTargetType = "channel" | "dm";
+/**
+ * Exactly one chat target, as a discriminated union (matches the Customizer).
+ * A `channel` target carries only `channelId`; a `dm` target only `userId`.
+ */
+export type PortalChatBlockTarget = {
+    type: "channel";
+    /** A channel id from listPortalChatChannels. */
+    channelId: string;
+} | {
+    type: "dm";
+    /** An active org member/owner user id. */
+    userId: number;
+};
+export interface AddPortalChatBlockRequestContract {
+    /** Required non-empty block title. */
+    title: string;
+    /** Exactly one of a `channel` (channelId) or `dm` (userId) target. */
+    target: PortalChatBlockTarget;
+    /**
+     * Channels only: restrict posting to members. Defaults to true; forbidden for
+     * a `dm` target; a private channel requires true.
+     */
+    membersOnly?: boolean;
+    /** Block width in grid columns. Default: 6. */
+    colspan?: 3 | 4 | 5 | 6;
+    /** Block height in grid rows. Default: 1. */
+    rowspan?: 1 | 2 | 3 | 4;
+    /** Fixed pixel height, or null to auto-size. Default: null. */
+    height?: number | null;
+}
+export interface AddPortalChatBlockResponseContract {
+    /** Id of the created chat 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 PortalChatChannelContract {
+    /** Channel id to pass to addPortalChatBlock as channelId. */
+    id: string;
+    /** Human-readable channel name. */
+    name: string;
+    /** Whether the channel is public (private channels require membersOnly). */
+    isPublic: boolean;
+    /** Whether this is the portal's default channel (returned first). */
+    isDefault: boolean;
+}
+export interface ListPortalChatChannelsResponseContract {
+    /** Listable chat channels, default channel first. */
+    channels: PortalChatChannelContract[];
+}
+export interface PortalChatUserContract {
+    /** User id to pass to addPortalChatBlock as target.userId. */
+    id: number;
+    /** Effective display name (composed name → username → email → id). */
+    displayName: string;
+    /** Username, when the user has one. */
+    username?: string;
+    /** Email, to tell apart users sharing a display name. Always present. */
+    email: string;
+}
+export interface ListPortalChatUsersResponseContract {
+    /** Matched DM target users (a single bounded page). */
+    users: PortalChatUserContract[];
+    /**
+     * Total number of matching users across all pages.
+     * @TJS-type integer
+     */
+    total: number;
+    /** Opaque cursor for the next page; absent when there are no more results. */
+    nextCursor?: string;
+}
 /**
  * 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 type PortalBlockType = "note" | "content" | "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;
@@ -165,7 +339,7 @@ export interface AddPortalBlockRequestContract {
     bricks?: unknown[];
     /**
      * Optional type-specific fields for the staged block, e.g. flat strings
-     * `embedType`/`content`/`contentUrl` for embed, `image`/`link` for info,
+     * `image`/`link` for info,
      * `sourcePortalId`/`sourcePageId`/`sourceBlockId` for projection,
      * `taskListIds` for task-list. Also overrides scaffold defaults (colspan,
      * rowspan, …) when provided. Every field is validated against the block's
@@ -201,7 +375,18 @@ export interface AddPortalAppPageRequestContract {
      * time from these ids — nothing is hard-coded here.
      */
     appId: string;
-    /** Title for the new page and its sidebar entry (default: "App"). */
+    /**
+     * private (default) -> Customizer "Your Products/Apps".
+     * managed -> Customizer "Managed Products": the app comes from a product owned
+     * by another organization, resolved via findPublishedApps.
+     */
+    productType?: "private" | "managed";
+    /**
+     * Owner organization of the product, as returned by findPublishedApps.
+     * Required for managed products; defaults to the path orgId for private ones.
+     */
+    productOrgId?: string;
+    /** Title for the new page and its sidebar entry (default: "App"; managed: "Managed Products"). */
     title?: string;
     /**
      * Optional id of an existing menu item (e.g. a folder) to nest the page under
@@ -230,6 +415,50 @@ export interface AddPortalAppPageResponseContract {
      */
     staged: boolean;
 }
+export interface AddPortalAppBlockRequestContract {
+    /**
+     * 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;
+    /**
+     * private (default) -> Customizer "Your Products/Apps".
+     * managed -> Customizer "Managed Products": the app comes from a product owned
+     * by another organization, resolved via findPublishedApps.
+     */
+    productType?: "private" | "managed";
+    /**
+     * Owner organization of the product, as returned by findPublishedApps.
+     * Required for managed products; defaults to the path orgId for private ones.
+     */
+    productOrgId?: string;
+    /** Title for the block (default: "App"; managed: "Managed Products"). */
+    title?: string;
+}
+export interface AddPortalAppBlockResponseContract {
+    /** Id of the created flexible block carrying the app-feature embed. */
+    blockId: string;
+    /**
+     * Page the block was staged on — echoes the requested pageId. Confirms where
+     * the block landed and can be chained into further page operations.
+     */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events. */
+    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 UpdatePortalCustomCodeRequestContract {
     /**
      * Custom CSS applied to every published portal page (portal-service

package/package.json

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