Add hardcoded trial license key

[sequba]

Context

https://app.clickup.com/t/9015210959/HF-116

How did you test your changes?

unit tests

Types of changes

• Breaking change (a fix or a feature because of which an existing functionality doesn't work as expected anymore)
• New feature or improvement (a non-breaking change that adds functionality)
• Bug fix (a non-breaking change that fixes an issue)
• Additional language file, or a change to an existing language file (translations)
• Change to the documentation

Checklist:

• I have reviewed the guidelines about Contributing to HyperFormula and I confirm that my code follows the code style of this project.
• I have signed the Contributor License Agreement.
• My change is compliant with the OpenDocument standard.
• My change is compatible with Microsoft Excel.
• My change is compatible with Google Sheets.
• I described my changes in the CHANGELOG.md file.
• My changes require a documentation update.
• My changes require a migration guide.

---

Note

High Risk
Updates license validation logic, a compliance-critical area, by adding a hardcoded key that will always be treated as valid; mistakes here could unintentionally bypass licensing checks.

Overview
Adds a new hardcoded trial license key (hftrial-0168e-1f2b7-47158-70b05-0842f) to the whitelist in checkLicenseKeyValidity, causing that exact value to be treated as valid without schema/expiry checks.

^{Reviewed by Cursor Bugbot for commit fd095ae. Bugbot is set up for automated code reviews on this repo. Configure here.}

[qunabu]

Task linked: HF-116 Hardocoded trial license-key

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Bugbot Autofix prepared a fix for the issue found in the latest run.

• ✅ Fixed: Trial license key never expires, behaves as permanent
  • Moved trial key from permanent license branch to separate expiration check with hardcoded expiry date (May 19, 2026).

Or push these changes by commenting:

@cursor push 199420175a

Preview (199420175a)

diff --git a/src/helpers/licenseKeyValidator.ts b/src/helpers/licenseKeyValidator.ts
--- a/src/helpers/licenseKeyValidator.ts
+++ b/src/helpers/licenseKeyValidator.ts
@@ -54,9 +54,23 @@
     vars: {},
   }
 
-  if (licenseKey === 'gpl-v3' || licenseKey === 'internal-use-in-handsontable' || licenseKey === 'hftrial-0168e-1f2b7-47158-70b05-0842f') {
+  if (licenseKey === 'gpl-v3' || licenseKey === 'internal-use-in-handsontable') {
     messageDescriptor.template = LicenseKeyValidityState.VALID
 
+  } else if (licenseKey === 'hftrial-0168e-1f2b7-47158-70b05-0842f') {
+    const [day, month, year] = (process.env.HT_RELEASE_DATE || '').split('/')
+    const releaseDays = Math.floor(new Date(`${month}/${day}/${year}`).getTime() / 8.64e7)
+    const trialExpiryDate = new Date('05/19/2026')
+    const trialExpiryDays = Math.floor(trialExpiryDate.getTime() / 8.64e7)
+
+    messageDescriptor.vars.keyValidityDate = formatDate(trialExpiryDate)
+
+    if (releaseDays > trialExpiryDays) {
+      messageDescriptor.template = LicenseKeyValidityState.EXPIRED
+    } else {
+      messageDescriptor.template = LicenseKeyValidityState.VALID
+    }
+
   } else if (typeof licenseKey === 'string' && checkKeySchema(licenseKey)) {
     const [day, month, year] = (process.env.HT_RELEASE_DATE || '').split('/')
     const releaseDays = Math.floor(new Date(`${month}/${day}/${year}`).getTime() / 8.64e7)

_{This Bugbot Autofix run was free. To enable autofix for future PRs, go to the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 755686a. Configure here.}

[cursor]

Trial license key never expires, behaves as permanent

High Severity

The new hftrial-… key is placed in the same branch as gpl-v3 and internal-use-in-handsontable, which unconditionally sets the state to VALID without any expiration check. Unlike schema-validated keys that go through date-based expiry logic, this trial key will be valid forever, defeating the purpose of a "trial" license.

 

^{Reviewed by Cursor Bugbot for commit 755686a. Configure here.}

[sequba]

let's keep it like that

[github-actions]

Performance comparison of head (fd095ae) vs base (357eee3)

                                     testName |   base |   head | change
------------------------------------------------------------------------
                                      Sheet A | 475.75 |  478.1 | +0.49%
                                      Sheet B | 153.39 | 155.55 | +1.41%
                                      Sheet T | 140.15 | 140.38 | +0.16%
                                Column ranges | 550.49 | 555.81 | +0.97%
Sheet A:  change value, add/remove row/column |  15.83 |  15.77 | -0.38%
 Sheet B: change value, add/remove row/column | 137.67 |  132.6 | -3.68%
                   Column ranges - add column | 167.94 | 160.95 | -4.16%
                Column ranges - without batch | 522.66 | 503.58 | -3.65%
                        Column ranges - batch | 126.66 | 125.65 | -0.80%

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.19%. Comparing base (357eee3) to head (fd095ae).
⚠️ Report is 1 commits behind head on develop.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #1649   +/-   ##
========================================
  Coverage    97.19%   97.19%           
========================================
  Files          173      173           
  Lines        15013    15013           
  Branches      3209     3209           
========================================
  Hits         14592    14592           
  Misses         421      421           

Files with missing lines	Coverage Δ
src/helpers/licenseKeyValidator.ts	90.32% <100.00%> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.