What is SuiteCloud SDK?
The SuiteCloud Software Development Kit (SuiteCloud SDK) is a collection of tools designed to streamline the development of SuiteCloud projects. These tools include SuiteCloud IDE plug-ins and command-line interfaces (CLIs), enabling developers to create, manage, and deploy NetSuite customizations efficiently.
The NetSuite 2025.1 release introduces significant updates and new features to SuiteCloud SDK, detailed below.
SuiteCloud SDK 2025.1 Features and Updates
The 2025.1 release of SuiteCloud SDK includes the following enhancements:
- Secure Credentials Storage for SuiteCloud SDK
- Removal of OAuth 1.0 Token-Based Authentication Support
- 2025.1 SuiteCloud Extension for Visual Studio Code Now Available
- 2025.1 SuiteCloud CLI for Node.js Now Available
- 2025.1 SuiteCloud IDE Plug-in for WebStorm Now Available
- 2025.1 SuiteCloud CLI for Java Now Available
Secure Credentials Storage for SuiteCloud SDK
Starting with the 2025.1 release, SuiteCloud SDK adopts Public-Key Cryptography Standards #12 (PKCS#12) to generate a password-protected credentials file. This enhances security and simplifies authentication workflows.
- How It Works:Upon first authentication with SuiteCloud SDK tools, a PKCS#12 credentials file is created and stored in the .suitecloud-sdk folder within your home directory.
- This encrypted file eliminates the need for repeated authentication in subsequent sessions.
- Passkey Management:Browser-Based Authentication: An auto-generated passkey is stored in your machine’s secure storage service (e.g., Windows Credential Manager, macOS Keychain, or Linux Keyring).
- Machine-to-Machine or Fallback Authentication: You must manually define the passkey using an environment variable.
- Important Note:The upcoming SuiteCloud SDK tools update (version 25.1 for SuiteCloud IDE Plug-in for WebStorm and SuiteCloud CLI for Java; version 3.0.X for SuiteCloud Extension for Visual Studio Code and SuiteCloud CLI for Node.js) will invalidate existing credentials files.
- After upgrading, you must reauthenticate to continue using these tools.
For more details, see Secure Credentials Storage for SuiteCloud SDK.
Removal of OAuth 1.0 Token-Based Authentication Support
Support for OAuth 1.0 and Token-Based Authentication (TBA) is being phased out:
- Timeline:As of February 2025, SuiteCloud SDK version 24.1 (the last version supporting OAuth 1.0/TBA) will no longer be available for new installations.
- Existing installations of version 24.1 and older will continue to function temporarily, but OAuth 1.0 support will eventually be fully removed, rendering these versions inoperable.
- Action Required:Upgrade to the latest SuiteCloud SDK version, which uses the OAuth 2.0 protocol for authorization, to ensure compatibility and security.
For more information, refer to Removal of OAuth 1.0 Token-Based Authentication Support in SuiteCloud SDK (SuiteAnswer ID 1019514).
New SuiteCloud SDK Tools for 2025.1
The following tools are now available with the 2025.1 release:
- 2025.1 SuiteCloud Extension for Visual Studio CodeDownload and installation details are available in Installing SuiteCloud Extension for Visual Studio Code.
- 2025.1 SuiteCloud CLI for Node.jsDownload and setup instructions can be found in Installing SuiteCloud CLI for Node.js.
- 2025.1 SuiteCloud IDE Plug-in for WebStormFully compatible with WebStorm 2024.3.2. See Update SuiteCloud IDE Plug-in for WebStorm for more information.
- 2025.1 SuiteCloud CLI for JavaInstallation guidance is provided in Installing SuiteCloud CLI for Java.
These tools enhance development workflows and align with the latest NetSuite 2025.1 features.
SuiteScript Updates in NetSuite 2025.1
SuiteScript, integrated with SuiteCloud SDK, also receives several updates in the 2025.1 release. Key changes include:
- Removal of the Ext JS LibraryThe unsupported Ext JS library is removed from NetSuite as of 2025.1.
- Customizations relying on Ext JS must be updated to either eliminate the dependency or use an external instance of the library.
- Test your updates by requesting early removal of Ext JS via NetSuite Customer Support.
- Changes to Audience Settings in Script Deployments and Single Page Applications (SPAs)New Behavior: Selecting “all roles” now applies only to internal roles. Internal and external roles are managed via separate multiselect fields.
- Script Deployment Updates:allroles (T = all internal roles).
- audslctrole (specify individual roles, including external; ignored for internal roles if allroles is T).
- Applies to: clientscript, massupdatescript, portlet, restlet, suitelet, usereventscript, workflowactionscript.
- SPA Updates:audienceallroles (T = all internal roles).
- audienceroles (specify individual roles, including external; ignored for internal roles if audienceallroles is T).
- Additional SuiteScript Enhancements:Removal of the Request Process for SPAs.
- New SuiteScript Generative AI API methods in the N/llm module.
- New SuiteScript tab on the AI Preferences page.
- Updates to hidden files and supported records.