@bitblit/ratchet-warden-common 4.0.1-alpha

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Notes]
+Alpha releases are exactly what they sound like - places where I am trying out new things that aren't ready for prime
+time, but I need published to see how they interact with the rest of my software ecosystem.  If you use an alpha
+package without knowing why it is alpha you'll get exactly what you deserve.
+
+## [Unreleased]
+
+## In Flight
+
+## [0.0.x] - 2018-03-23
+### Initial Release
+- Basic support for Warden, email and text messaging, and a simplified interface for bootstrapping over GraphQL
+

package/License.txt

@@ -0,0 +1,13 @@
+Copyright 2022-2023 Christopher Weiss
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,38 @@
+# @bitblit/ratchet-warden-common
+
+Typescript library to simplify using simplewebauthn and secondary auth methods over GraphQL.
+
+## Introduction
+
+I really like using the [SimpleWebAuthn](https://simplewebauthn.dev/) library for Authentication but it has a couple
+pieces of code that I still end up re-writing over and over - adding the secondary login methods (like single-use
+code sent to email/text) and setting it up to run over GraphQL, which I use regularly and don't really want to 
+add a bunch of special methods when they are boilerplate inside anyway once I nail down storage.
+
+So, Warden handles that stuff for me.  Relies heavily on my [Ratchet](https://github.com/bitblit/Ratchet) library
+for supporting code.
+
+You may wish to read [the changelog](CHANGELOG.md)
+
+## Installation
+
+`yarn install @bitblit/warden`
+
+## Usage
+
+TBD
+
+### Barrel Files
+A Note on barrel files - All of Warden's barrel files are one level down. This is because otherwise everything
+I said above about transitive dependencies gets thrown out the window if you put them all in one big barrel file
+
+# Testing
+
+Ha! No, seriously - all testing is done using Jest.  To run them:
+
+`yarn test`
+
+# Contributing
+
+Pull requests are welcome, although I'm not sure why you'd be interested!
+

package/lib/build/ratchet-warden-common-info.d.ts

@@ -0,0 +1,5 @@
+import { BuildInformation } from '@bitblit/ratchet-common';
+export declare class RatchetWardenCommonInfo {
+    private constructor();
+    static buildInformation(): BuildInformation;
+}

package/lib/client/provider/warden-client-abstract-recent-login-provider.d.ts

@@ -0,0 +1,13 @@
+import { WardenClientRecentLoginProvider } from './warden-client-recent-login-provider.js';
+import { WardenRecentLoginDescriptor } from './warden-recent-login-descriptor.js';
+import { WardenEntrySummary } from '../../common/model/warden-entry-summary.js';
+import { WardenContact } from '../../common/model/warden-contact.js';
+export declare abstract class WardenClientAbstractRecentLoginProvider implements WardenClientRecentLoginProvider {
+    abstract fetchCache(): WardenRecentLoginDescriptor[];
+    abstract updateCache(newValue: WardenRecentLoginDescriptor[]): any;
+    saveRecentLogin(entry: WardenEntrySummary): void;
+    saveNewUser(userId: string, label: string, contact: WardenContact): void;
+    removeUser(userId: string): void;
+    fetchAllLogins(): WardenRecentLoginDescriptor[];
+    clearAllLogins(): void;
+}

package/lib/client/provider/warden-client-current-logged-in-jwt-token-provider.d.ts

@@ -0,0 +1,3 @@
+export interface WardenClientCurrentLoggedInJwtTokenProvider {
+    fetchCurrentLoggedInJwtToken(): string;
+}

package/lib/client/provider/warden-client-local-storage-logged-in-user-provider.d.ts

@@ -0,0 +1,9 @@
+import { WardenLoggedInUserProvider } from './warden-logged-in-user-provider.js';
+import { WardenLoggedInUserWrapper } from './warden-logged-in-user-wrapper.js';
+export declare class WardenClientLocalStorageLoggedInUserProvider<T> implements WardenLoggedInUserProvider<T> {
+    private localStorageKey;
+    constructor(localStorageKey: string);
+    fetchLoggedInUserWrapper(): WardenLoggedInUserWrapper<T>;
+    logOutUser(): void;
+    setLoggedInUserWrapper(wrapper: WardenLoggedInUserWrapper<T>): void;
+}

package/lib/client/provider/warden-client-local-storage-recent-login-provider.d.ts

@@ -0,0 +1,8 @@
+import { WardenRecentLoginDescriptor } from './warden-recent-login-descriptor.js';
+import { WardenClientAbstractRecentLoginProvider } from './warden-client-abstract-recent-login-provider.js';
+export declare class WardenClientLocalStorageRecentLoginProvider extends WardenClientAbstractRecentLoginProvider {
+    private localStorageKey;
+    constructor(localStorageKey: string);
+    fetchCache(): WardenRecentLoginDescriptor[];
+    updateCache(newValue: WardenRecentLoginDescriptor[]): void;
+}

package/lib/client/provider/warden-client-recent-login-provider.d.ts

@@ -0,0 +1,10 @@
+import { WardenRecentLoginDescriptor } from './warden-recent-login-descriptor.js';
+import { WardenEntrySummary } from '../../common/model/warden-entry-summary.js';
+import { WardenContact } from '../../common/model/warden-contact.js';
+export interface WardenClientRecentLoginProvider {
+    saveRecentLogin(entry: WardenEntrySummary): void;
+    saveNewUser(userId: string, label: string, contact: WardenContact): void;
+    removeUser(userId: string): void;
+    fetchAllLogins(): WardenRecentLoginDescriptor[];
+    clearAllLogins(): void;
+}

package/lib/client/provider/warden-client-transient-memory-logged-in-user-provider.d.ts

@@ -0,0 +1,8 @@
+import { WardenLoggedInUserProvider } from './warden-logged-in-user-provider.js';
+import { WardenLoggedInUserWrapper } from './warden-logged-in-user-wrapper.js';
+export declare class WardenClientTransientMemoryLoggedInUserProvider<T> implements WardenLoggedInUserProvider<T> {
+    private wrapper;
+    fetchLoggedInUserWrapper(): WardenLoggedInUserWrapper<T>;
+    logOutUser(): void;
+    setLoggedInUserWrapper(wrapper: WardenLoggedInUserWrapper<T>): void;
+}

package/lib/client/provider/warden-client-transient-memory-recent-login-provider.d.ts

@@ -0,0 +1,7 @@
+import { WardenRecentLoginDescriptor } from './warden-recent-login-descriptor.js';
+import { WardenClientAbstractRecentLoginProvider } from './warden-client-abstract-recent-login-provider.js';
+export declare class WardenClientTransientMemoryRecentLoginProvider extends WardenClientAbstractRecentLoginProvider {
+    private _cache;
+    fetchCache(): WardenRecentLoginDescriptor[];
+    updateCache(newValue: WardenRecentLoginDescriptor[]): void;
+}

package/lib/client/provider/warden-command-exchange-provider.d.ts

@@ -0,0 +1,3 @@
+export interface WardenCommandExchangeProvider {
+    sendCommand(cmdString: string, jwtToken: string): Promise<string>;
+}

package/lib/client/provider/warden-logged-in-user-provider.d.ts

@@ -0,0 +1,6 @@
+import { WardenLoggedInUserWrapper } from './warden-logged-in-user-wrapper.js';
+export interface WardenLoggedInUserProvider<T> {
+    fetchLoggedInUserWrapper(): WardenLoggedInUserWrapper<T>;
+    setLoggedInUserWrapper(wrapper: WardenLoggedInUserWrapper<T>): any;
+    logOutUser(): void;
+}

package/lib/client/provider/warden-logged-in-user-wrapper.d.ts

@@ -0,0 +1,6 @@
+import { WardenJwtToken } from '../../common/model/warden-jwt-token.js';
+export interface WardenLoggedInUserWrapper<T> {
+    userObject: WardenJwtToken<T>;
+    jwtToken: string;
+    expirationEpochSeconds: number;
+}

package/lib/client/provider/warden-recent-login-descriptor.d.ts

@@ -0,0 +1,5 @@
+import { WardenEntrySummary } from '../../common/model/warden-entry-summary.js';
+export interface WardenRecentLoginDescriptor {
+    user: WardenEntrySummary;
+    lastLoginEpochMS: number;
+}

package/lib/client/provider/warden-user-service-event-processing-provider.d.ts

@@ -0,0 +1,8 @@
+import { WardenLoggedInUserWrapper } from './warden-logged-in-user-wrapper.js';
+export interface WardenUserServiceEventProcessingProvider<T> {
+    onLogout(): void;
+    onSuccessfulLogin(newUser: WardenLoggedInUserWrapper<T>): void;
+    onLoginFailure(reason: string): void;
+    onAutomaticTokenRefresh(refreshUser: WardenLoggedInUserWrapper<T>): void;
+    onAutomaticLogout(): void;
+}

package/lib/client/provider/warden-user-service-options.d.ts

@@ -0,0 +1,13 @@
+import { WardenLoggedInUserProvider } from './warden-logged-in-user-provider.js';
+import { WardenClient } from '../warden-client.js';
+import { WardenUserServiceEventProcessingProvider } from './warden-user-service-event-processing-provider.js';
+import { WardenClientRecentLoginProvider } from './warden-client-recent-login-provider.js';
+export interface WardenUserServiceOptions<T> {
+    recentLoginProvider?: WardenClientRecentLoginProvider;
+    loggedInUserProvider: WardenLoggedInUserProvider<T>;
+    wardenClient: WardenClient;
+    eventProcessor: WardenUserServiceEventProcessingProvider<T>;
+    loginCheckTimerPingSeconds?: number;
+    autoLoginHandlingThresholdSeconds?: number;
+    allowAutoRefresh?: boolean;
+}

package/lib/client/warden-client.d.ts

@@ -0,0 +1,27 @@
+import { WardenCommand } from '../common/command/warden-command.js';
+import { WardenContact } from '../common/model/warden-contact.js';
+import { WardenCommandExchangeProvider } from './provider/warden-command-exchange-provider.js';
+import { WardenCommandResponse } from '../common/command/warden-command-response.js';
+import { PublicKeyCredentialCreationOptionsJSON, PublicKeyCredentialRequestOptionsJSON, RegistrationResponseJSON } from '@simplewebauthn/typescript-types';
+import { WardenLoginResults } from '../common/model/warden-login-results.js';
+import { WardenLoginRequest } from '../common/model/warden-login-request.js';
+import { WardenClientCurrentLoggedInJwtTokenProvider } from './provider/warden-client-current-logged-in-jwt-token-provider.js';
+import { WardenEntrySummary } from '../common/model/warden-entry-summary.js';
+export declare class WardenClient {
+    private commandSender;
+    private jwtProvider;
+    constructor(commandSender: WardenCommandExchangeProvider, jwtProvider: WardenClientCurrentLoggedInJwtTokenProvider);
+    exchangeCommand(cmd: WardenCommand, returnErrors?: boolean): Promise<WardenCommandResponse>;
+    createAccount(contact: WardenContact, sendCode?: boolean, label?: string, tags?: string[]): Promise<string>;
+    generateWebAuthnAuthenticationChallengeForUserId(userId: string): Promise<PublicKeyCredentialRequestOptionsJSON>;
+    generateWebAuthnRegistrationChallengeForLoggedInUser(): Promise<PublicKeyCredentialCreationOptionsJSON>;
+    removeWebAuthnRegistration(userId: string, credId: string): Promise<WardenEntrySummary>;
+    removeWebAuthnRegistrationFromLoggedInUser(input: string): Promise<WardenEntrySummary>;
+    removeContactFromLoggedInUser(input: WardenContact): Promise<WardenEntrySummary>;
+    sendExpiringValidationToken(contact: WardenContact): Promise<boolean>;
+    addContactToLoggedInUser(contact: WardenContact): Promise<boolean>;
+    addWebAuthnRegistrationToLoggedInUser(data: RegistrationResponseJSON): Promise<WardenEntrySummary>;
+    performLoginCmd(login: WardenLoginRequest): Promise<WardenLoginResults>;
+    refreshJwtToken(oldJwtToken: string): Promise<string>;
+    executeExpiringTokenBasedLogin(contact: WardenContact, expiringToken: string): Promise<WardenLoginResults>;
+}

package/lib/client/warden-client.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/client/warden-delegating-current-user-providing-user-service-event-processing-provider.d.ts

@@ -0,0 +1,16 @@
+import { WardenUserServiceEventProcessingProvider } from './provider/warden-user-service-event-processing-provider.js';
+import { WardenLoggedInUserWrapper } from './provider/warden-logged-in-user-wrapper.js';
+import { BehaviorSubject } from 'rxjs';
+import { WardenClientCurrentLoggedInJwtTokenProvider } from './provider/warden-client-current-logged-in-jwt-token-provider.js';
+export declare class WardenDelegatingCurrentUserProvidingUserServiceEventProcessingProvider<T> implements WardenUserServiceEventProcessingProvider<T>, WardenClientCurrentLoggedInJwtTokenProvider {
+    private wrapped?;
+    private _currentUserSubject;
+    constructor(wrapped?: WardenUserServiceEventProcessingProvider<T>);
+    fetchCurrentLoggedInJwtToken(): string;
+    get currentUserSubject(): BehaviorSubject<WardenLoggedInUserWrapper<T>>;
+    onAutomaticLogout(): void;
+    onAutomaticTokenRefresh(refreshUser: WardenLoggedInUserWrapper<T>): void;
+    onLoginFailure(reason: string): void;
+    onLogout(): void;
+    onSuccessfulLogin(newUser: WardenLoggedInUserWrapper<T>): void;
+}

package/lib/client/warden-user-service.d.ts

@@ -0,0 +1,41 @@
+import { WardenUserServiceOptions } from './provider/warden-user-service-options.js';
+import { WardenLoggedInUserWrapper } from './provider/warden-logged-in-user-wrapper.js';
+import { WardenContact } from '../common/model/warden-contact.js';
+import { WardenJwtToken } from '../common/model/warden-jwt-token.js';
+import { WardenLoginResults } from '../common/model/warden-login-results.js';
+import { WardenEntrySummary } from '../common/model/warden-entry-summary.js';
+export declare class WardenUserService<T> {
+    private options;
+    private loggedInTimerSubscription;
+    private _autoRefreshEnabled;
+    constructor(options: WardenUserServiceOptions<T>);
+    cleanShutDown(): void;
+    get serviceOptions(): WardenUserServiceOptions<T>;
+    createAccount(contact: WardenContact, sendCode?: boolean, label?: string, tags?: string[]): Promise<string>;
+    addContactToLoggedInUser(contact: WardenContact): Promise<boolean>;
+    get autoRefreshEnabled(): boolean;
+    set autoRefreshEnabled(newValue: boolean);
+    checkForAutoLogoutOrRefresh(t: number): Promise<void>;
+    logout(): void;
+    static wrapperIsExpired(value: WardenLoggedInUserWrapper<any>): boolean;
+    fetchLoggedInUserWrapper(): WardenLoggedInUserWrapper<T>;
+    loggedInUserHasRole(role: string): boolean;
+    isLoggedIn(): boolean;
+    fetchLoggedInUserJwtObject(): WardenJwtToken<T>;
+    fetchLoggedInUserJwtToken(): string;
+    fetchLoggedInUserObject(): T;
+    fetchLoggedInUserExpirationEpochSeconds(): number;
+    fetchLoggedInUserRemainingSeconds(): number;
+    private updateLoggedInUserFromTokenString;
+    refreshToken(): Promise<WardenLoggedInUserWrapper<T>>;
+    sendExpiringCode(contact: WardenContact): Promise<boolean>;
+    private processWardenLoginResults;
+    private updateRecentLoginsFromWardenEntrySummary;
+    private updateRecentLoginsFromLoggedInUserWrapper;
+    executeWebAuthnBasedLogin(userId: string): Promise<WardenLoggedInUserWrapper<T>>;
+    removeWebAuthnRegistrationFromLoggedInUser(input: string): Promise<WardenEntrySummary>;
+    removeContactFromLoggedInUser(input: WardenContact): Promise<WardenEntrySummary>;
+    executeValidationTokenBasedLogin(contact: WardenContact, token: string): Promise<WardenLoggedInUserWrapper<T>>;
+    saveCurrentDeviceAsWebAuthnForCurrentUser(): Promise<WardenEntrySummary>;
+    executeWebAuthnLoginToWardenLoginResults(userId: string): Promise<WardenLoginResults>;
+}

package/lib/client/warden-user-service.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/common/command/create-account.d.ts

@@ -0,0 +1,7 @@
+import { WardenContact } from '../model/warden-contact.js';
+export interface CreateAccount {
+    contact: WardenContact;
+    sendCode?: boolean;
+    label?: string;
+    tags?: string[];
+}

package/lib/common/command/remove-web-authn-registration.d.ts

@@ -0,0 +1,4 @@
+export interface RemoveWebAuthnRegistration {
+    userId: string;
+    credentialId: string;
+}

package/lib/common/command/warden-command-response.d.ts

@@ -0,0 +1,17 @@
+import { WebAuthnObjectWrapper } from './web-authn-object-wrapper.js';
+import { WardenLoginResults } from '../model/warden-login-results.js';
+import { WardenEntrySummary } from '../model/warden-entry-summary.js';
+export interface WardenCommandResponse {
+    createAccount?: string;
+    generateWebAuthnAuthenticationChallengeForUserId?: WebAuthnObjectWrapper;
+    generateWebAuthnRegistrationChallengeForLoggedInUser?: WebAuthnObjectWrapper;
+    removeWebAuthnRegistration?: WardenEntrySummary;
+    sendExpiringValidationToken?: boolean;
+    addWebAuthnRegistrationToLoggedInUser?: WardenEntrySummary;
+    addContactToLoggedInUser?: boolean;
+    performLogin?: WardenLoginResults;
+    refreshJwtToken?: string;
+    removeWebAuthnRegistrationFromLoggedInUser?: WardenEntrySummary;
+    removeContactFromLoggedInUser?: WardenEntrySummary;
+    error?: string;
+}

package/lib/common/command/warden-command.d.ts

@@ -0,0 +1,18 @@
+import { CreateAccount } from './create-account.js';
+import { WardenContact } from '../model/warden-contact.js';
+import { WebAuthnObjectWrapper } from './web-authn-object-wrapper.js';
+import { RemoveWebAuthnRegistration } from './remove-web-authn-registration.js';
+import { WardenLoginRequest } from '../model/warden-login-request.js';
+export interface WardenCommand {
+    createAccount?: CreateAccount;
+    generateWebAuthnAuthenticationChallengeForUserId?: string;
+    generateWebAuthnRegistrationChallengeForLoggedInUser?: boolean;
+    sendExpiringValidationToken?: WardenContact;
+    addWebAuthnRegistrationToLoggedInUser?: WebAuthnObjectWrapper;
+    addContactToLoggedInUser?: WardenContact;
+    removeWebAuthnRegistrationFromLoggedInUser?: string;
+    removeContactFromLoggedInUser?: WardenContact;
+    removeWebAuthnRegistration?: RemoveWebAuthnRegistration;
+    performLogin?: WardenLoginRequest;
+    refreshJwtToken?: string;
+}

package/lib/common/command/web-authn-object-wrapper.d.ts

@@ -0,0 +1,3 @@
+export interface WebAuthnObjectWrapper {
+    dataAsJson: string;
+}

package/lib/common/model/warden-contact-type.d.ts

@@ -0,0 +1,4 @@
+export declare enum WardenContactType {
+    TextCapablePhoneNumber = "TextCapablePhoneNumber",
+    EmailAddress = "EmailAddress"
+}

package/lib/common/model/warden-contact.d.ts

@@ -0,0 +1,5 @@
+import { WardenContactType } from './warden-contact-type.js';
+export interface WardenContact {
+    value: string;
+    type: WardenContactType;
+}

package/lib/common/model/warden-customer-message-type.d.ts

@@ -0,0 +1,3 @@
+export declare enum WardenCustomerMessageType {
+    ExpiringCode = "ExpiringCode"
+}

package/lib/common/model/warden-entry-summary.d.ts

@@ -0,0 +1,7 @@
+import { WardenContact } from './warden-contact.js';
+export interface WardenEntrySummary {
+    userId: string;
+    userLabel: string;
+    contactMethods: WardenContact[];
+    webAuthnAuthenticatorIds: string[];
+}

package/lib/common/model/warden-entry.d.ts

@@ -0,0 +1,11 @@
+import { WardenWebAuthnEntry } from './warden-web-authn-entry.js';
+import { WardenContact } from './warden-contact.js';
+export interface WardenEntry {
+    userId: string;
+    userLabel: string;
+    contactMethods: WardenContact[];
+    tags: string[];
+    webAuthnAuthenticators: WardenWebAuthnEntry[];
+    createdEpochMS: number;
+    updatedEpochMS: number;
+}

package/lib/common/model/warden-jwt-token.d.ts

@@ -0,0 +1,5 @@
+import { CommonJwtToken } from '@bitblit/ratchet-common';
+import { WardenEntrySummary } from './warden-entry-summary.js';
+export interface WardenJwtToken<T> extends CommonJwtToken<T> {
+    loginData: WardenEntrySummary;
+}

package/lib/common/model/warden-login-request.d.ts

@@ -0,0 +1,9 @@
+import { WardenContact } from './warden-contact.js';
+import { AuthenticationResponseJSON } from '@simplewebauthn/typescript-types';
+export interface WardenLoginRequest {
+    userId?: string;
+    contact?: WardenContact;
+    webAuthn?: AuthenticationResponseJSON;
+    expiringToken?: string;
+    jwtTokenToRefresh?: string;
+}

package/lib/common/model/warden-login-results.d.ts

@@ -0,0 +1,7 @@
+import { WardenLoginRequest } from './warden-login-request.js';
+export interface WardenLoginResults {
+    request: WardenLoginRequest;
+    userId?: string;
+    jwtToken?: string;
+    error?: string;
+}

package/lib/common/model/warden-store-registration-response-type.d.ts

@@ -0,0 +1,5 @@
+export declare enum WardenStoreRegistrationResponseType {
+    Verified = "Verified",
+    Failed = "Failed",
+    Error = "Error"
+}

package/lib/common/model/warden-store-registration-response.d.ts

@@ -0,0 +1,8 @@
+import { WardenStoreRegistrationResponseType } from './warden-store-registration-response-type.js';
+import { WardenEntry } from './warden-entry.js';
+export interface WardenStoreRegistrationResponse {
+    updatedEntry?: WardenEntry;
+    registrationResponseId: string;
+    result: WardenStoreRegistrationResponseType;
+    error?: string;
+}

package/lib/common/model/warden-team-role.d.ts

@@ -0,0 +1,4 @@
+export interface WardenTeamRole {
+    team: string;
+    role: string;
+}

package/lib/common/model/warden-user-decoration.d.ts

@@ -0,0 +1,6 @@
+import { WardenTeamRole } from './warden-team-role.js';
+export interface WardenUserDecoration<T> {
+    userTokenData: T;
+    userTokenExpirationSeconds: number;
+    userTeamRoles: WardenTeamRole[];
+}

package/lib/common/model/warden-web-authn-entry.d.ts

@@ -0,0 +1,9 @@
+import { WardenWebAuthnTransportFutureType } from './warden-web-authn-transport-future-type.js';
+export interface WardenWebAuthnEntry {
+    credentialIdBase64: string;
+    credentialPublicKeyBase64: string;
+    counter: number;
+    credentialBackedUp: boolean;
+    credentialDeviceType: string;
+    transports?: WardenWebAuthnTransportFutureType[];
+}

package/lib/common/model/warden-web-authn-transport-future-type.d.ts

@@ -0,0 +1,8 @@
+export declare enum WardenWebAuthnTransportFutureType {
+    ble = "ble",
+    internal = "internal",
+    nfc = "nfc",
+    usb = "usb",
+    cable = "cable",
+    hybrid = "hybrid"
+}

package/lib/common/util/warden-utils.d.ts

@@ -0,0 +1,21 @@
+import { WardenContact } from '../model/warden-contact.js';
+import { WardenContactType } from '../model/warden-contact-type.js';
+import { WardenEntrySummary } from '../model/warden-entry-summary.js';
+import { WardenEntry } from '../model/warden-entry.js';
+import { WardenLoginRequest } from '../model/warden-login-request.js';
+import { WardenTeamRole } from '../model/warden-team-role.js';
+export declare class WardenUtils {
+    constructor();
+    static extractContactsOfType(req: WardenEntry | WardenEntrySummary, type: WardenContactType): string[];
+    static validLoginRequest(req: WardenLoginRequest): boolean;
+    static stringToWardenContact(input: string): WardenContact;
+    static teamRolesToRoles(teamRoles: WardenTeamRole[]): string[];
+    static roleStringsToTeamRoles(roles: string[]): WardenTeamRole[];
+    static roleStringToTeamRole(role: string): WardenTeamRole;
+    static teamRoleToRoleString(tr: WardenTeamRole): string;
+    static stringToContactType(input: string): WardenContactType;
+    static validContact(contact: WardenContact): boolean;
+    static stringIsEmailAddress(value: string): boolean;
+    static stringIsPhoneNumber(value: string): boolean;
+    static stripWardenEntryToSummary(we: WardenEntry): WardenEntrySummary;
+}

package/lib/common/util/warden-utils.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/index.d.ts

@@ -0,0 +1,37 @@
+export * from './build/ratchet-warden-common-info.js';
+export * from './client/warden-client.js';
+export * from './client/warden-delegating-current-user-providing-user-service-event-processing-provider.js';
+export * from './client/warden-user-service.js';
+export * from './client/provider/warden-client-abstract-recent-login-provider.js';
+export * from './client/provider/warden-client-current-logged-in-jwt-token-provider.js';
+export * from './client/provider/warden-client-local-storage-logged-in-user-provider.js';
+export * from './client/provider/warden-client-local-storage-recent-login-provider.js';
+export * from './client/provider/warden-client-recent-login-provider.js';
+export * from './client/provider/warden-client-transient-memory-logged-in-user-provider.js';
+export * from './client/provider/warden-client-transient-memory-recent-login-provider.js';
+export * from './client/provider/warden-command-exchange-provider.js';
+export * from './client/provider/warden-logged-in-user-provider.js';
+export * from './client/provider/warden-logged-in-user-wrapper.js';
+export * from './client/provider/warden-recent-login-descriptor.js';
+export * from './client/provider/warden-user-service-event-processing-provider.js';
+export * from './client/provider/warden-user-service-options.js';
+export * from './common/command/create-account.js';
+export * from './common/command/remove-web-authn-registration.js';
+export * from './common/command/warden-command-response.js';
+export * from './common/command/warden-command.js';
+export * from './common/command/web-authn-object-wrapper.js';
+export * from './common/model/warden-contact-type.js';
+export * from './common/model/warden-contact.js';
+export * from './common/model/warden-customer-message-type.js';
+export * from './common/model/warden-entry-summary.js';
+export * from './common/model/warden-entry.js';
+export * from './common/model/warden-jwt-token.js';
+export * from './common/model/warden-login-request.js';
+export * from './common/model/warden-login-results.js';
+export * from './common/model/warden-store-registration-response-type.js';
+export * from './common/model/warden-store-registration-response.js';
+export * from './common/model/warden-team-role.js';
+export * from './common/model/warden-user-decoration.js';
+export * from './common/model/warden-web-authn-entry.js';
+export * from './common/model/warden-web-authn-transport-future-type.js';
+export * from './common/util/warden-utils.js';