@mui/x-license 9.0.0-alpha.0 → 9.0.0-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-license",
-  "version": "9.0.0-alpha.0",
+  "version": "9.0.0-alpha.2",
   "author": "MUI Team",
   "description": "MUI X License verification.",
   "license": "SEE LICENSE IN LICENSE",
@@ -23,8 +23,8 @@
   "dependencies": {
     "@babel/runtime": "^7.28.6",
     "@mui/utils": "^7.3.7",
-    "@mui/x-internals": "9.0.0-alpha.0",
-    "@mui/x-telemetry": "9.0.0-alpha.0"
+    "@mui/x-internals": "9.0.0-alpha.2",
+    "@mui/x-telemetry": "9.0.0-alpha.2"
   },
   "peerDependencies": {
     "react": "^17.0.0 || ^18.0.0 || ^19.0.0"
@@ -33,30 +33,121 @@
     "node": ">=14.0.0"
   },
   "type": "commonjs",
-  "main": "./index.js",
-  "types": "./index.d.ts",
   "exports": {
     "./package.json": "./package.json",
     ".": {
+      "import": {
+        "types": "./index.d.mts",
+        "default": "./index.mjs"
+      },
       "require": {
         "types": "./index.d.ts",
         "default": "./index.js"
       },
       "default": {
-        "types": "./esm/index.d.ts",
-        "default": "./esm/index.js"
+        "types": "./index.d.mts",
+        "default": "./index.mjs"
+      }
+    },
+    "./Watermark": {
+      "import": {
+        "types": "./Watermark/index.d.mts",
+        "default": "./Watermark/index.mjs"
+      },
+      "require": {
+        "types": "./Watermark/index.d.ts",
+        "default": "./Watermark/index.js"
+      },
+      "default": {
+        "types": "./Watermark/index.d.mts",
+        "default": "./Watermark/index.mjs"
+      }
+    },
+    "./useLicenseVerifier": {
+      "import": {
+        "types": "./useLicenseVerifier/index.d.mts",
+        "default": "./useLicenseVerifier/index.mjs"
+      },
+      "require": {
+        "types": "./useLicenseVerifier/index.d.ts",
+        "default": "./useLicenseVerifier/index.js"
+      },
+      "default": {
+        "types": "./useLicenseVerifier/index.d.mts",
+        "default": "./useLicenseVerifier/index.mjs"
+      }
+    },
+    "./verifyLicense": {
+      "import": {
+        "types": "./verifyLicense/index.d.mts",
+        "default": "./verifyLicense/index.mjs"
+      },
+      "require": {
+        "types": "./verifyLicense/index.d.ts",
+        "default": "./verifyLicense/index.js"
+      },
+      "default": {
+        "types": "./verifyLicense/index.d.mts",
+        "default": "./verifyLicense/index.mjs"
       }
     },
-    "./*": {
+    "./utils": {
+      "import": {
+        "types": "./utils/index.d.mts",
+        "default": "./utils/index.mjs"
+      },
+      "require": {
+        "types": "./utils/index.d.ts",
+        "default": "./utils/index.js"
+      },
+      "default": {
+        "types": "./utils/index.d.mts",
+        "default": "./utils/index.mjs"
+      }
+    },
+    "./test-keys": {
+      "import": {
+        "types": "./test-keys.d.mts",
+        "default": "./test-keys.mjs"
+      },
+      "require": {
+        "types": "./test-keys.d.ts",
+        "default": "./test-keys.js"
+      },
+      "default": {
+        "types": "./test-keys.d.mts",
+        "default": "./test-keys.mjs"
+      }
+    },
+    "./Unstable_LicenseInfoProvider": {
+      "import": {
+        "types": "./Unstable_LicenseInfoProvider/index.d.mts",
+        "default": "./Unstable_LicenseInfoProvider/index.mjs"
+      },
       "require": {
-        "types": "./*/index.d.ts",
-        "default": "./*/index.js"
+        "types": "./Unstable_LicenseInfoProvider/index.d.ts",
+        "default": "./Unstable_LicenseInfoProvider/index.js"
       },
       "default": {
-        "types": "./esm/*/index.d.ts",
-        "default": "./esm/*/index.js"
+        "types": "./Unstable_LicenseInfoProvider/index.d.mts",
+        "default": "./Unstable_LicenseInfoProvider/index.mjs"
       }
     },
-    "./esm": null
-  }
+    "./encoding": {
+      "import": {
+        "types": "./encoding/index.d.mts",
+        "default": "./encoding/index.mjs"
+      },
+      "require": {
+        "types": "./encoding/index.d.ts",
+        "default": "./encoding/index.js"
+      },
+      "default": {
+        "types": "./encoding/index.d.mts",
+        "default": "./encoding/index.mjs"
+      }
+    }
+  },
+  "main": "./index.js",
+  "types": "./index.d.ts"
 }

package/test-keys.d.mts

@@ -0,0 +1,92 @@
+/**
+ * Test Premium license key.
+ * orderId: #123, scope: premium, licenseModel: annual, planVersion: Q3-2024
+ * keyVersion: 2, expiryDate: 2099-12-30T23:00:00.000Z
+ */
+export declare const TEST_LICENSE_KEY_PREMIUM = "715a2f48d6140e8e6f2484e6c4b981aeTz0xMjMsRT00MTAyMzU0ODAwMDAwLFM9cHJlbWl1bSxMTT1hbm51YWwsUFY9UTMtMjAyNCxUPXRydWUsS1Y9Mg==";
+/**
+ * Test Pro license key.
+ * orderId: #123, scope: pro, licenseModel: annual, planVersion: Q3-2024
+ * keyVersion: 2, expiryDate: 2099-12-30T23:00:00.000Z
+ */
+export declare const TEST_LICENSE_KEY_PRO = "8d0500f3fe93ffea84445b2aed17c59cTz0xMjMsRT00MTAyMzU0ODAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1RMy0yMDI0LFQ9dHJ1ZSxLVj0y";
+/**
+ * Key version 1 format (pro, perpetual, initial implied).
+ * orderId: #123, expiryDate: 2026-08-02
+ */
+export declare const TEST_KEY_V1 = "8f5bd7d70e4d7aeecd1d5b9d0d1759bbT1JERVI6MTIzLEVYUElSWT0xNzg1ODc0MDEwNzA4LFQ9dHJ1ZSxLRVlWRVJTSU9OPTE=";
+/**
+ * Pro subscription, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PRO_SUBSCRIPTION = "b4cb282aa165b05f65f70a4caddadc81Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPXN1YnNjcmlwdGlvbixQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y";
+/**
+ * Premium subscription, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PREMIUM_SUBSCRIPTION = "22bd1051015e3c663f8ca5cba9ebe56aTz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJlbWl1bSxMTT1zdWJzY3JpcHRpb24sUFY9aW5pdGlhbCxUPXRydWUsS1Y9Mg==";
+/**
+ * Pro perpetual, initial, expiry = releaseDate + 1 day (valid).
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PRO_PERPETUAL = "f4221ac32d1b8b102c143dcf65080414Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y";
+/**
+ * Pro perpetual, initial, expiry = releaseDate - 1 day (expired before release).
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PRO_PERPETUAL_EXPIRED = "64245e2bb861fc92856e682b32dc8bf2Tz0xMjMsRT0xNTE0NTg4NDAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y";
+/**
+ * Pro annual, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PRO_ANNUAL_INITIAL = "d82e3196c55fc5dc21a4145b796a77a7Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y";
+/**
+ * Premium annual, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PREMIUM_ANNUAL_INITIAL = "8fc9fa79e1b5f30ce737ccec8f3e36f4Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJlbWl1bSxMTT1hbm51YWwsUFY9aW5pdGlhbCxUPXRydWUsS1Y9Mg==";
+/**
+ * Pro subscription, initial, expiry = 2024-06-14 (fakeNow - 1 day, within grace period).
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_EXPIRED_GRACE = "84dcbd1c5a6169c74e6c70ec23e0df55Tz0xMjMsRT0xNzE4MzIzMjAwMDAwLFM9cHJvLExNPXN1YnNjcmlwdGlvbixQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y";
+/**
+ * Pro subscription, initial, expiry = 2024-05-16 (fakeNow - 30 days, past grace period).
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_EXPIRED_30DAYS = "4081d3863dda2ca60be4a5b29f582117Tz0xMjMsRT0xNzE1ODE3NjAwMDAwLFM9cHJvLExNPXN1YnNjcmlwdGlvbixQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y";
+/**
+ * Pro subscription, initial, expiry = 3001-01-01.
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PRO_SUBSCRIPTION_FUTURE = "e83a283135bbd911e4aa0fd55ceea3ebTz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXBybyxMTT1zdWJzY3JpcHRpb24sUFY9aW5pdGlhbCxUPXRydWUsS1Y9Mg==";
+/**
+ * Premium subscription, initial, expiry = 3001-01-01.
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PREMIUM_SUBSCRIPTION_FUTURE = "1c6ea00fadedfcb3f2ef393f1de32f29Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXByZW1pdW0sTE09c3Vic2NyaXB0aW9uLFBWPWluaXRpYWwsVD10cnVlLEtWPTI=";
+/**
+ * Pro annual, Q3-2024, quantity: 5, appType: single.
+ * orderId: #123, keyVersion: 3, expiryDate: 2099-12-30T23:00:00.000Z
+ */
+export declare const TEST_KEY_PRO_ANNUAL_V3 = "521a75b4cf0d0c5e8990ce070886e167Tz0xMjMsRT00MTAyMzU0ODAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1RMy0yMDI0LFE9NSxBVD1zaW5nbGUsVD10cnVlLEtWPTM=";
+/**
+ * Pro annual, Q1-2026, quantity: 5, appType: single.
+ * orderId: #123, keyVersion: 3, expiryDate: 3001-01-01
+ */
+export declare const TEST_KEY_PRO_ANNUAL_Q1_2026_V3 = "5f52871b5845f28ebdd0fabbe0b89695Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXBybyxMTT1hbm51YWwsUFY9UTEtMjAyNixRPTUsQVQ9c2luZ2xlLFQ9dHJ1ZSxLVj0z";
+/**
+ * Premium annual, Q1-2026, quantity: 10, appType: single.
+ * orderId: #123, keyVersion: 3, expiryDate: 3001-01-01
+ */
+export declare const TEST_KEY_PREMIUM_ANNUAL_Q1_2026_V3 = "450d9fc1b28e709fcb73969bd10e1c30Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXByZW1pdW0sTE09YW5udWFsLFBWPVExLTIwMjYsUT0xMCxBVD1zaW5nbGUsVD10cnVlLEtWPTM=";
+/**
+ * Invalid key: hash does not match payload (tampered).
+ * Used to test that verifyLicense rejects tampered keys.
+ */
+export declare const TEST_KEY_INVALID = "c0b3c1c31055976260628def9b697020TkFNRTpNYC1VSSBTQVMsREVWRUxPUEVSX0NPVU5UPTEwLEVYUElSWT0xNTkxNzIzMDY3MDQyLFZFUlNJT049MS4yLjMsVD10cnVl";
+/**
+ * Valid hash but unknown key version (KV=99).
+ * Used to test that decodeLicense returns null for unrecognized versions.
+ */
+export declare const TEST_KEY_UNKNOWN_VERSION = "64152474c774ae343484f08bbbc1a231Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj05OQ==";

package/test-keys.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Test Premium license key.
+ * orderId: #123, scope: premium, licenseModel: annual, planVersion: Q3-2024
+ * keyVersion: 2, expiryDate: 2099-12-30T23:00:00.000Z
+ */
+export declare const TEST_LICENSE_KEY_PREMIUM = "715a2f48d6140e8e6f2484e6c4b981aeTz0xMjMsRT00MTAyMzU0ODAwMDAwLFM9cHJlbWl1bSxMTT1hbm51YWwsUFY9UTMtMjAyNCxUPXRydWUsS1Y9Mg==";
+/**
+ * Test Pro license key.
+ * orderId: #123, scope: pro, licenseModel: annual, planVersion: Q3-2024
+ * keyVersion: 2, expiryDate: 2099-12-30T23:00:00.000Z
+ */
+export declare const TEST_LICENSE_KEY_PRO = "8d0500f3fe93ffea84445b2aed17c59cTz0xMjMsRT00MTAyMzU0ODAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1RMy0yMDI0LFQ9dHJ1ZSxLVj0y";
+/**
+ * Key version 1 format (pro, perpetual, initial implied).
+ * orderId: #123, expiryDate: 2026-08-02
+ */
+export declare const TEST_KEY_V1 = "8f5bd7d70e4d7aeecd1d5b9d0d1759bbT1JERVI6MTIzLEVYUElSWT0xNzg1ODc0MDEwNzA4LFQ9dHJ1ZSxLRVlWRVJTSU9OPTE=";
+/**
+ * Pro subscription, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PRO_SUBSCRIPTION = "b4cb282aa165b05f65f70a4caddadc81Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPXN1YnNjcmlwdGlvbixQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y";
+/**
+ * Premium subscription, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PREMIUM_SUBSCRIPTION = "22bd1051015e3c663f8ca5cba9ebe56aTz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJlbWl1bSxMTT1zdWJzY3JpcHRpb24sUFY9aW5pdGlhbCxUPXRydWUsS1Y9Mg==";
+/**
+ * Pro perpetual, initial, expiry = releaseDate + 1 day (valid).
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PRO_PERPETUAL = "f4221ac32d1b8b102c143dcf65080414Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y";
+/**
+ * Pro perpetual, initial, expiry = releaseDate - 1 day (expired before release).
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PRO_PERPETUAL_EXPIRED = "64245e2bb861fc92856e682b32dc8bf2Tz0xMjMsRT0xNTE0NTg4NDAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y";
+/**
+ * Pro annual, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PRO_ANNUAL_INITIAL = "d82e3196c55fc5dc21a4145b796a77a7Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y";
+/**
+ * Premium annual, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PREMIUM_ANNUAL_INITIAL = "8fc9fa79e1b5f30ce737ccec8f3e36f4Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJlbWl1bSxMTT1hbm51YWwsUFY9aW5pdGlhbCxUPXRydWUsS1Y9Mg==";
+/**
+ * Pro subscription, initial, expiry = 2024-06-14 (fakeNow - 1 day, within grace period).
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_EXPIRED_GRACE = "84dcbd1c5a6169c74e6c70ec23e0df55Tz0xMjMsRT0xNzE4MzIzMjAwMDAwLFM9cHJvLExNPXN1YnNjcmlwdGlvbixQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y";
+/**
+ * Pro subscription, initial, expiry = 2024-05-16 (fakeNow - 30 days, past grace period).
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_EXPIRED_30DAYS = "4081d3863dda2ca60be4a5b29f582117Tz0xMjMsRT0xNzE1ODE3NjAwMDAwLFM9cHJvLExNPXN1YnNjcmlwdGlvbixQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y";
+/**
+ * Pro subscription, initial, expiry = 3001-01-01.
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PRO_SUBSCRIPTION_FUTURE = "e83a283135bbd911e4aa0fd55ceea3ebTz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXBybyxMTT1zdWJzY3JpcHRpb24sUFY9aW5pdGlhbCxUPXRydWUsS1Y9Mg==";
+/**
+ * Premium subscription, initial, expiry = 3001-01-01.
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PREMIUM_SUBSCRIPTION_FUTURE = "1c6ea00fadedfcb3f2ef393f1de32f29Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXByZW1pdW0sTE09c3Vic2NyaXB0aW9uLFBWPWluaXRpYWwsVD10cnVlLEtWPTI=";
+/**
+ * Pro annual, Q3-2024, quantity: 5, appType: single.
+ * orderId: #123, keyVersion: 3, expiryDate: 2099-12-30T23:00:00.000Z
+ */
+export declare const TEST_KEY_PRO_ANNUAL_V3 = "521a75b4cf0d0c5e8990ce070886e167Tz0xMjMsRT00MTAyMzU0ODAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1RMy0yMDI0LFE9NSxBVD1zaW5nbGUsVD10cnVlLEtWPTM=";
+/**
+ * Pro annual, Q1-2026, quantity: 5, appType: single.
+ * orderId: #123, keyVersion: 3, expiryDate: 3001-01-01
+ */
+export declare const TEST_KEY_PRO_ANNUAL_Q1_2026_V3 = "5f52871b5845f28ebdd0fabbe0b89695Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXBybyxMTT1hbm51YWwsUFY9UTEtMjAyNixRPTUsQVQ9c2luZ2xlLFQ9dHJ1ZSxLVj0z";
+/**
+ * Premium annual, Q1-2026, quantity: 10, appType: single.
+ * orderId: #123, keyVersion: 3, expiryDate: 3001-01-01
+ */
+export declare const TEST_KEY_PREMIUM_ANNUAL_Q1_2026_V3 = "450d9fc1b28e709fcb73969bd10e1c30Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXByZW1pdW0sTE09YW5udWFsLFBWPVExLTIwMjYsUT0xMCxBVD1zaW5nbGUsVD10cnVlLEtWPTM=";
+/**
+ * Invalid key: hash does not match payload (tampered).
+ * Used to test that verifyLicense rejects tampered keys.
+ */
+export declare const TEST_KEY_INVALID = "c0b3c1c31055976260628def9b697020TkFNRTpNYC1VSSBTQVMsREVWRUxPUEVSX0NPVU5UPTEwLEVYUElSWT0xNTkxNzIzMDY3MDQyLFZFUlNJT049MS4yLjMsVD10cnVl";
+/**
+ * Valid hash but unknown key version (KV=99).
+ * Used to test that decodeLicense returns null for unrecognized versions.
+ */
+export declare const TEST_KEY_UNKNOWN_VERSION = "64152474c774ae343484f08bbbc1a231Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj05OQ==";

package/test-keys.js

@@ -0,0 +1,135 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TEST_LICENSE_KEY_PRO = exports.TEST_LICENSE_KEY_PREMIUM = exports.TEST_KEY_V1 = exports.TEST_KEY_UNKNOWN_VERSION = exports.TEST_KEY_PRO_SUBSCRIPTION_FUTURE = exports.TEST_KEY_PRO_SUBSCRIPTION = exports.TEST_KEY_PRO_PERPETUAL_EXPIRED = exports.TEST_KEY_PRO_PERPETUAL = exports.TEST_KEY_PRO_ANNUAL_V3 = exports.TEST_KEY_PRO_ANNUAL_Q1_2026_V3 = exports.TEST_KEY_PRO_ANNUAL_INITIAL = exports.TEST_KEY_PREMIUM_SUBSCRIPTION_FUTURE = exports.TEST_KEY_PREMIUM_SUBSCRIPTION = exports.TEST_KEY_PREMIUM_ANNUAL_Q1_2026_V3 = exports.TEST_KEY_PREMIUM_ANNUAL_INITIAL = exports.TEST_KEY_INVALID = exports.TEST_KEY_EXPIRED_GRACE = exports.TEST_KEY_EXPIRED_30DAYS = void 0;
+// =============================================================================
+// Test license keys for use in test suites.
+// All keys contain T=true in their payload and are rejected outside test environments.
+// Import via '@mui/x-license/test-keys'.
+// =============================================================================
+
+/**
+ * Test Premium license key.
+ * orderId: #123, scope: premium, licenseModel: annual, planVersion: Q3-2024
+ * keyVersion: 2, expiryDate: 2099-12-30T23:00:00.000Z
+ */
+const TEST_LICENSE_KEY_PREMIUM = exports.TEST_LICENSE_KEY_PREMIUM = '715a2f48d6140e8e6f2484e6c4b981aeTz0xMjMsRT00MTAyMzU0ODAwMDAwLFM9cHJlbWl1bSxMTT1hbm51YWwsUFY9UTMtMjAyNCxUPXRydWUsS1Y9Mg==';
+
+/**
+ * Test Pro license key.
+ * orderId: #123, scope: pro, licenseModel: annual, planVersion: Q3-2024
+ * keyVersion: 2, expiryDate: 2099-12-30T23:00:00.000Z
+ */
+const TEST_LICENSE_KEY_PRO = exports.TEST_LICENSE_KEY_PRO = '8d0500f3fe93ffea84445b2aed17c59cTz0xMjMsRT00MTAyMzU0ODAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1RMy0yMDI0LFQ9dHJ1ZSxLVj0y';
+
+// --- Key format v1 ---
+
+/**
+ * Key version 1 format (pro, perpetual, initial implied).
+ * orderId: #123, expiryDate: 2026-08-02
+ */
+const TEST_KEY_V1 = exports.TEST_KEY_V1 = '8f5bd7d70e4d7aeecd1d5b9d0d1759bbT1JERVI6MTIzLEVYUElSWT0xNzg1ODc0MDEwNzA4LFQ9dHJ1ZSxLRVlWRVJTSU9OPTE=';
+
+// --- Keys for verifyLicense tests (paired with releaseDate = 2018-01-01) ---
+
+/**
+ * Pro subscription, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+const TEST_KEY_PRO_SUBSCRIPTION = exports.TEST_KEY_PRO_SUBSCRIPTION = 'b4cb282aa165b05f65f70a4caddadc81Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPXN1YnNjcmlwdGlvbixQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y';
+
+/**
+ * Premium subscription, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+const TEST_KEY_PREMIUM_SUBSCRIPTION = exports.TEST_KEY_PREMIUM_SUBSCRIPTION = '22bd1051015e3c663f8ca5cba9ebe56aTz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJlbWl1bSxMTT1zdWJzY3JpcHRpb24sUFY9aW5pdGlhbCxUPXRydWUsS1Y9Mg==';
+
+/**
+ * Pro perpetual, initial, expiry = releaseDate + 1 day (valid).
+ * orderId: #123, keyVersion: 2
+ */
+const TEST_KEY_PRO_PERPETUAL = exports.TEST_KEY_PRO_PERPETUAL = 'f4221ac32d1b8b102c143dcf65080414Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y';
+
+/**
+ * Pro perpetual, initial, expiry = releaseDate - 1 day (expired before release).
+ * orderId: #123, keyVersion: 2
+ */
+const TEST_KEY_PRO_PERPETUAL_EXPIRED = exports.TEST_KEY_PRO_PERPETUAL_EXPIRED = '64245e2bb861fc92856e682b32dc8bf2Tz0xMjMsRT0xNTE0NTg4NDAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y';
+
+/**
+ * Pro annual, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+const TEST_KEY_PRO_ANNUAL_INITIAL = exports.TEST_KEY_PRO_ANNUAL_INITIAL = 'd82e3196c55fc5dc21a4145b796a77a7Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y';
+
+/**
+ * Premium annual, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+const TEST_KEY_PREMIUM_ANNUAL_INITIAL = exports.TEST_KEY_PREMIUM_ANNUAL_INITIAL = '8fc9fa79e1b5f30ce737ccec8f3e36f4Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJlbWl1bSxMTT1hbm51YWwsUFY9aW5pdGlhbCxUPXRydWUsS1Y9Mg==';
+
+// --- Keys for time-sensitive tests (used with vi.useFakeTimers, fakeNow = 2024-06-15) ---
+
+/**
+ * Pro subscription, initial, expiry = 2024-06-14 (fakeNow - 1 day, within grace period).
+ * orderId: #123, keyVersion: 2
+ */
+const TEST_KEY_EXPIRED_GRACE = exports.TEST_KEY_EXPIRED_GRACE = '84dcbd1c5a6169c74e6c70ec23e0df55Tz0xMjMsRT0xNzE4MzIzMjAwMDAwLFM9cHJvLExNPXN1YnNjcmlwdGlvbixQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y';
+
+/**
+ * Pro subscription, initial, expiry = 2024-05-16 (fakeNow - 30 days, past grace period).
+ * orderId: #123, keyVersion: 2
+ */
+const TEST_KEY_EXPIRED_30DAYS = exports.TEST_KEY_EXPIRED_30DAYS = '4081d3863dda2ca60be4a5b29f582117Tz0xMjMsRT0xNzE1ODE3NjAwMDAwLFM9cHJvLExNPXN1YnNjcmlwdGlvbixQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y';
+
+// --- Keys for useLicenseVerifier plan combination tests (initial planVersion, far-future expiry) ---
+
+/**
+ * Pro subscription, initial, expiry = 3001-01-01.
+ * orderId: #123, keyVersion: 2
+ */
+const TEST_KEY_PRO_SUBSCRIPTION_FUTURE = exports.TEST_KEY_PRO_SUBSCRIPTION_FUTURE = 'e83a283135bbd911e4aa0fd55ceea3ebTz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXBybyxMTT1zdWJzY3JpcHRpb24sUFY9aW5pdGlhbCxUPXRydWUsS1Y9Mg==';
+
+/**
+ * Premium subscription, initial, expiry = 3001-01-01.
+ * orderId: #123, keyVersion: 2
+ */
+const TEST_KEY_PREMIUM_SUBSCRIPTION_FUTURE = exports.TEST_KEY_PREMIUM_SUBSCRIPTION_FUTURE = '1c6ea00fadedfcb3f2ef393f1de32f29Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXByZW1pdW0sTE09c3Vic2NyaXB0aW9uLFBWPWluaXRpYWwsVD10cnVlLEtWPTI=';
+
+// --- Key format v3 ---
+
+/**
+ * Pro annual, Q3-2024, quantity: 5, appType: single.
+ * orderId: #123, keyVersion: 3, expiryDate: 2099-12-30T23:00:00.000Z
+ */
+const TEST_KEY_PRO_ANNUAL_V3 = exports.TEST_KEY_PRO_ANNUAL_V3 = '521a75b4cf0d0c5e8990ce070886e167Tz0xMjMsRT00MTAyMzU0ODAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1RMy0yMDI0LFE9NSxBVD1zaW5nbGUsVD10cnVlLEtWPTM=';
+
+// --- Key format v3 Q1-2026 ---
+
+/**
+ * Pro annual, Q1-2026, quantity: 5, appType: single.
+ * orderId: #123, keyVersion: 3, expiryDate: 3001-01-01
+ */
+const TEST_KEY_PRO_ANNUAL_Q1_2026_V3 = exports.TEST_KEY_PRO_ANNUAL_Q1_2026_V3 = '5f52871b5845f28ebdd0fabbe0b89695Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXBybyxMTT1hbm51YWwsUFY9UTEtMjAyNixRPTUsQVQ9c2luZ2xlLFQ9dHJ1ZSxLVj0z';
+
+/**
+ * Premium annual, Q1-2026, quantity: 10, appType: single.
+ * orderId: #123, keyVersion: 3, expiryDate: 3001-01-01
+ */
+const TEST_KEY_PREMIUM_ANNUAL_Q1_2026_V3 = exports.TEST_KEY_PREMIUM_ANNUAL_Q1_2026_V3 = '450d9fc1b28e709fcb73969bd10e1c30Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXByZW1pdW0sTE09YW5udWFsLFBWPVExLTIwMjYsUT0xMCxBVD1zaW5nbGUsVD10cnVlLEtWPTM=';
+
+// --- Invalid / edge-case keys ---
+
+/**
+ * Invalid key: hash does not match payload (tampered).
+ * Used to test that verifyLicense rejects tampered keys.
+ */
+const TEST_KEY_INVALID = exports.TEST_KEY_INVALID = 'c0b3c1c31055976260628def9b697020TkFNRTpNYC1VSSBTQVMsREVWRUxPUEVSX0NPVU5UPTEwLEVYUElSWT0xNTkxNzIzMDY3MDQyLFZFUlNJT049MS4yLjMsVD10cnVl';
+
+/**
+ * Valid hash but unknown key version (KV=99).
+ * Used to test that decodeLicense returns null for unrecognized versions.
+ */
+const TEST_KEY_UNKNOWN_VERSION = exports.TEST_KEY_UNKNOWN_VERSION = '64152474c774ae343484f08bbbc1a231Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj05OQ==';

package/test-keys.mjs

@@ -0,0 +1,129 @@
+// =============================================================================
+// Test license keys for use in test suites.
+// All keys contain T=true in their payload and are rejected outside test environments.
+// Import via '@mui/x-license/test-keys'.
+// =============================================================================
+
+/**
+ * Test Premium license key.
+ * orderId: #123, scope: premium, licenseModel: annual, planVersion: Q3-2024
+ * keyVersion: 2, expiryDate: 2099-12-30T23:00:00.000Z
+ */
+export const TEST_LICENSE_KEY_PREMIUM = '715a2f48d6140e8e6f2484e6c4b981aeTz0xMjMsRT00MTAyMzU0ODAwMDAwLFM9cHJlbWl1bSxMTT1hbm51YWwsUFY9UTMtMjAyNCxUPXRydWUsS1Y9Mg==';
+
+/**
+ * Test Pro license key.
+ * orderId: #123, scope: pro, licenseModel: annual, planVersion: Q3-2024
+ * keyVersion: 2, expiryDate: 2099-12-30T23:00:00.000Z
+ */
+export const TEST_LICENSE_KEY_PRO = '8d0500f3fe93ffea84445b2aed17c59cTz0xMjMsRT00MTAyMzU0ODAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1RMy0yMDI0LFQ9dHJ1ZSxLVj0y';
+
+// --- Key format v1 ---
+
+/**
+ * Key version 1 format (pro, perpetual, initial implied).
+ * orderId: #123, expiryDate: 2026-08-02
+ */
+export const TEST_KEY_V1 = '8f5bd7d70e4d7aeecd1d5b9d0d1759bbT1JERVI6MTIzLEVYUElSWT0xNzg1ODc0MDEwNzA4LFQ9dHJ1ZSxLRVlWRVJTSU9OPTE=';
+
+// --- Keys for verifyLicense tests (paired with releaseDate = 2018-01-01) ---
+
+/**
+ * Pro subscription, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+export const TEST_KEY_PRO_SUBSCRIPTION = 'b4cb282aa165b05f65f70a4caddadc81Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPXN1YnNjcmlwdGlvbixQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y';
+
+/**
+ * Premium subscription, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+export const TEST_KEY_PREMIUM_SUBSCRIPTION = '22bd1051015e3c663f8ca5cba9ebe56aTz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJlbWl1bSxMTT1zdWJzY3JpcHRpb24sUFY9aW5pdGlhbCxUPXRydWUsS1Y9Mg==';
+
+/**
+ * Pro perpetual, initial, expiry = releaseDate + 1 day (valid).
+ * orderId: #123, keyVersion: 2
+ */
+export const TEST_KEY_PRO_PERPETUAL = 'f4221ac32d1b8b102c143dcf65080414Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y';
+
+/**
+ * Pro perpetual, initial, expiry = releaseDate - 1 day (expired before release).
+ * orderId: #123, keyVersion: 2
+ */
+export const TEST_KEY_PRO_PERPETUAL_EXPIRED = '64245e2bb861fc92856e682b32dc8bf2Tz0xMjMsRT0xNTE0NTg4NDAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y';
+
+/**
+ * Pro annual, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+export const TEST_KEY_PRO_ANNUAL_INITIAL = 'd82e3196c55fc5dc21a4145b796a77a7Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y';
+
+/**
+ * Premium annual, initial, expiry = releaseDate + 1 day.
+ * orderId: #123, keyVersion: 2
+ */
+export const TEST_KEY_PREMIUM_ANNUAL_INITIAL = '8fc9fa79e1b5f30ce737ccec8f3e36f4Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJlbWl1bSxMTT1hbm51YWwsUFY9aW5pdGlhbCxUPXRydWUsS1Y9Mg==';
+
+// --- Keys for time-sensitive tests (used with vi.useFakeTimers, fakeNow = 2024-06-15) ---
+
+/**
+ * Pro subscription, initial, expiry = 2024-06-14 (fakeNow - 1 day, within grace period).
+ * orderId: #123, keyVersion: 2
+ */
+export const TEST_KEY_EXPIRED_GRACE = '84dcbd1c5a6169c74e6c70ec23e0df55Tz0xMjMsRT0xNzE4MzIzMjAwMDAwLFM9cHJvLExNPXN1YnNjcmlwdGlvbixQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y';
+
+/**
+ * Pro subscription, initial, expiry = 2024-05-16 (fakeNow - 30 days, past grace period).
+ * orderId: #123, keyVersion: 2
+ */
+export const TEST_KEY_EXPIRED_30DAYS = '4081d3863dda2ca60be4a5b29f582117Tz0xMjMsRT0xNzE1ODE3NjAwMDAwLFM9cHJvLExNPXN1YnNjcmlwdGlvbixQVj1pbml0aWFsLFQ9dHJ1ZSxLVj0y';
+
+// --- Keys for useLicenseVerifier plan combination tests (initial planVersion, far-future expiry) ---
+
+/**
+ * Pro subscription, initial, expiry = 3001-01-01.
+ * orderId: #123, keyVersion: 2
+ */
+export const TEST_KEY_PRO_SUBSCRIPTION_FUTURE = 'e83a283135bbd911e4aa0fd55ceea3ebTz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXBybyxMTT1zdWJzY3JpcHRpb24sUFY9aW5pdGlhbCxUPXRydWUsS1Y9Mg==';
+
+/**
+ * Premium subscription, initial, expiry = 3001-01-01.
+ * orderId: #123, keyVersion: 2
+ */
+export const TEST_KEY_PREMIUM_SUBSCRIPTION_FUTURE = '1c6ea00fadedfcb3f2ef393f1de32f29Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXByZW1pdW0sTE09c3Vic2NyaXB0aW9uLFBWPWluaXRpYWwsVD10cnVlLEtWPTI=';
+
+// --- Key format v3 ---
+
+/**
+ * Pro annual, Q3-2024, quantity: 5, appType: single.
+ * orderId: #123, keyVersion: 3, expiryDate: 2099-12-30T23:00:00.000Z
+ */
+export const TEST_KEY_PRO_ANNUAL_V3 = '521a75b4cf0d0c5e8990ce070886e167Tz0xMjMsRT00MTAyMzU0ODAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1RMy0yMDI0LFE9NSxBVD1zaW5nbGUsVD10cnVlLEtWPTM=';
+
+// --- Key format v3 Q1-2026 ---
+
+/**
+ * Pro annual, Q1-2026, quantity: 5, appType: single.
+ * orderId: #123, keyVersion: 3, expiryDate: 3001-01-01
+ */
+export const TEST_KEY_PRO_ANNUAL_Q1_2026_V3 = '5f52871b5845f28ebdd0fabbe0b89695Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXBybyxMTT1hbm51YWwsUFY9UTEtMjAyNixRPTUsQVQ9c2luZ2xlLFQ9dHJ1ZSxLVj0z';
+
+/**
+ * Premium annual, Q1-2026, quantity: 10, appType: single.
+ * orderId: #123, keyVersion: 3, expiryDate: 3001-01-01
+ */
+export const TEST_KEY_PREMIUM_ANNUAL_Q1_2026_V3 = '450d9fc1b28e709fcb73969bd10e1c30Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXByZW1pdW0sTE09YW5udWFsLFBWPVExLTIwMjYsUT0xMCxBVD1zaW5nbGUsVD10cnVlLEtWPTM=';
+
+// --- Invalid / edge-case keys ---
+
+/**
+ * Invalid key: hash does not match payload (tampered).
+ * Used to test that verifyLicense rejects tampered keys.
+ */
+export const TEST_KEY_INVALID = 'c0b3c1c31055976260628def9b697020TkFNRTpNYC1VSSBTQVMsREVWRUxPUEVSX0NPVU5UPTEwLEVYUElSWT0xNTkxNzIzMDY3MDQyLFZFUlNJT049MS4yLjMsVD10cnVl';
+
+/**
+ * Valid hash but unknown key version (KV=99).
+ * Used to test that decodeLicense returns null for unrecognized versions.
+ */
+export const TEST_KEY_UNKNOWN_VERSION = '64152474c774ae343484f08bbbc1a231Tz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPWFubnVhbCxQVj1pbml0aWFsLFQ9dHJ1ZSxLVj05OQ==';

package/{esm/useLicenseVerifier/index.d.ts → useLicenseVerifier/index.d.mts}

@@ -1 +1 @@
-export { clearLicenseStatusCache, useLicenseVerifier } from "./useLicenseVerifier.js";
+export { clearLicenseStatusCache, useLicenseVerifier } from "./useLicenseVerifier.mjs";

package/{esm/useLicenseVerifier/index.js → useLicenseVerifier/index.mjs}

@@ -1 +1 @@
-export { clearLicenseStatusCache, useLicenseVerifier } from "./useLicenseVerifier.js";
+export { clearLicenseStatusCache, useLicenseVerifier } from "./useLicenseVerifier.mjs";

package/{esm/useLicenseVerifier/useLicenseVerifier.d.ts → useLicenseVerifier/useLicenseVerifier.d.mts}

@@ -1,5 +1,5 @@
-import { LicenseStatus } from "../utils/licenseStatus.js";
-import { MuiCommercialPackageName } from "../utils/commercialPackages.js";
+import { LicenseStatus } from "../utils/licenseStatus.mjs";
+import { MuiCommercialPackageName } from "../utils/commercialPackages.mjs";
 export declare const sharedLicenseStatuses: { [packageName in MuiCommercialPackageName]?: {
   key: string | undefined;
   licenseVerifier: {

package/useLicenseVerifier/useLicenseVerifier.js

@@ -49,7 +49,8 @@ function useLicenseVerifier(packageName, releaseInfo) {
     });
     const fullPackageName = `@mui/${packageName}`;
     (0, _xTelemetry.sendMuiXTelemetryEvent)(_xTelemetry.muiXTelemetryEvents.licenseVerification({
-      licenseKey
+      licenseKey,
+      xLicenseClientVersion: "9.0.0-alpha.2"
     }, {
       packageName,
       packageReleaseInfo: releaseInfo,

package/{esm/useLicenseVerifier/useLicenseVerifier.js → useLicenseVerifier/useLicenseVerifier.mjs}

@@ -3,11 +3,11 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import * as React from 'react';
 import { sendMuiXTelemetryEvent, muiXTelemetryEvents } from '@mui/x-telemetry';
-import { verifyLicense } from "../verifyLicense/verifyLicense.js";
-import { LicenseInfo } from "../utils/licenseInfo.js";
-import { showExpiredAnnualGraceLicenseKeyError, showExpiredAnnualLicenseKeyError, showInvalidLicenseKeyError, showMissingLicenseKeyError, showLicenseKeyPlanMismatchError, showExpiredPackageVersionError, showNotAvailableInInitialProPlanError } from "../utils/licenseErrorMessageUtils.js";
-import { LICENSE_STATUS } from "../utils/licenseStatus.js";
-import MuiLicenseInfoContext from "../Unstable_LicenseInfoProvider/MuiLicenseInfoContext.js";
+import { verifyLicense } from "../verifyLicense/verifyLicense.mjs";
+import { LicenseInfo } from "../utils/licenseInfo.mjs";
+import { showExpiredAnnualGraceLicenseKeyError, showExpiredAnnualLicenseKeyError, showInvalidLicenseKeyError, showMissingLicenseKeyError, showLicenseKeyPlanMismatchError, showExpiredPackageVersionError, showNotAvailableInInitialProPlanError } from "../utils/licenseErrorMessageUtils.mjs";
+import { LICENSE_STATUS } from "../utils/licenseStatus.mjs";
+import MuiLicenseInfoContext from "../Unstable_LicenseInfoProvider/MuiLicenseInfoContext.mjs";
 export const sharedLicenseStatuses = {};
 
 /**
@@ -40,7 +40,8 @@ export function useLicenseVerifier(packageName, releaseInfo) {
     });
     const fullPackageName = `@mui/${packageName}`;
     sendMuiXTelemetryEvent(muiXTelemetryEvents.licenseVerification({
-      licenseKey
+      licenseKey,
+      xLicenseClientVersion: "9.0.0-alpha.2"
     }, {
       packageName,
       packageReleaseInfo: releaseInfo,

package/{esm/utils/commercialPackages.d.ts → utils/commercialPackages.d.mts}

@@ -1 +1 @@
-export type MuiCommercialPackageName = 'x-data-grid-pro' | 'x-data-grid-premium' | 'x-date-pickers-pro' | 'x-tree-view-pro' | 'x-charts-pro' | 'x-charts-premium';
+export type MuiCommercialPackageName = 'x-data-grid-pro' | 'x-data-grid-premium' | 'x-date-pickers-pro' | 'x-tree-view-pro' | 'x-charts-pro' | 'x-charts-premium' | 'x-scheduler-premium';