@astur-mobile/core 0.5.0-beta.3 → 0.5.0-beta.5

package/dist/flutter/network.d.ts

@@ -0,0 +1,34 @@
+import type { NetworkCapabilities, NetworkRedactionOptions, NetworkRequestFilter, NetworkRequestRecord } from '@astur-mobile/protocol';
+/**
+ * Network observation for Flutter Android, backed by the Dart VM service's
+ * `dart:io` HTTP profiler — the same source Flutter DevTools' Network view uses.
+ *
+ * Coverage is exactly `dart:io`'s HttpClient: that includes `package:http` and
+ * Dio's IO path, because both are built on it. It does NOT include a WebView's
+ * own requests, native SDKs, platform channels, or any client that opens its
+ * own sockets. Callers should read {@link capabilities} rather than assume.
+ *
+ * Read-only by design. Interception needs an in-app adapter that can hold a
+ * request open, which the profiler cannot do — it reports what already
+ * happened.
+ */
+export declare const DEFAULT_REDACTED_HEADERS: string[];
+/** 64 KiB. Enough for a JSON payload, small enough that a long run cannot blow up. */
+export declare const DEFAULT_MAX_BODY_BYTES: number;
+export declare const FLUTTER_NETWORK_CAPABILITIES: NetworkCapabilities;
+/** Case-insensitive header redaction, applied before a record is ever returned. */
+export declare function redactHeaders(headers: Record<string, unknown> | undefined, redact: string[]): Record<string, string>;
+/** Keeps a body only when it is within budget, and says why when it is not. */
+export declare function applyBodyLimit(body: string | undefined, maxBytes: number): Pick<NetworkRequestRecord, 'responseBody' | 'bodyOmittedReason'>;
+/**
+ * Maps the VM profiler's payload onto {@link NetworkRequestRecord}.
+ *
+ * Every field is read defensively: the Dart SDK owns this shape and has moved
+ * fields between versions, so a missing key must degrade one record rather than
+ * throw and lose the whole batch.
+ */
+export declare function toNetworkRecords(profile: unknown, options: Required<NetworkRedactionOptions>): NetworkRequestRecord[];
+/** Applies a {@link NetworkRequestFilter} to already-collected records. */
+export declare function filterRecords(records: NetworkRequestRecord[], filter: NetworkRequestFilter | undefined): NetworkRequestRecord[];
+export declare function resolveRedactionOptions(options: NetworkRedactionOptions | undefined): Required<NetworkRedactionOptions>;
+//# sourceMappingURL=network.d.ts.map

package/dist/flutter/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/flutter/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,wBAAwB,UAAyD,CAAC;AAE/F,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,QAAY,CAAC;AAEhD,eAAO,MAAM,4BAA4B,EAAE,mBAO1C,CAAC;AAEF,mFAAmF;AACnF,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC5C,MAAM,EAAE,MAAM,EAAE,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,EAAE,MAAM,GACf,IAAI,CAAC,oBAAoB,EAAE,cAAc,GAAG,mBAAmB,CAAC,CAQlE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GACzC,oBAAoB,EAAE,CA4CxB;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,EAAE,EAC/B,MAAM,EAAE,oBAAoB,GAAG,SAAS,GACvC,oBAAoB,EAAE,CAmBxB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,uBAAuB,GAAG,SAAS,GAC3C,QAAQ,CAAC,uBAAuB,CAAC,CAKnC"}

package/dist/flutter/network.js

@@ -0,0 +1,121 @@
+/**
+ * Network observation for Flutter Android, backed by the Dart VM service's
+ * `dart:io` HTTP profiler — the same source Flutter DevTools' Network view uses.
+ *
+ * Coverage is exactly `dart:io`'s HttpClient: that includes `package:http` and
+ * Dio's IO path, because both are built on it. It does NOT include a WebView's
+ * own requests, native SDKs, platform channels, or any client that opens its
+ * own sockets. Callers should read {@link capabilities} rather than assume.
+ *
+ * Read-only by design. Interception needs an in-app adapter that can hold a
+ * request open, which the profiler cannot do — it reports what already
+ * happened.
+ */
+export const DEFAULT_REDACTED_HEADERS = ['authorization', 'cookie', 'set-cookie', 'x-api-key'];
+/** 64 KiB. Enough for a JSON payload, small enough that a long run cannot blow up. */
+export const DEFAULT_MAX_BODY_BYTES = 64 * 1024;
+export const FLUTTER_NETWORK_CAPABILITIES = {
+    observe: true,
+    intercept: false,
+    transports: ['http'],
+    responseBodies: true,
+    coverage: "dart:io HttpClient traffic (package:http and Dio included); excludes WebView, native SDK, and platform-channel requests",
+    adapterRequired: true
+};
+/** Case-insensitive header redaction, applied before a record is ever returned. */
+export function redactHeaders(headers, redact) {
+    const lowered = new Set(redact.map((name) => name.toLowerCase()));
+    const out = {};
+    for (const [key, value] of Object.entries(headers ?? {})) {
+        out[key] = lowered.has(key.toLowerCase())
+            ? '<redacted>'
+            : Array.isArray(value) ? value.join(', ') : String(value);
+    }
+    return out;
+}
+/** Keeps a body only when it is within budget, and says why when it is not. */
+export function applyBodyLimit(body, maxBytes) {
+    if (body === undefined) {
+        return { bodyOmittedReason: 'not-captured' };
+    }
+    if (Buffer.byteLength(body, 'utf8') > maxBytes) {
+        return { bodyOmittedReason: 'too-large' };
+    }
+    return { responseBody: body };
+}
+/**
+ * Maps the VM profiler's payload onto {@link NetworkRequestRecord}.
+ *
+ * Every field is read defensively: the Dart SDK owns this shape and has moved
+ * fields between versions, so a missing key must degrade one record rather than
+ * throw and lose the whole batch.
+ */
+export function toNetworkRecords(profile, options) {
+    const requests = profile?.requests;
+    if (!Array.isArray(requests)) {
+        return [];
+    }
+    return requests.flatMap((entry) => {
+        // Guard the entry itself, not just its fields: a null/non-object row would
+        // otherwise throw and take every other record in the batch with it.
+        if (typeof entry !== 'object' || entry === null) {
+            return [];
+        }
+        const row = entry;
+        const id = row.id === undefined ? undefined : String(row.id);
+        const uri = typeof row.uri === 'string' ? row.uri : undefined;
+        if (!id || !uri) {
+            return [];
+        }
+        const request = (row.request ?? {});
+        const response = (row.response ?? {});
+        const startedMicros = Number(row.startTime ?? 0);
+        const endMicros = Number(row.endTime ?? 0);
+        const errorText = typeof request.error === 'string'
+            ? request.error
+            : typeof row.error === 'string' ? row.error : undefined;
+        return [{
+                id,
+                transport: 'http',
+                method: typeof row.method === 'string' ? row.method.toUpperCase() : 'GET',
+                url: uri,
+                requestHeaders: redactHeaders(request.headers, options.redactHeaders),
+                ...(response.headers
+                    ? { responseHeaders: redactHeaders(response.headers, options.redactHeaders) }
+                    : {}),
+                ...(response.statusCode === undefined ? {} : { status: Number(response.statusCode) }),
+                // The VM reports microseconds since epoch; the public contract is ms.
+                startedAt: Math.round(startedMicros / 1000),
+                ...(endMicros > startedMicros ? { durationMs: Math.round((endMicros - startedMicros) / 1000) } : {}),
+                ...(errorText ? { error: errorText } : {})
+            }];
+    });
+}
+/** Applies a {@link NetworkRequestFilter} to already-collected records. */
+export function filterRecords(records, filter) {
+    if (!filter) {
+        return records;
+    }
+    return records.filter((record) => {
+        if (filter.method && record.method.toUpperCase() !== filter.method.toUpperCase()) {
+            return false;
+        }
+        if (filter.transport && record.transport !== filter.transport) {
+            return false;
+        }
+        if (filter.url instanceof RegExp) {
+            return filter.url.test(record.url);
+        }
+        if (typeof filter.url === 'string') {
+            return record.url.includes(filter.url);
+        }
+        return true;
+    });
+}
+export function resolveRedactionOptions(options) {
+    return {
+        redactHeaders: options?.redactHeaders ?? DEFAULT_REDACTED_HEADERS,
+        maxBodyBytes: options?.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES
+    };
+}
+//# sourceMappingURL=network.js.map

package/dist/flutter/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/flutter/network.ts"],"names":[],"mappings":"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"}

package/dist/flutter/vmService.d.ts

@@ -0,0 +1,170 @@
+import type { MobileElementSnapshot } from '@astur-mobile/protocol';
+interface RpcResult {
+    [key: string]: unknown;
+}
+export interface FlutterVmServiceOptions {
+    /** WebSocket URL of the Dart VM service, e.g. ws://127.0.0.1:PORT/TOKEN/ws */
+    url: string;
+    requestTimeoutMs?: number;
+    /** How long to wait for the first completed frame before serving trees. */
+    readyTimeoutMs?: number;
+    /** Poll interval while waiting for the first completed frame. */
+    readyPollMs?: number;
+    /** How long the laid-out element set must stay unchanged before the UI is considered settled. */
+    readySettleMs?: number;
+    /**
+     * Total wall-clock budget for retrying an on-device tree walk that lands
+     * mid-build (transient build-lock errors).
+     *
+     * This is deliberately a time budget rather than an attempt count. Each
+     * attempt can itself block for up to `requestTimeoutMs`, so `N retries`
+     * bounds the worst case at `N * requestTimeoutMs` — with a handful of
+     * retries that is already minutes, which silently blows past the caller's
+     * own timeout (see `evaluateStringStable`).
+     *
+     * Defaults to `requestTimeoutMs + 10s`. Setting it below `requestTimeoutMs`
+     * caps the first attempt at less than a full request, turning a slow-but-fine
+     * tree walk into a timeout.
+     */
+    evalBudgetMs?: number;
+    /** Delay between tree-walk retries. */
+    evalRetryDelayMs?: number;
+}
+export declare class FlutterVmService {
+    private ws?;
+    private nextId;
+    private readonly pending;
+    private isolateId?;
+    private rootLibId?;
+    private screen;
+    private readonly url;
+    private readonly timeoutMs;
+    private readonly readyTimeoutMs;
+    private readonly readyPollMs;
+    private readonly readySettleMs;
+    private readonly evalBudgetMs;
+    private readonly evalRetryDelayMs;
+    constructor(options: FlutterVmServiceOptions);
+    private openSocket;
+    /**
+     * Attaches for network observation only.
+     *
+     * Deliberately not {@link connect}: that one binds an isolate by evaluating a
+     * Dart expression, which needs the expression compiler that `flutter run`
+     * attaches. An app launched any other way — `simctl launch` on the iOS
+     * simulator, for instance — has a perfectly good VM service with a working
+     * HTTP profiler but no compiler, so requiring evaluation rejects a session
+     * that can observe traffic fine.
+     *
+     * Binds on the capability actually needed instead: an isolate that registered
+     * the `dart:io` profiler extensions.
+     */
+    connectForNetwork(): Promise<boolean>;
+    connect(): Promise<void>;
+    /**
+     * Re-binds to the isolate created by a hot restart. `flutter run`'s `R` tears
+     * down the running isolate and starts a *new* one. The old isolate lingers in
+     * `getVM` for a moment — and is still readable but FROZEN at its last frame —
+     * so binding to it makes tree reads return stale UI (taps reach the live app
+     * but the tree never reflects them) or, once it dies, an empty tree. Excluding
+     * the pre-restart id is what makes resets land on the live isolate.
+     */
+    reattach(): Promise<boolean>;
+    /**
+     * Re-checks readiness on the already-bound isolate without re-resolving it.
+     * Used by the reset path to re-wait after re-foregrounding a surfaceless engine
+     * (a hot restart can come back with a 0x0 view), so callers can retry cheaply
+     * instead of paying the isolate-resolution grace window again.
+     */
+    ensureReady(): Promise<boolean>;
+    /**
+     * Binds {@link isolateId}/{@link rootLibId} to a live, evaluable isolate.
+     *
+     * When `previousIsolateId` is given (a hot-restart reattach), an isolate with a
+     * *different* id is strongly preferred — that's the replacement; the old one is
+     * the frozen/dying predecessor. We only fall back to the same id after a short
+     * grace window (covers the rare case where a restart reuses the id) so we don't
+     * grab the predecessor before its replacement has registered. Each candidate is
+     * validated with a trivial eval, since a dying isolate can still be listed yet
+     * reject evaluations.
+     */
+    private resolveIsolate;
+    getTree(): Promise<MobileElementSnapshot>;
+    /**
+     * Runs the on-device tree walk and rebuilds the flat, parent-annotated output
+     * into a nested snapshot tree. Nesting matters because page logic reads a
+     * container's subtree (e.g. the counters under a tap-lab card) — a flat list
+     * would leave every container childless. Rows are emitted in pre-order, so a
+     * parent always precedes its children and the map is fully populated by the
+     * time we wire up links.
+     */
+    private extractChildren;
+    /** Dismisses the soft keyboard by clearing the Flutter primary focus. */
+    unfocus(): Promise<void>;
+    dispose(): Promise<void>;
+    private parseRow;
+    /**
+     * Blocks until the app's UI has settled, so the first read returns fully
+     * laid-out bounds rather than zeros.
+     *
+     * Two phases:
+     *  1. Wait for a completed frame (scheduler idle) with a non-zero screen size —
+     *     captures the real physical size, which is 0x0 until the view lays out.
+     *  2. Wait for the laid-out element set to stop changing across consecutive
+     *     polls. This is necessary because parts of the tree (e.g. a bottom
+     *     navigation bar) can lay out a frame or two after the first frame, so they
+     *     report zero bounds immediately after step 1 — tapping such a node would
+     *     hit the wrong coordinates. The fingerprint keys on which nodes are present
+     *     and laid out, not their exact bounds, so a continuously-animating app
+     *     still settles instead of polling until the timeout.
+     */
+    private waitForReady;
+    /** Identity of the laid-out, labelled nodes — present-and-sized, ignoring exact position so animations still settle. Walks the (now nested) tree. */
+    private layoutFingerprint;
+    /**
+     * Evaluates the on-device tree walk, retrying transient build-lock failures.
+     *
+     * The walk uses `visitChildren`, which throws if it runs while Flutter is mid-build
+     * (app startup, route transitions, animations). Those settle within a frame or two,
+     * so a short bounded retry makes reads reliable without callers having to sleep.
+     */
+    private evaluateStringStable;
+    private sleep;
+    /**
+     * Evaluates a Dart expression and returns its full String result (handles VM
+     * string truncation). `deadline` caps every RPC this makes, so paging a large
+     * tree cannot outlive the caller's retry budget.
+     */
+    private evaluateString;
+    /**
+     * Turns on the Dart VM's HTTP profiler for this isolate.
+     *
+     * Off by default: with it on the VM retains every request (and its body) for
+     * the life of the isolate, so it is enabled only when a test asks to observe,
+     * and the buffer is cleared between tests.
+     */
+    enableHttpProfiling(): Promise<void>;
+    /** Drops everything the profiler has buffered so far. */
+    clearHttpProfile(): Promise<void>;
+    /**
+     * Returns the profiler's buffered requests, newest state included.
+     *
+     * The response shape is owned by the Dart SDK and has changed between
+     * versions, so callers must treat every field as optional rather than
+     * trusting a schema — see `toNetworkRecords` in the Android driver.
+     */
+    getHttpProfile(): Promise<RpcResult>;
+    /** Full detail (including the response body) for one profiled request. */
+    getHttpProfileRequest(id: string): Promise<RpcResult>;
+    /**
+     * Whether this isolate actually registered the dart:io HTTP profiler
+     * extensions. They are absent in some builds, so capability is detected at
+     * runtime rather than assumed from the platform.
+     */
+    supportsHttpProfiling(): Promise<boolean>;
+    private call;
+    private onMessage;
+    private failAllPending;
+}
+export {};
+//# sourceMappingURL=vmService.d.ts.map

package/dist/flutter/vmService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vmService.d.ts","sourceRoot":"","sources":["../../src/flutter/vmService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAyG5E,UAAU,SAAS;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AASD,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iGAAiG;IACjG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAAC,CAAY;IACvB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6G;IACrI,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,OAAO,EAAE,uBAAuB;YAc9B,UAAU;IAYxB;;;;;;;;;;;;OAYG;IACG,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAKrC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B;;;;;;;OAOG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAKlC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;;;;;;;;;OAUG;YACW,cAAc;IAmFtB,OAAO,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAiB/C;;;;;;;OAOG;YACW,eAAe;IAyB7B,yEAAyE;IACnE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B,OAAO,CAAC,QAAQ;IAgChB;;;;;;;;;;;;;;OAcG;YACW,YAAY;IA2D1B,qJAAqJ;IACrJ,OAAO,CAAC,iBAAiB;IAgBzB;;;;;;OAMG;YACW,oBAAoB;IA6ClC,OAAO,CAAC,KAAK;IAIb;;;;OAIG;YACW,cAAc;IAoC5B;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAO1C,yDAAyD;IACnD,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvC;;;;;;OAMG;IACG,cAAc,IAAI,OAAO,CAAC,SAAS,CAAC;IAI1C,0EAA0E;IACpE,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAI3D;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC;IAM/C,OAAO,CAAC,IAAI;IAsBZ,OAAO,CAAC,SAAS;IAgCjB,OAAO,CAAC,cAAc;CAOvB"}