@bobfrankston/msgapidefs 0.1.40 → 0.1.41

package/.commitmsg

@@ -0,0 +1 @@
+diag.requestHome() and MsgInstallInfo.isHomeApp (msga 1.5.52): make msga the device's Home app via Android's own confirmation dialog so relaunch after self-update / WebView update / crash is automatic; README Diagnostics documents getInstallInfo/requestHome/requestOverlay and the per-start "Relaunched <gap>" log line.

package/README.md

@@ -216,7 +216,21 @@ for (const e of exits) {
 
 Interpreting common reasons: `LowMemory` = killed by the low-memory killer; `Anr` = main thread hung; `Crash`/`CrashNative` = unhandled exception / native crash; `Freezer` = app was frozen (Android 12+ cached-app freezing — UDP listeners silently suspended, app not actually dead); `UserRequested` = swiped away from recents; `PackageUpdated` = replaced by an APK update; `Signaled` = killed by signal (check `description`).
 
-msga also logs new exit records via MsgALog at startup when `LOGGING=true` in msga.env (`Previous exit: ...`), deduplicated across runs via a `lastSeenExitTimestamp` preference. See [msga/exit-diagnostics.md](../msga/exit-diagnostics.md) for the full design notes.
+msga also logs new exit records via MsgALog at startup when `LOGGING=true` in msga.env (`Previous exit: ...`), deduplicated across runs via a `lastSeenExitTimestamp` preference, plus one `Relaunched <gap> after previous exit: ...` line per start (held until logging is turned on). See [msga/exit-diagnostics.md](../msga/exit-diagnostics.md) for the full design notes.
+
+**Staying alive / coming back** (msga Android; other hosts resolve `'n/a'`):
+
+- `diag.getInstallInfo()` - Returns `MsgInstallInfo`: `installer` / `selfInstalled` (whether the next update can be silent), `canDrawOverlays`, `canInstallPackages`, `isHomeApp` (1.5.52+), `sdkInt`.
+- `diag.requestHome()` - Make msga the device's **Home app**. Android relaunches the Home app after *any* process death — self-update, System WebView update, crash, low-memory kill — with no other permission. On Android 10+ this shows the system's own one-button "Set as default Home app?" confirmation and resolves `'granted'` / `'denied'`; older Android opens the Home-settings list (`'opened'`). `'already'` if it is Home already. Recommended one-time step for a wall panel; a web app can offer it whenever `isHomeApp` is false. (msga 1.5.52+)
+- `diag.requestOverlay()` - Opens the "Display over other apps" settings page (`'already'` / `'opened'`). The older alternative: with the grant, the post-self-update relaunch is allowed to reach the foreground, but it does nothing for a WebView-update kill. Prefer `requestHome()`.
+
+```javascript
+// Panel setup: one tap, Android's own dialog
+const info = await window.msgapi?.diag?.getInstallInfo?.();
+if (info && info.isHomeApp === false) {
+    const r = await window.msgapi.diag.requestHome();   // 'granted' | 'denied' | 'opened' | ...
+}
+```
 
 ### Window Control
 

package/msgapidefs.ts

@@ -101,6 +101,7 @@ export interface MsgInstallInfo {
     selfInstalled: boolean;     // true => next update can be silent
     canDrawOverlays: boolean;   // true => post-update relaunch is allowed to foreground
     canInstallPackages: boolean;// "Install unknown apps" for this app
+    isHomeApp?: boolean;        // true => msga is the device's Home app: Android relaunches it after ANY process death (msga 1.5.52+)
     sdkInt: number;
 }
 
@@ -134,6 +135,7 @@ export interface MsgAPI {
         getExitReasons(max?: number): Promise<MsgExitInfo[]>;  // Previous-run exit records, newest first (default max 5). msga Android 11+ only; [] elsewhere.
         getInstallInfo?(): Promise<MsgInstallInfo>;   // Installer of record + permission state (msga 1.5.48+)
         requestOverlay?(): Promise<'already' | 'opened' | 'n/a'>;  // Open the Display-over-other-apps settings page
+        requestHome?(): Promise<'already' | 'granted' | 'denied' | 'opened' | 'n/a'>;  // Make msga the Home app: system one-button confirmation (Android 10+), settings list before. Home app = automatic relaunch after self-update / WebView update / crash. msga 1.5.52+
     };
 
     // ── Window Control ──────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/msgapidefs",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "description": "TypeScript definitions for msgapi JavaScript API (msgview/msger)",
   "type": "module",
   "main": "./msgapidefs.js",

package/tsconfig.json

@@ -2,7 +2,7 @@
     "compilerOptions": {
         "types": ["node"],
         "target": "ES2020",
-        "module": "ES2020",
+        "module": "NodeNext",
         "lib": ["ES2020", "DOM"],
         "declaration": true,
         "outDir": ".",
@@ -11,7 +11,7 @@
         "esModuleInterop": true,
         "skipLibCheck": true,
         "forceConsistentCasingInFileNames": true,
-        "moduleResolution": "node",
+        "moduleResolution": "NodeNext",
         "newLine": "lf"
     },
     "include": ["msgapidefs.ts"],