@provartesting/provardx-cli 1.4.7 → 1.5.0-dev.1

package/lib/commands/provar/quality-hub/test/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../../../src/commands/provar/quality-hub/test/run.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,cAAc,MAAM,iFAAiF,CAAC;AAE7G,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,cAAc;IAC5D,MAAM,CAAU,OAAO,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACtD,MAAM,CAAU,gBAAgB,GAAG,IAAI,CAAC"}

package/lib/commands/provar/quality-hub/testcase/retrieve.d.ts

@@ -0,0 +1,5 @@
+import ManagerTestcaseRetrieve from '@provartesting/provardx-plugins-manager/lib/commands/provar/manager/testcase/retrieve.js';
+export default class SfProvarQualityHubTestcaseRetrieve extends ManagerTestcaseRetrieve {
+    static readonly aliases: string[];
+    static readonly deprecateAliases = true;
+}

package/lib/commands/provar/quality-hub/testcase/retrieve.js

@@ -0,0 +1,12 @@
+/*
+ * Copyright (c) 2024 Provar Limited.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.md file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import ManagerTestcaseRetrieve from '@provartesting/provardx-plugins-manager/lib/commands/provar/manager/testcase/retrieve.js';
+export default class SfProvarQualityHubTestcaseRetrieve extends ManagerTestcaseRetrieve {
+    static aliases = ['provar:manager:testcase:retrieve'];
+    static deprecateAliases = true;
+}
+//# sourceMappingURL=retrieve.js.map

package/lib/commands/provar/quality-hub/testcase/retrieve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve.js","sourceRoot":"","sources":["../../../../../src/commands/provar/quality-hub/testcase/retrieve.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,uBAAuB,MAAM,0FAA0F,CAAC;AAE/H,MAAM,CAAC,OAAO,OAAO,kCAAmC,SAAQ,uBAAuB;IAC9E,MAAM,CAAU,OAAO,GAAG,CAAC,kCAAkC,CAAC,CAAC;IAC/D,MAAM,CAAU,gBAAgB,GAAG,IAAI,CAAC"}

package/lib/mcp/licensing/algasClient.d.ts

@@ -0,0 +1,19 @@
+import type { LicenseType } from './licenseCache.js';
+export interface AlgasResult {
+    valid: boolean;
+    licenseType: LicenseType;
+    expiresAt?: number;
+}
+/**
+ * Validate a license key against the Provar tag API.
+ *
+ * Returns { valid: true, licenseType: 'None' } when the key exists and is not deleted.
+ * The licenseType is 'None' because the tag endpoint does not expose the license type;
+ * licenseValidator.ts enriches the type via the IDE cross-reference step when possible.
+ */
+export declare function validateKeyWithAlgas(licenseKey: string): Promise<AlgasResult>;
+/**
+ * Exposed for testing only — resets the in-memory token cache.
+ * Do not call in production code.
+ */
+export declare function resetTokenCacheForTest(): void;

package/lib/mcp/licensing/algasClient.js

@@ -0,0 +1,144 @@
+/*
+ * Copyright (c) 2024 Provar Limited.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.md file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+/**
+ * algasClient.ts — Provar licensing API client.
+ *
+ * Validates a license key via the Provar tag API:
+ * 1. Obtain a short-lived Cognito Bearer token (client credentials flow, cached 50 min).
+ * 2. GET /studio/licensing/{licenseKey} — returns tag metadata including `deleted` flag.
+ *
+ * Validation semantics:
+ * - `deleted === false` → key exists in the Provar system and has not been revoked → valid.
+ * - `deleted === true`  → key has been revoked → invalid.
+ * - HTTP 404            → key does not exist in the Provar system → invalid.
+ *
+ * Note: `validityPeriod` in the tag response is measured from the key's generation /
+ * modification date, NOT from now. It cannot be used to determine remaining validity.
+ * We rely on the tag's `deleted` flag only.
+ *
+ * The licenseType returned is 'None' when only the tag API is consulted (the tag endpoint
+ * does not expose the type). The IDE cross-reference step in licenseValidator.ts can
+ * supply a richer type when the key matches a locally-activated IDE license.
+ */
+import { LicenseError } from './licenseError.js';
+const TOKEN_URL = 'https://prod.provar.cloud/studio/licensingauth/oauth2/token';
+const TAG_BASE_URL = 'https://prod.provar.cloud/studio/licensing';
+/** Cognito tokens expire at 1h; cache for 50 min to allow a margin for clock skew. */
+const TOKEN_TTL_MS = 50 * 60 * 1000;
+const TIMEOUT_MS = 15000;
+function getOAuthCredentials() {
+    const clientId = process.env['PROVAR_OAUTH_CLIENT_ID'];
+    const clientSecret = process.env['PROVAR_OAUTH_CLIENT_SECRET'];
+    if (!clientId || !clientSecret) {
+        throw new LicenseError('ALGAS_UNREACHABLE', 'Provar OAuth credentials are not configured.\n' +
+            'Set PROVAR_OAUTH_CLIENT_ID and PROVAR_OAUTH_CLIENT_SECRET (see .env.example).');
+    }
+    return { clientId, clientSecret };
+}
+let cachedToken = null;
+let tokenExpiresAt = 0;
+async function getCognitoToken() {
+    if (cachedToken && Date.now() < tokenExpiresAt)
+        return cachedToken;
+    const { clientId, clientSecret } = getOAuthCredentials();
+    const credentials = Buffer.from(`${clientId}:${clientSecret}`).toString('base64');
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    try {
+        const res = await fetch(TOKEN_URL, {
+            method: 'POST',
+            headers: {
+                Authorization: `Basic ${credentials}`,
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+            body: 'grant_type=client_credentials&scope=studio-licensing-api%2Fread',
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            throw new LicenseError('ALGAS_HTTP_ERROR', `Provar licensing auth returned HTTP ${res.status}: ${res.statusText}`);
+        }
+        const json = (await res.json());
+        const token = String(json['access_token'] ?? '');
+        if (!token) {
+            throw new LicenseError('ALGAS_HTTP_ERROR', 'Empty access_token in Cognito response');
+        }
+        cachedToken = token;
+        tokenExpiresAt = Date.now() + TOKEN_TTL_MS;
+        return token;
+    }
+    catch (err) {
+        if (err.name === 'AbortError') {
+            throw new LicenseError('ALGAS_TIMEOUT', 'Provar licensing auth did not respond within 15s');
+        }
+        if (err instanceof LicenseError)
+            throw err;
+        throw new LicenseError('ALGAS_UNREACHABLE', `Could not reach Provar licensing auth: ${err.message}`);
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Validate a license key against the Provar tag API.
+ *
+ * Returns { valid: true, licenseType: 'None' } when the key exists and is not deleted.
+ * The licenseType is 'None' because the tag endpoint does not expose the license type;
+ * licenseValidator.ts enriches the type via the IDE cross-reference step when possible.
+ */
+export async function validateKeyWithAlgas(licenseKey) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    try {
+        const token = await getCognitoToken();
+        let res = await fetch(`${TAG_BASE_URL}/${encodeURIComponent(licenseKey)}`, {
+            headers: { Authorization: `Bearer ${token}` },
+            signal: controller.signal,
+        });
+        // 401 means the Cognito token was rotated mid-session — clear the module-level cache
+        // and retry exactly once with a fresh token before surfacing an error.
+        if (res.status === 401) {
+            cachedToken = null;
+            tokenExpiresAt = 0;
+            const refreshedToken = await getCognitoToken();
+            res = await fetch(`${TAG_BASE_URL}/${encodeURIComponent(licenseKey)}`, {
+                headers: { Authorization: `Bearer ${refreshedToken}` },
+                signal: controller.signal,
+            });
+        }
+        if (res.status === 404) {
+            // Key not found in the Provar system — definitively invalid
+            return { valid: false, licenseType: 'None' };
+        }
+        if (!res.ok) {
+            throw new LicenseError('ALGAS_HTTP_ERROR', `Provar licensing tag API returned HTTP ${res.status}: ${res.statusText}`);
+        }
+        const body = (await res.json());
+        const deleted = body['deleted'] === true;
+        // !deleted = key is present in the system and not revoked
+        return { valid: !deleted, licenseType: 'None' };
+    }
+    catch (err) {
+        if (err.name === 'AbortError') {
+            throw new LicenseError('ALGAS_TIMEOUT', 'Provar licensing tag API did not respond within 15s');
+        }
+        if (err instanceof LicenseError)
+            throw err;
+        throw new LicenseError('ALGAS_UNREACHABLE', `Could not reach Provar licensing API: ${err.message}`);
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Exposed for testing only — resets the in-memory token cache.
+ * Do not call in production code.
+ */
+export function resetTokenCacheForTest() {
+    cachedToken = null;
+    tokenExpiresAt = 0;
+}
+//# sourceMappingURL=algasClient.js.map

package/lib/mcp/licensing/algasClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"algasClient.js","sourceRoot":"","sources":["../../../src/mcp/licensing/algasClient.ts"],"names":[],"mappings":"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"}

package/lib/mcp/licensing/ideDetection.d.ts

@@ -0,0 +1,34 @@
+import type { LicenseType } from './licenseCache.js';
+export interface IdeLicenseState {
+    /** Name of the .properties file (without extension). */
+    name: string;
+    licenseType: LicenseType;
+    activated: boolean;
+    /** When the IDE last checked this license online against ALGAS (Unix ms). */
+    lastOnlineCheckMs: number;
+}
+/**
+ * Read all .properties files from the Provar IDE license folder and return
+ * the activation state of each. Returns an empty array when the folder does
+ * not exist or cannot be read.
+ */
+export declare function readIdeLicenses(): IdeLicenseState[];
+/**
+ * Find the best activated IDE license, if any.
+ *
+ * Priority: most recently validated activated license.
+ * Returns null when no activated license is present.
+ */
+export declare function findActivatedIdeLicense(): IdeLicenseState | null;
+/**
+ * Search all IDE .properties files for one whose decrypted licenseKey matches
+ * the supplied raw key string.
+ *
+ * Used to cross-reference an explicit --license-key against the IDE's already-
+ * validated activation state without making a fresh API call.
+ *
+ * Returns the matching IdeLicenseState (which may have activated=false if the
+ * IDE recorded the key but it isn't currently activated), or null when no file
+ * decrypts to the given key.
+ */
+export declare function findLicenseByDecryptedKey(rawKey: string): IdeLicenseState | null;

package/lib/mcp/licensing/ideDetection.js

@@ -0,0 +1,179 @@
+/*
+ * Copyright (c) 2024 Provar Limited.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.md file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+/**
+ * ideDetection.ts — Read activated Provar IDE license from disk.
+ *
+ * The Provar IDE stores license state in ~/Provar/.licenses/{name}.properties
+ *
+ * Fields we care about:
+ * - licenseStatus — Activated | NotActivated | Expired | Invalid | QuotaReached
+ * - licenseType — Fixed Seat | Floating | Trial | None
+ * - lastOnlineAvailabilityCheckUtc — epoch ms of last ALGAS check by the IDE
+ * - licenseKey — AES-128-ECB encrypted with key "provarautomation", Base64-encoded
+ *
+ * The licenseKey field is AES-128-ECB encrypted (LicenseSupport.KEY = "provarautomation").
+ * We decrypt it to allow cross-referencing an explicitly supplied --license-key against
+ * the IDE's already-validated license state without re-calling the licensing API.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { createDecipheriv } from 'node:crypto';
+/** AES-128-ECB key used by Provar IDE to encrypt the licenseKey field. */
+const AES_KEY = Buffer.from('provarautomation'); // 16 bytes ASCII
+/**
+ * Decrypt an AES-128-ECB + PKCS5 encrypted, Base64-encoded licenseKey field.
+ * Returns the plaintext string, or null if decryption fails (wrong key / corrupt).
+ */
+function decryptLicenseKeyField(encryptedBase64) {
+    try {
+        const decipher = createDecipheriv('aes-128-ecb', AES_KEY, null);
+        const buf = Buffer.from(encryptedBase64, 'base64');
+        return Buffer.concat([decipher.update(buf), decipher.final()]).toString('utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/** Mirrors License4J's DEFAUT_LICENSE_FOLDER_PATH + PROVAR_USER_HOME. */
+function provarLicensesDir() {
+    const provarHome = process.env['PROVAR_HOME'] ?? path.join(os.homedir(), 'Provar');
+    return path.join(provarHome, '.licenses');
+}
+/**
+ * Parse a Java .properties file into a key→value map.
+ * Only handles simple `key=value` lines; ignores comments and blank lines.
+ */
+function parseProperties(content) {
+    const map = new Map();
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#') || trimmed.startsWith('!'))
+            continue;
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx < 0)
+            continue;
+        const k = trimmed.slice(0, eqIdx).trim();
+        const v = trimmed.slice(eqIdx + 1).trim();
+        map.set(k, v);
+    }
+    return map;
+}
+function parseLicenseType(raw) {
+    // Java stores LicenseType.name() = "FixedSeat"; "Fixed Seat" kept for defensive compat.
+    if (raw === 'FixedSeat' || raw === 'Fixed Seat')
+        return 'FixedSeat';
+    if (raw === 'Floating')
+        return 'Floating';
+    if (raw === 'Trial')
+        return 'Trial';
+    return 'None';
+}
+/**
+ * Read all .properties files from the Provar IDE license folder and return
+ * the activation state of each. Returns an empty array when the folder does
+ * not exist or cannot be read.
+ */
+export function readIdeLicenses() {
+    const dir = provarLicensesDir();
+    if (!fs.existsSync(dir))
+        return [];
+    const results = [];
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.properties'))
+            continue;
+        try {
+            const content = fs.readFileSync(path.join(dir, entry.name), 'utf-8');
+            const props = parseProperties(content);
+            const licenseStatus = props.get('licenseStatus') ?? '';
+            const licenseType = parseLicenseType(props.get('licenseType') ?? '');
+            const lastCheck = parseInt(props.get('lastOnlineAvailabilityCheckUtc') ?? '0', 10);
+            results.push({
+                name: entry.name.slice(0, -'.properties'.length),
+                licenseType,
+                activated: licenseStatus === 'Activated',
+                lastOnlineCheckMs: isNaN(lastCheck) ? 0 : lastCheck,
+            });
+        }
+        catch {
+            // Unreadable file — skip
+        }
+    }
+    return results;
+}
+/**
+ * Find the best activated IDE license, if any.
+ *
+ * Priority: most recently validated activated license.
+ * Returns null when no activated license is present.
+ */
+export function findActivatedIdeLicense() {
+    const all = readIdeLicenses();
+    const activated = all.filter((l) => l.activated);
+    if (activated.length === 0)
+        return null;
+    // Return the one with the most recent online check
+    return activated.sort((a, b) => b.lastOnlineCheckMs - a.lastOnlineCheckMs)[0];
+}
+/**
+ * Search all IDE .properties files for one whose decrypted licenseKey matches
+ * the supplied raw key string.
+ *
+ * Used to cross-reference an explicit --license-key against the IDE's already-
+ * validated activation state without making a fresh API call.
+ *
+ * Returns the matching IdeLicenseState (which may have activated=false if the
+ * IDE recorded the key but it isn't currently activated), or null when no file
+ * decrypts to the given key.
+ */
+export function findLicenseByDecryptedKey(rawKey) {
+    const dir = provarLicensesDir();
+    if (!fs.existsSync(dir))
+        return null;
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return null;
+    }
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.properties'))
+            continue;
+        try {
+            const content = fs.readFileSync(path.join(dir, entry.name), 'utf-8');
+            const props = parseProperties(content);
+            const encryptedKey = props.get('licenseKey');
+            if (!encryptedKey)
+                continue;
+            const decrypted = decryptLicenseKeyField(encryptedKey);
+            if (decrypted !== rawKey)
+                continue;
+            const licenseStatus = props.get('licenseStatus') ?? '';
+            const licenseType = parseLicenseType(props.get('licenseType') ?? '');
+            const lastCheck = parseInt(props.get('lastOnlineAvailabilityCheckUtc') ?? '0', 10);
+            return {
+                name: entry.name.slice(0, -'.properties'.length),
+                licenseType,
+                activated: licenseStatus === 'Activated',
+                lastOnlineCheckMs: isNaN(lastCheck) ? 0 : lastCheck,
+            };
+        }
+        catch {
+            // Unreadable or corrupt file — skip
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=ideDetection.js.map

package/lib/mcp/licensing/ideDetection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ideDetection.js","sourceRoot":"","sources":["../../../src/mcp/licensing/ideDetection.ts"],"names":[],"mappings":"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"}

package/lib/mcp/licensing/index.d.ts

@@ -0,0 +1,5 @@
+export { LicenseError } from './licenseError.js';
+export { validateLicense } from './licenseValidator.js';
+export type { LicenseValidationResult } from './licenseValidator.js';
+export { findActivatedIdeLicense, readIdeLicenses } from './ideDetection.js';
+export type { IdeLicenseState } from './ideDetection.js';

package/lib/mcp/licensing/index.js

@@ -0,0 +1,10 @@
+/*
+ * Copyright (c) 2024 Provar Limited.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.md file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+export { LicenseError } from './licenseError.js';
+export { validateLicense } from './licenseValidator.js';
+export { findActivatedIdeLicense, readIdeLicenses } from './ideDetection.js';
+//# sourceMappingURL=index.js.map

package/lib/mcp/licensing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/licensing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/mcp/licensing/licenseCache.d.ts

@@ -0,0 +1,20 @@
+export type LicenseType = 'Trial' | 'Floating' | 'FixedSeat' | 'None' | 'Whitelisted';
+export interface CacheEntry {
+    keyHash: string;
+    valid: boolean;
+    licenseType: LicenseType;
+    checkedAt: number;
+    expiresAt?: number;
+}
+/** Re-validate against ALGAS after 2 hours — mirrors License4J's online check interval. */
+export declare const ONLINE_TTL_MS: number;
+/** Allow cached result for up to 48 hours when ALGAS is unreachable. */
+export declare const OFFLINE_GRACE_MS: number;
+/** Hash the raw license key so we never store it on disk. */
+export declare function hashKey(licenseKey: string): string;
+export declare function readCacheEntry(keyHash: string): CacheEntry | null;
+export declare function writeCacheEntry(entry: CacheEntry): void;
+/** True when the cached entry is fresh enough to skip the next ALGAS call. */
+export declare function isCacheEntryFresh(entry: CacheEntry): boolean;
+/** True when the cached entry is within the 48-hour offline grace window. */
+export declare function isCacheEntryWithinGrace(entry: CacheEntry): boolean;

package/lib/mcp/licensing/licenseCache.js

@@ -0,0 +1,79 @@
+/*
+ * Copyright (c) 2024 Provar Limited.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.md file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { createHash } from 'node:crypto';
+/**
+ * Store the MCP license cache alongside the Provar IDE's own license folder
+ * (~/Provar/.licenses/) so there is a single authoritative location for all
+ * Provar license state on the machine.  This also enables auto-detection when
+ * a user switches from Provar Automation IDE to Claude + MCP.
+ *
+ * Computed lazily so tests can redirect HOME/USERPROFILE before calling any
+ * cache function without the path being baked in at module-load time.
+ */
+function cacheDir() {
+    const provarHome = process.env['PROVAR_HOME'] ?? path.join(os.homedir(), 'Provar');
+    return path.join(provarHome, '.licenses');
+}
+function cacheFile() {
+    return path.join(cacheDir(), '.mcp-license-cache.json');
+}
+/** Re-validate against ALGAS after 2 hours — mirrors License4J's online check interval. */
+export const ONLINE_TTL_MS = 2 * 60 * 60 * 1000;
+/** Allow cached result for up to 48 hours when ALGAS is unreachable. */
+export const OFFLINE_GRACE_MS = 48 * 60 * 60 * 1000;
+/** Hash the raw license key so we never store it on disk. */
+export function hashKey(licenseKey) {
+    return createHash('sha256').update(licenseKey).digest('hex');
+}
+export function readCacheEntry(keyHash) {
+    try {
+        const file = cacheFile();
+        if (!fs.existsSync(file))
+            return null;
+        const raw = fs.readFileSync(file, 'utf-8');
+        const cache = JSON.parse(raw);
+        return cache[keyHash] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function writeCacheEntry(entry) {
+    try {
+        const dir = cacheDir();
+        const file = cacheFile();
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        let cache = {};
+        if (fs.existsSync(file)) {
+            try {
+                cache = JSON.parse(fs.readFileSync(file, 'utf-8'));
+            }
+            catch {
+                cache = {};
+            }
+        }
+        cache[entry.keyHash] = entry;
+        fs.writeFileSync(file, JSON.stringify(cache, null, 2), 'utf-8');
+    }
+    catch {
+        // Cache write failure is non-fatal; validation result still returned to caller.
+    }
+}
+/** True when the cached entry is fresh enough to skip the next ALGAS call. */
+export function isCacheEntryFresh(entry) {
+    return Date.now() - entry.checkedAt < ONLINE_TTL_MS;
+}
+/** True when the cached entry is within the 48-hour offline grace window. */
+export function isCacheEntryWithinGrace(entry) {
+    return Date.now() - entry.checkedAt < OFFLINE_GRACE_MS;
+}
+//# sourceMappingURL=licenseCache.js.map

package/lib/mcp/licensing/licenseCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"licenseCache.js","sourceRoot":"","sources":["../../../src/mcp/licensing/licenseCache.ts"],"names":[],"mappings":"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"}

package/lib/mcp/licensing/licenseError.d.ts

@@ -0,0 +1,4 @@
+export declare class LicenseError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}

package/lib/mcp/licensing/licenseError.js

@@ -0,0 +1,15 @@
+/*
+ * Copyright (c) 2024 Provar Limited.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.md file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+export class LicenseError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'LicenseError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=licenseError.js.map

package/lib/mcp/licensing/licenseError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"licenseError.js","sourceRoot":"","sources":["../../../src/mcp/licensing/licenseError.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrB,IAAI,CAAS;IAE7B,YAAmB,IAAY,EAAE,OAAe;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/lib/mcp/licensing/licenseValidator.d.ts

@@ -0,0 +1,33 @@
+import { type LicenseType } from './licenseCache.js';
+export interface LicenseValidationResult {
+    valid: boolean;
+    licenseType: LicenseType;
+    /** True when the result came from disk cache rather than a live ALGAS call. */
+    fromCache: boolean;
+    /** True when ALGAS was unreachable and we fell back to the offline grace window. */
+    offlineGrace: boolean;
+}
+/**
+ * Validate the Provar license before starting the MCP server.
+ *
+ * Requires Provar Automation IDE to be installed with an activated licence.
+ * We trust the IDE's own licenseStatus field — if it says "Activated" we
+ * accept it. The IDE is responsible for setting licenseStatus to "Expired"
+ * or "Invalid" when a licence lapses; we do not re-check timing ourselves.
+ *
+ * The result is cached so repeated starts within 2 hours skip the IDE file
+ * read entirely. The 48-hour grace window lets the MCP server keep running
+ * when the IDE files become temporarily inaccessible (e.g. network share,
+ * permission change) after a successful read.
+ *
+ * Validation flow:
+ * 1. MCP cache fresh (< 2h) → serve from cache, skip IDE read
+ * 2. Scan ~/Provar/.licenses/*.properties for an Activated licence
+ * 3. Found → write cache, accept (offlineGrace=false)
+ * 4. Not found but MCP cache within 48h grace → serve, offlineGrace=true
+ * 5. Not found, no usable cache → throw LICENSE_NOT_FOUND
+ *
+ * When NODE_ENV=test this function returns immediately so unit tests never
+ * touch the filesystem.
+ */
+export declare function validateLicense(): Promise<LicenseValidationResult>;