Add River for JavaScript and TypeScript

.github/actions/setup-js/action.yaml

@@ -0,0 +1,36 @@
+name: Set up JavaScript workspace
+description: >-
+  Install pnpm and an official Node.js 26 build, prove that it has native
+  Temporal, and install the locked dependencies of the workspace in `js/`.
+
+inputs:
+  node-version:
+    default: ""
+    description: >-
+      Node.js version to use instead of the one in `js/.node-version`.
+
+runs:
+  using: composite
+  steps:
+    - uses: pnpm/action-setup@v6
+      with:
+        package_json_file: js/package.json
+
+    - uses: actions/setup-node@v6
+      with:
+        cache: pnpm
+        cache-dependency-path: js/pnpm-lock.yaml
+        node-version: ${{ inputs.node-version }}
+        node-version-file: ${{ inputs.node-version == '' && 'js/.node-version' || '' }}
+
+    # Official Node.js 26 binaries enable Temporal; some builds from source do
+    # not, and River refuses to run without it.
+    - name: Require native Temporal
+      shell: bash
+      run: |
+        node --version
+        test "$(node -p 'typeof Temporal')" = object
+
+    - run: pnpm install --frozen-lockfile
+      shell: bash
+      working-directory: js

.github/dependabot.yml

@@ -17,7 +17,10 @@ updates:
     schedule:
       interval: "weekly"
   - package-ecosystem: "github-actions"
-    directory: "/"
+    # The JavaScript workflows' composite actions live under .github/actions.
+    directories:
+      - "/"
+      - "/.github/actions/*"
     schedule:
       interval: "weekly"
   - package-ecosystem: "gomod"
@@ -30,3 +33,31 @@ updates:
           - "patch"
     schedule:
       interval: "weekly"
+  # Routine minor and patch updates to the JavaScript workspace arrive as one
+  # grouped pull request per dependency type; major updates stay separate so
+  # each can be reviewed on its own. Exact pins in package.json (Prisma, the
+  # TypeScript-next preview, pnpm overrides) stay exact because `increase`
+  # rewrites the pinned version rather than widening it.
+  - package-ecosystem: "npm"
+    directory: "/js"
+    cooldown:
+      default-days: 7
+    groups:
+      development-dependencies:
+        dependency-type: "development"
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+      production-dependencies:
+        dependency-type: "production"
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+    open-pull-requests-limit: 10
+    schedule:
+      interval: "monthly"
+    versioning-strategy: increase

.github/workflows/js.yaml

@@ -0,0 +1,231 @@
+name: JavaScript
+
+on:
+  # Filter the whole workflow so unrelated changes don't create skipped
+  # matrix jobs. Keep both events' paths in sync. Release tags always run it.
+  push:
+    branches:
+      - master
+    paths:
+      - ".github/actions/setup-js/**"
+      - ".github/workflows/js.yaml"
+      - "Makefile"
+      - "js/**"
+      - "riverdriver/**/*.sql"
+    tags: ["v*"]
+  pull_request:
+    paths:
+      - ".github/actions/setup-js/**"
+      - ".github/workflows/js.yaml"
+      - "Makefile"
+      - "js/**"
+      - "riverdriver/**/*.sql"
+
+concurrency:
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+  group: ${{ github.workflow }}-${{ github.ref }}
+
+permissions:
+  contents: read
+
+# The full runtime deliberately requires native Temporal from Node 26. Every
+# job installs the official build selected by js/.node-version (or the matrix)
+# and asserts `typeof Temporal` before doing anything else.
+
+defaults:
+  run:
+    working-directory: js
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - uses: ./.github/actions/setup-js
+
+      - run: pnpm run build:all
+
+      - run: pnpm run typecheck:tests
+
+      - run: pnpm run typecheck:next
+
+      # Compares the generated mirror with River's canonical migration sources.
+      - run: pnpm run verify:migrations
+
+      - run: pnpm run api:check
+
+      - run: pnpm run docs:api
+
+      - run: pnpm run docs:snippets
+
+      - run: pnpm run migration:legacy
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - uses: ./.github/actions/setup-js
+
+      # Type-aware lint reads `riverqueue` through its built declarations.
+      - run: pnpm run build
+
+      - run: pnpm run lint
+
+      - run: pnpm run fmt:check
+
+      - run: pnpm run license:check
+
+      - run: pnpm audit
+
+  packages:
+    name: Package archives
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    # The packed `node:test` suite runs its PostgreSQL tests against this
+    # database, and RIVER_REQUIRE_POSTGRES makes them fail instead of skip
+    # when DATABASE_URL is missing.
+    services:
+      postgres:
+        image: postgres:18
+        env:
+          POSTGRES_DB: river_test
+          POSTGRES_PASSWORD: postgres
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 5432:5432
+
+    env:
+      DATABASE_URL: postgres://postgres:postgres@localhost:5432/river_test?sslmode=disable
+      RIVER_REQUIRE_POSTGRES: "1"
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - uses: ./.github/actions/setup-js
+
+      - run: pnpm run build:all
+
+      # The packed examples that need a database use its default schema.
+      - run: node cli/dist/bin.js migrate-up --database-url "$DATABASE_URL"
+
+      - run: pnpm run package:check
+
+  examples:
+    name: Examples
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    services:
+      postgres:
+        image: postgres:18
+        env:
+          POSTGRES_DB: river_test
+          POSTGRES_PASSWORD: postgres
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 5432:5432
+
+    env:
+      DATABASE_URL: postgres://postgres:postgres@localhost:5432/river_test?sslmode=disable
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - uses: ./.github/actions/setup-js
+
+      - run: pnpm run build:all
+
+      - run: node cli/dist/bin.js migrate-up --database-url "$DATABASE_URL"
+
+      - run: pnpm run package:examples
+
+  test:
+    name: Test (Node ${{ matrix.node-version || 'from .node-version' }})
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    strategy:
+      fail-fast: false
+      matrix:
+        # The minimum supported release and the current Node 26 release.
+        node-version: ["26.0.0", ""]
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - uses: ./.github/actions/setup-js
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      # The unit tests import the other workspace packages through their
+      # build output, and worker threads run compiled handler modules.
+      - run: pnpm run build:all
+
+      - run: pnpm run test
+
+  test_integration:
+    name: Test (integration, PostgreSQL ${{ matrix.postgres-version }})
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    strategy:
+      fail-fast: false
+      matrix:
+        postgres-version: [14, 15, 16, 17, 18]
+
+    services:
+      postgres:
+        image: postgres:${{ matrix.postgres-version }}
+        env:
+          POSTGRES_DB: river_test
+          POSTGRES_PASSWORD: postgres
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 5432:5432
+
+    env:
+      TEST_DATABASE_URL: postgres://postgres:postgres@localhost:5432/river_test?sslmode=disable
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - uses: ./.github/actions/setup-js
+
+      - run: pnpm run build:all
+
+      - run: node cli/dist/bin.js migrate-up --database-url "$TEST_DATABASE_URL"
+
+      - run: pnpm run test:integration