@traceten/ai-crawl 0.1.1 → 1.0.0

package/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [1.0.0] - Unreleased
+
+First stable release. No functional change since 0.1.1 — the API has held
+steady in production use, so this marks it stable rather than adding to it.
+
 ## [0.1.1] - 2026-09-05
 
 ### Changed

package/README.md

@@ -1,6 +1,7 @@
+<img src="https://traceten.com/logos/traceten-wordmark-black.png" alt="Traceten" width="320" />
+
 # @traceten/ai-crawl
 
-[![CI](https://github.com/traceten/ai-crawl/actions/workflows/ci.yml/badge.svg)](https://github.com/traceten/ai-crawl/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/@traceten/ai-crawl.svg)](https://www.npmjs.com/package/@traceten/ai-crawl)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)

package/dist/matcher.d.ts

@@ -1,9 +1,9 @@
 /**
  * Anchored two-tier user-agent matching.
  *
- * NEVER `includes()` on the whole string — that is the reference package's
- * defect (its page claims token matching; its code does substring matching,
- * so a browser UA containing `grok` or `copilot` false-positives). Follows
+ * NEVER `includes()` on the whole string. Substring matching false-positives
+ * on ordinary browser traffic: a UA containing `grok` or `copilot` anywhere
+ * would be reported as a crawler. Follows
  * the same anchoring discipline Traceten's server-side classifier uses,
  * adapted for crawler UAs where the token sits mid-string
  * (`Mozilla/5.0 … compatible; GPTBot/1.1; +https://openai.com/gptbot`).

package/dist/matcher.js

@@ -1,9 +1,9 @@
 /**
  * Anchored two-tier user-agent matching.
  *
- * NEVER `includes()` on the whole string — that is the reference package's
- * defect (its page claims token matching; its code does substring matching,
- * so a browser UA containing `grok` or `copilot` false-positives). Follows
+ * NEVER `includes()` on the whole string. Substring matching false-positives
+ * on ordinary browser traffic: a UA containing `grok` or `copilot` anywhere
+ * would be reported as a crawler. Follows
  * the same anchoring discipline Traceten's server-side classifier uses,
  * adapted for crawler UAs where the token sits mid-string
  * (`Mozilla/5.0 … compatible; GPTBot/1.1; +https://openai.com/gptbot`).

package/package.json

@@ -1,16 +1,28 @@
 {
   "name": "@traceten/ai-crawl",
-  "version": "0.1.1",
+  "version": "1.0.0",
   "private": false,
   "description": "Traceten server-side AI crawler tracking — see the GPTBot/ClaudeBot/PerplexityBot crawls that browser JavaScript can never see. Five adapters, zero dependencies, never blocks a response.",
   "keywords": [
+    "traceten",
+    "traceten.com",
     "ai-crawler",
     "gptbot",
     "claudebot",
     "perplexitybot",
     "bot-detection",
     "analytics",
-    "traceten"
+    "ai-analytics",
+    "web-analytics",
+    "ai-traffic",
+    "ai-visibility",
+    "chatgpt",
+    "perplexity",
+    "llm-traffic",
+    "generative-engine-optimization",
+    "aeo",
+    "server-side-analytics",
+    "nodejs"
   ],
   "license": "MIT",
   "homepage": "https://docs.traceten.com/install/ai-crawler-tracking",

package/src/matcher.ts

@@ -1,9 +1,9 @@
 /**
  * Anchored two-tier user-agent matching.
  *
- * NEVER `includes()` on the whole string — that is the reference package's
- * defect (its page claims token matching; its code does substring matching,
- * so a browser UA containing `grok` or `copilot` false-positives). Follows
+ * NEVER `includes()` on the whole string. Substring matching false-positives
+ * on ordinary browser traffic: a UA containing `grok` or `copilot` anywhere
+ * would be reported as a crawler. Follows
  * the same anchoring discipline Traceten's server-side classifier uses,
  * adapted for crawler UAs where the token sits mid-string
  * (`Mozilla/5.0 … compatible; GPTBot/1.1; +https://openai.com/gptbot`).