@teamvortexsoftware/vortex-node-22-sdk 0.0.7 → 0.1.0

package/README.md

@@ -17,7 +17,8 @@ npm install --save @teamvortexsoftware/vortex-node-22-sdk
 
 Once you have the SDK, [login](https://admin.vortexsoftware.com/signin) to Vortex and [create an API Key](https://admin.vortexsoftware.com/members/api-keys). Keep your API key safe! Vortex does not store the API key and it is not retrievable once it has been created. Also, it should be noted that the API key you use is scoped to the environment you're targeting. The environment is implied based on the API key used to sign JWTs and to make API requests.
 
-Your API key is used to 
+Your API key is used to
+
 - Sign JWTs for use with the Vortex Widget
 - Make API calls against the [Vortex API](https://api.vortexsoftware.com/api)
 
@@ -27,6 +28,53 @@ Let's assume you have an express powered API and a user that is looking to invit
 
 You could populate the JWT in some set of initial data that your application already provides (recommended) or you could create an endpoint specifically to fetch the JWT on demand for use with the widget. For the purposes of this example, we'll create an endpoint to fetch the JWT.
 
+#### Current Format (Recommended)
+
+```ts
+const express = require('express');
+const app = express();
+const port = 3000;
+
+// Provide your API key however you see fit.
+const vortex = new Vortex(process.env.VORTEX_API_KEY);
+
+app.get('/vortex-jwt', (req, res) => {
+  res.setHeader('Content-Type', 'application/json');
+
+  const token = vortex.generateJwt({
+    user: {
+      id: 'user-123',
+      email: 'user@example.com',
+      adminScopes: ['autojoin'], // Optional: grants admin privileges for autojoining
+    },
+  });
+
+  res.end(JSON.stringify({ jwt: token }));
+});
+
+app.listen(port, () => {
+  console.log(`Example app listening on port ${port}. Fetch example JWT by hitting /vortex-jwt`);
+});
+```
+
+You can also add extra properties to the JWT payload:
+
+```ts
+const token = vortex.generateJwt({
+  user: {
+    id: 'user-123',
+    email: 'user@example.com',
+    adminScopes: ['autojoin'],
+  },
+  role: 'admin',
+  department: 'Engineering',
+});
+```
+
+#### Legacy Format (Deprecated)
+
+The legacy format is still supported for backward compatibility but is deprecated. New integrations should use the simplified format above.
+
 ```ts
 const express = require('express');
 const app = express();
@@ -39,14 +87,18 @@ 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: 'sms', 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
 const groups = [
-  { type: 'workspace', groupId: 'some-workspace-id', name: 'The greatest workspace...pause...in the world' },
-  { type: 'document', groupId: 'some-document-id', name: 'Ricky\'s grade 10 word papers' },
-  { type: 'document', groupId: 'another-document-id', name: 'Sunnyvale bylaws' }
+  {
+    type: 'workspace',
+    groupId: 'some-workspace-id',
+    name: 'The greatest workspace...pause...in the world',
+  },
+  { type: 'document', groupId: 'some-document-id', name: "Ricky's grade 10 word papers" },
+  { type: 'document', groupId: 'another-document-id', name: 'Sunnyvale bylaws' },
 ];
 
 // If your product has the concept of user roles (admin, guest, member, etc), provide it here
@@ -57,17 +109,21 @@ const vortex = new Vortex(process.env.VORTEX_API_KEY);
 
 app.get('/vortex-jwt', (req, res) => {
   res.setHeader('Content-Type', 'application/json');
-  res.end(JSON.stringify({ jwt: vortex.generateJwt({
-    userId,
-    identifiers,
-    groups,
-    role
-  })}));
-})
+  res.end(
+    JSON.stringify({
+      jwt: vortex.generateJwt({
+        userId,
+        identifiers,
+        groups,
+        role,
+      }),
+    })
+  );
+});
 
 app.listen(port, () => {
-  console.log(`Example app listening on port ${port}. Fetch example JWT by hitting /vortex-jwt`)
-})
+  console.log(`Example app listening on port ${port}. Fetch example JWT by hitting /vortex-jwt`);
+});
 ```
 
 Now, you can utilize that JWT endpoint in conjuction with the Vortex widget
@@ -75,7 +131,7 @@ Now, you can utilize that JWT endpoint in conjuction with the Vortex widget
 Here's an example hook:
 
 ```ts
-import { useEffect, useState } from "react";
+import { useEffect, useState } from 'react';
 
 export function useVortexJwt() {
   const [data, setData] = useState<any>(null);
@@ -87,7 +143,7 @@ export function useVortexJwt() {
 
     async function fetchJwt() {
       try {
-        const res = await fetch("/vortex-jwt");
+        const res = await fetch('/vortex-jwt');
         if (!res.ok) throw new Error(`HTTP ${res.status}`);
         const json = await res.json();
         if (!cancelled) setData(json);
@@ -132,6 +188,7 @@ function InviteWrapperComponent() {
   />);
 }
 ```
+
 ### Fetch an invitation by ID
 
 When a shared invitation link or an invitaion link sent via email is clicked, the user who clicks it is redirected to the landing page you set in the widget configurator. For instance, if you set http://localhost:3000/invite/landing as the landing page and the invitation being clicked has an id of deadbeef-dead-4bad-8dad-c001d00dc0de, the user who clicks the invitation link will land on http://localhost:3000/invite/landing?invitationId=deadbeef-dead-4bad-8dad-c001d00dc0de
@@ -157,8 +214,9 @@ app.get('/invite/landing', async (req, res) => {
   // For the sake of simplicity, we'll simply return the raw JSON
   res.setHeader('Content-Type', 'application/json');
   res.end(JSON.stringify(invitation));
-})
+});
 ```
+
 ### 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.
@@ -182,8 +240,9 @@ app.get('/invitations/by-email', async (req, res) => {
   // For the sake of simplicity, we'll simply return the raw JSON
   res.setHeader('Content-Type', 'application/json');
   res.end(JSON.stringify(invitations));
-})
+});
 ```
+
 ### Accept invitations
 
 This is how you'd accept one or more invitations with the SDK. You want this as part of your signup flow more than likely. When someone clicks on an invitation link, we redirect to the landing page you specified in the widget configuration. Ultimately, the user will sign up with your service and that is when you create the relationship between the newly created user in your system and whatever grouping defined in the invitation itself.
@@ -199,12 +258,12 @@ app.post('/signup', async (req, res) => {
   }
 
   // YOUR signup logic, whatever it may be
-  await myApp.doSignupLogic(email); 
+  await myApp.doSignupLogic(email);
 
   // you may want to do this even if the user is signing up without clicking an invitaiton link
   const invitations = await vortex.getInvitationsByTarget('email', email);
 
-  // Assume that your application may pass the original invitationId from the 
+  // Assume that your application may pass the original invitationId from the
   // landing page registered with the configured widget
   const invitationId = req.body.invitationId;
 
@@ -213,16 +272,17 @@ app.post('/signup', async (req, res) => {
     uniqueInvitationIds.push(invitationId);
   }
 
-  const acceptedInvitations = await vortex.acceptInvitations(
-    uniqueInvitationIds,
-    { type: 'email', value: email }
-  );
-  
+  const acceptedInvitations = await vortex.acceptInvitations(uniqueInvitationIds, {
+    type: 'email',
+    value: email,
+  });
+
   // continue with post-signup activity. perhaps redirect to your logged in landing page
 
   res.redirect(302, '/app');
-})
+});
 ```
+
 ### Fetch invitations by group
 
 Perhaps you want to allow your users to see all outstanding invitations for a group that they are a member of. Or perhaps you want this exclusively for admins of the group. However you choose to do it, this SDK feature will allow you to fetch all outstanding invitations for a group.
@@ -239,8 +299,9 @@ app.get('/invitations/by-group', async (req, res) => {
 
   res.setHeader('Content-Type', 'application/json');
   res.end(JSON.stringify(invitations));
-})
+});
 ```
+
 ### Reinvite
 
 You may want to allow your users to resend an existing invitation. Allowing for this will increase the conversion chances of a stale invitation. Perhaps you display a list of outstanding invites and allow for a reinvite based on that list.
@@ -257,8 +318,9 @@ app.post('/invitations/reinvite', async (req, res) => {
 
   res.setHeader('Content-Type', 'application/json');
   res.end(JSON.stringify(invitation));
-})
+});
 ```
+
 ### Revoke invitation
 
 In addition to reinvite, you may want to present your users (or perhaps just admins) with the ability to revoke outstanding invitations.
@@ -275,13 +337,15 @@ app.post('/invitations/revoke', async (req, res) => {
 
   res.setHeader('Content-Type', 'application/json');
   res.end(JSON.stringify({}));
-})
+});
 ```
+
 ### Delete invitations by group
 
 Your product may allow for your users to delete the underlying resource that is tied to one or more invitations. For instance, say your product has the concept of a 'workspace' and your invitations are created specifying a particular workspace associated with each invitation. Then, at some point in the future, the admin of the workspace decides to delete it. This means all invitations associated with that workspace are now invalid and need to be removed so that reminders don't go out for any outstanding invite to the now deleted workspace.
 
 Here is how to clean them up when the workspace is deleted.
+
 ```ts
 app.delete('/workspace/:workspaceId', async (req, res) => {
   const { workspaceId } = req.params;
@@ -294,5 +358,5 @@ app.delete('/workspace/:workspaceId', async (req, res) => {
 
   res.setHeader('Content-Type', 'application/json');
   res.end(JSON.stringify({}));
-})
-```
+});
+```

package/dist/index.d.mts

@@ -51,6 +51,8 @@ type InvitationResult = {
     projectId: string;
     groups: InvitationGroup[];
     accepts: InvitationAcceptance[];
+    expired: boolean;
+    expires?: string;
 };
 type AcceptInvitationRequest = {
     invitationIds: string[];
@@ -60,19 +62,65 @@ type ApiResponseJson = InvitationResult | {
     invitations: InvitationResult[];
 } | {};
 type ApiRequestBody = AcceptInvitationRequest | null;
+/**
+ * User type for JWT generation
+ */
+type User = {
+    id: string;
+    email: string;
+    adminScopes?: string[];
+    [key: string]: any;
+};
+/**
+ * Autojoin domain configuration
+ */
+type AutojoinDomain = {
+    id: string;
+    domain: string;
+};
+/**
+ * Response from autojoin API endpoints
+ */
+type AutojoinDomainsResponse = {
+    autojoinDomains: AutojoinDomain[];
+    invitation: InvitationResult | null;
+};
+/**
+ * Request body for configuring autojoin domains
+ */
+type ConfigureAutojoinRequest = {
+    scope: string;
+    scopeType: string;
+    scopeName?: string;
+    domains: string[];
+    widgetId: string;
+    metadata?: Record<string, any>;
+};
 
 declare class Vortex {
     private apiKey;
     constructor(apiKey: string);
-    generateJwt({ userId, identifiers, groups, role, attributes, }: {
-        userId: string;
-        identifiers: {
-            type: 'email' | 'sms';
-            value: string;
-        }[];
-        groups: GroupInput[];
-        role?: string;
-        attributes?: Record<string, any>;
+    /**
+     * Generate a JWT token for a user
+     *
+     * @param params - Object containing user and optional additional properties
+     * @param params.user - User object with id, email, and optional adminScopes
+     * @returns JWT token string
+     *
+     * @example
+     * ```typescript
+     * const token = vortex.generateJwt({
+     *   user: {
+     *     id: "user-123",
+     *     email: "user@example.com",
+     *     adminScopes: ['autojoin']
+     *   }
+     * });
+     * ```
+     */
+    generateJwt(params: {
+        user: User;
+        [key: string]: any;
     }): string;
     vortexApiRequest(options: {
         method: 'GET' | 'POST' | 'PUT' | 'DELETE';
@@ -90,6 +138,47 @@ declare class Vortex {
     deleteInvitationsByGroup(groupType: string, groupId: string): Promise<{}>;
     getInvitationsByGroup(groupType: string, groupId: string): Promise<InvitationResult[]>;
     reinvite(invitationId: string): Promise<InvitationResult>;
+    /**
+     * Get autojoin domains configured for a specific scope
+     *
+     * @param scopeType - The type of scope (e.g., "organization", "team", "project")
+     * @param scope - The scope identifier (customer's group ID)
+     * @returns Autojoin domains and associated invitation
+     *
+     * @example
+     * ```typescript
+     * const result = await vortex.getAutojoinDomains('organization', 'acme-org');
+     * console.log(result.autojoinDomains); // [{ id: '...', domain: 'acme.com' }]
+     * ```
+     */
+    getAutojoinDomains(scopeType: string, scope: string): Promise<AutojoinDomainsResponse>;
+    /**
+     * Configure autojoin domains for a specific scope
+     *
+     * This endpoint syncs autojoin domains - it will add new domains, remove domains
+     * not in the provided list, and deactivate the autojoin invitation if all domains
+     * are removed (empty array).
+     *
+     * @param params - Configuration parameters
+     * @param params.scope - The scope identifier (customer's group ID)
+     * @param params.scopeType - The type of scope (e.g., "organization", "team")
+     * @param params.scopeName - Optional display name for the scope
+     * @param params.domains - Array of domains to configure for autojoin
+     * @param params.widgetId - The widget configuration ID
+     * @returns Updated autojoin domains and associated invitation
+     *
+     * @example
+     * ```typescript
+     * const result = await vortex.configureAutojoin({
+     *   scope: 'acme-org',
+     *   scopeType: 'organization',
+     *   scopeName: 'Acme Corporation',
+     *   domains: ['acme.com', 'acme.org'],
+     *   widgetId: 'widget-123',
+     * });
+     * ```
+     */
+    configureAutojoin(params: ConfigureAutojoinRequest): Promise<AutojoinDomainsResponse>;
 }
 
-export { type AcceptInvitationRequest, type ApiRequestBody, type ApiResponseJson, type GroupInput, type InvitationAcceptance, type InvitationGroup, type InvitationResult, type InvitationTarget, Vortex };
+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 };

package/dist/index.d.ts

@@ -51,6 +51,8 @@ type InvitationResult = {
     projectId: string;
     groups: InvitationGroup[];
     accepts: InvitationAcceptance[];
+    expired: boolean;
+    expires?: string;
 };
 type AcceptInvitationRequest = {
     invitationIds: string[];
@@ -60,19 +62,65 @@ type ApiResponseJson = InvitationResult | {
     invitations: InvitationResult[];
 } | {};
 type ApiRequestBody = AcceptInvitationRequest | null;
+/**
+ * User type for JWT generation
+ */
+type User = {
+    id: string;
+    email: string;
+    adminScopes?: string[];
+    [key: string]: any;
+};
+/**
+ * Autojoin domain configuration
+ */
+type AutojoinDomain = {
+    id: string;
+    domain: string;
+};
+/**
+ * Response from autojoin API endpoints
+ */
+type AutojoinDomainsResponse = {
+    autojoinDomains: AutojoinDomain[];
+    invitation: InvitationResult | null;
+};
+/**
+ * Request body for configuring autojoin domains
+ */
+type ConfigureAutojoinRequest = {
+    scope: string;
+    scopeType: string;
+    scopeName?: string;
+    domains: string[];
+    widgetId: string;
+    metadata?: Record<string, any>;
+};
 
 declare class Vortex {
     private apiKey;
     constructor(apiKey: string);
-    generateJwt({ userId, identifiers, groups, role, attributes, }: {
-        userId: string;
-        identifiers: {
-            type: 'email' | 'sms';
-            value: string;
-        }[];
-        groups: GroupInput[];
-        role?: string;
-        attributes?: Record<string, any>;
+    /**
+     * Generate a JWT token for a user
+     *
+     * @param params - Object containing user and optional additional properties
+     * @param params.user - User object with id, email, and optional adminScopes
+     * @returns JWT token string
+     *
+     * @example
+     * ```typescript
+     * const token = vortex.generateJwt({
+     *   user: {
+     *     id: "user-123",
+     *     email: "user@example.com",
+     *     adminScopes: ['autojoin']
+     *   }
+     * });
+     * ```
+     */
+    generateJwt(params: {
+        user: User;
+        [key: string]: any;
     }): string;
     vortexApiRequest(options: {
         method: 'GET' | 'POST' | 'PUT' | 'DELETE';
@@ -90,6 +138,47 @@ declare class Vortex {
     deleteInvitationsByGroup(groupType: string, groupId: string): Promise<{}>;
     getInvitationsByGroup(groupType: string, groupId: string): Promise<InvitationResult[]>;
     reinvite(invitationId: string): Promise<InvitationResult>;
+    /**
+     * Get autojoin domains configured for a specific scope
+     *
+     * @param scopeType - The type of scope (e.g., "organization", "team", "project")
+     * @param scope - The scope identifier (customer's group ID)
+     * @returns Autojoin domains and associated invitation
+     *
+     * @example
+     * ```typescript
+     * const result = await vortex.getAutojoinDomains('organization', 'acme-org');
+     * console.log(result.autojoinDomains); // [{ id: '...', domain: 'acme.com' }]
+     * ```
+     */
+    getAutojoinDomains(scopeType: string, scope: string): Promise<AutojoinDomainsResponse>;
+    /**
+     * Configure autojoin domains for a specific scope
+     *
+     * This endpoint syncs autojoin domains - it will add new domains, remove domains
+     * not in the provided list, and deactivate the autojoin invitation if all domains
+     * are removed (empty array).
+     *
+     * @param params - Configuration parameters
+     * @param params.scope - The scope identifier (customer's group ID)
+     * @param params.scopeType - The type of scope (e.g., "organization", "team")
+     * @param params.scopeName - Optional display name for the scope
+     * @param params.domains - Array of domains to configure for autojoin
+     * @param params.widgetId - The widget configuration ID
+     * @returns Updated autojoin domains and associated invitation
+     *
+     * @example
+     * ```typescript
+     * const result = await vortex.configureAutojoin({
+     *   scope: 'acme-org',
+     *   scopeType: 'organization',
+     *   scopeName: 'Acme Corporation',
+     *   domains: ['acme.com', 'acme.org'],
+     *   widgetId: 'widget-123',
+     * });
+     * ```
+     */
+    configureAutojoin(params: ConfigureAutojoinRequest): Promise<AutojoinDomainsResponse>;
 }
 
-export { type AcceptInvitationRequest, type ApiRequestBody, type ApiResponseJson, type GroupInput, type InvitationAcceptance, type InvitationGroup, type InvitationResult, type InvitationTarget, Vortex };
+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 };

package/dist/index.js

@@ -41,13 +41,26 @@ var Vortex = class {
   constructor(apiKey) {
     this.apiKey = apiKey;
   }
-  generateJwt({
-    userId,
-    identifiers,
-    groups,
-    role,
-    attributes
-  }) {
+  /**
+   * Generate a JWT token for a user
+   *
+   * @param params - Object containing user and optional additional properties
+   * @param params.user - User object with id, email, and optional adminScopes
+   * @returns JWT token string
+   *
+   * @example
+   * ```typescript
+   * const token = vortex.generateJwt({
+   *   user: {
+   *     id: "user-123",
+   *     email: "user@example.com",
+   *     adminScopes: ['autojoin']
+   *   }
+   * });
+   * ```
+   */
+  generateJwt(params) {
+    const { user, ...rest } = params;
     const [prefix, encodedId, key] = this.apiKey.split(".");
     if (!prefix || !encodedId || !key) {
       throw new Error("Invalid API key format");
@@ -65,13 +78,22 @@ var Vortex = class {
       kid: id
     };
     const payload = {
-      userId,
-      groups,
-      role,
+      userId: user.id,
+      userEmail: user.email,
       expires,
-      identifiers,
-      ...attributes && Object.keys(attributes).length > 0 ? { attributes } : {}
+      // Include identifiers array for widget compatibility (VrtxAutojoin checks this)
+      identifiers: user.email ? [{ type: "email", value: user.email }] : []
     };
+    if (user.adminScopes) {
+      payload.adminScopes = user.adminScopes;
+      if (user.adminScopes.includes("autojoin")) {
+        payload.userIsAutojoinAdmin = true;
+        payload.role = "admin";
+      }
+    }
+    if (rest && Object.keys(rest).length > 0) {
+      Object.assign(payload, rest);
+    }
     const headerB64 = Buffer.from(JSON.stringify(header)).toString("base64url");
     const payloadB64 = Buffer.from(JSON.stringify(payload)).toString("base64url");
     const toSign = `${headerB64}.${payloadB64}`;
@@ -83,7 +105,9 @@ var Vortex = class {
   }
   async vortexApiRequest(options) {
     const { method, path, body, queryParams } = options;
-    const url = new URL(`${process.env.VORTEX_API_BASE_URL || "https://api.vortexsoftware.com"}${path}`);
+    const url = new URL(
+      `${process.env.VORTEX_API_BASE_URL || "https://api.vortexsoftware.com"}${path}`
+    );
     if (queryParams) {
       Object.entries(queryParams).forEach(([key, value]) => {
         url.searchParams.append(key, String(value));
@@ -99,11 +123,13 @@ var Vortex = class {
     });
     if (!results.ok) {
       const errorBody = await results.text();
-      throw new Error(`Vortex API request failed: ${results.status} ${results.statusText} - ${errorBody}`);
+      throw new Error(
+        `Vortex API request failed: ${results.status} ${results.statusText} - ${errorBody}`
+      );
     }
     const contentLength = results.headers.get("content-length");
     const contentType = results.headers.get("content-type");
-    if (contentLength === "0" || !(contentType == null ? void 0 : contentType.includes("application/json")) && !contentLength) {
+    if (contentLength === "0" || !contentType?.includes("application/json") && !contentLength) {
       return {};
     }
     const responseText = await results.text();
@@ -119,7 +145,7 @@ var Vortex = class {
   async getInvitationsByTarget(targetType, targetValue) {
     const response = await this.vortexApiRequest({
       method: "GET",
-      path: "/api/v1/invitations?targetType",
+      path: "/api/v1/invitations",
       queryParams: {
         targetType,
         targetValue
@@ -169,6 +195,58 @@ var Vortex = class {
       path: `/api/v1/invitations/${invitationId}/reinvite`
     });
   }
+  /**
+   * Get autojoin domains configured for a specific scope
+   *
+   * @param scopeType - The type of scope (e.g., "organization", "team", "project")
+   * @param scope - The scope identifier (customer's group ID)
+   * @returns Autojoin domains and associated invitation
+   *
+   * @example
+   * ```typescript
+   * const result = await vortex.getAutojoinDomains('organization', 'acme-org');
+   * console.log(result.autojoinDomains); // [{ id: '...', domain: 'acme.com' }]
+   * ```
+   */
+  async getAutojoinDomains(scopeType, scope) {
+    return this.vortexApiRequest({
+      method: "GET",
+      path: `/api/v1/invitations/by-scope/${encodeURIComponent(scopeType)}/${encodeURIComponent(scope)}/autojoin`
+    });
+  }
+  /**
+   * Configure autojoin domains for a specific scope
+   *
+   * This endpoint syncs autojoin domains - it will add new domains, remove domains
+   * not in the provided list, and deactivate the autojoin invitation if all domains
+   * are removed (empty array).
+   *
+   * @param params - Configuration parameters
+   * @param params.scope - The scope identifier (customer's group ID)
+   * @param params.scopeType - The type of scope (e.g., "organization", "team")
+   * @param params.scopeName - Optional display name for the scope
+   * @param params.domains - Array of domains to configure for autojoin
+   * @param params.widgetId - The widget configuration ID
+   * @returns Updated autojoin domains and associated invitation
+   *
+   * @example
+   * ```typescript
+   * const result = await vortex.configureAutojoin({
+   *   scope: 'acme-org',
+   *   scopeType: 'organization',
+   *   scopeName: 'Acme Corporation',
+   *   domains: ['acme.com', 'acme.org'],
+   *   widgetId: 'widget-123',
+   * });
+   * ```
+   */
+  async configureAutojoin(params) {
+    return this.vortexApiRequest({
+      method: "POST",
+      path: "/api/v1/invitations/autojoin",
+      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 { ApiRequestBody, ApiResponseJson, InvitationResult, AcceptInvitationRequest, GroupInput } from './types';\n\nexport class Vortex {\n  constructor(private apiKey: string) { }\n\n  generateJwt({\n    userId,\n    identifiers,\n    groups,\n    role,\n    attributes,\n  }: {\n    userId: string;\n    identifiers: { type: 'email' | 'sms'; value: string }[];\n    groups: GroupInput[];\n    role?: string;\n    attributes?: Record<string, any>;\n  }): string {\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    const payload = {\n      userId,\n      groups,\n      role,\n      expires,\n      identifiers,\n      ...(attributes && Object.keys(attributes).length > 0 ? { attributes } : {}),\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(`${process.env.VORTEX_API_BASE_URL || 'https://api.vortexsoftware.com'}${path}`);\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(`Vortex API request failed: ${results.status} ${results.statusText} - ${errorBody}`);\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(targetType: 'email' | 'username' | 'phoneNumber', targetValue: string): Promise<InvitationResult[]> {\n    const response = await this.vortexApiRequest({\n      method: 'GET',\n      path: '/api/v1/invitations?targetType',\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}"],"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  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"]}

package/dist/index.mjs

@@ -5,13 +5,26 @@ var Vortex = class {
   constructor(apiKey) {
     this.apiKey = apiKey;
   }
-  generateJwt({
-    userId,
-    identifiers,
-    groups,
-    role,
-    attributes
-  }) {
+  /**
+   * Generate a JWT token for a user
+   *
+   * @param params - Object containing user and optional additional properties
+   * @param params.user - User object with id, email, and optional adminScopes
+   * @returns JWT token string
+   *
+   * @example
+   * ```typescript
+   * const token = vortex.generateJwt({
+   *   user: {
+   *     id: "user-123",
+   *     email: "user@example.com",
+   *     adminScopes: ['autojoin']
+   *   }
+   * });
+   * ```
+   */
+  generateJwt(params) {
+    const { user, ...rest } = params;
     const [prefix, encodedId, key] = this.apiKey.split(".");
     if (!prefix || !encodedId || !key) {
       throw new Error("Invalid API key format");
@@ -29,13 +42,22 @@ var Vortex = class {
       kid: id
     };
     const payload = {
-      userId,
-      groups,
-      role,
+      userId: user.id,
+      userEmail: user.email,
       expires,
-      identifiers,
-      ...attributes && Object.keys(attributes).length > 0 ? { attributes } : {}
+      // Include identifiers array for widget compatibility (VrtxAutojoin checks this)
+      identifiers: user.email ? [{ type: "email", value: user.email }] : []
     };
+    if (user.adminScopes) {
+      payload.adminScopes = user.adminScopes;
+      if (user.adminScopes.includes("autojoin")) {
+        payload.userIsAutojoinAdmin = true;
+        payload.role = "admin";
+      }
+    }
+    if (rest && Object.keys(rest).length > 0) {
+      Object.assign(payload, rest);
+    }
     const headerB64 = Buffer.from(JSON.stringify(header)).toString("base64url");
     const payloadB64 = Buffer.from(JSON.stringify(payload)).toString("base64url");
     const toSign = `${headerB64}.${payloadB64}`;
@@ -47,7 +69,9 @@ var Vortex = class {
   }
   async vortexApiRequest(options) {
     const { method, path, body, queryParams } = options;
-    const url = new URL(`${process.env.VORTEX_API_BASE_URL || "https://api.vortexsoftware.com"}${path}`);
+    const url = new URL(
+      `${process.env.VORTEX_API_BASE_URL || "https://api.vortexsoftware.com"}${path}`
+    );
     if (queryParams) {
       Object.entries(queryParams).forEach(([key, value]) => {
         url.searchParams.append(key, String(value));
@@ -63,11 +87,13 @@ var Vortex = class {
     });
     if (!results.ok) {
       const errorBody = await results.text();
-      throw new Error(`Vortex API request failed: ${results.status} ${results.statusText} - ${errorBody}`);
+      throw new Error(
+        `Vortex API request failed: ${results.status} ${results.statusText} - ${errorBody}`
+      );
     }
     const contentLength = results.headers.get("content-length");
     const contentType = results.headers.get("content-type");
-    if (contentLength === "0" || !(contentType == null ? void 0 : contentType.includes("application/json")) && !contentLength) {
+    if (contentLength === "0" || !contentType?.includes("application/json") && !contentLength) {
       return {};
     }
     const responseText = await results.text();
@@ -83,7 +109,7 @@ var Vortex = class {
   async getInvitationsByTarget(targetType, targetValue) {
     const response = await this.vortexApiRequest({
       method: "GET",
-      path: "/api/v1/invitations?targetType",
+      path: "/api/v1/invitations",
       queryParams: {
         targetType,
         targetValue
@@ -133,6 +159,58 @@ var Vortex = class {
       path: `/api/v1/invitations/${invitationId}/reinvite`
     });
   }
+  /**
+   * Get autojoin domains configured for a specific scope
+   *
+   * @param scopeType - The type of scope (e.g., "organization", "team", "project")
+   * @param scope - The scope identifier (customer's group ID)
+   * @returns Autojoin domains and associated invitation
+   *
+   * @example
+   * ```typescript
+   * const result = await vortex.getAutojoinDomains('organization', 'acme-org');
+   * console.log(result.autojoinDomains); // [{ id: '...', domain: 'acme.com' }]
+   * ```
+   */
+  async getAutojoinDomains(scopeType, scope) {
+    return this.vortexApiRequest({
+      method: "GET",
+      path: `/api/v1/invitations/by-scope/${encodeURIComponent(scopeType)}/${encodeURIComponent(scope)}/autojoin`
+    });
+  }
+  /**
+   * Configure autojoin domains for a specific scope
+   *
+   * This endpoint syncs autojoin domains - it will add new domains, remove domains
+   * not in the provided list, and deactivate the autojoin invitation if all domains
+   * are removed (empty array).
+   *
+   * @param params - Configuration parameters
+   * @param params.scope - The scope identifier (customer's group ID)
+   * @param params.scopeType - The type of scope (e.g., "organization", "team")
+   * @param params.scopeName - Optional display name for the scope
+   * @param params.domains - Array of domains to configure for autojoin
+   * @param params.widgetId - The widget configuration ID
+   * @returns Updated autojoin domains and associated invitation
+   *
+   * @example
+   * ```typescript
+   * const result = await vortex.configureAutojoin({
+   *   scope: 'acme-org',
+   *   scopeType: 'organization',
+   *   scopeName: 'Acme Corporation',
+   *   domains: ['acme.com', 'acme.org'],
+   *   widgetId: 'widget-123',
+   * });
+   * ```
+   */
+  async configureAutojoin(params) {
+    return this.vortexApiRequest({
+      method: "POST",
+      path: "/api/v1/invitations/autojoin",
+      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 { ApiRequestBody, ApiResponseJson, InvitationResult, AcceptInvitationRequest, GroupInput } from './types';\n\nexport class Vortex {\n  constructor(private apiKey: string) { }\n\n  generateJwt({\n    userId,\n    identifiers,\n    groups,\n    role,\n    attributes,\n  }: {\n    userId: string;\n    identifiers: { type: 'email' | 'sms'; value: string }[];\n    groups: GroupInput[];\n    role?: string;\n    attributes?: Record<string, any>;\n  }): string {\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    const payload = {\n      userId,\n      groups,\n      role,\n      expires,\n      identifiers,\n      ...(attributes && Object.keys(attributes).length > 0 ? { attributes } : {}),\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(`${process.env.VORTEX_API_BASE_URL || 'https://api.vortexsoftware.com'}${path}`);\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(`Vortex API request failed: ${results.status} ${results.statusText} - ${errorBody}`);\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(targetType: 'email' | 'username' | 'phoneNumber', targetValue: string): Promise<InvitationResult[]> {\n    const response = await this.vortexApiRequest({\n      method: 'GET',\n      path: '/api/v1/invitations?targetType',\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}"],"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  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":[]}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@teamvortexsoftware/vortex-node-22-sdk",
   "description": "Vortex Node 22 SDK",
   "author": "@teamvortexsoftware",
-  "version": "0.0.7",
+  "version": "0.1.0",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -19,14 +19,14 @@
   "scripts": {
     "build:stg": "pnpm run distclean && pnpm run build && mkdir -p dist.d/stg && mv dist dist.d/stg && echo && echo 'Build in ./dist.d/stg'",
     "prepublish:stg": "cp ./LICENSE ./README.md ./dist.d/stg/ && jq '.name = \"@teamvortexsoftware/vortex-node-22-sdk-stg\" | .description = \"Vortex Node 22 SDK (STG)\" | del(.scripts.prepack)' ./package.json > ./dist.d/stg/package.json",
-    "publish:stg": "pnpm run prepublish:stg && npm publish  --userconfig ../../.npmrc --access restricted ./dist.d/stg",
+    "publish:stg": "pnpm run prepublish:stg && pnpm publish --access restricted ./dist.d/stg",
     "build:prod": "pnpm run distclean && pnpm run build && mkdir -p dist.d/prod && mv dist dist.d/prod && echo && echo 'Build in ./dist.d/prod'",
     "prepublish:prod": "cp ./LICENSE ./README.md ./dist.d/prod/ && jq 'del(.scripts.prepack)' ./package.json > ./dist.d/prod/package.json",
-    "publish:prod": "pnpm run prepublish:prod && npm publish  --userconfig ../../.npmrc --access public ./dist.d/prod",
+    "publish:prod": "pnpm run prepublish:prod && pnpm publish --access public ./dist.d/prod",
     "check-types": "tsc --noEmit",
     "distclean": "rm -rf ./dist ./dist.d",
     "clean": "rm -rf ./dist",
-    "dev": "",
+    "dev": "tsup --watch",
     "test": "jest",
     "package": "pnpm run build && cd dist/vortex-node-22-sdk && npm pack",
     "build": "tsup"
@@ -44,16 +44,18 @@
     "testEnvironment": "node"
   },
   "devDependencies": {
-    "@eslint/js": "^9.24.0",
+    "@eslint/js": "catalog:",
     "@jest/globals": "29.7.0",
     "@teamvortexsoftware/eslint-config": "workspace:*",
     "@teamvortexsoftware/typescript-config": "workspace:*",
-    "eslint": "^9.24.0",
+    "@types/node": "catalog:",
+    "eslint": "catalog:",
     "jest": "29.7.0",
-    "tsup": "^8.5.0",
-    "typescript-eslint": "^8.30.1"
+    "ts-jest": "catalog:",
+    "tsup": "catalog:",
+    "typescript-eslint": "catalog:"
   },
   "dependencies": {
-    "uuid": "^13.0.0"
+    "uuid": "catalog:"
   }
 }