@fusebase/fusebase-gate-sdk 2.3.11 → 2.3.12

package/dist/apis/PortalsApi.d.ts

@@ -5,7 +5,7 @@
  * Domain: portals
  */
 import type { Client } from "../runtime/transport";
-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";
+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";
 export declare class PortalsApi {
     private client;
     constructor(client: Client);
@@ -33,6 +33,18 @@ export declare class PortalsApi {
         headers?: Record<string, string>;
         body: AddPortalNoteBlockRequestContract;
     }): Promise<AddPortalNoteBlockResponseContract>;
+    /**
+     * Invite multiple users to a portal in one call
+     * Invites a batch of users to a single portal in one request, replacing N sequential inviteToPortal calls. Portal discovery (listPortals/getPortal) runs once for the whole batch. Invites are processed with bounded concurrency (default 5, max 5); the rest are queued. With background=false (default) the response waits for all invites and returns aggregated per-invitation results (status='completed'). With background=true the response returns immediately (status='processing') and invites run in the background without blocking the caller. Per-invitation orgRole/isFullAccess semantics match inviteToPortal. Invarian — before calling for client invites (orgRole='client' or unspecified): ALWAYS ask the user 'Full access (all pages) or Shared only (public pages)?' and wait for their answer.
+     */
+    bulkInviteToPortal(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            portalId: globalIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: BulkInviteToPortalRequestContract;
+    }): Promise<BulkInviteToPortalResponseContract>;
     /**
      * Create a new portal
      * 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.

package/dist/apis/PortalsApi.js

@@ -41,6 +41,21 @@ class PortalsApi {
             expectedContentType: "application/json",
         });
     }
+    /**
+     * Invite multiple users to a portal in one call
+     * Invites a batch of users to a single portal in one request, replacing N sequential inviteToPortal calls. Portal discovery (listPortals/getPortal) runs once for the whole batch. Invites are processed with bounded concurrency (default 5, max 5); the rest are queued. With background=false (default) the response waits for all invites and returns aggregated per-invitation results (status='completed'). With background=true the response returns immediately (status='processing') and invites run in the background without blocking the caller. Per-invitation orgRole/isFullAccess semantics match inviteToPortal. Invarian — before calling for client invites (orgRole='client' or unspecified): ALWAYS ask the user 'Full access (all pages) or Shared only (public pages)?' and wait for their answer.
+     */
+    async bulkInviteToPortal(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/portals/:portalId/invite/bulk",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "bulkInviteToPortal",
+            expectedContentType: "application/json",
+        });
+    }
     /**
      * Create a new portal
      * 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.

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, 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, 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/portals/portals.d.ts

@@ -266,6 +266,66 @@ export interface InviteToPortalResponseContract {
     /** User ID in the system. */
     userId: number;
 }
+/** A single invitee in a bulk portal invite request. */
+export interface BulkPortalInvitationContract {
+    email: string;
+    fullName?: string;
+    /** Org role for the invitee (default: "client"). */
+    orgRole?: "client" | "member" | "manager";
+    /** Workspace role (default: "editor"). */
+    workspaceRole?: "reader" | "editor";
+    /**
+     * Only relevant when orgRole="client".
+     * true = Full access (all pages, default). false = Shared only (public pages).
+     * Always full access for "member"/"manager".
+     */
+    isFullAccess?: boolean;
+}
+export interface BulkInviteToPortalRequestContract {
+    /** Users to invite to the portal in a single call. */
+    invitations: BulkPortalInvitationContract[];
+    /**
+     * Max number of invites processed in parallel.
+     * Default 5, clamped to the 1..5 range; the rest are queued.
+     */
+    concurrency?: number;
+    /**
+     * When true, respond immediately ("processing") and run the invites in the
+     * background without blocking the caller. Default false: wait for all invites
+     * and return aggregated per-invitation results ("completed").
+     */
+    background?: boolean;
+}
+/** Per-invitation outcome in a completed bulk invite. */
+export interface BulkInviteResultItemContract {
+    email: string;
+    status: "success" | "error";
+    /** Present on success. Magic link for direct portal access. */
+    magicLink?: string;
+    /** Present on success. Portal URL. */
+    url?: string;
+    /** Present on success. User ID in the system. */
+    userId?: number;
+    /** Present on error. Failure reason. */
+    error?: string;
+}
+export interface BulkInviteToPortalResponseContract {
+    /** Total number of invitations received. */
+    total: number;
+    /**
+     * "completed" — invites finished synchronously, `results` is populated.
+     * "processing" — invites accepted and running in the background.
+     */
+    status: "completed" | "processing";
+    /** Background mode only: number of invitations accepted for processing. */
+    accepted?: number;
+    /** Completed mode only: count of successful invites. */
+    succeeded?: number;
+    /** Completed mode only: count of failed invites. */
+    failed?: number;
+    /** Completed mode only: per-invitation results, in request order. */
+    results?: BulkInviteResultItemContract[];
+}
 export interface InvitePortalManagerRequestContract {
     /** Email of the user to invite as a portal manager. */
     email: string;

package/package.json

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

@@ -0,0 +1,53 @@
+# Release Notes 2.3.12
+
+- Current ref: `HEAD`
+- Previous tag: `v2.3.12`
+- Generated at: 2026-06-29T08:59:27.274Z
+
+## Included Drafts
+
+- `docs/release-notes/2026-06-16-bulk-invite-to-portal.md` - Bulk invite users to a portal
+
+## Summary
+
+### Bulk invite users to a portal
+
+Gate exposes `POST /:orgId/portals/:portalId/invite/bulk` (`bulkInviteToPortal`) to invite many users to a single portal in one request, replacing N sequential `inviteToPortal` calls. Invites run with bounded concurrency (default 5, max 5); the rest are queued. Portal discovery (`listPortals`/`getPortal`) runs once for the whole batch. An optional `background` mode returns immediately without blocking the caller.
+
+
+## API / SDK Changes
+
+### Bulk invite users to a portal
+
+- Added `bulkInviteToPortal` operation and `PortalsApi.bulkInviteToPortal` SDK client method.
+- Request: `invitations[]` (each item matches `inviteToPortal`: `email` required; optional `fullName`, `orgRole`, `workspaceRole`, `isFullAccess`), optional `concurrency` (1..5, default 5), optional `background` (default false).
+- Response: `total`, `status` (`completed` | `processing`). For `completed`: `succeeded`, `failed`, `results[]` (`{ email, status, magicLink?, url?, userId?, error? }`). For `processing`: `accepted`.
+- Per-invitation `orgRole`/`isFullAccess` semantics are identical to `inviteToPortal` (shared `invitePortalUser` helper).
+- Permission: `portals.manage` with org-scoped authz (same as `inviteToPortal`).
+- MCP: `bulkInviteToPortal` is MCP-visible under the `portals` prompt group; the prompt now documents batching, concurrency, background mode, and the client access-clarification rule.
+
+
+## Consumer Impact
+
+### Bulk invite users to a portal
+
+- App agents inviting several clients can issue one call instead of N blocking sequential requests.
+- Single `inviteToPortal` is unchanged; behavior and response shape are preserved.
+- Failures are isolated per invitee in `completed` mode — a single bad invite does not fail the batch.
+
+
+## Verification
+
+### Bulk invite users to a portal
+
+- `npm test -- tests/unit/portals-bulk-invite-controller.test.ts tests/unit/concurrency.test.ts tests/unit/portals-controller.test.ts`
+- `npm run build`
+- `npm run build:sdk`
+- `npm run mcp:skills:generate` (validate blocked locally: `skills-ref` Python module unavailable in this environment)
+
+
+## Follow-ups
+
+### Bulk invite users to a portal
+
+- Background mode is fire-and-forget within the request pod; if durable retry/observability is later required, move bulk processing to a worker/queue.

package/release-notes/latest.md

@@ -1,9 +1,53 @@
-# Release Notes 2.3.11
+# Release Notes 2.3.12
 
 - Current ref: `HEAD`
-- Previous tag: `v2.3.11`
-- Generated at: 2026-06-26T10:53:55.284Z
+- Previous tag: `v2.3.12`
+- Generated at: 2026-06-29T08:59:27.274Z
 
 ## Included Drafts
 
-- None
+- `docs/release-notes/2026-06-16-bulk-invite-to-portal.md` - Bulk invite users to a portal
+
+## Summary
+
+### Bulk invite users to a portal
+
+Gate exposes `POST /:orgId/portals/:portalId/invite/bulk` (`bulkInviteToPortal`) to invite many users to a single portal in one request, replacing N sequential `inviteToPortal` calls. Invites run with bounded concurrency (default 5, max 5); the rest are queued. Portal discovery (`listPortals`/`getPortal`) runs once for the whole batch. An optional `background` mode returns immediately without blocking the caller.
+
+
+## API / SDK Changes
+
+### Bulk invite users to a portal
+
+- Added `bulkInviteToPortal` operation and `PortalsApi.bulkInviteToPortal` SDK client method.
+- Request: `invitations[]` (each item matches `inviteToPortal`: `email` required; optional `fullName`, `orgRole`, `workspaceRole`, `isFullAccess`), optional `concurrency` (1..5, default 5), optional `background` (default false).
+- Response: `total`, `status` (`completed` | `processing`). For `completed`: `succeeded`, `failed`, `results[]` (`{ email, status, magicLink?, url?, userId?, error? }`). For `processing`: `accepted`.
+- Per-invitation `orgRole`/`isFullAccess` semantics are identical to `inviteToPortal` (shared `invitePortalUser` helper).
+- Permission: `portals.manage` with org-scoped authz (same as `inviteToPortal`).
+- MCP: `bulkInviteToPortal` is MCP-visible under the `portals` prompt group; the prompt now documents batching, concurrency, background mode, and the client access-clarification rule.
+
+
+## Consumer Impact
+
+### Bulk invite users to a portal
+
+- App agents inviting several clients can issue one call instead of N blocking sequential requests.
+- Single `inviteToPortal` is unchanged; behavior and response shape are preserved.
+- Failures are isolated per invitee in `completed` mode — a single bad invite does not fail the batch.
+
+
+## Verification
+
+### Bulk invite users to a portal
+
+- `npm test -- tests/unit/portals-bulk-invite-controller.test.ts tests/unit/concurrency.test.ts tests/unit/portals-controller.test.ts`
+- `npm run build`
+- `npm run build:sdk`
+- `npm run mcp:skills:generate` (validate blocked locally: `skills-ref` Python module unavailable in this environment)
+
+
+## Follow-ups
+
+### Bulk invite users to a portal
+
+- Background mode is fire-and-forget within the request pod; if durable retry/observability is later required, move bulk processing to a worker/queue.

package/release-notes/2.3.11.md

@@ -1,9 +0,0 @@
-# Release Notes 2.3.11
-
-- Current ref: `HEAD`
-- Previous tag: `v2.3.11`
-- Generated at: 2026-06-26T10:53:55.284Z
-
-## Included Drafts
-
-- None

package/release-notes/2.3.5-sdk.8.md

@@ -1,9 +0,0 @@
-# Release Notes 2.3.5-sdk.8
-
-- Current ref: `HEAD`
-- Previous tag: `v2.3.5-sdk.7`
-- Generated at: 2026-06-24T15:04:43.797Z
-
-## Included Drafts
-
-- None