Refresh Project

.github/workflows/ci.yml

@@ -0,0 +1,93 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+
+jobs:
+  # tsdown/rolldown require Node >=22.18 to run; vitest requires >=20. The
+  # published library itself only requires Node >=18 (see `engines` in
+  # package.json) — that promise is checked separately by `dist-smoke` below,
+  # against the pre-built output, without needing the build tooling to run.
+  test:
+    name: Lint, typecheck, build & unit test (Node ${{ matrix.node-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [ 22, 24, latest ]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+      - run: npm ci
+      - run: npm run lint
+      - run: npm run typecheck
+      - run: npm run build
+      - run: npm run test:unit
+      - if: matrix.node-version == 'latest'
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist
+          retention-days: 1
+
+  dist-smoke:
+    name: Published dist works on Node ${{ matrix.node-version }}
+    runs-on: ubuntu-latest
+    needs: test
+    strategy:
+      matrix:
+        node-version: [ 18, 20 ]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+      - run: npm ci --omit=dev
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+      - run: |
+          node -e "
+            const WPAPI = require('./dist/index.cjs');
+            const wp = new WPAPI({ endpoint: 'http://localhost/wp-json' });
+            if (typeof wp.posts !== 'function') throw new Error('CJS entry did not bootstrap');
+            if (typeof WPAPI.transport.get !== 'function') throw new Error('CJS entry has no bound transport');
+          "
+          node --input-type=module -e "
+            import WPAPI from './dist/index.mjs';
+            const wp = new WPAPI({ endpoint: 'http://localhost/wp-json' });
+            if (typeof wp.posts !== 'function') throw new Error('ESM entry did not bootstrap');
+            if (typeof WPAPI.transport.get !== 'function') throw new Error('ESM entry has no bound transport');
+          "
+          node -e "
+            try { require('./dist/superagent.cjs'); }
+            catch (e) { if (/wpapi.superagent was removed/.test(e.message)) process.exit(0); throw e; }
+            throw new Error('superagent stub did not throw its migration error');
+          "
+
+  integration:
+    name: Integration tests (wp-env)
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - run: npm run env:start
+      - run: npm run env:seed
+      - run: npm run test:integration
+      # `npm run env:logs` defaults to `--watch`, which never exits; pass
+      # `--no-watch` directly so this step prints once and completes.
+      - if: always()
+        run: npx @wordpress/env logs development --no-watch
+      - if: always()
+        run: npm run env:stop

.github/workflows/release.yml

@@ -0,0 +1,30 @@
+name: Release
+
+# Scaffolded in Phase 1, replacing the local `release-npm` script; not yet
+# exercised until publishing resumes (requires an `NPM_TOKEN` secret).
+on:
+  release:
+    types: [ published ]
+
+jobs:
+  publish:
+    name: Build, test & publish to npm
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          # tsdown/rolldown require Node >=22.18 to run the build itself.
+          node-version: 22
+          cache: npm
+          registry-url: https://registry.npmjs.org
+      - run: npm ci
+      - run: npm run lint
+      - run: npm run typecheck
+      - run: npm run build
+      - run: npm run test:unit
+      - run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -45,8 +45,5 @@ documentation/index.html
 *.sublime-*
 .ruby-version
 
-# Built files (for use in browser)
-browser/
-
-# Consuming applications should maintain their own lockfile.
-package-lock.json
+# Built files (tsdown output: ESM/CJS/UMD + .d.ts)
+dist/

.prettierrc.json

@@ -0,0 +1,7 @@
+{
+	"useTabs": true,
+	"singleQuote": true,
+	"semi": true,
+	"trailingComma": "all",
+	"printWidth": 90
+}

.wp-env.json

@@ -0,0 +1,15 @@
+{
+	"port": 2747,
+	"testsEnvironment": false,
+	"config": {
+		"SCRIPT_DEBUG": true,
+		"WP_DEBUG_DISPLAY": false,
+		"WP_DEBUG": true,
+		"WP_DEVELOPMENT_MODE": "plugin"
+	},
+	"plugins": [
+		".",
+		"https://downloads.wordpress.org/plugin/query-monitor.zip",
+		"https://github.com/WP-API/Basic-Auth/archive/refs/heads/master.zip"
+	]
+}

CHANGELOG.md

@@ -1,8 +1,10 @@
 # Changelog
 
-## v2.0.0 [**alpha**] _Second Toughest in the Infants_
+## v2.0.0 [**unreleased**] _Second Toughest in the Infants_
 - **BREAKING**: "Node-style" error-first callbacks (_e.g._ `.get( ( err, data ) => {} )`) are no longer supported. All transport request methods return Promises.
-- **BREAKING**: The module exported as `wpapi` no longer includes HTTP methods. Install `superagent` as a peer dependency and `require( 'wpapi/superagent' )` in order to make HTTP requests.
+- **BREAKING**: The minimum supported Node.js version is now v18; Internet Explorer is no longer supported.
+- **BREAKING**: HTTP requests are made with the native `fetch` API. The superagent transport and the `wpapi/superagent` entrypoint introduced in the v2 alphas are removed; the default `wpapi` export makes HTTP requests out of the box again, with no additional dependencies. `wpapi/fetch` remains as an alias for the default export.
+- **BREAKING**: Media uploads use native `FormData`/`Blob`. `.file()` accepts a file path (Node), a `Buffer` or `Blob` plus a file name, or a `File` object; streams are no longer supported. The multipart part's content type is no longer inferred from the file name (WordPress determines the type server-side from the name); pass a `Blob` or `File` with an explicit `type` to control it.
 - **BREAKING**: Autodiscovery now either succeeds or fails; a WPAPI instance configured with default routes will no longer be returned.