@sphereon/ssi-express-support 0.33.1-next.3 → 0.33.1-next.73

package/dist/index.d.ts

@@ -1,9 +1,403 @@
-export * from './entra-id-auth';
-export * from './static-bearer-auth';
-export * from './auth-utils';
-export * from './express-builders';
-export * from './types';
-export { sendErrorResponse, jsonErrorHandler } from './express-utils';
-export * from './functions';
-export * from './openid-connect-rp';
-//# sourceMappingURL=index.d.ts.map
+import { Enforcer } from 'casbin';
+import express, { Express, RequestHandler, NextFunction, Router } from 'express';
+import { ParamsDictionary, ApplicationRequestHandler, Application } from 'express-serve-static-core';
+import http from 'http';
+import { HttpTerminator } from 'http-terminator';
+import { AuthenticateCallback, Strategy, InitializeOptions } from 'passport';
+import { ParsedQs } from 'qs';
+import session from 'express-session';
+import morgan from 'morgan';
+import { TAgent } from '@veramo/core';
+import { Issuer, BaseClient, ClientMetadata, ClientOptions } from 'openid-client';
+import { JsonWebKey } from '@sphereon/ssi-types';
+
+interface IExpressServerOpts {
+    port?: number;
+    cookieSigningKey?: string;
+    hostname?: string;
+    basePath?: string;
+    existingExpress?: Express;
+    listenCallback?: () => void;
+    startListening?: boolean;
+}
+declare function hasEndpointOpts(opts: any): any;
+type HasEndpointOpts = {
+    endpointOpts?: IEndpointOpts & SingleEndpoints;
+} & Record<string, any>;
+type SingleEndpoints = Record<string, ISingleEndpointOpts | any>;
+interface IEndpointOpts {
+    basePath?: string;
+    baseUrl?: string | URL;
+    globalAuth?: GenericAuthArgs;
+}
+interface ExpressSupport {
+    express: Express;
+    port: number;
+    hostname: string;
+    userIsInRole?: string | string[];
+    startListening: boolean;
+    server?: http.Server;
+    enforcer?: Enforcer;
+    start: (opts?: {
+        disableErrorHandler?: boolean;
+        doNotStartListening?: boolean;
+    }) => {
+        server: http.Server;
+        terminator: HttpTerminator;
+    };
+    stop: (terminator?: HttpTerminator) => Promise<boolean>;
+}
+interface ISingleEndpointOpts extends GenericAuthArgs {
+    endpoint?: EndpointArgs;
+    enabled?: boolean;
+    path?: string;
+    disableGlobalAuth?: boolean;
+}
+interface GenericAuthArgs {
+    authentication?: {
+        callback?: AuthenticateCallback | ((...args: any[]) => any);
+        useDefaultCallback?: boolean;
+        enabled?: boolean;
+        strategy?: string | string[] | Strategy;
+        strategyOptions?: Record<string, any> | any;
+        authInfo?: boolean;
+        session?: boolean;
+    };
+    authorization?: {
+        enabled?: boolean;
+        requireUserInRoles?: string | string[];
+        enforcer?: Enforcer;
+    };
+}
+interface EndpointArgs extends GenericAuthArgs {
+    resource?: string;
+    operation?: string;
+    handlers?: RequestHandler<ParamsDictionary, any, any, ParsedQs, Record<string, any>>[];
+}
+interface BearerUser extends Express.User {
+    id: string | number;
+    name?: string;
+    token: string;
+}
+interface IStaticBearerVerifyOptions {
+    message?: string | undefined;
+    scope: string | Array<string>;
+}
+interface ITokenPayload {
+    /** An App ID URI. Identifies the intended recipient of the token. */
+    aud?: string | undefined;
+    /** A security token service(STS) URI. Identifies the STS that constructs and returns the token,
+     * and the Azure AD tenant in which the user was authenticated.*/
+    iss?: string | undefined;
+    /** The identity provider that authenticated the subject of the token*/
+    idp?: string | undefined;
+    /** "Issued At" indicates when the authentication for this token occurred. */
+    iat?: number | undefined;
+    /** The "nbf" (not before) claim identifies the time before which the JWT must not be accepted for processing. */
+    nbf?: number | undefined;
+    /** The "exp" (expiration time) claim identifies the expiration time on or after which the JWT must not be accepted for processing. */
+    exp?: number | undefined;
+    /** An internal claim used by Azure AD to record data for token reuse. */
+    aio?: string | undefined;
+    /** Only present in v1.0 tokens. The "Authentication context class" claim. A value of "0" indicates the end-user authentication did not meet the requirements of ISO/IEC 29115. */
+    acr?: '0' | '1' | undefined;
+    /** Only present in v1.0 tokens. Identifies how the subject of the token was authenticated.  */
+    amr?: string[] | undefined;
+    /** Only present in v1.0 tokens. GUID represents the application ID of the client using the token. */
+    appid?: string | undefined;
+    /** Only present in v2.0 tokens. The application ID of the client using the token. */
+    azp?: string | undefined;
+    /** Only present in v1.0 tokens. Indicates how the client was authenticated. For a public client, the value is "0".
+     * If client ID and client secret are used, the value is "1". If a client certificate was used for authentication, the value is "2". */
+    appidacr?: '0' | '1' | '2' | undefined;
+    /** Only present in v2.0 tokens. Indicates how the client was authenticated.
+     * For a public client, the value is "0". If client ID and client secret are used, the value is "1". If a client certificate was used for authentication, the value is "2". */
+    azpacr?: '0' | '1' | '2' | undefined;
+    /** Only present in v2.0 tokens. The primary username that represents the user. It could be an email address, phone number, or a generic username without a specified format */
+    preferred_username?: string | undefined;
+    /** Provides a human-readable value that identifies the subject of the token.
+     * The value is not guaranteed to be unique, it is mutable, and it's designed to be used only for display purposes. The profile scope is required in order to receive this claim. */
+    name?: string | undefined;
+    /** The set of scopes exposed by your application for which the client application has requested (and received) consent. */
+    scp?: string | undefined;
+    /** The set of permissions exposed by your application that the requesting application has been given permission to call. */
+    roles?: string[] | undefined;
+    /** Provides object IDs that represent the subject's group memberships. */
+    groups?: string | string[] | undefined;
+    /** Denoting the user is in at least one group. */
+    hasgroups?: true | undefined;
+    /** The principal about which the token asserts information, such as the user of an app. This value is immutable and cannot be reassigned or reused.
+     * It can be used to perform authorization checks safely, such as when the token is used to access a resource,
+     * and can be used as a key in database tables. Because the subject is always present in the tokens that Azure AD issues,
+     * we recommend using this value in a general-purpose authorization system. The subject is, however, a pairwise identifier - it is unique to a particular application ID.   */
+    sub?: string | undefined;
+    /** GUID represents a user. This ID uniquely identifies the user across applications. */
+    oid?: string | undefined;
+    /** Represents the Azure AD tenant that the user is from. */
+    tid?: string | undefined;
+    /** Only present in v1.0 tokens. Provides a human readable value that identifies the subject of the token.  */
+    unique_name?: string | undefined;
+    /** An internal claim used by Azure to revalidate tokens. */
+    uti?: string | undefined;
+    /** An internal claim used by Azure to revalidate tokens. */
+    rh?: string | undefined;
+    /** Indicates the version of the access token. */
+    ver?: '1.0' | '2.0' | undefined;
+    /** v1.0 basic claims */
+    /** The IP address the user authenticated from. */
+    ipaddr?: string | undefined;
+    /** In cases where the user has an on-premises authentication, this claim provides their SID. */
+    onprem_sid?: string | undefined;
+    /** Indicates when the user's password expires. */
+    pwd_exp?: number | undefined;
+    /** A URL where users can be sent to reset their password. */
+    pwd_url?: string | undefined;
+    /** Signals if the client is logging in from the corporate network. If they aren't, the claim isn't included. */
+    in_corp?: string | undefined;
+    /** An additional name for the user, separate from first or last name */
+    nickname?: string | undefined;
+    /** Provides the last name, surname, or family name of the user as defined on the user object. */
+    family_name?: string | undefined;
+    /** Provides the first or given name of the user, as set on the user object. */
+    given_name?: string | undefined;
+    /** The username of the user. May be a phone number, email address, or unformatted string. */
+    upn?: string | undefined;
+}
+interface IBaseStrategyOption {
+    identityMetadata: string;
+    clientID: string;
+    isB2C?: boolean | undefined;
+    validateIssuer?: boolean | undefined;
+    issuer?: string | string[] | undefined;
+    loggingLevel?: 'info' | 'warn' | 'error' | undefined;
+    loggingNoPII?: boolean | undefined;
+    clockSkew?: number | undefined;
+}
+interface IBaseStrategyOption {
+    identityMetadata: string;
+    clientID: string;
+    isB2C?: boolean | undefined;
+    validateIssuer?: boolean | undefined;
+    issuer?: string | string[] | undefined;
+    loggingLevel?: 'info' | 'warn' | 'error' | undefined;
+    loggingNoPII?: boolean | undefined;
+    clockSkew?: number | undefined;
+}
+interface IBearerStrategyOption extends IBaseStrategyOption {
+    audience?: string | string[] | undefined;
+    policyName?: String | undefined;
+    allowMultiAudiencesInToken?: boolean | undefined;
+    scope?: string[] | undefined;
+}
+interface IBearerStrategyOptionWithRequest extends IBearerStrategyOption {
+    passReqToCallback: boolean;
+}
+type VerifyBearerFunction = (token: ITokenPayload, done: VerifyCallback) => void;
+interface VerifyCallback {
+    (error: any, user?: any, info?: any): void;
+}
+
+declare class EntraIDAuth {
+    private readonly strategy;
+    private options?;
+    static init(strategy: string): EntraIDAuth;
+    private constructor();
+    withOptions(options: IBearerStrategyOption | IBearerStrategyOptionWithRequest): this;
+    connectPassport(): void;
+}
+
+declare class StaticBearerAuth {
+    private readonly strategy;
+    private static providers;
+    private static verifyOptions;
+    private hashTokens?;
+    static init(strategy: string, provider?: StaticBearerUserProvider): StaticBearerAuth;
+    private constructor();
+    get provider(): StaticBearerUserProvider;
+    withHashTokens(hashTokens: boolean): this;
+    withUsers(users: BearerUser[] | BearerUser): this;
+    addUser(user: BearerUser[] | BearerUser): this;
+    withVerifyOptions(options: IStaticBearerVerifyOptions | string): this;
+    connectPassport(): void;
+}
+interface StaticBearerUserProvider {
+    strategy: string;
+    addUser(user: BearerUser | BearerUser[], hashToken?: boolean): void;
+    getUser(token: string): BearerUser | undefined;
+    hashedTokens?: boolean;
+}
+declare class MapBasedStaticBearerUserProvider implements StaticBearerUserProvider {
+    private readonly _strategy;
+    private readonly _users;
+    private readonly _hashedTokens;
+    constructor(strategy: string, hashedTokens?: boolean);
+    get users(): BearerUser[];
+    get hashedTokens(): boolean;
+    get strategy(): string;
+    getUser(token: string): BearerUser | undefined;
+    addUser(user: BearerUser | BearerUser[], hashToken?: boolean): void;
+    getUsers(): BearerUser[];
+}
+
+declare const checkUserIsInRole: (opts: {
+    roles: string | string[];
+}) => (req: express.Request, res: express.Response, next: NextFunction) => void | express.Response<any, Record<string, any>>;
+declare const checkAuthenticationOnly: (opts?: EndpointArgs) => (req: express.Request, res: express.Response, next: express.NextFunction) => void | express.Response<any, Record<string, any>>;
+declare const checkAuthorizationOnly: (opts?: EndpointArgs) => (req: express.Request, res: express.Response, next: express.NextFunction) => void | express.Response<any, Record<string, any>>;
+declare const isUserNotAuthenticated: (req: express.Request, res: express.Response, next: express.NextFunction) => void;
+declare const isUserAuthenticated: (req: express.Request, res: express.Response, next: express.NextFunction) => void | express.Response<any, Record<string, any>>;
+declare const checkAuth: (opts?: EndpointArgs) => RequestHandler<ParamsDictionary, any, any, ParsedQs, Record<string, any>>[];
+declare function copyGlobalAuthToEndpoint(args?: {
+    opts?: HasEndpointOpts;
+    key: string;
+}): void;
+declare function copyGlobalAuthToEndpoints(args?: {
+    opts?: HasEndpointOpts;
+    keys: string[];
+}): void;
+
+type Handler<Request extends http.IncomingMessage, Response extends http.ServerResponse> = (req: Request, res: Response, callback: (err?: Error) => void) => void;
+declare class ExpressBuilder {
+    private existingExpress?;
+    private hostnameOrIP?;
+    private port?;
+    private _handlers?;
+    private listenCallback?;
+    private _startListen?;
+    private readonly envVarPrefix?;
+    private _corsConfigurer?;
+    private _sessionOpts?;
+    private _usePassportAuth?;
+    private _passportInitOpts?;
+    private _userIsInRole?;
+    private _enforcer?;
+    private _server?;
+    private _terminator?;
+    private _morgan?;
+    private constructor();
+    static fromExistingExpress(opts?: {
+        existingExpress?: Express;
+        envVarPrefix?: string;
+    }): ExpressBuilder;
+    static fromServerOpts(opts: IExpressServerOpts & {
+        envVarPrefix?: string;
+    }): ExpressBuilder;
+    enableListen(startOnBuild?: boolean): this;
+    withMorganLogging(opts?: {
+        existingMorgan?: Handler<any, any>;
+        format?: string;
+        options?: morgan.Options<any, any>;
+    }): this;
+    withEnableListenOpts({ port, hostnameOrIP, callback, startOnBuild, }: {
+        port?: number;
+        hostnameOrIP?: string;
+        startOnBuild?: boolean;
+        callback?: () => void;
+    }): this;
+    withPort(port: number): this;
+    withHostname(hostnameOrIP: string): this;
+    withListenCallback(callback: () => void): this;
+    withExpress(existingExpress: Express): this;
+    withCorsConfigurer(configurer: ExpressCorsConfigurer): this;
+    withPassportAuth(usePassport: boolean, initializeOptions?: InitializeOptions): this;
+    withGlobalUserIsInRole(userIsInRole: string | string[]): this;
+    withEnforcer(enforcer: Enforcer): this;
+    startListening(express: Express): {
+        server: http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
+        terminator: HttpTerminator;
+    };
+    getHostname(): string;
+    getPort(): number;
+    setHandlers(handlers: ApplicationRequestHandler<any> | ApplicationRequestHandler<any>[]): this;
+    addHandler(handler: ApplicationRequestHandler<any>): this;
+    withSessionOptions(sessionOpts: session.SessionOptions): this;
+    build<T extends Application>(opts?: {
+        express?: Express;
+        startListening?: boolean;
+        handlers?: ApplicationRequestHandler<T> | ApplicationRequestHandler<T>[];
+    }): ExpressSupport;
+    protected buildExpress<T extends Application>(opts?: {
+        express?: Express;
+        startListening?: boolean;
+        handlers?: ApplicationRequestHandler<T> | ApplicationRequestHandler<T>[];
+    }): express.Express;
+}
+declare class ExpressCorsConfigurer {
+    private _disableCors?;
+    private _enablePreflightOptions?;
+    private _allowOrigin?;
+    private _allowMethods?;
+    private _allowedHeaders?;
+    private _allowCredentials?;
+    private readonly _express?;
+    private readonly _envVarPrefix?;
+    constructor(args?: {
+        existingExpress?: Express;
+        envVarPrefix?: string;
+    });
+    allowOrigin(value: string | boolean | RegExp | Array<string | boolean | RegExp>): this;
+    disableCors(value: boolean): this;
+    allowMethods(value: string | string[]): this;
+    allowedHeaders(value: string | string[]): this;
+    allowCredentials(value: boolean): this;
+    configure({ existingExpress }: {
+        existingExpress?: Express;
+    }): void;
+}
+
+declare function sendErrorResponse(response: express.Response, statusCode: number, message: string | object, error?: any): express.Response<any, Record<string, any>>;
+declare const jsonErrorHandler: (err: any, req: express.Request, res: express.Response, next: NextFunction) => void | express.Response<any, Record<string, any>>;
+
+declare function env(key?: string, prefix?: string): string | undefined;
+
+declare function oidcDiscoverIssuer(opts?: {
+    issuerUrl?: string;
+}): Promise<{
+    issuer: Issuer<BaseClient>;
+    issuerUrl: string;
+}>;
+declare function oidcGetClient(issuer: Issuer<BaseClient>, metadata: ClientMetadata, opts?: {
+    jwks?: {
+        keys: JsonWebKey[];
+    };
+    options?: ClientOptions;
+}): Promise<BaseClient>;
+declare function getLoginEndpoint(router: Router, opts?: ISingleEndpointOpts & {
+    redirectUrl?: string;
+}): void;
+declare function getLoginCallbackEndpoint(router: Router, opts?: ISingleEndpointOpts): void;
+declare function getLogoutEndpoint(router: Router, client: BaseClient, opts?: ISingleEndpointOpts): void;
+declare function getLogoutCallbackEndpoint(router: Router, opts?: ISingleEndpointOpts): void;
+declare function getIdTokenEndpoint(router: Router, client: BaseClient, opts: ISingleEndpointOpts): void;
+declare function getAuthenticatedUserEndpoint(router: Router, opts?: ISingleEndpointOpts): void;
+interface IAuthenticationOpts {
+    enabledFeatures?: AuthenticationApiFeatures;
+    endpointOpts?: IAuthenticationEndpointOpts;
+}
+interface IAuthenticationEndpointOpts {
+    basePath?: string;
+    globalAuth?: GenericAuthArgs;
+    getAuthenticatedUser?: ISingleEndpointOpts;
+    getLogin?: ISingleEndpointOpts;
+    getLogout?: ISingleEndpointOpts;
+    getIdToken?: ISingleEndpointOpts;
+}
+type AuthenticationApiFeatures = 'login' | 'logout' | 'id-token' | 'authenticated-user';
+declare class OpenIDConnectAuthApi {
+    get router(): express.Router;
+    private readonly _express;
+    private readonly _agent?;
+    private readonly _opts?;
+    private readonly _router;
+    constructor(args: {
+        agent?: TAgent<any>;
+        expressSupport: ExpressSupport;
+        client: BaseClient;
+        opts: IAuthenticationOpts;
+    });
+    get agent(): TAgent<any> | undefined;
+    get opts(): IAuthenticationOpts | undefined;
+    get express(): Express;
+}
+
+export { type AuthenticationApiFeatures, type BearerUser, type EndpointArgs, EntraIDAuth, ExpressBuilder, ExpressCorsConfigurer, type ExpressSupport, type GenericAuthArgs, type HasEndpointOpts, type IAuthenticationEndpointOpts, type IAuthenticationOpts, type IBaseStrategyOption, type IBearerStrategyOption, type IBearerStrategyOptionWithRequest, type IEndpointOpts, type IExpressServerOpts, type ISingleEndpointOpts, type IStaticBearerVerifyOptions, type ITokenPayload, MapBasedStaticBearerUserProvider, OpenIDConnectAuthApi, type SingleEndpoints, StaticBearerAuth, type StaticBearerUserProvider, type VerifyBearerFunction, type VerifyCallback, checkAuth, checkAuthenticationOnly, checkAuthorizationOnly, checkUserIsInRole, copyGlobalAuthToEndpoint, copyGlobalAuthToEndpoints, env, getAuthenticatedUserEndpoint, getIdTokenEndpoint, getLoginCallbackEndpoint, getLoginEndpoint, getLogoutCallbackEndpoint, getLogoutEndpoint, hasEndpointOpts, isUserAuthenticated, isUserNotAuthenticated, jsonErrorHandler, oidcDiscoverIssuer, oidcGetClient, sendErrorResponse };