Address PR review feedback for browser-plugin-bot-detection

- Change rush change type from "none" to "minor" for new package
- Add author field to package.json
- Add README.md and LICENSE files
- Improve error log message to be more descriptive
- Fix test mock detect() to return Promise.reject instead of throwing
- Revert unrelated rush-prettier lockfile upgrade
- Remove unrelated transitive version bumps from pnpm-lock.yaml

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: stanch

common/autoinstallers/rush-prettier/pnpm-lock.yaml

@@ -2,7 +2,7 @@
   "changes": [
     {
       "comment": "Add browser-plugin-bot-detection plugin wrapping FingerprintJS BotD for client-side bot detection",
-      "type": "none",
+      "type": "minor",
       "packageName": "@snowplow/browser-plugin-bot-detection"
     }
   ],

common/changes/@snowplow/browser-plugin-bot-detection/bot-detection-plugin_2026-03-17-17-11.json

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2022 Snowplow Analytics Ltd, 2010 Anthon Pang
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

common/config/rush/pnpm-lock.yaml

@@ -0,0 +1,59 @@
+# Snowplow Bot Detection
+
+[![npm version][npm-image]][npm-url]
+[![License][license-image]](LICENSE)
+
+Browser Plugin to be used with `@snowplow/browser-tracker`.
+
+Detects bots client-side using [FingerprintJS BotD](https://github.com/nicedoc/fingerprintjs-botd) and attaches the result as a `client_side_bot_detection` context entity to all tracked events.
+
+## Maintainer quick start
+
+Part of the Snowplow JavaScript Tracker monorepo.
+Build with [Node.js](https://nodejs.org/en/) (18 - 20) and [Rush](https://rushjs.io/).
+
+### Setup repository
+
+```bash
+npm install -g @microsoft/rush
+git clone https://github.com/snowplow/snowplow-javascript-tracker.git
+rush update
+```
+
+## Package Installation
+
+With npm:
+
+```bash
+npm install @snowplow/browser-plugin-bot-detection
+```
+
+## Usage
+
+Initialize your tracker with the BotDetectionPlugin:
+
+```js
+import { newTracker } from '@snowplow/browser-tracker';
+import { BotDetectionPlugin } from '@snowplow/browser-plugin-bot-detection';
+
+newTracker('sp1', '{{collector}}', { plugins: [ BotDetectionPlugin() ] });
+```
+
+Once detection completes, a `client_side_bot_detection` context entity will be attached to all subsequent events with the following fields:
+
+- `bot` (boolean): Whether a bot was detected.
+- `kind` (string | null): The type of bot detected (e.g. `"selenium"`, `"phantomjs"`), or `null` if no bot was found.
+
+## Copyright and license
+
+Licensed and distributed under the [BSD 3-Clause License](LICENSE) ([An OSI Approved License][osi]).
+
+Copyright (c) 2022 Snowplow Analytics Ltd, 2010 Anthon Pang.
+
+All rights reserved.
+
+[npm-url]: https://www.npmjs.com/package/@snowplow/browser-plugin-bot-detection
+[npm-image]: https://img.shields.io/npm/v/@snowplow/browser-plugin-bot-detection
+[docs]: https://docs.snowplowanalytics.com/docs/collecting-data/collecting-from-own-applications/javascript-tracker/
+[osi]: https://opensource.org/licenses/BSD-3-Clause
+[license-image]: https://img.shields.io/npm/l/@snowplow/browser-plugin-bot-detection

plugins/browser-plugin-bot-detection/LICENSE

@@ -9,6 +9,7 @@
     "url": "https://github.com/snowplow/snowplow-javascript-tracker.git"
   },
   "license": "BSD-3-Clause",
+  "author": "Snowplow Analytics Ltd (https://snowplow.io/)",
   "sideEffects": false,
   "main": "./dist/index.umd.js",
   "module": "./dist/index.module.js",

plugins/browser-plugin-bot-detection/README.md

@@ -19,7 +19,7 @@ export function BotDetectionPlugin(): BrowserPlugin {
           .then((result) => {
             contextData = result.bot ? { bot: true, kind: result.botKind } : { bot: false, kind: null };
           })
-          .catch((err) => LOG.error('BotDetectionPlugin', err));
+          .catch((err) => LOG.error('BotDetectionPlugin: BotD load/detect failed', err));
       }
     },
     contexts: () => {

plugins/browser-plugin-bot-detection/package.json

@@ -16,9 +16,9 @@ jest.mock('@fingerprintjs/botd', () => ({
     return Promise.resolve({
       detect: () => {
         if (mockDetectReject) {
-          throw mockDetectReject;
+          return Promise.reject(mockDetectReject);
         }
-        return mockDetectResult;
+        return Promise.resolve(mockDetectResult);
       },
     });
   },