cbrowser 8.0.0 → 8.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +55 -0
- package/dist/mcp-server-remote.js +1 -1
- package/examples/ci-cd/README.md +47 -0
- package/package.json +6 -2
package/README.md
CHANGED
|
@@ -829,6 +829,61 @@ CBrowser uses optimized Chromium launch flags for fast startup:
|
|
|
829
829
|
|
|
830
830
|
---
|
|
831
831
|
|
|
832
|
+
## CI/CD Integration
|
|
833
|
+
|
|
834
|
+
CBrowser provides native integrations for CI/CD pipelines. Add browser automation, visual regression, and NL test validation to every pull request.
|
|
835
|
+
|
|
836
|
+
### GitHub Actions
|
|
837
|
+
|
|
838
|
+
Use the official GitHub Action for zero-config setup:
|
|
839
|
+
|
|
840
|
+
```yaml
|
|
841
|
+
# .github/workflows/cbrowser.yml
|
|
842
|
+
name: CBrowser Tests
|
|
843
|
+
on: [pull_request]
|
|
844
|
+
|
|
845
|
+
jobs:
|
|
846
|
+
test:
|
|
847
|
+
runs-on: ubuntu-latest
|
|
848
|
+
steps:
|
|
849
|
+
- uses: actions/checkout@v4
|
|
850
|
+
- uses: alexandriashai/cbrowser@v8
|
|
851
|
+
with:
|
|
852
|
+
test-file: tests/e2e/checkout.txt
|
|
853
|
+
sensitivity: strict
|
|
854
|
+
```
|
|
855
|
+
|
|
856
|
+
Available inputs: `test-file`, `url`, `command`, `browsers`, `sensitivity`.
|
|
857
|
+
|
|
858
|
+
### GitLab CI
|
|
859
|
+
|
|
860
|
+
Include the reusable component:
|
|
861
|
+
|
|
862
|
+
```yaml
|
|
863
|
+
include:
|
|
864
|
+
- component: gitlab.com/alexandriashai/cbrowser/.gitlab-ci-component.yml
|
|
865
|
+
inputs:
|
|
866
|
+
test-file: tests/e2e/checkout.txt
|
|
867
|
+
sensitivity: strict
|
|
868
|
+
```
|
|
869
|
+
|
|
870
|
+
### Docker
|
|
871
|
+
|
|
872
|
+
Run CBrowser in any CI system using the Docker image:
|
|
873
|
+
|
|
874
|
+
```bash
|
|
875
|
+
docker run --rm -v $(pwd)/tests:/work/tests ghcr.io/alexandriashai/cbrowser:latest \
|
|
876
|
+
test-suite tests/checkout.txt --output results.json --html
|
|
877
|
+
```
|
|
878
|
+
|
|
879
|
+
### Exit Codes
|
|
880
|
+
|
|
881
|
+
CBrowser exits with code 1 on test failure, making it compatible with any CI system that uses exit codes to determine pass/fail status.
|
|
882
|
+
|
|
883
|
+
For detailed setup guides and examples, see [`examples/ci-cd/`](examples/ci-cd/).
|
|
884
|
+
|
|
885
|
+
---
|
|
886
|
+
|
|
832
887
|
## Examples
|
|
833
888
|
|
|
834
889
|
See the [`examples/`](examples/) directory:
|
|
@@ -1067,7 +1067,7 @@ async function startRemoteMcpServer() {
|
|
|
1067
1067
|
const apiKeyAuthEnabled = apiKeys !== null && apiKeys.size > 0;
|
|
1068
1068
|
const auth0Enabled = auth0 !== null;
|
|
1069
1069
|
const authEnabled = apiKeyAuthEnabled || auth0Enabled;
|
|
1070
|
-
console.log(`Starting CBrowser Remote MCP Server v8.
|
|
1070
|
+
console.log(`Starting CBrowser Remote MCP Server v8.1.0...`);
|
|
1071
1071
|
console.log(`Mode: ${sessionMode}`);
|
|
1072
1072
|
console.log(`Auth: ${authEnabled ? "enabled" : "disabled (open access)"}`);
|
|
1073
1073
|
if (apiKeyAuthEnabled) {
|
package/examples/ci-cd/README.md
CHANGED
|
@@ -8,6 +8,53 @@ Add CBrowser checks to your existing CI pipeline so every pull request is automa
|
|
|
8
8
|
- A **staging URL** that reflects the PR branch (set as a CI variable)
|
|
9
9
|
- CBrowser baselines captured at least once before the first CI run
|
|
10
10
|
|
|
11
|
+
## GitHub Action
|
|
12
|
+
|
|
13
|
+
The official GitHub Action provides zero-config CBrowser in any workflow:
|
|
14
|
+
|
|
15
|
+
```yaml
|
|
16
|
+
# .github/workflows/cbrowser.yml
|
|
17
|
+
name: CBrowser Tests
|
|
18
|
+
on: [pull_request]
|
|
19
|
+
|
|
20
|
+
jobs:
|
|
21
|
+
test:
|
|
22
|
+
runs-on: ubuntu-latest
|
|
23
|
+
steps:
|
|
24
|
+
- uses: actions/checkout@v4
|
|
25
|
+
- uses: alexandriashai/cbrowser@v8
|
|
26
|
+
with:
|
|
27
|
+
test-file: tests/e2e/checkout.txt
|
|
28
|
+
sensitivity: strict
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Available inputs: `test-file`, `url`, `command`, `browsers`, `sensitivity`.
|
|
32
|
+
|
|
33
|
+
## Docker Image
|
|
34
|
+
|
|
35
|
+
Run CBrowser in any CI system using the official Docker image:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
docker run --rm \
|
|
39
|
+
-v $(pwd)/tests:/work/tests \
|
|
40
|
+
ghcr.io/alexandriashai/cbrowser:latest \
|
|
41
|
+
test-suite tests/checkout.txt --output results.json --html
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
The image includes Chromium and all dependencies. Mount your test directory and collect results as artifacts.
|
|
45
|
+
|
|
46
|
+
## GitLab CI Component
|
|
47
|
+
|
|
48
|
+
Include the reusable GitLab CI component:
|
|
49
|
+
|
|
50
|
+
```yaml
|
|
51
|
+
include:
|
|
52
|
+
- component: gitlab.com/alexandriashai/cbrowser/.gitlab-ci-component.yml
|
|
53
|
+
inputs:
|
|
54
|
+
test-file: tests/e2e/checkout.txt
|
|
55
|
+
sensitivity: strict
|
|
56
|
+
```
|
|
57
|
+
|
|
11
58
|
## Quick start
|
|
12
59
|
|
|
13
60
|
1. Copy the workflow file for your platform into your repository:
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "cbrowser",
|
|
3
|
-
"version": "8.
|
|
3
|
+
"version": "8.1.0",
|
|
4
4
|
"description": "AI-powered browser automation with constitutional safety, AI visual regression, persona testing, and natural language test suites. Modular architecture for visual, testing, analysis, and performance modules.",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -72,7 +72,11 @@
|
|
|
72
72
|
"screenshot-comparison",
|
|
73
73
|
"cross-browser-testing",
|
|
74
74
|
"modular-architecture",
|
|
75
|
-
"performance-testing"
|
|
75
|
+
"performance-testing",
|
|
76
|
+
"session-management",
|
|
77
|
+
"responsive-testing",
|
|
78
|
+
"chaos-testing",
|
|
79
|
+
"ab-testing"
|
|
76
80
|
],
|
|
77
81
|
"author": "WF Media",
|
|
78
82
|
"license": "MIT",
|