@teamvortexsoftware/vortex-node-22-sdk 0.1.3 → 0.3.0

package/README.md

@@ -4,6 +4,21 @@ This package provides the Vortex Node/Typescript SDK.
 
 With this module, you can both generate a JWT for use with the Vortex Widget and make API calls to the Vortex API.
 
+## Features
+
+### Invitation Delivery Types
+
+Vortex supports multiple delivery methods for invitations:
+
+- **`email`** - Email invitations sent by Vortex (includes reminders and nudges)
+- **`phone`** - Phone invitations sent by the user/customer
+- **`share`** - Shareable invitation links for social sharing
+- **`internal`** - Internal invitations managed entirely by your application
+  - No email/SMS communication triggered by Vortex
+  - Target value can be any customer-defined identifier (UUID, string, number)
+  - Useful for in-app invitation flows where you handle the delivery
+  - Example use case: In-app notifications, dashboard invites, etc.
+
 ## Use Cases and Examples
 
 ### Install the NodeJS SDK
@@ -45,7 +60,9 @@ app.get('/vortex-jwt', (req, res) => {
     user: {
       id: 'user-123',
       email: 'user@example.com',
-      adminScopes: ['autojoin'], // Optional: grants admin privileges for autojoining
+      name: 'Jane Doe',                                      // Optional: user's display name
+      avatarUrl: 'https://example.com/avatars/jane.jpg',    // Optional: user's avatar URL
+      adminScopes: ['autojoin'],                             // Optional: grants admin privileges for autojoining
     },
   });
 
@@ -57,6 +74,30 @@ app.listen(port, () => {
 });
 ```
 
+#### User Profile Information (Optional)
+
+You can optionally include the user's name and avatar URL in JWTs. This information will be stored and returned when fetching invitations created by this user.
+
+```ts
+const token = vortex.generateJwt({
+  user: {
+    id: 'user-123',
+    email: 'user@example.com',
+    name: 'Jane Doe',                                    // Optional
+    avatarUrl: 'https://example.com/avatars/jane.jpg',  // Optional
+  },
+});
+```
+
+**Requirements:**
+- `name`: Optional string (max 200 characters)
+- `avatarUrl`: Optional HTTPS URL (max 2000 characters)
+- Both fields are optional and can be omitted
+
+**Validation:**
+- Invalid or non-HTTPS avatar URLs will be ignored with a warning
+- Authentication will succeed even with invalid avatar URLs
+
 You can also add extra properties to the JWT payload:
 
 ```ts
@@ -87,7 +128,7 @@ const userId = 'users-id-in-my-system';
 const identifiers = [
   { type: 'email', value: 'users@emailaddress.com' },
   { type: 'email', value: 'someother@address.com' },
-  { type: 'sms', value: '18008675309' },
+  { type: 'phone', value: '18008675309' },
 ];
 
 // groups are specific to your product. This list should be the groups that the current requesting user is a part of. It is up to you to define them if you so choose. Based on the values here, we can determine whether or not the user is allowed to invite others to a particular group
@@ -219,7 +260,7 @@ app.get('/invite/landing', async (req, res) => {
 
 ### View invitations by target (email address for example)
 
-Depending on your use case, you may want to accept all outstanding invitations to a given user when they sign up for your service. If you don't want to auto accept, you may want to present the new user with a list of all invitations that target them. Either way, the example below shows how you fetch these invitations once you know how to identify (via email, sms or others in the future) a new user to your product.
+Depending on your use case, you may want to accept all outstanding invitations to a given user when they sign up for your service. If you don't want to auto accept, you may want to present the new user with a list of all invitations that target them. Either way, the example below shows how you fetch these invitations once you know how to identify (via email, phone or others in the future) a new user to your product.
 
 ```ts
 app.get('/invitations/by-email', async (req, res) => {

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 type InvitationTarget = {
-    type: 'email' | 'sms';
+    type: 'email' | 'phone';
     value: string;
 };
 /**
@@ -40,7 +40,7 @@ type InvitationResult = {
     createdAt: string;
     deactivated: boolean;
     deliveryCount: number;
-    deliveryTypes: ('email' | 'sms' | 'share')[];
+    deliveryTypes: ('email' | 'phone' | 'share' | 'internal')[];
     foreignCreatorId: string;
     invitationType: 'single_use' | 'multi_use';
     modifiedAt: string | null;
@@ -53,21 +53,40 @@ type InvitationResult = {
     accepts: InvitationAcceptance[];
     expired: boolean;
     expires?: string;
+    source?: string;
+    creatorName?: string | null;
+    creatorAvatarUrl?: string | null;
+};
+/**
+ * User type for accepting invitations
+ * Requires either email or phone (or both)
+ */
+type AcceptUser = {
+    email?: string;
+    phone?: string;
+    name?: string;
 };
 type AcceptInvitationRequest = {
+    invitationIds: string[];
+    user: AcceptUser;
+};
+type AcceptInvitationRequestLegacy = {
     invitationIds: string[];
     target: InvitationTarget;
 };
 type ApiResponseJson = InvitationResult | {
     invitations: InvitationResult[];
 } | {};
-type ApiRequestBody = AcceptInvitationRequest | null;
+type ApiRequestBody = AcceptInvitationRequest | AcceptInvitationRequestLegacy | null;
 /**
  * User type for JWT generation
+ * Requires both id and email
  */
 type User = {
     id: string;
     email: string;
+    name?: string;
+    avatarUrl?: string;
     adminScopes?: string[];
     [key: string]: any;
 };
@@ -96,6 +115,73 @@ type ConfigureAutojoinRequest = {
     widgetId: string;
     metadata?: Record<string, any>;
 };
+/**
+ * Target types for creating invitations
+ */
+type CreateInvitationTargetType = 'email' | 'phone' | 'internal';
+/**
+ * Target for creating an invitation
+ */
+type CreateInvitationTarget = {
+    type: CreateInvitationTargetType;
+    value: string;
+};
+/**
+ * Information about the user creating the invitation (the inviter)
+ */
+type Inviter = {
+    /** The internal user ID of the person creating the invitation (from your system) */
+    userId: string;
+    /** The email address of the person creating the invitation */
+    userEmail?: string;
+    /** The display name of the person creating the invitation */
+    name?: string;
+    /** Avatar URL for the person creating the invitation */
+    avatarUrl?: string;
+};
+/**
+ * Group information for creating invitations
+ */
+type CreateInvitationGroup = {
+    /** The type of the group/scope (e.g., "team", "organization", "project") */
+    type: string;
+    /** The ID of the group/scope in your system */
+    groupId: string;
+    /** The display name of the group/scope */
+    name: string;
+};
+/**
+ * Request body for creating an invitation via the public API
+ */
+type CreateInvitationRequest = {
+    /** The ID of the widget configuration to use for this invitation */
+    widgetConfigurationId: string;
+    /** The target of the invitation (who is being invited) */
+    target: CreateInvitationTarget;
+    /** Information about the user creating the invitation */
+    inviter: Inviter;
+    /** Groups/scopes to associate with this invitation */
+    groups?: CreateInvitationGroup[];
+    /** The source of the invitation for analytics (e.g., "api", "backend", "pymk") */
+    source?: string;
+    /** Template variables for email customization */
+    templateVariables?: Record<string, string>;
+    /** Custom metadata to attach to the invitation (passed through to webhooks) */
+    metadata?: Record<string, any>;
+};
+/**
+ * Response from creating an invitation
+ */
+type CreateInvitationResponse = {
+    /** The ID of the created invitation */
+    id: string;
+    /** The short link for the invitation */
+    shortLink: string;
+    /** The status of the invitation */
+    status: string;
+    /** When the invitation was created */
+    createdAt: string;
+};
 
 declare class Vortex {
     private apiKey;
@@ -131,10 +217,34 @@ declare class Vortex {
     getInvitationsByTarget(targetType: 'email' | 'username' | 'phoneNumber', targetValue: string): Promise<InvitationResult[]>;
     getInvitation(invitationId: string): Promise<InvitationResult>;
     revokeInvitation(invitationId: string): Promise<{}>;
-    acceptInvitations(invitationIds: string[], target: {
-        type: 'email' | 'username' | 'phoneNumber';
-        value: string;
-    }): Promise<InvitationResult>;
+    /**
+     * Accept invitations using the new User format (preferred)
+     * @param invitationIds - Array of invitation IDs to accept
+     * @param user - User object with email or phone (and optional name)
+     * @returns Invitation result
+     * @example
+     * ```typescript
+     * await vortex.acceptInvitations(['inv-123'], { email: 'user@example.com', name: 'John' });
+     * ```
+     */
+    acceptInvitations(invitationIds: string[], user: AcceptUser): Promise<InvitationResult>;
+    /**
+     * Accept invitations using legacy target format (deprecated)
+     * @deprecated Use the User format instead: acceptInvitations(invitationIds, { email: 'user@example.com' })
+     * @param invitationIds - Array of invitation IDs to accept
+     * @param target - Legacy target object with type and value
+     * @returns Invitation result
+     */
+    acceptInvitations(invitationIds: string[], target: InvitationTarget): Promise<InvitationResult>;
+    /**
+     * Accept invitations using multiple legacy targets (deprecated)
+     * Will call the accept endpoint once per target
+     * @deprecated Use the User format instead: acceptInvitations(invitationIds, { email: 'user@example.com' })
+     * @param invitationIds - Array of invitation IDs to accept
+     * @param targets - Array of legacy target objects
+     * @returns Invitation result from the last acceptance
+     */
+    acceptInvitations(invitationIds: string[], targets: InvitationTarget[]): Promise<InvitationResult>;
     deleteInvitationsByGroup(groupType: string, groupId: string): Promise<{}>;
     getInvitationsByGroup(groupType: string, groupId: string): Promise<InvitationResult[]>;
     reinvite(invitationId: string): Promise<InvitationResult>;
@@ -179,6 +289,48 @@ declare class Vortex {
      * ```
      */
     configureAutojoin(params: ConfigureAutojoinRequest): Promise<AutojoinDomainsResponse>;
+    /**
+     * Create an invitation from your backend
+     *
+     * This method allows you to create invitations programmatically using your API key,
+     * without requiring a user JWT token. This is useful for server-side invitation
+     * creation, such as "People You May Know" flows or admin-initiated invitations.
+     *
+     * @param params - Invitation parameters
+     * @param params.widgetConfigurationId - The widget configuration ID to use
+     * @param params.target - The target of the invitation (who is being invited)
+     * @param params.target.type - 'email', 'phone', or 'internal'
+     * @param params.target.value - Email address, phone number, or internal user ID
+     * @param params.inviter - Information about the user creating the invitation
+     * @param params.inviter.userId - Your internal user ID for the inviter
+     * @param params.inviter.userEmail - Optional email of the inviter
+     * @param params.inviter.name - Optional display name of the inviter
+     * @param params.groups - Optional groups/scopes to associate with the invitation
+     * @param params.source - Optional source for analytics (defaults to 'api')
+     * @param params.templateVariables - Optional template variables for email customization
+     * @param params.metadata - Optional metadata passed through to webhooks
+     * @returns Created invitation with ID, short link, status, and creation timestamp
+     *
+     * @example
+     * ```typescript
+     * // Create an email invitation
+     * const invitation = await vortex.createInvitation({
+     *   widgetConfigurationId: 'widget-config-123',
+     *   target: { type: 'email', value: 'invitee@example.com' },
+     *   inviter: { userId: 'user-456', userEmail: 'inviter@example.com', name: 'John Doe' },
+     *   groups: [{ type: 'team', groupId: 'team-789', name: 'Engineering' }],
+     * });
+     *
+     * // Create an internal invitation (PYMK flow - no email sent)
+     * const pymkInvitation = await vortex.createInvitation({
+     *   widgetConfigurationId: 'widget-config-123',
+     *   target: { type: 'internal', value: 'internal-user-id-abc' },
+     *   inviter: { userId: 'user-456' },
+     *   source: 'pymk',
+     * });
+     * ```
+     */
+    createInvitation(params: CreateInvitationRequest): Promise<CreateInvitationResponse>;
 }
 
-export { type AcceptInvitationRequest, type ApiRequestBody, type ApiResponseJson, type AutojoinDomain, type AutojoinDomainsResponse, type ConfigureAutojoinRequest, type GroupInput, type InvitationAcceptance, type InvitationGroup, type InvitationResult, type InvitationTarget, type User, Vortex };
+export { type AcceptInvitationRequest, type AcceptInvitationRequestLegacy, type AcceptUser, type ApiRequestBody, type ApiResponseJson, type AutojoinDomain, type AutojoinDomainsResponse, type ConfigureAutojoinRequest, type CreateInvitationGroup, type CreateInvitationRequest, type CreateInvitationResponse, type CreateInvitationTarget, type CreateInvitationTargetType, type GroupInput, type InvitationAcceptance, type InvitationGroup, type InvitationResult, type InvitationTarget, type Inviter, type User, Vortex };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 type InvitationTarget = {
-    type: 'email' | 'sms';
+    type: 'email' | 'phone';
     value: string;
 };
 /**
@@ -40,7 +40,7 @@ type InvitationResult = {
     createdAt: string;
     deactivated: boolean;
     deliveryCount: number;
-    deliveryTypes: ('email' | 'sms' | 'share')[];
+    deliveryTypes: ('email' | 'phone' | 'share' | 'internal')[];
     foreignCreatorId: string;
     invitationType: 'single_use' | 'multi_use';
     modifiedAt: string | null;
@@ -53,21 +53,40 @@ type InvitationResult = {
     accepts: InvitationAcceptance[];
     expired: boolean;
     expires?: string;
+    source?: string;
+    creatorName?: string | null;
+    creatorAvatarUrl?: string | null;
+};
+/**
+ * User type for accepting invitations
+ * Requires either email or phone (or both)
+ */
+type AcceptUser = {
+    email?: string;
+    phone?: string;
+    name?: string;
 };
 type AcceptInvitationRequest = {
+    invitationIds: string[];
+    user: AcceptUser;
+};
+type AcceptInvitationRequestLegacy = {
     invitationIds: string[];
     target: InvitationTarget;
 };
 type ApiResponseJson = InvitationResult | {
     invitations: InvitationResult[];
 } | {};
-type ApiRequestBody = AcceptInvitationRequest | null;
+type ApiRequestBody = AcceptInvitationRequest | AcceptInvitationRequestLegacy | null;
 /**
  * User type for JWT generation
+ * Requires both id and email
  */
 type User = {
     id: string;
     email: string;
+    name?: string;
+    avatarUrl?: string;
     adminScopes?: string[];
     [key: string]: any;
 };
@@ -96,6 +115,73 @@ type ConfigureAutojoinRequest = {
     widgetId: string;
     metadata?: Record<string, any>;
 };
+/**
+ * Target types for creating invitations
+ */
+type CreateInvitationTargetType = 'email' | 'phone' | 'internal';
+/**
+ * Target for creating an invitation
+ */
+type CreateInvitationTarget = {
+    type: CreateInvitationTargetType;
+    value: string;
+};
+/**
+ * Information about the user creating the invitation (the inviter)
+ */
+type Inviter = {
+    /** The internal user ID of the person creating the invitation (from your system) */
+    userId: string;
+    /** The email address of the person creating the invitation */
+    userEmail?: string;
+    /** The display name of the person creating the invitation */
+    name?: string;
+    /** Avatar URL for the person creating the invitation */
+    avatarUrl?: string;
+};
+/**
+ * Group information for creating invitations
+ */
+type CreateInvitationGroup = {
+    /** The type of the group/scope (e.g., "team", "organization", "project") */
+    type: string;
+    /** The ID of the group/scope in your system */
+    groupId: string;
+    /** The display name of the group/scope */
+    name: string;
+};
+/**
+ * Request body for creating an invitation via the public API
+ */
+type CreateInvitationRequest = {
+    /** The ID of the widget configuration to use for this invitation */
+    widgetConfigurationId: string;
+    /** The target of the invitation (who is being invited) */
+    target: CreateInvitationTarget;
+    /** Information about the user creating the invitation */
+    inviter: Inviter;
+    /** Groups/scopes to associate with this invitation */
+    groups?: CreateInvitationGroup[];
+    /** The source of the invitation for analytics (e.g., "api", "backend", "pymk") */
+    source?: string;
+    /** Template variables for email customization */
+    templateVariables?: Record<string, string>;
+    /** Custom metadata to attach to the invitation (passed through to webhooks) */
+    metadata?: Record<string, any>;
+};
+/**
+ * Response from creating an invitation
+ */
+type CreateInvitationResponse = {
+    /** The ID of the created invitation */
+    id: string;
+    /** The short link for the invitation */
+    shortLink: string;
+    /** The status of the invitation */
+    status: string;
+    /** When the invitation was created */
+    createdAt: string;
+};
 
 declare class Vortex {
     private apiKey;
@@ -131,10 +217,34 @@ declare class Vortex {
     getInvitationsByTarget(targetType: 'email' | 'username' | 'phoneNumber', targetValue: string): Promise<InvitationResult[]>;
     getInvitation(invitationId: string): Promise<InvitationResult>;
     revokeInvitation(invitationId: string): Promise<{}>;
-    acceptInvitations(invitationIds: string[], target: {
-        type: 'email' | 'username' | 'phoneNumber';
-        value: string;
-    }): Promise<InvitationResult>;
+    /**
+     * Accept invitations using the new User format (preferred)
+     * @param invitationIds - Array of invitation IDs to accept
+     * @param user - User object with email or phone (and optional name)
+     * @returns Invitation result
+     * @example
+     * ```typescript
+     * await vortex.acceptInvitations(['inv-123'], { email: 'user@example.com', name: 'John' });
+     * ```
+     */
+    acceptInvitations(invitationIds: string[], user: AcceptUser): Promise<InvitationResult>;
+    /**
+     * Accept invitations using legacy target format (deprecated)
+     * @deprecated Use the User format instead: acceptInvitations(invitationIds, { email: 'user@example.com' })
+     * @param invitationIds - Array of invitation IDs to accept
+     * @param target - Legacy target object with type and value
+     * @returns Invitation result
+     */
+    acceptInvitations(invitationIds: string[], target: InvitationTarget): Promise<InvitationResult>;
+    /**
+     * Accept invitations using multiple legacy targets (deprecated)
+     * Will call the accept endpoint once per target
+     * @deprecated Use the User format instead: acceptInvitations(invitationIds, { email: 'user@example.com' })
+     * @param invitationIds - Array of invitation IDs to accept
+     * @param targets - Array of legacy target objects
+     * @returns Invitation result from the last acceptance
+     */
+    acceptInvitations(invitationIds: string[], targets: InvitationTarget[]): Promise<InvitationResult>;
     deleteInvitationsByGroup(groupType: string, groupId: string): Promise<{}>;
     getInvitationsByGroup(groupType: string, groupId: string): Promise<InvitationResult[]>;
     reinvite(invitationId: string): Promise<InvitationResult>;
@@ -179,6 +289,48 @@ declare class Vortex {
      * ```
      */
     configureAutojoin(params: ConfigureAutojoinRequest): Promise<AutojoinDomainsResponse>;
+    /**
+     * Create an invitation from your backend
+     *
+     * This method allows you to create invitations programmatically using your API key,
+     * without requiring a user JWT token. This is useful for server-side invitation
+     * creation, such as "People You May Know" flows or admin-initiated invitations.
+     *
+     * @param params - Invitation parameters
+     * @param params.widgetConfigurationId - The widget configuration ID to use
+     * @param params.target - The target of the invitation (who is being invited)
+     * @param params.target.type - 'email', 'phone', or 'internal'
+     * @param params.target.value - Email address, phone number, or internal user ID
+     * @param params.inviter - Information about the user creating the invitation
+     * @param params.inviter.userId - Your internal user ID for the inviter
+     * @param params.inviter.userEmail - Optional email of the inviter
+     * @param params.inviter.name - Optional display name of the inviter
+     * @param params.groups - Optional groups/scopes to associate with the invitation
+     * @param params.source - Optional source for analytics (defaults to 'api')
+     * @param params.templateVariables - Optional template variables for email customization
+     * @param params.metadata - Optional metadata passed through to webhooks
+     * @returns Created invitation with ID, short link, status, and creation timestamp
+     *
+     * @example
+     * ```typescript
+     * // Create an email invitation
+     * const invitation = await vortex.createInvitation({
+     *   widgetConfigurationId: 'widget-config-123',
+     *   target: { type: 'email', value: 'invitee@example.com' },
+     *   inviter: { userId: 'user-456', userEmail: 'inviter@example.com', name: 'John Doe' },
+     *   groups: [{ type: 'team', groupId: 'team-789', name: 'Engineering' }],
+     * });
+     *
+     * // Create an internal invitation (PYMK flow - no email sent)
+     * const pymkInvitation = await vortex.createInvitation({
+     *   widgetConfigurationId: 'widget-config-123',
+     *   target: { type: 'internal', value: 'internal-user-id-abc' },
+     *   inviter: { userId: 'user-456' },
+     *   source: 'pymk',
+     * });
+     * ```
+     */
+    createInvitation(params: CreateInvitationRequest): Promise<CreateInvitationResponse>;
 }
 
-export { type AcceptInvitationRequest, type ApiRequestBody, type ApiResponseJson, type AutojoinDomain, type AutojoinDomainsResponse, type ConfigureAutojoinRequest, type GroupInput, type InvitationAcceptance, type InvitationGroup, type InvitationResult, type InvitationTarget, type User, Vortex };
+export { type AcceptInvitationRequest, type AcceptInvitationRequestLegacy, type AcceptUser, type ApiRequestBody, type ApiResponseJson, type AutojoinDomain, type AutojoinDomainsResponse, type ConfigureAutojoinRequest, type CreateInvitationGroup, type CreateInvitationRequest, type CreateInvitationResponse, type CreateInvitationTarget, type CreateInvitationTargetType, type GroupInput, type InvitationAcceptance, type InvitationGroup, type InvitationResult, type InvitationTarget, type Inviter, type User, Vortex };

package/dist/index.js

@@ -84,6 +84,12 @@ var Vortex = class {
       // Include identifiers array for widget compatibility (VrtxAutojoin checks this)
       identifiers: user.email ? [{ type: "email", value: user.email }] : []
     };
+    if (user.name) {
+      payload.name = user.name;
+    }
+    if (user.avatarUrl) {
+      payload.avatarUrl = user.avatarUrl;
+    }
     if (user.adminScopes) {
       payload.adminScopes = user.adminScopes;
       if (user.adminScopes.includes("autojoin")) {
@@ -165,12 +171,54 @@ var Vortex = class {
       path: `/api/v1/invitations/${invitationId}`
     });
   }
-  async acceptInvitations(invitationIds, target) {
+  // Implementation
+  async acceptInvitations(invitationIds, userOrTarget) {
+    if (Array.isArray(userOrTarget)) {
+      console.warn(
+        '[Vortex SDK] DEPRECATED: Passing an array of targets is deprecated. Use the User format instead: acceptInvitations(invitationIds, { email: "user@example.com" })'
+      );
+      let lastResult;
+      for (const target of userOrTarget) {
+        lastResult = await this.acceptInvitations(invitationIds, target);
+      }
+      if (!lastResult) {
+        throw new Error("No targets provided");
+      }
+      return lastResult;
+    }
+    const isLegacyTarget = "type" in userOrTarget && "value" in userOrTarget;
+    if (isLegacyTarget) {
+      console.warn(
+        '[Vortex SDK] DEPRECATED: Passing a target object is deprecated. Use the User format instead: acceptInvitations(invitationIds, { email: "user@example.com" })'
+      );
+      const target = userOrTarget;
+      const user2 = {};
+      if (target.type === "email") {
+        user2.email = target.value;
+      } else if (target.type === "phone" || target.type === "phoneNumber") {
+        user2.phone = target.value;
+      } else {
+        user2.email = target.value;
+      }
+      const response2 = await this.vortexApiRequest({
+        method: "POST",
+        body: {
+          invitationIds,
+          user: user2
+        },
+        path: `/api/v1/invitations/accept`
+      });
+      return response2;
+    }
+    const user = userOrTarget;
+    if (!user.email && !user.phone) {
+      throw new Error("User must have either email or phone");
+    }
     const response = await this.vortexApiRequest({
       method: "POST",
       body: {
         invitationIds,
-        target
+        user
       },
       path: `/api/v1/invitations/accept`
     });
@@ -247,6 +295,54 @@ var Vortex = class {
       body: params
     });
   }
+  /**
+   * Create an invitation from your backend
+   *
+   * This method allows you to create invitations programmatically using your API key,
+   * without requiring a user JWT token. This is useful for server-side invitation
+   * creation, such as "People You May Know" flows or admin-initiated invitations.
+   *
+   * @param params - Invitation parameters
+   * @param params.widgetConfigurationId - The widget configuration ID to use
+   * @param params.target - The target of the invitation (who is being invited)
+   * @param params.target.type - 'email', 'phone', or 'internal'
+   * @param params.target.value - Email address, phone number, or internal user ID
+   * @param params.inviter - Information about the user creating the invitation
+   * @param params.inviter.userId - Your internal user ID for the inviter
+   * @param params.inviter.userEmail - Optional email of the inviter
+   * @param params.inviter.name - Optional display name of the inviter
+   * @param params.groups - Optional groups/scopes to associate with the invitation
+   * @param params.source - Optional source for analytics (defaults to 'api')
+   * @param params.templateVariables - Optional template variables for email customization
+   * @param params.metadata - Optional metadata passed through to webhooks
+   * @returns Created invitation with ID, short link, status, and creation timestamp
+   *
+   * @example
+   * ```typescript
+   * // Create an email invitation
+   * const invitation = await vortex.createInvitation({
+   *   widgetConfigurationId: 'widget-config-123',
+   *   target: { type: 'email', value: 'invitee@example.com' },
+   *   inviter: { userId: 'user-456', userEmail: 'inviter@example.com', name: 'John Doe' },
+   *   groups: [{ type: 'team', groupId: 'team-789', name: 'Engineering' }],
+   * });
+   *
+   * // Create an internal invitation (PYMK flow - no email sent)
+   * const pymkInvitation = await vortex.createInvitation({
+   *   widgetConfigurationId: 'widget-config-123',
+   *   target: { type: 'internal', value: 'internal-user-id-abc' },
+   *   inviter: { userId: 'user-456' },
+   *   source: 'pymk',
+   * });
+   * ```
+   */
+  async createInvitation(params) {
+    return this.vortexApiRequest({
+      method: "POST",
+      path: "/api/v1/invitations",
+      body: params
+    });
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/vortex.ts"],"sourcesContent":["export * from './vortex';\nexport * from './types';","import crypto from 'node:crypto';\nimport { stringify as uuidStringify } from 'uuid';\nimport {\n  ApiRequestBody,\n  ApiResponseJson,\n  InvitationResult,\n  AcceptInvitationRequest,\n  User,\n  AutojoinDomainsResponse,\n  ConfigureAutojoinRequest,\n} from './types';\n\nexport class Vortex {\n  constructor(private apiKey: string) {}\n\n  /**\n   * Generate a JWT token for a user\n   *\n   * @param params - Object containing user and optional additional properties\n   * @param params.user - User object with id, email, and optional adminScopes\n   * @returns JWT token string\n   *\n   * @example\n   * ```typescript\n   * const token = vortex.generateJwt({\n   *   user: {\n   *     id: \"user-123\",\n   *     email: \"user@example.com\",\n   *     adminScopes: ['autojoin']\n   *   }\n   * });\n   * ```\n   */\n  generateJwt(params: { user: User; [key: string]: any }): string {\n    const { user, ...rest } = params;\n    const [prefix, encodedId, key] = this.apiKey.split('.'); // prefix is just VRTX\n    if (!prefix || !encodedId || !key) {\n      throw new Error('Invalid API key format');\n    }\n    if (prefix !== 'VRTX') {\n      throw new Error('Invalid API key prefix');\n    }\n    const id = uuidStringify(Buffer.from(encodedId, 'base64url'));\n\n    const expires = Math.floor(Date.now() / 1000) + 3600;\n\n    // 🔐 Step 1: Derive signing key from API key + ID\n    const signingKey = crypto.createHmac('sha256', key).update(id).digest(); // <- raw Buffer\n\n    // 🧱 Step 2: Build header + payload\n    const header = {\n      iat: Math.floor(Date.now() / 1000),\n      alg: 'HS256',\n      typ: 'JWT',\n      kid: id,\n    };\n\n    // Build payload with user data\n    const payload: any = {\n      userId: user.id,\n      userEmail: user.email,\n      expires,\n      // Include identifiers array for widget compatibility (VrtxAutojoin checks this)\n      identifiers: user.email ? [{ type: 'email', value: user.email }] : [],\n    };\n\n    // Add adminScopes if present\n    if (user.adminScopes) {\n      payload.adminScopes = user.adminScopes;\n      // Add widget compatibility fields for autojoin admin\n      if (user.adminScopes.includes('autojoin')) {\n        payload.userIsAutojoinAdmin = true;\n        payload.role = 'admin'; // VrtxAutojoin checks parsedJwt.role === 'admin'\n      }\n    }\n\n    // Add any additional properties from rest\n    if (rest && Object.keys(rest).length > 0) {\n      Object.assign(payload, rest);\n    }\n\n    // 🧱 Step 3: Base64URL encode\n    const headerB64 = Buffer.from(JSON.stringify(header)).toString('base64url');\n    const payloadB64 = Buffer.from(JSON.stringify(payload)).toString('base64url');\n\n    // 🧾 Step 4: Sign\n    const toSign = `${headerB64}.${payloadB64}`;\n    const signature = Buffer.from(\n      crypto.createHmac('sha256', signingKey).update(toSign).digest()\n    ).toString('base64url');\n    const jwt = `${toSign}.${signature}`;\n    return jwt;\n  }\n\n  async vortexApiRequest(options: {\n    method: 'GET' | 'POST' | 'PUT' | 'DELETE';\n    path: string;\n    body?: ApiRequestBody;\n    queryParams?: Record<string, string | number | boolean>;\n  }): Promise<ApiResponseJson> {\n    const { method, path, body, queryParams } = options;\n    const url = new URL(\n      `${process.env.VORTEX_API_BASE_URL || 'https://api.vortexsoftware.com'}${path}`\n    );\n    if (queryParams) {\n      Object.entries(queryParams).forEach(([key, value]) => {\n        url.searchParams.append(key, String(value));\n      });\n    }\n    const results = await fetch(url.toString(), {\n      method,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': this.apiKey,\n      },\n      body: body ? JSON.stringify(body) : undefined,\n    });\n    if (!results.ok) {\n      const errorBody = await results.text();\n      throw new Error(\n        `Vortex API request failed: ${results.status} ${results.statusText} - ${errorBody}`\n      );\n    }\n\n    // Check if response has content to parse\n    const contentLength = results.headers.get('content-length');\n    const contentType = results.headers.get('content-type');\n\n    // If no content or content-length is 0, return empty object\n    if (contentLength === '0' || (!contentType?.includes('application/json') && !contentLength)) {\n      return {};\n    }\n\n    // Try to get text first to check if there's actually content\n    const responseText = await results.text();\n    if (!responseText.trim()) {\n      return {};\n    }\n\n    // Parse JSON if there's content\n    try {\n      return JSON.parse(responseText);\n    } catch (error) {\n      // If JSON parsing fails, return the text or empty object\n      return {};\n    }\n  }\n\n  async getInvitationsByTarget(\n    targetType: 'email' | 'username' | 'phoneNumber',\n    targetValue: string\n  ): Promise<InvitationResult[]> {\n    const response = (await this.vortexApiRequest({\n      method: 'GET',\n      path: '/api/v1/invitations',\n      queryParams: {\n        targetType,\n        targetValue,\n      },\n    })) as { invitations: InvitationResult[] };\n    return response.invitations;\n  }\n\n  async getInvitation(invitationId: string): Promise<InvitationResult> {\n    return this.vortexApiRequest({\n      method: 'GET',\n      path: `/api/v1/invitations/${invitationId}`,\n    }) as Promise<InvitationResult>;\n  }\n\n  async revokeInvitation(invitationId: string): Promise<{}> {\n    return this.vortexApiRequest({\n      method: 'DELETE',\n      path: `/api/v1/invitations/${invitationId}`,\n    }) as Promise<{}>;\n  }\n\n  async acceptInvitations(\n    invitationIds: string[],\n    target: { type: 'email' | 'username' | 'phoneNumber'; value: string }\n  ): Promise<InvitationResult> {\n    const response = (await this.vortexApiRequest({\n      method: 'POST',\n      body: {\n        invitationIds,\n        target,\n      } as AcceptInvitationRequest,\n      path: `/api/v1/invitations/accept`,\n    })) as InvitationResult;\n    return response;\n  }\n\n  async deleteInvitationsByGroup(groupType: string, groupId: string): Promise<{}> {\n    return this.vortexApiRequest({\n      method: 'DELETE',\n      path: `/api/v1/invitations/by-group/${groupType}/${groupId}`,\n    }) as Promise<{}>;\n  }\n\n  async getInvitationsByGroup(groupType: string, groupId: string): Promise<InvitationResult[]> {\n    const response = (await this.vortexApiRequest({\n      method: 'GET',\n      path: `/api/v1/invitations/by-group/${groupType}/${groupId}`,\n    })) as { invitations: InvitationResult[] };\n    return response.invitations;\n  }\n\n  async reinvite(invitationId: string): Promise<InvitationResult> {\n    return this.vortexApiRequest({\n      method: 'POST',\n      path: `/api/v1/invitations/${invitationId}/reinvite`,\n    }) as Promise<InvitationResult>;\n  }\n\n  /**\n   * Get autojoin domains configured for a specific scope\n   *\n   * @param scopeType - The type of scope (e.g., \"organization\", \"team\", \"project\")\n   * @param scope - The scope identifier (customer's group ID)\n   * @returns Autojoin domains and associated invitation\n   *\n   * @example\n   * ```typescript\n   * const result = await vortex.getAutojoinDomains('organization', 'acme-org');\n   * console.log(result.autojoinDomains); // [{ id: '...', domain: 'acme.com' }]\n   * ```\n   */\n  async getAutojoinDomains(scopeType: string, scope: string): Promise<AutojoinDomainsResponse> {\n    return this.vortexApiRequest({\n      method: 'GET',\n      path: `/api/v1/invitations/by-scope/${encodeURIComponent(scopeType)}/${encodeURIComponent(scope)}/autojoin`,\n    }) as Promise<AutojoinDomainsResponse>;\n  }\n\n  /**\n   * Configure autojoin domains for a specific scope\n   *\n   * This endpoint syncs autojoin domains - it will add new domains, remove domains\n   * not in the provided list, and deactivate the autojoin invitation if all domains\n   * are removed (empty array).\n   *\n   * @param params - Configuration parameters\n   * @param params.scope - The scope identifier (customer's group ID)\n   * @param params.scopeType - The type of scope (e.g., \"organization\", \"team\")\n   * @param params.scopeName - Optional display name for the scope\n   * @param params.domains - Array of domains to configure for autojoin\n   * @param params.widgetId - The widget configuration ID\n   * @returns Updated autojoin domains and associated invitation\n   *\n   * @example\n   * ```typescript\n   * const result = await vortex.configureAutojoin({\n   *   scope: 'acme-org',\n   *   scopeType: 'organization',\n   *   scopeName: 'Acme Corporation',\n   *   domains: ['acme.com', 'acme.org'],\n   *   widgetId: 'widget-123',\n   * });\n   * ```\n   */\n  async configureAutojoin(params: ConfigureAutojoinRequest): Promise<AutojoinDomainsResponse> {\n    return this.vortexApiRequest({\n      method: 'POST',\n      path: '/api/v1/invitations/autojoin',\n      body: params as unknown as ApiRequestBody,\n    }) as Promise<AutojoinDomainsResponse>;\n  }\n}\n"],"mappings":"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","names":["uuidStringify","crypto"]}
+{"version":3,"sources":["../src/index.ts","../src/vortex.ts"],"sourcesContent":["export * from './vortex';\nexport * from './types';","import crypto from 'node:crypto';\nimport { stringify as uuidStringify } from 'uuid';\nimport {\n  ApiRequestBody,\n  ApiResponseJson,\n  InvitationResult,\n  AcceptInvitationRequest,\n  User,\n  AcceptUser,\n  AutojoinDomainsResponse,\n  ConfigureAutojoinRequest,\n  InvitationTarget,\n  CreateInvitationRequest,\n  CreateInvitationResponse,\n} from './types';\n\nexport class Vortex {\n  constructor(private apiKey: string) {}\n\n  /**\n   * Generate a JWT token for a user\n   *\n   * @param params - Object containing user and optional additional properties\n   * @param params.user - User object with id, email, and optional adminScopes\n   * @returns JWT token string\n   *\n   * @example\n   * ```typescript\n   * const token = vortex.generateJwt({\n   *   user: {\n   *     id: \"user-123\",\n   *     email: \"user@example.com\",\n   *     adminScopes: ['autojoin']\n   *   }\n   * });\n   * ```\n   */\n  generateJwt(params: { user: User; [key: string]: any }): string {\n    const { user, ...rest } = params;\n    const [prefix, encodedId, key] = this.apiKey.split('.'); // prefix is just VRTX\n    if (!prefix || !encodedId || !key) {\n      throw new Error('Invalid API key format');\n    }\n    if (prefix !== 'VRTX') {\n      throw new Error('Invalid API key prefix');\n    }\n    const id = uuidStringify(Buffer.from(encodedId, 'base64url'));\n\n    const expires = Math.floor(Date.now() / 1000) + 3600;\n\n    // 🔐 Step 1: Derive signing key from API key + ID\n    const signingKey = crypto.createHmac('sha256', key).update(id).digest(); // <- raw Buffer\n\n    // 🧱 Step 2: Build header + payload\n    const header = {\n      iat: Math.floor(Date.now() / 1000),\n      alg: 'HS256',\n      typ: 'JWT',\n      kid: id,\n    };\n\n    // Build payload with user data\n    const payload: any = {\n      userId: user.id,\n      userEmail: user.email,\n      expires,\n      // Include identifiers array for widget compatibility (VrtxAutojoin checks this)\n      identifiers: user.email ? [{ type: 'email', value: user.email }] : [],\n    };\n\n    // Add name if present\n    if (user.name) {\n      payload.name = user.name;\n    }\n\n    // Add avatarUrl if present\n    if (user.avatarUrl) {\n      payload.avatarUrl = user.avatarUrl;\n    }\n\n    // Add adminScopes if present\n    if (user.adminScopes) {\n      payload.adminScopes = user.adminScopes;\n      // Add widget compatibility fields for autojoin admin\n      if (user.adminScopes.includes('autojoin')) {\n        payload.userIsAutojoinAdmin = true;\n        payload.role = 'admin'; // VrtxAutojoin checks parsedJwt.role === 'admin'\n      }\n    }\n\n    // Add any additional properties from rest\n    if (rest && Object.keys(rest).length > 0) {\n      Object.assign(payload, rest);\n    }\n\n    // 🧱 Step 3: Base64URL encode\n    const headerB64 = Buffer.from(JSON.stringify(header)).toString('base64url');\n    const payloadB64 = Buffer.from(JSON.stringify(payload)).toString('base64url');\n\n    // 🧾 Step 4: Sign\n    const toSign = `${headerB64}.${payloadB64}`;\n    const signature = Buffer.from(\n      crypto.createHmac('sha256', signingKey).update(toSign).digest()\n    ).toString('base64url');\n    const jwt = `${toSign}.${signature}`;\n    return jwt;\n  }\n\n  async vortexApiRequest(options: {\n    method: 'GET' | 'POST' | 'PUT' | 'DELETE';\n    path: string;\n    body?: ApiRequestBody;\n    queryParams?: Record<string, string | number | boolean>;\n  }): Promise<ApiResponseJson> {\n    const { method, path, body, queryParams } = options;\n    const url = new URL(\n      `${process.env.VORTEX_API_BASE_URL || 'https://api.vortexsoftware.com'}${path}`\n    );\n    if (queryParams) {\n      Object.entries(queryParams).forEach(([key, value]) => {\n        url.searchParams.append(key, String(value));\n      });\n    }\n    const results = await fetch(url.toString(), {\n      method,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': this.apiKey,\n      },\n      body: body ? JSON.stringify(body) : undefined,\n    });\n    if (!results.ok) {\n      const errorBody = await results.text();\n      throw new Error(\n        `Vortex API request failed: ${results.status} ${results.statusText} - ${errorBody}`\n      );\n    }\n\n    // Check if response has content to parse\n    const contentLength = results.headers.get('content-length');\n    const contentType = results.headers.get('content-type');\n\n    // If no content or content-length is 0, return empty object\n    if (contentLength === '0' || (!contentType?.includes('application/json') && !contentLength)) {\n      return {};\n    }\n\n    // Try to get text first to check if there's actually content\n    const responseText = await results.text();\n    if (!responseText.trim()) {\n      return {};\n    }\n\n    // Parse JSON if there's content\n    try {\n      return JSON.parse(responseText);\n    } catch (error) {\n      // If JSON parsing fails, return the text or empty object\n      return {};\n    }\n  }\n\n  async getInvitationsByTarget(\n    targetType: 'email' | 'username' | 'phoneNumber',\n    targetValue: string\n  ): Promise<InvitationResult[]> {\n    const response = (await this.vortexApiRequest({\n      method: 'GET',\n      path: '/api/v1/invitations',\n      queryParams: {\n        targetType,\n        targetValue,\n      },\n    })) as { invitations: InvitationResult[] };\n    return response.invitations;\n  }\n\n  async getInvitation(invitationId: string): Promise<InvitationResult> {\n    return this.vortexApiRequest({\n      method: 'GET',\n      path: `/api/v1/invitations/${invitationId}`,\n    }) as Promise<InvitationResult>;\n  }\n\n  async revokeInvitation(invitationId: string): Promise<{}> {\n    return this.vortexApiRequest({\n      method: 'DELETE',\n      path: `/api/v1/invitations/${invitationId}`,\n    }) as Promise<{}>;\n  }\n\n  /**\n   * Accept invitations using the new User format (preferred)\n   * @param invitationIds - Array of invitation IDs to accept\n   * @param user - User object with email or phone (and optional name)\n   * @returns Invitation result\n   * @example\n   * ```typescript\n   * await vortex.acceptInvitations(['inv-123'], { email: 'user@example.com', name: 'John' });\n   * ```\n   */\n  async acceptInvitations(invitationIds: string[], user: AcceptUser): Promise<InvitationResult>;\n\n  /**\n   * Accept invitations using legacy target format (deprecated)\n   * @deprecated Use the User format instead: acceptInvitations(invitationIds, { email: 'user@example.com' })\n   * @param invitationIds - Array of invitation IDs to accept\n   * @param target - Legacy target object with type and value\n   * @returns Invitation result\n   */\n  async acceptInvitations(\n    invitationIds: string[],\n    target: InvitationTarget\n  ): Promise<InvitationResult>;\n\n  /**\n   * Accept invitations using multiple legacy targets (deprecated)\n   * Will call the accept endpoint once per target\n   * @deprecated Use the User format instead: acceptInvitations(invitationIds, { email: 'user@example.com' })\n   * @param invitationIds - Array of invitation IDs to accept\n   * @param targets - Array of legacy target objects\n   * @returns Invitation result from the last acceptance\n   */\n  async acceptInvitations(\n    invitationIds: string[],\n    targets: InvitationTarget[]\n  ): Promise<InvitationResult>;\n\n  // Implementation\n  async acceptInvitations(\n    invitationIds: string[],\n    userOrTarget: AcceptUser | InvitationTarget | InvitationTarget[]\n  ): Promise<InvitationResult> {\n    // Handle array of targets (legacy, call once per target)\n    if (Array.isArray(userOrTarget)) {\n      console.warn(\n        '[Vortex SDK] DEPRECATED: Passing an array of targets is deprecated. Use the User format instead: acceptInvitations(invitationIds, { email: \"user@example.com\" })'\n      );\n      let lastResult: InvitationResult | undefined;\n      for (const target of userOrTarget) {\n        lastResult = await this.acceptInvitations(invitationIds, target);\n      }\n      if (!lastResult) {\n        throw new Error('No targets provided');\n      }\n      return lastResult;\n    }\n\n    // Check if it's a legacy target format (has 'type' and 'value' properties)\n    const isLegacyTarget = 'type' in userOrTarget && 'value' in userOrTarget;\n\n    if (isLegacyTarget) {\n      console.warn(\n        '[Vortex SDK] DEPRECATED: Passing a target object is deprecated. Use the User format instead: acceptInvitations(invitationIds, { email: \"user@example.com\" })'\n      );\n\n      // Convert legacy target to User format\n      const target = userOrTarget as InvitationTarget;\n      const user: AcceptUser = {};\n\n      if (target.type === 'email') {\n        user.email = target.value;\n      } else if (target.type === 'phone' || target.type === 'phoneNumber') {\n        user.phone = target.value;\n      } else {\n        // For other types (like 'username'), try to use as email\n        user.email = target.value;\n      }\n\n      // Make request with User format\n      const response = (await this.vortexApiRequest({\n        method: 'POST',\n        body: {\n          invitationIds,\n          user,\n        } as AcceptInvitationRequest,\n        path: `/api/v1/invitations/accept`,\n      })) as InvitationResult;\n      return response;\n    }\n\n    // New User format\n    const user = userOrTarget as AcceptUser;\n\n    // Validate that either email or phone is provided\n    if (!user.email && !user.phone) {\n      throw new Error('User must have either email or phone');\n    }\n\n    const response = (await this.vortexApiRequest({\n      method: 'POST',\n      body: {\n        invitationIds,\n        user,\n      } as AcceptInvitationRequest,\n      path: `/api/v1/invitations/accept`,\n    })) as InvitationResult;\n    return response;\n  }\n\n  async deleteInvitationsByGroup(groupType: string, groupId: string): Promise<{}> {\n    return this.vortexApiRequest({\n      method: 'DELETE',\n      path: `/api/v1/invitations/by-group/${groupType}/${groupId}`,\n    }) as Promise<{}>;\n  }\n\n  async getInvitationsByGroup(groupType: string, groupId: string): Promise<InvitationResult[]> {\n    const response = (await this.vortexApiRequest({\n      method: 'GET',\n      path: `/api/v1/invitations/by-group/${groupType}/${groupId}`,\n    })) as { invitations: InvitationResult[] };\n    return response.invitations;\n  }\n\n  async reinvite(invitationId: string): Promise<InvitationResult> {\n    return this.vortexApiRequest({\n      method: 'POST',\n      path: `/api/v1/invitations/${invitationId}/reinvite`,\n    }) as Promise<InvitationResult>;\n  }\n\n  /**\n   * Get autojoin domains configured for a specific scope\n   *\n   * @param scopeType - The type of scope (e.g., \"organization\", \"team\", \"project\")\n   * @param scope - The scope identifier (customer's group ID)\n   * @returns Autojoin domains and associated invitation\n   *\n   * @example\n   * ```typescript\n   * const result = await vortex.getAutojoinDomains('organization', 'acme-org');\n   * console.log(result.autojoinDomains); // [{ id: '...', domain: 'acme.com' }]\n   * ```\n   */\n  async getAutojoinDomains(scopeType: string, scope: string): Promise<AutojoinDomainsResponse> {\n    return this.vortexApiRequest({\n      method: 'GET',\n      path: `/api/v1/invitations/by-scope/${encodeURIComponent(scopeType)}/${encodeURIComponent(scope)}/autojoin`,\n    }) as Promise<AutojoinDomainsResponse>;\n  }\n\n  /**\n   * Configure autojoin domains for a specific scope\n   *\n   * This endpoint syncs autojoin domains - it will add new domains, remove domains\n   * not in the provided list, and deactivate the autojoin invitation if all domains\n   * are removed (empty array).\n   *\n   * @param params - Configuration parameters\n   * @param params.scope - The scope identifier (customer's group ID)\n   * @param params.scopeType - The type of scope (e.g., \"organization\", \"team\")\n   * @param params.scopeName - Optional display name for the scope\n   * @param params.domains - Array of domains to configure for autojoin\n   * @param params.widgetId - The widget configuration ID\n   * @returns Updated autojoin domains and associated invitation\n   *\n   * @example\n   * ```typescript\n   * const result = await vortex.configureAutojoin({\n   *   scope: 'acme-org',\n   *   scopeType: 'organization',\n   *   scopeName: 'Acme Corporation',\n   *   domains: ['acme.com', 'acme.org'],\n   *   widgetId: 'widget-123',\n   * });\n   * ```\n   */\n  async configureAutojoin(params: ConfigureAutojoinRequest): Promise<AutojoinDomainsResponse> {\n    return this.vortexApiRequest({\n      method: 'POST',\n      path: '/api/v1/invitations/autojoin',\n      body: params as unknown as ApiRequestBody,\n    }) as Promise<AutojoinDomainsResponse>;\n  }\n\n  /**\n   * Create an invitation from your backend\n   *\n   * This method allows you to create invitations programmatically using your API key,\n   * without requiring a user JWT token. This is useful for server-side invitation\n   * creation, such as \"People You May Know\" flows or admin-initiated invitations.\n   *\n   * @param params - Invitation parameters\n   * @param params.widgetConfigurationId - The widget configuration ID to use\n   * @param params.target - The target of the invitation (who is being invited)\n   * @param params.target.type - 'email', 'phone', or 'internal'\n   * @param params.target.value - Email address, phone number, or internal user ID\n   * @param params.inviter - Information about the user creating the invitation\n   * @param params.inviter.userId - Your internal user ID for the inviter\n   * @param params.inviter.userEmail - Optional email of the inviter\n   * @param params.inviter.name - Optional display name of the inviter\n   * @param params.groups - Optional groups/scopes to associate with the invitation\n   * @param params.source - Optional source for analytics (defaults to 'api')\n   * @param params.templateVariables - Optional template variables for email customization\n   * @param params.metadata - Optional metadata passed through to webhooks\n   * @returns Created invitation with ID, short link, status, and creation timestamp\n   *\n   * @example\n   * ```typescript\n   * // Create an email invitation\n   * const invitation = await vortex.createInvitation({\n   *   widgetConfigurationId: 'widget-config-123',\n   *   target: { type: 'email', value: 'invitee@example.com' },\n   *   inviter: { userId: 'user-456', userEmail: 'inviter@example.com', name: 'John Doe' },\n   *   groups: [{ type: 'team', groupId: 'team-789', name: 'Engineering' }],\n   * });\n   *\n   * // Create an internal invitation (PYMK flow - no email sent)\n   * const pymkInvitation = await vortex.createInvitation({\n   *   widgetConfigurationId: 'widget-config-123',\n   *   target: { type: 'internal', value: 'internal-user-id-abc' },\n   *   inviter: { userId: 'user-456' },\n   *   source: 'pymk',\n   * });\n   * ```\n   */\n  async createInvitation(params: CreateInvitationRequest): Promise<CreateInvitationResponse> {\n    return this.vortexApiRequest({\n      method: 'POST',\n      path: '/api/v1/invitations',\n      body: params as unknown as ApiRequestBody,\n    }) as Promise<CreateInvitationResponse>;\n  }\n}\n"],"mappings":"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","names":["uuidStringify","crypto","user","response"]}

package/dist/index.mjs

@@ -48,6 +48,12 @@ var Vortex = class {
       // Include identifiers array for widget compatibility (VrtxAutojoin checks this)
       identifiers: user.email ? [{ type: "email", value: user.email }] : []
     };
+    if (user.name) {
+      payload.name = user.name;
+    }
+    if (user.avatarUrl) {
+      payload.avatarUrl = user.avatarUrl;
+    }
     if (user.adminScopes) {
       payload.adminScopes = user.adminScopes;
       if (user.adminScopes.includes("autojoin")) {
@@ -129,12 +135,54 @@ var Vortex = class {
       path: `/api/v1/invitations/${invitationId}`
     });
   }
-  async acceptInvitations(invitationIds, target) {
+  // Implementation
+  async acceptInvitations(invitationIds, userOrTarget) {
+    if (Array.isArray(userOrTarget)) {
+      console.warn(
+        '[Vortex SDK] DEPRECATED: Passing an array of targets is deprecated. Use the User format instead: acceptInvitations(invitationIds, { email: "user@example.com" })'
+      );
+      let lastResult;
+      for (const target of userOrTarget) {
+        lastResult = await this.acceptInvitations(invitationIds, target);
+      }
+      if (!lastResult) {
+        throw new Error("No targets provided");
+      }
+      return lastResult;
+    }
+    const isLegacyTarget = "type" in userOrTarget && "value" in userOrTarget;
+    if (isLegacyTarget) {
+      console.warn(
+        '[Vortex SDK] DEPRECATED: Passing a target object is deprecated. Use the User format instead: acceptInvitations(invitationIds, { email: "user@example.com" })'
+      );
+      const target = userOrTarget;
+      const user2 = {};
+      if (target.type === "email") {
+        user2.email = target.value;
+      } else if (target.type === "phone" || target.type === "phoneNumber") {
+        user2.phone = target.value;
+      } else {
+        user2.email = target.value;
+      }
+      const response2 = await this.vortexApiRequest({
+        method: "POST",
+        body: {
+          invitationIds,
+          user: user2
+        },
+        path: `/api/v1/invitations/accept`
+      });
+      return response2;
+    }
+    const user = userOrTarget;
+    if (!user.email && !user.phone) {
+      throw new Error("User must have either email or phone");
+    }
     const response = await this.vortexApiRequest({
       method: "POST",
       body: {
         invitationIds,
-        target
+        user
       },
       path: `/api/v1/invitations/accept`
     });
@@ -211,6 +259,54 @@ var Vortex = class {
       body: params
     });
   }
+  /**
+   * Create an invitation from your backend
+   *
+   * This method allows you to create invitations programmatically using your API key,
+   * without requiring a user JWT token. This is useful for server-side invitation
+   * creation, such as "People You May Know" flows or admin-initiated invitations.
+   *
+   * @param params - Invitation parameters
+   * @param params.widgetConfigurationId - The widget configuration ID to use
+   * @param params.target - The target of the invitation (who is being invited)
+   * @param params.target.type - 'email', 'phone', or 'internal'
+   * @param params.target.value - Email address, phone number, or internal user ID
+   * @param params.inviter - Information about the user creating the invitation
+   * @param params.inviter.userId - Your internal user ID for the inviter
+   * @param params.inviter.userEmail - Optional email of the inviter
+   * @param params.inviter.name - Optional display name of the inviter
+   * @param params.groups - Optional groups/scopes to associate with the invitation
+   * @param params.source - Optional source for analytics (defaults to 'api')
+   * @param params.templateVariables - Optional template variables for email customization
+   * @param params.metadata - Optional metadata passed through to webhooks
+   * @returns Created invitation with ID, short link, status, and creation timestamp
+   *
+   * @example
+   * ```typescript
+   * // Create an email invitation
+   * const invitation = await vortex.createInvitation({
+   *   widgetConfigurationId: 'widget-config-123',
+   *   target: { type: 'email', value: 'invitee@example.com' },
+   *   inviter: { userId: 'user-456', userEmail: 'inviter@example.com', name: 'John Doe' },
+   *   groups: [{ type: 'team', groupId: 'team-789', name: 'Engineering' }],
+   * });
+   *
+   * // Create an internal invitation (PYMK flow - no email sent)
+   * const pymkInvitation = await vortex.createInvitation({
+   *   widgetConfigurationId: 'widget-config-123',
+   *   target: { type: 'internal', value: 'internal-user-id-abc' },
+   *   inviter: { userId: 'user-456' },
+   *   source: 'pymk',
+   * });
+   * ```
+   */
+  async createInvitation(params) {
+    return this.vortexApiRequest({
+      method: "POST",
+      path: "/api/v1/invitations",
+      body: params
+    });
+  }
 };
 export {
   Vortex

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/vortex.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport { stringify as uuidStringify } from 'uuid';\nimport {\n  ApiRequestBody,\n  ApiResponseJson,\n  InvitationResult,\n  AcceptInvitationRequest,\n  User,\n  AutojoinDomainsResponse,\n  ConfigureAutojoinRequest,\n} from './types';\n\nexport class Vortex {\n  constructor(private apiKey: string) {}\n\n  /**\n   * Generate a JWT token for a user\n   *\n   * @param params - Object containing user and optional additional properties\n   * @param params.user - User object with id, email, and optional adminScopes\n   * @returns JWT token string\n   *\n   * @example\n   * ```typescript\n   * const token = vortex.generateJwt({\n   *   user: {\n   *     id: \"user-123\",\n   *     email: \"user@example.com\",\n   *     adminScopes: ['autojoin']\n   *   }\n   * });\n   * ```\n   */\n  generateJwt(params: { user: User; [key: string]: any }): string {\n    const { user, ...rest } = params;\n    const [prefix, encodedId, key] = this.apiKey.split('.'); // prefix is just VRTX\n    if (!prefix || !encodedId || !key) {\n      throw new Error('Invalid API key format');\n    }\n    if (prefix !== 'VRTX') {\n      throw new Error('Invalid API key prefix');\n    }\n    const id = uuidStringify(Buffer.from(encodedId, 'base64url'));\n\n    const expires = Math.floor(Date.now() / 1000) + 3600;\n\n    // 🔐 Step 1: Derive signing key from API key + ID\n    const signingKey = crypto.createHmac('sha256', key).update(id).digest(); // <- raw Buffer\n\n    // 🧱 Step 2: Build header + payload\n    const header = {\n      iat: Math.floor(Date.now() / 1000),\n      alg: 'HS256',\n      typ: 'JWT',\n      kid: id,\n    };\n\n    // Build payload with user data\n    const payload: any = {\n      userId: user.id,\n      userEmail: user.email,\n      expires,\n      // Include identifiers array for widget compatibility (VrtxAutojoin checks this)\n      identifiers: user.email ? [{ type: 'email', value: user.email }] : [],\n    };\n\n    // Add adminScopes if present\n    if (user.adminScopes) {\n      payload.adminScopes = user.adminScopes;\n      // Add widget compatibility fields for autojoin admin\n      if (user.adminScopes.includes('autojoin')) {\n        payload.userIsAutojoinAdmin = true;\n        payload.role = 'admin'; // VrtxAutojoin checks parsedJwt.role === 'admin'\n      }\n    }\n\n    // Add any additional properties from rest\n    if (rest && Object.keys(rest).length > 0) {\n      Object.assign(payload, rest);\n    }\n\n    // 🧱 Step 3: Base64URL encode\n    const headerB64 = Buffer.from(JSON.stringify(header)).toString('base64url');\n    const payloadB64 = Buffer.from(JSON.stringify(payload)).toString('base64url');\n\n    // 🧾 Step 4: Sign\n    const toSign = `${headerB64}.${payloadB64}`;\n    const signature = Buffer.from(\n      crypto.createHmac('sha256', signingKey).update(toSign).digest()\n    ).toString('base64url');\n    const jwt = `${toSign}.${signature}`;\n    return jwt;\n  }\n\n  async vortexApiRequest(options: {\n    method: 'GET' | 'POST' | 'PUT' | 'DELETE';\n    path: string;\n    body?: ApiRequestBody;\n    queryParams?: Record<string, string | number | boolean>;\n  }): Promise<ApiResponseJson> {\n    const { method, path, body, queryParams } = options;\n    const url = new URL(\n      `${process.env.VORTEX_API_BASE_URL || 'https://api.vortexsoftware.com'}${path}`\n    );\n    if (queryParams) {\n      Object.entries(queryParams).forEach(([key, value]) => {\n        url.searchParams.append(key, String(value));\n      });\n    }\n    const results = await fetch(url.toString(), {\n      method,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': this.apiKey,\n      },\n      body: body ? JSON.stringify(body) : undefined,\n    });\n    if (!results.ok) {\n      const errorBody = await results.text();\n      throw new Error(\n        `Vortex API request failed: ${results.status} ${results.statusText} - ${errorBody}`\n      );\n    }\n\n    // Check if response has content to parse\n    const contentLength = results.headers.get('content-length');\n    const contentType = results.headers.get('content-type');\n\n    // If no content or content-length is 0, return empty object\n    if (contentLength === '0' || (!contentType?.includes('application/json') && !contentLength)) {\n      return {};\n    }\n\n    // Try to get text first to check if there's actually content\n    const responseText = await results.text();\n    if (!responseText.trim()) {\n      return {};\n    }\n\n    // Parse JSON if there's content\n    try {\n      return JSON.parse(responseText);\n    } catch (error) {\n      // If JSON parsing fails, return the text or empty object\n      return {};\n    }\n  }\n\n  async getInvitationsByTarget(\n    targetType: 'email' | 'username' | 'phoneNumber',\n    targetValue: string\n  ): Promise<InvitationResult[]> {\n    const response = (await this.vortexApiRequest({\n      method: 'GET',\n      path: '/api/v1/invitations',\n      queryParams: {\n        targetType,\n        targetValue,\n      },\n    })) as { invitations: InvitationResult[] };\n    return response.invitations;\n  }\n\n  async getInvitation(invitationId: string): Promise<InvitationResult> {\n    return this.vortexApiRequest({\n      method: 'GET',\n      path: `/api/v1/invitations/${invitationId}`,\n    }) as Promise<InvitationResult>;\n  }\n\n  async revokeInvitation(invitationId: string): Promise<{}> {\n    return this.vortexApiRequest({\n      method: 'DELETE',\n      path: `/api/v1/invitations/${invitationId}`,\n    }) as Promise<{}>;\n  }\n\n  async acceptInvitations(\n    invitationIds: string[],\n    target: { type: 'email' | 'username' | 'phoneNumber'; value: string }\n  ): Promise<InvitationResult> {\n    const response = (await this.vortexApiRequest({\n      method: 'POST',\n      body: {\n        invitationIds,\n        target,\n      } as AcceptInvitationRequest,\n      path: `/api/v1/invitations/accept`,\n    })) as InvitationResult;\n    return response;\n  }\n\n  async deleteInvitationsByGroup(groupType: string, groupId: string): Promise<{}> {\n    return this.vortexApiRequest({\n      method: 'DELETE',\n      path: `/api/v1/invitations/by-group/${groupType}/${groupId}`,\n    }) as Promise<{}>;\n  }\n\n  async getInvitationsByGroup(groupType: string, groupId: string): Promise<InvitationResult[]> {\n    const response = (await this.vortexApiRequest({\n      method: 'GET',\n      path: `/api/v1/invitations/by-group/${groupType}/${groupId}`,\n    })) as { invitations: InvitationResult[] };\n    return response.invitations;\n  }\n\n  async reinvite(invitationId: string): Promise<InvitationResult> {\n    return this.vortexApiRequest({\n      method: 'POST',\n      path: `/api/v1/invitations/${invitationId}/reinvite`,\n    }) as Promise<InvitationResult>;\n  }\n\n  /**\n   * Get autojoin domains configured for a specific scope\n   *\n   * @param scopeType - The type of scope (e.g., \"organization\", \"team\", \"project\")\n   * @param scope - The scope identifier (customer's group ID)\n   * @returns Autojoin domains and associated invitation\n   *\n   * @example\n   * ```typescript\n   * const result = await vortex.getAutojoinDomains('organization', 'acme-org');\n   * console.log(result.autojoinDomains); // [{ id: '...', domain: 'acme.com' }]\n   * ```\n   */\n  async getAutojoinDomains(scopeType: string, scope: string): Promise<AutojoinDomainsResponse> {\n    return this.vortexApiRequest({\n      method: 'GET',\n      path: `/api/v1/invitations/by-scope/${encodeURIComponent(scopeType)}/${encodeURIComponent(scope)}/autojoin`,\n    }) as Promise<AutojoinDomainsResponse>;\n  }\n\n  /**\n   * Configure autojoin domains for a specific scope\n   *\n   * This endpoint syncs autojoin domains - it will add new domains, remove domains\n   * not in the provided list, and deactivate the autojoin invitation if all domains\n   * are removed (empty array).\n   *\n   * @param params - Configuration parameters\n   * @param params.scope - The scope identifier (customer's group ID)\n   * @param params.scopeType - The type of scope (e.g., \"organization\", \"team\")\n   * @param params.scopeName - Optional display name for the scope\n   * @param params.domains - Array of domains to configure for autojoin\n   * @param params.widgetId - The widget configuration ID\n   * @returns Updated autojoin domains and associated invitation\n   *\n   * @example\n   * ```typescript\n   * const result = await vortex.configureAutojoin({\n   *   scope: 'acme-org',\n   *   scopeType: 'organization',\n   *   scopeName: 'Acme Corporation',\n   *   domains: ['acme.com', 'acme.org'],\n   *   widgetId: 'widget-123',\n   * });\n   * ```\n   */\n  async configureAutojoin(params: ConfigureAutojoinRequest): Promise<AutojoinDomainsResponse> {\n    return this.vortexApiRequest({\n      method: 'POST',\n      path: '/api/v1/invitations/autojoin',\n      body: params as unknown as ApiRequestBody,\n    }) as Promise<AutojoinDomainsResponse>;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/vortex.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport { stringify as uuidStringify } from 'uuid';\nimport {\n  ApiRequestBody,\n  ApiResponseJson,\n  InvitationResult,\n  AcceptInvitationRequest,\n  User,\n  AcceptUser,\n  AutojoinDomainsResponse,\n  ConfigureAutojoinRequest,\n  InvitationTarget,\n  CreateInvitationRequest,\n  CreateInvitationResponse,\n} from './types';\n\nexport class Vortex {\n  constructor(private apiKey: string) {}\n\n  /**\n   * Generate a JWT token for a user\n   *\n   * @param params - Object containing user and optional additional properties\n   * @param params.user - User object with id, email, and optional adminScopes\n   * @returns JWT token string\n   *\n   * @example\n   * ```typescript\n   * const token = vortex.generateJwt({\n   *   user: {\n   *     id: \"user-123\",\n   *     email: \"user@example.com\",\n   *     adminScopes: ['autojoin']\n   *   }\n   * });\n   * ```\n   */\n  generateJwt(params: { user: User; [key: string]: any }): string {\n    const { user, ...rest } = params;\n    const [prefix, encodedId, key] = this.apiKey.split('.'); // prefix is just VRTX\n    if (!prefix || !encodedId || !key) {\n      throw new Error('Invalid API key format');\n    }\n    if (prefix !== 'VRTX') {\n      throw new Error('Invalid API key prefix');\n    }\n    const id = uuidStringify(Buffer.from(encodedId, 'base64url'));\n\n    const expires = Math.floor(Date.now() / 1000) + 3600;\n\n    // 🔐 Step 1: Derive signing key from API key + ID\n    const signingKey = crypto.createHmac('sha256', key).update(id).digest(); // <- raw Buffer\n\n    // 🧱 Step 2: Build header + payload\n    const header = {\n      iat: Math.floor(Date.now() / 1000),\n      alg: 'HS256',\n      typ: 'JWT',\n      kid: id,\n    };\n\n    // Build payload with user data\n    const payload: any = {\n      userId: user.id,\n      userEmail: user.email,\n      expires,\n      // Include identifiers array for widget compatibility (VrtxAutojoin checks this)\n      identifiers: user.email ? [{ type: 'email', value: user.email }] : [],\n    };\n\n    // Add name if present\n    if (user.name) {\n      payload.name = user.name;\n    }\n\n    // Add avatarUrl if present\n    if (user.avatarUrl) {\n      payload.avatarUrl = user.avatarUrl;\n    }\n\n    // Add adminScopes if present\n    if (user.adminScopes) {\n      payload.adminScopes = user.adminScopes;\n      // Add widget compatibility fields for autojoin admin\n      if (user.adminScopes.includes('autojoin')) {\n        payload.userIsAutojoinAdmin = true;\n        payload.role = 'admin'; // VrtxAutojoin checks parsedJwt.role === 'admin'\n      }\n    }\n\n    // Add any additional properties from rest\n    if (rest && Object.keys(rest).length > 0) {\n      Object.assign(payload, rest);\n    }\n\n    // 🧱 Step 3: Base64URL encode\n    const headerB64 = Buffer.from(JSON.stringify(header)).toString('base64url');\n    const payloadB64 = Buffer.from(JSON.stringify(payload)).toString('base64url');\n\n    // 🧾 Step 4: Sign\n    const toSign = `${headerB64}.${payloadB64}`;\n    const signature = Buffer.from(\n      crypto.createHmac('sha256', signingKey).update(toSign).digest()\n    ).toString('base64url');\n    const jwt = `${toSign}.${signature}`;\n    return jwt;\n  }\n\n  async vortexApiRequest(options: {\n    method: 'GET' | 'POST' | 'PUT' | 'DELETE';\n    path: string;\n    body?: ApiRequestBody;\n    queryParams?: Record<string, string | number | boolean>;\n  }): Promise<ApiResponseJson> {\n    const { method, path, body, queryParams } = options;\n    const url = new URL(\n      `${process.env.VORTEX_API_BASE_URL || 'https://api.vortexsoftware.com'}${path}`\n    );\n    if (queryParams) {\n      Object.entries(queryParams).forEach(([key, value]) => {\n        url.searchParams.append(key, String(value));\n      });\n    }\n    const results = await fetch(url.toString(), {\n      method,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': this.apiKey,\n      },\n      body: body ? JSON.stringify(body) : undefined,\n    });\n    if (!results.ok) {\n      const errorBody = await results.text();\n      throw new Error(\n        `Vortex API request failed: ${results.status} ${results.statusText} - ${errorBody}`\n      );\n    }\n\n    // Check if response has content to parse\n    const contentLength = results.headers.get('content-length');\n    const contentType = results.headers.get('content-type');\n\n    // If no content or content-length is 0, return empty object\n    if (contentLength === '0' || (!contentType?.includes('application/json') && !contentLength)) {\n      return {};\n    }\n\n    // Try to get text first to check if there's actually content\n    const responseText = await results.text();\n    if (!responseText.trim()) {\n      return {};\n    }\n\n    // Parse JSON if there's content\n    try {\n      return JSON.parse(responseText);\n    } catch (error) {\n      // If JSON parsing fails, return the text or empty object\n      return {};\n    }\n  }\n\n  async getInvitationsByTarget(\n    targetType: 'email' | 'username' | 'phoneNumber',\n    targetValue: string\n  ): Promise<InvitationResult[]> {\n    const response = (await this.vortexApiRequest({\n      method: 'GET',\n      path: '/api/v1/invitations',\n      queryParams: {\n        targetType,\n        targetValue,\n      },\n    })) as { invitations: InvitationResult[] };\n    return response.invitations;\n  }\n\n  async getInvitation(invitationId: string): Promise<InvitationResult> {\n    return this.vortexApiRequest({\n      method: 'GET',\n      path: `/api/v1/invitations/${invitationId}`,\n    }) as Promise<InvitationResult>;\n  }\n\n  async revokeInvitation(invitationId: string): Promise<{}> {\n    return this.vortexApiRequest({\n      method: 'DELETE',\n      path: `/api/v1/invitations/${invitationId}`,\n    }) as Promise<{}>;\n  }\n\n  /**\n   * Accept invitations using the new User format (preferred)\n   * @param invitationIds - Array of invitation IDs to accept\n   * @param user - User object with email or phone (and optional name)\n   * @returns Invitation result\n   * @example\n   * ```typescript\n   * await vortex.acceptInvitations(['inv-123'], { email: 'user@example.com', name: 'John' });\n   * ```\n   */\n  async acceptInvitations(invitationIds: string[], user: AcceptUser): Promise<InvitationResult>;\n\n  /**\n   * Accept invitations using legacy target format (deprecated)\n   * @deprecated Use the User format instead: acceptInvitations(invitationIds, { email: 'user@example.com' })\n   * @param invitationIds - Array of invitation IDs to accept\n   * @param target - Legacy target object with type and value\n   * @returns Invitation result\n   */\n  async acceptInvitations(\n    invitationIds: string[],\n    target: InvitationTarget\n  ): Promise<InvitationResult>;\n\n  /**\n   * Accept invitations using multiple legacy targets (deprecated)\n   * Will call the accept endpoint once per target\n   * @deprecated Use the User format instead: acceptInvitations(invitationIds, { email: 'user@example.com' })\n   * @param invitationIds - Array of invitation IDs to accept\n   * @param targets - Array of legacy target objects\n   * @returns Invitation result from the last acceptance\n   */\n  async acceptInvitations(\n    invitationIds: string[],\n    targets: InvitationTarget[]\n  ): Promise<InvitationResult>;\n\n  // Implementation\n  async acceptInvitations(\n    invitationIds: string[],\n    userOrTarget: AcceptUser | InvitationTarget | InvitationTarget[]\n  ): Promise<InvitationResult> {\n    // Handle array of targets (legacy, call once per target)\n    if (Array.isArray(userOrTarget)) {\n      console.warn(\n        '[Vortex SDK] DEPRECATED: Passing an array of targets is deprecated. Use the User format instead: acceptInvitations(invitationIds, { email: \"user@example.com\" })'\n      );\n      let lastResult: InvitationResult | undefined;\n      for (const target of userOrTarget) {\n        lastResult = await this.acceptInvitations(invitationIds, target);\n      }\n      if (!lastResult) {\n        throw new Error('No targets provided');\n      }\n      return lastResult;\n    }\n\n    // Check if it's a legacy target format (has 'type' and 'value' properties)\n    const isLegacyTarget = 'type' in userOrTarget && 'value' in userOrTarget;\n\n    if (isLegacyTarget) {\n      console.warn(\n        '[Vortex SDK] DEPRECATED: Passing a target object is deprecated. Use the User format instead: acceptInvitations(invitationIds, { email: \"user@example.com\" })'\n      );\n\n      // Convert legacy target to User format\n      const target = userOrTarget as InvitationTarget;\n      const user: AcceptUser = {};\n\n      if (target.type === 'email') {\n        user.email = target.value;\n      } else if (target.type === 'phone' || target.type === 'phoneNumber') {\n        user.phone = target.value;\n      } else {\n        // For other types (like 'username'), try to use as email\n        user.email = target.value;\n      }\n\n      // Make request with User format\n      const response = (await this.vortexApiRequest({\n        method: 'POST',\n        body: {\n          invitationIds,\n          user,\n        } as AcceptInvitationRequest,\n        path: `/api/v1/invitations/accept`,\n      })) as InvitationResult;\n      return response;\n    }\n\n    // New User format\n    const user = userOrTarget as AcceptUser;\n\n    // Validate that either email or phone is provided\n    if (!user.email && !user.phone) {\n      throw new Error('User must have either email or phone');\n    }\n\n    const response = (await this.vortexApiRequest({\n      method: 'POST',\n      body: {\n        invitationIds,\n        user,\n      } as AcceptInvitationRequest,\n      path: `/api/v1/invitations/accept`,\n    })) as InvitationResult;\n    return response;\n  }\n\n  async deleteInvitationsByGroup(groupType: string, groupId: string): Promise<{}> {\n    return this.vortexApiRequest({\n      method: 'DELETE',\n      path: `/api/v1/invitations/by-group/${groupType}/${groupId}`,\n    }) as Promise<{}>;\n  }\n\n  async getInvitationsByGroup(groupType: string, groupId: string): Promise<InvitationResult[]> {\n    const response = (await this.vortexApiRequest({\n      method: 'GET',\n      path: `/api/v1/invitations/by-group/${groupType}/${groupId}`,\n    })) as { invitations: InvitationResult[] };\n    return response.invitations;\n  }\n\n  async reinvite(invitationId: string): Promise<InvitationResult> {\n    return this.vortexApiRequest({\n      method: 'POST',\n      path: `/api/v1/invitations/${invitationId}/reinvite`,\n    }) as Promise<InvitationResult>;\n  }\n\n  /**\n   * Get autojoin domains configured for a specific scope\n   *\n   * @param scopeType - The type of scope (e.g., \"organization\", \"team\", \"project\")\n   * @param scope - The scope identifier (customer's group ID)\n   * @returns Autojoin domains and associated invitation\n   *\n   * @example\n   * ```typescript\n   * const result = await vortex.getAutojoinDomains('organization', 'acme-org');\n   * console.log(result.autojoinDomains); // [{ id: '...', domain: 'acme.com' }]\n   * ```\n   */\n  async getAutojoinDomains(scopeType: string, scope: string): Promise<AutojoinDomainsResponse> {\n    return this.vortexApiRequest({\n      method: 'GET',\n      path: `/api/v1/invitations/by-scope/${encodeURIComponent(scopeType)}/${encodeURIComponent(scope)}/autojoin`,\n    }) as Promise<AutojoinDomainsResponse>;\n  }\n\n  /**\n   * Configure autojoin domains for a specific scope\n   *\n   * This endpoint syncs autojoin domains - it will add new domains, remove domains\n   * not in the provided list, and deactivate the autojoin invitation if all domains\n   * are removed (empty array).\n   *\n   * @param params - Configuration parameters\n   * @param params.scope - The scope identifier (customer's group ID)\n   * @param params.scopeType - The type of scope (e.g., \"organization\", \"team\")\n   * @param params.scopeName - Optional display name for the scope\n   * @param params.domains - Array of domains to configure for autojoin\n   * @param params.widgetId - The widget configuration ID\n   * @returns Updated autojoin domains and associated invitation\n   *\n   * @example\n   * ```typescript\n   * const result = await vortex.configureAutojoin({\n   *   scope: 'acme-org',\n   *   scopeType: 'organization',\n   *   scopeName: 'Acme Corporation',\n   *   domains: ['acme.com', 'acme.org'],\n   *   widgetId: 'widget-123',\n   * });\n   * ```\n   */\n  async configureAutojoin(params: ConfigureAutojoinRequest): Promise<AutojoinDomainsResponse> {\n    return this.vortexApiRequest({\n      method: 'POST',\n      path: '/api/v1/invitations/autojoin',\n      body: params as unknown as ApiRequestBody,\n    }) as Promise<AutojoinDomainsResponse>;\n  }\n\n  /**\n   * Create an invitation from your backend\n   *\n   * This method allows you to create invitations programmatically using your API key,\n   * without requiring a user JWT token. This is useful for server-side invitation\n   * creation, such as \"People You May Know\" flows or admin-initiated invitations.\n   *\n   * @param params - Invitation parameters\n   * @param params.widgetConfigurationId - The widget configuration ID to use\n   * @param params.target - The target of the invitation (who is being invited)\n   * @param params.target.type - 'email', 'phone', or 'internal'\n   * @param params.target.value - Email address, phone number, or internal user ID\n   * @param params.inviter - Information about the user creating the invitation\n   * @param params.inviter.userId - Your internal user ID for the inviter\n   * @param params.inviter.userEmail - Optional email of the inviter\n   * @param params.inviter.name - Optional display name of the inviter\n   * @param params.groups - Optional groups/scopes to associate with the invitation\n   * @param params.source - Optional source for analytics (defaults to 'api')\n   * @param params.templateVariables - Optional template variables for email customization\n   * @param params.metadata - Optional metadata passed through to webhooks\n   * @returns Created invitation with ID, short link, status, and creation timestamp\n   *\n   * @example\n   * ```typescript\n   * // Create an email invitation\n   * const invitation = await vortex.createInvitation({\n   *   widgetConfigurationId: 'widget-config-123',\n   *   target: { type: 'email', value: 'invitee@example.com' },\n   *   inviter: { userId: 'user-456', userEmail: 'inviter@example.com', name: 'John Doe' },\n   *   groups: [{ type: 'team', groupId: 'team-789', name: 'Engineering' }],\n   * });\n   *\n   * // Create an internal invitation (PYMK flow - no email sent)\n   * const pymkInvitation = await vortex.createInvitation({\n   *   widgetConfigurationId: 'widget-config-123',\n   *   target: { type: 'internal', value: 'internal-user-id-abc' },\n   *   inviter: { userId: 'user-456' },\n   *   source: 'pymk',\n   * });\n   * ```\n   */\n  async createInvitation(params: CreateInvitationRequest): Promise<CreateInvitationResponse> {\n    return this.vortexApiRequest({\n      method: 'POST',\n      path: '/api/v1/invitations',\n      body: params as unknown as ApiRequestBody,\n    }) as Promise<CreateInvitationResponse>;\n  }\n}\n"],"mappings":"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","names":["user","response"]}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@teamvortexsoftware/vortex-node-22-sdk",
   "description": "Vortex Node 22 SDK",
   "author": "@teamvortexsoftware",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -36,7 +36,7 @@
     "jest": "29.7.0",
     "ts-jest": "29.4.6",
     "tsup": "8.5.1",
-    "typescript-eslint": "8.50.0"
+    "typescript-eslint": "8.50.1"
   },
   "dependencies": {
     "uuid": "11.1.0"