@crossauth/backend 0.0.2

package/dist/session.d.ts

@@ -0,0 +1,491 @@
+import { User, UserSecrets, Key, UserInputFields, UserSecretsInputFields } from '@crossauth/common';
+import { UserStorage, KeyStorage } from './storage.ts';
+import { AuthenticationParameters, Authenticator } from './auth.ts';
+import { TokenEmailerOptions } from './emailtokens.ts';
+import { Cookie, DoubleSubmitCsrfToken, DoubleSubmitCsrfTokenOptions, SessionCookieOptions } from './cookieauth.ts';
+
+/**
+ * Options for {@link SessionManager}
+ */
+export interface SessionManagerOptions extends TokenEmailerOptions {
+    /**
+     * If user login is enabled, you must provide the object where users
+     * are stored.
+     */
+    userStorage?: UserStorage;
+    /** options for csrf cookie manager */
+    doubleSubmitCookieOptions?: DoubleSubmitCsrfTokenOptions;
+    /** options for session cookie manager */
+    sessionCookieOptions?: SessionCookieOptions;
+    /** If true, users will have to verify their email address before account is created or when changing their email address.
+     * See class description for details.. Default true
+     */
+    enableEmailVerification?: boolean;
+    /** If true, allow password reset by email token.
+     * See class description for details.. Default true
+     */
+    enablePasswordReset?: boolean;
+    /** Server secret.  Needed for emailing tokens and for csrf tokens */
+    secret?: string;
+    /**
+     * Store for password reset and email vcerification tokens.  If not passed, the same store as
+     * for sessions is used.
+     */
+    emailTokenStorage?: KeyStorage;
+    /**
+     * Base URL for the site.
+     *
+     * This is used when constructing URLs, eg for sending password reset
+     * tokens.
+     */
+    siteUrl?: string;
+    /**
+     * Set of 2FA factor names a user is allowed to set.
+     *
+     * The name corresponds to the key you give when adding authenticators.
+     * See `authentiators` in {@link SessionManager.constructor}.
+     */
+    allowedFactor2?: string[];
+}
+/**
+ * Class for managing sessions.
+ */
+export declare class SessionManager {
+    userStorage?: UserStorage;
+    keyStorage: KeyStorage;
+    emailTokenStorage: KeyStorage;
+    readonly csrfTokens: DoubleSubmitCsrfToken;
+    private session;
+    readonly authenticators: {
+        [key: string]: Authenticator;
+    };
+    private enableEmailVerification;
+    private enablePasswordReset;
+    private tokenEmailer?;
+    allowedFactor2: string[];
+    /**
+     * Constructor
+     * @param keyStorage  the {@link KeyStorage} instance to use, eg {@link PrismaKeyStorage}.
+     * @param authenticators authenticators used to validate users, eg {@link LocalPasswordAuthenticatorOptions }.
+     * @param options optional parameters for authentication. See {@link SessionManagerOptions }.
+     */
+    constructor(keyStorage: KeyStorage, authenticators: {
+        [key: string]: Authenticator;
+    }, options?: SessionManagerOptions);
+    /**
+     * Returns the name used for session ID cookies.
+     */
+    get sessionCookieName(): string;
+    /**
+     * Returns the name used for session ID cookies.
+     */
+    get sessionCookiePath(): string;
+    /**
+     * Returns the name used for CSRF token cookies.
+     */
+    get csrfCookieName(): string;
+    /**
+     * Returns the name used for CSRF token cookies.
+     */
+    get csrfCookiePath(): string;
+    /**
+     * Returns the name used for CSRF token cookies.
+     */
+    get csrfHeaderName(): string;
+    /**
+     * Performs a user login
+     *
+     *    * Authenticates the username and password
+     *    * Creates a session key - if 2FA is enabled, this is an anonymous session,
+     *      otherwise it is bound to the user
+     *    * Returns the user (without the password hash) and the session cookie.
+     * If the user object is defined, authentication (and 2FA) is bypassed
+     * @param username the username to validate
+     * @param params user-provided credentials (eg password) to authenticate with
+     * @param extraFields add these extra fields to the session key if authentication is successful
+     * @param persist if passed, overrides the persistSessionId setting.
+     * @param user if this is defined, the username and password are ignored and the given user is logged in.
+     *             The 2FA step is also skipped
+     * @param bypass2FA if true, the 2FA step will be skipped
+     * @returns the user, user secrets, and session cookie and CSRF cookie and token.
+     *          if a 2fa step is needed, it will be an anonymouos session, otherwise bound to the user
+     * @throws {@link @crossauth/common!CrossauthError} with
+     *         {@link @crossauth/common!ErrorCode} of `Connection`, `UserNotValid`,
+     *         `PasswordNotMatch` or `UserNotExist`.
+     */
+    login(username: string, params: AuthenticationParameters, extraFields?: {
+        [key: string]: any;
+    }, persist?: boolean, user?: User, bypass2FA?: boolean): Promise<{
+        sessionCookie: Cookie;
+        csrfCookie: Cookie;
+        csrfFormOrHeaderValue: string;
+        user: User;
+        secrets: UserSecrets;
+    }>;
+    /**
+     * If a valid session key does not exist, create and store an anonymous one.
+     *
+     * @param extraFields these will be added to the created session object.
+     * @returns a cookie with the session ID, a cookie with the CSRF token
+     *          and the CSRF value to put in the form or header value.
+     */
+    createAnonymousSession(extraFields?: {
+        [key: string]: any;
+    }): Promise<{
+        sessionCookie: Cookie;
+        csrfCookie: Cookie;
+        csrfFormOrHeaderValue: string;
+    }>;
+    /**
+     * Logs a user out.
+     *
+     * Removes the given session ID from the session storage.
+     *
+     * @param sessionId the session ID to remove.
+     * @throws {@link @crossauth/common!CrossauthError} with
+     *         {@link @crossauth/common!ErrorCode} of `Connection`
+     */
+    logout(sessionId: string): Promise<void>;
+    /**
+     * Logs a user out from all sessions.
+     *
+     * Removes the given session ID from the session storage.
+     *
+     * @param except Don't log out from the matching session.
+     * @throws {@link @crossauth/common!CrossauthError} with
+     *         {@link @crossauth/common!ErrorCode} of `Connection`
+     */
+    logoutFromAll(userid: string | number, except?: string | undefined): Promise<void>;
+    /**
+     * Returns the user (without secrets) matching the given session key.
+     *
+     * If the user is undefined, or the key has expired, returns undefined.
+     *
+     * @param sessionId the session key to look up in session storage
+     * @returns the {@link User} (without password hash) matching the  session key
+     * @throws {@link @crossauth/common!CrossauthError} with
+     *         {@link @crossauth/common!ErrorCode} of `Connection`,
+     *         `InvalidSessionId`
+     *         `UserNotExist` or `Expired`.
+     */
+    userForSessionId(sessionId: string): Promise<{
+        key: Key;
+        user: User | undefined;
+    }>;
+    /**
+     * Returns the data object for a session key, or undefined, as a JSON string
+     * (which is how it is stored in the session table)
+     *
+     * If the user is undefined, or the key has expired, returns undefined.
+     *
+     * @param sessionId the session id to look up in session storage
+     * @returns a string from the data field
+     * @throws {@link @crossauth/common!CrossauthError} with
+     *         {@link @crossauth/common!ErrorCode} of `Connection`,  `InvalidSessionId`
+     *         `UserNotExist` or `Expired`.
+     */
+    dataStringForSessionId(sessionId: string): Promise<string | undefined>;
+    /**
+     * Returns the data object for a session id, or undefined, as an object.
+     *
+     * If the user is undefined, or the key has expired, returns undefined.
+     *
+     * @param sessionId the session key to look up in session storage
+     * @returns a string from the data field
+     * @throws {@link @crossauth/common!CrossauthError} with
+     *         {@link @crossauth/common!ErrorCode} of `Connection`,  `InvalidSessionId`
+     *         `UserNotExist` or `Expired`.
+     */
+    dataForSessionId(sessionId: string): Promise<{
+        [key: string]: any;
+    }>;
+    /**
+     * Creates and returns a signed CSRF token based on the session ID
+     * @returns a CSRF cookie and value to put in the form or CSRF header
+     */
+    createCsrfToken(): Promise<{
+        csrfCookie: Cookie;
+        csrfFormOrHeaderValue: string;
+    }>;
+    /**
+     * Validates the signature on the CSRF cookie value and returns a
+     * value that can be put in the form or CSRF header value.
+     *
+     * @param csrfCookieValue the value from the CSRF cookie
+     * @returns the value to put in the form or CSRF header
+     */
+    createCsrfFormOrHeaderValue(csrfCookieValue: string): Promise<string>;
+    /**
+     * Returns the session ID from the signed session cookie value
+     *
+     * @param sessionCookieValue value from the session ID cookie
+     * @returns the usigned cookie value.
+     * @throws {@link @crossauth/common!CrossauthError} with `InvalidKey`
+     *         if the signature is invalid.
+     */
+    getSessionId(sessionCookieValue: string): string;
+    /**
+     * Throws {@link @crossauth/common!CrossauthError} with
+     * `InvalidKey` if the passed CSRF token is not valid for the given
+     * session ID.  Otherwise returns without error
+     *
+     * @param csrfCookieValue the CSRF cookie value
+     * @param csrfFormOrHeaderValue the value from the form field or
+     *        CSRF header
+     */
+    validateDoubleSubmitCsrfToken(csrfCookieValue: string | undefined, csrfFormOrHeaderValue: string | undefined): void;
+    /**
+     * Throws {@link @crossauth/common!CrossauthError} with `InvalidKey` if
+     * the passed CSRF cookie value is not valid (ie invalid signature)
+     * @param csrfCookieValue the CSRF cookie value
+     */
+    validateCsrfCookie(csrfCookieValue: string): void;
+    /**
+     * If sessionIdleTimeout is set, update the last activcity time in key
+     * storage to current time.
+     *
+     * @param sessionId the session Id to update.
+     */
+    updateSessionActivity(sessionId: string): Promise<void>;
+    /**
+     * Update a field in the session data.
+     *
+     * The `data` field in the session entry is assumed to be a JSON string.
+     * The field with the given name is updated or set if not already set.
+     * @param sessionId the session Id to update.
+     * @param name of the field.
+     * @param value new value to store
+     */
+    updateSessionData(sessionId: string, name: string, value: {
+        [key: string]: any;
+    }): Promise<void>;
+    /**
+     * Update field sin the session data.
+     *
+     * The `data` field in the session entry is assumed to be a JSON string.
+     * The field with the given name is updated or set if not already set.
+     * @param sessionId the session Id to update.
+     * @param name of the field.
+     * @param value new value to store
+     */
+    updateManySessionData(sessionId: string, dataArray: {
+        dataName: string;
+        value: any;
+    }[]): Promise<void>;
+    /**
+    * Deletes a field from the session data.
+    *
+    * The `data` field in the session entry is assumed to be a JSON string.
+    * The field with the given name is updated or set if not already set.
+    * @param sessionId the session Id to update.
+    * @param name of the field.
+    */
+    deleteSessionData(sessionId: string, name: string): Promise<void>;
+    /**
+     * Deletes the given session ID from the key storage (not the cookie)
+     *
+     * @param sessionId the session Id to delete
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * Creates a new user, sending an email verification message if necessary.
+     *
+     * If email verification is enabled, the user's state is set to
+     * `awaitingemailverification`. Otherwise it is set to `active`.
+     *
+     * @param user fields to put in the new entry
+     * @param params parameters to pass to the relevant factor 1 authenticator.
+     * @param repeatParams if this is set, an exception will be raised if
+     *        the values here to not match those in `params`.
+     * @param skipEmailVerification if true, email verification will not be
+     *        performed
+     * @returns the new user
+     */
+    createUser(user: UserInputFields, params: AuthenticationParameters, repeatParams?: AuthenticationParameters, skipEmailVerification?: boolean, emptyPassword?: boolean): Promise<User>;
+    /**
+     * Deletes the user matching the given username
+     * @param username user to delete
+     */
+    deleteUserByUsername(username: string): Promise<void>;
+    /** Creates a user with 2FA enabled.
+     *
+     * The user storage entry will be createed, with the state set to
+     * `awaitingtwofactorsetup`.   The passed session key will be updated to
+     * include the username and details needed by 2FA during the configure step.
+     * @param user : details to save in the user table
+     * @param params : params the parameters needed to authenticate with factor1
+     *                   (eg password)
+     * @param sessionId the anonymous session cookie
+     * @param repeatParams if passed, these will be compared with `params` and
+     *                     if they don't match, `PasswordMatch` is thrown.
+     * @return `userid` the id of the created user.
+     *         `userData` data that can be displayed to the user in the page to
+     *          complete 2FA set up (eg the secret key and QR codee for TOTP),
+     *
+     */
+    initiateTwoFactorSignup(user: UserInputFields, params: AuthenticationParameters, sessionId: string, repeatParams?: AuthenticationParameters): Promise<{
+        userid: string | number;
+        userData: {
+            [key: string]: any;
+        };
+    }>;
+    /**
+     * Begins the process of setting up 2FA for a user which has already been
+     * created and activated.  Called when changing 2FA or changing its parameters.
+     * @param user the logged in user
+     * @param newFactor2 new second factor to change user to
+     * @param sessionId the session cookie for the user
+     * @returns the 2FA data that can be displayed to the user in the confifugre 2FA
+     *          step (such as the secret and QR code for TOTP).
+     */
+    initiateTwoFactorSetup(user: User, newFactor2: string | undefined, sessionId: string): Promise<{
+        [key: string]: any;
+    }>;
+    /**
+     * This can be called if the user has finished signing up with factor1 but
+     * closed the browser before completing factor2 setup.  Call it if the user
+     * signs up again with the same factor1 credentials.
+     * @param sessionId the anonymous session ID for the user
+     * @returns `userid` the id of the created user
+     *          `userData` data that can be displayed to the user in the page to
+     *           complete 2FA set up (eg the secret key and QR codee for TOTP),
+     *          `secrets` data that is saved in the session for factor2.  In the
+     *          case of TOTP, both `userData` and `secrets` contain the shared
+     *          secret but only `userData` has the QR code, since it can be
+     *          generated from the shared secret.
+     */
+    repeatTwoFactorSignup(sessionId: string): Promise<{
+        userid: string | number;
+        userData: {
+            [key: string]: any;
+        };
+        secrets: Partial<UserSecretsInputFields>;
+    }>;
+    /**
+     * Authenticates with the second factor.
+     *
+     * If successful, the new user object is returned.  Otherwise an exception
+     * is thrown,
+     * @param params the parameters from user input needed to authenticate (eg TOTP code)
+     * @param sessionId the session cookie value (ie still signed)
+     * @returns the user object
+     * @throws {@link @crossauth/common!CrossauthError} if authentication fails.
+     */
+    completeTwoFactorSetup(params: AuthenticationParameters, sessionId: string): Promise<User>;
+    /**
+     * Initiates the two factor login process.
+     *
+     * Creates an anonymous session and coorresponding CSRF token
+     * @param user the user, which should aleady have been authenticated with factor1
+     * @returns a new anonymous session cookie and corresponding CSRF cookie and token.
+     */
+    private initiateTwoFactorLogin;
+    /**
+     * Initiates the two factor process when visiting a protected page.
+     *
+     * Creates an anonymous session and coorresponding CSRF token
+     * @param user the user, which should aleady have been authenticated with factor1
+     * @param sessionId the logged in session associated with the user
+     * @param requestBody the parameters from the request made before being redirected to factor2 authentication
+     * @param url the requested url, including path and query parameters
+     * @returns If a token was passed a new anonymous session cookie and
+     *          corresponding CSRF cookie and token.
+     */
+    initiateTwoFactorPageVisit(user: User, sessionId: string, requestBody: {
+        [key: string]: any;
+    }, url: string | undefined, contentType?: string): Promise<{
+        sessionCookie: Cookie | undefined;
+        csrfCookie: Cookie | undefined;
+        csrfFormOrHeaderValue: string | undefined;
+    }>;
+    /**
+     * Completes 2FA when visiting a protected page.
+     *
+     * If successful, returns.  Otherwise an exception is thrown.
+     * @param params the parameters from user input needed to authenticate
+     *        (eg TOTP code).  Passed to the authenticator
+     * @param sessionId the session cookie value (ie still signed)
+     * @throws {@link @crossauth/common!CrossauthError} if authentication fails.
+     */
+    completeTwoFactorPageVisit(params: AuthenticationParameters, sessionId: string): Promise<void>;
+    /**
+     * Cancels the 2FA that was previously initiated but not completed..
+     *
+     * If successful, returns.  Otherwise an exception is thrown.
+     * @param sessionId the session id (unsigned)
+     * @returns the 2FA data that was created on initiation
+     * @throws {@link @crossauth/common!CrossauthError} of `Unauthorized`
+     *         if 2FA was not initiated.
+     */
+    cancelTwoFactorPageVisit(sessionId: string): Promise<{
+        [key: string]: any;
+    }>;
+    /**
+     * Performs the second factor authentication as the second step of the login
+     * process
+     *
+     * If authentication is successful, the user's state will be set to active
+     * and a new session will be created, bound to the user.  The anonymous session
+     * will be deleted.
+     * @param params the user-provided parameters to authenticate with (eg TOTP code).
+     * @param sessionId the user's anonymous session
+     * @param extraFields extra fields to add to the user-bound new session table entry
+     * @param persist if true, the cookie will be perstisted (with an expiry value);
+     *                otberwise it will be a session-only cookie.
+     * @returns `sessionCookie` the new session cookie
+     *          `csrfCookie` the new CSRF cookie
+     *          `csrfToken` the new CSRF token corresponding to the cookie
+     *          `user` the newly-logged in user.
+     */
+    completeTwoFactorLogin(params: AuthenticationParameters, sessionId: string, extraFields?: {
+        [key: string]: any;
+    }, persist?: boolean): Promise<{
+        sessionCookie: Cookie;
+        csrfCookie: Cookie;
+        csrfFormOrHeaderValue: string;
+        user: User;
+    }>;
+    /**
+     * Sends a password reset token
+     * @param email the user's email (where the token will be sent)
+.     */
+    requestPasswordReset(email: string): Promise<void>;
+    /**
+     * Takes an email verification token as input and applies it to the user storage.
+     *
+     * The state is reset to active.  If the token was for changing the password, the new
+     * password is saved to the user in user storage.
+     *
+     * @param token the token to apply
+     * @returns the new user record
+     */
+    applyEmailVerificationToken(token: string): Promise<User>;
+    /**
+     * Returns the user associated with a password reset token
+     * @param token the token that was emailed
+     * @returns the user
+     * @throws {@link @crossauth/common!CrossauthError} if the token is not valid.
+     */
+    userForPasswordResetToken(token: string): Promise<User>;
+    changeSecrets(username: string, factorNumber: 1 | 2, newParams: AuthenticationParameters, repeatParams?: AuthenticationParameters, oldParams?: AuthenticationParameters): Promise<User>;
+    /**
+     * Updates a user entry in storage
+     * @param currentUser the current user details
+     * @param newUser the new user details
+     * @returns true if email verification is now needed, false otherwise
+     */
+    updateUser(currentUser: User, newUser: User, skipEmailVerification?: boolean): Promise<boolean>;
+    /**
+     * Resets the secret for factor1 or 2 (eg reset password)
+     * @param token the reset password token that was emailed
+     * @param factorNumber which factor to reset (1 or 2)
+     * @param params the new secrets entered by the user (eg new password)
+     * @param repeatParams optionally, repeat of the secrets.  If passed,
+     *                     an exception will be thrown if they do not match
+     * @returns the user object
+     * @throws {@link @crossauth/common!CrossauthError} if the repeatParams don't match params,
+     * the token is invalid or the user storage cannot be updated.
+     */
+    resetSecret(token: string, factorNumber: 1 | 2, params: AuthenticationParameters, repeatParams?: AuthenticationParameters): Promise<User>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

package/dist/storage/dbconnection.d.ts

@@ -0,0 +1,19 @@
+export declare abstract class DbPool {
+    constructor();
+    abstract connect(): Promise<DbConnection>;
+    abstract parameters(): DbParameter;
+}
+export declare abstract class DbParameter {
+    constructor();
+    abstract nextParameter(): string;
+}
+export declare abstract class DbConnection {
+    abstract execute(query: string, values: any[]): Promise<{
+        [key: string]: any;
+    }[]>;
+    abstract startTransaction(): Promise<void>;
+    abstract commit(): Promise<void>;
+    abstract rollback(): Promise<void>;
+    abstract release(): void;
+}
+//# sourceMappingURL=dbconnection.d.ts.map

package/dist/storage/dbconnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dbconnection.d.ts","sourceRoot":"","sources":["../../src/storage/dbconnection.ts"],"names":[],"mappings":"AACA,8BAAsB,MAAM;;IAExB,QAAQ,CAAC,OAAO,IAAK,OAAO,CAAC,YAAY,CAAC;IAC1C,QAAQ,CAAC,UAAU,IAAK,WAAW;CACtC;AAED,8BAAsB,WAAW;;IAE7B,QAAQ,CAAC,aAAa,IAAK,MAAM;CACpC;AAED,8BAAsB,YAAY;IAC9B,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAG,MAAM,EAAE,MAAM,EAAG,GAAG,EAAE,GAAI,OAAO,CAAC;QAAC,CAAC,GAAG,EAAC,MAAM,GAAE,GAAG,CAAA;KAAC,EAAE,CAAC;IAChF,QAAQ,CAAC,gBAAgB,IAAK,OAAO,CAAC,IAAI,CAAC;IAC3C,QAAQ,CAAC,MAAM,IAAK,OAAO,CAAC,IAAI,CAAC;IACjC,QAAQ,CAAC,QAAQ,IAAK,OAAO,CAAC,IAAI,CAAC;IACnC,QAAQ,CAAC,OAAO,IAAK,IAAI;CAE5B"}