From 6dfc3f924ce9b6b43b4abc6c9ff29e5aa3e02e88 Mon Sep 17 00:00:00 2001
From: devjiwonchoi <devjiwonchoi@gmail.com>
Date: Wed, 9 Sep 2026 08:06:11 +0200
Subject: [PATCH] release: 0.3.0
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Bump version to 0.3.0 (first prerelease of the revived client).
- README: rewrite the API-reference section so endpoint discovery is
  actually usable — the Lichess docs are organized by URL path, not function
  name, so point to editor autocomplete + hover JSDoc, the operationId->name
  mapping, and src/client/sdk.gen.ts as the function index.
- Add .github/workflows/publish.yml: publish to npm on GitHub Release
  (published), with provenance; needs an NPM_TOKEN secret.
---
 .github/workflows/publish.yml | 38 +++++++++++++++++++++++++++++++++++
 README.md                     | 11 ++++++----
 package.json                  |  2 +-
 3 files changed, 46 insertions(+), 5 deletions(-)
 create mode 100644 .github/workflows/publish.yml

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
new file mode 100644
index 0000000..3561ef3
--- /dev/null
+++ b/.github/workflows/publish.yml
@@ -0,0 +1,38 @@
+name: Publish
+
+# Publishes the package to npm when a GitHub Release is published.
+# Requires an NPM_TOKEN repo secret (npm automation token with publish rights).
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write # for npm provenance
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: 'https://registry.npmjs.org'
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm build
+
+      - name: Publish to npm
+        run: pnpm publish --no-git-checks --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
diff --git a/README.md b/README.md
index 8390f82..e2df1a5 100644
--- a/README.md
+++ b/README.md
@@ -42,10 +42,13 @@ to clear the token.
 
 ## API reference
 
-Every Lichess endpoint is exposed as a named function (`accountMe`,
-`apiUsersStatus`, `challengeCreate`, …), fully typed with inline docs from the
-spec. See the [Lichess API documentation](https://lichess.org/api) for endpoint
-details.
+Every Lichess endpoint is exposed as a named function. The name is the
+operation's `operationId` from the spec (e.g. `accountMe`, `apiUsersStatus`,
+`challengeCreate`), and each function carries the endpoint's summary and
+description as JSDoc.
+
+For a full, searchable index of every generated function and its types, see
+[`src/client/sdk.gen.ts`](./src/client/sdk.gen.ts).
 
 ## How it stays current
 
diff --git a/package.json b/package.json
index 53e2a42..a59d6b9 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "equine",
-  "version": "1.0.0-alpha.0",
+  "version": "0.3.0",
   "description": "Minimal Lichess API Client for Node.js",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",