@elliemae/pui-scripting-object 1.8.0 → 1.10.0

package/dist/types/objects/http.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Provides methods to make call-outs to to external systems via HTTPS.
+ * By exposing this object from the host, it ensures that the call will bear the "Origin" header of the host application.
+ * This is critical for situations where the guest's code is running in a strict-mode sandbox (where the "allowSameOrigin" flag is false).
+ */
+export interface IHttp {
+    /**
+     * get http request
+     *
+     * @param url url to make the call to
+     * @param headersOrAccessToken http headers object or access token to be used for the call
+     * @returns http response object
+     * @throws error if the http call fails with non 2xx status code
+     */
+    get(url: string, headersOrAccessToken?: HeadersInit | string): Promise<Response>;
+    /**
+     * post http request
+     *
+     * @param url url to make the call to
+     * @param headersOrAccessToken http headers object or access token to be used for the call
+     * @returns http response object
+     * @throws error if the http call fails with non 2xx status code
+     */
+    post(url: string, content: string | Record<string, string>, headersOrAccessToken?: HeadersInit | string): Promise<Response>;
+    /**
+     * patch http request
+     *
+     * @param url url to make the call to
+     * @param headersOrAccessToken http headers object or access token to be used for the call
+     * @returns http response object
+     * @throws error if the http call fails with non 2xx status code
+     */
+    patch(url: string, content: string | Record<string, string>, headersOrAccessToken?: HeadersInit | string): Promise<Response>;
+    /**
+     * put http request
+     *
+     * @param url url to make the call to
+     * @param headersOrAccessToken http headers object or access token to be used for the call
+     * @returns http response object
+     * @throws error if the http call fails with non 2xx status code
+     */
+    put(url: string, content: string | Record<string, string>, headersOrAccessToken?: HeadersInit | string): Promise<Response>;
+    /**
+     * delete http request
+     *
+     * @param url url to make the call to
+     * @param headersOrAccessToken http headers object or access token to be used for the call
+     * @returns http response object
+     * @throws error if the http call fails with non 2xx status code
+     */
+    delete(url: string, headersOrAccessToken?: HeadersInit | string): Promise<Response>;
+}

package/dist/types/{loan.d.ts → objects/loan.d.ts}

@@ -11,6 +11,9 @@ export declare type FieldOptions = {
      */
     value: string;
 };
+/**
+ * v3 loan object
+ */
 export declare type LoanObject = Record<string, any>;
 export declare enum LoanLevelActions {
     UPDATE_CORRESPONDENT_BALANCE = "updateCorrespondentBalance",
@@ -19,11 +22,11 @@ export declare enum LoanLevelActions {
     CALCULATE_EEM_MORTGAGE = "calculateEEMMortgage"
 }
 /**
- * The Loan object provides methods for interacting with an open loan in the application's editor screen(s).
+ * Methods for interacting with an open loan in the application
  */
 export interface ILoan {
     /**
-     * Get entire Loan object
+     * Get complete Loan object
      *
      * @returns v3 Loan Object
      *
@@ -46,6 +49,12 @@ export interface ILoan {
      * | all |  ✔ |  ✔ |  ✔ |  ✖️ |
      */
     commit(): Promise<void>;
+    /**
+     * get value of the given field id
+     *
+     * @param id field id
+     * @returns field value
+     */
     getField(id: string): Promise<string>;
     /**
      * get options for list of fields
@@ -135,38 +144,93 @@ export interface ILoan {
     getLockSnapshot(): Promise<Record<string, string>>;
 }
 /**
- * This event is fired prior to saving and pending changes to the loan. The guest can use this event to perform custom validation and, via the feedback mechanism, prevent the loan from being saved
+ * event handler for loan precommit event
+ *
+ * @param cause cause of precommit event
+ * @returns true if precommit is allowed, false otherwise
  */
 export declare type LoanPreCommitListener = (cause: string) => boolean;
 /**
- * This event is fired after pending changes to the loan are committed
+ * event handler for loan commited event
+ *
+ * @param cause cause of commit event
  */
 export declare type LoanCommittedListener = (cause: string) => void;
 /**
- * This event is fired for each change made by the user in the UI
+ * event handler for loan data change event
  */
 export declare type LoanChangeListener = () => void;
 /**
- * This event is fired after the loan is sync'ed within any saved state made outside of the user's workspace. This event should fire after any call to calculate() or merge(), assuming any changes are made to the loan
+ * event handler for loan sync event
  */
 export declare type LoanSyncListener = () => void;
 /**
- * Fired after the loan is opened and ready for user interaction
+ * event handler for loan open event
  */
 export declare type LoanOpenListener = () => void;
 /**
- * Fired just prior to closing the loan in the UI
+ * event handler for loan close event
+ *
+ * @returns true if loan close is allowed, false otherwise
  */
 export declare type LoanCloseListener = () => boolean;
 /**
- * This event is fired after a milestone is completed by the user and committed to the server
+ * event handler for loan milestone completed event
+ *
+ * @param name milestone name
  */
 export declare type LoanMilestoneCompletedListener = (name: string) => void;
 /**
- * This event is fired when the user attempts to complete a milestone and allows for custom validation, and cancellation, of the process
+ * event handler for loan pre milestone complete event
+ *
+ * @returns true if milestone complete is allowed, false otherwise
  */
 export declare type LoanPreMilestoneCompleteListener = (name: string) => boolean;
 /**
- * This event is fired when a borrower pair changes
+ * event handler for loan application selected event
  */
 export declare type LoanApplicationSelectedListener = () => void;
+/**
+ * events supported by Loan scripting object
+ */
+export declare type LoanEvents = {
+    /**
+     * event is fired prior to saving any pending changes to the loan.
+     * The guest can use this event to perform custom validation and,
+     * via the feedback mechanism, prevent the loan from being saved
+     */
+    'loan.precommit': LoanPreCommitListener;
+    /**
+     * event is fired after pending changes to the loan are committed
+     */
+    'loan.committed': LoanCommittedListener;
+    /**
+     * event is fired for each change made by the user in the UI
+     */
+    'loan.change': LoanChangeListener;
+    /**
+     * event is fired after the loan is sync'ed within any saved state made outside of the user's workspace.
+     */
+    'loan.sync': LoanSyncListener;
+    /**
+     * event is fired after the loan is opened and ready for user interaction
+     */
+    'loan.open': LoanOpenListener;
+    /**
+     * event is fired just prior to closing the loan in the UI
+     */
+    'loan.close': LoanCloseListener;
+    /**
+     * event is fired after a milestone is completed by the user and committed to the server
+     */
+    'loan.milestoneCompleted': LoanMilestoneCompletedListener;
+    /**
+     * event is fired when the user attempts to complete a milestone and allows for custom validation,
+     * and cancellation, of the process
+     */
+    'loan.premilestoneComplete': LoanPreMilestoneCompleteListener;
+    /**
+     * event is fired when a borrower pair changes
+     */
+    'loan.applicationselected': LoanApplicationSelectedListener;
+};

package/dist/types/{loanv2.d.ts → objects/loanv2.d.ts}

@@ -1,4 +1,7 @@
 import { ILoan, LoanObject } from './loan.js';
+/**
+ * Types of field errors
+ */
 export declare enum FieldErrorType {
     /**
      * access related violations
@@ -23,20 +26,47 @@ export declare enum FieldErrorType {
      */
     CONFLICT = "conflict"
 }
+/**
+ * Field error object
+ */
 export declare type FieldErrors = {
+    /**
+     * field id
+     */
     id: string;
+    /**
+     * field error type
+     */
     type: FieldErrorType;
+    /**
+     * error description
+     */
     description: string;
 };
+/**
+ * Return type of setField method
+ */
 export declare type SetFieldResponse = {
     /**
      * List of fields not meeting data, access or required rule criteria
      */
     errors: FieldErrors[];
 };
+/**
+ * Types of commit errors
+ */
 export declare enum CommitErrorStatus {
+    /**
+     * Commit failed due to fields
+     */
     FIELDERROR = "field_error",
+    /**
+     * Commit failed due to invalid lock or read only loan status
+     */
     LOCK_INVALID_OR_REMOVED = "lock_invalid_or_removed",
+    /**
+     * Commit failed due to invalid workspace state
+     */
     WORKSPACE_READ_ONLY = "workspace_read_only"
 }
 /**
@@ -54,6 +84,9 @@ export declare type CommitError = Error & {
         fieldErrors: FieldErrors[];
     };
 };
+/**
+ * Map of field ids to their loan contract path
+ */
 export declare type FieldIDToContractPath = {
     fieldId: string;
     contractPath: string;

package/dist/types/objects/memStorage.d.ts

@@ -0,0 +1,26 @@
+/**
+ * get or set values in host application javascript memory
+ * values stored in memory are not persisted across sessions
+ *
+ * Host application implemeting this scripting object ensures,
+ * there are no collisions with keys from other microapp guest applications
+ * that means, two microapps can use same key to store different values. Thier values will not collide.
+ *
+ */
+export interface IMemStorage {
+    /**
+     * set a value in memory for given key
+     *
+     * @param clientId unique identifier assigned to the microapp
+     * @param key unique key to store the value
+     * @param value value to be stored. value should be JSON serializable
+     */
+    set(clientId: string, key: string, value: any): Promise<void>;
+    /**
+     * get a value from memory for given key and microapp id
+     *
+     * @param key unique key to retrieve the value
+     * @returns value stored in memory
+     */
+    get(clientId: string, key: string): Promise<any>;
+}

package/dist/types/objects/module.d.ts

@@ -0,0 +1,55 @@
+export declare enum LogLevel {
+    TRACE = "TRACE",
+    DEBUG = "DEBUG",
+    INFO = "INFO",
+    AUDIT = "AUDIT",
+    WARN = "WARN",
+    ERROR = "ERROR",
+    FATAL = "FATAL"
+}
+/**
+ * Methods to bootstraps feature modules
+ */
+export interface IModule {
+    /**
+     * get module-specific JavaScript object that can be used to communicate additional capabilities to the module
+     *
+     * @returns key-value pairs of module-specific JavaScript objects
+     */
+    getCapabilities(): Promise<Record<string, string>>;
+    /**
+     * Get startup parameters for the module
+     *
+     * @returns startup parameters as key-value pairs
+     */
+    getParameters(): Promise<Record<string, string>>;
+    /**
+     * unload the module from the host application
+     */
+    unload(): Promise<void>;
+    /**
+     * log a message to host application's logs
+     *
+     * @param message message to log
+     * @param logLevel level of the log message
+     */
+    log(message: string, logLevel: LogLevel): Promise<void>;
+}
+/**
+ * event handler that handles module unload event
+ *
+ * @param id unique id of the module that is being unloaded
+ * @returns true if the module can be unloaded, false otherwise
+ */
+export declare type ModuleUnLoadingListener = (id: string) => boolean;
+/**
+ * events that notifies the module's lifecycle
+ */
+export declare type ModuleEvents = {
+    /**
+     * event fired when the module is unloading
+     *
+     * @returns true if the module can be unloaded, false otherwise
+     */
+    'module.unloading': ModuleUnLoadingListener;
+};

package/dist/types/{route.d.ts → objects/route.d.ts}

@@ -1,6 +1,6 @@
 import { To } from 'history';
 /**
- * Methods and events to view, modify & get notified about parent window url navigation
+ * Methods to view, modify & get notified about parent window url navigation
  */
 export interface IRoute {
     navigate(path: To, state?: any): Promise<void>;

package/dist/types/objects/service.d.ts

@@ -0,0 +1,58 @@
+/**
+ * type of service setup categories
+ */
+declare enum ServiceSetupCategory {
+    APPRAISAL = "Appraisal"
+}
+/**
+ * details of a service setup
+ */
+declare type ServiceSetup = {
+    /**
+     * service setup id
+     */
+    serviceSetupId: string;
+    /**
+     * unique provider id
+     */
+    providerId: string;
+    /**
+     * product listing name
+     */
+    productListingName: string;
+    /**
+     * service setup category
+     */
+    category: ServiceSetupCategory;
+};
+/**
+ * options to open the service order integration
+ */
+declare type OpenOptions = {
+    /**
+     * context of the application that is opening the service order integration
+     */
+    target: string;
+};
+/**
+ * Methods for interacting with the Service orders
+ */
+export interface IService {
+    /**
+     * Get the service setup for the current user and loan
+     *
+     * @param category - The category of the service setup
+     * @param providerId - The provider id of the service setup
+     * @returns list of service setups matching the input criteria. Empty list if no service setups are found
+     */
+    getEligibleServices: (category: ServiceSetupCategory, providerId?: string) => Promise<Array<ServiceSetup>>;
+    /**
+     * open service intergration to place an order
+     *
+     * @param serviceSetupId - id of the service setup
+     * @param options - options for opening the service integration
+     * @throws Error if the service setup is not found or user is not authorized to open the integration
+     */
+    open: (serviceSetupId: string, options: OpenOptions) => Promise<void>;
+}
+export {};

package/dist/types/{session.d.ts → objects/session.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Methods and events to view, modify & get notified about parent window session storage
+ * store and retrieves values in host application's session storage
  */
 export interface ISession {
     /**