@fusebase/fusebase-gate-sdk 2.3.34-sdk.9 → 2.5.0

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,654 @@ 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;
+}
+/** Customizer "Type" for the Database block: a database table, or a shared dashboard. */
+export type PortalDatabaseBlockTargetContract = {
+    /** Customizer Type: Database. */
+    type: "database";
+    databaseId: string;
+    /** Database-bound dashboard (Customizer label: Table). */
+    dashboardId: string;
+    viewId: string;
+} | {
+    /** Customizer Type: Dashboard. */
+    type: "dashboard";
+    /** Shared dashboard source, e.g. All forms. */
+    dashboardId: string;
+    viewId: string;
+};
+/**
+ * Customizer background picker. Colors are Tailwind palette tokens
+ * (e.g. `red-200`, `orange-900`), never HEX; raw CSS is not accepted.
+ */
+export type PortalBackgroundContract = {
+    type: "color";
+    color: string;
+} | {
+    type: "gradient";
+    from: string;
+    to: string;
+    /** Default: `to-b`. */
+    direction?: "to-t" | "to-b" | "to-r" | "to-l";
+} | {
+    type: "image";
+    image: {
+        url: string;
+    };
+};
+/** Customizer Appearance section. Only `custom` carries the extra controls. */
+export type PortalDatabaseBlockAppearanceContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background: PortalBackgroundContract;
+    /** Default: `m`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: true. */
+    showTitle?: boolean;
+};
+/** Customizer Layout section. */
+export interface PortalDatabaseBlockLayoutContract {
+    /** Customizer Width. Default: 6. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /** Customizer Height: null = Auto; a manual value is at least 50px. Default: null. */
+    height?: number | null;
+}
+export interface AddPortalDatabaseBlockRequestContract {
+    /** Exact ids from listPortalDatabaseBlockSources; names and aliases are rejected. */
+    target: PortalDatabaseBlockTargetContract;
+    /** Block title. Default: "Database". */
+    title?: string;
+    /** Rows shown per page. Default: 100. */
+    itemsPerPage?: 10 | 20 | 50 | 100 | 200 | 500;
+    /** Visual wrapper of the portal block. Default: `{ backdrop: "blank" }`. */
+    appearance?: PortalDatabaseBlockAppearanceContract;
+    /** Grid placement. Default: width 6 columns and automatic height. */
+    layout?: PortalDatabaseBlockLayoutContract;
+}
+export interface AddPortalDatabaseBlockResponseContract {
+    /** Id of the created database 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 customizer draft, not yet live. */
+    staged: boolean;
+}
+/**
+ * One exact token of the Customizer common palette: `transparent`, `white`,
+ * `black` or `<hue>-<shade>` (e.g. `cyan-700`). HEX, rgb()/hsl(), CSS variables,
+ * `text-*`/`bg-*` classes and opacity values are rejected.
+ */
+export type PortalColorToken = string;
+/**
+ * The palette token pattern, repeated on every colour property: a type alias to
+ * `string` carries no JSDoc tag into the generated schema, so the `@pattern`
+ * has to sit on the property itself.
+ */
+export type PortalTextSize = "s" | "m" | "l" | "xl";
+export type PortalTextStyle = "bold" | "italic" | "underline" | "lineThrough";
+export type PortalTextAlign = "left" | "center" | "right" | "justify";
+/** The five Customizer preset background images. No URL or upload is accepted. */
+export type PortalBackgroundImagePreset = "azure" | "mira" | "solis" | "serenity" | "glow";
+/**
+ * Customizer background picker for a Text & Media block. Colours are palette
+ * tokens; an image is one of the five built-in presets.
+ */
+export type PortalTextBackgroundContract = {
+    type: "color";
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    color: PortalColorToken;
+} | {
+    type: "gradient";
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    from: PortalColorToken;
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    to: PortalColorToken;
+    /** Default: `to-t`. */
+    direction?: "to-t" | "to-r" | "to-b" | "to-l";
+} | {
+    type: "image";
+    preset: PortalBackgroundImagePreset;
+    /** Default: false. */
+    blur?: boolean;
+};
+/** Customizer Appearance section. Only `custom` carries the extra controls. */
+export type PortalFlexibleTextAppearanceContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background: PortalTextBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: false. */
+    showTitle?: boolean;
+};
+/** Customizer Layout section shared by the three Text & Media operations. */
+export interface PortalTextAndMediaLayoutContract {
+    /** Customizer Width. Default: 6. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+/** Customizer Content section of a Heading or Simple text block. */
+export interface PortalTextContentContract {
+    /**
+     * Plain text. Only `{{ClientName}}` and `{{ClientLastName}}` are variables.
+     * @maxLength 5000
+     */
+    text?: string;
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    color?: PortalColorToken;
+    size?: PortalTextSize;
+    /** Set semantics: a duplicate value is rejected by portal-service with 400. */
+    styles?: PortalTextStyle[];
+    align?: PortalTextAlign;
+}
+export interface AddPortalHeadingBlockRequestContract {
+    /** Defaults: text "Your Title Goes Here", size `l`, no styles, left alignment. */
+    content?: PortalTextContentContract;
+    /** Default: `{ backdrop: "blank" }`. */
+    appearance?: PortalFlexibleTextAppearanceContract;
+    /** Default: width 6 columns and automatic height. */
+    layout?: PortalTextAndMediaLayoutContract;
+}
+export interface AddPortalTextBlockRequestContract {
+    /** Defaults: the Customizer's Simple text copy, size `m`, no styles, left alignment. */
+    content?: PortalTextContentContract;
+    /** Default: `{ backdrop: "blank" }`. */
+    appearance?: PortalFlexibleTextAppearanceContract;
+    /** Default: width 6 columns and automatic height. */
+    layout?: PortalTextAndMediaLayoutContract;
+}
+/** The Image block always stages the Customizer's stock image: only Layout applies. */
+export interface AddPortalImageBlockRequestContract {
+    /** Default: width 6 columns and automatic height. */
+    layout?: PortalTextAndMediaLayoutContract;
+}
+export interface PortalTextAndMediaBlockResponseContract {
+    /** 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 customizer draft, not yet live. */
+    staged: boolean;
+}
+/**
+ * Customizer background picker. Colours are palette tokens; an image is one of
+ * the five built-in presets.
+ */
+export type PortalCardBackgroundContract = {
+    type: "color";
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    color: PortalColorToken;
+} | {
+    type: "gradient";
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    from: PortalColorToken;
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    to: PortalColorToken;
+    /** Default: `to-t`. */
+    direction?: "to-t" | "to-r" | "to-b" | "to-l";
+} | {
+    type: "image";
+    preset: PortalBackgroundImagePreset;
+    /** Default: false. */
+    blur?: boolean;
+};
+/** The four Card Types of the Customizer's Card tile. `compact` is legacy and rejected. */
+export type PortalCardViewContract = "top-image" | "left-image" | "right-image" | "fill-image";
+/**
+ * Customizer Appearance section of a Card. Omitting `appearance` keeps the
+ * Card's canonical `bare` wrapper, which is not a selectable backdrop.
+ */
+export type PortalCardAppearanceContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background: PortalCardBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: false. */
+    showTitle?: boolean;
+};
+/** Customizer Layout section of a Card. */
+export interface PortalCardLayoutContract {
+    /** Customizer Width. Default: 3. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+/**
+ * A hidden Card item carries ONLY `visible: false`: sending text or styles next
+ * to it would silently drop settings the caller believes they applied.
+ */
+export type PortalCardHeadingContract = {
+    visible: false;
+} | {
+    /** Default: true. */
+    visible?: true;
+    /**
+     * Plain text. Only `{{ClientName}}` and `{{ClientLastName}}` are variables.
+     * @minLength 1
+     * @maxLength 100
+     */
+    text?: string;
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    color?: PortalColorToken;
+    size?: PortalTextSize;
+    /** Set semantics: a duplicate value is rejected with 400. */
+    styles?: PortalTextStyle[];
+    align?: PortalTextAlign;
+};
+export type PortalCardDescriptionContract = {
+    visible: false;
+} | {
+    /** Default: true. */
+    visible?: true;
+    /**
+     * Plain text. Only `{{ClientName}}` and `{{ClientLastName}}` are variables.
+     * @minLength 1
+     * @maxLength 2000
+     */
+    text?: string;
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    color?: PortalColorToken;
+    size?: PortalTextSize;
+    /** Set semantics: a duplicate value is rejected with 400. */
+    styles?: PortalTextStyle[];
+    align?: PortalTextAlign;
+};
+export type PortalCardButtonContract = {
+    visible: false;
+} | {
+    /** Default: true. */
+    visible?: true;
+    /**
+     * Plain text; the Button label supports no dynamic variables.
+     * @minLength 1
+     * @maxLength 100
+     */
+    text?: string;
+};
+/** The Card always uses the template image: no source field is accepted. */
+export interface PortalCardImageContract {
+    /** Default: true. */
+    visible?: boolean;
+}
+/** Semantic Destination of the whole Card (and of its Button). */
+export type PortalCardDestinationContract = {
+    type: "portalPage";
+    /** Exact id of an existing page in the SAME portal. */
+    pageId: string;
+} | {
+    type: "external";
+    /**
+     * Absolute https:// URL. `javascript:`, `data:`, a protocol-relative URL
+     * and embedded credentials are rejected.
+     * @maxLength 2048
+     */
+    url: string;
+} | {
+    type: "email";
+    /**
+     * Address only; portal-service adds the `mailto:` scheme.
+     * @maxLength 254
+     */
+    email: string;
+};
+/** Customizer Content section of a Card. */
+export interface PortalCardContentContract {
+    image?: PortalCardImageContract;
+    /** Default: "Helpful Resources", bold. */
+    heading?: PortalCardHeadingContract;
+    /** Default: the Customizer's Card copy. */
+    description?: PortalCardDescriptionContract;
+    /** Default: "Explore". */
+    button?: PortalCardButtonContract;
+    /**
+     * Omitted keeps the Customizer default link; `null` leaves the Card without
+     * any destination.
+     */
+    destination?: PortalCardDestinationContract | null;
+}
+export interface AddPortalCardBlockRequestContract {
+    /** Card Type. Default: `top-image`. */
+    view?: PortalCardViewContract;
+    content?: PortalCardContentContract;
+    /** Omitted keeps the Card's canonical bare wrapper. */
+    appearance?: PortalCardAppearanceContract;
+    /** Default: width 3 columns and automatic height. */
+    layout?: PortalCardLayoutContract;
+}
+export interface AddPortalCardBlockResponseContract {
+    /** 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 customizer draft, not yet live. */
+    staged: boolean;
+}
+/** Customizer Layout section of a Carousel. */
+export interface PortalCarouselLayoutContract {
+    /** Customizer Width. Default: 6. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+/**
+ * One Carousel slide. The image is always a built-in one, and the index comes
+ * from the array order: neither is accepted from the caller.
+ */
+export interface PortalCarouselItemContract {
+    /**
+     * Plain text; the caption supports no dynamic variables.
+     * @minLength 1
+     */
+    caption?: string;
+    /**
+     * Plain text. Only `{{ClientName}}` and `{{ClientLastName}}` are variables.
+     * @minLength 1
+     */
+    description?: string;
+    /** `null` or omitted leaves the slide without a Button. */
+    button?: {
+        /**
+         * Plain label; the Button supports no dynamic variables.
+         * @minLength 1
+         */
+        text: string;
+    } | null;
+    /**
+     * Destination of both the slide surface and its Button. `null` or omitted
+     * leaves the slide without a link.
+     */
+    destination?: PortalCardDestinationContract | null;
+}
+/** Customizer Content section of a Carousel. */
+export interface PortalCarouselContentContract {
+    /**
+     * The full desired slide list in visual order, not a patch. Omitting it keeps
+     * the three factory slides (Deliberation, Elaboration, Presentation).
+     * Server-side limits: 1 to 6 slides.
+     */
+    items?: PortalCarouselItemContract[];
+}
+export interface AddPortalCarouselBlockRequestContract {
+    content?: PortalCarouselContentContract;
+    /** Default: width 6 columns and automatic height. */
+    layout?: PortalCarouselLayoutContract;
+}
+export interface AddPortalCarouselBlockResponseContract {
+    /** 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 customizer draft, not yet live. */
+    staged: boolean;
+}
+/**
+ * Customizer Appearance section of a Countdown. Omitting `appearance` keeps the
+ * Countdown's canonical `blank` backdrop with the block title shown.
+ */
+export type PortalCountdownAppearanceContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background: PortalCardBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: true. */
+    showTitle?: boolean;
+};
+/** Customizer Layout section of a Countdown. */
+export interface PortalCountdownLayoutContract {
+    /** Customizer Width. Default: 6. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+/** Customizer Content section of a Countdown. */
+export interface PortalCountdownContentContract {
+    /**
+     * The moment the countdown ends, as an absolute RFC 3339 date-time carrying
+     * `Z` or an explicit UTC offset, for example `2026-08-15T09:00:00+07:00`.
+     * Never epoch seconds/milliseconds and never a timezone-less local date.
+     * Default: 30 days after creation. Server-side limits: not in the past and at
+     * most 99 days after creation.
+     * @format date-time
+     */
+    targetAt?: string;
+}
+export interface AddPortalCountdownBlockRequestContract {
+    /**
+     * Block title shown above the countdown. Plain text; only `{{ClientName}}`
+     * and `{{ClientLastName}}` are variables. Default: `Countdown`.
+     * @minLength 1
+     * @maxLength 100
+     */
+    title?: string;
+    content?: PortalCountdownContentContract;
+    /** Omitted keeps the canonical blank backdrop with the title shown. */
+    appearance?: PortalCountdownAppearanceContract;
+    /** Default: width 6 columns and automatic height. */
+    layout?: PortalCountdownLayoutContract;
+}
+export interface AddPortalCountdownBlockResponseContract {
+    /** 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 customizer draft, not yet live. */
+    staged: boolean;
+}
+/** One selectable view of a Database table or a shared Dashboard. */
+export interface PortalDatabaseBlockViewContract {
+    id: string;
+    title: string;
+    isDefault: boolean;
+}
+/** A Database table or a shared Dashboard, with the views it offers. */
+export interface PortalDatabaseBlockSourceContract {
+    /** Use as `target.dashboardId`. */
+    id: string;
+    title: string;
+    views: PortalDatabaseBlockViewContract[];
+}
+/**
+ * Compact discovery projection. Which group is present depends on the request:
+ * `databases` + paging for a database list, `database` + `tables` for one
+ * database, `dashboards` for the shared sources.
+ */
+export interface ListPortalDatabaseBlockSourcesResponseContract {
+    /** `type=database` with no `databaseId`: one page of databases. */
+    databases?: {
+        id: string;
+        title: string;
+        alias?: string;
+    }[];
+    /** Current database page. */
+    page?: number;
+    /** Database page size; always 20. */
+    limit?: number;
+    /** Total databases matching the search. */
+    total?: number;
+    /** Present only while further database pages exist. */
+    nextPage?: number;
+    /** `type=database` with `databaseId`: the selected database. */
+    database?: {
+        id: string;
+        title: string;
+    };
+    /** Tables of the selected database. */
+    tables?: PortalDatabaseBlockSourceContract[];
+    /** `type=dashboard`: every shared dashboard source. */
+    dashboards?: PortalDatabaseBlockSourceContract[];
+}
+export interface SetDashboardViewReadonlyRequestContract {
+    /** True restricts editing of the view everywhere it is used. */
+    readonly: boolean;
+}
+export interface SetDashboardViewReadonlyResponseContract {
+    viewId: string;
+    readonly: 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 +861,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 +897,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 +937,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
@@ -423,3 +1174,89 @@ export interface PortalContentItemContract {
 export interface ListPortalContentResponseContract {
     items: PortalContentItemContract[];
 }
+export interface PortalAiAgentContract {
+    /** Agent global id — pass verbatim to addPortalAiAgentBlock as agentId. */
+    id: string;
+    /** Agent title; becomes the block title when the agent is added. */
+    title: string;
+    /** Short description, when the agent has one. */
+    description?: string;
+    /** Icon key, for display only. */
+    iconName?: string;
+    /** Icon colour, for display only. */
+    iconColor?: string;
+}
+export interface ListPortalAiAgentsResponseContract {
+    /** Matched agents (a single bounded page). */
+    agents: PortalAiAgentContract[];
+    /** Opaque cursor for the next page; absent when there are no more results. */
+    nextCursor?: string;
+}
+export interface GetPortalPageBlockCountResponseContract {
+    /**
+     * Number of matching active blocks on the page, counted over published data
+     * plus the portal's active customizer draft.
+     * @TJS-type integer
+     */
+    count: number;
+}
+export interface AddPortalAiAgentBlockRequestContract {
+    /** Exact agent id from listPortalAiAgents. Never invent one. */
+    agentId: string;
+}
+export interface AddPortalAiAgentBlockResponseContract {
+    /** Id of the created AI Agent 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 declare const PortalDatabaseBlockTargetContract: {
+    readonly Database: "database";
+};
+export declare const PortalBackgroundContract: {
+    readonly Color: "color";
+};
+export declare const PortalDatabaseBlockAppearanceContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
+export declare const PortalTextBackgroundContract: {
+    readonly Color: "color";
+};
+export declare const PortalFlexibleTextAppearanceContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
+export declare const PortalCardBackgroundContract: {
+    readonly Color: "color";
+};
+export declare const PortalCardViewContract: {
+    readonly TopImage: "top-image";
+    readonly LeftImage: "left-image";
+    readonly RightImage: "right-image";
+    readonly FillImage: "fill-image";
+};
+export declare const PortalCardAppearanceContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
+export declare const PortalCardDestinationContract: {
+    readonly Portalpage: "portalPage";
+};
+export declare const PortalCountdownAppearanceContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};