@nyssance/tauri-hasgard 0.2.1 → 0.4.1

package/README.md

@@ -29,6 +29,50 @@ export const { test, expect } = createHasgardTest({
 
 The fixture passes the selected socket to the application as `TAURI_HASGARD_SOCKET`, so each Playwright worker receives an isolated connection.
 
+On macOS, a managed launch owns a detached process group. Teardown
+waits for that group to exit, including children left behind by a launcher,
+and escalates from SIGTERM to SIGKILL after five seconds. Startup failures also
+clean up, and concurrent `stop()` calls share the same cleanup. A live endpoint
+is rejected rather than unlinked; readiness requires a successful connection.
+If cleanup fails, ownership is retained so `stop()` can be retried; another
+launch is blocked until that cleanup succeeds.
+Diagnostics retain the last 64 Ki characters per output stream with a truncation
+marker. `await process.diagnostics()` exposes those tails and the actual exit
+code or signal. Failed tests attach them; a failed screenshot does not replace
+the original test error. Teardown removes the owned stale socket after its
+process group exits, checking its identity and preserving live or replaced paths.
+
+An independent supervisor owns the application and watches the worker's IPC
+connection. If the worker is killed with SIGKILL, the supervisor still terminates
+the application group and exits. Killing the supervisor itself or children that
+deliberately create a new session or process group are outside this guarantee.
+Attach-only fixtures do not terminate an application they did not launch.
+
+`window.press(key)` uses native OS input and, by default, waits for a trusted
+WebView keyup before the next press may switch windows. For OS shortcuts and
+keys that navigate or close the document, explicitly use
+`window.press(key, { completion: "native" })`; that mode confirms posting only.
+Bare modifiers also use native posting completion. The active input method
+remains in effect: use `fill` for exact text, and `Shift+m` for a shifted key.
+
+To keep keyboard ownership until an application state is observable:
+
+```ts
+await window.press("Tab", {
+  waitFor: "document.activeElement.id === 'save'",
+  timeoutMs: 1_000
+})
+```
+
+The postcondition timeout is capped at ten seconds. Failures retain their
+`HasgardRpcError.data.phase` and `injected` status; never blindly retry an
+already-injected or uncertain press. See [the wire contract](../../docs/protocol.md#native-keyboard-completion).
+
+Requests are limited to 1,048,576 UTF-8 bytes including the trailing newline,
+matching the plugin. Oversized requests fail before transmission. An explicit
+null result is supported; malformed responses are rejected instead of returning
+an invented value.
+
 ## Test
 
 ```ts

package/dist/chunk-N7YDYAKI.js

@@ -0,0 +1,31 @@
+// src/process-group.js
+import { setTimeout as delay } from "timers/promises";
+function signalGroup(pid, signal) {
+  try {
+    process.kill(-pid, signal);
+    return true;
+  } catch (error) {
+    if (error.code === "ESRCH") return false;
+    if (signal === 0 && error.code === "EPERM") return true;
+    throw error;
+  }
+}
+async function waitForExit(pid, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  while (signalGroup(pid, 0)) {
+    if (Date.now() >= deadline) return false;
+    await delay(25);
+  }
+  return true;
+}
+async function stopProcessGroup(pid) {
+  signalGroup(pid, "SIGTERM");
+  if (!await waitForExit(pid, 5e3)) {
+    signalGroup(pid, "SIGKILL");
+    if (!await waitForExit(pid, 5e3)) throw new Error(`Hasgard process group ${pid} survived SIGKILL`);
+  }
+}
+
+export {
+  stopProcessGroup
+};

package/dist/index.d.ts

@@ -3,5 +3,5 @@ export { createHasgardExpect } from "./expect.js";
 export { createHasgardTest } from "./fixture.js";
 export { HasgardProcess } from "./process-manager.js";
 export { HasgardRpcClient, HasgardRpcError } from "./rpc-client.js";
-export type { BoundingBox, ConsoleLogEntry, ConsoleLogOptions, DialogListing, DialogPolicy, DialogRecord, DialogType, DiffChange, DiffOptions, DragOffset, DropFile, FileInput, FilterOptions, FormEntry, FormField, FormsDump, HasgardFixtures, HasgardLaunchConfig, HasgardTarget, HasgardTestConfig, HasgardWorkerFixtures, JsonPrimitive, JsonValue, NativeScreenshot, NativeScreenshotOptions, NetworkRequestEntry, NetworkRequestOptions, QueryDimension, RecorderEntry, RecorderResult, RecorderStatus, RoleQuery, ScrollOptions, Snapshot, SnapshotDiff, SnapshotElement, SnapshotOptions, StorageEntry, StorageListing, StorageOptions, TextQuery, WaitForFunctionOptions, WaitOptions, WatchChanges, WatchNode, WatchOptions, WindowInfo, WindowState } from "./types.js";
-export { byPoint, byRef, bySelector, HasgardApplication, HasgardLocator, HasgardWindow } from "./window.js";
+export type { BoundingBox, ClickOptions, ConsoleLogEntry, ConsoleLogOptions, DialogListing, DialogPolicy, DialogRecord, DialogType, DiffChange, DiffOptions, DragOffset, DropFile, ElementPosition, FileInput, FilterOptions, FormEntry, FormField, FormsDump, FulfillOptions, HasgardFixtures, HasgardLaunchConfig, HasgardTarget, HasgardTestConfig, HasgardWorkerFixtures, InterceptedRequest, JsonPrimitive, JsonValue, KeyModifier, MouseButton, NativeScreenshot, NativeScreenshotOptions, NetworkRequestEntry, NetworkRequestOptions, PressOptions, QueryDimension, RecorderEntry, RecorderResult, RecorderStatus, RoleQuery, RouteListing, RouteOptions, RouteRule, ScrollOptions, Snapshot, SnapshotDiff, SnapshotElement, SnapshotOptions, StorageEntry, StorageListing, StorageOptions, TextQuery, WaitForFunctionOptions, WaitOptions, WatchChanges, WatchNode, WatchOptions, WindowInfo, WindowState } from "./types.js";
+export { byPoint, byRef, bySelector, HasgardApplication, HasgardFrameLocator, HasgardLocator, HasgardWindow } from "./window.js";