@fusebase/fusebase-gate-sdk 2.5.4 → 2.6.1

package/dist/types/app-magic-link/app-magic-link.d.ts

@@ -54,14 +54,21 @@ export interface CreateAppMagicLinkRequestContract {
 export interface CreateAppMagicLinkResponseContract {
     /**
      * globalId of the magic link row, also the value passed to the activation
-     * endpoint.
+     * endpoint. NIM-42663: omitted together with `magicLinkUrl` when the link
+     * may not be handed to the caller.
      */
-    id: string;
+    id?: string;
     /**
      * Fully qualified URL to the app `/link` route with `id` (and optional
      * `redirect`) query params.
+     *
+     * NIM-42663: omitted when the recipient email belongs to an existing
+     * FuseBase account that is not already a member of this organization —
+     * activating a link logs the caller in as that user, so the link is only
+     * emailed to the address itself. Present when the invite provisions a
+     * brand-new account or targets an existing org member.
      */
-    magicLinkUrl: string;
+    magicLinkUrl?: string;
     /**
      * Unix timestamp (seconds) when the link expires (createdAt + ttlSeconds,
      * defaulting to 24h when ttlSeconds is omitted).
@@ -175,8 +182,13 @@ export interface RevokeAppMagicLinkResponseContract {
  * material — only metadata safe for an owner/support view.
  */
 export interface AppMagicLinkSummaryContract {
-    /** globalId of the magic link row. */
-    id: string;
+    /**
+     * globalId of the magic link row. NIM-42663: omitted for links whose URL was
+     * never disclosed to the owner (self-service links, and invites to existing
+     * accounts outside the org) — the id activates the link. Such a link cannot
+     * be revoked by id; remove the recipient's access principal instead.
+     */
+    id?: string;
     /**
      * Recipient email the link was issued to.
      * @nullable true