@elliemae/pui-scripting-object 1.42.3 → 1.43.1

package/dist/cjs/objects/application.js

@@ -20,7 +20,8 @@ var application_exports = {};
 __export(application_exports, {
   ApplicationExtensionType: () => ApplicationExtensionType,
   LogLevel: () => LogLevel,
-  ModalSize: () => ModalSize
+  ModalSize: () => ModalSize,
+  ModuleOpenMode: () => ModuleOpenMode
 });
 module.exports = __toCommonJS(application_exports);
 var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
@@ -44,3 +45,8 @@ var ModalSize = /* @__PURE__ */ ((ModalSize2) => {
   ModalSize2["LARGE"] = "lg";
   return ModalSize2;
 })(ModalSize || {});
+var ModuleOpenMode = /* @__PURE__ */ ((ModuleOpenMode2) => {
+  ModuleOpenMode2["POPUP"] = "POPUP";
+  ModuleOpenMode2["INLINE"] = "INLINE";
+  return ModuleOpenMode2;
+})(ModuleOpenMode || {});

package/dist/cjs/objects/loan.js

@@ -18,6 +18,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var loan_exports = {};
 __export(loan_exports, {
+  EditModes: () => EditModes,
   LoanLevelActions: () => LoanLevelActions,
   RecordActions: () => RecordActions,
   RecordViewType: () => RecordViewType
@@ -43,3 +44,8 @@ var LoanLevelActions = /* @__PURE__ */ ((LoanLevelActions2) => {
   LoanLevelActions2["COPY_BORROWER_TO_TAX_REQUEST"] = "copyBorrowerToTaxRequest";
   return LoanLevelActions2;
 })(LoanLevelActions || {});
+var EditModes = /* @__PURE__ */ ((EditModes2) => {
+  EditModes2["READ_ONLY"] = "READONLY";
+  EditModes2["EDIT"] = "EDIT";
+  return EditModes2;
+})(EditModes || {});

package/dist/esm/objects/application.js

@@ -19,8 +19,14 @@ var ModalSize = /* @__PURE__ */ ((ModalSize2) => {
   ModalSize2["LARGE"] = "lg";
   return ModalSize2;
 })(ModalSize || {});
+var ModuleOpenMode = /* @__PURE__ */ ((ModuleOpenMode2) => {
+  ModuleOpenMode2["POPUP"] = "POPUP";
+  ModuleOpenMode2["INLINE"] = "INLINE";
+  return ModuleOpenMode2;
+})(ModuleOpenMode || {});
 export {
   ApplicationExtensionType,
   LogLevel,
-  ModalSize
+  ModalSize,
+  ModuleOpenMode
 };

package/dist/esm/objects/loan.js

@@ -18,7 +18,13 @@ var LoanLevelActions = /* @__PURE__ */ ((LoanLevelActions2) => {
   LoanLevelActions2["COPY_BORROWER_TO_TAX_REQUEST"] = "copyBorrowerToTaxRequest";
   return LoanLevelActions2;
 })(LoanLevelActions || {});
+var EditModes = /* @__PURE__ */ ((EditModes2) => {
+  EditModes2["READ_ONLY"] = "READONLY";
+  EditModes2["EDIT"] = "EDIT";
+  return EditModes2;
+})(EditModes || {});
 export {
+  EditModes,
   LoanLevelActions,
   RecordActions,
   RecordViewType

package/dist/types/lib/objects/application.d.ts

@@ -144,6 +144,38 @@ export type OpenModalOptions = {
      */
     size: ModalSize;
 };
+/**
+ * module open mode
+ */
+export declare enum ModuleOpenMode {
+    /**
+     * open the module in a new popup window
+     */
+    POPUP = "POPUP",
+    /**
+     * open the module in the same window
+     */
+    INLINE = "INLINE"
+}
+/**
+ * open module options
+ */
+export type OpenModuleOptions = {
+    /**
+     * module to be opened in urn format
+     * @example urn:encompass:loanapp
+     */
+    moduleId: string;
+    /**
+     * mode to open the module
+     * @default INLINE
+     */
+    mode?: ModuleOpenMode;
+    /**
+     * module parameters as key-value pairs
+     */
+    parameters?: Record<string, unknown>;
+};
 /**
  * capabilities exposed by the application
  */
@@ -368,6 +400,12 @@ export interface IApplication extends IScriptingObject {
      * @param options modal properties
      */
     openModal(options: OpenModalOptions): Promise<void>;
+    /**
+     * Open a module inline or in a popup
+     * @param options module open options
+     * @returns false if the module is not found, true otherwise
+     */
+    openModule(options: OpenModuleOptions): Promise<boolean>;
     /**
      * Perform an action
      * @param action action name

package/dist/types/lib/objects/loan.d.ts

@@ -254,6 +254,33 @@ export type LoanApplicationSelectedListener = (params: {
     eventParams: Record<string, never>;
     eventOptions?: Record<string, unknown>;
 }) => void;
+/**
+ * List of supported edit modes
+ */
+export declare enum EditModes {
+    /**
+     * read only mode
+     */
+    READ_ONLY = "READONLY",
+    /**
+     * edit mode
+     */
+    EDIT = "EDIT"
+}
+/**
+ * options for setting loan edit mode
+ */
+export type EditModeOptions = {
+    /**
+     * edit mode type
+     */
+    mode: EditModes;
+    /**
+     * module requesting the edit mode change. urn format
+     * @example urn:encompass:efolder
+     */
+    moduleId: string;
+};
 /**
  * Events supported by Loan scripting object
  */
@@ -396,7 +423,11 @@ export interface ILoan extends IScriptingObject {
      */
     apply(loan: LoanObject): Promise<void>;
     /**
-     * Applies or removes the calculation lock on a loan field. In this way you can enable or disable the lock on a loan field programmatically. Parameters are: ID of the field you want to apply or remove the calculation lock and the status you want to set the lock to
+     * Applies or removes the calculation lock on a loan field.
+     *
+     * In this way you can enable or disable the lock on a loan field programmatically.
+     *
+     * Parameters are: ID of the field you want to apply or remove the calculation lock and the status you want to set the lock to
      * @param fieldId ID of the field you want to apply or remove the calculation lock
      * @param lock
      */
@@ -421,7 +452,9 @@ export interface ILoan extends IScriptingObject {
      */
     getCurrentApplication(): Promise<Record<string, string>>;
     /**
-     * Returns an object reference of type LoanCollection. Argument "name" is required & used to get specific collection like BorrowerEmployer, Escrow etc.
+     * Returns an object reference of type LoanCollection.
+     *
+     * Argument "name" is required & used to get specific collection like BorrowerEmployer, Escrow etc.
      * @param name collection template name
      */
     getCollection(name: string): Promise<Record<string, string>>;
@@ -433,7 +466,9 @@ export interface ILoan extends IScriptingObject {
     getField(id: string): Promise<string>;
     /**
      * get options for loan fields / custom form controls
+     *
      * supports both standard & custom loan fields.
+     *
      * control Ids takes precedence over field Ids.
      * @param {FieldOptionsParam} param parameter for getting field options
      * @returns array of field options for each field / control id
@@ -497,6 +532,15 @@ export interface ILoan extends IScriptingObject {
      * @param options options for setting current application
      */
     setCurrentApplication(options: CurrentApplicationOptions): Promise<void>;
+    /**
+     * Set UI edit mode for the loan.
+     *
+     * It doesn't apply loan level lock.
+     *
+     * Use this api to prevent current user from making edits to the loan file, while a compliance based workflow is in progress
+     * @param options options for setting edit mode
+     */
+    setEditMode(options: EditModeOptions): Promise<void>;
     /**
      * Set the values of one or more fields on the Loan.
      * @param fields list of field ids and their values
@@ -504,6 +548,7 @@ export interface ILoan extends IScriptingObject {
     setFields(fields: Record<string, string>): Promise<void>;
     /**
      * insert, delete, update, replace different loand record types.
+     *
      * scope includes log and non-log record types
      * @param options options for updating records
      * @returns array of record ids or loan view entity

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

@@ -25,6 +25,80 @@ export type ErrorData = {
      */
     correlationId?: string;
 };
+/**
+ * MicroApp module specific parameters
+ */
+export type ModuleParameters = {
+    /**
+     * module id in urn format
+     * @example urn:encompass:loanapp
+     */
+    moduleId: string;
+    /**
+     * additional parameters as key-value pairs
+     */
+    [key: string]: unknown;
+};
+/**
+ * module close event info
+ */
+export type ModuleCloseInfo = {
+    /**
+     * module that triggered the close event in urn format
+     * @example urn:encompass:loanapp
+     */
+    moduleId: string;
+};
+/**
+ * event handler that handles module close event
+ * @param params event parameters
+ * @param params.obj module object reference
+ * @param params.eventName event name
+ * @param params.eventParams Module close info
+ * @param params.eventOptions additional options related to the event
+ * @returns true to allow module unload, false otherwise
+ */
+export type ModuleCloseListener = (params: {
+    obj: IModule;
+    eventName: string;
+    eventParams: ModuleCloseInfo;
+    eventOptions?: Record<string, unknown>;
+}) => boolean;
+/**
+ * module open event info
+ */
+export type ModuleOpenInfo = {
+    /**
+     * module to be opened in urn format
+     * @example urn:encompass:loanapp
+     */
+    moduleId: string;
+};
+/**
+ * event handler that handles module open event
+ * @param params event parameters
+ * @param params.obj module object reference
+ * @param params.eventName event name
+ * @param params.eventParams Module open info
+ * @param params.eventOptions additional options related to the event
+ * @returns true if module is valid and can be opened, false otherwise
+ */
+export type ModuleOpenListener = (params: {
+    obj: IModule;
+    eventName: string;
+    eventParams: ModuleOpenInfo;
+    eventOptions?: Record<string, unknown>;
+}) => boolean;
+/**
+ * module unload event info
+ */
+export type ModuleUnloadInfo = {
+    /**
+     * module that triggered the unload event in urn format
+     * @example urn:encompass:loanapp
+     */
+    moduleId: string;
+};
 /**
  * event handler that handles module unload event
  * @param params event parameters
@@ -37,13 +111,25 @@ export type ErrorData = {
 export type ModuleUnLoadingListener = (params: {
     obj: IModule;
     eventName: string;
-    eventParams: Record<string, never>;
+    eventParams: ModuleUnloadInfo;
     eventOptions?: Record<string, unknown>;
 }) => boolean;
 /**
  * events that notifies the module's lifecycle
  */
 export type ModuleEvents = {
+    /**
+     * event fired when the module to be closed
+     *
+     * Use {@link ModuleCloseListener} to handle this event
+     */
+    'module.close': ModuleCloseListener;
+    /**
+     * event fired when the module to be opened
+     *
+     * Use {@link ModuleOpenListener} to handle this event
+     */
+    'module.open': ModuleOpenListener;
     /**
      * event fired when the module is unloading
      *
@@ -53,12 +139,22 @@ export type ModuleEvents = {
 };
 /**
  * Exposes MicroApp module specific methods
- * This is an abstract interface and needs to be extended by the module
- * users should avoid creating Scripting object with name 'Module'
  *
  * See {@link ModuleEvents} for supported events
  */
 export interface IModule extends IScriptingObject {
+    /**
+     * event fired when the module to be closed
+     *
+     * Use {@link ModuleCloseListener} to handle this event
+     */
+    readonly Close: IEvent;
+    /**
+     * event fired when the module to be opened
+     *
+     * Use {@link ModuleOpenListener} to handle this event
+     */
+    readonly Open: IEvent;
     /**
      * event fired when the module is unloading
      *
@@ -66,17 +162,20 @@ export interface IModule extends IScriptingObject {
      */
     readonly Unloading: IEvent;
     /**
-     * get microapp module-specific capabilities or settings defined by the host application. Helps to define the style and/or behavior of the module
+     * get microapp module-specific capabilities or settings defined by the host application.
+     *
+     * Helps to define the style and/or behavior of the module
      * @returns capabilities or settings as key-value pairs
      */
     getCapabilities(): Promise<Record<string, unknown>>;
     /**
      * get microapp module-specific parameters.
+     *
      * For example, a lender may select a set of loans within the host application which must be passed to a module
      * that implements a specific workflow for those loans
      * @returns parameters as key-value pairs
      */
-    getParameters(): Promise<Record<string, unknown>>;
+    getParameters(): Promise<ModuleParameters>;
     /**
      * unload the microapp module from the host application
      */