Validate SSEs
The server-side extension framework performs validation checks on SSEs to avoid conflicts and errors.
This section applies to Open Storefront Framework (OSF) and Storefront Classic.
By default, the SSE framework checks the authenticatedUrls
and publicUrls
property in each SSE's package.json
file to determine whether the SSE has at least one URL that is registered with the main
Express application. If it does, the SSE is considered valid. If at least one SSE
running on the server is valid, network traffic can be routed to the server.
You can disable this checking for an individual SSE by setting the
validateModule
property in the package.json
file
to false
:
{
"validateModule" : false,
...
}
Commerce also checks whether your SSE ZIP file includes libraries that are part of the
server-side extension framework, such as Express, Winston, Nconf, or Moment. If these
modules are included in your node_modules
folder, they may cause
unpredictable behavior, because the SSE framework will use the local
node_modules
copy instead of the global copy. The SSE framework
produces a warning if you upload an SSE that includes one or more of these modules. The
framework also warns if an SSE's proxy configuration is invalid.