@livx.cc/appwrap 0.43.0 → 0.46.1

package/src/config.ts

@@ -89,6 +89,42 @@ export interface AppwrapConfig {
      * the app dir, so `build desktop` apps must keep their repo (+ node_modules) around at runtime —
      * embedding the handler file into the `.app` is out of scope for phase-0. macOS-only. */
     handlers?: string;
+    /** Local-server mode: boot a command that serves the app locally, then load it LIVE in the window
+     * (instead of the bundled `pwaDist`). The shell shows a bundled splash, spawns `command` (+`args`)
+     * in a background thread, polls `http://localhost:<port><healthPath>` until it answers, then
+     * navigates the window there; on window-close it kills the child so the stack never outlives the
+     * shell. Use for a desktop app that IS a local dev/server stack (e.g. `para-chat`). Absent → the
+     * desktop lane loads the bundled `pwaDist` as usual. The CLI resolves `command` (when a bare name)
+     * and `cwd` to absolute paths at stamp time (a GUI-launched .app inherits the minimal launchd PATH,
+     * so a bare `bun`/PATH lookup would fail). `build desktop` apps must keep the server (+ its repo)
+     * present at runtime — bundling the server INTO the .app is a future phase. macOS-only. */
+    server?: {
+      /** Command to spawn (argv[0]). A bare name is PATH-resolved at stamp time; an absolute path is used as-is. */
+      command: string;
+      /** Extra arguments passed to the command. */
+      args?: string[];
+      /** Working directory to spawn in (default: the app project root). */
+      cwd?: string;
+      /** How the shell learns the URL to load. Provide EXACTLY ONE:
+       *  - `urlMarker` (preferred for servers that print their address, e.g. vite/para-chat): the shell
+       *    pipes the server's stdout and, on the first line CONTAINING this marker, extracts the first
+       *    `http(s)://…` token and loads it. This tracks whatever port the server auto-picked — no
+       *    hardcoded port, no mismatch. e.g. `"Frontend:"` matches `Frontend:  https://localhost:5050`.
+       *  - `port` (+ optional `https`) for a silent server on a KNOWN fixed port: the shell TCP-polls
+       *    `localhost:<port>` and loads `<http|https>://localhost:<port>`. */
+      urlMarker?: string;
+      /** Fixed port the server listens on (used only when `urlMarker` is absent). */
+      port?: number;
+      /** Load over https in fixed-`port` mode (default false = http). Ignored in `urlMarker` mode (the
+       * captured URL carries its own scheme). The server's TLS cert CA must be trusted by the system
+       * keychain and its SANs cover `localhost`/`127.0.0.1`, or the WebView shows a cert error. */
+      https?: boolean;
+      /** Health path polled for readiness (default `/`). Ready = any HTTP response (even 4xx/5xx). */
+      healthPath?: string;
+      /** Max ms to wait for the port before showing an error in the splash (default 120000 — a first-run
+       * production build can be slow). */
+      readyTimeoutMs?: number;
+    };
   };
   /** Custom URL scheme for deep links (e.g. "hellowrap" → hellowrap://...). */
   urlScheme?: string;

package/src/desktop.ts

@@ -44,6 +44,31 @@ export interface DesktopShellConfig {
    * ~/.bun/bin, so a bare `bun` spawn fails. The Rust shell falls back to `bun` when this is
    * missing/nonexistent. */
   handlersRuntime: string;
+  /** True when `modules` includes 'media' → the .app carries an NSMicrophoneUsageDescription so
+   * `getUserMedia` (voice mode) can pass macOS TCC. The WebKit-layer grant (popup_mac) is
+   * unconditional; this only adds the OS usage string an app that actually uses the mic needs. */
+  microphone: boolean;
+  /** Local-server mode. When present the Rust shell boots `command` (+`args`) in a background thread,
+   * polls `http://localhost:<port><healthPath>` until it answers, then navigates the window there
+   * (instead of the bundled dist); it kills the child on window-close. Absent → bundled-PWA load.
+   * `command`/`cwd` are resolved to ABSOLUTE by the CLI (see `regenerateDesktop`) because a
+   * GUI-launched .app has the minimal launchd PATH (no ~/.bun/bin). Empty when the app isn't a
+   * local-server app. */
+  server?: {
+    command: string;
+    args: string[];
+    cwd: string;
+    /** Stdout marker → capture the URL the server prints (dynamic port). '' when using fixed `port`. */
+    urlMarker: string;
+    /** Fixed port (used only when `urlMarker` is ''). 0 when unused. */
+    port: number;
+    https: boolean;
+    healthPath: string;
+    readyTimeoutMs: number;
+    /** PATH the child is spawned with — the CLI stamps its own (build-time) PATH so a GUI launch can
+     * still resolve neighbouring tools (bun, node) the launchd PATH omits. */
+    path: string;
+  };
 }
 
 /** Resolve the desktop shell config from an appwrap config: identity + `urlScheme` come from the
@@ -65,6 +90,21 @@ export function deriveDesktopConfig(cfg: AppwrapConfig): DesktopShellConfig {
     handlers: d.handlers ?? '',
     pushSigned: false, // stamped by the CLI when a signing identity + macOS profile resolve — see buildDesktop
     handlersRuntime: '', // stamped by the CLI (process.execPath) when handlers is set — see regenerateDesktop
+    microphone: (cfg.modules ?? []).includes('media'),
+    // `command`/`cwd`/`path` are resolved to absolute by the CLI (regenerateDesktop); carried as authored here.
+    server: d.server
+      ? {
+          command: d.server.command,
+          args: d.server.args ?? [],
+          cwd: d.server.cwd ?? '',
+          urlMarker: d.server.urlMarker ?? '',
+          port: d.server.port ?? 0,
+          https: d.server.https ?? false,
+          healthPath: d.server.healthPath ?? '/',
+          readyTimeoutMs: d.server.readyTimeoutMs ?? 120_000,
+          path: '',
+        }
+      : undefined,
   };
 }
 
@@ -134,6 +174,13 @@ export function buildInfoPlist(
 	<key>CFBundleIconName</key>
 	<string>${xmlEscape(iconName)}</string>`
     : '';
+  // NSMicrophoneUsageDescription: required for getUserMedia (voice mode) to pass macOS TCC — without
+  // it the OS silently denies mic access (no prompt). Added only when the app declares the `media` module.
+  const mic = shell.microphone
+    ? `
+	<key>NSMicrophoneUsageDescription</key>
+	<string>${xmlEscape(shell.name)} uses the microphone for voice input.</string>`
+    : '';
   return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -153,7 +200,7 @@ export function buildInfoPlist(
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>NSHighResolutionCapable</key>
-	<true/>${icon}${iconAsset}${urlTypes}
+	<true/>${icon}${iconAsset}${mic}${urlTypes}
 </dict>
 </plist>
 `;