@moonbase.sh/licensing 2.0.1 → 3.1.0

package/dist/index.cjs

@@ -31,20 +31,46 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   ActivationMethod: () => ActivationMethod,
-  DefaultDeviceIdResolver: () => DefaultDeviceIdResolver,
+  DEVICE_ID_SOURCE_TAGS: () => DEVICE_ID_SOURCE_TAGS,
   ErrorType: () => ErrorType,
+  FINGERPRINT_PREFIX: () => FINGERPRINT_PREFIX,
+  FINGERPRINT_VERSION: () => FINGERPRINT_VERSION,
   FileLicenseStore: () => FileLicenseStore,
+  IDENTIFYING_PARAM_NAMES: () => IDENTIFYING_PARAM_NAMES,
   InMemoryLicenseStore: () => InMemoryLicenseStore,
+  InsufficientDeviceIdentityError: () => InsufficientDeviceIdentityError,
+  LegacyDeviceIdResolver: () => LegacyDeviceIdResolver,
   LicenseClient: () => LicenseClient,
   LicenseValidator: () => LicenseValidator,
+  MAX_VALUE_LENGTH: () => MAX_VALUE_LENGTH,
+  MigratingDeviceIdResolver: () => MigratingDeviceIdResolver,
+  MoonbaseDeviceIdResolver: () => MoonbaseDeviceIdResolver,
   MoonbaseError: () => MoonbaseError,
-  MoonbaseLicensing: () => MoonbaseLicensing
+  MoonbaseLicensing: () => MoonbaseLicensing,
+  buildFingerprintMaterial: () => buildFingerprintMaterial,
+  canonicalizeParams: () => canonicalizeParams,
+  canonicalizeValue: () => canonicalizeValue,
+  defaultDeviceIdentityReader: () => defaultDeviceIdentityReader,
+  fingerprintDeviceId: () => fingerprintDeviceId,
+  fingerprintDigest: () => fingerprintDigest,
+  identitySource: () => identitySource,
+  parseDeviceIdStamp: () => parseDeviceIdStamp,
+  parseIoregPlatformUuid: () => parseIoregPlatformUuid,
+  parseSmbiosParams: () => parseSmbiosParams,
+  platformTag: () => platformTag,
+  selectMachineId: () => selectMachineId,
+  stampDeviceId: () => stampDeviceId
 });
 module.exports = __toCommonJS(index_exports);
+var import_node_buffer2 = require("buffer");
+var import_node_process3 = __toESM(require("process"), 1);
 
 // src/client.ts
 var import_cross_fetch = __toESM(require("cross-fetch"), 1);
 
+// src/schemas.ts
+var import_zod = require("zod");
+
 // src/types.ts
 var ActivationMethod = /* @__PURE__ */ ((ActivationMethod2) => {
   ActivationMethod2["Online"] = "Online";
@@ -53,7 +79,6 @@ var ActivationMethod = /* @__PURE__ */ ((ActivationMethod2) => {
 })(ActivationMethod || {});
 
 // src/schemas.ts
-var import_zod = require("zod");
 var activationRequestResponseSchema = import_zod.z.object({
   id: import_zod.z.string(),
   request: import_zod.z.string(),
@@ -107,7 +132,7 @@ var LicenseClient = class {
       deviceName: await this.deviceIdResolver.resolveDeviceName(),
       deviceSignature: await this.deviceIdResolver.resolveDeviceId()
     };
-    const response = await (0, import_cross_fetch.default)(this.configuration.endpoint + `/api/client/activations/${this.configuration.productId}/request${this.buildQueryString()}`, {
+    const response = await (0, import_cross_fetch.default)(`${this.configuration.endpoint}/api/client/activations/${this.configuration.productId}/request${this.buildQueryString()}`, {
       ...defaultFetchOptions,
       method: "POST",
       body: JSON.stringify(content)
@@ -129,7 +154,8 @@ var LicenseClient = class {
   }
   async getRequestedActivation(request) {
     const response = await (0, import_cross_fetch.default)(request.request, defaultFetchOptions);
-    if (response.status === 204 || response.status === 404) return null;
+    if (response.status === 204 || response.status === 404)
+      return null;
     return await this.handleLicenseResponse(response);
   }
   async requestTrial() {
@@ -137,7 +163,7 @@ var LicenseClient = class {
       deviceName: await this.deviceIdResolver.resolveDeviceName(),
       deviceSignature: await this.deviceIdResolver.resolveDeviceId()
     };
-    const response = await (0, import_cross_fetch.default)(this.configuration.endpoint + `/api/client/trials/${this.configuration.productId}/request${this.buildQueryString()}`, {
+    const response = await (0, import_cross_fetch.default)(`${this.configuration.endpoint}/api/client/trials/${this.configuration.productId}/request${this.buildQueryString()}`, {
       ...defaultFetchOptions,
       method: "POST",
       headers: {
@@ -149,7 +175,7 @@ var LicenseClient = class {
     return await this.handleLicenseResponse(response);
   }
   async validateLicense(license) {
-    const response = await (0, import_cross_fetch.default)(this.configuration.endpoint + `/api/client/licenses/${this.configuration.productId}/validate${this.buildQueryString()}`, {
+    const response = await (0, import_cross_fetch.default)(`${this.configuration.endpoint}/api/client/licenses/${this.configuration.productId}/validate${this.buildQueryString()}`, {
       ...defaultFetchOptions,
       method: "POST",
       headers: {
@@ -162,11 +188,12 @@ var LicenseClient = class {
   }
   async validateRawLicense(rawLicense) {
     const license = await this.licenseValidator.validateLicense(rawLicense.toString("utf8"));
-    if (license.activationMethod === "Offline" /* Offline */) return license;
+    if (license.activationMethod === "Offline" /* Offline */)
+      return license;
     return await this.validateLicense(license);
   }
   async revokeLicense(license) {
-    const response = await (0, import_cross_fetch.default)(this.configuration.endpoint + `/api/client/licenses/${this.configuration.productId}/revoke?format=JWT`, {
+    const response = await (0, import_cross_fetch.default)(`${this.configuration.endpoint}/api/client/licenses/${this.configuration.productId}/revoke?format=JWT`, {
       ...defaultFetchOptions,
       method: "POST",
       headers: {
@@ -188,11 +215,14 @@ var LicenseClient = class {
   buildQueryString() {
     const parts = ["format=JWT"];
     const { platform, appVersion, metadata } = this.configuration;
-    if (platform) parts.push(`platform=${encodeURIComponent(platform)}`);
-    if (appVersion) parts.push(`appVersion=${encodeURIComponent(appVersion)}`);
+    if (platform)
+      parts.push(`platform=${encodeURIComponent(platform)}`);
+    if (appVersion)
+      parts.push(`appVersion=${encodeURIComponent(appVersion)}`);
     if (metadata) {
       for (const [key, value] of Object.entries(metadata)) {
-        if (value === null || value === void 0 || value === "") continue;
+        if (value === null || value === void 0 || value === "")
+          continue;
         parts.push(`meta[${encodeURIComponent(key)}]=${encodeURIComponent(value)}`);
       }
     }
@@ -201,32 +231,486 @@ var LicenseClient = class {
 };
 
 // src/deviceIdResolver.ts
+var import_node_child_process2 = __toESM(require("child_process"), 1);
+var import_node_crypto2 = require("crypto");
+var import_node_os2 = __toESM(require("os"), 1);
+var import_node_process2 = __toESM(require("process"), 1);
 var import_systeminformation = __toESM(require("systeminformation"), 1);
-var import_node_os = __toESM(require("os"), 1);
+
+// src/errors.ts
+var ErrorType = /* @__PURE__ */ ((ErrorType2) => {
+  ErrorType2["None"] = "None";
+  ErrorType2["ApiError"] = "ApiError";
+  ErrorType2["NoEligibleLicense"] = "NoEligibleLicense";
+  ErrorType2["LicenseInvalid"] = "LicenseInvalid";
+  ErrorType2["LicenseRevoked"] = "LicenseRevoked";
+  ErrorType2["LicenseActivationRevoked"] = "LicenseActivationRevoked";
+  ErrorType2["LicenseExpired"] = "LicenseExpired";
+  ErrorType2["LicenseDeviceMismatch"] = "LicenseDeviceMismatch";
+  ErrorType2["DeviceIdentityUnavailable"] = "DeviceIdentityUnavailable";
+  return ErrorType2;
+})(ErrorType || {});
+var MoonbaseError = class extends Error {
+  constructor(title, detail, type, inner) {
+    super();
+    this.title = title;
+    this.detail = detail;
+    this.type = type;
+    this.inner = inner;
+    this.name = "MoonbaseError";
+    this.message = detail != null ? detail : title;
+  }
+};
+var InsufficientDeviceIdentityError = class extends MoonbaseError {
+  constructor(platform, reason = "no identity parameter could be read") {
+    super(
+      "No device identity",
+      `Could not identify this device (platform: ${platform}): ${reason}`,
+      "DeviceIdentityUnavailable" /* DeviceIdentityUnavailable */
+    );
+    this.platform = platform;
+    this.name = "InsufficientDeviceIdentityError";
+  }
+};
+
+// src/fingerprint.ts
+var import_node_buffer = require("buffer");
 var import_node_child_process = __toESM(require("child_process"), 1);
 var import_node_crypto = require("crypto");
-var DefaultDeviceIdResolver = class {
+var import_node_fs = __toESM(require("fs"), 1);
+var import_node_os = __toESM(require("os"), 1);
+var import_node_process = __toESM(require("process"), 1);
+var FINGERPRINT_PREFIX = "moonbase:fingerprint:v2";
+var FINGERPRINT_VERSION = 2;
+var MAX_VALUE_LENGTH = 128;
+var PRINTABLE_ASCII_MIN = 32;
+var PRINTABLE_ASCII_MAX = 126;
+var SOURCE_TAGS = {
+  identity: "",
+  deviceName: "n",
+  scoped: "s"
+};
+var DEVICE_ID_SOURCE_TAGS = Object.freeze({ ...SOURCE_TAGS });
+var SOURCE_BY_TAG = new Map(
+  Object.entries(SOURCE_TAGS).map(([source, tag]) => [tag, source])
+);
+var SCOPED_PLATFORMS = /* @__PURE__ */ new Set(["ios", "android"]);
+function identitySource(platform) {
+  return SCOPED_PLATFORMS.has(platform) ? "scoped" : "identity";
+}
+var STAMP_PATTERN = /^mbd(\d+)([a-z]*)_([0-9a-f]{64})$/;
+function canonicalizeValue(value) {
+  var _a;
+  let printable = "";
+  for (const char of value.normalize("NFC")) {
+    const code = (_a = char.codePointAt(0)) != null ? _a : 0;
+    if (code >= PRINTABLE_ASCII_MIN && code <= PRINTABLE_ASCII_MAX)
+      printable += char;
+  }
+  return printable.slice(0, MAX_VALUE_LENGTH).replace(/^ +| +$/g, "");
+}
+var PLATFORM_TAGS = /* @__PURE__ */ new Set(
+  ["mac", "ios", "windows", "android", "linux", "bsd", "unknown"]
+);
+function isPlatformTag(value) {
+  return PLATFORM_TAGS.has(value);
+}
+function platformTag(platform = import_node_process.default.platform) {
+  switch (platform) {
+    case "darwin":
+      return "mac";
+    case "win32":
+      return "windows";
+    case "android":
+      return "android";
+    case "linux":
+      return "linux";
+    case "freebsd":
+    case "openbsd":
+    case "netbsd":
+      return "bsd";
+    default:
+      return isPlatformTag(platform) ? platform : "unknown";
+  }
+}
+var IDENTIFYING_PARAMS = /* @__PURE__ */ new Set([
+  "ioPlatformUuid",
+  "machineId",
+  "systemUuid",
+  "baseboardSerialNumber",
+  "identifierForVendor",
+  "androidId",
+  "deviceName"
+]);
+var IDENTIFYING_PARAM_NAMES = Object.freeze([...IDENTIFYING_PARAMS]);
+var NOT_PROGRAMMED_VALUES = /* @__PURE__ */ new Set([
+  "to be filled by o.e.m.",
+  // The same filler without the dots, which plenty of firmware writes instead.
+  "to be filled by oem",
+  "default string",
+  "system serial number",
+  "base board serial number",
+  "chassis serial number",
+  "not specified",
+  "not applicable",
+  "not available",
+  "none",
+  "unknown",
+  "invalid",
+  "n/a",
+  "0123456789",
+  // `machine-id(5)`: the literal marker systemd writes to say "no id yet",
+  // e.g. in an initrd or a golden image awaiting first boot. Every machine
+  // deployed from such an image reads it, so it is the opposite of an identifier.
+  "uninitialized"
+]);
+var IDENTITY_CONSTRAINTS = {
+  androidId: {
+    // Reading the *static field* `Settings.Secure.ANDROID_ID` instead of calling
+    // `getString` with it yields the key name "android_id", identical on every
+    // device, so a single activation would unlock a whole Android install base.
+    // That string is not hex, so this stops it reaching the material.
+    //
+    // The bound is 1,16 and not 16 because AOSP before 8.0 generated the value
+    // with `Long.toHexString`, which drops leading zeros — a strict 16 would
+    // reject legitimate ids on roughly one in sixteen pre-Oreo devices.
+    format: /^[0-9a-f]{1,16}$/,
+    // A real ANDROID_ID shared by a large batch of 2010-era devices whose
+    // `ro.serialno` was unset, seeding the generator identically on every unit.
+    // Valid hex, so the format rule cannot catch it.
+    rejected: /* @__PURE__ */ new Set(["9774d56d682e549c"])
+  }
+};
+function isNotProgrammed(value) {
+  return NOT_PROGRAMMED_VALUES.has(value.toLowerCase()) || /^0+$/.test(value) || /^f+$/i.test(value);
+}
+function isUsableIdentity(name, value) {
+  var _a, _b, _c;
+  if (isNotProgrammed(value))
+    return false;
+  const constraint = IDENTITY_CONSTRAINTS[name];
+  if (!constraint)
+    return true;
+  return ((_b = (_a = constraint.format) == null ? void 0 : _a.test(value)) != null ? _b : true) && !((_c = constraint.rejected) == null ? void 0 : _c.has(value.toLowerCase()));
+}
+function canonicalizeParams(params) {
+  const kept = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const [name, rawValue] of params) {
+    const value = canonicalizeValue(rawValue);
+    if (value.length === 0)
+      continue;
+    if (IDENTIFYING_PARAMS.has(name) && !isUsableIdentity(name, value))
+      continue;
+    if (seen.has(name))
+      throw new Error(`Duplicate fingerprint parameter name: ${name}`);
+    seen.add(name);
+    kept.push([name, value]);
+  }
+  return kept;
+}
+function buildFingerprintMaterial(platform, params) {
+  const kept = canonicalizeParams(params);
+  if (kept.length === 0)
+    throw new InsufficientDeviceIdentityError(platform, "no identity parameter could be read");
+  if (SCOPED_PLATFORMS.has(platform) && kept.some(([name]) => name === "deviceName")) {
+    throw new InsufficientDeviceIdentityError(
+      platform,
+      "the host-name fallback is not available on this platform, where the host name is the same on every device"
+    );
+  }
+  if (!kept.some(([name]) => IDENTIFYING_PARAMS.has(name))) {
+    throw new InsufficientDeviceIdentityError(
+      platform,
+      `only model-level parameters could be read (${kept.map(([name]) => name).join(", ")}), none of which identify this individual machine`
+    );
+  }
+  const lines = [FINGERPRINT_PREFIX, `platform=${platform}`];
+  for (const [name, value] of kept)
+    lines.push(`${name}=${value}`);
+  return lines.join("\n");
+}
+function fingerprintDigest(material) {
+  return (0, import_node_crypto.createHash)("sha256").update(material, "utf8").digest("hex");
+}
+function stampDeviceId(digest, source = "identity") {
+  return `mbd${FINGERPRINT_VERSION}${SOURCE_TAGS[source]}_${digest}`;
+}
+function fingerprintDeviceId(material, source = "identity") {
+  return stampDeviceId(fingerprintDigest(material), source);
+}
+function parseDeviceIdStamp(deviceId) {
+  var _a;
+  const match = STAMP_PATTERN.exec(deviceId);
+  if (!match)
+    return null;
+  return {
+    version: Number(match[1]),
+    sourceTag: match[2],
+    source: (_a = SOURCE_BY_TAG.get(match[2])) != null ? _a : null,
+    digest: match[3]
+  };
+}
+function commandOutput(command) {
+  try {
+    return import_node_child_process.default.execSync(command, { encoding: "utf8" });
+  } catch (e) {
+    return "";
+  }
+}
+function readSysFile(path2) {
+  try {
+    return import_node_fs.default.readFileSync(path2, "utf8");
+  } catch (e) {
+    return "";
+  }
+}
+function parseIoregPlatformUuid(ioregOutput) {
+  const match = ioregOutput.match(/"IOPlatformUUID"\s*=\s*"([^"]+)"/);
+  return match ? match[1].replaceAll("-", "").toUpperCase() : "";
+}
+function readMacIdentity() {
+  const uuid = parseIoregPlatformUuid(commandOutput("ioreg -rd1 -c IOPlatformExpertDevice"));
+  const params = [["ioPlatformUuid", uuid]];
+  return { params, deviceName: import_node_os.default.hostname().replace(/\.local$/i, "") };
+}
+function selectMachineId(...sources) {
+  var _a;
+  return (_a = sources.map(canonicalizeValue).find((value) => /^[0-9a-f]{32}$/.test(value) && !isNotProgrammed(value))) != null ? _a : "";
+}
+function readMachineId() {
+  return selectMachineId(
+    readSysFile("/etc/machine-id"),
+    readSysFile("/var/lib/dbus/machine-id")
+  );
+}
+function readLinuxIdentity() {
+  const params = [
+    ["machineId", readMachineId()],
+    ["sysVendor", readSysFile("/sys/class/dmi/id/sys_vendor")],
+    ["productName", readSysFile("/sys/class/dmi/id/product_name")],
+    ["boardVendor", readSysFile("/sys/class/dmi/id/board_vendor")],
+    ["boardName", readSysFile("/sys/class/dmi/id/board_name")]
+  ];
+  return { params, deviceName: import_node_os.default.hostname() };
+}
+function parseSmbiosStructures(data) {
+  const structures = [];
+  let offset = 0;
+  while (offset + 4 <= data.length) {
+    const type = data[offset];
+    const length = data[offset + 1];
+    if (length < 4 || offset + length > data.length)
+      break;
+    const formatted = data.subarray(offset, offset + length);
+    const strings = [];
+    let p = offset + length;
+    if (p + 1 < data.length && data[p] === 0 && data[p + 1] === 0) {
+      p += 2;
+    } else {
+      while (p < data.length) {
+        let end = p;
+        while (end < data.length && data[end] !== 0)
+          end++;
+        strings.push(data.toString("latin1", p, end));
+        p = end + 1;
+        if (p < data.length && data[p] === 0) {
+          p += 1;
+          break;
+        }
+      }
+    }
+    structures.push({ type, formatted, strings });
+    if (type === 127)
+      break;
+    offset = p;
+  }
+  return structures;
+}
+function resolveSmbiosString(structure, fieldOffset) {
+  if (fieldOffset >= structure.formatted.length)
+    return "";
+  const index = structure.formatted[fieldOffset];
+  if (index === 0 || index > structure.strings.length)
+    return "";
+  return structure.strings[index - 1];
+}
+function formatSmbiosUuid(structure, fieldOffset) {
+  if (fieldOffset + 16 > structure.formatted.length)
+    return "";
+  const bytes = structure.formatted.subarray(fieldOffset, fieldOffset + 16);
+  if (bytes.every((byte) => byte === 0) || bytes.every((byte) => byte === 255))
+    return "";
+  let hex = "";
+  for (const byte of bytes)
+    hex += byte.toString(16).padStart(2, "0").toUpperCase();
+  return hex;
+}
+function parseSmbiosParams(smbiosData) {
+  const structures = parseSmbiosStructures(smbiosData);
+  const params = [];
+  const system = structures.find((structure) => structure.type === 1);
+  if (system) {
+    params.push(["systemManufacturer", resolveSmbiosString(system, 4)]);
+    params.push(["systemProductName", resolveSmbiosString(system, 5)]);
+    params.push(["systemUuid", formatSmbiosUuid(system, 8)]);
+  }
+  const baseboard = structures.find((structure) => structure.type === 2);
+  if (baseboard) {
+    params.push(["baseboardManufacturer", resolveSmbiosString(baseboard, 4)]);
+    params.push(["baseboardProduct", resolveSmbiosString(baseboard, 5)]);
+    params.push(["baseboardSerialNumber", resolveSmbiosString(baseboard, 7)]);
+  }
+  return params;
+}
+function readWindowsSmbios() {
+  const script = "[Convert]::ToBase64String((Get-CimInstance -Namespace root/wmi -ClassName MSSmBios_RawSMBiosTables).SMBiosData)";
+  const output = commandOutput(`powershell -NoProfile -NonInteractive -Command "${script}"`);
+  try {
+    return import_node_buffer.Buffer.from(output.trim(), "base64");
+  } catch (e) {
+    return import_node_buffer.Buffer.alloc(0);
+  }
+}
+function readWindowsIdentity() {
+  return { params: parseSmbiosParams(readWindowsSmbios()), deviceName: import_node_os.default.hostname() };
+}
+function defaultDeviceIdentityReader(platform = import_node_process.default.platform) {
+  const tag = platformTag(platform);
+  return {
+    read() {
+      switch (tag) {
+        case "mac":
+          return readMacIdentity();
+        case "linux":
+          return readLinuxIdentity();
+        case "windows":
+          return readWindowsIdentity();
+        // Everything else yields no identity params here, so it resolves to an
+        // insufficient-identity error unless the deviceName fallback is enabled.
+        // For bsd and unknown that matches the spec, which defines none. Android
+        // is different: the spec *does* define `androidId`, but it comes from
+        // `Settings.Secure.getString`, which is Android-framework API that a
+        // Node.js process cannot reach. Collecting it is the C++/.NET SDKs' job.
+        // A host that can bridge it should supply its own DeviceIdentityReader.
+        default:
+          return { params: [], deviceName: import_node_os.default.hostname() };
+      }
+    }
+  };
+}
+
+// src/deviceIdResolver.ts
+var MoonbaseDeviceIdResolver = class {
+  constructor(options) {
+    var _a, _b, _c;
+    const platform = (_a = options == null ? void 0 : options.platform) != null ? _a : import_node_process2.default.platform;
+    this.platform = platformTag(platform);
+    this.reader = (_b = options == null ? void 0 : options.reader) != null ? _b : defaultDeviceIdentityReader(platform);
+    this.fallback = (_c = options == null ? void 0 : options.fallback) != null ? _c : "none";
+  }
+  async resolveDeviceName() {
+    return this.readIdentity().deviceName;
+  }
+  async resolveDeviceId() {
+    return this.compute().deviceId;
+  }
+  /**
+   * A fresh copy each call. The device binding is what activation sends and what
+   * validation compares, so handing out the resolver's own object would let a
+   * consumer that edits a diagnostic — or logs it through something that
+   * normalizes in place — silently change the id every later call returns.
+   */
+  async describeDevice() {
+    const described = this.compute();
+    return { ...described, paramNames: [...described.paramNames] };
+  }
+  compute() {
+    var _a;
+    (_a = this.described) != null ? _a : this.described = this.computeDescription();
+    return this.described;
+  }
+  /**
+   * Read identity at most once. Both halves of an activation request ask for it —
+   * the name and then the id — and a read can mean spawning `ioreg` or
+   * PowerShell, so reading per call would double the cost of every request and
+   * let the name and the id come from two different reads of the machine.
+   */
+  readIdentity() {
+    var _a;
+    (_a = this.identity) != null ? _a : this.identity = this.reader.read();
+    return this.identity;
+  }
+  computeDescription() {
+    const { params, deviceName } = this.readIdentity();
+    try {
+      return this.describe(params, identitySource(this.platform));
+    } catch (err) {
+      if (this.fallback !== "deviceName" || !(err instanceof InsufficientDeviceIdentityError))
+        throw err;
+      return this.describe([["deviceName", deviceName]], "deviceName");
+    }
+  }
+  describe(params, source) {
+    return {
+      deviceId: fingerprintDeviceId(buildFingerprintMaterial(this.platform, params), source),
+      version: FINGERPRINT_VERSION,
+      platform: this.platform,
+      source,
+      paramNames: canonicalizeParams(params).map(([name]) => name)
+    };
+  }
+};
+var MigratingDeviceIdResolver = class {
+  constructor(current, ...previous) {
+    this.current = current;
+    this.previous = previous;
+    const describe = current.describeDevice;
+    if (typeof describe === "function")
+      this.describeDevice = () => describe.call(current);
+  }
+  async resolveDeviceName() {
+    return this.current.resolveDeviceName();
+  }
+  async resolveDeviceId() {
+    return this.current.resolveDeviceId();
+  }
+  async acceptsDeviceId(deviceId) {
+    if (!this.previousIds) {
+      this.previousIds = Promise.all(this.previous.map(async (resolver) => {
+        try {
+          return await resolver.resolveDeviceId();
+        } catch (e) {
+          return "";
+        }
+      }));
+    }
+    return (await this.previousIds).some((previous) => previous.length > 0 && previous === deviceId);
+  }
+};
+var LegacyDeviceIdResolver = class {
   async resolveDeviceName() {
-    switch (process.platform) {
+    switch (import_node_process2.default.platform) {
       case "darwin":
         try {
-          return import_node_child_process.default.execSync("scutil --get ComputerName").toString().trim();
+          return import_node_child_process2.default.execSync("scutil --get ComputerName").toString().trim();
         } catch (e) {
-          return import_node_os.default.hostname();
+          return import_node_os2.default.hostname();
         }
       case "win32":
-        return process.env.COMPUTERNAME || import_node_os.default.hostname();
-      case "linux":
-        const prettyname = import_node_child_process.default.execSync("hostnamectl --pretty").toString().trim();
-        return prettyname || import_node_os.default.hostname();
+        return import_node_process2.default.env.COMPUTERNAME || import_node_os2.default.hostname();
+      case "linux": {
+        const prettyname = import_node_child_process2.default.execSync("hostnamectl --pretty").toString().trim();
+        return prettyname || import_node_os2.default.hostname();
+      }
       default:
-        return import_node_os.default.hostname();
+        return import_node_os2.default.hostname();
     }
   }
   async resolveDeviceId() {
     const [cpu, hw] = await Promise.all([import_systeminformation.default.cpu(), import_systeminformation.default.system()]);
     const parts = [
-      import_node_os.default.hostname(),
+      import_node_os2.default.hostname(),
       hw.manufacturer,
       hw.model,
       hw.serial,
@@ -238,40 +722,15 @@ var DefaultDeviceIdResolver = class {
       cpu.family,
       cpu.model
     ];
-    const hash = (0, import_node_crypto.createHash)("sha256").update(parts.join("")).digest();
+    const hash = (0, import_node_crypto2.createHash)("sha256").update(parts.join("")).digest();
     return hash.toString("base64").replaceAll("=", "");
   }
 };
 
 // src/store.ts
-var import_node_fs = __toESM(require("fs"), 1);
+var import_node_fs2 = __toESM(require("fs"), 1);
 var import_promises = __toESM(require("fs/promises"), 1);
 var import_node_path = __toESM(require("path"), 1);
-
-// src/errors.ts
-var ErrorType = /* @__PURE__ */ ((ErrorType2) => {
-  ErrorType2["None"] = "None";
-  ErrorType2["ApiError"] = "ApiError";
-  ErrorType2["NoEligibleLicense"] = "NoEligibleLicense";
-  ErrorType2["LicenseInvalid"] = "LicenseInvalid";
-  ErrorType2["LicenseRevoked"] = "LicenseRevoked";
-  ErrorType2["LicenseActivationRevoked"] = "LicenseActivationRevoked";
-  ErrorType2["LicenseExpired"] = "LicenseExpired";
-  return ErrorType2;
-})(ErrorType || {});
-var MoonbaseError = class extends Error {
-  constructor(title, detail, type, inner) {
-    super();
-    this.title = title;
-    this.detail = detail;
-    this.type = type;
-    this.inner = inner;
-    this.name = "MoonbaseError";
-    this.message = detail != null ? detail : title;
-  }
-};
-
-// src/store.ts
 var InMemoryLicenseStore = class {
   async loadLocalLicense() {
     var _a;
@@ -289,7 +748,8 @@ var FileLicenseStore = class {
     this.options = options;
   }
   async loadLocalLicense() {
-    if (!import_node_fs.default.existsSync(this.path)) return null;
+    if (!import_node_fs2.default.existsSync(this.path))
+      return null;
     try {
       const file = await import_promises.default.readFile(this.path, { encoding: "utf-8" });
       const license = licenseSchema.parse(JSON.parse(file));
@@ -302,7 +762,8 @@ var FileLicenseStore = class {
     await import_promises.default.writeFile(this.path, JSON.stringify(license), { encoding: "utf-8" });
   }
   async deleteLocalLicense() {
-    if (!import_node_fs.default.existsSync(this.path)) return;
+    if (!import_node_fs2.default.existsSync(this.path))
+      return;
     await import_promises.default.rm(this.path);
   }
   get path() {
@@ -312,8 +773,8 @@ var FileLicenseStore = class {
 };
 
 // src/validator.ts
-var import_zod2 = require("zod");
 var import_jsonwebtoken = __toESM(require("jsonwebtoken"), 1);
+var import_zod2 = require("zod");
 var licenseClaimsSchema = import_zod2.z.object({
   ["l:id" /* LicenseId */]: import_zod2.z.string(),
   ["trial" /* Trial */]: import_zod2.z.string().or(import_zod2.z.boolean()).transform((v) => v === true || v === "true").pipe(import_zod2.z.boolean()),
@@ -350,15 +811,20 @@ var LicenseValidator = class {
       );
     }
     const expectedSignature = await this.deviceIdResolver.resolveDeviceId();
-    if (expectedSignature !== claims["sig" /* ComputerSignature */]) {
-      throw new MoonbaseError(
-        "License invalide",
-        "This license is not for this device",
-        "LicenseExpired" /* LicenseExpired */
-      );
-    }
+    const boundSignature = claims["sig" /* ComputerSignature */];
+    if (expectedSignature !== boundSignature && !await this.acceptsHistoricalDeviceId(boundSignature))
+      throw deviceMismatchError(expectedSignature, boundSignature);
     return license;
   }
+  /**
+   * Give a {@link IMigratingDeviceIdResolver} the chance to vouch for a device id
+   * this machine used to have. Only consulted after the fast path fails, so
+   * apps that have not opted into a migration pay nothing.
+   */
+  async acceptsHistoricalDeviceId(boundSignature) {
+    const accepts = this.deviceIdResolver.acceptsDeviceId;
+    return typeof accepts === "function" && await accepts.call(this.deviceIdResolver, boundSignature);
+  }
   parseLicenseToken(token) {
     return new Promise((resolve, reject) => {
       import_jsonwebtoken.default.verify(token, this.configuration.publicKey, {
@@ -423,11 +889,57 @@ var LicenseValidator = class {
     });
   }
 };
+function deviceMismatchError(expected, bound) {
+  const detail = "This license is not for this device";
+  const stampNote = describeStampDifference(expected, bound);
+  return new MoonbaseError(
+    "License is for another device",
+    stampNote ? `${detail}. ${stampNote}` : detail,
+    "LicenseDeviceMismatch" /* LicenseDeviceMismatch */
+  );
+}
+function describeStampDifference(expected, bound) {
+  const expectedStamp = parseDeviceIdStamp(expected);
+  if (!expectedStamp)
+    return null;
+  const boundStamp = parseDeviceIdStamp(bound);
+  if (!boundStamp || boundStamp.version !== expectedStamp.version)
+    return describeVersionDifference(expectedStamp, boundStamp);
+  if (boundStamp.sourceTag !== expectedStamp.sourceTag)
+    return describeSourceDifference(expectedStamp, boundStamp);
+  return null;
+}
+function describeVersionDifference(expected, bound) {
+  if (bound && bound.version > expected.version) {
+    return `The binding was created by device fingerprint v${bound.version}, which is newer than the v${expected.version} this SDK computes \u2014 update the SDK rather than re-activating, which would rebind the device to the older algorithm.`;
+  }
+  const boundVersion = bound ? `device fingerprint v${bound.version}` : "an SDK predating versioned device fingerprints";
+  return `The binding was created by ${boundVersion}, while this SDK computes v${expected.version}, so this may instead be the same machine bound under the older algorithm \u2014 re-activate to find out, or configure a MigratingDeviceIdResolver to keep accepting the previous id.`;
+}
+function describeSourceDifference(expected, bound) {
+  if (bound.source === "scoped") {
+    return "The binding uses an app-scoped device identity, which cannot be compared with the id this SDK computes \u2014 not even on the same device. Re-activate here to bind this build.";
+  }
+  if (expected.source === "scoped") {
+    return "This SDK computes an app-scoped device identity, which cannot be compared with the one the binding carries \u2014 not even on the same device. Re-activate here to bind this app.";
+  }
+  if (bound.source === null) {
+    return `The binding carries the device identity tag "${bound.sourceTag}", which this SDK does not recognise \u2014 it was created by a newer Moonbase SDK, so update rather than re-activating.`;
+  }
+  if (expected.source === null) {
+    return `The id this SDK computes carries the device identity tag "${expected.sourceTag}", which the spec does not define \u2014 it came from a custom device id resolver, so check that resolver rather than the binding.`;
+  }
+  if (bound.source === "deviceName") {
+    return "The binding was created from the host-name fallback, while this SDK reads hardware identity, so this may instead be the same machine bound while no hardware identity could be read \u2014 re-activate to find out.";
+  }
+  return "The binding was created from hardware identity, while this SDK has fallen back to the host name \u2014 check why hardware identity cannot be read here rather than re-activating, which would rebind the device to the weaker id.";
+}
 
 // src/index.ts
 function detectPlatform() {
-  if (typeof process === "undefined") return void 0;
-  switch (process.platform) {
+  if (typeof import_node_process3.default === "undefined")
+    return void 0;
+  switch (import_node_process3.default.platform) {
     case "darwin":
       return "Mac";
     case "win32":
@@ -447,7 +959,7 @@ var MoonbaseLicensing = class {
       platform: configuration.platform === void 0 ? detectPlatform() : configuration.platform
     };
     this.store = (_a = configuration.licenseStore) != null ? _a : new InMemoryLicenseStore();
-    this.deviceIdResolver = (_b = configuration.deivceIdResolver) != null ? _b : new DefaultDeviceIdResolver();
+    this.deviceIdResolver = (_b = configuration.deviceIdResolver) != null ? _b : new MoonbaseDeviceIdResolver();
     this.validator = new LicenseValidator(this.configuration, this.deviceIdResolver);
     this.client = new LicenseClient(this.configuration, this.deviceIdResolver, this.validator);
   }
@@ -459,7 +971,7 @@ var MoonbaseLicensing = class {
       format: "JWT"
     };
     const json = JSON.stringify(token);
-    return Buffer.from(Buffer.from(json).toString("base64"));
+    return import_node_buffer2.Buffer.from(import_node_buffer2.Buffer.from(json).toString("base64"));
   }
   async readRawLicense(license) {
     return await this.client.validateRawLicense(license);
@@ -468,12 +980,33 @@ var MoonbaseLicensing = class {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActivationMethod,
-  DefaultDeviceIdResolver,
+  DEVICE_ID_SOURCE_TAGS,
   ErrorType,
+  FINGERPRINT_PREFIX,
+  FINGERPRINT_VERSION,
   FileLicenseStore,
+  IDENTIFYING_PARAM_NAMES,
   InMemoryLicenseStore,
+  InsufficientDeviceIdentityError,
+  LegacyDeviceIdResolver,
   LicenseClient,
   LicenseValidator,
+  MAX_VALUE_LENGTH,
+  MigratingDeviceIdResolver,
+  MoonbaseDeviceIdResolver,
   MoonbaseError,
-  MoonbaseLicensing
+  MoonbaseLicensing,
+  buildFingerprintMaterial,
+  canonicalizeParams,
+  canonicalizeValue,
+  defaultDeviceIdentityReader,
+  fingerprintDeviceId,
+  fingerprintDigest,
+  identitySource,
+  parseDeviceIdStamp,
+  parseIoregPlatformUuid,
+  parseSmbiosParams,
+  platformTag,
+  selectMachineId,
+  stampDeviceId
 });