Release v1.5.9

Author: AudD

.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version: ["20", "22"]
+    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 test
+      - run: npm run build

.github/workflows/contract.yml

@@ -0,0 +1,41 @@
+name: Contract
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  schedule:
+    # Daily nightly run at 06:00 UTC catches drift from upstream API changes
+    # captured into fixtures/ between merges.
+    - cron: "0 6 * * *"
+  repository_dispatch:
+    # Fired by audd-openapi on every merge to main; re-run our parser against
+    # the latest spec to catch contract drift before it reaches users.
+    types: [openapi-updated]
+
+permissions:
+  contents: read
+  issues: write
+
+jobs:
+  contract:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          path: audd-node
+      - uses: actions/checkout@v4
+        with:
+          repository: AudDMusic/audd-openapi
+          path: audd-openapi
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: npm
+          cache-dependency-path: audd-node/package-lock.json
+      - working-directory: audd-node
+        run: npm ci
+      - working-directory: audd-node
+        env:
+          AUDD_OPENAPI_FIXTURES: ${{ github.workspace }}/audd-openapi/fixtures
+        run: npx vitest run test/contract.test.ts

.github/workflows/release.yml

@@ -0,0 +1,47 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'audd-node/v*'
+      - 'v*'
+permissions:
+  contents: read
+  id-token: write   # for npm trusted publishing OIDC + Sigstore provenance
+  packages: write   # for GitHub Packages npm push
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"   # ships npm >= 11.5.1, required for trusted publishing
+          cache: npm
+          registry-url: "https://registry.npmjs.org"
+      - run: npm ci
+      - run: npm run lint
+      - run: npm run typecheck
+      - run: npm run test
+      - run: npm run build
+      - name: Publish to npmjs.com
+        run: npm publish --access public
+      - name: Publish to GitHub Packages (scoped @auddmusic/audd)
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        # GitHub Packages npm requires the package name to be `@<owner>/<name>`,
+        # lowercase owner. We publish a renamed copy of the same artifact to the
+        # AudDMusic org's package list. The canonical install path is still
+        # `npm install audd` from npmjs.com.
+        run: |
+          set -e
+          cp package.json package.json.npmjs
+          node -e "const p=require('./package.json'); p.name='@auddmusic/audd'; require('fs').writeFileSync('./package.json', JSON.stringify(p, null, 2));"
+          {
+            echo "@auddmusic:registry=https://npm.pkg.github.com"
+            echo "//npm.pkg.github.com/:_authToken=\${NODE_AUTH_TOKEN}"
+          } > .npmrc
+          npm publish --access public
+          mv package.json.npmjs package.json
+          rm .npmrc

.gitignore

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+coverage/
+.env
+.DS_Store
+*.log

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AudD, LLC (https://audd.io)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.