@nklisch/pi-enhanced 0.1.11 → 0.2.0

package/node_modules/@nklisch/pi-plugins/dist/application/plugin-lifecycle-service.d.ts

@@ -1,13 +1,9 @@
 import { z } from "zod";
 import { type LifecycleOperation, type LifecycleOrigin, type LifecycleRejectionCode, type LifecycleRetainedData } from "./plugin-lifecycle-contract.js";
-import { type ActivationObservation, type LifecycleReloadPort } from "./ports/lifecycle-reload.js";
-import { type ProjectionExpectation, type RuntimeProjectionPort } from "./ports/runtime-projection.js";
-import { type LifecycleTransitionStore } from "./ports/lifecycle-transition-store.js";
-import type { LifecycleOperationIdPort } from "./ports/lifecycle-operation-id.js";
+import type { LifecycleReloadPort } from "./ports/lifecycle-reload.js";
 import type { InstalledPluginLoader } from "./ports/installed-plugin-loader.js";
-import { type AutomaticUpdateAuthorizationEvidence } from "./automatic-update-authorization.js";
-import type { PluginMaterializer } from "./source-materialization.js";
-import { type CandidateContentLease } from "./ports/candidate-content-lease.js";
+import type { PluginMaterializer, SourceContext } from "./source-materialization.js";
+import type { CandidateContentLease } from "./ports/candidate-content-lease.js";
 import type { PreparedLifecycleCandidateBinding } from "./trusted-install-contract.js";
 import type { LifecycleTargetExpectation } from "./native-lifecycle-operation-contract.js";
 import type { PluginInspectionService } from "./inspection-service.js";
@@ -20,15 +16,16 @@ import type { SecretStore } from "./ports/secret-store.js";
 import type { ConfigurationPathPort, ConfigurationPathContext } from "./ports/configuration-path.js";
 import type { LifecycleStateStore } from "./ports/lifecycle-state-store.js";
 import { type GenerationSnapshot } from "./state-contract.js";
-import { type InstalledPluginRecord, type InstalledRevisionRecord } from "../domain/state/installed-state.js";
+import { type InstalledPluginRecord } from "../domain/state/installed-state.js";
 import { type ScopeContext, type ScopeReference } from "../domain/state/scope.js";
 import { type PluginKey } from "../domain/identity.js";
-import type { Generation } from "../domain/state/config-state.js";
+import { type Generation } from "../domain/state/config-state.js";
 import type { TrustStateRecord } from "../domain/state/trust-state.js";
 import type { NormalizedMarketplaceEntry } from "../domain/marketplace.js";
-import type { ResolvedMarketplaceSource } from "../domain/source.js";
-import type { SourceContext } from "./source-materialization.js";
-import type { Sha256 } from "../domain/source.js";
+import type { ResolvedMarketplaceSource, Sha256 } from "../domain/source.js";
+import { type ContentDigest } from "../domain/content-manifest.js";
+import type { PendingDeleteMarkerStore } from "./ports/pending-data-deletion.js";
+import type { PersistentDataRemovalPort } from "./ports/persistent-data-removal.js";
 export type InstallPluginRequest = Readonly<{
     scope: ScopeContext;
     plugin: PluginKey;
@@ -38,15 +35,10 @@ export type InstallPluginRequest = Readonly<{
     sourceContext: SourceContext;
     trustRecords?: readonly TrustStateRecord[];
     configurationPathContext: ConfigurationPathContext;
-    expectedRevision?: import("../domain/content-manifest.js").ContentDigest;
-    automaticAuthorization?: AutomaticUpdateAuthorizationEvidence;
+    expectedRevision?: ContentDigest;
+    automaticAuthorization?: import("./automatic-update-authorization.js").AutomaticUpdateAuthorizationEvidence;
 }>;
 export type UpdatePluginRequest = InstallPluginRequest & ExpectedLifecycleTarget & Readonly<{
-    /**
-     * "deferred" commits the update and deliberately leaves activation to the
-     * next start/reload (staged update). Default "immediate" drives a reload
-     * and observes activation before settling.
-     */
     activation?: "immediate" | "deferred";
 }>;
 type ExpectedLifecycleTarget = Readonly<{
@@ -58,7 +50,7 @@ export type EnablePluginRequest = Readonly<{
     origin?: LifecycleOrigin;
     trustRecords?: readonly TrustStateRecord[];
     configurationPathContext: ConfigurationPathContext;
-    expectedConfigurationRevision?: import("../domain/content-manifest.js").ContentDigest;
+    expectedConfigurationRevision?: ContentDigest;
 }> & ExpectedLifecycleTarget;
 export type DisablePluginRequest = Readonly<{
     scope: ScopeContext;
@@ -71,64 +63,56 @@ export type UninstallPluginRequest = Readonly<{
     origin?: LifecycleOrigin;
     retainedData?: LifecycleRetainedData;
 }> & ExpectedLifecycleTarget;
-export type LifecycleActivationFailure = Readonly<{
-    kind: "reload-rejected";
-    code: "RELOAD_REJECTED";
-}> | Readonly<{
-    kind: "activation-unavailable";
-    code: "PI_RELOAD_CONTEXT_UNAVAILABLE";
-}> | Readonly<{
-    kind: "observation-mismatch";
-    code: "OBSERVATION_MISMATCH";
-}> | Readonly<{
-    kind: "adapter-error";
-    code: "ADAPTER_FAILED" | "ABORTED";
-}>;
-export type LifecycleCleanupIntent = Readonly<{
-    kind: "deferred";
-    retainedData: LifecycleRetainedData;
-    transition: import("../domain/state/references.js").PendingTransitionRef;
+/** Repair needs the current catalog handoff because installed state retains only
+ * hashed source evidence, never executable URLs or paths. */
+export type RepairPluginRequest = Readonly<{
+    scope: ScopeContext;
+    plugin: PluginKey;
+    entry: NormalizedMarketplaceEntry;
+    marketplaceSource: ResolvedMarketplaceSource;
+    sourceContext: SourceContext;
+    trustRecords?: readonly TrustStateRecord[];
+    configurationPathContext: ConfigurationPathContext;
+    expectedConfigurationRevision?: ContentDigest;
 }>;
+export type RollbackPluginRequest = Readonly<{
+    scope: ScopeContext;
+    plugin: PluginKey;
+}> & ExpectedLifecycleTarget;
+/** Lifecycle outcomes intentionally describe state authority, not a durable operation journal. */
 export type PluginLifecycleResult = Readonly<{
-    kind: "changed";
+    kind: "applied";
     operation: LifecycleOperation;
     snapshot: GenerationSnapshot;
-    observation: ActivationObservation;
-    cleanup?: LifecycleCleanupIntent;
+    activation?: "applied" | "live-next-start";
 }> | Readonly<{
-    kind: "unchanged";
+    kind: "live-next-start";
     operation: LifecycleOperation;
     snapshot: GenerationSnapshot;
+    note?: "no-reload-context" | "reload-failed";
 }> | Readonly<{
-    kind: "rejected";
+    kind: "degraded";
     operation: LifecycleOperation;
-    code: LifecycleRejectionCode;
-}> | Readonly<{
-    kind: "stale";
-    operation: LifecycleOperation;
-    expected: Generation;
-    actual: Generation;
+    snapshot: GenerationSnapshot;
+    failure: Readonly<{
+        plugin: PluginKey;
+        code: string;
+        explanation: string;
+    }>;
+    runningRevision?: ContentDigest;
 }> | Readonly<{
-    kind: "rolled-back";
+    kind: "current";
     operation: LifecycleOperation;
-    failure: LifecycleActivationFailure;
     snapshot: GenerationSnapshot;
-    observation: ActivationObservation;
 }> | Readonly<{
-    kind: "recovery-required";
+    kind: "rejected";
     operation: LifecycleOperation;
-    transition: import("../domain/state/references.js").PendingTransitionRef;
-    committed?: Generation;
+    code: LifecycleRejectionCode;
 }> | Readonly<{
-    /**
-     * Committed with activation deliberately deferred: the durable
-     * transition stays pending and the next start/reload activates and
-     * settles it through the normal recovery path.
-     */
-    kind: "staged";
+    kind: "stale";
     operation: LifecycleOperation;
-    transition: import("../domain/state/references.js").PendingTransitionRef;
-    snapshot: GenerationSnapshot;
+    expected: Generation;
+    actual?: Generation;
 }>;
 export interface PluginLifecycleService {
     install(request: InstallPluginRequest, signal: AbortSignal): Promise<PluginLifecycleResult>;
@@ -136,6 +120,8 @@ export interface PluginLifecycleService {
     disable(request: DisablePluginRequest, signal: AbortSignal): Promise<PluginLifecycleResult>;
     update(request: UpdatePluginRequest, signal: AbortSignal): Promise<PluginLifecycleResult>;
     uninstall(request: UninstallPluginRequest, signal: AbortSignal): Promise<PluginLifecycleResult>;
+    repair(request: RepairPluginRequest, signal: AbortSignal): Promise<PluginLifecycleResult>;
+    rollback(request: RollbackPluginRequest, signal: AbortSignal): Promise<PluginLifecycleResult>;
 }
 export type PreparedLifecycleMutationRequest = Readonly<{
     scope: ScopeContext;
@@ -145,7 +131,7 @@ export type PreparedLifecycleMutationRequest = Readonly<{
     sourceContext: SourceContext;
     lease: CandidateContentLease;
     expected: PreparedLifecycleCandidateBinding;
-    expectedConfigurationRevision?: import("../domain/content-manifest.js").ContentDigest;
+    expectedConfigurationRevision?: ContentDigest;
     configurationPathContext: ConfigurationPathContext;
 }>;
 export interface PreparedLifecycleAuthority {
@@ -154,7 +140,6 @@ export interface PreparedLifecycleAuthority {
         expectedTarget: LifecycleTargetExpectation;
     }>, signal: AbortSignal): Promise<PluginLifecycleResult>;
 }
-/** Source-compatible trusted-install authority name. */
 export type PreparedInstallLifecycleAuthority = Pick<PreparedLifecycleAuthority, "installPrepared">;
 export type PluginLifecycleComposition = Readonly<{
     application: PluginLifecycleService;
@@ -163,35 +148,32 @@ export type PluginLifecycleComposition = Readonly<{
 }>;
 export type PluginLifecycleServiceDependencies = Readonly<{
     state: LifecycleStateStore;
-    mutations: import("./generation-mutation-coordinator.js").GenerationMutationCoordinator;
     content: ContentStorePort;
     materializer: PluginMaterializer;
     inspector: PluginInspectionService;
     compatibility: CompatibilityService;
     installed: InstalledPluginLoader;
-    projections: RuntimeProjectionPort;
+    projections: import("./ports/runtime-projection.js").RuntimeProjectionPort;
     reload: LifecycleReloadPort;
-    transitions: LifecycleTransitionStore;
-    operationIds: LifecycleOperationIdPort;
     projectTrust: ProjectTrustPort;
     projectRoots: ProjectRootAuthorityPort;
     configurations: PluginConfigurationStore;
     secrets: SecretStore;
     paths: ConfigurationPathPort;
     sha256: Sha256;
+    pendingDeletes?: PendingDeleteMarkerStore;
+    dataRemoval?: PersistentDataRemovalPort;
 }>;
 export declare function createPluginLifecycleComposition(dependencies: PluginLifecycleServiceDependencies): PluginLifecycleComposition;
-/** Source-compatible public lifecycle factory. */
 export declare function createPluginLifecycleService(dependencies: PluginLifecycleServiceDependencies): PluginLifecycleService;
 export declare const PluginLifecycleResultSchema: z.ZodReadonly<z.ZodObject<{
     kind: z.ZodEnum<{
-        changed: "changed";
-        "recovery-required": "recovery-required";
+        applied: "applied";
+        current: "current";
+        degraded: "degraded";
+        "live-next-start": "live-next-start";
         rejected: "rejected";
-        "rolled-back": "rolled-back";
-        staged: "staged";
         stale: "stale";
-        unchanged: "unchanged";
     }>;
 }, z.core.$loose>>;
-export type { ActivationObservation, ConfigurationPathContext, Generation, GenerationSnapshot, InstalledPluginRecord, InstalledRevisionRecord, PluginKey, ProjectionExpectation, ScopeContext, ScopeReference, };
+export type { ConfigurationPathContext, Generation, GenerationSnapshot, InstalledPluginRecord, PluginKey, ScopeContext, ScopeReference };