taphound 0.2.0-dev.1

package/dist/domain/activity.js

@@ -0,0 +1,65 @@
+const PACKAGE_NAME = /^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)+$/;
+const QUALIFIED_ACTIVITY = /^(?:[A-Za-z_$][\w$]*\.)+[A-Za-z_$][\w$]*$/;
+function assertPackageName(packageName) {
+    if (!PACKAGE_NAME.test(packageName)) {
+        throw new Error(`Invalid package name: ${packageName}`);
+    }
+}
+export function normalizeActivity(packageName, activityOrComponent) {
+    assertPackageName(packageName);
+    const value = activityOrComponent.trim();
+    if (value.includes("/")) {
+        const parts = value.split("/");
+        if (parts.length !== 2) {
+            throw new Error(`Invalid Activity component: ${value}`);
+        }
+        const [componentPackage, componentActivity] = parts;
+        if (componentPackage !== packageName || componentActivity === undefined) {
+            throw new Error(`Activity component package does not match ${packageName}`);
+        }
+        const normalized = componentActivity.startsWith(".")
+            ? `${componentPackage}${componentActivity}`
+            : componentActivity;
+        if (!QUALIFIED_ACTIVITY.test(normalized)) {
+            throw new Error(`Invalid Activity: ${componentActivity}`);
+        }
+        return normalized;
+    }
+    if (value.startsWith(".")) {
+        const normalized = `${packageName}${value}`;
+        if (!QUALIFIED_ACTIVITY.test(normalized)) {
+            throw new Error(`Invalid Activity: ${value}`);
+        }
+        return normalized;
+    }
+    if (!QUALIFIED_ACTIVITY.test(value)) {
+        throw new Error(`Invalid Activity: ${value}`);
+    }
+    return value;
+}
+export function parseObservedActivityComponent(component) {
+    const value = component.trim();
+    const parts = value.split("/");
+    if (parts.length !== 2) {
+        throw new Error(`Invalid Activity component: ${value}`);
+    }
+    const [componentPackage, componentActivity] = parts;
+    if (componentPackage === undefined
+        || componentActivity === undefined
+        || !PACKAGE_NAME.test(componentPackage)) {
+        throw new Error(`Invalid Activity component: ${value}`);
+    }
+    const normalized = componentActivity.startsWith(".")
+        ? `${componentPackage}${componentActivity}`
+        : componentActivity;
+    if (!QUALIFIED_ACTIVITY.test(normalized)) {
+        throw new Error(`Invalid Activity component: ${value}`);
+    }
+    return {
+        packageName: componentPackage,
+        activity: normalized
+    };
+}
+export function normalizeObservedActivityComponent(component) {
+    return parseObservedActivityComponent(component).activity;
+}

package/dist/domain/app-process.d.ts

@@ -0,0 +1,7 @@
+export interface AppProcess {
+    pid: number;
+    name: string;
+}
+export declare function isAppProcessName(name: string, packageName: string): boolean;
+export declare function primaryAppPid(processes: readonly AppProcess[], packageName: string): number | null;
+export declare function appProcessPids(processes: readonly AppProcess[]): readonly number[];

package/dist/domain/app-process.js

@@ -0,0 +1,10 @@
+export function isAppProcessName(name, packageName) {
+    return name === packageName || name.startsWith(`${packageName}:`);
+}
+export function primaryAppPid(processes, packageName) {
+    const exact = processes.find((process) => process.name === packageName);
+    return exact?.pid ?? processes[0]?.pid ?? null;
+}
+export function appProcessPids(processes) {
+    return processes.map((process) => process.pid);
+}

package/dist/domain/config.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+export declare const TapHoundConfigSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    run: z.ZodObject<{
+        packageName: z.ZodString;
+        activity: z.ZodString;
+    }, z.core.$strict>;
+    idle: z.ZodObject<{
+        pollIntervalMs: z.ZodNumber;
+        stablePolls: z.ZodNumber;
+        timeoutMs: z.ZodNumber;
+    }, z.core.$strict>;
+    artifactsDir: z.ZodString;
+}, z.core.$strict>;
+export type TapHoundConfig = z.infer<typeof TapHoundConfigSchema>;

package/dist/domain/config.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+const PackageNameSchema = z.string().regex(/^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)+$/, "packageName must be a qualified Java package");
+const ActivityNameSchema = z.string().refine((value) => (/^\.[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*$/.test(value)
+    || /^(?:[A-Za-z_$][\w$]*\.)+[A-Za-z_$][\w$]*$/.test(value)), "activity must be relative with a leading dot or fully qualified");
+export const TapHoundConfigSchema = z.strictObject({
+    version: z.literal(1),
+    run: z.strictObject({
+        packageName: PackageNameSchema,
+        activity: ActivityNameSchema
+    }),
+    idle: z.strictObject({
+        pollIntervalMs: z.number().int().positive(),
+        stablePolls: z.number().int().positive(),
+        timeoutMs: z.number().int().positive()
+    }),
+    artifactsDir: z.string().trim().min(1)
+});

package/dist/domain/failure.d.ts

@@ -0,0 +1,4 @@
+export declare const FAILURE_CODES: readonly ["CONFIG_INVALID", "ENVIRONMENT_MISSING_TOOL", "DEVICE_UNAVAILABLE", "APP_NOT_INSTALLED", "APP_LAUNCH_FAILED", "APP_CRASHED", "LOCATOR_NOT_FOUND", "LOCATOR_AMBIGUOUS", "SCROLL_TARGET_NOT_FOUND", "ACTION_FAILED", "IDLE_TIMEOUT", "ACTIVITY_BEFORE_MISMATCH", "ACTIVITY_AFTER_MISMATCH", "EXPECT_ACTIVITY_FAILED", "EXPECT_ELEMENT_FAILED", "EXPECT_LOGCAT_FAILED", "COLLECTION_FAILED", "INTERNAL_ERROR"];
+export type FailureCode = (typeof FAILURE_CODES)[number];
+export type TapHoundExitCode = 1 | 2 | 3 | 4;
+export declare function exitCodeForFailure(failure: FailureCode): TapHoundExitCode;

package/dist/domain/failure.js

@@ -0,0 +1,43 @@
+export const FAILURE_CODES = [
+    "CONFIG_INVALID",
+    "ENVIRONMENT_MISSING_TOOL",
+    "DEVICE_UNAVAILABLE",
+    "APP_NOT_INSTALLED",
+    "APP_LAUNCH_FAILED",
+    "APP_CRASHED",
+    "LOCATOR_NOT_FOUND",
+    "LOCATOR_AMBIGUOUS",
+    "SCROLL_TARGET_NOT_FOUND",
+    "ACTION_FAILED",
+    "IDLE_TIMEOUT",
+    "ACTIVITY_BEFORE_MISMATCH",
+    "ACTIVITY_AFTER_MISMATCH",
+    "EXPECT_ACTIVITY_FAILED",
+    "EXPECT_ELEMENT_FAILED",
+    "EXPECT_LOGCAT_FAILED",
+    "COLLECTION_FAILED",
+    "INTERNAL_ERROR"
+];
+const EXIT_CODES = {
+    CONFIG_INVALID: 2,
+    ENVIRONMENT_MISSING_TOOL: 3,
+    DEVICE_UNAVAILABLE: 3,
+    APP_NOT_INSTALLED: 3,
+    APP_LAUNCH_FAILED: 1,
+    APP_CRASHED: 1,
+    LOCATOR_NOT_FOUND: 1,
+    LOCATOR_AMBIGUOUS: 1,
+    SCROLL_TARGET_NOT_FOUND: 1,
+    ACTION_FAILED: 1,
+    IDLE_TIMEOUT: 1,
+    ACTIVITY_BEFORE_MISMATCH: 1,
+    ACTIVITY_AFTER_MISMATCH: 1,
+    EXPECT_ACTIVITY_FAILED: 1,
+    EXPECT_ELEMENT_FAILED: 1,
+    EXPECT_LOGCAT_FAILED: 1,
+    COLLECTION_FAILED: 1,
+    INTERNAL_ERROR: 4
+};
+export function exitCodeForFailure(failure) {
+    return EXIT_CODES[failure];
+}