2.4.1: monitor billing in the docs (every check is 1 credit)

Since 2026-10-01 every monitor check costs 1 credit whether or not it finds
new videos, and so does the read at creation that records what is already
there; a failed listing stays free. The README and the create/check doc
comments still said the baseline and quiet checks were free.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01V2tZj5bJ3BQgp5mK97hq1A

Author: Chandler Casey

CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project are documented here. This project follows
 [Semantic Versioning](https://semver.org/).
 
+## [2.4.1] - 2026-10-02
+
+### Fixed
+
+- Monitor billing in the README and the `create` / `check` doc comments. Since
+  2026-10-01 every monitor check costs 1 credit whether or not it finds new
+  videos, and so does the read at creation that records what is already there;
+  a check whose listing fails stays free. The docs still described the old
+  rules (free baseline, free quiet checks). No code changes.
+
 ## [2.4.0] - 2026-09-27
 
 ### Added

README.md

@@ -121,10 +121,12 @@ await tf.health();                                     // unauthenticated livene
 ## Monitors (2.4.0+)
 
 Watch a YouTube channel or a TikTok/Instagram profile for new videos. Creating
-one records a free baseline and starts scheduled checks; existing videos are
-skipped. Checks with no new videos are free. A check finding videos costs
-1 credit, plus transcript charges when enabled. See [monitor docs](https://transcriptfetch.com/docs/monitors)
-for plan limits, audio billing, retention and webhook verification.
+one reads the target once to record what is already there (existing videos are
+skipped) and starts scheduled checks. Every check costs 1 credit whether or not
+it finds new videos, and so does that first read; caption transcripts cost 1
+credit more each when enabled. A check whose listing fails is free. See
+[monitor docs](https://transcriptfetch.com/docs/monitors) for plan limits, audio
+billing, retention and webhook verification.
 
 ```ts
 const tf = new TranscriptFetch({ timeout: 120_000 });
@@ -147,7 +149,7 @@ await tf.monitors.update(monitor.id, { status: "paused" });
 await tf.monitors.update(monitor.id, { webhookUrl: null, name: null, transcripts: false });
 // Omitted settings stay unchanged. null clears webhookUrl/name.
 await tf.monitors.update(monitor.id, { status: "active" });
-const check = await tf.monitors.check(monitor.id); // may spend credits
+const check = await tf.monitors.check(monitor.id); // 1 credit, found or not
 if (check.error) console.error(check.error); // listing failure, even with HTTP 200
 await tf.monitors.delete(monitor.id); // removes events too
 ```

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "transcriptfetch",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Official Node.js/TypeScript SDK for the TranscriptFetch API: a production transcript API for YouTube, TikTok, Instagram and direct media URLs - captions in about a second, automatic AI speech-to-text when none exist - plus search, channel and playlist listing, as clean typed data.",
   "keywords": [
     "youtube",

package.json

@@ -55,8 +55,9 @@ function settings(options: UpdateMonitorOptions): Record<string, unknown> {
 export class Monitors {
   constructor(private readonly client: TranscriptFetch) {}
 
-  /** Create a scheduled monitor. Baseline is free; only later videos produce events.
-   * Save webhookSecret now: it is only returned on creation. */
+  /** Create a scheduled monitor. Creation reads the target once (1 credit) and skips the
+   * videos already there; only later videos produce events, and every later check costs
+   * 1 credit, found or not. Save webhookSecret now: it is only returned on creation. */
   async create(target: string, options: CreateMonitorOptions = {}): Promise<Monitor> {
     const body = { ...settings(options), target, type: options.type, platform: options.platform, tab: options.tab };
     return normalizeMonitor(await this.client.request("POST", BASE, {
@@ -85,7 +86,7 @@ export class Monitors {
     return env.data as MonitorDeleted;
   }
 
-  /** Check now (even when paused). New videos cost credits; inspect error for listing failures. */
+  /** Check now (even when paused): 1 credit, found or not; inspect error for listing failures. */
   async check(monitorId: string, options: { idempotencyKey?: string } = {}): Promise<MonitorCheck> {
     return normalizeMonitorCheck(await this.client.request("POST", `${path(monitorId)}/check`, {
       idempotent: true, idempotencyKey: options.idempotencyKey,

src/resources/monitors.ts

@@ -1,2 +1,2 @@
 /** The SDK version, surfaced in the User-Agent header. Kept in sync with package.json. */
-export const VERSION = "2.4.0";
+export const VERSION = "2.4.1";