@workos-inc/node 7.36.1 → 7.37.0

package/lib/actions/actions.spec.js

@@ -106,6 +106,7 @@ describe('Actions', () => {
                 },
                 ipAddress: '50.141.123.10',
                 userAgent: 'Mozilla/5.0',
+                deviceFingerprint: 'notafingerprint',
                 issuer: 'test',
                 object: 'authentication_action_context',
                 organization: {
@@ -150,6 +151,7 @@ describe('Actions', () => {
                 },
                 ipAddress: '50.141.123.10',
                 userAgent: 'Mozilla/5.0',
+                deviceFingerprint: 'notafingerprint',
                 invitation: expect.objectContaining({
                     object: 'invitation',
                     id: '01JBVZWH8HJ855YZ5BWHG1WNZN',

package/lib/actions/fixtures/authentication-action-context.json

@@ -13,6 +13,7 @@
     },
     "ip_address": "50.141.123.10",
     "user_agent": "Mozilla/5.0",
+    "device_fingerprint": "notafingerprint",
     "issuer": "test",
     "object": "authentication_action_context",
     "organization": {

package/lib/actions/fixtures/user-registration-action-context.json

@@ -8,6 +8,7 @@
     },
     "ip_address": "50.141.123.10",
     "user_agent": "Mozilla/5.0",
+    "device_fingerprint": "notafingerprint",
     "object": "user_registration_action_context",
     "invitation": {
         "object": "invitation",

package/lib/actions/interfaces/action.interface.d.ts

@@ -8,6 +8,7 @@ interface AuthenticationActionContext {
     organizationMembership?: OrganizationMembership;
     ipAddress?: string;
     userAgent?: string;
+    deviceFingerprint?: string;
     issuer?: string;
 }
 export interface UserData {
@@ -23,6 +24,7 @@ interface UserRegistrationActionContext {
     invitation?: Invitation;
     ipAddress?: string;
     userAgent?: string;
+    deviceFingerprint?: string;
 }
 export type ActionContext = AuthenticationActionContext | UserRegistrationActionContext;
 interface AuthenticationActionPayload {
@@ -33,6 +35,7 @@ interface AuthenticationActionPayload {
     organization_membership?: OrganizationMembershipResponse;
     ip_address?: string;
     user_agent?: string;
+    device_fingerprint?: string;
     issuer?: string;
 }
 export interface UserDataPayload {
@@ -48,6 +51,7 @@ export interface UserRegistrationActionPayload {
     invitation?: InvitationResponse;
     ip_address?: string;
     user_agent?: string;
+    device_fingerprint?: string;
 }
 export type ActionPayload = AuthenticationActionPayload | UserRegistrationActionPayload;
 export {};

package/lib/actions/serializers/action.serializer.js

@@ -24,6 +24,7 @@ const deserializeAction = (actionPayload) => {
                     : undefined,
                 ipAddress: actionPayload.ip_address,
                 userAgent: actionPayload.user_agent,
+                deviceFingerprint: actionPayload.device_fingerprint,
             };
         case 'authentication_action_context':
             return {
@@ -38,6 +39,7 @@ const deserializeAction = (actionPayload) => {
                     : undefined,
                 ipAddress: actionPayload.ip_address,
                 userAgent: actionPayload.user_agent,
+                deviceFingerprint: actionPayload.device_fingerprint,
                 issuer: actionPayload.issuer,
             };
     }

package/lib/user-management/session.d.ts

@@ -31,7 +31,9 @@ export declare class Session {
      *
      * @returns The URL to redirect the user to for logging out.
      */
-    getLogoutUrl(): Promise<string>;
+    getLogoutUrl({ returnTo, }?: {
+        returnTo?: string;
+    }): Promise<string>;
     private isValidJwt;
 }
 export {};

package/lib/user-management/session.js

@@ -143,7 +143,7 @@ class Session {
      *
      * @returns The URL to redirect the user to for logging out.
      */
-    getLogoutUrl() {
+    getLogoutUrl({ returnTo, } = {}) {
         return __awaiter(this, void 0, void 0, function* () {
             const authenticationResponse = yield this.authenticate();
             if (!authenticationResponse.authenticated) {
@@ -152,6 +152,7 @@ class Session {
             }
             return this.userManagement.getLogoutUrl({
                 sessionId: authenticationResponse.sessionId,
+                returnTo,
             });
         });
     }

package/lib/user-management/session.spec.js

@@ -278,5 +278,30 @@ describe('Session', () => {
             });
             yield expect(session.getLogoutUrl()).rejects.toThrow('Failed to extract session ID for logout URL: no_session_cookie_provided');
         }));
+        describe('when a returnTo URL is provided', () => {
+            it('returns a logout URL for the user', () => __awaiter(void 0, void 0, void 0, function* () {
+                jest
+                    .spyOn(jose, 'jwtVerify')
+                    .mockResolvedValue({});
+                const cookiePassword = 'alongcookiesecretmadefortestingsessions';
+                const sessionData = yield (0, iron_session_1.sealData)({
+                    accessToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.ewogICJzdWIiOiAiMTIzNDU2Nzg5MCIsCiAgIm5hbWUiOiAiSm9obiBEb2UiLAogICJpYXQiOiAxNTE2MjM5MDIyLAogICJzaWQiOiAic2Vzc2lvbl8xMjMiLAogICJvcmdfaWQiOiAib3JnXzEyMyIsCiAgInJvbGUiOiAibWVtYmVyIiwKICAicGVybWlzc2lvbnMiOiBbInBvc3RzOmNyZWF0ZSIsICJwb3N0czpkZWxldGUiXQp9.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c',
+                    refreshToken: 'def456',
+                    user: {
+                        object: 'user',
+                        id: 'user_01H5JQDV7R7ATEYZDEG0W5PRYS',
+                        email: 'test01@example.com',
+                    },
+                }, { password: cookiePassword });
+                const session = workos.userManagement.loadSealedSession({
+                    sessionData,
+                    cookiePassword,
+                });
+                const url = yield session.getLogoutUrl({
+                    returnTo: 'https://example.com/signed-out',
+                });
+                expect(url).toBe('https://api.workos.com/user_management/sessions/logout?session_id=session_123&return_to=https%3A%2F%2Fexample.com%2Fsigned-out');
+            }));
+        });
     });
 });

package/lib/user-management/user-management.d.ts

@@ -104,8 +104,9 @@ export declare class UserManagement {
     revokeInvitation(invitationId: string): Promise<Invitation>;
     revokeSession(payload: RevokeSessionOptions): Promise<void>;
     getAuthorizationUrl({ connectionId, codeChallenge, codeChallengeMethod, context, clientId, domainHint, loginHint, organizationId, provider, redirectUri, state, screenHint, }: AuthorizationURLOptions): string;
-    getLogoutUrl({ sessionId }: {
+    getLogoutUrl({ sessionId, returnTo, }: {
         sessionId: string;
+        returnTo?: string;
     }): string;
     /**
      * @deprecated This method is deprecated and will be removed in a future major version.

package/lib/user-management/user-management.js

@@ -532,11 +532,16 @@ class UserManagement {
         });
         return `${this.workos.baseURL}/user_management/authorize?${query}`;
     }
-    getLogoutUrl({ sessionId }) {
+    getLogoutUrl({ sessionId, returnTo, }) {
         if (!sessionId) {
             throw new TypeError(`Incomplete arguments. Need to specify 'sessionId'.`);
         }
-        return `${this.workos.baseURL}/user_management/sessions/logout?session_id=${sessionId}`;
+        const url = new URL('/user_management/sessions/logout', this.workos.baseURL);
+        url.searchParams.set('session_id', sessionId);
+        if (returnTo) {
+            url.searchParams.set('return_to', returnTo);
+        }
+        return url.toString();
     }
     /**
      * @deprecated This method is deprecated and will be removed in a future major version.

package/lib/user-management/user-management.spec.js

@@ -1604,6 +1604,16 @@ describe('UserManagement', () => {
             });
             expect(url).toBe('https://api.workos.com/user_management/sessions/logout?session_id=123456');
         });
+        describe('when a `returnTo` is given', () => {
+            it('includes a `return_to` in the URL', () => {
+                const workos = new workos_1.WorkOS('sk_test_Sz3IQjepeSWaI4cMS4ms4sMuU');
+                const url = workos.userManagement.getLogoutUrl({
+                    sessionId: '123456',
+                    returnTo: 'https://your-app.com/signed-out',
+                });
+                expect(url).toBe('https://api.workos.com/user_management/sessions/logout?session_id=123456&return_to=https%3A%2F%2Fyour-app.com%2Fsigned-out');
+            });
+        });
     });
     describe('getLogoutUrlFromSessionCookie', () => {
         beforeEach(() => {

package/lib/workos.js

@@ -29,7 +29,7 @@ const subtle_crypto_provider_1 = require("./common/crypto/subtle-crypto-provider
 const fetch_client_1 = require("./common/net/fetch-client");
 const widgets_1 = require("./widgets/widgets");
 const actions_1 = require("./actions/actions");
-const VERSION = '7.36.1';
+const VERSION = '7.37.0';
 const DEFAULT_HOSTNAME = 'api.workos.com';
 const HEADER_AUTHORIZATION = 'Authorization';
 const HEADER_IDEMPOTENCY_KEY = 'Idempotency-Key';

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "7.36.1",
+  "version": "7.37.0",
   "name": "@workos-inc/node",
   "author": "WorkOS",
   "description": "A Node wrapper for the WorkOS API",
@@ -73,4 +73,3 @@
     }
   }
 }
-