Add JavaScript CI and release checks

Author: auscaster

.github/workflows/ci.yml

@@ -7,7 +7,7 @@ on:
   pull_request:
 
 jobs:
-  test:
+  python:
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
@@ -43,3 +43,42 @@ jobs:
 
       - name: Check package metadata
         run: python -m twine check dist/*
+
+  javascript:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version:
+          - "20"
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+          cache-dependency-path: js/package-lock.json
+
+      - name: Install JS dependencies
+        working-directory: js
+        run: npm ci
+
+      - name: Run JS type checks
+        working-directory: js
+        run: npm run check
+
+      - name: Run JS tests
+        working-directory: js
+        run: npm run test
+
+      - name: Run JS live integration test
+        working-directory: js
+        run: SOURCEY_TEST_SITE_URL=https://sourcey.com/docs npm run test
+
+      - name: Build JS package
+        working-directory: js
+        run: npm run build

CONTRIBUTING.md

@@ -2,34 +2,59 @@
 
 ## Local Setup
 
+Python:
+
 ```bash
 python3 -m venv .venv
 . .venv/bin/activate
 python -m pip install -U pip
 python -m pip install -e .[dev] build twine
 ```
 
+JavaScript:
+
+```bash
+cd js
+npm install
+```
+
 ## Test And Verify
 
-Run the full local test suite:
+Run the Python test suite:
 
 ```bash
 PYTHONPATH=src pytest -q
 ```
 
-Run the live Sourcey integration test against a published docs site:
+Run the Python live Sourcey integration test against a published docs site:
 
 ```bash
 SOURCEY_TEST_SITE_URL=https://sourcey.com/docs PYTHONPATH=src pytest tests/integration_tests/test_live_retriever.py -q
 ```
 
-Build and validate the distribution artefacts:
+Build and validate the Python distribution artefacts:
 
 ```bash
 python -m build
 python -m twine check dist/*
 ```
 
+Run the JavaScript checks:
+
+```bash
+cd js
+npm run check
+npm run test
+npm run build
+```
+
+Run the JavaScript live Sourcey integration test:
+
+```bash
+cd js
+SOURCEY_TEST_SITE_URL=https://sourcey.com/docs npm run test
+```
+
 ## Release Notes
 
 - Keep `pyproject.toml` and `src/langchain_sourcey/retrievers.py` on the same
@@ -38,3 +63,7 @@ python -m twine check dist/*
   pass.
 - If package metadata changes, confirm the public repository and issue tracker
   URLs resolve before publishing.
+- Keep `js/package.json` and `js/src/retriever.ts` on the same package version
+  so the JS `User-Agent` stays accurate.
+- Publish the JS package from `js/` only after `npm run check`, `npm run test`,
+  the live JS test, and `npm run build` pass.