Release javascript-modules 0.6.0/0.6.1

[GauBen]

✅ Summary

1. Minimum Jahia version
2. Testing matrix
3. Prepare checklist
4. Tests checklist
5. Publication checklist

Minimum Jahia version

We aim at reducing the possible deployment matrices by regularly bumping up the minimum Jahia version when releasing new versions of our modules.
When creating a Release ticket for a module, consult with your PM to identify the new minimum Jahia version this module must be associated with.
The default guideline is for a new module release to be compatible with the 2 previous releases.

Current Jahia Version: 8.2.0.0 (version currently in the POM)
Desired Jahia Version: 8.2.0.0

📜 Testing matrix

We aim at clearly documenting the possible deployment scenarios in a matrix and specify which ones are expected to be tested or not.
In the testing matrix, always use the latest patch version of a particular release

The following combinations should be validated:

Jahia 8.2.0.x

• Jahia 8.2.0.x
• javascript-modules-engine 0.6.0 (Artifact)

Luxe is not compatible with Jahia 8.2.0.x (discovered during testing)

Jahia 8.2.1.x

• Jahia 8.2.1.x
• javascript-modules-engine 0.6.0 (Artifact)
• luxe-jahia-demo 0.6.0 (Artifact) 0.6.1 (Artifact)
• luxe-prepackaged-site 0.6.0 (Artifact) 0.6.1 (Artifact)

ℹ️ If you are releasing for the main branch of a module, make sure to complete the checklist below when working on the ticket.

✏️ Prepare checklist

• All other tickets within that milestone are are closed
• Testing matrix and Minimum Jahia version are detailed
• Jahia-parent (minimum Jahia version) was updated if requested in the ticket
• The release workflow will publish a slack notification
• Release creation has been triggered from the Github Release UI (https://github.com/Jahia/[module-repo]/releases/new)

🚦 Tests checklist

General

• Manual tests detailing testing steps for validating the release of this module are present on Testrail
• Automated tests using the release artifacts were executed

Module migration

• Upgrade from the previous released version of the module was tested
• The upgrade did not require clearing the browser cache (i.e. missing labels)

While Testing

• Follow the new Getting Started guide and see if it works https://github.com/Jahia/javascript-modules/tree/main/docs/1-getting-started
• No warnings or errors are present in the browser console when testing the module
• No warnings or errors are present in Jahia logs when testing the module (incl. migration)
• Verified tickets present in the release are actually included in the release artifact
• testrail suite has been executed https://jahia.testrail.net/index.php?/runs/view/182259&group_by=cases:section_id&group_order=asc

After Testing

• Tested combinations (Jahia versions, modules versions) are listed in this released ticket
• Tested scenarios not detailed in Testrail are listed in this release ticket
• The version was updated in the Selenium integration tests

🚀 Publication checklist

• The release changelog was prepared
• In case of a major release, a Breaking Changes section is present in the Changelog
• The artifact was released on Nexus
• If applicable, corresponding academy pages were published
• The module was published on the store
• The modules releases log page on the Academy was updated
• A message was published on slack #releases channel
• The milestone on GitHub was closed

[ksagnard]

Blocked as we need a version of luxe-prepackaged-website compatible with luxe-jahia-demo and javascript-module-engine

[ksagnard]

Jahia 8.2.0.7

• first installation javascript-modules-engine 0.6.0
• upgrade from npm-module-engine 0.2.0 : after update luxe website can no longer be displayed, and can not be upgraded on this jahia version it is known issue but accepted like this
• T17244056 Installation
• T17244057 Update
• T17244058 Stop and restart
• T17244059 Execute javascript modules Tutorial - hello world > Hello world website from the tutorial is not woking on jahia 8.2.0.7 #246
• automated tests https://github.com/Jahia/javascript-modules/actions/runs/14260545279/job/39970974663

Jahia 8.2.1.0

• upgrade from 0.3.0
• import of luxe-jahia-demo 0.6.1
• deployement of luxe-prepackaged-site 0.6.1
• T17244056 Installation
• T17244057 Update
• T17244058 Stop and restart > label issue to confirm
• T17244059 Execute javascript modules Tutorial - hello world > documentation issue
• T17244061 Install javascript-modules-engine-test-module
• T17244062 Create site with content with javascript-modules-engine-test-module > no rendering for content-type imported by javascript-module-engine-test-module #247 and Missing icon in javascript-module-engine-test-module #248
• automated tests https://github.com/Jahia/javascript-modules/actions/runs/14245866816

Issues to address before completing the release ;
#246
https://github.com/Jahia/core-perf-test-terraform/issues/69

[Fgerthoffert]

Since we discovered that javascript-modules 0.6.0 is not compatible with Jahia 8.2.0.x (slack: https://jahia.slack.com/archives/C05TAKVKJHZ/p1743755647794769), we need to update the jahia-parent.

As soon as the restriction is in place, we'll re-trigger the release for a 0.6.1.

[jahia-ci]

If an issue is attached to a project starting with Product Team, it can only be closed if its has a Status of Done

code: INCORRECT_GITHUB_PROJECT_STATUS

[Fgerthoffert]

Javascript-modules 0.6.1 was re-released to include the jahia-parent restriction. It is now in staging and ready to be validated.

[ksagnard]

with Javascript-modules-engine 0.6.1

in jahia 8.2.0.7

• installation is no longer possible (as expected) : "The Jahia-Required-Version for this archive 8.2.1.0 does not match your current version 8.2.0.7"

in jahia 8.2.1.0

• Javascript-modules-engine 0.6.1 is installed and started as expected,
• luxe-jahia-demo and luxe-prepackaged-website are imported and started
• luxe website is deployed and correctly displayed in edit/ preview and live
• language switcher and login logout functionnalities works fine
• new npx module from tutorial is correctly imported
• new website from this template is correctly displayed in edit/ preview and live

[ksagnard]

READY FOR PUBLICATION