@modelprofile.com/browser-runtime 3.2.0 → 4.0.0

package/dist_ts/classes.runtimeownership.d.ts

@@ -0,0 +1,102 @@
+export type TOwnershipGenerationRemovalReason = 'stale' | 'startup-failure' | 'stop';
+export interface IBrowserRuntimeOwnershipTestingOptions {
+    procRoot?: string;
+    now?(): number;
+    beforeMetadataPublication?(): Promise<void>;
+    beforeGenerationRemoval?(reason: TOwnershipGenerationRemovalReason): Promise<void>;
+}
+export interface IBrowserRuntimeOwnershipOptions {
+    runtimeDirectory: string;
+    uid: number;
+    testing?: IBrowserRuntimeOwnershipTestingOptions;
+    onOwnershipLost?(): void;
+}
+export interface IBrowserRuntimeGeneration {
+    generationId: string;
+    generationDirectory: string;
+    profileRoot: string;
+    artifactRoot: string;
+}
+export declare class BrowserRuntimeOwnership {
+    readonly runtimeDirectory: string;
+    readonly lockPath: string;
+    readonly anchorDirectory: string;
+    private readonly generationsRoot;
+    private readonly legacyProfileRoot;
+    private readonly legacyArtifactRoot;
+    private readonly uid;
+    private readonly procRoot;
+    private readonly now;
+    private readonly beforeMetadataPublication?;
+    private readonly beforeGenerationRemoval?;
+    private readonly onOwnershipLost?;
+    private directoryHandle?;
+    private directoryIdentity?;
+    private anchorDirectoryHandle?;
+    private anchorDirectoryIdentity?;
+    private anchorIdentity?;
+    private namedMutex?;
+    private namedMutexLease?;
+    private lockHandle?;
+    private lockIdentity?;
+    private createdLock;
+    private leaseLost;
+    private metadata?;
+    private generation?;
+    private acquirePromise?;
+    private releasePromise?;
+    constructor(optionsArg: IBrowserRuntimeOwnershipOptions);
+    get owned(): boolean;
+    get cleanupPending(): boolean;
+    acquire(): Promise<IBrowserRuntimeGeneration>;
+    release(reasonArg?: Exclude<TOwnershipGenerationRemovalReason, 'stale'>): Promise<void>;
+    /** @internal */
+    assertCurrentOwnership(): Promise<void>;
+    private acquireInternal;
+    private openAndValidateRuntimeDirectory;
+    private openAndValidateAnchorDirectory;
+    private acquireNativeLease;
+    private ensurePermanentAnchor;
+    private assertPrivateAnchorStat;
+    private assertNativeAnchorCurrent;
+    /** @internal */
+    forceOwnershipLossForTesting(): Promise<void>;
+    private openAndClassifyLock;
+    private readPrivateLockPathStat;
+    private validateLockHandle;
+    private assertPrivateLockStat;
+    private assertLockPathCurrent;
+    private adoptCreatedLockLayout;
+    private unlinkCreatedLock;
+    private adoptLegacyLock;
+    private legacyLockPredatesCurrentBoot;
+    private readBootTimeNs;
+    private reclaimMetadataGeneration;
+    private publishGeneration;
+    private releaseInternal;
+    private closePassiveHandles;
+    private closeOwnershipHandles;
+    private readMetadata;
+    private writeMetadata;
+    private assertMetadataDirectoryIdentity;
+    private inspectLegacyLockDescriptors;
+    private inspectProfileProcesses;
+    private listOwnedProcessIds;
+    private processStillExists;
+    private parseProcessUidState;
+    private processIsZombie;
+    private readBootId;
+    private readBoundedFile;
+    private readBoundedBuffer;
+    private generationPath;
+    private pathIsWithin;
+    private assertRuntimeEntries;
+    private assertRuntimeDirectoryCurrent;
+    private ensurePrivateDirectory;
+    private validateOptionalPrivateDirectory;
+    private validateOptionalGeneration;
+    private removePrivateDirectory;
+    private readOptionalDirectoryEntries;
+    private syncOptionalDirectory;
+    private syncDirectory;
+}