@hanivanrizky/nestjs-browser-action 0.8.0 → 0.9.1

package/README.md

@@ -66,12 +66,12 @@ export class AppModule {}
 
 ```typescript
 import { Injectable } from '@nestjs/common';
-import { ActionHelpersService } from '@hanivanrizky/nestjs-browser-action';
+import { BrowserActionService } from '@hanivanrizky/nestjs-browser-action';
 
 @Injectable()
 export class MyService {
   constructor(
-    private readonly actionHelpers: ActionHelpersService,
+    private readonly actionHelpers: BrowserActionService,
   ) {}
 
   async scrapeData() {
@@ -97,7 +97,7 @@ export class MyService {
 |--------|-------------|
 | [`scrape()`](./docs/methods/scrape.md) | Extract single elements |
 | [`scrapeAll()`](./docs/methods/scrape-all.md) | Extract multiple elements |
-| [`scrapeWithActions()`](./docs/methods/workflow.md) | Workflow-based automation |
+| [`scrapeWithWorkflow()`](./docs/methods/workflow.md) | Workflow-based automation |
 | [`scrapeAllWithWorkflow()`](./docs/methods/workflow.md) | Workflow with multi-element |
 | [`takeScreenshot()`](./docs/methods/screenshots.md) | Capture screenshots |
 | [`generatePDF()`](./docs/methods/screenshots.md) | Generate PDFs |
@@ -149,7 +149,7 @@ const workflow = {
   ],
 };
 
-const result = await this.actionHelpers.scrapeWithActions(workflow);
+const result = await this.actionHelpers.scrapeWithWorkflow(workflow);
 ```
 
 ### With Data Cleansing
@@ -208,6 +208,24 @@ BrowserActionModule.forRoot({
 passthrough for backward compatibility. `cloak` is ignored when `remote` is set
 (remote uses plain CDP connect).
 
+**Per-call cloak override (proxy/UA rotation):** pass `cloak` per request to launch a
+dedicated off-pool browser with its own stealth config — useful for rotating proxies or
+fingerprints across requests. Not supported in remote CDP mode.
+
+```typescript
+// scrape / scrapeAll
+await actions.scrape(url, { title: 'h1' }, {
+  cloak: { proxy: { server: 'http://rotating-proxy:8080' } },
+});
+
+// workflow
+await actions.scrapeWithWorkflow(url, {
+  version: '1.0',
+  cloak: { proxy: { server: 'http://rotating-proxy:8080' } },
+  actions: [...],
+});
+```
+
 ### Remote Chrome Connection
 
 Connect to remote Chrome instances via Chrome DevTools Protocol (CDP):
@@ -241,7 +259,7 @@ BrowserActionModule.forRoot({
 
 | Service | Description |
 |---------|-------------|
-| **ActionHelpersService** | High-level automation methods (scrape, screenshot, PDF, workflows) |
+| **BrowserActionService** | High-level automation methods (scrape, screenshot, PDF, workflows) |
 | **BrowserManagerService** | Browser pool management |
 | **PageService** | Page lifecycle and navigation |
 | **CookieService** | Cookie persistence |
@@ -256,7 +274,8 @@ BrowserActionModule.forRoot({
   pool: {
     min: 2,
     max: 10,
-    idleTimeoutMs: 30000,
+    idleTimeoutMs: 30000,    // reap idle browsers down to min (0 disables)
+    acquireTimeoutMs: 30000, // reject acquire() if none free in time (0 waits forever)
     strategy: 'round-robin',
   },
   cookies: {
@@ -288,7 +307,7 @@ const result = await this.actionHelpers.scrape<ProductSelectors>(url, {
 });
 
 // Type-safe workflow results
-const workflow = await this.actionHelpers.scrapeWithActions<{
+const workflow = await this.actionHelpers.scrapeWithWorkflow<{
   title: string;
   price: number;
 }>(url, workflow);

package/dist/browser-action.module.js

@@ -11,8 +11,8 @@ exports.BrowserActionModule = void 0;
 const common_1 = require("@nestjs/common");
 const browser_pool_service_1 = require("./services/browser-pool.service");
 const browser_manager_service_1 = require("./services/browser-manager.service");
-const page_service_1 = require("./services/page-service");
-const action_helpers_service_1 = require("./helpers/action-helpers.service");
+const page_service_1 = require("./services/page.service");
+const browser_action_service_1 = require("./services/browser-action.service");
 const cookie_service_1 = require("./services/cookie.service");
 const cleansing_service_1 = require("./services/cleansing.service");
 const constants_1 = require("./constants");
@@ -40,14 +40,14 @@ let BrowserActionModule = BrowserActionModule_1 = class BrowserActionModule {
                 browser_pool_service_1.BrowserPoolService,
                 browser_manager_service_1.BrowserManagerService,
                 page_service_1.PageService,
-                action_helpers_service_1.ActionHelpersService,
+                browser_action_service_1.BrowserActionService,
                 cookie_service_1.CookieService,
                 cleansing_service_1.CleansingService,
             ],
             exports: [
                 browser_manager_service_1.BrowserManagerService,
                 page_service_1.PageService,
-                action_helpers_service_1.ActionHelpersService,
+                browser_action_service_1.BrowserActionService,
                 cookie_service_1.CookieService,
                 cleansing_service_1.CleansingService,
             ],
@@ -69,14 +69,14 @@ let BrowserActionModule = BrowserActionModule_1 = class BrowserActionModule {
                 browser_pool_service_1.BrowserPoolService,
                 browser_manager_service_1.BrowserManagerService,
                 page_service_1.PageService,
-                action_helpers_service_1.ActionHelpersService,
+                browser_action_service_1.BrowserActionService,
                 cookie_service_1.CookieService,
                 cleansing_service_1.CleansingService,
             ],
             exports: [
                 browser_manager_service_1.BrowserManagerService,
                 page_service_1.PageService,
-                action_helpers_service_1.ActionHelpersService,
+                browser_action_service_1.BrowserActionService,
                 cookie_service_1.CookieService,
                 cleansing_service_1.CleansingService,
             ],

package/dist/browser-action.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-action.module.js","sourceRoot":"","sources":["../src/browser-action.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAyE;AAKzE,0EAAqE;AACrE,gFAA2E;AAC3E,0DAAsD;AACtD,6EAAwE;AACxE,8DAA0D;AAC1D,oEAAgE;AAChE,2CAAqD;AAI9C,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,OAAmC;QACjD,MAAM,eAAe,GAAa;YAChC,OAAO,EAAE,kCAAsB;YAC/B,QAAQ,EAAE,OAAO;SAClB,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,qBAAmB;YAC3B,SAAS,EAAE,CAAC,eAAe,CAAC;YAC5B,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,OAAmC;QAChD,MAAM,eAAe,GAAa;YAChC,OAAO,EAAE,kCAAsB;YAC/B,QAAQ,EAAE,OAAO;SAClB,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,qBAAmB;YAC3B,SAAS,EAAE;gBACT,eAAe;gBACf,yCAAkB;gBAClB,+CAAqB;gBACrB,0BAAW;gBACX,6CAAoB;gBACpB,8BAAa;gBACb,oCAAgB;aACjB;YACD,OAAO,EAAE;gBACP,+CAAqB;gBACrB,0BAAW;gBACX,6CAAoB;gBACpB,8BAAa;gBACb,oCAAgB;aACjB;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAAwC;QAC1D,MAAM,oBAAoB,GAAa;YACrC,OAAO,EAAE,kCAAsB;YAC/B,UAAU,EAAE,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;gBACvC,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;YAC3C,CAAC;YACD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;SAC7B,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,qBAAmB;YAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS,EAAE;gBACT,oBAAoB;gBACpB,yCAAkB;gBAClB,+CAAqB;gBACrB,0BAAW;gBACX,6CAAoB;gBACpB,8BAAa;gBACb,oCAAgB;aACjB;YACD,OAAO,EAAE;gBACP,+CAAqB;gBACrB,0BAAW;gBACX,6CAAoB;gBACpB,8BAAa;gBACb,oCAAgB;aACjB;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe;IAErB,CAAC;CACF,CAAA;AA3EY,kDAAmB;8BAAnB,mBAAmB;IAF/B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,mBAAmB,CA2E/B"}
+{"version":3,"file":"browser-action.module.js","sourceRoot":"","sources":["../src/browser-action.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAyE;AAKzE,0EAAqE;AACrE,gFAA2E;AAC3E,0DAAsD;AACtD,8EAAyE;AACzE,8DAA0D;AAC1D,oEAAgE;AAChE,2CAAqD;AAI9C,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,OAAmC;QACjD,MAAM,eAAe,GAAa;YAChC,OAAO,EAAE,kCAAsB;YAC/B,QAAQ,EAAE,OAAO;SAClB,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,qBAAmB;YAC3B,SAAS,EAAE,CAAC,eAAe,CAAC;YAC5B,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,OAAmC;QAChD,MAAM,eAAe,GAAa;YAChC,OAAO,EAAE,kCAAsB;YAC/B,QAAQ,EAAE,OAAO;SAClB,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,qBAAmB;YAC3B,SAAS,EAAE;gBACT,eAAe;gBACf,yCAAkB;gBAClB,+CAAqB;gBACrB,0BAAW;gBACX,6CAAoB;gBACpB,8BAAa;gBACb,oCAAgB;aACjB;YACD,OAAO,EAAE;gBACP,+CAAqB;gBACrB,0BAAW;gBACX,6CAAoB;gBACpB,8BAAa;gBACb,oCAAgB;aACjB;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAAwC;QAC1D,MAAM,oBAAoB,GAAa;YACrC,OAAO,EAAE,kCAAsB;YAC/B,UAAU,EAAE,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;gBACvC,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;YAC3C,CAAC;YACD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;SAC7B,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,qBAAmB;YAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS,EAAE;gBACT,oBAAoB;gBACpB,yCAAkB;gBAClB,+CAAqB;gBACrB,0BAAW;gBACX,6CAAoB;gBACpB,8BAAa;gBACb,oCAAgB;aACjB;YACD,OAAO,EAAE;gBACP,+CAAqB;gBACrB,0BAAW;gBACX,6CAAoB;gBACpB,8BAAa;gBACb,oCAAgB;aACjB;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe;IAErB,CAAC;CACF,CAAA;AA3EY,kDAAmB;8BAAnB,mBAAmB;IAF/B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,mBAAmB,CA2E/B"}

package/dist/constants/browser-action.constants.d.ts

@@ -3,6 +3,7 @@ export declare const DEFAULT_POOL_OPTIONS: {
     min: number;
     max: number;
     idleTimeoutMs: number;
+    acquireTimeoutMs: number;
     strategy: "round-robin";
 };
 export declare const DEFAULT_LAUNCH_OPTIONS: {

package/dist/constants/browser-action.constants.js

@@ -6,6 +6,7 @@ exports.DEFAULT_POOL_OPTIONS = {
     min: 2,
     max: 10,
     idleTimeoutMs: 30000,
+    acquireTimeoutMs: 30000,
     strategy: 'round-robin',
 };
 exports.DEFAULT_LAUNCH_OPTIONS = {

package/dist/constants/browser-action.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-action.constants.js","sourceRoot":"","sources":["../../src/constants/browser-action.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,sBAAsB,GAAG,wBAAwB,CAAC;AAElD,QAAA,oBAAoB,GAAG;IAClC,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,EAAE;IACP,aAAa,EAAE,KAAK;IACpB,QAAQ,EAAE,aAAsB;CACjC,CAAC;AAEW,QAAA,sBAAsB,GAAG;IACpC,QAAQ,EAAE,IAAI;CACf,CAAC;AAEW,QAAA,sBAAsB,GAAG;IACpC,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,IAAI;CACR,CAAC;AAEE,QAAA,8BAA8B,GAAG,GAAG,CAAC;AAErC,QAAA,cAAc,GAAG;IAC5B,oBAAoB,EAClB,2EAA2E;IAC7E,oBAAoB,EAClB,iEAAiE;CAC3D,CAAC;AAEE,QAAA,uBAAuB,GAAG;IACrC,QAAQ,EAAE;QACR,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;KACb;CACF,CAAC;AAGW,QAAA,sBAAsB,GAAG,KAAK,CAAC;AAC/B,QAAA,4BAA4B,GAAG,GAAG,CAAC;AACnC,QAAA,0BAA0B,GAAG,KAAK,CAAC;AACnC,QAAA,uBAAuB,GAAG,GAAG,CAAC;AAC9B,QAAA,2BAA2B,GAAG,YAAY,CAAC;AAC3C,QAAA,iCAAiC,GAAG,OAAO,CAAC;AAC5C,QAAA,sBAAsB,GAAG;IACpC,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,WAAW;IACvB,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;IACf,kBAAkB,EAAE,SAAS;CACrB,CAAC"}
+{"version":3,"file":"browser-action.constants.js","sourceRoot":"","sources":["../../src/constants/browser-action.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,sBAAsB,GAAG,wBAAwB,CAAC;AAElD,QAAA,oBAAoB,GAAG;IAClC,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,EAAE;IACP,aAAa,EAAE,KAAK;IACpB,gBAAgB,EAAE,KAAK;IACvB,QAAQ,EAAE,aAAsB;CACjC,CAAC;AAEW,QAAA,sBAAsB,GAAG;IACpC,QAAQ,EAAE,IAAI;CACf,CAAC;AAEW,QAAA,sBAAsB,GAAG;IACpC,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,IAAI;CACR,CAAC;AAEE,QAAA,8BAA8B,GAAG,GAAG,CAAC;AAErC,QAAA,cAAc,GAAG;IAC5B,oBAAoB,EAClB,2EAA2E;IAC7E,oBAAoB,EAClB,iEAAiE;CAC3D,CAAC;AAEE,QAAA,uBAAuB,GAAG;IACrC,QAAQ,EAAE;QACR,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;KACb;CACF,CAAC;AAGW,QAAA,sBAAsB,GAAG,KAAK,CAAC;AAC/B,QAAA,4BAA4B,GAAG,GAAG,CAAC;AACnC,QAAA,0BAA0B,GAAG,KAAK,CAAC;AACnC,QAAA,uBAAuB,GAAG,GAAG,CAAC;AAC9B,QAAA,2BAA2B,GAAG,YAAY,CAAC;AAC3C,QAAA,iCAAiC,GAAG,OAAO,CAAC;AAC5C,QAAA,sBAAsB,GAAG;IACpC,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,WAAW;IACvB,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;IACf,kBAAkB,EAAE,SAAS;CACrB,CAAC"}

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 export * from './browser-action.module';
 export * from './services/browser-pool.service';
 export * from './services/browser-manager.service';
-export * from './services/page-service';
+export * from './services/page.service';
 export * from './services/cookie.service';
 export * from './services/cleansing.service';
-export * from './helpers/action-helpers.service';
+export * from './services/browser-action.service';
 export * from './pipes';
 export * from './enums';
 export * from './interfaces';

package/dist/index.js

@@ -17,10 +17,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./browser-action.module"), exports);
 __exportStar(require("./services/browser-pool.service"), exports);
 __exportStar(require("./services/browser-manager.service"), exports);
-__exportStar(require("./services/page-service"), exports);
+__exportStar(require("./services/page.service"), exports);
 __exportStar(require("./services/cookie.service"), exports);
 __exportStar(require("./services/cleansing.service"), exports);
-__exportStar(require("./helpers/action-helpers.service"), exports);
+__exportStar(require("./services/browser-action.service"), exports);
 __exportStar(require("./pipes"), exports);
 __exportStar(require("./enums"), exports);
 __exportStar(require("./interfaces"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,0DAAwC;AAGxC,kEAAgD;AAChD,qEAAmD;AACnD,0DAAwC;AACxC,4DAA0C;AAC1C,+DAA6C;AAG7C,mEAAiD;AAGjD,0CAAwB;AAGxB,0CAAwB;AAGxB,+CAA6B;AAG7B,8CAA4B;AAG5B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,0DAAwC;AAGxC,kEAAgD;AAChD,qEAAmD;AACnD,0DAAwC;AACxC,4DAA0C;AAC1C,+DAA6C;AAG7C,oEAAkD;AAGlD,0CAAwB;AAGxB,0CAAwB;AAGxB,+CAA6B;AAG7B,8CAA4B;AAG5B,+CAA6B"}

package/dist/interfaces/browser-action-options.d.ts

@@ -2,6 +2,7 @@ import type { LogLevel } from '@nestjs/common';
 import type { BrowserContextOptions, LaunchOptions } from 'puppeteer-core';
 import type { LaunchOptions as CloakLaunchOptions } from 'cloakbrowser';
 import { PoolOptions } from './pool-options';
+import type { CleansingPipe } from '../pipes/cleansing-pipe';
 export type CloakOptions = CloakLaunchOptions & {
     userDataDir?: string;
 };
@@ -28,4 +29,5 @@ export interface BrowserActionOptions {
     debugLogMaxLength?: number;
     remote?: RemoteOptions;
     cookies?: CookieOptions;
+    customPipes?: Record<string, new () => CleansingPipe>;
 }

package/dist/interfaces/pool-options.d.ts

@@ -2,5 +2,6 @@ export interface PoolOptions {
     min?: number;
     max?: number;
     idleTimeoutMs?: number;
+    acquireTimeoutMs?: number;
     strategy?: 'round-robin' | 'least-recently-used';
 }

package/dist/interfaces/types.d.ts

@@ -1,6 +1,7 @@
 import { CleansingType } from '../enums/cleansing-type.enum';
+import type { CloakOptions } from './browser-action-options';
 export interface PipeConfig {
-    type: CleansingType;
+    type: CleansingType | string;
     pattern?: string;
     replacement?: string;
     format?: string;
@@ -16,6 +17,9 @@ export type ScrapeResult = Partial<Record<string, unknown>>;
 export type ScrapeAllResult = Partial<Record<string, unknown[]>>;
 export type ScraperOptions = {
     pipes?: PipeOptions;
+    waitUntil?: 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2';
+    timeout?: number;
+    cloak?: CloakOptions;
 };
 export type ScraperOptionsTyped<T extends SelectorMap> = {
     pipes?: Partial<Record<keyof T, PipeConfig[]>>;

package/dist/interfaces/workflow-options.d.ts

@@ -1,4 +1,5 @@
 import type { PipeConfig } from './types';
+import type { CloakOptions } from './browser-action-options';
 export interface ActionTarget {
     type: 'css' | 'xpath';
     value?: string;
@@ -45,6 +46,7 @@ export interface WorkflowDefinition {
     actions: WorkflowAction[];
     onError?: WorkflowErrorConfig;
     debugLogMaxLength?: number;
+    cloak?: CloakOptions;
 }
 export interface WorkflowResult {
     success: boolean;

package/dist/pipes/remove-line-breaks.pipe.js

@@ -13,7 +13,7 @@ exports.RemoveLineBreaksPipe = void 0;
 const class_validator_1 = require("class-validator");
 const cleansing_pipe_1 = require("./cleansing-pipe");
 const cleansing_type_enum_1 = require("../enums/cleansing-type.enum");
-const string_util_1 = require("../helpers/string.util");
+const string_util_1 = require("../utils/string.util");
 class RemoveLineBreaksPipe extends cleansing_pipe_1.CleansingPipe {
     type = cleansing_type_enum_1.CleansingType.REMOVE_LINE_BREAKS;
     replaceWithSpace;

package/dist/pipes/remove-line-breaks.pipe.js.map

@@ -1 +1 @@
-{"version":3,"file":"remove-line-breaks.pipe.js","sourceRoot":"","sources":["../../src/pipes/remove-line-breaks.pipe.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAwD;AACxD,qDAAiD;AACjD,sEAA6D;AAC7D,wDAA6D;AAK7D,MAAa,oBAAqB,SAAQ,8BAA6B;IACrE,IAAI,GAAG,mCAAa,CAAC,kBAAkB,CAAC;IAIxC,gBAAgB,CAAW;IAE3B,IAAI,CAAC,KAAa;QAChB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,MAAM,GAAG,KAAK,CAAC;QAEnB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;YAChE,MAAM,GAAG,IAAA,iCAAmB,EAAC,MAAM,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAvBD,oDAuBC;AAlBC;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;8DACe"}
+{"version":3,"file":"remove-line-breaks.pipe.js","sourceRoot":"","sources":["../../src/pipes/remove-line-breaks.pipe.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAwD;AACxD,qDAAiD;AACjD,sEAA6D;AAC7D,sDAA2D;AAK3D,MAAa,oBAAqB,SAAQ,8BAA6B;IACrE,IAAI,GAAG,mCAAa,CAAC,kBAAkB,CAAC;IAIxC,gBAAgB,CAAW;IAE3B,IAAI,CAAC,KAAa;QAChB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,MAAM,GAAG,KAAK,CAAC;QAEnB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;YAChE,MAAM,GAAG,IAAA,iCAAmB,EAAC,MAAM,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAvBD,oDAuBC;AAlBC;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;8DACe"}

package/dist/pipes/remove-special-chars.pipe.js

@@ -13,7 +13,7 @@ exports.RemoveSpecialCharsPipe = void 0;
 const class_validator_1 = require("class-validator");
 const cleansing_pipe_1 = require("./cleansing-pipe");
 const cleansing_type_enum_1 = require("../enums/cleansing-type.enum");
-const string_util_1 = require("../helpers/string.util");
+const string_util_1 = require("../utils/string.util");
 class RemoveSpecialCharsPipe extends cleansing_pipe_1.CleansingPipe {
     type = cleansing_type_enum_1.CleansingType.REMOVE_SPECIAL_CHARS;
     allowedChars;

package/dist/pipes/remove-special-chars.pipe.js.map

@@ -1 +1 @@
-{"version":3,"file":"remove-special-chars.pipe.js","sourceRoot":"","sources":["../../src/pipes/remove-special-chars.pipe.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAuD;AACvD,qDAAiD;AACjD,sEAA6D;AAC7D,wDAA6D;AAK7D,MAAa,sBAAuB,SAAQ,8BAA6B;IACvE,IAAI,GAAG,mCAAa,CAAC,oBAAoB,CAAC;IAI1C,YAAY,CAAU;IAEd,MAAM,CAAU;IAExB,IAAI,CAAC,KAAa;QAChB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,MAAM,GAAG,KAAK,CAAC;QAEnB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY;qBAC9B,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC;qBACtC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACxB,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,cAAc,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC;YAC1D,CAAC;YACD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,IAAA,iCAAmB,EAAC,MAAM,CAAC,CAAC;IACrC,CAAC;CACF;AA9BD,wDA8BC;AAzBC;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;4DACW"}
+{"version":3,"file":"remove-special-chars.pipe.js","sourceRoot":"","sources":["../../src/pipes/remove-special-chars.pipe.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAuD;AACvD,qDAAiD;AACjD,sEAA6D;AAC7D,sDAA2D;AAK3D,MAAa,sBAAuB,SAAQ,8BAA6B;IACvE,IAAI,GAAG,mCAAa,CAAC,oBAAoB,CAAC;IAI1C,YAAY,CAAU;IAEd,MAAM,CAAU;IAExB,IAAI,CAAC,KAAa;QAChB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,MAAM,GAAG,KAAK,CAAC;QAEnB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY;qBAC9B,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC;qBACtC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACxB,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,cAAc,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC;YAC1D,CAAC;YACD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,IAAA,iCAAmB,EAAC,MAAM,CAAC,CAAC;IACrC,CAAC;CACF;AA9BD,wDA8BC;AAzBC;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;4DACW"}

package/dist/pipes/sanitize-text.pipe.js

@@ -13,7 +13,7 @@ exports.SanitizeTextPipe = void 0;
 const class_validator_1 = require("class-validator");
 const cleansing_pipe_1 = require("./cleansing-pipe");
 const cleansing_type_enum_1 = require("../enums/cleansing-type.enum");
-const string_util_1 = require("../helpers/string.util");
+const string_util_1 = require("../utils/string.util");
 class SanitizeTextPipe extends cleansing_pipe_1.CleansingPipe {
     type = cleansing_type_enum_1.CleansingType.SANITIZE_TEXT;
     static TAG_PAIR_REGEXES = [

package/dist/pipes/sanitize-text.pipe.js.map

@@ -1 +1 @@
-{"version":3,"file":"sanitize-text.pipe.js","sourceRoot":"","sources":["../../src/pipes/sanitize-text.pipe.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAA6C;AAC7C,qDAAiD;AACjD,sEAA6D;AAC7D,wDAA6D;AAK7D,MAAa,gBAAiB,SAAQ,8BAA6B;IACjE,IAAI,GAAG,mCAAa,CAAC,aAAa,CAAC;IAE3B,MAAM,CAAU,gBAAgB,GAAa;QACnD,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,MAAM;QACN,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,UAAU;QACV,MAAM;QACN,MAAM;QACN,OAAO;KACR,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,gBAAgB,GAAG,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAExD,MAAM,CAAU,wBAAwB,GAAa;QAC3D,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,MAAM;QACN,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,UAAU;QACV,MAAM;QACN,MAAM;QACN,OAAO;KACR,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC;IAElD,MAAM,CAAU,qBAAqB,GAAa;QACxD,SAAS;QACT,SAAS;QACT,QAAQ;QACR,aAAa;QACb,YAAY;QACZ,SAAS;QACT,QAAQ;QACR,UAAU;QACV,UAAU;QACV,SAAS;QACT,UAAU;QACV,WAAW;QACX,SAAS;QACT,YAAY;KACb,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAG5C,gBAAgB,CAAW;IAE3B,IAAI,CAAC,KAAa;QAChB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,MAAM,GAAG,KAAK,CAAC;QAEnB,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,gBAAgB,EAAE,CAAC;YACtD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,wBAAwB,EAAE,CAAC;YAC9D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,qBAAqB,EAAE,CAAC;YAC3D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAC7C,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAExC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,MAAM,GAAG,MAAM;iBACZ,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;iBACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;iBACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;iBACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;iBACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,GAAG,IAAA,iCAAmB,EAAC,MAAM,CAAC,CAAC;QAErC,OAAO,MAAM,CAAC;IAChB,CAAC;;AAvFH,4CAwFC;AAnCC;IADC,IAAA,4BAAU,GAAE;;0DACc"}
+{"version":3,"file":"sanitize-text.pipe.js","sourceRoot":"","sources":["../../src/pipes/sanitize-text.pipe.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAA6C;AAC7C,qDAAiD;AACjD,sEAA6D;AAC7D,sDAA2D;AAK3D,MAAa,gBAAiB,SAAQ,8BAA6B;IACjE,IAAI,GAAG,mCAAa,CAAC,aAAa,CAAC;IAE3B,MAAM,CAAU,gBAAgB,GAAa;QACnD,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,MAAM;QACN,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,UAAU;QACV,MAAM;QACN,MAAM;QACN,OAAO;KACR,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,gBAAgB,GAAG,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAExD,MAAM,CAAU,wBAAwB,GAAa;QAC3D,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,MAAM;QACN,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,UAAU;QACV,MAAM;QACN,MAAM;QACN,OAAO;KACR,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC;IAElD,MAAM,CAAU,qBAAqB,GAAa;QACxD,SAAS;QACT,SAAS;QACT,QAAQ;QACR,aAAa;QACb,YAAY;QACZ,SAAS;QACT,QAAQ;QACR,UAAU;QACV,UAAU;QACV,SAAS;QACT,UAAU;QACV,WAAW;QACX,SAAS;QACT,YAAY;KACb,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAG5C,gBAAgB,CAAW;IAE3B,IAAI,CAAC,KAAa;QAChB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,MAAM,GAAG,KAAK,CAAC;QAEnB,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,gBAAgB,EAAE,CAAC;YACtD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,wBAAwB,EAAE,CAAC;YAC9D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,qBAAqB,EAAE,CAAC;YAC3D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAC7C,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAExC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,MAAM,GAAG,MAAM;iBACZ,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;iBACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;iBACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;iBACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;iBACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,GAAG,IAAA,iCAAmB,EAAC,MAAM,CAAC,CAAC;QAErC,OAAO,MAAM,CAAC;IAChB,CAAC;;AAvFH,4CAwFC;AAnCC;IADC,IAAA,4BAAU,GAAE;;0DACc"}

package/dist/{helpers/action-helpers.service.d.ts → services/browser-action.service.d.ts}

@@ -1,11 +1,11 @@
 import type { Page, ScreenshotOptions, PDFOptions } from 'puppeteer-core';
-import { PageService } from '../services/page-service';
-import { CookieService } from '../services/cookie.service';
-import { CleansingService } from '../services/cleansing.service';
+import { PageService } from './page.service';
+import { CookieService } from './cookie.service';
+import { CleansingService } from './cleansing.service';
 import type { WorkflowDefinition, VariableContext } from '../interfaces/workflow-options';
 import { SelectorMap, ScraperOptions, ScrapeResult, ScrapeAllResult, WorkflowResultTyped } from '../interfaces/types';
 import type { BrowserActionOptions } from '../interfaces/browser-action-options';
-export declare class ActionHelpersService {
+export declare class BrowserActionService {
     private readonly pageService;
     private readonly cookieService;
     private readonly cleansingService;
@@ -17,14 +17,17 @@ export declare class ActionHelpersService {
     takeScreenshot(url: string, path: string, options?: ScreenshotOptions): Promise<Buffer>;
     generatePDF(url: string, path: string, options?: PDFOptions): Promise<Buffer>;
     scrape<T extends SelectorMap>(url: string, selectors: T, options?: ScraperOptions): Promise<ScrapeResult>;
+    private parseSelector;
+    private buildNavOptions;
     scrapeAll<T extends SelectorMap>(url: string, selectors: T, options?: ScraperOptions): Promise<ScrapeAllResult>;
     private extractAllData;
     private extractAllFromShadowRoot;
     waitForSelector(url: string, selector: string, timeout?: number): Promise<Page>;
-    evaluate<T = unknown>(url: string, script: string | (() => any)): Promise<T>;
-    scrapeWithActions<T = Record<string, unknown>>(url: string, workflow: WorkflowDefinition, variables?: VariableContext): Promise<WorkflowResultTyped<T>>;
+    evaluate<T = unknown>(url: string, script: string | (() => unknown)): Promise<T>;
+    scrapeWithWorkflow<T = Record<string, unknown>>(url: string, workflow: WorkflowDefinition, variables?: VariableContext): Promise<WorkflowResultTyped<T>>;
     scrapeAllWithWorkflow<T = Record<string, unknown>>(url: string, workflow: WorkflowDefinition, variables?: VariableContext): Promise<WorkflowResultTyped<T>>;
     private executeAction;
+    private dispatchAction;
     private evaluateCondition;
     private describeTarget;
     private findElement;

package/dist/{helpers/action-helpers.service.js → services/browser-action.service.js}

@@ -11,19 +11,19 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
-var ActionHelpersService_1;
+var BrowserActionService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ActionHelpersService = void 0;
+exports.BrowserActionService = void 0;
 const common_1 = require("@nestjs/common");
-const page_service_1 = require("../services/page-service");
-const cookie_service_1 = require("../services/cookie.service");
-const cleansing_service_1 = require("../services/cleansing.service");
-const logger_util_1 = require("./logger.util");
-const delay_util_1 = require("./delay.util");
-const dom_util_1 = require("./dom.util");
-const truncate_log_util_1 = require("./truncate-log.util");
+const page_service_1 = require("./page.service");
+const cookie_service_1 = require("./cookie.service");
+const cleansing_service_1 = require("./cleansing.service");
+const logger_util_1 = require("../utils/logger.util");
+const delay_util_1 = require("../utils/delay.util");
+const dom_util_1 = require("../utils/dom.util");
+const truncate_log_util_1 = require("../utils/truncate-log.util");
 const browser_action_constants_1 = require("../constants/browser-action.constants");
-let ActionHelpersService = ActionHelpersService_1 = class ActionHelpersService {
+let BrowserActionService = BrowserActionService_1 = class BrowserActionService {
     pageService;
     cookieService;
     cleansingService;
@@ -36,7 +36,7 @@ let ActionHelpersService = ActionHelpersService_1 = class ActionHelpersService {
         this.cookieService = cookieService;
         this.cleansingService = cleansingService;
         this.moduleOptions = moduleOptions;
-        this.logger = new logger_util_1.LoggerWithLevel(ActionHelpersService_1.name, this.pageService.getLogLevel());
+        this.logger = new logger_util_1.LoggerWithLevel(BrowserActionService_1.name, this.pageService.getLogLevel());
         this.activeDebugLogMaxLength =
             moduleOptions?.debugLogMaxLength ?? browser_action_constants_1.DEFAULT_DEBUG_LOG_MAX_LENGTH;
     }
@@ -56,11 +56,15 @@ let ActionHelpersService = ActionHelpersService_1 = class ActionHelpersService {
     }
     async scrape(url, selectors, options) {
         this.logger.debug((0, truncate_log_util_1.truncateLog)(this.activeDebugLogMaxLength, `Scraping ${url}`));
-        const page = await this.pageService.navigateTo(url);
+        const page = await this.pageService.navigateTo(url, this.buildNavOptions(options), options?.cloak);
         const result = {};
-        for (const [key, selector] of Object.entries(selectors)) {
+        const evalOne = page['$eval'].bind(page);
+        await Promise.all(Object.entries(selectors).map(async ([key, rawSelector]) => {
+            const { selector, attribute } = this.parseSelector(rawSelector);
             try {
-                const value = await page.$eval(selector, (el) => el.textContent);
+                const value = attribute
+                    ? await evalOne(selector, (el, attr) => el.getAttribute(attr), attribute)
+                    : await evalOne(selector, (el) => el.textContent);
                 if (options?.pipes?.[key]) {
                     const pipeInstances = this.getCachedPipeInstances(options.pipes[key]);
                     result[key] = this.cleansingService.cleanse(value, pipeInstances);
@@ -69,23 +73,50 @@ let ActionHelpersService = ActionHelpersService_1 = class ActionHelpersService {
                     result[key] = value;
                 }
             }
-            catch {
-                this.logger.warn(`Failed to scrape ${selector}`);
+            catch (err) {
+                this.logger.warn(`Failed to scrape '${key}' (${rawSelector}): ${err instanceof Error ? err.message : String(err)}`);
             }
-        }
+        }));
         await this.pageService.closePage();
         return result;
     }
+    parseSelector(raw) {
+        const match = raw.match(/^(.*)@([A-Za-z_][\w-]*)$/);
+        if (match && match[1].trim() !== '') {
+            return { selector: match[1], attribute: match[2] };
+        }
+        return { selector: raw };
+    }
+    buildNavOptions(options) {
+        if (!options?.waitUntil && !options?.timeout)
+            return undefined;
+        return { waitUntil: options.waitUntil, timeout: options.timeout };
+    }
     async scrapeAll(url, selectors, options) {
         this.logger.debug((0, truncate_log_util_1.truncateLog)(this.activeDebugLogMaxLength, `Scraping all elements from ${url}`));
-        const page = await this.pageService.navigateTo(url);
+        const page = await this.pageService.navigateTo(url, this.buildNavOptions(options), options?.cloak);
         const result = {};
-        for (const [key, selector] of Object.entries(selectors)) {
-            this.validateSelector(key, selector);
+        const evalAll = page['$$eval'].bind(page);
+        Object.entries(selectors).forEach(([key, selector]) => this.validateSelector(key, selector));
+        await Promise.all(Object.entries(selectors).map(async ([key, rawSelector]) => {
+            const { selector, attribute } = this.parseSelector(rawSelector);
             try {
                 const isXPath = (0, dom_util_1.isXPathSelector)(selector);
                 let values;
-                if (isXPath) {
+                if (isXPath && attribute) {
+                    values = await page.evaluate((xpathSelector, attr) => {
+                        const results = document.evaluate(xpathSelector, document, null, XPathResult.UNORDERED_NODE_ITERATOR_TYPE, null);
+                        const vals = [];
+                        let node;
+                        while ((node = results.iterateNext())) {
+                            vals.push(node instanceof Element
+                                ? node.getAttribute(attr) || ''
+                                : node?.textContent?.trim() || '');
+                        }
+                        return vals;
+                    }, selector, attribute);
+                }
+                else if (isXPath) {
                     values = await page.evaluate((xpathSelector) => {
                         const results = document.evaluate(xpathSelector, document, null, XPathResult.UNORDERED_NODE_ITERATOR_TYPE, null);
                         const vals = [];
@@ -96,8 +127,11 @@ let ActionHelpersService = ActionHelpersService_1 = class ActionHelpersService {
                         return vals;
                     }, selector);
                 }
+                else if (attribute) {
+                    values = await evalAll(selector, (elements, attr) => elements.map((el) => el.getAttribute(attr) || ''), attribute);
+                }
                 else {
-                    values = await page.$$eval(selector, (elements) => elements.map((el) => el.textContent?.trim() || ''));
+                    values = await evalAll(selector, (elements) => elements.map((el) => el.textContent?.trim() || ''));
                 }
                 if (options?.pipes?.[key]) {
                     const pipeInstances = this.getCachedPipeInstances(options.pipes[key]);
@@ -107,10 +141,10 @@ let ActionHelpersService = ActionHelpersService_1 = class ActionHelpersService {
                     result[key] = values;
                 }
             }
-            catch {
-                this.logger.warn(`Failed to scrape ${selector}`);
+            catch (err) {
+                this.logger.warn(`Failed to scrape '${key}' (${rawSelector}): ${err instanceof Error ? err.message : String(err)}`);
             }
-        }
+        }));
         await this.pageService.closePage();
         return result;
     }
@@ -206,17 +240,19 @@ let ActionHelpersService = ActionHelpersService_1 = class ActionHelpersService {
     async evaluate(url, script) {
         this.logger.debug((0, truncate_log_util_1.truncateLog)(this.activeDebugLogMaxLength, `Evaluating script on ${url}`));
         const page = await this.pageService.navigateTo(url);
-        const result = await page.evaluate(script);
+        const result = typeof script === 'function'
+            ? await page.evaluate(script)
+            : await page.evaluate(script);
         await this.pageService.closePage();
         return result;
     }
-    async scrapeWithActions(url, workflow, variables) {
+    async scrapeWithWorkflow(url, workflow, variables) {
         this.activeDebugLogMaxLength =
             workflow.debugLogMaxLength ??
                 this.moduleOptions?.debugLogMaxLength ??
                 browser_action_constants_1.DEFAULT_DEBUG_LOG_MAX_LENGTH;
         this.logger.debug((0, truncate_log_util_1.truncateLog)(this.activeDebugLogMaxLength, `Starting workflow execution for ${url}`));
-        const page = await this.pageService.navigateTo(url);
+        const page = await this.pageService.navigateTo(url, undefined, workflow.cloak);
         const result = {
             success: false,
             data: {},
@@ -263,7 +299,7 @@ let ActionHelpersService = ActionHelpersService_1 = class ActionHelpersService {
         return result;
     }
     async scrapeAllWithWorkflow(url, workflow, variables) {
-        return await this.scrapeWithActions(url, workflow, variables);
+        return await this.scrapeWithWorkflow(url, workflow, variables);
     }
     async executeAction(page, action, context) {
         if (action.condition) {
@@ -278,11 +314,34 @@ let ActionHelpersService = ActionHelpersService_1 = class ActionHelpersService {
             ? `[${action.action}] id="${action.id}"`
             : `[${action.action}]`;
         this.logger.debug((0, truncate_log_util_1.truncateLog)(this.activeDebugLogMaxLength, `Executing action: ${actionLabel}`));
+        const maxRetries = action.options?.retry ?? 0;
+        const retryDelay = action.options?.retryDelay ?? 0;
+        for (let attempt = 0;; attempt++) {
+            try {
+                await this.dispatchAction(page, action, value, context);
+                return;
+            }
+            catch (err) {
+                if (attempt >= maxRetries)
+                    throw err;
+                this.logger.warn((0, truncate_log_util_1.truncateLog)(this.activeDebugLogMaxLength, `Action ${actionLabel} failed (attempt ${attempt + 1}/${maxRetries + 1}), retrying: ${err instanceof Error ? err.message : String(err)}`));
+                if (retryDelay > 0)
+                    await (0, delay_util_1.delay)(retryDelay);
+            }
+        }
+    }
+    async dispatchAction(page, action, value, context) {
         switch (action.action) {
-            case 'navigate':
+            case 'navigate': {
+                const navOptions = {};
+                if (action.options?.waitUntil)
+                    navOptions.waitUntil = action.options.waitUntil;
+                if (action.options?.timeout)
+                    navOptions.timeout = action.options.timeout;
                 this.logger.debug((0, truncate_log_util_1.truncateLog)(this.activeDebugLogMaxLength, `  navigate → ${value}`));
-                await page.goto(value);
+                await page.goto(value, Object.keys(navOptions).length ? navOptions : undefined);
                 break;
+            }
             case 'wait':
                 this.logger.debug((0, truncate_log_util_1.truncateLog)(this.activeDebugLogMaxLength, `  wait ${Number(action.value) || 0}ms`));
                 await (0, delay_util_1.delay)(Number(action.value) || 0);
@@ -573,7 +632,7 @@ let ActionHelpersService = ActionHelpersService_1 = class ActionHelpersService {
     getCachedPipeInstances(config) {
         const cacheKey = JSON.stringify(config);
         if (!this.pipeCache.has(cacheKey)) {
-            this.pipeCache.set(cacheKey, this.cleansingService.loadPipes(config));
+            this.pipeCache.set(cacheKey, this.cleansingService.buildPipes(config));
         }
         return this.pipeCache.get(cacheKey);
     }
@@ -711,13 +770,13 @@ let ActionHelpersService = ActionHelpersService_1 = class ActionHelpersService {
         });
     }
 };
-exports.ActionHelpersService = ActionHelpersService;
-exports.ActionHelpersService = ActionHelpersService = ActionHelpersService_1 = __decorate([
+exports.BrowserActionService = BrowserActionService;
+exports.BrowserActionService = BrowserActionService = BrowserActionService_1 = __decorate([
     (0, common_1.Injectable)({ scope: common_1.Scope.TRANSIENT }),
     __param(3, (0, common_1.Optional)()),
     __param(3, (0, common_1.Inject)(browser_action_constants_1.BROWSER_ACTION_OPTIONS)),
     __metadata("design:paramtypes", [page_service_1.PageService,
         cookie_service_1.CookieService,
         cleansing_service_1.CleansingService, Object])
-], ActionHelpersService);
-//# sourceMappingURL=action-helpers.service.js.map
+], BrowserActionService);
+//# sourceMappingURL=browser-action.service.js.map