@bloom-perf/yaml-pptr 1.0.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,336 @@
+# yaml-pptr
+
+[![GitHub last commit](https://img.shields.io/github/last-commit/bloom-perf/yaml-pptr?logo=github)](https://github.com/bloom-perf/yaml-pptr)
+[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/bloom-perf/yaml-pptr/ci.yml?style=flat&branch=main)](https://github.com/Bloom-Perf/yaml-pptr/actions)
+[![GitHub release](https://img.shields.io/github/v/release/bloom-perf/yaml-pptr?style=flat)](https://github.com/Bloom-Perf/yaml-pptr/releases)
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg?style=flat)](https://opensource.org/licenses/Apache-2.0)
+
+**yaml-pptr** is a library that allows you to control web browsers using Puppeteer by defining your scenarios in YAML. No more verbose Puppeteer scripts - just simple, human-readable configuration files.
+
+## Installation
+
+```bash
+npm install @bloom-perf/yaml-pptr
+```
+
+## Quick Start
+
+```typescript
+import { readYamlAndInterpret } from '@bloom-perf/yaml-pptr';
+
+const yaml = `
+scenarios:
+  - name: Login Test
+    location: "https://www.saucedemo.com"
+    steps:
+      - input:
+          selector: "#user-name"
+          text: "standard_user"
+      - input:
+          selector: "#password"
+          text: "secret_sauce"
+      - click: "#login-button"
+      - wait: 2
+`;
+
+readYamlAndInterpret(yaml);
+```
+
+## Examples
+
+Ready-to-run examples are available in the [`examples/`](./examples) directory:
+
+```bash
+npm run example:login   # Login test with screenshot
+npm run example:load    # Load test (3 workers × 2 iterations)
+```
+
+## Getting Started
+
+### Project Structure
+
+```
+my-automation/
+├── scenarios/
+│   └── login-test.yaml
+├── src/
+│   └── runner.ts
+├── package.json
+└── tsconfig.json
+```
+
+### 1. Create a YAML scenario
+
+**scenarios/login-test.yaml**
+
+```yaml
+scenarios:
+  - name: Sauce Demo Login
+    location: "https://www.saucedemo.com"
+    steps:
+      - input:
+          selector: "#user-name"
+          text: "standard_user"
+      - input:
+          selector: "#password"
+          text: "secret_sauce"
+      - click: "#login-button"
+      - wait: 2
+    actions:
+      - type: WAIT_FOR_SELECTOR
+        selector: ".inventory_list"
+        options:
+          visible: true
+      - type: SCREENSHOT
+        path: "screenshots/result.png"
+        options:
+          fullPage: true
+```
+
+### 2. Create a runner script
+
+**src/runner.ts**
+
+```typescript
+import { readYamlAndInterpret } from '@bloom-perf/yaml-pptr';
+import * as fs from 'fs';
+
+const yaml = fs.readFileSync('./scenarios/login-test.yaml', 'utf-8');
+
+fs.mkdirSync('./screenshots', { recursive: true });
+
+readYamlAndInterpret(yaml)
+  .then(() => console.log('Done!'))
+  .catch(console.error);
+```
+
+### 3. Run it
+
+```bash
+npx ts-node src/runner.ts
+```
+
+## YAML Reference
+
+### Scenario Configuration
+
+| Property | Type | Default | Description |
+| -------- | ---- | ------- | ----------- |
+| `name` | string | `Scenario N` | Scenario name |
+| `browser` | `chrome` \| `firefox` | `chrome` | Browser to use |
+| `run` | `PARALLEL` \| `SEQUENTIAL` | `PARALLEL` | Worker start strategy |
+| `initialDelaySeconds` | number | `0` | Delay before starting |
+| `workers` | number | `1` | Number of parallel workers |
+| `iterations` | number | `1` | Repetitions per worker |
+| `location` | string | - | Starting URL |
+| `steps` | array | - | Simplified syntax |
+| `actions` | array | - | Full syntax with options |
+
+### Steps (Simplified Syntax)
+
+#### click
+
+```yaml
+- click: "#submit-button"
+```
+
+#### input
+
+```yaml
+- input:
+    selector: "#username"
+    text: "myuser"
+```
+
+#### navigate
+
+```yaml
+- navigate: "http://example.com"
+- navigate: "$ENV_VAR"
+```
+
+#### wait
+
+```yaml
+- wait: 3  # seconds
+```
+
+#### waitForever
+
+```yaml
+- waitForever
+```
+
+### Actions (Full Syntax)
+
+Use `actions` instead of `steps` when you need advanced options.
+
+#### GOTO
+
+```yaml
+- type: GOTO
+  url: "http://example.com"
+  options:
+    timeout: 30000
+    waitUntil: networkidle0  # load | domcontentloaded | networkidle0 | networkidle2
+    referer: "http://referrer.com"
+```
+
+#### CLICK
+
+```yaml
+- type: CLICK
+  selector: "#button"
+  options:
+    button: left     # left | right | middle
+    clickCount: 2    # double-click
+    delay: 100       # ms between mousedown/mouseup
+```
+
+#### TYPE
+
+```yaml
+- type: TYPE
+  selector: "#input"
+  text: "Hello"
+  options:
+    delay: 50  # ms between keystrokes
+```
+
+#### WAIT
+
+```yaml
+- type: WAIT
+  milliseconds: 2000
+```
+
+#### WAIT_FOR_SELECTOR
+
+```yaml
+- type: WAIT_FOR_SELECTOR
+  selector: ".loaded"
+  options:
+    visible: true
+    hidden: false
+    timeout: 5000
+```
+
+#### WAIT_FOR_TIMEOUT
+
+```yaml
+- type: WAIT_FOR_TIMEOUT
+  timeout: 1000
+```
+
+#### SCREENSHOT
+
+```yaml
+- type: SCREENSHOT
+  path: "screenshot.png"
+  options:
+    type: png          # png | jpeg
+    quality: 80        # jpeg quality (0-100)
+    fullPage: true
+    omitBackground: false
+    encoding: binary   # binary | base64
+    clip:
+      x: 0
+      y: 0
+      width: 800
+      height: 600
+```
+
+#### EVALUATE
+
+```yaml
+- type: EVALUATE
+  script: "document.title"
+```
+
+#### SET_VIEWPORT
+
+```yaml
+- type: SET_VIEWPORT
+  width: 1920
+  height: 1080
+```
+
+#### PAUSE
+
+```yaml
+- type: PAUSE  # Press Enter to continue
+```
+
+#### CLOSE
+
+```yaml
+- type: CLOSE
+```
+
+## Environment Variables
+
+Use `$VAR_NAME` syntax in `location` or `navigate`:
+
+```yaml
+location: "$BASE_URL"
+```
+
+```bash
+BASE_URL=https://example.com npx ts-node runner.ts
+```
+
+### Indexed Variables
+
+Assign different values to each worker using `$VAR[workerIndex]`:
+
+```yaml
+scenarios:
+  - name: Multi-URL Test
+    workers: 3
+    location: "$URLS[workerIndex]"
+    steps:
+      - wait: 2
+```
+
+```bash
+URLS="https://site1.com,https://site2.com,https://site3.com" npx ts-node runner.ts
+```
+
+Worker 0 gets `site1.com`, worker 1 gets `site2.com`, etc.
+
+## Load Testing Example
+
+```yaml
+scenarios:
+  - name: Load Test
+    run: PARALLEL
+    workers: 10
+    iterations: 5
+    location: "https://example.com"
+    steps:
+      - click: "#action-button"
+      - wait: 1
+```
+
+This runs 10 workers in parallel, each executing the scenario 5 times.
+
+## Development
+
+```bash
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Build
+npm run build
+```
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## License
+
+[Apache 2.0](https://opensource.org/licenses/Apache-2.0)

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";var B=Object.create;var b=Object.defineProperty;var P=Object.getOwnPropertyDescriptor;var j=Object.getOwnPropertyNames;var U=Object.getPrototypeOf,V=Object.prototype.hasOwnProperty;var _=(o,t)=>{for(var i in t)b(o,i,{get:t[i],enumerable:!0})},$=(o,t,i,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of j(t))!V.call(o,r)&&r!==i&&b(o,r,{get:()=>t[r],enumerable:!(n=P(t,r))||n.enumerable});return o};var T=(o,t,i)=>(i=o!=null?B(U(o)):{},$(t||!o||!o.__esModule?b(i,"default",{value:o,enumerable:!0}):i,o)),G=o=>$(b({},"__esModule",{value:!0}),o);var bt={};_(bt,{readYamlAndInterpret:()=>wt});module.exports=G(bt);var C=T(require("puppeteer"),1);var x=T(require("js-yaml"),1);var e=T(require("zod"),1),E=e.enum(["load","domcontentloaded","networkidle0","networkidle2"]),I=e.enum(["left","right","middle"]),M=e.enum(["chrome","firefox"]),N=e.object({timeout:e.number().optional(),waitUntil:e.union([E,E.array()]).optional(),referer:e.string().optional()}).optional(),D=e.object({type:e.literal("WAIT"),milliseconds:e.number()}),q=e.object({button:I.optional(),clickCount:e.number().optional(),delay:e.number().optional()}).optional(),H=e.object({delay:e.number().optional()}).optional(),K=e.object({visible:e.boolean().optional(),hidden:e.boolean().optional(),timeout:e.number().optional()}).optional(),J=e.object({type:e.enum(["png","jpeg"]).optional(),quality:e.number().optional(),fullPage:e.boolean().optional(),clip:e.object({x:e.number(),y:e.number(),width:e.number(),height:e.number()}).optional(),omitBackground:e.boolean().optional(),encoding:e.enum(["base64","binary"]).optional()}).optional(),Q=e.object({type:e.literal("GOTO"),url:e.string(),options:N}),Z=e.object({type:e.literal("CLICK"),selector:e.string(),options:q}),X=e.object({type:e.literal("TYPE"),selector:e.string(),text:e.string(),options:H}),Y=e.object({type:e.literal("WAIT_FOR_SELECTOR"),selector:e.string(),options:K}),tt=e.object({type:e.literal("WAIT_FOR_TIMEOUT"),timeout:e.number()}),et=e.object({type:e.literal("PAUSE")}),ot=e.object({type:e.literal("SCREENSHOT"),path:e.string(),options:J}),it=e.object({type:e.literal("EVALUATE"),script:e.union([e.string(),e.function()])}),nt=e.object({type:e.literal("SET_VIEWPORT"),width:e.number(),height:e.number()}),rt=e.object({type:e.literal("CLOSE")}),W=[Q,Z,X,Y,tt,et,ot,it,nt,rt,D];if(W.length===0)throw new Error("Le tableau des sch\xE9mas d'actions est vide.");var st=W,at=e.discriminatedUnion("type",st),ct=e.object({navigate:e.string()}),pt=e.literal("waitForever"),lt=e.object({wait:e.number()}),ut=e.object({click:e.string()}),gt=e.object({input:e.object({selector:e.string(),text:e.string()})}),St=e.union([ct,pt,lt,ut,gt]),dt=e.object({name:e.string().optional(),browser:M.optional(),run:e.enum(["PARALLEL","SEQUENTIAL"]).optional(),initialDelaySeconds:e.number().nonnegative().optional(),workers:e.number().positive().optional(),iterations:e.number().positive().optional(),location:e.string().optional(),steps:e.array(St).optional(),actions:e.array(at).optional()}),k=e.object({scenarios:e.array(dt)});var O=o=>{let t=x.load(o);return k.parse(t)};var S={debug(o){console.log(o)},info(o){console.log(o)},warn(o){console.log(o)},error(o){console.error(o)}};var v=class{envVarResolve;logger;constructor(t,i=S){this.envVarResolve=n=>{let r=n.startsWith("$")?n.substring(1):n;return t(r)},this.logger=i}resolve(t){return{scenarios:t.scenarios.map((i,n)=>this.resolveScenario(i,n+1))}}resolveScenario(t,i){this.logger.debug(`Resolving YAML scenario: ${JSON.stringify(t)}`);let n=[];t.location&&n.push(this.createNavigateAction(t.location)),t.steps&&n.push(...t.steps.map(s=>this.resolveStep(s))),t.actions&&n.push(...t.actions.map(s=>this.resolveAction(s)));let r=t.run==="SEQUENTIAL"?{delaySecondsBetweenWorkerInits:t.initialDelaySeconds||0}:{initialDelaySeconds:t.initialDelaySeconds||0};return{name:t.name||`Scenario ${i}`,browser:t.browser||"chrome",run:r,workers:t.workers||1,iterations:t.iterations||1,actions:n}}resolveStep(t){if(t==="waitForever")return this.logger.debug("Resolving step: waitForever"),{actionType:"WaitForever"};if("wait"in t)return this.logger.debug(`Resolving step: wait ${t.wait} seconds`),{actionType:"Wait",milliseconds:t.wait*1e3};if("navigate"in t)return this.logger.debug("Resolving step: navigate"),this.createNavigateAction(t.navigate);if("click"in t)return this.logger.debug(`Resolving step: click "${t.click}"`),{actionType:"CLICK",selector:t.click};if("input"in t)return this.logger.debug(`Resolving step: input into "${t.input.selector}"`),{actionType:"TYPE",selector:t.input.selector,text:t.input.text};throw new Error(`Unknown step format: ${JSON.stringify(t)}`)}resolveAction(t){switch(this.logger.debug(`Resolving action: ${JSON.stringify(t)}`),t.type){case"GOTO":return{actionType:"GOTO",url:this.resolveStringOrEnv(t.url),options:t.options};case"WAIT":return{actionType:"Wait",milliseconds:t.milliseconds*1e3};case"CLICK":return{actionType:"CLICK",selector:t.selector,options:t.options};case"TYPE":return{actionType:"TYPE",selector:t.selector,text:t.text,options:t.options};case"WAIT_FOR_SELECTOR":return{actionType:"WAIT_FOR_SELECTOR",selector:t.selector,options:t.options};case"WAIT_FOR_TIMEOUT":return{actionType:"WAIT_FOR_TIMEOUT",timeout:t.timeout};case"PAUSE":return{actionType:"PAUSE"};case"SCREENSHOT":return{actionType:"SCREENSHOT",path:this.resolveStringOrEnv(t.path),options:t.options};case"EVALUATE":return{actionType:"EVALUATE",script:t.script};case"SET_VIEWPORT":return{actionType:"SET_VIEWPORT",width:t.width,height:t.height};case"CLOSE":return{actionType:"CLOSE"};default:return t}}createNavigateAction(t){return{actionType:"Navigate",location:this.resolveUrlOrEnv(t)}}resolveUrlOrEnv(t){let i="[workerIndex]";if(t.startsWith("$")){if(t.endsWith(i)){this.logger.debug(`Resolving indexed environment variable: "${t}"`);let n=t.substring(1,t.length-i.length);return{workerIndex:this.envVarResolve(n).split(",").map(c=>c.trim())}}return this.logger.debug(`Resolving environment variable: "${t}"`),{url:this.envVarResolve(t.substring(1))}}return this.logger.debug(`Using direct URL: "${t}"`),{url:t}}resolveStringOrEnv(t){return t.startsWith("$")?(this.logger.debug(`Resolving environment variable: "${t}"`),this.envVarResolve(t.substring(1))):t}};function At(o,t){let i=t||"png";return o.endsWith(".png")||o.endsWith(".jpeg")||o.endsWith(".jpg")||o.endsWith(".webp")?o:`${o}.${i}`}var R=async(o,t,i=S)=>await ht(t.workers,t.name,async n=>{for(let r=0;r<t.iterations;r++){let s=t.run;"delaySecondsBetweenWorkerInits"in s?(i.info(`Scenario "${t.name}" (worker ${n}) > Choosing SEQUENTIAL start with ${s.delaySecondsBetweenWorkerInits} seconds between workers`),await new Promise(p=>setTimeout(p,s.delaySecondsBetweenWorkerInits*n*1e3))):(i.info(`Scenario "${t.name}" (worker ${n}) > Choosing PARALLEL start with ${s.initialDelaySeconds} seconds of initial delay`),await new Promise(p=>setTimeout(p,s.initialDelaySeconds*1e3)));let c=await o.newPage();await yt(t.name,t.actions,c,n,i),await c.close()}},i),ht=async(o,t,i,n=S)=>Promise.all(Array.from({length:o},async(r,s)=>{try{n.info(`Scenario "${t}" (worker ${s}) started.`),await i(s)}catch(c){n.error(`Scenario ${t} (worker ${s}) failed: ${c}`)}})),yt=async(o,t,i,n,r=S)=>{for(let s of t){let{actionType:c}=s;switch(c){case"Navigate":let p=s;"url"in p.location?(r.info(`Scenario "${o}" (worker ${n}) > Navigating to location "${p.location.url}"`),await i.goto(p.location.url)):(r.info(`Scenario "${o}" (worker ${n}) > Navigating to indexed location "${p.location.workerIndex[n]}"`),await i.goto(p.location.workerIndex[n]));break;case"Wait":let y=s;r.info(`Scenario "${o}" (worker ${n}) > Waiting ${y.milliseconds} milliseconds...`),await i.evaluate(h=>new Promise(f=>setTimeout(f,h)),y.milliseconds);break;case"WaitForever":for(r.info(`Scenario "${o}" (worker ${n}) > Waiting forever...`);;)await new Promise(h=>setTimeout(h,3600*1e3));break;case"GOTO":let a=s;r.info(`Scenario "${o}" (worker ${n}) > GOTO "${a.url}"`);let l={timeout:a.options?.timeout,waitUntil:a.options?.waitUntil,referer:a.options?.referer};await i.goto(a.url,l);break;case"CLICK":let u=s;r.info(`Scenario "${o}" (worker ${n}) > CLICK on "${u.selector}"`);let d={button:u.options?.button,clickCount:u.options?.clickCount,delay:u.options?.delay};await i.click(u.selector,d);break;case"TYPE":let m=s;r.info(`Scenario "${o}" (worker ${n}) > TYPE into "${m.selector}"`),await i.type(m.selector,m.text,m.options);break;case"WAIT_FOR_SELECTOR":let A=s;r.info(`Scenario "${o}" (worker ${n}) > WAIT_FOR_SELECTOR "${A.selector}"`),await i.waitForSelector(A.selector,A.options);break;case"WAIT_FOR_TIMEOUT":let z=s;r.info(`Scenario "${o}" (worker ${n}) > WAIT_FOR_TIMEOUT ${z.timeout} milliseconds`),await i.evaluate(h=>new Promise(f=>setTimeout(f,h)),z.timeout);break;case"PAUSE":r.info(`Scenario "${o}" (worker ${n}) > PAUSE, press Enter to continue...`),await new Promise(h=>{process.stdin.resume(),process.stdin.once("data",()=>{process.stdin.pause(),h()})});break;case"SCREENSHOT":let g=s;r.info(`Scenario "${o}" (worker ${n}) > SCREENSHOT "${g.path}"`);let F={path:At(g.path,g.options?.type),type:g.options?.type,quality:g.options?.quality,fullPage:g.options?.fullPage,clip:g.options?.clip,omitBackground:g.options?.omitBackground,encoding:g.options?.encoding};await i.screenshot(F);break;case"EVALUATE":let L=s;r.info(`Scenario "${o}" (worker ${n}) > EVALUATE script`),await i.evaluate(L.script);break;case"SET_VIEWPORT":let w=s;r.info(`Scenario "${o}" (worker ${n}) > SET_VIEWPORT width=${w.width}, height=${w.height}`),await i.setViewport({width:w.width,height:w.height});break;case"CLOSE":r.info(`Scenario "${o}" (worker ${n}) > CLOSE page`),await i.close();break;default:throw new Error(`Unhandled action type "${c}" while evaluating scenario "${o}" on worker ${n}`)}}};var wt=async(o,t={},i=S)=>{let n=O(o),s=new v(a=>{let l=process.env[a];if(i.debug(`Resolving env variable "${a}" with value ***`),l)return l;throw new Error(`Tried to resolve env variable ${a} but was empty.`)},i).resolve(n),c={};for(let a of s.scenarios){let l=a.browser||"chrome";c[l]||(c[l]=[]),c[l]?.push(a)}let p=["chrome","firefox"],y=Object.entries(c).map(async([a,l])=>{if(!l)return;if(!p.includes(a)){console.error(`Navigateur non support\xE9: ${a}. Les navigateurs support\xE9s sont: ${p.join(", ")}`);return}let u=["--no-sandbox","--disable-setuid-sandbox","--disable-dev-shm-usage","--disable-accelerated-2d-canvas","--disable-gpu","--ignore-certificate-errors"];a==="chrome"&&u.push("--start-maximized"),a==="firefox"&&u.push("--private");let d=t[a],m=!1;d||(d=await C.launch({headless:!1,channel:a,acceptInsecureCerts:!0,args:u}),m=!0);try{for(let A of l)await R(d,A,i)}catch(A){console.error(`Erreur lors de l'ex\xE9cution des sc\xE9narios pour ${a}:`,A)}finally{m&&d&&await d.close()}});await Promise.all(y)};0&&(module.exports={readYamlAndInterpret});

package/dist/src/core/logger.d.ts

@@ -0,0 +1,7 @@
+export type YpLogger = {
+    debug(str: string): void;
+    info(str: string): void;
+    warn(str: string): void;
+    error(str: string): void;
+};
+export declare const dumbLogger: YpLogger;

package/dist/src/core/model.d.ts

@@ -0,0 +1,130 @@
+export declare enum ActionType {
+    Navigate = "Navigate",
+    WaitForever = "WaitForever",
+    Wait = "Wait",
+    Goto = "GOTO",
+    Click = "CLICK",
+    Type = "TYPE",
+    WaitForSelector = "WAIT_FOR_SELECTOR",
+    WaitForTimeout = "WAIT_FOR_TIMEOUT",
+    Pause = "PAUSE",
+    Screenshot = "SCREENSHOT",
+    Close = "CLOSE",
+    Evaluate = "EVALUATE",
+    SetViewport = "SET_VIEWPORT"
+}
+export type UrlOrArray = {
+    url: string;
+} | {
+    workerIndex: string[];
+};
+export interface BaseAction {
+    actionType: ActionType;
+}
+export interface NavigateAction extends BaseAction {
+    actionType: ActionType.Navigate;
+    location: UrlOrArray;
+}
+export interface WaitForeverAction extends BaseAction {
+    actionType: ActionType.WaitForever;
+}
+export interface WaitAction extends BaseAction {
+    actionType: ActionType.Wait;
+    milliseconds: number;
+}
+export type WaitUntil = 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2';
+export type MouseButton = 'left' | 'right' | 'middle';
+export interface GotoOptions {
+    timeout?: number;
+    waitUntil?: WaitUntil | WaitUntil[];
+    referer?: string;
+}
+export interface ClickOptions {
+    button?: MouseButton;
+    clickCount?: number;
+    delay?: number;
+}
+export interface TypeOptions {
+    delay?: number;
+}
+export interface WaitForSelectorOptions {
+    visible?: boolean;
+    hidden?: boolean;
+    timeout?: number;
+}
+export interface ScreenshotOptions {
+    type?: 'png' | 'jpeg';
+    quality?: number;
+    fullPage?: boolean;
+    clip?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    omitBackground?: boolean;
+    encoding?: 'base64' | 'binary';
+}
+export interface GotoAction extends BaseAction {
+    actionType: ActionType.Goto;
+    url: string;
+    options?: GotoOptions;
+}
+export interface ClickAction extends BaseAction {
+    actionType: ActionType.Click;
+    selector: string;
+    options?: ClickOptions;
+}
+export interface TypeAction extends BaseAction {
+    actionType: ActionType.Type;
+    selector: string;
+    text: string;
+    options?: TypeOptions;
+}
+export interface WaitForSelectorAction extends BaseAction {
+    actionType: ActionType.WaitForSelector;
+    selector: string;
+    options?: WaitForSelectorOptions;
+}
+export interface WaitForTimeoutAction extends BaseAction {
+    actionType: ActionType.WaitForTimeout;
+    timeout: number;
+}
+export interface PauseAction extends BaseAction {
+    actionType: ActionType.Pause;
+}
+export interface ScreenshotAction extends BaseAction {
+    actionType: ActionType.Screenshot;
+    path: string;
+    options?: ScreenshotOptions;
+}
+export interface CloseAction extends BaseAction {
+    actionType: ActionType.Close;
+}
+export interface EvaluateAction extends BaseAction {
+    actionType: ActionType.Evaluate;
+    script: string | ((...args: any[]) => any);
+}
+export interface SetViewportAction extends BaseAction {
+    actionType: ActionType.SetViewport;
+    width: number;
+    height: number;
+}
+export type Action = NavigateAction | WaitForeverAction | WaitAction | GotoAction | ClickAction | TypeAction | WaitForSelectorAction | WaitForTimeoutAction | PauseAction | ScreenshotAction | CloseAction | EvaluateAction | SetViewportAction;
+export type Run = {
+    initialDelaySeconds: number;
+} | {
+    delaySecondsBetweenWorkerInits: number;
+};
+export type SupportedBrowser = 'chrome' | 'firefox';
+export type Scenario = {
+    name: string;
+    browser: SupportedBrowser;
+    run: Run;
+    workers: number;
+    iterations: number;
+    actions: Action[];
+};
+export type Root = {
+    scenarios: Scenario[];
+};