video-context-mcp-server 0.26.1-beta → 0.27.1-beta

package/README.md

@@ -415,7 +415,7 @@ When a free-tier limit is reached, the tool falls back gracefully with a notice
 
 ### Getting a License
 
-License keys are valid for **1 year** and verified **offline** (no network calls at runtime). Contact the author to obtain one.
+License keys are valid for **1 year**. Validation uses a hybrid approach: fast offline Ed25519 verification runs first, then a brief online heartbeat registers your device (up to **5 devices per key**) and enables revocation. The online check has a 5-second timeout; if the server is unreachable, the offline result is used as a fallback — you are never blocked by network issues. Contact the author to obtain a key.
 
 Add `VIDEO_MCP_LICENSE_KEY` to your MCP config `env` block and restart the server:
 
@@ -427,7 +427,7 @@ Add `VIDEO_MCP_LICENSE_KEY` to your MCP config `env` block and restart the serve
 }
 ```
 
-> No registration, no internet check, no extra setup.
+> No account registration required. Validation is offline-first — the brief online heartbeat enforces the device limit and enables revocation, but if the server is unreachable you are never blocked.
 
 ---
 

package/dist/generated/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.26.1-beta";
+export declare const VERSION = "0.27.1-beta";
 //# sourceMappingURL=version.d.ts.map

package/dist/generated/version.js

@@ -1,3 +1,3 @@
 // Auto-generated by scripts/sync-version.ts — do not edit
-export const VERSION = '0.26.1-beta';
+export const VERSION = '0.27.1-beta';
 //# sourceMappingURL=version.js.map

package/dist/index.js

@@ -9,6 +9,7 @@ import { searchTimestampTool } from './tools/searchTimestamp.js';
 import { getVideoInfoTool } from './tools/getVideoInfo.js';
 import { transcribeVideoTool } from './tools/transcribeVideo.js';
 import { setLoggerServer } from './utils/logger.js';
+import { initLicenseValidation } from './utils/license.js';
 import { triggerUpdateCheck, waitForUpdateCheck, wrapWithUpdateNotice, } from './utils/updateCheck.js';
 import { VERSION } from './generated/version.js';
 import { analyzeVideoSchema, summarizeVideoSchema, extractFramesSchema, searchTimestampSchema, getVideoInfoSchema, transcribeVideoSchema, } from './tools/schemas.js';
@@ -28,6 +29,8 @@ async function main() {
     });
     // Wire up the logger so tools can emit progress notifications
     setLoggerServer(server);
+    // Validate the pro license (offline Ed25519 + online heartbeat if key is set)
+    await initLicenseValidation();
     /**
      * Wrap a tool handler to:
      *   1. Trigger the background update-check on the first call (fire-and-forget)

package/dist/index.js.map

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

package/dist/utils/license.d.ts

@@ -9,6 +9,12 @@
  * The license key is read from the VIDEO_MCP_LICENSE_KEY environment variable.
  *
  * Tokens are valid for 1 year from issuance (exp = iat + 365 days).
+ *
+ * Hybrid validation: offline Ed25519 check runs first (fast path). When a key
+ * is present, `initLicenseValidation()` also performs an online heartbeat to
+ * register this device and enforce the 5-device-per-license limit.  The online
+ * check has a 5-second timeout; on failure the offline result is used as a
+ * fallback so legitimate users are never blocked by network issues.
  */
 export interface LicensePayload {
     email: string;
@@ -22,6 +28,19 @@ export interface LicenseInfo {
     email?: string;
     expiresAt?: Date;
     reason?: string;
+    /** Reason returned by the online validation server (e.g. 'device_limit_exceeded', 'revoked') */
+    onlineReason?: string;
+    /** Number of devices currently consuming this license (from online check) */
+    devicesUsed?: number;
+    /** Maximum devices allowed for this license (from online check) */
+    deviceLimit?: number;
+}
+/** Result returned by the online validation endpoint */
+export interface OnlineValidationResult {
+    valid: boolean;
+    reason?: string;
+    devicesUsed?: number;
+    deviceLimit?: number;
 }
 /**
  * Resets the cached license validation result.
@@ -29,6 +48,26 @@ export interface LicenseInfo {
  * @internal
  */
 export declare function _resetLicenseCache(): void;
+/**
+ * Directly sets the license cache for testing purposes.
+ * Allows simulating a pre-validated cache state (e.g. stale online check).
+ * @internal
+ */
+export declare function _setLicenseCacheForTesting(result: LicenseInfo, validatedAt: number, onlineChecked: boolean): void;
+/**
+ * Returns a stable, non-PII 16-character hex device identifier.
+ * Computed as the first 16 hex chars of:
+ *   SHA-256(hostname + platform + arch + username)
+ */
+export declare function getDeviceFingerprint(): string;
+/**
+ * Sends a heartbeat to the license validation server.
+ *
+ * @param token       - The raw license token string
+ * @param fingerprint - Device fingerprint from `getDeviceFingerprint()`
+ * @returns           - Online validation result (valid + metadata)
+ */
+export declare function validateOnline(token: string, fingerprint: string): Promise<OnlineValidationResult>;
 /**
  * Validates a raw license token string and returns detailed info.
  *
@@ -36,14 +75,30 @@ export declare function _resetLicenseCache(): void;
  * @param nowSec - Current time in Unix seconds (overridable for testing)
  */
 export declare function validateLicenseToken(token: string, nowSec?: number): LicenseInfo;
+/**
+ * Initializes the license validation cache by running both offline and
+ * (if a key is present and offline passes) online validation.
+ *
+ * Must be called once at process startup before the first `isPro()` call.
+ * Subsequent `isPro()` calls return the cached result synchronously.
+ *
+ * Worst-case startup delay: 5 s (only when online check times out).
+ */
+export declare function initLicenseValidation(): Promise<void>;
 /**
  * Returns detailed license validation info.
- * The result is cached after the first call (per process lifetime).
+ *
+ * Uses the cache populated by `initLicenseValidation()`. If the cache is stale
+ * (> 24 h since last online check), the last known result is returned and a
+ * background refresh is triggered for the next call.
+ *
+ * Falls back to a synchronous offline check if the cache was never populated
+ * (e.g. in tests or if `initLicenseValidation()` was not called).
  */
 export declare function getLicenseInfo(): LicenseInfo;
 /**
  * Returns true if the current process has a valid (non-expired) pro license.
- * The result is cached after the first call (per process lifetime).
+ * Synchronous — relies on the cache populated by `initLicenseValidation()`.
  */
 export declare function isPro(): boolean;
 /**

package/dist/utils/license.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../../src/utils/license.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiBH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAmBD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAsC,GAC7C,WAAW,CA4Db;AAMD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAED;;;GAGG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOjD"}
+{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../../src/utils/license.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA0BH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wDAAwD;AACxD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AA4BD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,OAAO,GACrB,IAAI,CAEN;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAQ7C;AAMD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,sBAAsB,CAAC,CAgDjC;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAsC,GAC7C,WAAW,CA4Db;AAMD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAgE3D;AAuCD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAoB5C;AAED;;;GAGG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBjD"}

package/dist/utils/license.js

@@ -9,8 +9,16 @@
  * The license key is read from the VIDEO_MCP_LICENSE_KEY environment variable.
  *
  * Tokens are valid for 1 year from issuance (exp = iat + 365 days).
+ *
+ * Hybrid validation: offline Ed25519 check runs first (fast path). When a key
+ * is present, `initLicenseValidation()` also performs an online heartbeat to
+ * register this device and enforce the 5-device-per-license limit.  The online
+ * check has a 5-second timeout; on failure the offline result is used as a
+ * fallback so legitimate users are never blocked by network issues.
  */
 import * as crypto from 'node:crypto';
+import * as os from 'node:os';
+import { logProgress } from './logger.js';
 // ---------------------------------------------------------------------------
 // Embedded public key (Ed25519, PEM format)
 // Replace this with the real public key generated by scripts/generate-license.ts
@@ -18,6 +26,10 @@ import * as crypto from 'node:crypto';
 const PUBLIC_KEY_PEM = `-----BEGIN PUBLIC KEY-----
 MCowBQYDK2VwAyEA92GHVIXluVRurAJ8C20JIQi8vezWgKcZ8HsFYvtRtmY=
 -----END PUBLIC KEY-----`;
+/** Default license validation server. Set VIDEO_MCP_LICENSE_SERVER='' to disable. */
+const DEFAULT_LICENSE_SERVER = 'https://video-mcp-license.video-context-mcp.workers.dev';
+/** Online result cache TTL: 24 hours in milliseconds */
+const ONLINE_TTL_MS = 24 * 60 * 60 * 1000;
 // ---------------------------------------------------------------------------
 // Base64url helpers (no external deps)
 // ---------------------------------------------------------------------------
@@ -28,19 +40,100 @@ function base64urlDecode(str) {
     return Buffer.from(base64 + '='.repeat(pad), 'base64');
 }
 // ---------------------------------------------------------------------------
-// Cached result — validated once per process lifetime
+// Cache — richer than before to support TTL-based refresh
 // ---------------------------------------------------------------------------
-let cachedResult = null;
+let licenseCache = null;
 /**
  * Resets the cached license validation result.
  * Exposed for testing purposes only.
  * @internal
  */
 export function _resetLicenseCache() {
-    cachedResult = null;
+    licenseCache = null;
+}
+/**
+ * Directly sets the license cache for testing purposes.
+ * Allows simulating a pre-validated cache state (e.g. stale online check).
+ * @internal
+ */
+export function _setLicenseCacheForTesting(result, validatedAt, onlineChecked) {
+    licenseCache = { result, validatedAt, onlineChecked };
+}
+// ---------------------------------------------------------------------------
+// Device fingerprint
+// ---------------------------------------------------------------------------
+/**
+ * Returns a stable, non-PII 16-character hex device identifier.
+ * Computed as the first 16 hex chars of:
+ *   SHA-256(hostname + platform + arch + username)
+ */
+export function getDeviceFingerprint() {
+    const raw = [
+        os.hostname(),
+        os.platform(),
+        os.arch(),
+        os.userInfo().username,
+    ].join('|');
+    return crypto.createHash('sha256').update(raw).digest('hex').slice(0, 16);
+}
+// ---------------------------------------------------------------------------
+// Online validation
+// ---------------------------------------------------------------------------
+/**
+ * Sends a heartbeat to the license validation server.
+ *
+ * @param token       - The raw license token string
+ * @param fingerprint - Device fingerprint from `getDeviceFingerprint()`
+ * @returns           - Online validation result (valid + metadata)
+ */
+export async function validateOnline(token, fingerprint) {
+    const serverUrl = process.env.VIDEO_MCP_LICENSE_SERVER ?? DEFAULT_LICENSE_SERVER;
+    // Allow disabling online validation by setting the var to empty string
+    if (!serverUrl) {
+        return { valid: true, reason: 'online_disabled' };
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    try {
+        const response = await fetch(`${serverUrl}/v1/validate`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                token,
+                fingerprint,
+                metadata: {
+                    os: os.platform(),
+                    arch: os.arch(),
+                    nodeVersion: process.version,
+                },
+            }),
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            try {
+                const json = JSON.parse(text);
+                return json;
+            }
+            catch {
+                return { valid: false, reason: `server_error_${response.status}` };
+            }
+        }
+        const json = (await response.json());
+        return json;
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === 'AbortError') {
+            return { valid: false, reason: 'timeout' };
+        }
+        return { valid: false, reason: 'network_error' };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
 }
 // ---------------------------------------------------------------------------
-// Core validation
+// Core offline validation
 // ---------------------------------------------------------------------------
 /**
  * Validates a raw license token string and returns detailed info.
@@ -102,22 +195,131 @@ export function validateLicenseToken(token, nowSec = Math.floor(Date.now() / 100
     };
 }
 // ---------------------------------------------------------------------------
+// Hybrid validation — run once at startup
+// ---------------------------------------------------------------------------
+/**
+ * Initializes the license validation cache by running both offline and
+ * (if a key is present and offline passes) online validation.
+ *
+ * Must be called once at process startup before the first `isPro()` call.
+ * Subsequent `isPro()` calls return the cached result synchronously.
+ *
+ * Worst-case startup delay: 5 s (only when online check times out).
+ */
+export async function initLicenseValidation() {
+    const token = process.env.VIDEO_MCP_LICENSE_KEY ?? '';
+    // Step 1: Offline check
+    const offlineResult = validateLicenseToken(token);
+    // No key or offline failure → cache immediately, skip online
+    if (!offlineResult.valid) {
+        licenseCache = {
+            result: offlineResult,
+            validatedAt: 0,
+            onlineChecked: false,
+        };
+        return;
+    }
+    // Step 2: Online check (token is offline-valid)
+    const serverUrl = process.env.VIDEO_MCP_LICENSE_SERVER ?? DEFAULT_LICENSE_SERVER;
+    if (!serverUrl) {
+        // Online validation explicitly disabled
+        licenseCache = {
+            result: offlineResult,
+            validatedAt: Date.now(),
+            onlineChecked: false,
+        };
+        return;
+    }
+    const fingerprint = getDeviceFingerprint();
+    const onlineResult = await validateOnline(token, fingerprint);
+    if (onlineResult.reason === 'timeout' ||
+        onlineResult.reason === 'network_error') {
+        // Network failure → fall back to offline result with a warning
+        logProgress(`[video-mcp] License online check failed (${onlineResult.reason}). ` +
+            'Falling back to offline validation.');
+        licenseCache = {
+            result: offlineResult,
+            validatedAt: 0,
+            onlineChecked: false,
+        };
+        return;
+    }
+    // Online result takes precedence
+    const finalResult = {
+        ...offlineResult,
+        valid: onlineResult.valid,
+        onlineReason: onlineResult.reason,
+        devicesUsed: onlineResult.devicesUsed,
+        deviceLimit: onlineResult.deviceLimit,
+    };
+    licenseCache = {
+        result: finalResult,
+        validatedAt: Date.now(),
+        onlineChecked: true,
+    };
+}
+/**
+ * Fires a background (non-blocking) online re-validation to refresh a stale
+ * cache entry. Updates `licenseCache` in place when the response arrives.
+ */
+function _refreshOnlineAsync() {
+    const token = process.env.VIDEO_MCP_LICENSE_KEY ?? '';
+    const fingerprint = getDeviceFingerprint();
+    validateOnline(token, fingerprint)
+        .then((onlineResult) => {
+        if (onlineResult.reason === 'timeout' ||
+            onlineResult.reason === 'network_error') {
+            return; // Keep stale cached result
+        }
+        if (licenseCache) {
+            licenseCache.result = {
+                ...licenseCache.result,
+                valid: onlineResult.valid,
+                onlineReason: onlineResult.reason,
+                devicesUsed: onlineResult.devicesUsed,
+                deviceLimit: onlineResult.deviceLimit,
+            };
+            licenseCache.validatedAt = Date.now();
+            licenseCache.onlineChecked = true;
+        }
+    })
+        .catch(() => {
+        // Silently ignore — stale cache result is fine
+    });
+}
+// ---------------------------------------------------------------------------
 // Public API
 // ---------------------------------------------------------------------------
 /**
  * Returns detailed license validation info.
- * The result is cached after the first call (per process lifetime).
+ *
+ * Uses the cache populated by `initLicenseValidation()`. If the cache is stale
+ * (> 24 h since last online check), the last known result is returned and a
+ * background refresh is triggered for the next call.
+ *
+ * Falls back to a synchronous offline check if the cache was never populated
+ * (e.g. in tests or if `initLicenseValidation()` was not called).
  */
 export function getLicenseInfo() {
-    if (cachedResult)
-        return cachedResult;
-    const token = process.env.VIDEO_MCP_LICENSE_KEY ?? '';
-    cachedResult = validateLicenseToken(token);
-    return cachedResult;
+    if (!licenseCache) {
+        // Fallback: synchronous offline-only check (no initLicenseValidation called)
+        const token = process.env.VIDEO_MCP_LICENSE_KEY ?? '';
+        const result = validateLicenseToken(token);
+        licenseCache = { result, validatedAt: 0, onlineChecked: false };
+        return result;
+    }
+    // Check if online result has gone stale
+    const onlineTTLExpired = licenseCache.onlineChecked &&
+        Date.now() - licenseCache.validatedAt > ONLINE_TTL_MS;
+    if (onlineTTLExpired) {
+        // Return last known result and kick off background refresh
+        _refreshOnlineAsync();
+    }
+    return licenseCache.result;
 }
 /**
  * Returns true if the current process has a valid (non-expired) pro license.
- * The result is cached after the first call (per process lifetime).
+ * Synchronous — relies on the cache populated by `initLicenseValidation()`.
  */
 export function isPro() {
     return getLicenseInfo().valid;
@@ -128,6 +330,13 @@ export function isPro() {
  * @param feature - Human-readable name of the pro feature
  */
 export function proNotice(feature) {
+    const info = getLicenseInfo();
+    // Device limit exceeded — give a specific, actionable message
+    if (info.onlineReason === 'device_limit_exceeded') {
+        const used = info.devicesUsed ?? '?';
+        const limit = info.deviceLimit ?? 5;
+        return `⚡ License device limit reached (${used}/${limit} devices).`;
+    }
     return (`⚡ Pro feature: ${feature}. ` +
         'Using free-tier limit instead. ' +
         'Set VIDEO_MCP_LICENSE_KEY to unlock. ' +

package/dist/utils/license.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "video-context-mcp-server",
-  "version": "0.26.1-beta",
+  "version": "0.27.1-beta",
   "description": "A Model Context Protocol server that gives GitHub Copilot the ability to understand and analyze video content",
   "type": "module",
   "main": "dist/index.js",