@frontegg/redux-store 5.61.0 → 6.0.1-alpha.2

package/auth/ActivateState/saga.js

@@ -0,0 +1,187 @@
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+const _excluded = ["callback", "events"],
+      _excluded2 = ["callback"];
+import { call, delay, put, select, takeLeading } from 'redux-saga/effects';
+import { api, ContextHolder } from '@frontegg/rest-api';
+import { actions } from '../reducer';
+import { afterAuthNavigation, getMfaRequiredState, isMfaRequired } from '../LoginState/saga';
+import { UserVeirifedOriginTypes } from '../interfaces';
+import { ActivateAccountStep } from './interfaces';
+
+function* preActivateAccount({
+  payload: {
+    userId,
+    token
+  }
+}) {
+  yield put(actions.setActivateState({
+    loading: true,
+    step: ActivateAccountStep.activating
+  }));
+
+  try {
+    const {
+      isAuthenticated
+    } = yield select(state => state.auth);
+
+    if (isAuthenticated) {
+      yield put(actions.silentLogout());
+    }
+
+    const strategy = yield call(api.auth.getActivateAccountStrategy, {
+      userId,
+      token
+    });
+    yield put(actions.setActivateStrategyState({
+      strategy,
+      loading: false,
+      error: undefined
+    }));
+
+    if (strategy.shouldSetPassword) {
+      yield put(actions.setActivateState({
+        loading: false,
+        step: ActivateAccountStep.activatingForm
+      }));
+    }
+  } catch (e) {
+    yield put(actions.setActivateState({
+      loading: false,
+      error: e.message
+    }));
+  }
+}
+
+function* activateAccount(_ref) {
+  let {
+    payload: {
+      callback,
+      events
+    }
+  } = _ref,
+      payload = _objectWithoutPropertiesLoose(_ref.payload, _excluded);
+
+  yield put(actions.setActivateState({
+    loading: true
+  }));
+
+  try {
+    const onRedirectTo = ContextHolder.onRedirectTo;
+    const {
+      routes
+    } = yield select(state => state.auth);
+    const data = yield call(api.auth.activateAccount, payload);
+
+    if (data.redirectLocation) {
+      window.location.href = data.redirectLocation;
+      return;
+    }
+
+    if (isMfaRequired(data)) {
+      yield put(actions.setActivateState({
+        step: ActivateAccountStep.success
+      }));
+      const mfaRequiredState = yield getMfaRequiredState(data);
+      yield put(actions.setState(mfaRequiredState));
+      yield delay(1000);
+      onRedirectTo(routes.loginUrl, {
+        preserveQueryParams: true
+      });
+    } else {
+      var _events$userVerified;
+
+      yield put(actions.setActivateState({
+        step: ActivateAccountStep.success
+      }));
+      const {
+        user,
+        tenants
+      } = yield call(api.auth.generateLoginResponseV2, data);
+      events == null ? void 0 : (_events$userVerified = events.userVerified) == null ? void 0 : _events$userVerified.call(events, {
+        email: user.email,
+        origin: UserVeirifedOriginTypes.ACTIVATION_LINK,
+        id: user.id,
+        tenantId: user.tenantId,
+        name: user.name,
+        createdAt: new Date()
+      });
+      yield put(actions.setTenantsState({
+        tenants,
+        loading: false
+      }));
+      yield put(actions.setState({
+        user,
+        isAuthenticated: true
+      }));
+      yield delay(1000);
+      yield afterAuthNavigation();
+      yield put(actions.resetActivateState());
+    }
+
+    callback == null ? void 0 : callback(true);
+  } catch (e) {
+    yield put(actions.setActivateState({
+      loading: false,
+      error: e.message
+    }));
+  }
+}
+
+function* getActivateAccountStrategy({
+  payload
+}) {
+  const {
+    callback
+  } = payload,
+        params = _objectWithoutPropertiesLoose(payload, _excluded2);
+
+  yield put(actions.setActivateStrategyState({
+    loading: true
+  }));
+
+  try {
+    const strategy = yield call(api.auth.getActivateAccountStrategy, params);
+    yield put(actions.setActivateStrategyState({
+      strategy,
+      loading: false,
+      error: undefined
+    }));
+    callback == null ? void 0 : callback(strategy);
+  } catch (e) {
+    yield put(actions.setActivateStrategyState({
+      loading: false,
+      error: e.message
+    }));
+  }
+}
+
+function* resendActivationEmailFunction({
+  payload
+}) {
+  yield put(actions.setActivateState({
+    loading: true
+  }));
+
+  try {
+    yield call(api.auth.resendActivationEmail, {
+      email: payload.email
+    });
+    yield put(actions.setActivateState({
+      loading: false,
+      error: undefined,
+      resentEmail: true
+    }));
+  } catch (e) {
+    yield put(actions.setActivateState({
+      loading: false,
+      error: e.message
+    }));
+  }
+}
+
+export function* activateSagas() {
+  yield takeLeading(actions.activateAccount, activateAccount);
+  yield takeLeading(actions.preActivateAccount, preActivateAccount);
+  yield takeLeading(actions.getActivateAccountStrategy, getActivateAccountStrategy);
+  yield takeLeading(actions.resendActivationEmail, resendActivationEmailFunction);
+}

package/auth/ApiTokensState/index.d.ts

@@ -1,119 +1,119 @@
-import { ApiTokensState, ApiStateIndicator, ApiTokenType, AddTenantApiTokenPayload, AddUserApiTokenPayload, ITenantApiTokensData } from './interfaces';
-import { WithCallback, WithSilentLoad } from '../../interfaces';
-declare const apiTokensState: ApiTokensState;
-declare const reducers: {
-    setApiTokensLoader: {
-        prepare: (payload: ApiStateIndicator) => {
-            payload: ApiStateIndicator;
-        };
-        reducer: (state: import("..").AuthState, { payload }: {
-            payload: ApiStateIndicator;
-            type: string;
-        }) => import("..").AuthState;
-    };
-    setApiTokensError: {
-        prepare: (payload: ApiStateIndicator) => {
-            payload: ApiStateIndicator;
-        };
-        reducer: (state: import("..").AuthState, { payload }: {
-            payload: ApiStateIndicator;
-            type: string;
-        }) => import("..").AuthState;
-    };
-    setApiTokensState: {
-        prepare: (payload: Partial<ApiTokensState>) => {
-            payload: Partial<ApiTokensState>;
-        };
-        reducer: (state: import("..").AuthState, { payload }: {
-            payload: Partial<ApiTokensState>;
-            type: string;
-        }) => {
-            onRedirectTo: (path: string, opts?: import("@frontegg/rest-api").RedirectOptions | undefined) => void;
-            error?: any;
-            isAuthenticated: boolean;
-            isLoading: boolean;
-            keepSessionAlive?: boolean | undefined;
-            user?: import("..").User | null | undefined;
-            isSSOAuth: boolean;
-            ssoACS?: string | undefined;
-            loginState: import("..").LoginState;
-            activateState: import("..").ActivateAccountState;
-            acceptInvitationState: import("..").AcceptInvitationState;
-            forgotPasswordState: import("..").ForgotPasswordState;
-            resetPhoneNumberState: import("..").ResetPhoneNumberState;
-            ssoState: import("..").SSOState;
-            profileState: import("..").ProfileState;
-            mfaState: import("..").MFAState;
-            teamState: import("..").TeamState;
-            socialLoginState: import("..").SocialLoginState;
-            signUpState: import("..").SignUpState;
-            apiTokensState: ApiTokensState;
-            securityPolicyState: import("..").SecurityPolicyState;
-            accountSettingsState: import("..").AccountSettingsState;
-            tenantsState: import("..").TenantsState;
-            rolesState: import("..").RolesState;
-            routes: import("..").AuthPageRoutes;
-            header?: any;
-            loaderComponent?: any;
-        };
-    };
-    resetApiTokensState: (state: import("..").AuthState) => {
-        onRedirectTo: (path: string, opts?: import("@frontegg/rest-api").RedirectOptions | undefined) => void;
-        error?: any;
-        isAuthenticated: boolean;
-        isLoading: boolean;
-        keepSessionAlive?: boolean | undefined;
-        user?: import("..").User | null | undefined;
-        isSSOAuth: boolean;
-        ssoACS?: string | undefined;
-        loginState: import("..").LoginState;
-        activateState: import("..").ActivateAccountState;
-        acceptInvitationState: import("..").AcceptInvitationState;
-        forgotPasswordState: import("..").ForgotPasswordState;
-        resetPhoneNumberState: import("..").ResetPhoneNumberState;
-        ssoState: import("..").SSOState;
-        profileState: import("..").ProfileState;
-        mfaState: import("..").MFAState;
-        teamState: import("..").TeamState;
-        socialLoginState: import("..").SocialLoginState;
-        signUpState: import("..").SignUpState;
-        apiTokensState: ApiTokensState;
-        securityPolicyState: import("..").SecurityPolicyState;
-        accountSettingsState: import("..").AccountSettingsState;
-        tenantsState: import("..").TenantsState;
-        rolesState: import("..").RolesState;
-        routes: import("..").AuthPageRoutes;
-        header?: any;
-        loaderComponent?: any;
-    };
-};
-declare const actions: {
-    loadApiTokens: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[(WithSilentLoad<{
-        callback?: ((data: boolean | null, error?: string | undefined) => void) | undefined;
-    }> | undefined)?], WithSilentLoad<{
-        callback?: ((data: boolean | null, error?: string | undefined) => void) | undefined;
-    }> | undefined, string, never, never>;
-    initApiTokensData: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[ApiTokenType], ApiTokenType, string, never, never>;
-    addTenantApiToken: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[WithCallback<Pick<ITenantApiTokensData, "description" | "roleIds">, boolean>], WithCallback<Pick<ITenantApiTokensData, "description" | "roleIds">, boolean>, string, never, never>;
-    addUserApiToken: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[WithCallback<Pick<import("./interfaces").IApiTokensData, "description">, boolean>], WithCallback<Pick<import("./interfaces").IApiTokensData, "description">, boolean>, string, never, never>;
-    deleteUserApiToken: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[string], string, string, never, never>;
-    deleteTenantApiToken: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[string], string, string, never, never>;
-};
-/**
- *  To be used for actions types after dispatch, and should contains
- *  the reducers and actions as standalone function
- */
-declare type DispatchedActions = {
-    setApiTokensLoader: (payload: ApiStateIndicator) => void;
-    setApiTokensError: (payload: ApiStateIndicator) => void;
-    setApiTokensState: (state: Partial<ApiTokensState>) => void;
-    resetApiTokensState: () => void;
-    loadApiTokens: (payload?: WithSilentLoad<WithCallback>) => void;
-    initApiTokensData: (payload: ApiTokenType) => void;
-    addTenantApiToken: (payload: AddTenantApiTokenPayload) => void;
-    addUserApiToken: (payload: AddUserApiTokenPayload) => void;
-    deleteUserApiToken: (payload: string) => void;
-    deleteTenantApiToken: (payload: string) => void;
-};
-export declare type ApiTokensActions = DispatchedActions;
-export { apiTokensState, reducers as apiTokensReducers, actions as apiTokensActions };
+import { ApiTokensState, ApiStateIndicator, ApiTokenType, AddTenantApiTokenPayload, AddUserApiTokenPayload, ITenantApiTokensData } from './interfaces';
+import { WithCallback, WithSilentLoad } from '../../interfaces';
+declare const apiTokensState: ApiTokensState;
+declare const reducers: {
+    setApiTokensLoader: {
+        prepare: (payload: ApiStateIndicator) => {
+            payload: ApiStateIndicator;
+        };
+        reducer: (state: import("..").AuthState, { payload }: {
+            payload: ApiStateIndicator;
+            type: string;
+        }) => import("..").AuthState;
+    };
+    setApiTokensError: {
+        prepare: (payload: ApiStateIndicator) => {
+            payload: ApiStateIndicator;
+        };
+        reducer: (state: import("..").AuthState, { payload }: {
+            payload: ApiStateIndicator;
+            type: string;
+        }) => import("..").AuthState;
+    };
+    setApiTokensState: {
+        prepare: (payload: Partial<ApiTokensState>) => {
+            payload: Partial<ApiTokensState>;
+        };
+        reducer: (state: import("..").AuthState, { payload }: {
+            payload: Partial<ApiTokensState>;
+            type: string;
+        }) => {
+            onRedirectTo: (path: string, opts?: import("@frontegg/rest-api").RedirectOptions | undefined) => void;
+            error?: any;
+            isAuthenticated: boolean;
+            isLoading: boolean;
+            keepSessionAlive?: boolean | undefined;
+            user?: import("..").User | null | undefined;
+            isSSOAuth: boolean;
+            ssoACS?: string | undefined;
+            loginState: import("..").LoginState;
+            activateState: import("..").ActivateAccountState;
+            acceptInvitationState: import("..").AcceptInvitationState;
+            forgotPasswordState: import("..").ForgotPasswordState;
+            resetPhoneNumberState: import("..").ResetPhoneNumberState;
+            ssoState: import("..").SSOState;
+            profileState: import("..").ProfileState;
+            mfaState: import("..").MFAState;
+            teamState: import("..").TeamState;
+            socialLoginState: import("..").SocialLoginState;
+            signUpState: import("..").SignUpState;
+            apiTokensState: ApiTokensState;
+            securityPolicyState: import("..").SecurityPolicyState;
+            accountSettingsState: import("..").AccountSettingsState;
+            tenantsState: import("..").TenantsState;
+            rolesState: import("..").RolesState;
+            routes: import("..").AuthPageRoutes;
+            header?: any;
+            loaderComponent?: any;
+        };
+    };
+    resetApiTokensState: (state: import("..").AuthState) => {
+        onRedirectTo: (path: string, opts?: import("@frontegg/rest-api").RedirectOptions | undefined) => void;
+        error?: any;
+        isAuthenticated: boolean;
+        isLoading: boolean;
+        keepSessionAlive?: boolean | undefined;
+        user?: import("..").User | null | undefined;
+        isSSOAuth: boolean;
+        ssoACS?: string | undefined;
+        loginState: import("..").LoginState;
+        activateState: import("..").ActivateAccountState;
+        acceptInvitationState: import("..").AcceptInvitationState;
+        forgotPasswordState: import("..").ForgotPasswordState;
+        resetPhoneNumberState: import("..").ResetPhoneNumberState;
+        ssoState: import("..").SSOState;
+        profileState: import("..").ProfileState;
+        mfaState: import("..").MFAState;
+        teamState: import("..").TeamState;
+        socialLoginState: import("..").SocialLoginState;
+        signUpState: import("..").SignUpState;
+        apiTokensState: ApiTokensState;
+        securityPolicyState: import("..").SecurityPolicyState;
+        accountSettingsState: import("..").AccountSettingsState;
+        tenantsState: import("..").TenantsState;
+        rolesState: import("..").RolesState;
+        routes: import("..").AuthPageRoutes;
+        header?: any;
+        loaderComponent?: any;
+    };
+};
+declare const actions: {
+    loadApiTokens: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[(WithSilentLoad<{
+        callback?: ((data: boolean | null, error?: string | undefined) => void) | undefined;
+    }> | undefined)?], WithSilentLoad<{
+        callback?: ((data: boolean | null, error?: string | undefined) => void) | undefined;
+    }> | undefined, string, never, never>;
+    initApiTokensData: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[ApiTokenType], ApiTokenType, string, never, never>;
+    addTenantApiToken: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[WithCallback<Pick<ITenantApiTokensData, "description" | "roleIds">, boolean>], WithCallback<Pick<ITenantApiTokensData, "description" | "roleIds">, boolean>, string, never, never>;
+    addUserApiToken: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[WithCallback<Pick<import("./interfaces").IApiTokensData, "description">, boolean>], WithCallback<Pick<import("./interfaces").IApiTokensData, "description">, boolean>, string, never, never>;
+    deleteUserApiToken: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[string], string, string, never, never>;
+    deleteTenantApiToken: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[string], string, string, never, never>;
+};
+/**
+ *  To be used for actions types after dispatch, and should contains
+ *  the reducers and actions as standalone function
+ */
+declare type DispatchedActions = {
+    setApiTokensLoader: (payload: ApiStateIndicator) => void;
+    setApiTokensError: (payload: ApiStateIndicator) => void;
+    setApiTokensState: (state: Partial<ApiTokensState>) => void;
+    resetApiTokensState: () => void;
+    loadApiTokens: (payload?: WithSilentLoad<WithCallback>) => void;
+    initApiTokensData: (payload: ApiTokenType) => void;
+    addTenantApiToken: (payload: AddTenantApiTokenPayload) => void;
+    addUserApiToken: (payload: AddUserApiTokenPayload) => void;
+    deleteUserApiToken: (payload: string) => void;
+    deleteTenantApiToken: (payload: string) => void;
+};
+export declare type ApiTokensActions = DispatchedActions;
+export { apiTokensState, reducers as apiTokensReducers, actions as apiTokensActions };

package/auth/ApiTokensState/index.js

@@ -0,0 +1,54 @@
+import { createAction } from '@reduxjs/toolkit';
+import { resetStateByKey, typeReducerForKey, loadersReducerForKey, errorsReducerForKey } from '../utils';
+import { authStoreName } from '../../constants';
+const apiTokensState = {
+  apiTokenType: null,
+  searchValue: '',
+  showAddTokenDialog: false,
+  createdByUserIdColumn: 'show',
+  deleteTokenDialog: {
+    open: false,
+    clientId: ''
+  },
+  successDialog: {
+    open: false,
+    secret: '',
+    clientId: ''
+  },
+  loaders: {},
+  apiTokensDataTenant: [],
+  apiTokensDataUser: [],
+  roles: [],
+  permissions: [],
+  errors: {}
+};
+const reducers = {
+  setApiTokensLoader: loadersReducerForKey('apiTokensState'),
+  setApiTokensError: errorsReducerForKey('apiTokensState'),
+  setApiTokensState: typeReducerForKey('apiTokensState'),
+  resetApiTokensState: resetStateByKey('apiTokensState', {
+    apiTokensState
+  })
+};
+const actions = {
+  loadApiTokens: createAction(`${authStoreName}/loadApiTokens`, payload => ({
+    payload
+  })),
+  initApiTokensData: createAction(`${authStoreName}/initApiTokensData`, payload => ({
+    payload
+  })),
+  addTenantApiToken: createAction(`${authStoreName}/addTenantApiToken`, payload => ({
+    payload
+  })),
+  addUserApiToken: createAction(`${authStoreName}/addUserApiToken`, payload => ({
+    payload
+  })),
+  deleteUserApiToken: createAction(`${authStoreName}/deleteUserApiToken`, payload => ({
+    payload
+  })),
+  deleteTenantApiToken: createAction(`${authStoreName}/deleteTenantApiToken`, payload => ({
+    payload
+  }))
+};
+const Matcher = {};
+export { apiTokensState, reducers as apiTokensReducers, actions as apiTokensActions };

package/auth/ApiTokensState/interfaces.d.ts

@@ -1,49 +1,49 @@
-import { ITeamUserPermission, ITeamUserRole } from '@frontegg/rest-api';
-import { LoaderIndicatorState, WithCallback } from '../../interfaces';
-export interface ApiTokensState {
-    loaders: LoaderIndicatorState<ApiStateKeys>;
-    searchValue: string;
-    apiTokensDataTenant: ITenantApiTokensData[];
-    apiTokensDataUser: IApiTokensData[];
-    showAddTokenDialog: boolean;
-    createdByUserIdColumn?: createdByUserIdColumn;
-    deleteTokenDialog: {
-        open: boolean;
-        clientId: string;
-    };
-    successDialog: {
-        open: boolean;
-        secret?: string;
-        clientId?: string;
-    };
-    apiTokenType: ApiTokenType;
-    roles: ITeamUserRole[];
-    permissions: ITeamUserPermission[];
-    errors?: any;
-}
-export declare type ApiTokenType = 'user' | 'tenant' | null;
-export declare type createdByUserIdColumn = 'show' | 'hide' | undefined;
-export interface IApiTokensData {
-    clientId: string;
-    createdAt: string;
-    secret?: string;
-    description: string;
-    metadata?: {};
-}
-export declare type IUserApiTokensData = IApiTokensData;
-export interface ITenantApiTokensData extends IApiTokensData {
-    roleIds: string[];
-    tenantId: string;
-    createdByUserId: string;
-}
-export declare type ApiStateIndicator = {
-    key: ApiStateKeys;
-    value: string | boolean;
-};
-export declare enum ApiStateKeys {
-    LOAD_API_TOKENS = "LOAD_API_TOKENS",
-    ADD_API_TOKEN = "ADD_API_TOKEN",
-    DELETE_API_TOKEN = "DELETE_API_TOKEN"
-}
-export declare type AddTenantApiTokenPayload = WithCallback<Pick<ITenantApiTokensData, 'description' | 'roleIds'>>;
-export declare type AddUserApiTokenPayload = WithCallback<Pick<IApiTokensData, 'description'>>;
+import { ITeamUserPermission, ITeamUserRole } from '@frontegg/rest-api';
+import { LoaderIndicatorState, WithCallback } from '../../interfaces';
+export interface ApiTokensState {
+    loaders: LoaderIndicatorState<ApiStateKeys>;
+    searchValue: string;
+    apiTokensDataTenant: ITenantApiTokensData[];
+    apiTokensDataUser: IApiTokensData[];
+    showAddTokenDialog: boolean;
+    createdByUserIdColumn?: createdByUserIdColumn;
+    deleteTokenDialog: {
+        open: boolean;
+        clientId: string;
+    };
+    successDialog: {
+        open: boolean;
+        secret?: string;
+        clientId?: string;
+    };
+    apiTokenType: ApiTokenType;
+    roles: ITeamUserRole[];
+    permissions: ITeamUserPermission[];
+    errors?: any;
+}
+export declare type ApiTokenType = 'user' | 'tenant' | null;
+export declare type createdByUserIdColumn = 'show' | 'hide' | undefined;
+export interface IApiTokensData {
+    clientId: string;
+    createdAt: string;
+    secret?: string;
+    description: string;
+    metadata?: {};
+}
+export declare type IUserApiTokensData = IApiTokensData;
+export interface ITenantApiTokensData extends IApiTokensData {
+    roleIds: string[];
+    tenantId: string;
+    createdByUserId: string;
+}
+export declare type ApiStateIndicator = {
+    key: ApiStateKeys;
+    value: string | boolean;
+};
+export declare enum ApiStateKeys {
+    LOAD_API_TOKENS = "LOAD_API_TOKENS",
+    ADD_API_TOKEN = "ADD_API_TOKEN",
+    DELETE_API_TOKEN = "DELETE_API_TOKEN"
+}
+export declare type AddTenantApiTokenPayload = WithCallback<Pick<ITenantApiTokensData, 'description' | 'roleIds'>>;
+export declare type AddUserApiTokenPayload = WithCallback<Pick<IApiTokensData, 'description'>>;

package/auth/ApiTokensState/interfaces.js

@@ -0,0 +1,7 @@
+export let ApiStateKeys;
+
+(function (ApiStateKeys) {
+  ApiStateKeys["LOAD_API_TOKENS"] = "LOAD_API_TOKENS";
+  ApiStateKeys["ADD_API_TOKEN"] = "ADD_API_TOKEN";
+  ApiStateKeys["DELETE_API_TOKEN"] = "DELETE_API_TOKEN";
+})(ApiStateKeys || (ApiStateKeys = {}));

package/auth/ApiTokensState/saga.d.ts

@@ -1,2 +1,2 @@
-export declare function apiTokensSaga(): Generator<import("redux-saga/effects").ForkEffect<never>, void, unknown>;
-export declare function apiTokensSagaMock(): Generator<import("redux-saga/effects").ForkEffect<never>, void, unknown>;
+export declare function apiTokensSaga(): Generator<import("redux-saga/effects").ForkEffect<never>, void, unknown>;
+export declare function apiTokensSagaMock(): Generator<import("redux-saga/effects").ForkEffect<never>, void, unknown>;