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

Usage

sentinelqa playwright

If you want to run without installing, use:

npx @sentinelqa/uploader playwright

Minimal GitLab CI (preserves test exit code)

e2e:
  image: node:20
  script:
    - npm ci
    - npx playwright install --with-deps
    - |
      set +e
      npx playwright test --reporter=line,json --output=test-results
      TEST_EXIT=$?
      export SENTINEL_TEST_EXIT_CODE=$TEST_EXIT
      npx @sentinelqa/uploader playwright
      exit $TEST_EXIT
  artifacts:
    when: always
    paths:
      - playwright-report/
      - test-results/

Minimal GitHub Actions (preserves test 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: |
          set +e
          npx playwright test --reporter=line,json --output=test-results
          TEST_EXIT=$?
          echo "SENTINEL_TEST_EXIT_CODE=$TEST_EXIT" >> $GITHUB_ENV
          npx @sentinelqa/uploader playwright
          exit $TEST_EXIT

Required Environment Variables

SENTINEL_TOKEN (project ingest token)
SENTINEL_URL (optional; defaults to https://app.sentinelqa.com)
SENTINEL_TEST_EXIT_CODE (optional; used to preserve CI test exit code when running in the same job)

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.