@sava-info-systems/api-maker-with-extensions 1.20.2 → 1.21.0

package/sandbox/assets/schema-types/types.js

@@ -1,4 +1,7 @@
-"use strict";
+/**
+ * Global API Maker context object available in custom code execution.
+ * Provides access to request/response data, system utilities, logging, and shared state.
+ */ "use strict";
 function _export(target, all) {
     for(var name in all)Object.defineProperty(target, name, {
         enumerable: true,
@@ -209,16 +212,16 @@ _export(exports, {
     }
 });
 var EAPICategoryEnum = /*#__PURE__*/ function(EAPICategoryEnum) {
-    EAPICategoryEnum["INSTANCES"] = "INSTANCES";
-    EAPICategoryEnum["THIRD_PARTY_APIS"] = "THIRD_PARTY_APIS";
-    EAPICategoryEnum["CUSTOM_APIS"] = "CUSTOM_APIS";
-    EAPICategoryEnum["SYSTEM_APIS"] = "SYSTEM_APIS";
-    EAPICategoryEnum["EVENTS"] = "EVENTS";
-    EAPICategoryEnum["SCHEDULERS"] = "SCHEDULERS";
-    EAPICategoryEnum["MIGRATION_SCRIPT"] = "MIGRATION_SCRIPT";
-    EAPICategoryEnum["WEB_SOCKET_EVENT_CAN_USER_CONNECT_CODE"] = "WEB_SOCKET_EVENT_CAN_USER_CONNECT_CODE";
-    EAPICategoryEnum["PROCESS_INITIALIZER"] = "PROCESS_INITIALIZER";
-    EAPICategoryEnum["UTILITY_CLASS"] = "UTILITY_CLASS";
+    /** Database instance APIs for CRUD operations. */ EAPICategoryEnum["INSTANCES"] = "INSTANCES";
+    /** Third-party API integrations. */ EAPICategoryEnum["THIRD_PARTY_APIS"] = "THIRD_PARTY_APIS";
+    /** User-defined custom APIs. */ EAPICategoryEnum["CUSTOM_APIS"] = "CUSTOM_APIS";
+    /** Built-in system APIs for platform operations. */ EAPICategoryEnum["SYSTEM_APIS"] = "SYSTEM_APIS";
+    /** Event handlers and listeners. */ EAPICategoryEnum["EVENTS"] = "EVENTS";
+    /** Scheduled tasks and cron jobs. */ EAPICategoryEnum["SCHEDULERS"] = "SCHEDULERS";
+    /** Database migration scripts. */ EAPICategoryEnum["MIGRATION_SCRIPT"] = "MIGRATION_SCRIPT";
+    /** WebSocket connection authorization handlers. */ EAPICategoryEnum["WEB_SOCKET_EVENT_CAN_USER_CONNECT_CODE"] = "WEB_SOCKET_EVENT_CAN_USER_CONNECT_CODE";
+    /** Process initialization scripts. */ EAPICategoryEnum["PROCESS_INITIALIZER"] = "PROCESS_INITIALIZER";
+    /** Reusable utility classes and functions. */ EAPICategoryEnum["UTILITY_CLASS"] = "UTILITY_CLASS";
     return EAPICategoryEnum;
 }({});
 var EAPIIdEnum = /*#__PURE__*/ function(EAPIIdEnum) {
@@ -285,46 +288,46 @@ var EAPIIdEnum = /*#__PURE__*/ function(EAPIIdEnum) {
     return EAPIIdEnum;
 }({});
 var EContentType = /*#__PURE__*/ function(EContentType) {
-    EContentType["JSON"] = "application/json";
-    EContentType["XML"] = "text/xml";
-    EContentType["YAML"] = "text/yaml";
-    EContentType["TEXT"] = "text/plain";
-    EContentType["HTML"] = "text/html";
-    EContentType["OCTET_STREAM"] = "application/octet-stream";
+    /** JSON content type. */ EContentType["JSON"] = "application/json";
+    /** XML content type. */ EContentType["XML"] = "text/xml";
+    /** YAML content type. */ EContentType["YAML"] = "text/yaml";
+    /** Plain text content type. */ EContentType["TEXT"] = "text/plain";
+    /** HTML content type. */ EContentType["HTML"] = "text/html";
+    /** Binary/octet stream content type for file downloads. */ EContentType["OCTET_STREAM"] = "application/octet-stream";
     return EContentType;
 }({});
 var ERequestMethod = /*#__PURE__*/ function(ERequestMethod) {
-    ERequestMethod["GET"] = "GET";
-    ERequestMethod["POST"] = "POST";
-    ERequestMethod["PUT"] = "PUT";
-    ERequestMethod["DELETE"] = "DELETE";
+    /** HTTP GET method for retrieving resources. */ ERequestMethod["GET"] = "GET";
+    /** HTTP POST method for creating resources. */ ERequestMethod["POST"] = "POST";
+    /** HTTP PUT method for updating resources. */ ERequestMethod["PUT"] = "PUT";
+    /** HTTP DELETE method for removing resources. */ ERequestMethod["DELETE"] = "DELETE";
     return ERequestMethod;
 }({});
 var EType = /*#__PURE__*/ function(EType) {
-    EType["string"] = "string";
-    EType["number"] = "number";
-    EType["boolean"] = "boolean";
-    EType["date"] = "date";
-    EType["objectId"] = "objectId";
-    // below are added because of third party request body
-    EType["file"] = "file";
-    EType["files"] = "files";
+    /** String/text data type. */ EType["string"] = "string";
+    /** Numeric data type. */ EType["number"] = "number";
+    /** Boolean data type (true/false). */ EType["boolean"] = "boolean";
+    /** Date/DateTime data type. */ EType["date"] = "date";
+    /** MongoDB ObjectId data type. */ EType["objectId"] = "objectId";
+    // File upload types (used in third-party API request body)
+    /** Single file upload. */ EType["file"] = "file";
+    /** Multiple file uploads. */ EType["files"] = "files";
     return EType;
 }({});
 var EErrorType = /*#__PURE__*/ function(EErrorType) {
-    EErrorType["required"] = "required";
-    EErrorType["min"] = "min";
-    EErrorType["max"] = "max";
-    EErrorType["minLength"] = "minLength";
-    EErrorType["maxLength"] = "maxLength";
-    EErrorType["unique"] = "unique";
-    EErrorType["uniqueCombination"] = "uniqueCombination";
-    EErrorType["invalidValue"] = "invalidValue";
-    EErrorType["schemaKeyNotFound"] = "schemaKeyNotFound";
-    EErrorType["schemaNotFound"] = "schemaNotFound";
-    EErrorType["emailNotValid"] = "emailNotValid";
-    EErrorType["enumValidation"] = "enumValidation";
-    EErrorType["virtualFieldUsedInFind"] = "virtualFieldUsedInFind";
+    /** Required field validation error. */ EErrorType["required"] = "required";
+    /** Minimum value validation error (for numbers/dates). */ EErrorType["min"] = "min";
+    /** Maximum value validation error (for numbers/dates). */ EErrorType["max"] = "max";
+    /** Minimum length validation error (for strings/arrays). */ EErrorType["minLength"] = "minLength";
+    /** Maximum length validation error (for strings/arrays). */ EErrorType["maxLength"] = "maxLength";
+    /** Unique constraint violation for a single field. */ EErrorType["unique"] = "unique";
+    /** Unique constraint violation for combination of multiple fields. */ EErrorType["uniqueCombination"] = "uniqueCombination";
+    /** Value doesn't match expected format or allowed values. */ EErrorType["invalidValue"] = "invalidValue";
+    /** Referenced schema property/key not found. */ EErrorType["schemaKeyNotFound"] = "schemaKeyNotFound";
+    /** Referenced schema definition not found. */ EErrorType["schemaNotFound"] = "schemaNotFound";
+    /** Email format validation error. */ EErrorType["emailNotValid"] = "emailNotValid";
+    /** Enumeration value validation error. */ EErrorType["enumValidation"] = "enumValidation";
+    /** Virtual field incorrectly used in query find clause. */ EErrorType["virtualFieldUsedInFind"] = "virtualFieldUsedInFind";
     return EErrorType;
 }({});
 var EValueGeneratorType = /*#__PURE__*/ function(EValueGeneratorType) {
@@ -340,12 +343,15 @@ var EIPropertyConversionDefaults = /*#__PURE__*/ function(EIPropertyConversionDe
     return EIPropertyConversionDefaults;
 }({});
 var ESendingToSchema = /*#__PURE__*/ function(ESendingToSchema) {
-    ESendingToSchema["DB"] = "DB";
-    ESendingToSchema["USER"] = "USER";
+    /** Apply operation when sending data to the database. */ ESendingToSchema["DB"] = "DB";
+    /** Apply operation when sending data to the user. */ ESendingToSchema["USER"] = "USER";
     return ESendingToSchema;
 }({});
 var ESpecialParamKeyNames = /*#__PURE__*/ function(ESpecialParamKeyNames) {
-    ESpecialParamKeyNames["path"] = "path";
+    /**
+     * Used in file upload/download for FTP, S3, and Azure operations.
+     * The engine uses this to extract filename with extension for proper download handling.
+     */ ESpecialParamKeyNames["path"] = "path";
     return ESpecialParamKeyNames;
 }({});
 var EApiPaths = /*#__PURE__*/ function(EApiPaths) {
@@ -385,63 +391,82 @@ var EApiPaths = /*#__PURE__*/ function(EApiPaths) {
     return EApiPaths;
 }({});
 var EDataValidationType = /*#__PURE__*/ function(EDataValidationType) {
-    EDataValidationType["SUPER_KEY"] = "SUPER_KEY";
+    /**
+     * Super key (composite unique key) validation.
+     * Ensures the combination of specified fields is unique across all records.
+     * Note: All fields in the combination should be marked as required.
+     */ EDataValidationType["SUPER_KEY"] = "SUPER_KEY";
     return EDataValidationType;
 }({});
 var EStatusCode = /*#__PURE__*/ function(EStatusCode) {
-    EStatusCode[EStatusCode["OK"] = 200] = "OK";
-    EStatusCode[EStatusCode["NO_CONTENT"] = 204] = "NO_CONTENT";
-    EStatusCode[EStatusCode["CREATED"] = 201] = "CREATED";
-    EStatusCode[EStatusCode["BAD_REQUEST"] = 400] = "BAD_REQUEST";
-    EStatusCode[EStatusCode["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
-    EStatusCode[EStatusCode["FORBIDDEN"] = 403] = "FORBIDDEN";
-    EStatusCode[EStatusCode["RESOURCE_NOT_FOUND"] = 404] = "RESOURCE_NOT_FOUND";
-    EStatusCode[EStatusCode["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+    /** Request succeeded. */ EStatusCode[EStatusCode["OK"] = 200] = "OK";
+    /**
+     * No content to return.
+     * Note: Avoid using this as it prevents returning data payloads.
+     */ EStatusCode[EStatusCode["NO_CONTENT"] = 204] = "NO_CONTENT";
+    /** Resource created successfully. */ EStatusCode[EStatusCode["CREATED"] = 201] = "CREATED";
+    /** Malformed request or invalid parameters. */ EStatusCode[EStatusCode["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    /** Authentication required or invalid credentials. */ EStatusCode[EStatusCode["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    /** Client authenticated but lacks access permissions, or CORS error. */ EStatusCode[EStatusCode["FORBIDDEN"] = 403] = "FORBIDDEN";
+    /**
+     * Resource not found.
+     * Note: 405 (Method Not Allowed) errors are converted to 404.
+     */ EStatusCode[EStatusCode["RESOURCE_NOT_FOUND"] = 404] = "RESOURCE_NOT_FOUND";
+    /** Server encountered an unexpected error. */ EStatusCode[EStatusCode["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
     return EStatusCode;
 }({});
 var EApiCallType = /*#__PURE__*/ function(EApiCallType) {
-    EApiCallType["parallel"] = "parallel";
-    EApiCallType["sequential"] = "sequential";
+    /** Execute all API calls concurrently. */ EApiCallType["parallel"] = "parallel";
+    /** Execute API calls one after another in sequence. */ EApiCallType["sequential"] = "sequential";
     return EApiCallType;
 }({});
 var ESwaggerParamInType = /*#__PURE__*/ function(ESwaggerParamInType) {
-    ESwaggerParamInType["body"] = "body";
-    ESwaggerParamInType["query"] = "query";
-    ESwaggerParamInType["path"] = "path";
-    ESwaggerParamInType["header"] = "header";
-    ESwaggerParamInType["formData"] = "formData";
+    /** Parameter in request body. */ ESwaggerParamInType["body"] = "body";
+    /** Parameter in URL query string. */ ESwaggerParamInType["query"] = "query";
+    /** Parameter in URL path. */ ESwaggerParamInType["path"] = "path";
+    /** Parameter in HTTP headers. */ ESwaggerParamInType["header"] = "header";
+    /** Parameter in multipart form data. */ ESwaggerParamInType["formData"] = "formData";
     return ESwaggerParamInType;
 }({});
 var EAuthTokenType = /*#__PURE__*/ function(EAuthTokenType) {
-    EAuthTokenType["AM"] = "AM";
-    EAuthTokenType["AM_DB"] = "AM_DB";
-    EAuthTokenType["GOOGLE"] = "GOOGLE";
-    EAuthTokenType["AWS"] = "AWS";
-    EAuthTokenType["AZURE"] = "AZURE";
+    /** API Maker native user authentication. */ EAuthTokenType["AM"] = "AM";
+    /** Database-backed user authentication. */ EAuthTokenType["AM_DB"] = "AM_DB";
+    /** Google OAuth authentication. */ EAuthTokenType["GOOGLE"] = "GOOGLE";
+    /** AWS Cognito authentication. */ EAuthTokenType["AWS"] = "AWS";
+    /** Azure Active Directory authentication. */ EAuthTokenType["AZURE"] = "AZURE";
     return EAuthTokenType;
 }({});
 var EArrayOperation = /*#__PURE__*/ function(EArrayOperation) {
-    EArrayOperation["push"] = "push";
-    EArrayOperation["addToSet"] = "addToSet";
-    EArrayOperation["pull"] = "pull";
-    EArrayOperation["pullAll"] = "pullAll";
-    EArrayOperation["pop"] = "pop";
-    EArrayOperation["set"] = "set";
+    /** Add elements to the end of an array. */ EArrayOperation["push"] = "push";
+    /** Add elements to array only if they don't already exist (prevents duplicates). */ EArrayOperation["addToSet"] = "addToSet";
+    /** Remove all array elements matching a query. */ EArrayOperation["pull"] = "pull";
+    /** Remove all specified values from array. */ EArrayOperation["pullAll"] = "pullAll";
+    /** Remove first or last element from array. */ EArrayOperation["pop"] = "pop";
+    /** Update specific array elements matching filter criteria. */ EArrayOperation["set"] = "set";
     return EArrayOperation;
 }({});
 var EAPIAccessType = /*#__PURE__*/ function(EAPIAccessType) {
-    /** API is not accessible for outside world. Can be used from custom API and code from global "g" object.. */ EAPIAccessType["NO_ACCESS"] = "NO_ACCESS";
-    /** API is public and can be accessible without any token. */ EAPIAccessType["IS_PUBLIC"] = "IS_PUBLIC";
-    /** API can be accessible using tokens. Required tokens depends on authTokenInfo configuration.. */ EAPIAccessType["TOKEN_ACCESS"] = "TOKEN_ACCESS";
+    /**
+     * API is not accessible from outside.
+     * Can only be invoked from custom API code and internal global "g" object.
+     */ EAPIAccessType["NO_ACCESS"] = "NO_ACCESS";
+    /**
+     * API is publicly accessible without authentication.
+     * No token required to access this endpoint.
+     */ EAPIAccessType["IS_PUBLIC"] = "IS_PUBLIC";
+    /**
+     * API requires authentication token.
+     * Token requirements depend on authTokenInfo configuration.
+     */ EAPIAccessType["TOKEN_ACCESS"] = "TOKEN_ACCESS";
     return EAPIAccessType;
 }({});
 var EInstanceType = /*#__PURE__*/ function(EInstanceType) {
-    EInstanceType["MONGO_DB"] = "MONGO_DB";
-    EInstanceType["MYSQL_DB"] = "MYSQL_DB";
-    EInstanceType["MARIA_DB"] = "MARIA_DB";
-    EInstanceType["SQL_SERVER_DB"] = "SQL_SERVER_DB";
-    EInstanceType["POSTGRE_SQL_DB"] = "POSTGRE_SQL_DB";
-    EInstanceType["ORACLE_DB"] = "ORACLE_DB";
+    /** MongoDB NoSQL database. */ EInstanceType["MONGO_DB"] = "MONGO_DB";
+    /** MySQL relational database. */ EInstanceType["MYSQL_DB"] = "MYSQL_DB";
+    /** MariaDB relational database. */ EInstanceType["MARIA_DB"] = "MARIA_DB";
+    /** Microsoft SQL Server database. */ EInstanceType["SQL_SERVER_DB"] = "SQL_SERVER_DB";
+    /** PostgreSQL relational database. */ EInstanceType["POSTGRE_SQL_DB"] = "POSTGRE_SQL_DB";
+    /** Oracle relational database. */ EInstanceType["ORACLE_DB"] = "ORACLE_DB";
     return EInstanceType;
 }({});
 var EEncryptionAlgorithm = /*#__PURE__*/ function(EEncryptionAlgorithm) {
@@ -460,40 +485,36 @@ var ECustomAPIDataValidationType = /*#__PURE__*/ function(ECustomAPIDataValidati
     return ECustomAPIDataValidationType;
 }({});
 var EWSEventType = /*#__PURE__*/ function(EWSEventType) {
-    EWSEventType["INSTANCES"] = "INSTANCES";
-    EWSEventType["THIRD_PARTY_APIS"] = "THIRD_PARTY_APIS";
-    EWSEventType["CUSTOM_APIS"] = "CUSTOM_APIS";
-    EWSEventType["SYSTEM_APIS"] = "SYSTEM_APIS";
-    EWSEventType["CUSTOM_WS_EVENTS"] = "CUSTOM_WS_EVENTS";
-    // Below is only used for local client sync
-    EWSEventType["LOCAL_CLIENT_SYNC_EVENTS"] = "LOCAL_CLIENT_SYNC_EVENTS";
-    // Below is only used for browser client sync
-    EWSEventType["BROWSER_CLIENT_SYNC_EVENTS"] = "BROWSER_CLIENT_SYNC_EVENTS";
+    /** Database instance API events (CRUD operations). */ EWSEventType["INSTANCES"] = "INSTANCES";
+    /** Third-party API integration events. */ EWSEventType["THIRD_PARTY_APIS"] = "THIRD_PARTY_APIS";
+    /** Custom API endpoint events. */ EWSEventType["CUSTOM_APIS"] = "CUSTOM_APIS";
+    /** System-level API events. */ EWSEventType["SYSTEM_APIS"] = "SYSTEM_APIS";
+    /** Custom WebSocket events defined by users. */ EWSEventType["CUSTOM_WS_EVENTS"] = "CUSTOM_WS_EVENTS";
+    /** Local client synchronization events (desktop apps). */ EWSEventType["LOCAL_CLIENT_SYNC_EVENTS"] = "LOCAL_CLIENT_SYNC_EVENTS";
+    /** Browser client synchronization events. */ EWSEventType["BROWSER_CLIENT_SYNC_EVENTS"] = "BROWSER_CLIENT_SYNC_EVENTS";
     return EWSEventType;
 }({});
 var EWSObjectType = /*#__PURE__*/ function(EWSObjectType) {
-    EWSObjectType["REGISTER"] = "REGISTER";
-    EWSObjectType["UNREGISTER"] = "UNREGISTER";
-    EWSObjectType["CONNECTED"] = "CONNECTED";
-    EWSObjectType["UNKNOWN"] = "UNKNOWN";
-    EWSObjectType["TOKEN_VALIDATION"] = "TOKEN_VALIDATION";
-    EWSObjectType["NOTIFICATION"] = "NOTIFICATION";
-    // Below is only used for local client sync
-    EWSObjectType["LC_DATA_REQ_RES"] = "LC_DATA_REQ_RES";
-    // Below is only used for browser client sync
-    EWSObjectType["BROWSER_DATA_REQ_RES"] = "BROWSER_DATA_REQ_RES";
+    /** Register new event listener. */ EWSObjectType["REGISTER"] = "REGISTER";
+    /** Unregister existing event listener. */ EWSObjectType["UNREGISTER"] = "UNREGISTER";
+    /** Connection established confirmation. */ EWSObjectType["CONNECTED"] = "CONNECTED";
+    /** Unknown/unhandled message type. */ EWSObjectType["UNKNOWN"] = "UNKNOWN";
+    /** Token validation request/response. */ EWSObjectType["TOKEN_VALIDATION"] = "TOKEN_VALIDATION";
+    /** Event notification from server. */ EWSObjectType["NOTIFICATION"] = "NOTIFICATION";
+    /** Local client data request/response. */ EWSObjectType["LC_DATA_REQ_RES"] = "LC_DATA_REQ_RES";
+    /** Browser client data request/response. */ EWSObjectType["BROWSER_DATA_REQ_RES"] = "BROWSER_DATA_REQ_RES";
     return EWSObjectType;
 }({});
 var ELocalClientSubEventType = /*#__PURE__*/ function(ELocalClientSubEventType) {
-    ELocalClientSubEventType["LC_SEND_ALL_DATA"] = "LC_SEND_ALL_DATA";
-    ELocalClientSubEventType["LC_DATA_MODIFIED_IN_DATABASE"] = "LC_DATA_MODIFIED_IN_DATABASE";
-    ELocalClientSubEventType["LC_FOLDER_CHANGED_ON_LOCAL_SYSTEM"] = "LC_FOLDER_CHANGED_ON_LOCAL_SYSTEM";
-    ELocalClientSubEventType["BROWSER_DATA_MODIFIED_IN_DATABASE"] = "BROWSER_DATA_MODIFIED_IN_DATABASE";
-    ELocalClientSubEventType["BROWSER_GIT_PULL_HAPPENED"] = "BROWSER_GIT_PULL_HAPPENED";
+    /** Request all data from local client. */ ELocalClientSubEventType["LC_SEND_ALL_DATA"] = "LC_SEND_ALL_DATA";
+    /** Database modification notification to local client. */ ELocalClientSubEventType["LC_DATA_MODIFIED_IN_DATABASE"] = "LC_DATA_MODIFIED_IN_DATABASE";
+    /** Local file system change notification from client. */ ELocalClientSubEventType["LC_FOLDER_CHANGED_ON_LOCAL_SYSTEM"] = "LC_FOLDER_CHANGED_ON_LOCAL_SYSTEM";
+    /** Database modification notification to browser client. */ ELocalClientSubEventType["BROWSER_DATA_MODIFIED_IN_DATABASE"] = "BROWSER_DATA_MODIFIED_IN_DATABASE";
+    /** Git pull event notification to browser client. */ ELocalClientSubEventType["BROWSER_GIT_PULL_HAPPENED"] = "BROWSER_GIT_PULL_HAPPENED";
     return ELocalClientSubEventType;
 }({});
 var EWSConditionType = /*#__PURE__*/ function(EWSConditionType) {
-    EWSConditionType["RESPONSE"] = "RESPONSE";
+    /** Filter based on API response data. */ EWSConditionType["RESPONSE"] = "RESPONSE";
     return EWSConditionType;
 }({});
 var EFilesVariables = /*#__PURE__*/ function(EFilesVariables) {
@@ -556,19 +577,24 @@ var EGitSyncMode = /*#__PURE__*/ function(EGitSyncMode) {
     return EGitSyncMode;
 }({});
 var EDBMasterTheme = /*#__PURE__*/ function(EDBMasterTheme) {
+    // Bootstrap 4 Themes
     EDBMasterTheme["BOOTSTRAP4_LIGHT_BLUE"] = "bootstrap4-light-blue";
     EDBMasterTheme["BOOTSTRAP4_LIGHT_PURPLE"] = "bootstrap4-light-purple";
     EDBMasterTheme["BOOTSTRAP4_DARK_BLUE"] = "bootstrap4-dark-blue";
     EDBMasterTheme["BOOTSTRAP4_DARK_PURPLE"] = "bootstrap4-dark-purple";
+    // Material Design (Classic)
     EDBMasterTheme["MD_LIGHT_INDIGO"] = "md-light-indigo";
     EDBMasterTheme["MD_LIGHT_DEEPPURPLE"] = "md-light-deeppurple";
     EDBMasterTheme["MD_DARK_INDIGO"] = "md-dark-indigo";
     EDBMasterTheme["MD_DARK_DEEPPURPLE"] = "md-dark-deeppurple";
+    // Material Design Components
     EDBMasterTheme["MDC_LIGHT_INDIGO"] = "mdc-light-indigo";
     EDBMasterTheme["MDC_LIGHT_DEEPPURPLE"] = "mdc-light-deeppurple";
     EDBMasterTheme["MDC_DARK_INDIGO"] = "mdc-dark-indigo";
     EDBMasterTheme["MDC_DARK_DEEPPURPLE"] = "mdc-dark-deeppurple";
+    // Fluent Design
     EDBMasterTheme["FLUENT_LIGHT"] = "fluent-light";
+    // Lara Themes (Modern, Recommended)
     EDBMasterTheme["LARA_LIGHT_BLUE"] = "lara-light-blue";
     EDBMasterTheme["LARA_LIGHT_INDIGO"] = "lara-light-indigo";
     EDBMasterTheme["LARA_LIGHT_PURPLE"] = "lara-light-purple";
@@ -577,41 +603,52 @@ var EDBMasterTheme = /*#__PURE__*/ function(EDBMasterTheme) {
     EDBMasterTheme["LARA_DARK_INDIGO"] = "lara-dark-indigo";
     EDBMasterTheme["LARA_DARK_PURPLE"] = "lara-dark-purple";
     EDBMasterTheme["LARA_DARK_TEAL"] = "lara-dark-teal";
+    // Soho Themes
     EDBMasterTheme["SOHO_LIGHT"] = "soho-light";
     EDBMasterTheme["SOHO_DARK"] = "soho-dark";
+    // Viva Themes
     EDBMasterTheme["VIVA_LIGHT"] = "viva-light";
     EDBMasterTheme["VIVA_DARK"] = "viva-dark";
+    // Specialized Themes
     EDBMasterTheme["MIRA"] = "mira";
     EDBMasterTheme["NANO"] = "nano";
+    // Saga Themes (Classic Light)
     EDBMasterTheme["SAGA_BLUE"] = "saga-blue";
     EDBMasterTheme["SAGA_GREEN"] = "saga-green";
     EDBMasterTheme["SAGA_ORANGE"] = "saga-orange";
     EDBMasterTheme["SAGA_PURPLE"] = "saga-purple";
+    // Vela Themes (Classic Dark)
     EDBMasterTheme["VELA_BLUE"] = "vela-blue";
     EDBMasterTheme["VELA_GREEN"] = "vela-green";
     EDBMasterTheme["VELA_ORANGE"] = "vela-orange";
     EDBMasterTheme["VELA_PURPLE"] = "vela-purple";
+    // Arya Themes (Modern Dark)
     EDBMasterTheme["ARYA_BLUE"] = "arya-blue";
     EDBMasterTheme["ARYA_GREEN"] = "arya-green";
     EDBMasterTheme["ARYA_ORANGE"] = "arya-orange";
     EDBMasterTheme["ARYA_PURPLE"] = "arya-purple";
+    // Nova Themes
     EDBMasterTheme["NOVA"] = "nova";
     EDBMasterTheme["NOVA_ALT"] = "nova-alt";
     EDBMasterTheme["NOVA_ACCENT"] = "nova-accent";
+    // Luna Themes
     EDBMasterTheme["LUNA_AMBER"] = "luna-amber";
     EDBMasterTheme["LUNA_BLUE"] = "luna-blue";
     EDBMasterTheme["LUNA_GREEN"] = "luna-green";
     EDBMasterTheme["LUNA_PINK"] = "luna-pink";
+    // Rhea Theme
     EDBMasterTheme["RHEA"] = "rhea";
     return EDBMasterTheme;
 }({});
 var EDBMasterGridExport = /*#__PURE__*/ function(EDBMasterGridExport) {
-    EDBMasterGridExport["CSV"] = "CSV";
-    EDBMasterGridExport["CSV_SELECTED"] = "CSV Selected";
+    /** Export all grid data to CSV file. */ EDBMasterGridExport["CSV"] = "CSV";
+    /** Export only selected rows to CSV file. */ EDBMasterGridExport["CSV_SELECTED"] = "CSV Selected";
+    /** Export all grid data to PDF file. */ EDBMasterGridExport["PDF"] = "PDF";
+    /** Export only selected rows to PDF file. */ EDBMasterGridExport["PDF_SELECTED"] = "PDF Selected";
     return EDBMasterGridExport;
 }({});
 var EDBMasterDataImport = /*#__PURE__*/ function(EDBMasterDataImport) {
-    EDBMasterDataImport["CSV"] = "CSV";
+    /** Import data from CSV file with column mapping. */ EDBMasterDataImport["CSV"] = "CSV";
     return EDBMasterDataImport;
 }({});
 var EDBMasterOperationsOrder = /*#__PURE__*/ function(EDBMasterOperationsOrder) {
@@ -641,32 +678,38 @@ var EDBMasterGridColumnsOrder = /*#__PURE__*/ function(EDBMasterGridColumnsOrder
     return EDBMasterGridColumnsOrder;
 }({});
 var EDBMasterMatchMode = /*#__PURE__*/ function(EDBMasterMatchMode) {
-    EDBMasterMatchMode["contains"] = "contains";
-    EDBMasterMatchMode["notContains"] = "notContains";
-    EDBMasterMatchMode["startsWith"] = "startsWith";
-    EDBMasterMatchMode["endsWith"] = "endsWith";
-    EDBMasterMatchMode["equals"] = "equals";
-    EDBMasterMatchMode["notEquals"] = "notEquals";
-    EDBMasterMatchMode["lt"] = "lt";
-    EDBMasterMatchMode["lte"] = "lte";
-    EDBMasterMatchMode["gt"] = "gt";
-    EDBMasterMatchMode["gte"] = "gte";
-    EDBMasterMatchMode["dateIs"] = "dateIs";
-    EDBMasterMatchMode["dateIsNot"] = "dateIsNot";
-    EDBMasterMatchMode["dateBefore"] = "dateBefore";
-    EDBMasterMatchMode["dateAfter"] = "dateAfter";
+    /** String contains substring (case-insensitive). */ EDBMasterMatchMode["contains"] = "contains";
+    /** String does not contain substring. */ EDBMasterMatchMode["notContains"] = "notContains";
+    /** String starts with prefix. */ EDBMasterMatchMode["startsWith"] = "startsWith";
+    /** String ends with suffix. */ EDBMasterMatchMode["endsWith"] = "endsWith";
+    /** Value exactly equals filter value. */ EDBMasterMatchMode["equals"] = "equals";
+    /** Value does not equal filter value. */ EDBMasterMatchMode["notEquals"] = "notEquals";
+    /** Less than (numeric/date). */ EDBMasterMatchMode["lt"] = "lt";
+    /** Less than or equal (numeric/date). */ EDBMasterMatchMode["lte"] = "lte";
+    /** Greater than (numeric/date). */ EDBMasterMatchMode["gt"] = "gt";
+    /** Greater than or equal (numeric/date). */ EDBMasterMatchMode["gte"] = "gte";
+    /** Date exactly matches (ignoring time). */ EDBMasterMatchMode["dateIs"] = "dateIs";
+    /** Date does not match (ignoring time). */ EDBMasterMatchMode["dateIsNot"] = "dateIsNot";
+    /** Date is before specified date. */ EDBMasterMatchMode["dateBefore"] = "dateBefore";
+    /** Date is after specified date. */ EDBMasterMatchMode["dateAfter"] = "dateAfter";
     return EDBMasterMatchMode;
 }({});
 var EDBMasterConfigFilterType = /*#__PURE__*/ function(EDBMasterConfigFilterType) {
-    EDBMasterConfigFilterType["text"] = "text";
-    EDBMasterConfigFilterType["numeric"] = "numeric";
-    EDBMasterConfigFilterType["boolean"] = "boolean";
-    EDBMasterConfigFilterType["date"] = "date";
+    /** Text input filter for string fields. */ EDBMasterConfigFilterType["text"] = "text";
+    /** Number input filter for numeric fields. */ EDBMasterConfigFilterType["numeric"] = "numeric";
+    /** Checkbox filter for boolean fields. */ EDBMasterConfigFilterType["boolean"] = "boolean";
+    /** Date picker filter for date/datetime fields. */ EDBMasterConfigFilterType["date"] = "date";
     return EDBMasterConfigFilterType;
 }({});
 var EDBMasterConfigGridColumnVisibilityStatus = /*#__PURE__*/ function(EDBMasterConfigGridColumnVisibilityStatus) {
-    /** Default and column is visible in grid. */ EDBMasterConfigGridColumnVisibilityStatus["VISIBLE"] = "VISIBLE";
-    /** Column is present in grid but hidden by default. Need to select in column selector dropdown. */ EDBMasterConfigGridColumnVisibilityStatus["INVISIBLE"] = "INVISIBLE";
+    /**
+     * Column is visible by default in grid and exports.
+     * Default state for all columns.
+     */ EDBMasterConfigGridColumnVisibilityStatus["VISIBLE"] = "VISIBLE";
+    /**
+     * Column is hidden by default but available.
+     * Users can show it via column selector dropdown.
+     */ EDBMasterConfigGridColumnVisibilityStatus["INVISIBLE"] = "INVISIBLE";
     return EDBMasterConfigGridColumnVisibilityStatus;
 }({});
 var EDBMasterDropdownAppendTo = /*#__PURE__*/ function(EDBMasterDropdownAppendTo) {
@@ -861,46 +904,120 @@ var EDBMasterGridAppendTo = /*#__PURE__*/ function(EDBMasterGridAppendTo) {
     return EDBMasterGridAppendTo;
 }({});
 var EDBMasterConfigAppendTo = /*#__PURE__*/ function(EDBMasterConfigAppendTo) {
-    /** Code will be run only once on page load. config and global data are not available. It will append script to page script tag. */ EDBMasterConfigAppendTo["oncePageLoad"] = "oncePageLoad";
-    /** Code will be run only once on page load with context of data. (config, globalData: any, utils: any, queryParams: any) */ EDBMasterConfigAppendTo["oncePageLoadWithContext"] = "oncePageLoadWithContext";
-    /** Gets executed everytime grid gets data. (gridEvent, gridData, globalData: any, utils: any, queryParams: any) */ EDBMasterConfigAppendTo["gridRender"] = "gridRender";
-    /** You can modify api call request. (gridEvent, reqBody: IQueryFormat, globalData: any, utils: any, queryParams: any) */ EDBMasterConfigAppendTo["modifyGridRequest"] = "modifyGridRequest";
-    /** Executed once grid data loaded. */ EDBMasterConfigAppendTo["onceGridDataLoaded"] = "onceGridDataLoaded";
-    /** run code before save & edit operation of form. Change data before saving/update/import. (reqBody: any | any[], globalData: any, utils: any, queryParams: any, mode: 'save' | 'edit' | 'import') */ EDBMasterConfigAppendTo["preSaveAndEdit"] = "preSaveAndEdit";
-    /** Change data before save modal open. (formData: any , globalData: any, utils: any, queryParams: any) */ EDBMasterConfigAppendTo["beforeSaveModalOpen"] = "beforeSaveModalOpen";
-    /** Change data before edit modal open. (formData: any , globalData: any, utils: any, queryParams: any) */ EDBMasterConfigAppendTo["beforeEditModalOpen"] = "beforeEditModalOpen";
-    EDBMasterConfigAppendTo["beforeViewModalOpen"] = "beforeViewModalOpen";
-    EDBMasterConfigAppendTo["columnSelectionChanged"] = "columnSelectionChanged";
-    /** this code will be executed just before making CSV file from data. (gridData will have CSV data) */ EDBMasterConfigAppendTo["processDataBeforeExport"] = "processDataBeforeExport";
+    /**
+     * Execute once on initial page load.
+     * Appends script to page <script> tag.
+     * ⚠️ Note: config and globalData are NOT available in this hook.
+     */ EDBMasterConfigAppendTo["oncePageLoad"] = "oncePageLoad";
+    /**
+     * Execute once on page load with full context.
+     * Available: config, globalData, utils, queryParams
+     * Use this for initialization that needs access to configuration.
+     */ EDBMasterConfigAppendTo["oncePageLoadWithContext"] = "oncePageLoadWithContext";
+    /**
+     * Execute every time grid renders data.
+     * Available: gridEvent, gridData, globalData, utils, queryParams
+     * Use for dynamic row styling or data transformation.
+     */ EDBMasterConfigAppendTo["gridRender"] = "gridRender";
+    /**
+     * Modify grid API request before execution.
+     * Available: gridEvent, reqBody (IQueryFormat), globalData, utils, queryParams
+     * Use to add custom filters or modify query parameters.
+     */ EDBMasterConfigAppendTo["modifyGridRequest"] = "modifyGridRequest";
+    /**
+     * Execute once after initial grid data load.
+     * Available: gridData, globalData, utils, queryParams
+     */ EDBMasterConfigAppendTo["onceGridDataLoaded"] = "onceGridDataLoaded";
+    /**
+     * Execute before save/edit operations.
+     * Modify data before saving, updating, or importing.
+     * Available: reqBody (any | any[]), globalData, utils, queryParams, mode ('save' | 'edit' | 'import')
+     */ EDBMasterConfigAppendTo["preSaveAndEdit"] = "preSaveAndEdit";
+    /**
+     * Execute before save form dialog opens.
+     * Pre-populate or transform form data for new records.
+     * Available: formData, globalData, utils, queryParams
+     */ EDBMasterConfigAppendTo["beforeSaveModalOpen"] = "beforeSaveModalOpen";
+    /**
+     * Execute before edit form dialog opens.
+     * Transform loaded data before displaying in edit form.
+     * Available: formData, globalData, utils, queryParams
+     */ EDBMasterConfigAppendTo["beforeEditModalOpen"] = "beforeEditModalOpen";
+    /**
+     * Execute before view form dialog opens.
+     * Transform data before displaying in read-only view.
+     * Available: formData, globalData, utils, queryParams
+     */ EDBMasterConfigAppendTo["beforeViewModalOpen"] = "beforeViewModalOpen";
+    /**
+     * Execute when user changes column visibility.
+     * React to column show/hide events.
+     */ EDBMasterConfigAppendTo["columnSelectionChanged"] = "columnSelectionChanged";
+    /**
+     * Generate custom delete confirmation dialog.
+     * Must return IConfirmDialogSettings object.
+     */ EDBMasterConfigAppendTo["deleteConfirmationDialogGenerator"] = "deleteConfirmationDialogGenerator";
+    /**
+     * Generate custom delete-all confirmation dialog.
+     * Must return IConfirmDialogSettings object.
+     */ EDBMasterConfigAppendTo["deleteAllConfirmationDialogGenerator"] = "deleteAllConfirmationDialogGenerator";
+    /**
+     * Generate custom edit confirmation dialog.
+     * Must return IConfirmDialogSettings object.
+     */ EDBMasterConfigAppendTo["editConfirmationDialogGenerator"] = "editConfirmationDialogGenerator";
+    /**
+     * Generate custom save confirmation dialog.
+     * Must return IConfirmDialogSettings object.
+     */ EDBMasterConfigAppendTo["saveConfirmationDialogGenerator"] = "saveConfirmationDialogGenerator";
+    /**
+     * Process grid data before CSV export.
+     * Modify gridData for export (does not affect displayed data).
+     * Available: gridData (mutable copy), globalData, utils, queryParams
+     */ EDBMasterConfigAppendTo["processDataBeforeExport"] = "processDataBeforeExport";
+    /**
+     * Process grid data before PDF export.
+     * Modify gridData for PDF generation (does not affect displayed data).
+     *
+     * Available: gridData (mutable copy), jsPdfDoc, globalData, utils, queryParams
+     *
+     * **jsPdfDoc**: Pre-created jsPDF instance. You can customize or replace it.
+     *
+     * @example
+     * // Customize PDF document
+     * const { jsPDF } = window.jspdf;
+     * const doc = new jsPDF({
+     *     orientation: 'landscape',
+     *     format: 'a4'
+     * });
+     * $scope.jsPdfDoc = doc;
+     * $scope.jsPdfDoc.text("Custom Report Title", 14, 15);
+     */ EDBMasterConfigAppendTo["processDataBeforePDFExport"] = "processDataBeforePDFExport";
     return EDBMasterConfigAppendTo;
 }({});
 var EDBMasterFormControl = /*#__PURE__*/ function(EDBMasterFormControl) {
-    EDBMasterFormControl["input"] = "input";
-    EDBMasterFormControl["inputNumber"] = "inputNumber";
-    EDBMasterFormControl["inputMask"] = "inputMask";
-    EDBMasterFormControl["inputOtp"] = "inputOtp";
-    EDBMasterFormControl["password"] = "password";
-    EDBMasterFormControl["date_picker"] = "date_picker";
-    EDBMasterFormControl["textarea"] = "textarea";
-    EDBMasterFormControl["editor"] = "editor";
-    EDBMasterFormControl["checkbox"] = "checkbox";
-    EDBMasterFormControl["radio"] = "radio";
-    EDBMasterFormControl["color_picker"] = "color_picker";
-    EDBMasterFormControl["dropdown"] = "dropdown";
-    EDBMasterFormControl["auto_complete"] = "auto_complete";
-    EDBMasterFormControl["multi_select"] = "multi_select";
-    EDBMasterFormControl["file_upload"] = "file_upload";
-    EDBMasterFormControl["grid"] = "grid";
-    EDBMasterFormControl["divider"] = "divider";
-    EDBMasterFormControl["rating"] = "rating";
-    EDBMasterFormControl["knob"] = "knob";
-    // Field holder controls
-    EDBMasterFormControl["accordion"] = "accordion";
-    EDBMasterFormControl["tab_view"] = "tab_view";
-    // utility controls
-    EDBMasterFormControl["button"] = "button";
-    EDBMasterFormControl["image"] = "image";
-    EDBMasterFormControl["customHTML"] = "customHTML";
+    /** Single-line text input. */ EDBMasterFormControl["input"] = "input";
+    /** Numeric input with spinner buttons and formatting. */ EDBMasterFormControl["inputNumber"] = "inputNumber";
+    /** Text input with pattern-based masking (phone, SSN, etc.). */ EDBMasterFormControl["inputMask"] = "inputMask";
+    /** One-time password multi-character input. */ EDBMasterFormControl["inputOtp"] = "inputOtp";
+    /** Password input with visibility toggle and strength meter. */ EDBMasterFormControl["password"] = "password";
+    /** Date and/or time picker with calendar popup. */ EDBMasterFormControl["date_picker"] = "date_picker";
+    /** Multi-line text input. */ EDBMasterFormControl["textarea"] = "textarea";
+    /** Rich text WYSIWYG editor. */ EDBMasterFormControl["editor"] = "editor";
+    /** Binary checkbox (true/false). */ EDBMasterFormControl["checkbox"] = "checkbox";
+    /** Radio button group for single selection. */ EDBMasterFormControl["radio"] = "radio";
+    /** Color picker with multiple format support. */ EDBMasterFormControl["color_picker"] = "color_picker";
+    /** Dropdown select with single selection. */ EDBMasterFormControl["dropdown"] = "dropdown";
+    /** Autocomplete with type-ahead search. */ EDBMasterFormControl["auto_complete"] = "auto_complete";
+    /** Multi-select dropdown with chip display. */ EDBMasterFormControl["multi_select"] = "multi_select";
+    /** File upload with validation. */ EDBMasterFormControl["file_upload"] = "file_upload";
+    /** Nested data grid for one-to-many relationships. */ EDBMasterFormControl["grid"] = "grid";
+    /** Visual separator line. */ EDBMasterFormControl["divider"] = "divider";
+    /** Star-based rating input. */ EDBMasterFormControl["rating"] = "rating";
+    /** Circular dial for numeric input. */ EDBMasterFormControl["knob"] = "knob";
+    /** Collapsible accordion panels (field container). */ EDBMasterFormControl["accordion"] = "accordion";
+    /** Tabbed view for organizing fields (field container). */ EDBMasterFormControl["tab_view"] = "tab_view";
+    /** Clickable button with custom actions. */ EDBMasterFormControl["button"] = "button";
+    /** Image display with preview. */ EDBMasterFormControl["image"] = "image";
+    /** Custom HTML content. */ EDBMasterFormControl["customHTML"] = "customHTML";
     return EDBMasterFormControl;
 }({});
 var EDBMasterCustomActionButtonAppendTo = /*#__PURE__*/ function(EDBMasterCustomActionButtonAppendTo) {
@@ -908,36 +1025,70 @@ var EDBMasterCustomActionButtonAppendTo = /*#__PURE__*/ function(EDBMasterCustom
     return EDBMasterCustomActionButtonAppendTo;
 }({});
 var IDBMasterEventFromIframeToParent = /*#__PURE__*/ function(IDBMasterEventFromIframeToParent) {
-    IDBMasterEventFromIframeToParent["PAGE_READY"] = "PAGE_READY";
-    IDBMasterEventFromIframeToParent["RECORD_SAVED"] = "RECORD_SAVED";
-    IDBMasterEventFromIframeToParent["RECORDS_IMPORTED"] = "RECORDS_IMPORTED";
-    IDBMasterEventFromIframeToParent["RECORD_UPDATED"] = "RECORD_UPDATED";
-    IDBMasterEventFromIframeToParent["RECORD_DELETED"] = "RECORD_DELETED";
-    IDBMasterEventFromIframeToParent["MANY_RECORD_DELETED"] = "MANY_RECORD_DELETED";
-    IDBMasterEventFromIframeToParent["GRID_EXPORTED"] = "GRID_EXPORTED";
-    IDBMasterEventFromIframeToParent["GRID_REFRESHED"] = "GRID_REFRESHED";
-    IDBMasterEventFromIframeToParent["ADD_NEW_BUTTON_CLICKED"] = "ADD_NEW_BUTTON_CLICKED";
-    IDBMasterEventFromIframeToParent["CLOSE_BUTTON_CLICKED"] = "CLOSE_BUTTON_CLICKED";
-    IDBMasterEventFromIframeToParent["CUSTOM_ACTION_BUTTON_CLICKED"] = "CUSTOM_ACTION_BUTTON_CLICKED";
-    IDBMasterEventFromIframeToParent["DROPDOWN_ADD_NEW_RECORD_SAVED"] = "DROPDOWN_ADD_NEW_RECORD_SAVED";
-    IDBMasterEventFromIframeToParent["DOUBLE_CLICK_GRID_EVENT"] = "DOUBLE_CLICK_GRID_EVENT";
-    IDBMasterEventFromIframeToParent["CLICK_GRID_EVENT"] = "CLICK_GRID_EVENT";
+    /** DB Master UI has fully loaded and is ready. */ IDBMasterEventFromIframeToParent["PAGE_READY"] = "PAGE_READY";
+    /** New record was successfully saved. */ IDBMasterEventFromIframeToParent["RECORD_SAVED"] = "RECORD_SAVED";
+    /** Multiple records were imported successfully. */ IDBMasterEventFromIframeToParent["RECORDS_IMPORTED"] = "RECORDS_IMPORTED";
+    /** Existing record was updated. */ IDBMasterEventFromIframeToParent["RECORD_UPDATED"] = "RECORD_UPDATED";
+    /** Single record was deleted. */ IDBMasterEventFromIframeToParent["RECORD_DELETED"] = "RECORD_DELETED";
+    /** Multiple records were deleted. */ IDBMasterEventFromIframeToParent["MANY_RECORD_DELETED"] = "MANY_RECORD_DELETED";
+    /** Grid data was exported (CSV/PDF). */ IDBMasterEventFromIframeToParent["GRID_EXPORTED"] = "GRID_EXPORTED";
+    /** Grid data was manually refreshed. */ IDBMasterEventFromIframeToParent["GRID_REFRESHED"] = "GRID_REFRESHED";
+    /** User clicked the "Add New" button. */ IDBMasterEventFromIframeToParent["ADD_NEW_BUTTON_CLICKED"] = "ADD_NEW_BUTTON_CLICKED";
+    /** User clicked the "Close" button. */ IDBMasterEventFromIframeToParent["CLOSE_BUTTON_CLICKED"] = "CLOSE_BUTTON_CLICKED";
+    /** User clicked a custom action button. */ IDBMasterEventFromIframeToParent["CUSTOM_ACTION_BUTTON_CLICKED"] = "CUSTOM_ACTION_BUTTON_CLICKED";
+    /** New record saved via dropdown "Add New" dialog. */ IDBMasterEventFromIframeToParent["DROPDOWN_ADD_NEW_RECORD_SAVED"] = "DROPDOWN_ADD_NEW_RECORD_SAVED";
+    /** User double-clicked a grid row. */ IDBMasterEventFromIframeToParent["DOUBLE_CLICK_GRID_EVENT"] = "DOUBLE_CLICK_GRID_EVENT";
+    /** User clicked a grid row. */ IDBMasterEventFromIframeToParent["CLICK_GRID_EVENT"] = "CLICK_GRID_EVENT";
     return IDBMasterEventFromIframeToParent;
 }({});
 var IDBMasterEventFromParentToIframe = /*#__PURE__*/ function(IDBMasterEventFromParentToIframe) {
-    /** You can trigger add button click. */ IDBMasterEventFromParentToIframe["TRIGGER_ADD_NEW_BUTTON_CLICK"] = "TRIGGER_ADD_NEW_BUTTON_CLICK";
-    /** You can trigger refresh button click of grid. */ IDBMasterEventFromParentToIframe["TRIGGER_REFRESH_BUTTON_CLICK"] = "TRIGGER_REFRESH_BUTTON_CLICK";
-    /** Need to pass object and those properties will be sent in grid load query. */ IDBMasterEventFromParentToIframe["DATA_TO_APPEND_IN_GRID_LOAD_FIND_QUERY"] = "DATA_TO_APPEND_IN_GRID_LOAD_FIND_QUERY";
-    /** Need to pass object and those properties will be sent in SAVE API call. */ IDBMasterEventFromParentToIframe["DATA_TO_APPEND_IN_RECORD_SAVE_API_PAYLOAD"] = "DATA_TO_APPEND_IN_RECORD_SAVE_API_PAYLOAD";
-    /** Need to pass object and those properties will be sent in Update API call. */ IDBMasterEventFromParentToIframe["DATA_TO_APPEND_IN_RECORD_UPDATE_API_PAYLOAD"] = "DATA_TO_APPEND_IN_RECORD_UPDATE_API_PAYLOAD";
-    /** Pass object which will be used in global variable named "globalData" in custom code. */ IDBMasterEventFromParentToIframe["SET_GLOBAL_DATA_TO_USE_IN_ANY_SCRIPT"] = "SET_GLOBAL_DATA_TO_USE_IN_ANY_SCRIPT";
-    /** Send message to iframe when you are done with setting required data in globalData or other required places. */ IDBMasterEventFromParentToIframe["PARENT_READY"] = "PARENT_READY";
+    /**
+     * Programmatically trigger "Add New" button click.
+     * Opens add form dialog.
+     */ IDBMasterEventFromParentToIframe["TRIGGER_ADD_NEW_BUTTON_CLICK"] = "TRIGGER_ADD_NEW_BUTTON_CLICK";
+    /**
+     * Programmatically trigger grid refresh.
+     * Reloads grid data from server.
+     */ IDBMasterEventFromParentToIframe["TRIGGER_REFRESH_BUTTON_CLICK"] = "TRIGGER_REFRESH_BUTTON_CLICK";
+    /**
+     * Inject query conditions into grid data fetch.
+     * eventData: Object merged into find query.
+     * @example { status: 'active', companyId: '123' }
+     */ IDBMasterEventFromParentToIframe["DATA_TO_APPEND_IN_GRID_LOAD_FIND_QUERY"] = "DATA_TO_APPEND_IN_GRID_LOAD_FIND_QUERY";
+    /**
+     * Inject additional data into save API payload.
+     * eventData: Object merged into new record data.
+     * @example { createdBy: 'parentApp', tenantId: '456' }
+     */ IDBMasterEventFromParentToIframe["DATA_TO_APPEND_IN_RECORD_SAVE_API_PAYLOAD"] = "DATA_TO_APPEND_IN_RECORD_SAVE_API_PAYLOAD";
+    /**
+     * Inject additional data into update API payload.
+     * eventData: Object merged into update record data.
+     * @example { modifiedBy: 'parentApp' }
+     */ IDBMasterEventFromParentToIframe["DATA_TO_APPEND_IN_RECORD_UPDATE_API_PAYLOAD"] = "DATA_TO_APPEND_IN_RECORD_UPDATE_API_PAYLOAD";
+    /**
+     * Set global data accessible in custom scripts.
+     * eventData: Object available as $scope.globalData in all hooks.
+     * @example { userRole: 'admin', permissions: [...] }
+     */ IDBMasterEventFromParentToIframe["SET_GLOBAL_DATA_TO_USE_IN_ANY_SCRIPT"] = "SET_GLOBAL_DATA_TO_USE_IN_ANY_SCRIPT";
+    /**
+     * Signal that parent has finished initialization.
+     * Send this after all data injection messages are sent.
+     */ IDBMasterEventFromParentToIframe["PARENT_READY"] = "PARENT_READY";
     return IDBMasterEventFromParentToIframe;
 }({});
 var EDBMasterSpecialRowProperties = /*#__PURE__*/ function(EDBMasterSpecialRowProperties) {
-    /** if this property found in row with truthy value, it will hide delete button for that row even if that is supported. */ EDBMasterSpecialRowProperties["____hide_delete_button"] = "____hide_delete_button";
-    /** if this property found in row with truthy value, it will hide edit button for that row even if that is supported. */ EDBMasterSpecialRowProperties["____hide_edit_button"] = "____hide_edit_button";
-    /** if this property found in row with truthy value, it will hide view button for that row even if that is supported. */ EDBMasterSpecialRowProperties["____hide_view_button"] = "____hide_view_button";
+    /**
+     * When truthy, hides the delete button for this specific row.
+     * Useful for protecting certain records from deletion.
+     */ EDBMasterSpecialRowProperties["____hide_delete_button"] = "____hide_delete_button";
+    /**
+     * When truthy, hides the edit button for this specific row.
+     * Useful for read-only records or locked entries.
+     */ EDBMasterSpecialRowProperties["____hide_edit_button"] = "____hide_edit_button";
+    /**
+     * When truthy, hides the view button for this specific row.
+     * Useful for restricting access to certain record details.
+     */ EDBMasterSpecialRowProperties["____hide_view_button"] = "____hide_view_button";
     return EDBMasterSpecialRowProperties;
 }({})// ==== DB Master configurations End ====
 ;