agl 22.0.0 → 22.0.2

package/dist_ts/classes.upgradecoordinator.d.ts

@@ -92,6 +92,7 @@ export interface IUpgradeTransactionV2 extends IUpgradeTransactionBase {
     version: typeof coordinationVersion;
     sourceVersion: string;
     targetVersion?: string;
+    registryUrl?: string;
     targetStartupInvoked?: true;
 }
 export interface IUpgradeTransactionV3 extends IUpgradeTransactionBase {
@@ -106,6 +107,7 @@ export interface IUpgradeTransactionV3 extends IUpgradeTransactionBase {
     targetManagementVersion: typeof upgradePackageTransitionTarget.managementVersion;
     targetCliName: typeof upgradePackageTransitionTarget.cliName;
     targetCliRelativePath: typeof upgradePackageTransitionTarget.cliRelativePath;
+    recoveryTargetVersion?: string;
     packageTransitionStarted?: true;
     groupedTargetVerified?: true;
     targetPackageCommitStarted?: true;
@@ -113,8 +115,31 @@ export interface IUpgradeTransactionV3 extends IUpgradeTransactionBase {
     targetStartupInvoked?: true;
 }
 export type TUpgradeTransaction = IUpgradeTransactionV2 | IUpgradeTransactionV3;
+export interface IUpgradeTransactionInventoryEntry {
+    fileName: string;
+    state: 'active' | 'adopting';
+    transaction: TUpgradeTransaction;
+}
+export interface IUpgradeTransactionInventory {
+    transactions: IUpgradeTransactionInventoryEntry[];
+    tokenMetadataFileNames: string[];
+    mutationDirectoryNames: string[];
+}
+export interface IAdoptOrphanedUpgradeTransactionOptions {
+    lock: UpgradeInstallationLock;
+    token: string;
+    expectedTokenHash: string;
+    expectedRevision: number;
+    port: number;
+    installedVersion: string;
+    registryUrl?: string;
+}
 export type TUpgradeControllerAction = 'prepare' | 'finalize';
+export declare const compareUpgradeSemver: (leftArg: string, rightArg: string) => number;
+export declare const normalizeUpgradeRegistryUrl: (valueArg: unknown) => string;
 export declare const upgradeTransactionIsStalled: (transactionArg: TUpgradeTransaction, nowArg?: number) => boolean;
+export declare const upgradeTransactionRequiresForwardRecovery: (transactionArg: TUpgradeTransaction) => boolean;
+export declare const upgradeTransactionTargetVersion: (transactionArg: TUpgradeTransaction) => string | undefined;
 declare class UpgradeOwnedDirectory {
     readonly directory: string;
     readonly owner: IUpgradeProcessOwner;
@@ -130,6 +155,13 @@ export declare class UpgradeInstallationLock extends UpgradeOwnedDirectory {
 }
 export declare class UpgradeStartLease extends UpgradeOwnedDirectory {
 }
+export interface IVerifiedUpgradeWorkerProcessGroup {
+    pid: number;
+    processGroupId: number;
+    fingerprint: string;
+    cliPath: string;
+}
+export declare const terminateVerifiedUpgradeWorkerProcessGroup: (worker: IVerifiedUpgradeWorkerProcessGroup) => Promise<void>;
 export declare class UpgradeCoordinator {
     readonly canonicalGlobalRoot: string;
     readonly uid: number;
@@ -143,7 +175,9 @@ export declare class UpgradeCoordinator {
     private initializationTask?;
     constructor(canonicalGlobalRoot: string);
     init(): Promise<void>;
+    initializeExistingCanonicalState(): Promise<void>;
     private performInitialization;
+    inspectCanonicalTransactionInventory(): Promise<IUpgradeTransactionInventory>;
     private ownershipGuardDirectory;
     private inspectOwnershipGuardDirectory;
     private reclaimOwnershipGuardDirectory;
@@ -179,10 +213,13 @@ export declare class UpgradeCoordinator {
     private transactionFilePath;
     private transactionMutationDirectory;
     private withTransactionMutation;
+    private cleanupUncommittedAdoptionAuditsUnderLock;
+    adoptOrphanedTransaction(optionsArg: IAdoptOrphanedUpgradeTransactionOptions): Promise<TUpgradeTransaction>;
     createTransaction(optionsArg: {
         token: string;
         port: number;
         sourceVersion: string;
+        registryUrl?: string;
         controllerWasRunning: boolean;
         continueSessions: boolean;
         gracePeriodMs: number;
@@ -240,7 +277,8 @@ export declare class UpgradeCoordinator {
         packageVersion: string;
         controller: IUpgradeExpectedController;
     }): Promise<void>;
-    acknowledgeWorker(tokenArg: string): Promise<void>;
+    removeWorkerAcknowledgement(tokenArg: string): Promise<void>;
+    acknowledgeWorker(tokenArg: string, workerArg: Pick<IVerifiedUpgradeWorkerProcessGroup, 'pid' | 'processGroupId' | 'fingerprint'>): Promise<void>;
     waitForWorkerAcknowledgement(tokenArg: string, timeoutMsArg?: number): Promise<void>;
 }
 export declare const createUpgradeToken: () => string;