@workos-inc/node 8.0.0-beta.2 → 8.0.0-beta.3

package/lib/esm/user-management/serializers/send-invitation-options.serializer.js

@@ -0,0 +1,13 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const serializeSendInvitationOptions = /* @__PURE__ */ __name((options) => ({
+  email: options.email,
+  organization_id: options.organizationId,
+  expires_in_days: options.expiresInDays,
+  inviter_user_id: options.inviterUserId,
+  role_slug: options.roleSlug
+}), "serializeSendInvitationOptions");
+export {
+  serializeSendInvitationOptions
+};
+//# sourceMappingURL=send-invitation-options.serializer.js.map

package/lib/esm/user-management/serializers/send-invitation-options.serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/user-management/serializers/send-invitation-options.serializer.ts"],"sourcesContent":["import {} from '../interfaces';\nimport {\n  SendInvitationOptions,\n  SerializedSendInvitationOptions,\n} from '../interfaces/send-invitation-options.interface';\n\nexport const serializeSendInvitationOptions = (\n  options: SendInvitationOptions,\n): SerializedSendInvitationOptions => ({\n  email: options.email,\n  organization_id: options.organizationId,\n  expires_in_days: options.expiresInDays,\n  inviter_user_id: options.inviterUserId,\n  role_slug: options.roleSlug,\n});\n"],"mappings":";;AAMO,MAAM,iCAAiC,wBAC5C,aACqC;AAAA,EACrC,OAAO,QAAQ;AAAA,EACf,iBAAiB,QAAQ;AAAA,EACzB,iBAAiB,QAAQ;AAAA,EACzB,iBAAiB,QAAQ;AAAA,EACzB,WAAW,QAAQ;AACrB,IAR8C;","names":[]}

package/lib/esm/user-management/serializers/session.serializer.d.ts

@@ -0,0 +1,6 @@
+import { SessionResponse, Session } from '../interfaces/session.interface.js';
+import '../interfaces/impersonator.interface.js';
+
+declare const deserializeSession: (session: SessionResponse) => Session;
+
+export { deserializeSession };

package/lib/esm/user-management/serializers/session.serializer.js

@@ -0,0 +1,21 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const deserializeSession = /* @__PURE__ */ __name((session) => ({
+  object: "session",
+  id: session.id,
+  userId: session.user_id,
+  ipAddress: session.ip_address,
+  userAgent: session.user_agent,
+  organizationId: session.organization_id,
+  impersonator: session.impersonator,
+  authMethod: session.auth_method,
+  status: session.status,
+  expiresAt: session.expires_at,
+  endedAt: session.ended_at,
+  createdAt: session.created_at,
+  updatedAt: session.updated_at
+}), "deserializeSession");
+export {
+  deserializeSession
+};
+//# sourceMappingURL=session.serializer.js.map

package/lib/esm/user-management/serializers/session.serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/user-management/serializers/session.serializer.ts"],"sourcesContent":["import { Session, SessionResponse } from '../interfaces';\n\nexport const deserializeSession = (session: SessionResponse): Session => ({\n  object: 'session',\n  id: session.id,\n  userId: session.user_id,\n  ipAddress: session.ip_address,\n  userAgent: session.user_agent,\n  organizationId: session.organization_id,\n  impersonator: session.impersonator,\n  authMethod: session.auth_method,\n  status: session.status,\n  expiresAt: session.expires_at,\n  endedAt: session.ended_at,\n  createdAt: session.created_at,\n  updatedAt: session.updated_at,\n});\n"],"mappings":";;AAEO,MAAM,qBAAqB,wBAAC,aAAuC;AAAA,EACxE,QAAQ;AAAA,EACR,IAAI,QAAQ;AAAA,EACZ,QAAQ,QAAQ;AAAA,EAChB,WAAW,QAAQ;AAAA,EACnB,WAAW,QAAQ;AAAA,EACnB,gBAAgB,QAAQ;AAAA,EACxB,cAAc,QAAQ;AAAA,EACtB,YAAY,QAAQ;AAAA,EACpB,QAAQ,QAAQ;AAAA,EAChB,WAAW,QAAQ;AAAA,EACnB,SAAS,QAAQ;AAAA,EACjB,WAAW,QAAQ;AAAA,EACnB,WAAW,QAAQ;AACrB,IAdkC;","names":[]}

package/lib/esm/user-management/serializers/update-organization-membership-options.serializer.d.ts

@@ -0,0 +1,5 @@
+import { UpdateOrganizationMembershipOptions, SerializedUpdateOrganizationMembershipOptions } from '../interfaces/update-organization-membership-options.interface.js';
+
+declare const serializeUpdateOrganizationMembershipOptions: (options: UpdateOrganizationMembershipOptions) => SerializedUpdateOrganizationMembershipOptions;
+
+export { serializeUpdateOrganizationMembershipOptions };

package/lib/esm/user-management/serializers/update-organization-membership-options.serializer.js

@@ -0,0 +1,9 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const serializeUpdateOrganizationMembershipOptions = /* @__PURE__ */ __name((options) => ({
+  role_slug: options.roleSlug
+}), "serializeUpdateOrganizationMembershipOptions");
+export {
+  serializeUpdateOrganizationMembershipOptions
+};
+//# sourceMappingURL=update-organization-membership-options.serializer.js.map

package/lib/esm/user-management/serializers/update-organization-membership-options.serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/user-management/serializers/update-organization-membership-options.serializer.ts"],"sourcesContent":["import {\n  UpdateOrganizationMembershipOptions,\n  SerializedUpdateOrganizationMembershipOptions,\n} from '../interfaces/update-organization-membership-options.interface';\n\nexport const serializeUpdateOrganizationMembershipOptions = (\n  options: UpdateOrganizationMembershipOptions,\n): SerializedUpdateOrganizationMembershipOptions => ({\n  role_slug: options.roleSlug,\n});\n"],"mappings":";;AAKO,MAAM,+CAA+C,wBAC1D,aACmD;AAAA,EACnD,WAAW,QAAQ;AACrB,IAJ4D;","names":[]}

package/lib/esm/user-management/serializers/update-user-options.serializer.d.ts

@@ -0,0 +1,6 @@
+import { UpdateUserOptions, SerializedUpdateUserOptions } from '../interfaces/update-user-options.interface.js';
+import '../interfaces/password-hash-type.interface.js';
+
+declare const serializeUpdateUserOptions: (options: UpdateUserOptions) => SerializedUpdateUserOptions;
+
+export { serializeUpdateUserOptions };

package/lib/esm/user-management/serializers/update-user-options.serializer.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const serializeUpdateUserOptions = /* @__PURE__ */ __name((options) => ({
+  email: options.email,
+  email_verified: options.emailVerified,
+  first_name: options.firstName,
+  last_name: options.lastName,
+  password: options.password,
+  password_hash: options.passwordHash,
+  password_hash_type: options.passwordHashType,
+  external_id: options.externalId,
+  metadata: options.metadata
+}), "serializeUpdateUserOptions");
+export {
+  serializeUpdateUserOptions
+};
+//# sourceMappingURL=update-user-options.serializer.js.map

package/lib/esm/user-management/serializers/update-user-options.serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/user-management/serializers/update-user-options.serializer.ts"],"sourcesContent":["import { SerializedUpdateUserOptions, UpdateUserOptions } from '../interfaces';\n\nexport const serializeUpdateUserOptions = (\n  options: UpdateUserOptions,\n): SerializedUpdateUserOptions => ({\n  email: options.email,\n  email_verified: options.emailVerified,\n  first_name: options.firstName,\n  last_name: options.lastName,\n  password: options.password,\n  password_hash: options.passwordHash,\n  password_hash_type: options.passwordHashType,\n  external_id: options.externalId,\n  metadata: options.metadata,\n});\n"],"mappings":";;AAEO,MAAM,6BAA6B,wBACxC,aACiC;AAAA,EACjC,OAAO,QAAQ;AAAA,EACf,gBAAgB,QAAQ;AAAA,EACxB,YAAY,QAAQ;AAAA,EACpB,WAAW,QAAQ;AAAA,EACnB,UAAU,QAAQ;AAAA,EAClB,eAAe,QAAQ;AAAA,EACvB,oBAAoB,QAAQ;AAAA,EAC5B,aAAa,QAAQ;AAAA,EACrB,UAAU,QAAQ;AACpB,IAZ0C;","names":[]}

package/lib/esm/user-management/serializers/update-user-password-options.serializer.d.ts

@@ -0,0 +1,5 @@
+import { UpdateUserPasswordOptions, SerializedUpdateUserPasswordOptions } from '../interfaces/update-user-password-options.interface.js';
+
+declare const serializeUpdateUserPasswordOptions: (options: UpdateUserPasswordOptions) => SerializedUpdateUserPasswordOptions;
+
+export { serializeUpdateUserPasswordOptions };

package/lib/esm/user-management/serializers/update-user-password-options.serializer.js

@@ -0,0 +1,9 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const serializeUpdateUserPasswordOptions = /* @__PURE__ */ __name((options) => ({
+  password: options.password
+}), "serializeUpdateUserPasswordOptions");
+export {
+  serializeUpdateUserPasswordOptions
+};
+//# sourceMappingURL=update-user-password-options.serializer.js.map

package/lib/esm/user-management/serializers/update-user-password-options.serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/user-management/serializers/update-user-password-options.serializer.ts"],"sourcesContent":["import {\n  SerializedUpdateUserPasswordOptions,\n  UpdateUserPasswordOptions,\n} from '../interfaces';\n\nexport const serializeUpdateUserPasswordOptions = (\n  options: UpdateUserPasswordOptions,\n): SerializedUpdateUserPasswordOptions => ({\n  password: options.password,\n});\n"],"mappings":";;AAKO,MAAM,qCAAqC,wBAChD,aACyC;AAAA,EACzC,UAAU,QAAQ;AACpB,IAJkD;","names":[]}

package/lib/esm/user-management/serializers/user.serializer.d.ts

@@ -0,0 +1,5 @@
+import { UserResponse, User } from '../interfaces/user.interface.js';
+
+declare const deserializeUser: (user: UserResponse) => User;
+
+export { deserializeUser };

package/lib/esm/user-management/serializers/user.serializer.js

@@ -0,0 +1,20 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const deserializeUser = /* @__PURE__ */ __name((user) => ({
+  object: user.object,
+  id: user.id,
+  email: user.email,
+  emailVerified: user.email_verified,
+  firstName: user.first_name,
+  profilePictureUrl: user.profile_picture_url,
+  lastName: user.last_name,
+  lastSignInAt: user.last_sign_in_at,
+  createdAt: user.created_at,
+  updatedAt: user.updated_at,
+  externalId: user.external_id ?? null,
+  metadata: user.metadata ?? {}
+}), "deserializeUser");
+export {
+  deserializeUser
+};
+//# sourceMappingURL=user.serializer.js.map

package/lib/esm/user-management/serializers/user.serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/user-management/serializers/user.serializer.ts"],"sourcesContent":["import { User, UserResponse } from '../interfaces';\n\nexport const deserializeUser = (user: UserResponse): User => ({\n  object: user.object,\n  id: user.id,\n  email: user.email,\n  emailVerified: user.email_verified,\n  firstName: user.first_name,\n  profilePictureUrl: user.profile_picture_url,\n  lastName: user.last_name,\n  lastSignInAt: user.last_sign_in_at,\n  createdAt: user.created_at,\n  updatedAt: user.updated_at,\n  externalId: user.external_id ?? null,\n  metadata: user.metadata ?? {},\n});\n"],"mappings":";;AAEO,MAAM,kBAAkB,wBAAC,UAA8B;AAAA,EAC5D,QAAQ,KAAK;AAAA,EACb,IAAI,KAAK;AAAA,EACT,OAAO,KAAK;AAAA,EACZ,eAAe,KAAK;AAAA,EACpB,WAAW,KAAK;AAAA,EAChB,mBAAmB,KAAK;AAAA,EACxB,UAAU,KAAK;AAAA,EACf,cAAc,KAAK;AAAA,EACnB,WAAW,KAAK;AAAA,EAChB,WAAW,KAAK;AAAA,EAChB,YAAY,KAAK,eAAe;AAAA,EAChC,UAAU,KAAK,YAAY,CAAC;AAC9B,IAb+B;","names":[]}

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

@@ -0,0 +1,126 @@
+import './interfaces/authenticate-with-session-cookie.interface.js';
+import './interfaces/refresh-and-seal-session-data.interface.js';
+export { C as CookieSession } from '../workos-DGRMJ65Z.js';
+import './interfaces/authentication-response.interface.js';
+import './interfaces/impersonator.interface.js';
+import './interfaces/oauth-tokens.interface.js';
+import './interfaces/user.interface.js';
+import '../common/interfaces/get-options.interface.js';
+import '../common/interfaces/post-options.interface.js';
+import '../common/interfaces/put-options.interface.js';
+import '../common/interfaces/workos-options.interface.js';
+import '../common/interfaces/app-info.interface.js';
+import '../events/interfaces/list-events-options.interface.js';
+import '../common/interfaces/event.interface.js';
+import '../directory-sync/interfaces/directory.interface.js';
+import '../directory-sync/interfaces/directory-group.interface.js';
+import '../directory-sync/interfaces/directory-user.interface.js';
+import '../roles/interfaces/role.interface.js';
+import '../organizations/interfaces/organization.interface.js';
+import '../organization-domains/interfaces/organization-domain.interface.js';
+import '../sso/interfaces/connection.interface.js';
+import '../sso/interfaces/connection-type.enum.js';
+import './interfaces/authentication-event.interface.js';
+import './interfaces/authentication-radar-risk-detected-event.interface.js';
+import './interfaces/email-verification.interface.js';
+import './interfaces/invitation.interface.js';
+import './interfaces/organization-membership.interface.js';
+import './interfaces/magic-auth.interface.js';
+import './interfaces/password-reset.interface.js';
+import './interfaces/session.interface.js';
+import '../common/interfaces/list.interface.js';
+import '../common/utils/pagination.js';
+import '../common/interfaces/pagination-options.interface.js';
+import '../organizations/interfaces/create-organization-options.interface.js';
+import '../organizations/interfaces/domain-data.interface.js';
+import '../organizations/interfaces/feature-flag.interface.js';
+import '../organizations/interfaces/list-organization-feature-flags-options.interface.js';
+import '../organizations/interfaces/list-organizations-options.interface.js';
+import '../organizations/interfaces/update-organization-options.interface.js';
+import '../organizations/interfaces/list-organization-roles-options.interface.js';
+import '../organization-domains/interfaces/create-organization-domain-options.interface.js';
+import '../passwordless/interfaces/passwordless-session.interface.js';
+import '../passwordless/interfaces/create-passwordless-session-options.interface.js';
+import '../passwordless/interfaces/send-session-response.interface.js';
+import '../portal/interfaces/generate-portal-link-intent.interface.js';
+import '../common/interfaces/unknown-record.interface.js';
+import '../sso/interfaces/authorization-url-options.interface.js';
+import '../sso/interfaces/get-profile-options.interface.js';
+import '../sso/interfaces/get-profile-and-token-options.interface.js';
+import '../sso/interfaces/list-connections-options.interface.js';
+import '../sso/interfaces/profile-and-token.interface.js';
+import '../sso/interfaces/profile.interface.js';
+import '../webhooks/webhooks.js';
+import '../common/crypto/crypto-provider.js';
+import '../mfa/interfaces/challenge-factor-options.js';
+import '../mfa/interfaces/challenge.interface.js';
+import '../mfa/interfaces/enroll-factor-options.js';
+import '../mfa/interfaces/factor.interface.js';
+import '../mfa/interfaces/sms.interface.js';
+import '../mfa/interfaces/totp.interface.js';
+import '../mfa/interfaces/verify-challenge-options.js';
+import '../mfa/interfaces/verify-challenge-response.js';
+import '../audit-logs/interfaces/audit-log-export-options.interface.js';
+import '../audit-logs/interfaces/audit-log-export.interface.js';
+import '../audit-logs/interfaces/create-audit-log-event-options.interface.js';
+import '../audit-logs/interfaces/create-audit-log-schema-options.interface.js';
+import 'jose';
+import './interfaces/authenticate-with-code-options.interface.js';
+import './interfaces/authenticate-with-options-base.interface.js';
+import './interfaces/authenticate-with-code-and-verifier-options.interface.js';
+import './interfaces/authenticate-with-email-verification-options.interface.js';
+import './interfaces/authenticate-with-magic-auth-options.interface.js';
+import './interfaces/authenticate-with-organization-selection.interface.js';
+import './interfaces/authenticate-with-password-options.interface.js';
+import './interfaces/authenticate-with-refresh-token-options.interface.js';
+import './interfaces/authenticate-with-totp-options.interface.js';
+import './interfaces/authorization-url-options.interface.js';
+import './interfaces/create-magic-auth-options.interface.js';
+import './interfaces/create-organization-membership-options.interface.js';
+import './interfaces/create-password-reset-options.interface.js';
+import './interfaces/create-user-options.interface.js';
+import './interfaces/password-hash-type.interface.js';
+import './interfaces/enroll-auth-factor.interface.js';
+import './interfaces/factor.interface.js';
+import './interfaces/identity.interface.js';
+import './interfaces/list-auth-factors-options.interface.js';
+import './interfaces/list-invitations-options.interface.js';
+import './interfaces/list-organization-memberships-options.interface.js';
+import './interfaces/list-sessions-options.interface.js';
+import './interfaces/list-users-options.interface.js';
+import './interfaces/reset-password-options.interface.js';
+import './interfaces/revoke-session-options.interface.js';
+import './interfaces/send-invitation-options.interface.js';
+import './interfaces/send-verification-email-options.interface.js';
+import './interfaces/update-organization-membership-options.interface.js';
+import './interfaces/update-user-options.interface.js';
+import './interfaces/verify-email-options.interface.js';
+import './interfaces/session-handler-options.interface.js';
+import '../fga/interfaces/check.interface.js';
+import '../fga/interfaces/resource.interface.js';
+import '../fga/interfaces/resource-op.enum.js';
+import '../fga/interfaces/warrant.interface.js';
+import '../fga/interfaces/warrant-op.enum.js';
+import '../fga/interfaces/check-op.enum.js';
+import '../fga/interfaces/warning.interface.js';
+import '../fga/interfaces/query.interface.js';
+import '../fga/interfaces/warrant-token.interface.js';
+import '../fga/utils/fga-paginatable.js';
+import '../fga/interfaces/list.interface.js';
+import '../common/net/http-client.js';
+import '../common/interfaces/http-client.interface.js';
+import '../widgets/interfaces/get-token.js';
+import '../actions/actions.js';
+import '../actions/interfaces/action.interface.js';
+import '../actions/interfaces/response-payload.interface.js';
+import '../vault/interfaces/key/create-data-key.interface.js';
+import '../vault/interfaces/key.interface.js';
+import '../vault/interfaces/key/decrypt-data-key.interface.js';
+import '../vault/interfaces/object/create-object.interface.js';
+import '../vault/interfaces/object/delete-object.interface.js';
+import '../vault/interfaces/object/read-object.interface.js';
+import '../vault/interfaces/object.interface.js';
+import '../vault/interfaces/object/update-object.interface.js';
+import '../directory-sync/interfaces/list-directories-options.interface.js';
+import '../directory-sync/interfaces/list-groups-options.interface.js';
+import '../directory-sync/interfaces/list-directory-users-options.interface.js';

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

@@ -0,0 +1,187 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { decodeJwt, jwtVerify } from "jose";
+import { OauthException } from "../common/exceptions/oauth.exception.js";
+import {
+  AuthenticateWithSessionCookieFailureReason,
+  RefreshSessionFailureReason
+} from "./interfaces/index.js";
+import { unsealData } from "iron-session";
+class CookieSession {
+  static {
+    __name(this, "CookieSession");
+  }
+  jwks;
+  userManagement;
+  cookiePassword;
+  sessionData;
+  constructor(userManagement, sessionData, cookiePassword) {
+    if (!cookiePassword) {
+      throw new Error("cookiePassword is required");
+    }
+    this.userManagement = userManagement;
+    this.cookiePassword = cookiePassword;
+    this.sessionData = sessionData;
+    this.jwks = this.userManagement.jwks;
+  }
+  /**
+   * Authenticates a user with a session cookie.
+   *
+   * @returns An object indicating whether the authentication was successful or not. If successful, it will include the user's session data.
+   */
+  async authenticate() {
+    if (!this.sessionData) {
+      return {
+        authenticated: false,
+        reason: AuthenticateWithSessionCookieFailureReason.NO_SESSION_COOKIE_PROVIDED
+      };
+    }
+    let session;
+    try {
+      session = await unsealData(this.sessionData, {
+        password: this.cookiePassword
+      });
+    } catch (e) {
+      return {
+        authenticated: false,
+        reason: AuthenticateWithSessionCookieFailureReason.INVALID_SESSION_COOKIE
+      };
+    }
+    if (!session.accessToken) {
+      return {
+        authenticated: false,
+        reason: AuthenticateWithSessionCookieFailureReason.INVALID_SESSION_COOKIE
+      };
+    }
+    if (!await this.isValidJwt(session.accessToken)) {
+      return {
+        authenticated: false,
+        reason: AuthenticateWithSessionCookieFailureReason.INVALID_JWT
+      };
+    }
+    const {
+      sid: sessionId,
+      org_id: organizationId,
+      role,
+      permissions,
+      entitlements,
+      feature_flags: featureFlags
+    } = decodeJwt(session.accessToken);
+    return {
+      authenticated: true,
+      sessionId,
+      organizationId,
+      role,
+      permissions,
+      entitlements,
+      featureFlags,
+      user: session.user,
+      impersonator: session.impersonator,
+      accessToken: session.accessToken
+    };
+  }
+  /**
+   * Refreshes the user's session.
+   *
+   * @param options - Optional options for refreshing the session.
+   * @param options.cookiePassword - The password to use for the new session cookie.
+   * @param options.organizationId - The organization ID to use for the new session cookie.
+   * @returns An object indicating whether the refresh was successful or not. If successful, it will include the new sealed session data.
+   */
+  async refresh(options = {}) {
+    const session = await unsealData(this.sessionData, {
+      password: this.cookiePassword
+    });
+    if (!session.refreshToken || !session.user) {
+      return {
+        authenticated: false,
+        reason: RefreshSessionFailureReason.INVALID_SESSION_COOKIE
+      };
+    }
+    const { org_id: organizationIdFromAccessToken } = decodeJwt(
+      session.accessToken
+    );
+    try {
+      const cookiePassword = options.cookiePassword ?? this.cookiePassword;
+      const authenticationResponse = await this.userManagement.authenticateWithRefreshToken({
+        clientId: this.userManagement.clientId,
+        refreshToken: session.refreshToken,
+        organizationId: options.organizationId ?? organizationIdFromAccessToken,
+        session: {
+          // We want to store the new sealed session in this class instance, so this always needs to be true
+          sealSession: true,
+          cookiePassword
+        }
+      });
+      if (options.cookiePassword) {
+        this.cookiePassword = options.cookiePassword;
+      }
+      this.sessionData = authenticationResponse.sealedSession;
+      const {
+        sid: sessionId,
+        org_id: organizationId,
+        role,
+        permissions,
+        entitlements,
+        feature_flags: featureFlags
+      } = decodeJwt(authenticationResponse.accessToken);
+      return {
+        authenticated: true,
+        sealedSession: authenticationResponse.sealedSession,
+        session: authenticationResponse,
+        sessionId,
+        organizationId,
+        role,
+        permissions,
+        entitlements,
+        featureFlags,
+        user: session.user,
+        impersonator: session.impersonator
+      };
+    } catch (error) {
+      if (error instanceof OauthException && // TODO: Add additional known errors and remove re-throw
+      (error.error === RefreshSessionFailureReason.INVALID_GRANT || error.error === RefreshSessionFailureReason.MFA_ENROLLMENT || error.error === RefreshSessionFailureReason.SSO_REQUIRED)) {
+        return {
+          authenticated: false,
+          reason: error.error
+        };
+      }
+      throw error;
+    }
+  }
+  /**
+   * Gets the URL to redirect the user to for logging out.
+   *
+   * @returns The URL to redirect the user to for logging out.
+   */
+  async getLogoutUrl({
+    returnTo
+  } = {}) {
+    const authenticationResponse = await this.authenticate();
+    if (!authenticationResponse.authenticated) {
+      const { reason } = authenticationResponse;
+      throw new Error(`Failed to extract session ID for logout URL: ${reason}`);
+    }
+    return this.userManagement.getLogoutUrl({
+      sessionId: authenticationResponse.sessionId,
+      returnTo
+    });
+  }
+  async isValidJwt(accessToken) {
+    if (!this.jwks) {
+      throw new Error(
+        "Missing client ID. Did you provide it when initializing WorkOS?"
+      );
+    }
+    try {
+      await jwtVerify(accessToken, this.jwks);
+      return true;
+    } catch (e) {
+      return false;
+    }
+  }
+}
+export {
+  CookieSession
+};
+//# sourceMappingURL=session.js.map

package/lib/esm/user-management/session.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/user-management/session.ts"],"sourcesContent":["import { createRemoteJWKSet, decodeJwt, jwtVerify } from 'jose';\nimport { OauthException } from '../common/exceptions/oauth.exception';\nimport {\n  AccessToken,\n  AuthenticateWithSessionCookieFailedResponse,\n  AuthenticateWithSessionCookieFailureReason,\n  AuthenticateWithSessionCookieSuccessResponse,\n  AuthenticationResponse,\n  RefreshSessionFailureReason,\n  RefreshSessionResponse,\n  SessionCookieData,\n} from './interfaces';\nimport { UserManagement } from './user-management';\nimport { unsealData } from 'iron-session';\n\ntype RefreshOptions = {\n  cookiePassword?: string;\n  organizationId?: string;\n};\n\nexport class CookieSession {\n  private jwks: ReturnType<typeof createRemoteJWKSet> | undefined;\n  private userManagement: UserManagement;\n  private cookiePassword: string;\n  private sessionData: string;\n\n  constructor(\n    userManagement: UserManagement,\n    sessionData: string,\n    cookiePassword: string,\n  ) {\n    if (!cookiePassword) {\n      throw new Error('cookiePassword is required');\n    }\n\n    this.userManagement = userManagement;\n    this.cookiePassword = cookiePassword;\n    this.sessionData = sessionData;\n\n    this.jwks = this.userManagement.jwks;\n  }\n\n  /**\n   * Authenticates a user with a session cookie.\n   *\n   * @returns An object indicating whether the authentication was successful or not. If successful, it will include the user's session data.\n   */\n  async authenticate(): Promise<\n    | AuthenticateWithSessionCookieSuccessResponse\n    | AuthenticateWithSessionCookieFailedResponse\n  > {\n    if (!this.sessionData) {\n      return {\n        authenticated: false,\n        reason:\n          AuthenticateWithSessionCookieFailureReason.NO_SESSION_COOKIE_PROVIDED,\n      };\n    }\n\n    let session: SessionCookieData;\n\n    try {\n      session = await unsealData<SessionCookieData>(this.sessionData, {\n        password: this.cookiePassword,\n      });\n    } catch (e) {\n      return {\n        authenticated: false,\n        reason:\n          AuthenticateWithSessionCookieFailureReason.INVALID_SESSION_COOKIE,\n      };\n    }\n\n    if (!session.accessToken) {\n      return {\n        authenticated: false,\n        reason:\n          AuthenticateWithSessionCookieFailureReason.INVALID_SESSION_COOKIE,\n      };\n    }\n\n    if (!(await this.isValidJwt(session.accessToken))) {\n      return {\n        authenticated: false,\n        reason: AuthenticateWithSessionCookieFailureReason.INVALID_JWT,\n      };\n    }\n\n    const {\n      sid: sessionId,\n      org_id: organizationId,\n      role,\n      permissions,\n      entitlements,\n      feature_flags: featureFlags,\n    } = decodeJwt<AccessToken>(session.accessToken);\n\n    return {\n      authenticated: true,\n      sessionId,\n      organizationId,\n      role,\n      permissions,\n      entitlements,\n      featureFlags,\n      user: session.user,\n      impersonator: session.impersonator,\n      accessToken: session.accessToken,\n    };\n  }\n\n  /**\n   * Refreshes the user's session.\n   *\n   * @param options - Optional options for refreshing the session.\n   * @param options.cookiePassword - The password to use for the new session cookie.\n   * @param options.organizationId - The organization ID to use for the new session cookie.\n   * @returns An object indicating whether the refresh was successful or not. If successful, it will include the new sealed session data.\n   */\n  async refresh(options: RefreshOptions = {}): Promise<RefreshSessionResponse> {\n    const session = await unsealData<SessionCookieData>(this.sessionData, {\n      password: this.cookiePassword,\n    });\n\n    if (!session.refreshToken || !session.user) {\n      return {\n        authenticated: false,\n        reason: RefreshSessionFailureReason.INVALID_SESSION_COOKIE,\n      };\n    }\n\n    const { org_id: organizationIdFromAccessToken } = decodeJwt<AccessToken>(\n      session.accessToken,\n    );\n\n    try {\n      const cookiePassword = options.cookiePassword ?? this.cookiePassword;\n\n      const authenticationResponse =\n        await this.userManagement.authenticateWithRefreshToken({\n          clientId: this.userManagement.clientId as string,\n          refreshToken: session.refreshToken,\n          organizationId:\n            options.organizationId ?? organizationIdFromAccessToken,\n          session: {\n            // We want to store the new sealed session in this class instance, so this always needs to be true\n            sealSession: true,\n            cookiePassword,\n          },\n        });\n\n      // Update the password if a new one was provided\n      if (options.cookiePassword) {\n        this.cookiePassword = options.cookiePassword;\n      }\n\n      this.sessionData = authenticationResponse.sealedSession as string;\n\n      const {\n        sid: sessionId,\n        org_id: organizationId,\n        role,\n        permissions,\n        entitlements,\n        feature_flags: featureFlags,\n      } = decodeJwt<AccessToken>(authenticationResponse.accessToken);\n\n      // TODO: Returning `session` here means there's some duplicated data.\n      // Slim down the return type in a future major version.\n      return {\n        authenticated: true,\n        sealedSession: authenticationResponse.sealedSession,\n        session: authenticationResponse as AuthenticationResponse,\n        sessionId,\n        organizationId,\n        role,\n        permissions,\n        entitlements,\n        featureFlags,\n        user: session.user,\n        impersonator: session.impersonator,\n      };\n    } catch (error) {\n      if (\n        error instanceof OauthException &&\n        // TODO: Add additional known errors and remove re-throw\n        (error.error === RefreshSessionFailureReason.INVALID_GRANT ||\n          error.error === RefreshSessionFailureReason.MFA_ENROLLMENT ||\n          error.error === RefreshSessionFailureReason.SSO_REQUIRED)\n      ) {\n        return {\n          authenticated: false,\n          reason: error.error,\n        };\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Gets the URL to redirect the user to for logging out.\n   *\n   * @returns The URL to redirect the user to for logging out.\n   */\n  async getLogoutUrl({\n    returnTo,\n  }: { returnTo?: string } = {}): Promise<string> {\n    const authenticationResponse = await this.authenticate();\n\n    if (!authenticationResponse.authenticated) {\n      const { reason } = authenticationResponse;\n      throw new Error(`Failed to extract session ID for logout URL: ${reason}`);\n    }\n\n    return this.userManagement.getLogoutUrl({\n      sessionId: authenticationResponse.sessionId,\n      returnTo,\n    });\n  }\n\n  private async isValidJwt(accessToken: string): Promise<boolean> {\n    if (!this.jwks) {\n      throw new Error(\n        'Missing client ID. Did you provide it when initializing WorkOS?',\n      );\n    }\n\n    try {\n      await jwtVerify(accessToken, this.jwks);\n      return true;\n    } catch (e) {\n      return false;\n    }\n  }\n}\n"],"mappings":"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","names":[]}

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

@@ -0,0 +1,126 @@
+import 'jose';
+import '../common/interfaces/pagination-options.interface.js';
+import '../common/utils/pagination.js';
+import '../mfa/interfaces/challenge.interface.js';
+export { U as UserManagement } from '../workos-DGRMJ65Z.js';
+import './interfaces/authenticate-with-code-options.interface.js';
+import './interfaces/authenticate-with-code-and-verifier-options.interface.js';
+import './interfaces/authenticate-with-email-verification-options.interface.js';
+import './interfaces/authenticate-with-magic-auth-options.interface.js';
+import './interfaces/authenticate-with-organization-selection.interface.js';
+import './interfaces/authenticate-with-password-options.interface.js';
+import './interfaces/authenticate-with-refresh-token-options.interface.js';
+import './interfaces/authenticate-with-session-cookie.interface.js';
+import './interfaces/authenticate-with-totp-options.interface.js';
+import './interfaces/authentication-response.interface.js';
+import './interfaces/authorization-url-options.interface.js';
+import './interfaces/create-magic-auth-options.interface.js';
+import './interfaces/create-organization-membership-options.interface.js';
+import './interfaces/create-password-reset-options.interface.js';
+import './interfaces/create-user-options.interface.js';
+import './interfaces/email-verification.interface.js';
+import './interfaces/enroll-auth-factor.interface.js';
+import './interfaces/factor.interface.js';
+import './interfaces/identity.interface.js';
+import './interfaces/invitation.interface.js';
+import './interfaces/list-auth-factors-options.interface.js';
+import './interfaces/list-invitations-options.interface.js';
+import './interfaces/list-organization-memberships-options.interface.js';
+import './interfaces/list-sessions-options.interface.js';
+import './interfaces/list-users-options.interface.js';
+import './interfaces/magic-auth.interface.js';
+import './interfaces/organization-membership.interface.js';
+import './interfaces/password-reset.interface.js';
+import './interfaces/reset-password-options.interface.js';
+import './interfaces/revoke-session-options.interface.js';
+import './interfaces/send-invitation-options.interface.js';
+import './interfaces/send-verification-email-options.interface.js';
+import './interfaces/session.interface.js';
+import './interfaces/update-organization-membership-options.interface.js';
+import './interfaces/update-user-options.interface.js';
+import './interfaces/user.interface.js';
+import './interfaces/verify-email-options.interface.js';
+import './interfaces/session-handler-options.interface.js';
+import '../common/interfaces/list.interface.js';
+import '../common/interfaces/get-options.interface.js';
+import '../common/interfaces/post-options.interface.js';
+import '../common/interfaces/put-options.interface.js';
+import '../common/interfaces/workos-options.interface.js';
+import '../common/interfaces/app-info.interface.js';
+import '../events/interfaces/list-events-options.interface.js';
+import '../common/interfaces/event.interface.js';
+import '../directory-sync/interfaces/directory.interface.js';
+import '../directory-sync/interfaces/directory-group.interface.js';
+import '../directory-sync/interfaces/directory-user.interface.js';
+import '../roles/interfaces/role.interface.js';
+import '../organizations/interfaces/organization.interface.js';
+import '../organization-domains/interfaces/organization-domain.interface.js';
+import '../sso/interfaces/connection.interface.js';
+import '../sso/interfaces/connection-type.enum.js';
+import './interfaces/authentication-event.interface.js';
+import './interfaces/authentication-radar-risk-detected-event.interface.js';
+import './interfaces/impersonator.interface.js';
+import '../organizations/interfaces/create-organization-options.interface.js';
+import '../organizations/interfaces/domain-data.interface.js';
+import '../organizations/interfaces/feature-flag.interface.js';
+import '../organizations/interfaces/list-organization-feature-flags-options.interface.js';
+import '../organizations/interfaces/list-organizations-options.interface.js';
+import '../organizations/interfaces/update-organization-options.interface.js';
+import '../organizations/interfaces/list-organization-roles-options.interface.js';
+import '../organization-domains/interfaces/create-organization-domain-options.interface.js';
+import '../passwordless/interfaces/passwordless-session.interface.js';
+import '../passwordless/interfaces/create-passwordless-session-options.interface.js';
+import '../passwordless/interfaces/send-session-response.interface.js';
+import '../portal/interfaces/generate-portal-link-intent.interface.js';
+import '../common/interfaces/unknown-record.interface.js';
+import '../sso/interfaces/authorization-url-options.interface.js';
+import '../sso/interfaces/get-profile-options.interface.js';
+import '../sso/interfaces/get-profile-and-token-options.interface.js';
+import '../sso/interfaces/list-connections-options.interface.js';
+import '../sso/interfaces/profile-and-token.interface.js';
+import '../sso/interfaces/profile.interface.js';
+import '../webhooks/webhooks.js';
+import '../common/crypto/crypto-provider.js';
+import '../mfa/interfaces/challenge-factor-options.js';
+import '../mfa/interfaces/enroll-factor-options.js';
+import '../mfa/interfaces/factor.interface.js';
+import '../mfa/interfaces/sms.interface.js';
+import '../mfa/interfaces/totp.interface.js';
+import '../mfa/interfaces/verify-challenge-options.js';
+import '../mfa/interfaces/verify-challenge-response.js';
+import '../audit-logs/interfaces/audit-log-export-options.interface.js';
+import '../audit-logs/interfaces/audit-log-export.interface.js';
+import '../audit-logs/interfaces/create-audit-log-event-options.interface.js';
+import '../audit-logs/interfaces/create-audit-log-schema-options.interface.js';
+import './interfaces/refresh-and-seal-session-data.interface.js';
+import './interfaces/oauth-tokens.interface.js';
+import '../fga/interfaces/check.interface.js';
+import '../fga/interfaces/resource.interface.js';
+import '../fga/interfaces/resource-op.enum.js';
+import '../fga/interfaces/warrant.interface.js';
+import '../fga/interfaces/warrant-op.enum.js';
+import '../fga/interfaces/check-op.enum.js';
+import '../fga/interfaces/warning.interface.js';
+import '../fga/interfaces/query.interface.js';
+import '../fga/interfaces/warrant-token.interface.js';
+import '../fga/utils/fga-paginatable.js';
+import '../fga/interfaces/list.interface.js';
+import '../common/net/http-client.js';
+import '../common/interfaces/http-client.interface.js';
+import '../widgets/interfaces/get-token.js';
+import '../actions/actions.js';
+import '../actions/interfaces/action.interface.js';
+import '../actions/interfaces/response-payload.interface.js';
+import '../vault/interfaces/key/create-data-key.interface.js';
+import '../vault/interfaces/key.interface.js';
+import '../vault/interfaces/key/decrypt-data-key.interface.js';
+import '../vault/interfaces/object/create-object.interface.js';
+import '../vault/interfaces/object/delete-object.interface.js';
+import '../vault/interfaces/object/read-object.interface.js';
+import '../vault/interfaces/object.interface.js';
+import '../vault/interfaces/object/update-object.interface.js';
+import '../directory-sync/interfaces/list-directories-options.interface.js';
+import '../directory-sync/interfaces/list-groups-options.interface.js';
+import '../directory-sync/interfaces/list-directory-users-options.interface.js';
+import './interfaces/authenticate-with-options-base.interface.js';
+import './interfaces/password-hash-type.interface.js';