Catalyst Release Notes
Identity Scanner: Catalyst introduces a new Zia AI-driven suite, Identity Scanner, that enables you to perform secure identity checks through E-KYC and document processing. Identity Scanner incorporates extended OCR, data extraction, face comparison, and other advanced AI functionalities that allow you to process various ID proofs and official documents. Catalyst provides Identity Scanner in the Java and Node.js environments, as well as through multiple APIs.
Note: Document Processing is only relevant to Indian users and is only available in the IN DC (Indian Data Center). E-KYC is available as Facial Comparison in the Java and Node.js SDK packages, and as an API to all users globally.
Configuration of Function Environmental Variables and Triggers: Catalyst Functions have undergone a major upgrade with the newly introduced options of configuring environmental variables and function triggers. You can now declare and store function-specific variables for the development and production environments of your project in the newly introduced Configuration section for functions in the console. You can now also easily create and manage all triggers associated with that function based on the function's type, as well configure it's allocated memory from this section.
Sort, Search, and Pagination Updates in Functions List View: You can now sort the functions listed on the Functions component page in the console by their names, IDs, or by other columns. You can also search for a function using the new search bar on top of the page, as well as view them in pages containing rows of 10, 20, or 50 results.
Anti-virus check during File Attachments/Uploads: Catalyst now provides an additional layer of security for your application files by implementing anti-virus checks on the files uploaded in the File Store, and on the attachments sent through Catalyst Mail.
Bug Fixes in ZCQL: Fixes were made to resolve a bug in ZCQL where the scope criteria of the child table was considered over the scope of the parent table, in the case of Joins. The default limits for the number of rows fetched in SELECT operations are also updated to 300 from 200.
Bug Fixes in Functions: Fixes were made to address the issue of including characters like "4d", "2d", or "56f" in function names that resulted in errors due to them getting converted to float or double values.
Bug Fixes in API Gateway: Minor bug fixes were done in API Gateway to validate empty values for API names.
Bug fixes in IAC Exports: Fixes were made to address the issue of project export failures when an app alert with no event listener rule mapped to it is exported.
Bug fixes in File Store: Bug fixes were made to rectify minor duplication error throws during folder deletions in the File Store.
Bug fixes in Project List View: A bug that disabled the scroll when the sign-out page was opened in the projects list view was fixed.
IaC Settings: Catalyst introduces a new method of performing project imports and exports from the console through Infrastructure as Code (IaC) settings. You can export the schema and code of a project into a ZIP file, and import this ZIP file into a new project of any Catalyst account. These IaC operations are already available in the CLI.
Bug Fixes in Domain Mapping: A console message stating the CNAME entry for Domain Mapping to be linked to catalyst-cs.zohohost.com for all DCs has now been changed based on the user's DC.
Bug Fixes in File Store: Fixes were made to rectify a bug that prevented folder permissions from being updated for custom user roles, i.e., the roles other than App Administrator or App User.
Extension of Node.js v10 Deprecation: The deprecation phase of Node.js v10 has been ongoing since April 2021. The retirement date was announced as July 31, 2022 for the version. However, we have planned to extend the deprecation period of the version until October 31, 2022. Following the deprecation period, Node.js v10 will be retired on January 31, 2023, and Catalyst will end its support for the runtime.
Node.js v12 Deprecation Announcement: Node.js v12 is currently in the deprecation phase. Following the deprecation period of one year until April 30, 2023, Node.js v12 will be retired on July 31, 2023, three months after the end of the deprecation period. Catalyst will then end its support for the runtime.
Automation Testing: Catalyst introduces Automation Testing- an API testing tool that enables you to test all the accessible end point APIs of your application, i.e., the Basic I/O and Advanced I/O functions, or any third-party API. You can write custom test cases, automate the entire process of API testing, and obtain real-time responses and detailed reports. Catalyst also enables you to trigger the execution of configured test plans through an API.Automation Testing- Help Documentation
Support for Pagination in Java, Node.js, Web SDKs, and API: Catalyst has introduced support for Pagination in fetching all rows from a table in the Data Store, in the Java, Node.js, Web SDKs and the API. Pagination enables you to fetch the rows of a table in batches or pages through iterations. The support for the older methods of fetching all rows in the same response has been deprecated in all the SDKs and the API, and Pagination will now be the default.
Catalyst CLI v1.12.0: Catalyst CLI version 1.12.0 is published with several enhancements and bug-fixes in the existing CLI features and packages.
Deprecation of Angular and React Plugins as Global Packages: Catalyst will no longer support the global installation and use of Angular and React packages in the project directory. You will only be able to install these plugins in the specific app directories of the web client where they are initialized, using the CLI. Please update the code of your existing Angular and React web apps accordingly.
Deprecation of the --watch option in Functions Shell: Catalyst has deprecated the --watch option for the catalyst functions:shell CLI command. The watch mode will be set as the default. You can disable the default watch using the new --no-watch option while executing the command.
Cliq Integration Functions Template Update: We have updated the default code templates of some Cliq handler classes that you set up in a Cliq Integration function. This will not affect any of your existing functions.
Angular Schematics Package Update: We have reflected the updates that were made in the Angular schematics collection, in the Catalyst Angular plugin.
Angular and React Plugin Upgrades: Catalyst Angular and React plugins have been updated to support updated LTS versions of the respective frameworks- Angular v12.2.15 and React v17.0.2.
Bug-Fixes in IN DC: Minor bug-fixes were made in the static URL handling of the IN data center, where in some instances the static URLs pointed to the US DC instead of the IN DC.
Bug-Fixes in CLI Dependancy Package: Fixes were made to update the dependancy clone package cli-table3 to reflect the latest patch updates made in the original package.
Bug-Fixes in catalyst serve: Fixes were made in the catalyst serve CLI command to address the issue where the serving of a minified HTML file caused the script injection logic to render an extra character.
Angular and React Web Client Apps: Catalyst has released support for Angular and React web client application templates, and provides custom plugins for them to facilitate a better app development experience. You can now initialize or set up the web client in your project as an Angular app, React app, or the basic web app which was available earlier. You can test and deploy these apps similar to the other components of your project.
Catalyst CLI v1.11.0 Release: We have released Catalyst CLI v1.11.0 with the support for Angular and React web client applications.
Application Alerts: Catalyst now enables you to configure email alerts to be sent during failures or specific event occurrences in any of these components: Cron, Event Listeners, or Logs. You can associate multiple entities of a component in a single alert, and set the alert's criteria and frequency according to your needs.Application Alerts- Help Link
Project Export and Import Operations in the CLI: You can now perform the Infrastructure as Code (IaC) operations of exporting and importing projects from the CLI. You can export a project's component configurations, functions, and client code, without any data, as an external ZIP file. This project ZIP file can be imported as a new project into any Catalyst account.Export and Import Projects - Help Link
Enhancements in Cron: Catalyst will now send emails each time a cron is disabled in any of the projects. The alerts will be sent to the collaborators of the project who configured the cron.
Bug- Fixes in Catalyst Sign-up: Catalyst has now improved the user sign-up process through an SDK or API, by implementing validations to accept only the ZAID values of projects associated with existing Catalyst applications.
Catalyst CLI v1.9.1 Release: We have released Catalyst CLI v1.9.1 implementing some bug fixes in the --only option of the catalyst serve command, where the client component did not get served in some cases.
Catalyst CLI v1.9.0 Release: Catalyst CLI v1.9.0 is out now with enhancements in the CLI serve command. The serve command now includes a --watch option that enables a hot reload of the serve session whenever changes are detected in the target files. This allows you to modify your resources while the serve session is still active.
Context-Sensitive Help in CLI: Catalyst CLI will now display context-sensitive help, when you encounter an error during a CLI command execution. Catalyst will analyze the error dynamically to understand the usage of the command and the reason behind the error occurrence, and provide you custom help for the specific scenario. The CLI will suggest actions that you can take to rectify or prevent the error, and provide a relevant help link to implement the fix.CLI Context-Senstive Help
Language Runtime Support Policy: We have designed a standard Language Runtime Support Policy that defines the framework for deprecating and ending support for the Java and Node.js language runtimes approaching their end of life. The policy includes multiple phases in ending support for these runtimes. This phased reduction provides you plenty of time to plan, implement, and test upgrades in your functions.
Support for Node.js v12 and v14 Functions: Catalyst now provides support for Node.js v12 and Node.js v14 versions in your Catalyst functions. You can select any of these versions while creating a Node.js function in the remote console, or while initializing it or setting it up from the CLI. You can upgrade your existing functions to the latest supported version from the remote console.
Deprecation of Node.js v10: Catalyst is beginning the deprecation of Node.js v10, effective immediately. The deprecation period in Catalyst will be until July 31, 2022. Please ensure you upgrade your existing Node.js v10 functions to the latest supported runtime to ensure stability and security in your Catalyst application.
New Demo App in the Console: Catalyst users can now access and test a demo app that is readily configured and populated with data. The 'Polls' app enables users to create polls instantly, and share them on social media. You can also vote on any polls and view real-time data reports in the app. This demo app is now available for all users in the index page of their remote console.
Status and Time Filters in Cron Execution History: You can now filter the executions listed in a cron's execution history based on the status or time of the executions. You can select a status such as Timeout or CodeException, and a time range such as the last 1 hour from drop-downs, to view executions matching these criteria.
Catalyst CLI v1.8.0 Release: Catalyst CLI v1.8.0 is out now with enhancements related to Node.js v12 and v14 versions, context-sensitive help, and the availability of IN DC while using the --dc option to execute a command from a specific data center.
Changes in Automatic Disabling of Cron After Repeated Failures: Catalyst automatically disabled a cron job that failed to execute successfully for 50 times in a row. We have now made enhancements to include this feature only for the crons associated with an external URL through webhooks, and not for crons associated with Cron Functions.
That is, a cron linked to a Cron Function will not be automatically disabled even after consecutive failures. You can check for a cron's execution history from the console, and disable it manually or perform fixes as needed.
Enhancements in Circuit Compilation Error Handling:Catalyst Circuits now includes compilation error handling. Catalyst performs a compilation error check in a circuit's configuration or structure right after you save the circuit. This will list the non-dependant and possible errors identified in a circuit's state configurations, design, and logic flow, even before you execute the circuit.
End of Free Trial: We are ending the free trial of the Catalyst accounts of existing production environment users on August 1, 2021. Users will be priced for their Catalyst usage from that point onward. Users who haven't used the production environment yet will be asked to set up their Catalyst payment method and add their payment details before they deploy their first project.
Complimentary Wallet Credits: We are pleased to offer $250 as complimentary wallet credits for all existing users. Users can use this credit amount for their Catalyst payments. This amount will be reflected in their Catalyst wallets on August 1, 2021, if they are existing production environment users. For others, the credits will be available in their wallet after they deploy their first project.
Minor Bug Fixes in Text Analytics: We have resolved an issue in the Text Analytics UI wherein certain keywords displayed in the Keyword Extraction section were not highlighted in some cases.
Text Analytics API, SDK, and Testing in the Console: Catalyst introduces Text Analytics as a Zia AI-driven service that processes textual content to perform these three operations on it: Sentiment Analysis, Named Entity Recognition, and Keyword Extraction. You can process text for these operations individually, or for all three together using the Java or Node.js SDK, and the APIs. You can also test them from the Catalyst console.Text Analytics- Help Page
Support for IN Data Center: Catalyst is now hosted in an IN data center and is accessible from an IN domain. IN users can now access the Catalyst remote console from the IN domain. The multi-DC support is also reflected while implementing Catalyst OAuth 2.0 Authentication to access the REST APIs. The base API URI of Catalyst APIs are changed accordingly. Refer to the Multi-DC Support API documentation. You can also disable or enable access to your application to users of the IN DC from the Zoho API console after registering your client.
Enhancements related to the IN data center are also reflected while logging into the Catalyst CLI. Catalyst SDK packages are also now compatible with the IN DC.
Note: Circuits and Push Notifications features will not be available for the users accessing from the IN DC.
Brand new Product Tour in the Catalyst Console: New users of the Catalyst console can now access a product tour that will navigate them across all the components, features, and settings available in the console with brief explanations. This guided walkthrough is designed to familiarize the user with the Catalyst environment, and help them get started with their application building.
Enhancements and Additional Features in Event Listeners: We have implemented new features in Event Listeners, such as Queued Events which display the events that are currently being processed, and Processed Events which contain the execution history of the processed events after they exit the queue.
The Event Listeners UI console has also undergone some upgrades that enhance and simplify the user experience, like the availability of the day's stats inside an event listener's page.
New Query Operations and Features in ZCQL:ZCQL now includes a host of new functionalities that will improve your coding experience. You can now perform data insertion, updation, and deletion operations on the Catalyst Data Store using ZCQL, in addition to the data retrieval operations. ZCQL also offers support for additional features such as the LIKE and BETWEEN operators in the WHERE clause, and partial data insertion.
Advanced Memory Configurations in Functions: Catalyst now enables you to configure memory allocations for each of your functions, while creating them. You can choose from a memory range of 128 MB to 512 MB to allocate for the function's execution.
The default memory allocated for a function is 256 MB. All the functions that you created prior to this feature availability will be allocated the default memory automatically. You can modify this any time you need from the console, or from the CLI using this command.
CLI Version v1.70 Release: Catalyst CLI has been upgraded to version v1.70 with an IN DC login option, and other enhancements.
Domain Mappings: You will now be able to work with Domain Mappings to map your own domain addresses with Catalyst applications only in the production environment of your project.
Minor changes in Java Compilation: Compiled Java function classes will now be available in the .output directory in your Java function's package.
Integration with Cliq through Integration Functions: Catalyst now supports a new function type called Integration Functions, which can be coded and used as the backend for other Zoho services. You can currently establish an integration with Zoho Cliq and build extensions that bundle the following Cliq internal tools: Bots, Commands, Message Actions, Widgets, and Functions. When these services are accessed in Cliq, it will automatically invoke the execution of the Integration function coded in the Catalyst through a HTTP call.Integration Functions
Inclusion of additional time ranges and other enhancements in Logs: You can now select a variety of time ranges to search for function logs, and also select a custom time range from a calendar and view records of the function executions in that range. You can also filter the logs of Cron and Event function executions by providing their unique Execution ID, and view details of that execution alone. We have also included direct links from Event Listeners and Cron executions to Catalyst Logs.
Bug-Fixes in Application Performance Monitoring: We have fixed a bug faced by some users that caused the inability to enable or disable APM after the initial start.
Bug- fixes in passing data in Functions: Catalyst now supports passing data of the content type application/x-www-form-urlencoded in the request body of a function call, and not in its query parameters as earlier.
Bug-Fixes in Function Executions: Fixes were made to address certain function execution failure issues, that was caused because of function calls and associated log activities being performed simultaneously. This issue had previously led to the function calls resulting in an error 500.
Minor bug-fixes in Logs: Fixes were made to address the issue that prevented certain users from viewing the logs of their function executions in the Production environment.
Bulk Write API: Performance optimizations were made in Bulk Write API
Support for EU Data Center: Catalyst is now hosted in a EU data center and is accessible from a EU domain. EU users can now access the Catalyst remote console from the EU domain. The multi-DC support is also reflected while implementing Catalyst OAuth 2.0 Authentication to access the REST APIs. The base API URI of Catalyst APIs are changed accordingly. Refer to the Multi-DC Support API documentation. You can also provide access to your application to users of a specific DC from the Zoho API console after registering your client.
Enhancements related to the EU data center are also reflected while logging into the Catalyst CLI. Catalyst SDK packages are also now compatible with the EU DC.
Note: Circuits and Push Notifications features are not available for the users accessing from the EU DC.
Changes in the domain of Catalyst application URLs: The app domain of all Catalyst application URLs will now be 'catalystserverless.com' instead of 'zohocatalyst.com'. That is, Catalyst application URLs will now be of the format "https://project-domain-name.catalystserverless.com".
This change will be automatically reflected in all your function and web client URLs of your previous and future Catalyst projects. URLs with the older app domain will still work for some time and will be deprecated soon after that. We will announce the date of deprecation shortly. You can find your application URLs of both the Development and Production environments in the Environments settings of your project. The resources that you deploy from the CLI will be deployed to URLs of the new domain.
Catalyst Web SDK version 2.0.0: We have now released a newer version of Catalyst Web SDK which comes with enhancements in the initialization script. You can now refer to an init.js file from your app's domain which will automatically populate the essential details of your project, such as the Project ID and ZAID for the appropriate environment. You can find the latest Web SDK script in the Developer Tools settings and in the Sign-in Method section of Authentication.
Major upgrades in Catalyst Android and iOS SDK Packages: We have revamped the Catalyst Android and iOS SDK packages to include a host of tools for Authentication, Data Store, Functions, and more. You will also now be able to register your mobile app packages in the Catalyst console to download the configuration files to include in your mobile apps. Refer to our revamped Android SDK documentation and iOS SDK documentation for help.
Profiles and Permissions: We have introduced a new permission to add or delete mobile SDK packages for Android and iOS apps from the console.
Testing Local Authentication from the CLI: We have provided enhancements to enable the authentication flow in your Catalyst applications to be tested locally using the catalyst serve command. You can now host and test web apps with iFrames in them, using the local server.
Login Redirect obtained from APIG: The login redirect value that you configure in your Catalyst applications will be fetched from API Gateway rules, if available, instead of the client-package.json file. If you have not configured API Gateway for your project, it will be fetched from client-package.json.
Login Redirect as URL: You can now provide the login redirect value in your Catalyst applications as a URL path instead of a direct resource, such as a HTML file.
CLI token Option: Bug-fixes were made to rectify unexpected errors that were occurring while using the CLI token option.
Security bug-fixes in Node.js SDK: We have addressed security issues pertaining to the user scope, and provided enhancements to strengthen the security in the admin scope in Node.js SDK.
Minor bug-fixes in Java SDK Connectors: Fixes were made to rectify Connectors throwing null pointer exceptions in the Java SDK.
Collaborators: You can now categorize Collaborators as project members or admins of the account, and grant permissions to project members through profiles.Collaborators
Profiles and Permissions: You can now assign profiles to project members and grant them specific sets of permissions that define their access to Catalyst features, for each project.Profiles and Permissions
CLI Shell: We have now implemented soft kill for the CLI Functions shell operations, if the user terminates a shell operation abruptly.
CLI Login: The server timeout for CLI login without browser has now been extended to 60 seconds from 30 seconds.
CLI Scripts: Catalyst now enables you to configure scripts for specific functions in the directory, and prevents the scripts from executing for the other functions.
CLI Serve: Minor bug-fixes and performance improvements were implemented in the catalyst serve command.
Catalyst Logs: We have enhanced Catalyst Logs to display contextual data relevant to the function stack that you select. Node.js functions now also have different log levels from those of Java functions.
Data Store: We have now included the Table ID of each table included under the table's name in the Data Store.
Web Client: The literal 'WebApp' has been changed to 'Web Client' in multiple places in the Catalyst console for standardization purposes.
AutoML: Some API calls were throwing the 400 error response in AutoML. This has been fixed.
Data Store: Some Encrypted column creation operations were throwing the 400 error response. This has been fixed.
API: The HTTP PATCH request method was not supported earlier. Catalyst now supports PATCH requests for certain APIs.