Package Exports

@sentinelqa/uploader
@sentinelqa/uploader/dist/cli.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@sentinelqa/uploader) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@sentinelqa/uploader

Sentinel uploader CLI for Playwright CI artifacts.

Install

npm i -D @sentinelqa/uploader

Or run directly:

npx @sentinelqa/uploader playwright -- --help

Usage

sentinelqa playwright -- <playwright args...>

If you want to run without installing, use:

npx @sentinelqa/uploader playwright -- <playwright args...>

Universal Wrapper (any command)

npx @sentinelqa/uploader run -- <your test command>

Minimal GitLab CI (single command, preserves exit code)

e2e:
  image: node:20
  script:
    - npm ci
    - npx playwright install --with-deps
    - npx @sentinelqa/uploader playwright -- --reporter=line,json --output=test-results
  artifacts:
    when: always
    paths:
      - playwright-report/
      - test-results/

Minimal GitHub Actions (single command, preserves exit code)

name: E2E
on: [push]
jobs:
  e2e:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "20"
      - run: npm ci
      - run: npx playwright install --with-deps
      - run: npx @sentinelqa/uploader playwright -- --reporter=line,json --output=test-results

Required Environment Variables

SENTINEL_TOKEN (project ingest token)
SENTINEL_URL (optional; defaults to https://app.sentinelqa.com)
SENTINEL_TEST_EXIT_CODE (optional; set automatically by the wrapper)

Optional: BYO S3 (Advanced)

Set these to upload directly to your own bucket:

SENTINEL_S3_ENDPOINT (optional for AWS)
SENTINEL_S3_REGION
SENTINEL_S3_BUCKET
SENTINEL_S3_PREFIX (optional)
SENTINEL_S3_ACCESS_KEY_ID
SENTINEL_S3_SECRET_ACCESS_KEY

Troubleshooting

Missing artifacts

Ensure Playwright outputs are present:
- playwright-report/report.json
- playwright-report/
- test-results/

401 Unauthorized

Check SENTINEL_TOKEN and project permissions.

No CI metadata

The uploader detects GitLab or GitHub. If running locally, set the CI env vars or run in CI.

No failed tests

Ensure @playwright/test is installed and the JSON reporter is enabled.

BYO uploads failing

Verify SENTINEL_S3_* values and permissions.