@floegence/redevplugin-ui 3.0.13 → 3.0.15

package/dist/errors.d.ts

@@ -13,8 +13,9 @@ export declare class PluginPlatformRequestError extends Error {
 }
 export declare class PluginTransportError extends Error {
     readonly mutationOutcome?: PluginMutationOutcome;
+    readonly httpStatus?: number;
     readonly cause: unknown;
-    constructor(message: string, cause: unknown, mutationOutcome?: PluginMutationOutcome);
+    constructor(message: string, cause: unknown, mutationOutcome?: PluginMutationOutcome, httpStatus?: number);
 }
 export declare class PluginBridgeError extends Error {
     readonly errorCode: string;

package/dist/errors.js

@@ -13,12 +13,14 @@ export class PluginPlatformRequestError extends Error {
 }
 export class PluginTransportError extends Error {
     mutationOutcome;
+    httpStatus;
     cause;
-    constructor(message, cause, mutationOutcome) {
+    constructor(message, cause, mutationOutcome, httpStatus) {
         super(message, { cause });
         this.name = "PluginTransportError";
         this.cause = cause;
         this.mutationOutcome = mutationOutcome;
+        this.httpStatus = httpStatus;
     }
 }
 export class PluginBridgeError extends Error {

package/dist/http.js

@@ -60,19 +60,21 @@ async function readResponse(response, mutation) {
         raw = await response.json();
     }
     catch (cause) {
-        throw new PluginTransportError(`Plugin platform endpoint returned invalid JSON with HTTP ${response.status}`, cause, mutation ? "unknown" : undefined);
+        throw new PluginTransportError(response.ok && response.status >= 200 && response.status < 300
+            ? `Plugin platform endpoint returned invalid JSON with HTTP ${response.status}`
+            : `Plugin platform endpoint rejected the request with HTTP ${response.status}`, cause, mutation ? "unknown" : undefined, response.status);
     }
     if (!isPlatformResponse(raw, mutation)) {
-        throw new PluginTransportError(`Plugin platform endpoint returned an invalid envelope with HTTP ${response.status}`, new PluginPlatformRequestError("PLUGIN_CONTRACT_MISMATCH", "Invalid platform response envelope"), mutation ? "unknown" : undefined);
+        throw new PluginTransportError(`Plugin platform endpoint returned an invalid envelope with HTTP ${response.status}`, new PluginPlatformRequestError("PLUGIN_CONTRACT_MISMATCH", "Invalid platform response envelope"), mutation ? "unknown" : undefined, response.status);
     }
     if (raw.ok) {
         if (!response.ok || response.status !== 200) {
-            throw new PluginTransportError(`Plugin platform endpoint returned a success envelope with HTTP ${response.status}`, new PluginPlatformRequestError("PLUGIN_CONTRACT_MISMATCH", "HTTP status does not match the platform response envelope"), mutation ? "unknown" : undefined);
+            throw new PluginTransportError(`Plugin platform endpoint returned a success envelope with HTTP ${response.status}`, new PluginPlatformRequestError("PLUGIN_CONTRACT_MISMATCH", "HTTP status does not match the platform response envelope"), mutation ? "unknown" : undefined, response.status);
         }
         return raw.data;
     }
     if (response.ok || response.status === 200) {
-        throw new PluginTransportError(`Plugin platform endpoint returned an error envelope with HTTP ${response.status}`, new PluginPlatformRequestError("PLUGIN_CONTRACT_MISMATCH", "HTTP status does not match the platform response envelope"), mutation ? "unknown" : undefined);
+        throw new PluginTransportError(`Plugin platform endpoint returned an error envelope with HTTP ${response.status}`, new PluginPlatformRequestError("PLUGIN_CONTRACT_MISMATCH", "HTTP status does not match the platform response envelope"), mutation ? "unknown" : undefined, response.status);
     }
     {
         throw new PluginPlatformRequestError(raw.error.code, raw.error.message || `Plugin platform endpoint failed with HTTP ${response.status}`, raw.error.details, "mutation_outcome" in raw.error ? raw.error.mutation_outcome : undefined);

package/dist/openapi.gen.d.ts

@@ -2089,6 +2089,8 @@ export interface components {
         };
         ListExecutionsRequest: {
             plugin_instance_id?: string;
+            /** @enum {string} */
+            operation_scope?: "release_install";
             cursor?: number;
             limit?: number;
         };
@@ -2356,7 +2358,8 @@ export interface components {
             failure_code?: string;
             /** @enum {string} */
             failure_stage?: "download" | "verify" | "install" | "enable";
-        };
+            retryable?: boolean;
+        } & unknown;
         PublicError: {
             code: string;
             message: string;

package/dist/platform.d.ts

@@ -77,11 +77,15 @@ export type PluginSettingsPatchRequest = PluginSettingsPatchBase & ({
 export type PluginCapabilityContractPin = PlatformSchemas["HostCapabilityPinV1"];
 export type PluginExecution = PlatformSchemas["Execution"];
 export type PluginEvent = PlatformSchemas["Event"];
+export type PluginReleaseInstallProgressEvent = PlatformSchemas["ReleaseInstallProgressEvent"];
 export type PluginStartReleaseInstallExecutionRequest = PlatformSchemas["StartReleaseInstallExecutionRequest"];
 export type PluginExecutionList = PlatformSchemas["ExecutionList"];
 export type PluginExecutionEventList = PlatformSchemas["ExecutionEventList"];
 export type PluginExecutionListOptions = PlatformSchemas["ListExecutionsRequest"];
+export type PluginReleaseInstallExecutionListOptions = Omit<PluginExecutionListOptions, "operation_scope">;
 export type PluginExecutionEventListOptions = PlatformSchemas["ListExecutionEventsRequest"];
+/** Reads the stable release-install progress projection from an execution event. */
+export declare function decodePluginReleaseInstallProgressEvent(event: PluginEvent): PluginReleaseInstallProgressEvent | undefined;
 export type PluginIntentRecord = PlatformSchemas["PluginIntentRecord"];
 export type PluginIntentList = PlatformSchemas["PluginIntentList"];
 export type PluginIntentListOptions = PlatformSchemas["ListIntentsQueryRequest"];
@@ -144,6 +148,7 @@ export declare class PluginPlatformClient {
     getSettings(pluginInstanceId: string, scope: PluginResourceScopeKind, options?: PluginRequestOptions): Promise<PluginSettingsSnapshot>;
     patchSettings(pluginInstanceId: string, request: PluginSettingsPatchRequest, options?: PluginRequestOptions): Promise<PluginSettingsSnapshot>;
     listExecutions(options?: PluginExecutionListOptions, requestOptions?: PluginRequestOptions): Promise<PluginExecutionList>;
+    listReleaseInstallExecutions(options?: PluginReleaseInstallExecutionListOptions, requestOptions?: PluginRequestOptions): Promise<PluginExecutionList>;
     startReleaseInstallExecution(request: PluginStartReleaseInstallExecutionRequest, options?: PluginRequestOptions): Promise<PluginExecution>;
     getExecution(executionID: string, options?: PluginRequestOptions): Promise<PluginExecution>;
     cancelExecution(executionID: string, reason?: string, options?: PluginRequestOptions): Promise<PluginExecution>;

package/dist/platform.js

@@ -20,6 +20,58 @@ function toPluginSurfaceHostBootstrap(value) {
         runtimeGenerationId: value.runtime_generation_id,
     };
 }
+const releaseInstallStages = ["download", "verify", "install", "enable"];
+const releaseInstallStatuses = ["pending", "running", "completed", "failed"];
+const releaseInstallProgressKeys = [
+    "task_id",
+    "request_id",
+    "stage",
+    "status",
+    "completed",
+    "total",
+    "failure_code",
+    "failure_stage",
+    "retryable",
+];
+/** Reads the stable release-install progress projection from an execution event. */
+export function decodePluginReleaseInstallProgressEvent(event) {
+    const payload = event?.payload;
+    if (!isRecord(payload))
+        return undefined;
+    const value = payload.install_progress;
+    if (!isRecord(value) || !hasOnlyKeys(value, releaseInstallProgressKeys))
+        return undefined;
+    if (!isNonEmptyString(value.task_id) || !isNonEmptyString(value.request_id))
+        return undefined;
+    if (value.task_id !== event.execution_id)
+        return undefined;
+    if (!isOneOf(value.stage, releaseInstallStages) || !isOneOf(value.status, releaseInstallStatuses)) {
+        return undefined;
+    }
+    const hasCompleted = value.completed !== undefined;
+    const hasTotal = value.total !== undefined;
+    if (hasCompleted !== hasTotal)
+        return undefined;
+    if (hasCompleted &&
+        (!isSafeIntegerAtLeast(value.completed, 0) || !isSafeIntegerAtLeast(value.total, 1))) {
+        return undefined;
+    }
+    if (hasCompleted && Number(value.completed) > Number(value.total))
+        return undefined;
+    const failed = value.status === "failed";
+    if (failed) {
+        if (!isNonEmptyString(value.failure_code) ||
+            !isOneOf(value.failure_stage, releaseInstallStages) ||
+            value.failure_stage !== value.stage ||
+            typeof value.retryable !== "boolean") {
+            return undefined;
+        }
+    }
+    else if (value.failure_code !== undefined || value.failure_stage !== undefined || value.retryable !== undefined) {
+        return undefined;
+    }
+    return value;
+}
 export class PluginPlatformClient {
     #fetch;
     #apiBaseURL;
@@ -161,6 +213,9 @@ export class PluginPlatformClient {
     listExecutions(options = {}, requestOptions = {}) {
         return this.#requestQuery("/_redevplugin/api/plugins/executions/query", options, requestOptions);
     }
+    listReleaseInstallExecutions(options = {}, requestOptions = {}) {
+        return this.listExecutions({ ...options, operation_scope: "release_install" }, requestOptions);
+    }
     startReleaseInstallExecution(request, options = {}) {
         return this.#requestMutation("POST", "/_redevplugin/api/plugins/executions/release-installs", request, options);
     }
@@ -412,6 +467,22 @@ function isPluginSessionScopeRevokeResult(value) {
         return false;
     return sessionScopeCountKeys.every((key) => Number.isSafeInteger(counts[key]) && Number(counts[key]) >= 0);
 }
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasOnlyKeys(value, keys) {
+    const allowed = new Set(keys);
+    return Object.keys(value).every((key) => allowed.has(key));
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+function isOneOf(value, values) {
+    return typeof value === "string" && values.includes(value);
+}
+function isSafeIntegerAtLeast(value, minimum) {
+    return Number.isSafeInteger(value) && Number(value) >= minimum;
+}
 function isExactRecord(value, keys) {
     if (typeof value !== "object" || value === null || Array.isArray(value))
         return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floegence/redevplugin-ui",
-  "version": "3.0.13",
+  "version": "3.0.15",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -40,7 +40,7 @@
     "dist"
   ],
   "dependencies": {
-    "@floegence/redevplugin-contracts": "3.0.13"
+    "@floegence/redevplugin-contracts": "3.0.15"
   },
   "publishConfig": {
     "access": "public"