Skip to main content

Interface: ExtensionStateInfo

Defined in: Extensions/IExtensionHost.ts:29

Snapshot of an extension's state from the host's perspective. Returned by listExtensions() and getExtension().

Properties

crashCountSession

crashCountSession: number

Defined in: Extensions/IExtensionHost.ts:47

Number of crashes counted in the current app session.


devMode?

optional devMode?: boolean

Defined in: Extensions/IExtensionHost.ts:87

True for an extension loaded unpacked in Developer Mode.

A normal install copies the package into data/extensions/<id>/ and the host owns that directory. A dev-mode extension is instead run in place from wherever the developer built it, so installPath points outside the extensions root and the host watches it for rebuilds.

It is a distinct flag rather than an inference from installPath because every consumer that cares — reload, pruning, the UI badge — needs a definite answer, and "is this path under the extensions root?" is a question with an OS-dependent answer.


enabled

enabled: boolean

Defined in: Extensions/IExtensionHost.ts:35

True if the extension is enabled (i.e. allowed to be activated).


folderGrantDate?

optional folderGrantDate?: string

Defined in: Extensions/IExtensionHost.ts:73

ISO 8601 date string when the folder grant was made.


folderGrantPath?

optional folderGrantPath?: string

Defined in: Extensions/IExtensionHost.ts:71

Absolute path of the user-granted managed folder, if any.


grantedPermissions

grantedPermissions: ExtensionPermission[]

Defined in: Extensions/IExtensionHost.ts:39

Permissions the user has granted, post-install.


installedAt

installedAt: number

Defined in: Extensions/IExtensionHost.ts:41

Epoch ms when the extension was installed.


installPath

installPath: string

Defined in: Extensions/IExtensionHost.ts:33

Absolute install path.


lastError?

optional lastError?: string

Defined in: Extensions/IExtensionHost.ts:45

Last load- or runtime-error message, if any.


manifest

manifest: ExtensionManifest

Defined in: Extensions/IExtensionHost.ts:31

Manifest as loaded from disk.


signatureKey?

optional signatureKey?: string

Defined in: Extensions/IExtensionHost.ts:51

Hex-encoded public key when signatureStatus === 'verified'.


signatureStatus?

optional signatureStatus?: SignatureVerificationStatus

Defined in: Extensions/IExtensionHost.ts:49

Ed25519 signature verification status from install time.


sourceCatalogUrl?

optional sourceCatalogUrl?: string

Defined in: Extensions/IExtensionHost.ts:69

Catalog URL this extension was installed from. Absent for a sideload or a Developer-Mode load.

Recorded because it is a historical fact about the install; whether it still counts as the marketplace is decided at read time against the app's current default-catalog setting, which is what makes trustTier above track configuration changes instead of going stale.


status

status: ExtensionStatus

Defined in: Extensions/IExtensionHost.ts:37

Lifecycle stage.


trustTier?

optional trustTier?: ExtensionTrustTier

Defined in: Extensions/IExtensionHost.ts:59

Provenance tier. Derived, never stored — computed from signatureStatus + signatureKey against the app's current trusted-publisher set each time this snapshot is built, so adding or removing a trusted publisher reclassifies existing installs immediately instead of leaving a stale value in the database.


updatedAt

updatedAt: number

Defined in: Extensions/IExtensionHost.ts:43

Epoch ms when the extension was last updated.