@allwright.dev/core 0.0.54 → 0.0.55

package/dist/bootstrap.js

@@ -12,7 +12,7 @@ const ALLWRIGHT_HOME_ENV_VAR = "ALLWRIGHT_HOME";
 const ALLWRIGHT_REPOSITORY_ENV_VAR = "ALLWRIGHT_REPOSITORY";
 const ALLWRIGHT_VERSION_ENV_VAR = "ALLWRIGHT_VERSION";
 const DEFAULT_RELEASE_REPOSITORY = "allwright-dev/allwright";
-const DEFAULT_RELEASE_VERSION = "0.0.54";
+const DEFAULT_RELEASE_VERSION = "0.0.55";
 const STARTUP_TIMEOUT_MS = 20_000;
 const PING_TIMEOUT_MS = 1_000;
 const PROTO_ROOT = fileURLToPath(new URL("../proto/", import.meta.url));

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { PageImpl } from "./page.js";
 import { setServerAddr, shutdown } from "./runtime.js";
 import type { Browser, BrowserKind, BrowserType, LaunchOptions, Page, ResolveConfigOptions, ResolvedAllwrightConfig } from "./types.js";
 export { findConfigFile, loadConfigFile, resolveConfig, setServerAddr, shutdown };
-export type { AllwrightConfig, Browser, BrowserInfo, BrowserKind, BrowserType, ClickResult, CommandOptions, CountResult, ElementResult, FillResult, HighlightOptions, HighlightResult, LaunchOptions, MobileAndroidConnectOptions, MobileAndroidDevice, MobileAndroidLaunchOptions, MobileAndroidLocator, MobileAndroidApp, Locator, LocatorInfo, MobileSurfaceNamespace, NavigateResult, Page, PageInfo, PressOptions, PressResult, ResolveConfigOptions, ResolvedAllwrightConfig, RetryConfig, ScreenshotResult, TextResult, WaitForSelectorOptions, WaitForSelectorResult, } from "./types.js";
+export type { AllwrightConfig, Browser, BrowserInfo, BrowserKind, BrowserType, ClickResult, CommandOptions, CountResult, ElementResult, FillResult, HighlightOptions, HighlightResult, LaunchOptions, MobileAndroidConnectOptions, MobileAndroidDevice, MobileAndroidLaunchOptions, MobileAndroidLocator, MobileAndroidApp, Locator, LocatorInfo, MobileSurfaceNamespace, NavigateResult, Page, PageInfo, PressOptions, PressResult, ResolveConfigOptions, ResolvedAllwrightConfig, RetryConfig, ScreenshotOptions, ScreenshotResult, TextResult, WaitForSelectorOptions, WaitForSelectorResult, } from "./types.js";
 export declare const chromium: BrowserType;
 export declare const firefox: BrowserType;
 export { mobile };

package/dist/mobile.js

@@ -1,4 +1,5 @@
 import { createBrowserSessionHandle, createPageHandle, getRuntime } from "./runtime.js";
+import { writeFile } from "node:fs/promises";
 import { chainMobileSelectorForTransport, normalizeMobileSelectorForTransport } from "./mobileSelectors.js";
 function retryOptions(timeoutMs) {
     return timeoutMs ? { timeoutMs } : undefined;
@@ -83,15 +84,20 @@ class MobileAndroidAppImpl {
             contextSessionId: this.sessionId,
             screenshot: {
                 retryOptions: retryOptions(options.timeoutMs),
+                fullPage: options.fullPage,
             },
         });
         while (true) {
             const event = await handle.queue.next();
             if (event.screenshotCaptured?.pngData) {
-                return {
+                const screenshot = {
                     pngData: event.screenshotCaptured.pngData,
                     note: event.screenshotCaptured.note ?? "",
                 };
+                if (options.path) {
+                    await writeFile(options.path, screenshot.pngData);
+                }
+                return screenshot;
             }
             if (event.error?.message) {
                 throw new Error(event.error.message);

package/dist/page.d.ts

@@ -1,4 +1,4 @@
-import type { ClickResult, CommandOptions, CountResult, ElementResult, FillResult, HighlightOptions, HighlightResult, Locator, NavigateResult, Page, PageInfo, PressOptions, PressResult, RuntimeClient, ScreenshotResult, TextResult, WaitForSelectorOptions, WaitForSelectorResult } from "./types.js";
+import type { ClickResult, CommandOptions, CountResult, ElementResult, FillResult, HighlightOptions, HighlightResult, Locator, NavigateResult, Page, PageInfo, PressOptions, PressResult, RuntimeClient, ScreenshotOptions, ScreenshotResult, TextResult, WaitForSelectorOptions, WaitForSelectorResult } from "./types.js";
 export declare class PageImpl implements Page {
     #private;
     constructor(input: PageInfo & {
@@ -18,7 +18,7 @@ export declare class PageImpl implements Page {
     textContent(selector: string, options?: CommandOptions): Promise<TextResult>;
     innerText(selector: string, options?: CommandOptions): Promise<TextResult>;
     waitForSelector(selector: string, options?: WaitForSelectorOptions): Promise<WaitForSelectorResult>;
-    screenshot(options?: CommandOptions): Promise<ScreenshotResult>;
+    screenshot(options?: ScreenshotOptions): Promise<ScreenshotResult>;
     close(): Promise<void>;
     ping(message?: string): Promise<string>;
     pageInfo(): PageInfo;

package/dist/page.js

@@ -1,4 +1,5 @@
 import { LocatorImpl } from "./locator.js";
+import { writeFile } from "node:fs/promises";
 import { formatActionError } from "./errors.js";
 import { normalizeSelectorForTransport } from "./selectors.js";
 import { createPageHandle } from "./runtime.js";
@@ -312,15 +313,20 @@ export class PageImpl {
             contextSessionId: this.sessionId,
             screenshot: {
                 retryOptions: options.timeoutMs ? { timeoutMs: options.timeoutMs } : undefined,
+                fullPage: options.fullPage,
             },
         });
         while (true) {
             const event = await handle.queue.next();
             if (event.screenshotCaptured?.pngData) {
-                return {
+                const screenshot = {
                     pngData: event.screenshotCaptured.pngData,
                     note: event.screenshotCaptured.note ?? "",
                 };
+                if (options.path) {
+                    await writeFile(options.path, screenshot.pngData);
+                }
+                return screenshot;
             }
             if (event.error?.message) {
                 throw formatActionError("screenshot", event.error.message);

package/dist/types.d.ts

@@ -71,6 +71,10 @@ export interface ScreenshotResult {
     pngData: Uint8Array;
     note: string;
 }
+export interface ScreenshotOptions extends CommandOptions {
+    fullPage?: boolean;
+    path?: string;
+}
 export interface BrowserInfo {
     sessionId: string;
     browserName: string;
@@ -114,7 +118,7 @@ export interface Page extends PageInfo {
     textContent(selector: string, options?: CommandOptions): Promise<TextResult>;
     innerText(selector: string, options?: CommandOptions): Promise<TextResult>;
     waitForSelector(selector: string, options?: WaitForSelectorOptions): Promise<WaitForSelectorResult>;
-    screenshot(options?: CommandOptions): Promise<ScreenshotResult>;
+    screenshot(options?: ScreenshotOptions): Promise<ScreenshotResult>;
     close(): Promise<void>;
     ping(message?: string): Promise<string>;
     pageInfo(): PageInfo;
@@ -144,7 +148,7 @@ export interface MobileAndroidApp {
     locator(selector: string): MobileAndroidLocator;
     click(selector: string, options?: CommandOptions): Promise<ClickResult>;
     fill(selector: string, value: string, options?: CommandOptions): Promise<FillResult>;
-    screenshot(options?: CommandOptions): Promise<ScreenshotResult>;
+    screenshot(options?: ScreenshotOptions): Promise<ScreenshotResult>;
 }
 export interface MobileAndroidDevice {
     readonly sessionId: string;
@@ -582,6 +586,7 @@ export interface ScreenshotRequest {
         retryOptions?: {
             timeoutMs?: number;
         };
+        fullPage?: boolean;
     };
 }
 export interface CloseContextRequest {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allwright.dev/core",
-  "version": "0.0.54",
+  "version": "0.0.55",
   "description": "High-level TypeScript client for the allwright automation engine.",
   "license": "MIT",
   "type": "module",

package/proto/core/v1/context.proto

@@ -135,6 +135,7 @@ message WaitForSelectorCommand {
 
 message ScreenshotCommand {
   optional CommandRetryOptions retry_options = 1;
+  optional bool full_page = 2;
 }
 
 message PageNavigatedEvent {