@qpjoy/electron-launcher 2.1.0 → 2.2.0

package/dist/release-updater.d.ts

@@ -96,6 +96,18 @@ export interface ElectronLauncherUpdateCheckResult {
     decision: ElectronLauncherReleasePolicyDecision;
     artifacts: ElectronLauncherReleaseArtifactRef[];
     reason: string;
+    /** Markdown release notes from the server-side decision, when provided. */
+    releaseNotes?: string | null;
+    /** Feature keys granted to this install by the matched plan. */
+    featureFlags?: string[];
+    /** Why this install did (not) receive the release; shown in the update panel. */
+    rollout?: {
+        matchedBy?: string | null;
+        bucket?: number | null;
+        percentage?: number | null;
+    } | null;
+    /** Which check path produced this result. */
+    checkSource?: 'release-check' | 'plans-legacy';
 }
 export interface ElectronLauncherReleaseUpdaterOptions {
     baseUrl: string;

package/dist/release-updater.js

@@ -11,6 +11,28 @@ export function createElectronLauncherReleaseUpdater(options) {
     return {
         async check(input) {
             const checkedAt = new Date().toISOString();
+            // Preferred path: server-side single-install decision (docs/19 §6). The
+            // server owns target lists and rollout bucketing; the full plans list is
+            // being withdrawn to admin-only. Fall back to the legacy flow against
+            // older servers that do not expose /release/check yet.
+            const installId = input.installId ?? options.reportInstallId ?? null;
+            if (installId) {
+                try {
+                    const payload = await requestJson(fetchImpl, joinUrl(baseUrl, '/internal/v1/release/check'), 'POST', {
+                        installId,
+                        userId: input.userId ?? null,
+                        channel: input.channel,
+                        platform: input.platform ?? null,
+                        components: { [input.componentId]: input.currentVersion }
+                    });
+                    if (payload && typeof payload.status === 'string') {
+                        return mapReleaseCheckPayload(payload, input, baseUrl, checkedAt);
+                    }
+                }
+                catch {
+                    // Older server without /release/check; use the legacy plans flow.
+                }
+            }
             const plansPayload = await requestJson(fetchImpl, joinUrl(baseUrl, '/internal/v1/release-management/plans'), 'GET');
             const plans = Array.isArray(plansPayload.plans) ? plansPayload.plans : [];
             const plan = selectReleasePlan(plans, input);
@@ -42,7 +64,8 @@ export function createElectronLauncherReleaseUpdater(options) {
                 artifacts,
                 reason: status === 'blocked'
                     ? plan?.test?.gate?.reason || `release gate is ${gateVerdict}`
-                    : decision.reason
+                    : decision.reason,
+                checkSource: 'plans-legacy'
             };
         },
         async report(input) {
@@ -96,6 +119,53 @@ export async function downloadElectronLauncherReleaseArtifactToFile(input) {
         bytes
     };
 }
+function mapReleaseCheckPayload(payload, input, baseUrl, checkedAt) {
+    const decision = payload.decision ?? {
+        componentKind: input.componentKind || 'app-managed',
+        componentId: input.componentId,
+        currentVersion: input.currentVersion,
+        targetVersion: input.currentVersion,
+        updateAvailable: false,
+        updateMode: 'none',
+        canSkip: true,
+        canDefer: true,
+        requiresGate: false,
+        rollbackRequired: false,
+        reason: payload.reason
+    };
+    const plan = payload.planId && payload.releaseId
+        ? {
+            planId: payload.planId,
+            releaseId: payload.releaseId,
+            environment: 'internal',
+            channel: payload.channel,
+            installId: input.installId ?? null,
+            userId: input.userId ?? null,
+            createdBy: 'release-check',
+            components: decision.componentKind === 'app-managed' ? { app: decision } : { launcher: decision },
+            artifacts: payload.artifacts ?? [],
+            rollout: {
+                percentage: payload.rollout?.percentage ?? undefined,
+                featureKeys: payload.featureFlags ?? []
+            },
+            activation: payload.activation ?? undefined,
+            createdAt: payload.signedAt
+        }
+        : null;
+    return {
+        checkedAt,
+        baseUrl,
+        status: payload.status,
+        plan,
+        decision,
+        artifacts: payload.artifacts ?? [],
+        reason: payload.reason,
+        releaseNotes: payload.releaseNotes ?? null,
+        featureFlags: payload.featureFlags ?? [],
+        rollout: payload.rollout ?? null,
+        checkSource: 'release-check'
+    };
+}
 function selectReleasePlan(plans, input) {
     return plans.find((plan) => {
         if (plan.channel !== input.channel)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qpjoy/electron-launcher",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Product-facing Electron Launcher client for MX Launcher release, update, rollout, AppCenter, and network integration.",
   "type": "module",
   "main": "dist/index.js",
@@ -53,10 +53,10 @@
     "access": "public"
   },
   "dependencies": {
+    "@qpjoy/mx-launcher-core": "^2.2.0",
     "@qpjoy/electron-core-wireguard": "^2.1.0",
-    "@qpjoy/mx-launcher-embed-sdk": "^2.1.0",
-    "@qpjoy/mx-launcher-core": "^2.1.0",
-    "@qpjoy/mx-launcher-standalone": "^2.1.0"
+    "@qpjoy/mx-launcher-standalone": "^2.2.0",
+    "@qpjoy/mx-launcher-embed-sdk": "^2.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.7",