@codigoconelmer/driftwatch 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Elmer Jacobo
+
+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.

package/README.md

@@ -0,0 +1,202 @@
+# DriftWatch
+
+External API schema drift detector with Telegram alerts. No SDK to install in your apps — runs as a standalone daemon or Docker container, pointing at any HTTP endpoint you want to monitor.
+
+[![npm version](https://img.shields.io/npm/v/driftwatch)](https://www.npmjs.com/package/driftwatch)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-donate-orange)](https://buymeacoffee.com/)
+
+---
+
+## What it does
+
+DriftWatch periodically hits your API endpoints and extracts their response **schema** — keys and types, not values. When the schema changes (keys added, removed, or type changed), it fires a Telegram alert instantly.
+
+```
+⚠️ Schema drift detected!
+
+📌 Cards
+🔗 GET https://api.myapp.com/api/cards
+
+➕ Added:   data.[].role (string)
+➖ Removed: data.[].position_of (string)
+🔄 Changed: data.[].id  number → string
+```
+
+---
+
+## Install
+
+```bash
+npm install -g driftwatch
+# or
+pnpm add -g driftwatch
+```
+
+---
+
+## Quick start
+
+**1. Initialize config in your project**
+
+```bash
+cd my-project/
+driftwatch init
+```
+
+**2. Set up Telegram** (one-time, ~5 min)
+
+- Open Telegram → search `@BotFather` → send `/newbot` → copy the token
+- Send any message to your new bot
+- Open `https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates` in a browser
+- Copy the `chat.id` value from the JSON response
+
+**3. Configure environment**
+
+```bash
+cp .env.example .env
+```
+
+```env
+TELEGRAM_TOKEN=your-bot-token-here
+CHAT_ID=your-chat-id-here
+API_TOKEN=your-api-token-here   # optional, only if your API requires auth
+```
+
+**4. Edit `driftwatch.config.yml`** with your endpoints
+
+**5. First run** — creates snapshots, no alerts sent
+
+```bash
+driftwatch check
+```
+
+**6. Start the daemon**
+
+```bash
+driftwatch start
+```
+
+---
+
+## Config reference
+
+```yaml
+telegram:
+  bot_token: '${TELEGRAM_TOKEN}'
+  chat_id: '${CHAT_ID}'
+
+endpoints:
+  - name: 'Cards'
+    url: 'https://api.myapp.com/api/cards?company_id=123'
+    method: GET
+    headers:
+      Authorization: 'Bearer ${API_TOKEN}'
+      Accept: 'application/json'
+    interval: '*/5 * * * *'
+
+  - name: 'Create order'
+    url: 'https://api.myapp.com/api/orders'
+    method: POST
+    headers:
+      Authorization: 'Bearer ${API_TOKEN}'
+      Content-Type: 'application/json'
+    body:
+      product_id: 1
+      quantity: 1
+    interval: '0 * * * *'
+```
+
+| Field | Required | Description |
+|---|---|---|
+| `name` | yes | Display name used in alerts and snapshot filenames |
+| `url` | yes | Full URL including query params |
+| `method` | no | HTTP method, defaults to `GET` |
+| `headers` | no | Key/value headers sent with every request |
+| `body` | no | JSON body for POST/PUT/PATCH requests |
+| `interval` | yes | Cron expression (e.g. `*/5 * * * *` = every 5 min) |
+
+`${VAR}` values are resolved from `.env` or environment variables.
+
+---
+
+## CLI
+
+```bash
+driftwatch init                        # generate driftwatch.config.yml
+driftwatch start                       # start the daemon (cron-based)
+driftwatch start -c /path/to/cfg.yml   # custom config path
+driftwatch check                       # one-shot check all endpoints now
+driftwatch check -c /path/to/cfg.yml   # custom config path
+```
+
+---
+
+## How it works
+
+1. **First run per endpoint** — saves the response schema to `.driftwatch/snapshots/<name>.json`. No alert sent.
+2. **Subsequent runs** — compares live schema against the snapshot.
+   - No change → logs "no drift", no alert.
+   - Change detected → sends Telegram alert, updates snapshot as new baseline.
+3. **Schema** is a recursive key+type map. Values are ignored. Arrays are sampled from the first element — nested object structure is preserved.
+
+---
+
+## Docker (self-host on VPS)
+
+```bash
+cp .env.example .env
+# fill in your tokens
+
+docker compose up -d
+```
+
+Snapshots persist in a named Docker volume (`driftwatch-snapshots`) so they survive container restarts.
+
+To view logs:
+```bash
+docker compose logs -f
+```
+
+---
+
+## Snapshots
+
+Snapshots are stored in `.driftwatch/snapshots/` as JSON files named after each endpoint. They are **gitignored by default** — each environment (local, staging, prod) should build its own baseline on first run.
+
+Example snapshot:
+```json
+{
+  "endpoint": "Cards",
+  "url": "https://api.myapp.com/api/cards",
+  "capturedAt": "2026-01-15T10:30:00.000Z",
+  "schema": {
+    "status": "boolean",
+    "data": {
+      "[]": {
+        "id": "string",
+        "name": "string",
+        "email": "string"
+      }
+    }
+  }
+}
+```
+
+---
+
+## Cron expression reference
+
+| Expression | Meaning |
+|---|---|
+| `* * * * *` | Every minute |
+| `*/5 * * * *` | Every 5 minutes |
+| `0 * * * *` | Every hour |
+| `0 9 * * *` | Every day at 9am |
+| `0 9 * * 1` | Every Monday at 9am |
+
+---
+
+## License
+
+MIT

package/dist/checker.d.ts

@@ -0,0 +1,11 @@
+import type { EndpointConfig, SchemaValue, DiffResult } from './types.js';
+export declare function extractSchema(value: unknown, depth?: number): SchemaValue;
+export declare function diffSchemas(prev: SchemaValue, curr: SchemaValue): DiffResult;
+export interface CheckResult {
+    endpoint: EndpointConfig;
+    isFirstRun: boolean;
+    hasDrift: boolean;
+    diff: DiffResult;
+}
+export declare function checkEndpoint(endpoint: EndpointConfig): Promise<CheckResult>;
+//# sourceMappingURL=checker.d.ts.map

package/dist/checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../src/checker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAgB,UAAU,EAA2B,MAAM,YAAY,CAAC;AAIjH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,WAAW,CAiBpE;AAkBD,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAuB5E;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAgClF"}

package/dist/checker.js

@@ -0,0 +1,89 @@
+import axios from 'axios';
+import { readSnapshot, writeSnapshot } from './snapshot.js';
+const MAX_DEPTH = 20;
+export function extractSchema(value, depth = 0) {
+    if (depth >= MAX_DEPTH)
+        return 'object';
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value)) {
+        if (value.length > 0 && value[0] !== null && typeof value[0] === 'object' && !Array.isArray(value[0])) {
+            return { '[]': extractSchema(value[0], depth + 1) };
+        }
+        return 'array';
+    }
+    if (typeof value === 'object') {
+        const obj = {};
+        for (const [key, val] of Object.entries(value)) {
+            obj[key] = extractSchema(val, depth + 1);
+        }
+        return obj;
+    }
+    return typeof value;
+}
+function flattenSchema(schema, prefix = '') {
+    if (typeof schema === 'string') {
+        return prefix ? { [prefix]: schema } : {};
+    }
+    const result = {};
+    for (const [key, val] of Object.entries(schema)) {
+        const p = prefix ? `${prefix}.${key}` : key;
+        if (typeof val === 'string') {
+            result[p] = val;
+        }
+        else {
+            Object.assign(result, flattenSchema(val, p));
+        }
+    }
+    return result;
+}
+export function diffSchemas(prev, curr) {
+    const prevFlat = flattenSchema(prev);
+    const currFlat = flattenSchema(curr);
+    const added = [];
+    const removed = [];
+    const changed = [];
+    for (const [path, type] of Object.entries(currFlat)) {
+        if (!(path in prevFlat)) {
+            added.push({ path, type });
+        }
+        else if (prevFlat[path] !== type) {
+            changed.push({ path, from: prevFlat[path], to: type });
+        }
+    }
+    for (const [path, type] of Object.entries(prevFlat)) {
+        if (!(path in currFlat)) {
+            removed.push({ path, type });
+        }
+    }
+    return { added, removed, changed };
+}
+export async function checkEndpoint(endpoint) {
+    const response = await axios({
+        method: endpoint.method,
+        url: endpoint.url,
+        headers: endpoint.headers ?? {},
+        data: endpoint.body,
+        timeout: 15000,
+        maxContentLength: 5 * 1024 * 1024, // 5MB
+        maxBodyLength: 1 * 1024 * 1024, // 1MB request body
+    });
+    const schema = extractSchema(response.data);
+    const snapshot = readSnapshot(endpoint.name);
+    if (!snapshot) {
+        writeSnapshot(endpoint.name, endpoint.url, schema);
+        return {
+            endpoint,
+            isFirstRun: true,
+            hasDrift: false,
+            diff: { added: [], removed: [], changed: [] },
+        };
+    }
+    const diff = diffSchemas(snapshot.schema, schema);
+    const hasDrift = diff.added.length > 0 || diff.removed.length > 0 || diff.changed.length > 0;
+    if (hasDrift) {
+        writeSnapshot(endpoint.name, endpoint.url, schema);
+    }
+    return { endpoint, isFirstRun: false, hasDrift, diff };
+}
+//# sourceMappingURL=checker.js.map

package/dist/checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checker.js","sourceRoot":"","sources":["../src/checker.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,3 @@
+import type { Config } from './types.js';
+export declare function loadConfig(configPath?: string): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAiBzC,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAwBtD"}

package/dist/config.js

@@ -0,0 +1,43 @@
+import fs from 'fs';
+import path from 'path';
+import yaml from 'js-yaml';
+import dotenv from 'dotenv';
+dotenv.config();
+function resolveEnvVars(value) {
+    if (typeof value === 'string') {
+        return value.replace(/\$\{([^}]+)\}/g, (_, name) => process.env[name] ?? '');
+    }
+    if (Array.isArray(value))
+        return value.map(resolveEnvVars);
+    if (value !== null && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, resolveEnvVars(v)]));
+    }
+    return value;
+}
+export function loadConfig(configPath) {
+    const filePath = configPath ?? path.resolve(process.cwd(), 'driftwatch.config.yml');
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`Config not found: ${filePath}\nRun "driftwatch init" to create one.`);
+    }
+    const raw = yaml.load(fs.readFileSync(filePath, 'utf8'));
+    const resolved = resolveEnvVars(raw);
+    if (!resolved.telegram?.bot_token)
+        throw new Error('Config missing telegram.bot_token');
+    if (!resolved.telegram?.chat_id)
+        throw new Error('Config missing telegram.chat_id');
+    if (!Array.isArray(resolved.endpoints) || resolved.endpoints.length === 0) {
+        throw new Error('Config must have at least one endpoint');
+    }
+    for (const ep of resolved.endpoints) {
+        if (!ep.name)
+            throw new Error('Endpoint missing "name"');
+        if (!ep.url)
+            throw new Error(`Endpoint "${ep.name}" missing "url"`);
+        if (!ep.interval)
+            throw new Error(`Endpoint "${ep.name}" missing "interval"`);
+        if (!ep.method)
+            ep.method = 'GET';
+    }
+    return resolved;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,MAAM,MAAM,QAAQ,CAAC;AAG5B,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CACzF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,UAAmB;IAC5C,MAAM,QAAQ,GAAG,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,uBAAuB,CAAC,CAAC;IAEpF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,wCAAwC,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAW,CAAC;IAE/C,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACxF,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACpF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACpC,IAAI,CAAC,EAAE,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACzD,IAAI,CAAC,EAAE,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC,IAAI,iBAAiB,CAAC,CAAC;QACpE,IAAI,CAAC,EAAE,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC,IAAI,sBAAsB,CAAC,CAAC;QAC9E,IAAI,CAAC,EAAE,CAAC,MAAM;YAAE,EAAE,CAAC,MAAM,GAAG,KAAK,CAAC;IACpC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import fs from 'fs';
+import path from 'path';
+import { loadConfig } from './config.js';
+import { initBot, sendDriftAlert } from './telegram.js';
+import { startScheduler } from './scheduler.js';
+import { checkEndpoint } from './checker.js';
+const EXAMPLE_CONFIG = `telegram:
+  bot_token: '\${TELEGRAM_TOKEN}'
+  chat_id: '\${CHAT_ID}'
+
+endpoints:
+  - name: 'Users list'
+    url: 'https://your-app.com/api/users'
+    method: GET
+    headers:
+      Authorization: 'Bearer \${API_TOKEN}'
+    interval: '*/5 * * * *'
+
+  - name: 'Create order'
+    url: 'https://your-app.com/api/orders'
+    method: POST
+    headers:
+      Authorization: 'Bearer \${API_TOKEN}'
+      Content-Type: 'application/json'
+    body:
+      product_id: 1
+      quantity: 1
+    interval: '0 * * * *'
+`;
+const program = new Command();
+program
+    .name('driftwatch')
+    .description('External API schema drift detector with Telegram alerts')
+    .version('1.0.0');
+program
+    .command('init')
+    .description('Generate driftwatch.config.yml in the current directory')
+    .action(() => {
+    const dest = path.resolve(process.cwd(), 'driftwatch.config.yml');
+    if (fs.existsSync(dest)) {
+        console.log('driftwatch.config.yml already exists.');
+        process.exit(1);
+    }
+    fs.writeFileSync(dest, EXAMPLE_CONFIG);
+    console.log('Created driftwatch.config.yml — edit it and set your env vars in .env');
+});
+program
+    .command('start')
+    .description('Start the scheduler daemon')
+    .option('-c, --config <path>', 'Path to config file')
+    .action((opts) => {
+    const config = loadConfig(opts.config);
+    initBot(config.telegram.bot_token);
+    console.log(`[driftwatch] Starting with ${config.endpoints.length} endpoint(s)...`);
+    startScheduler(config);
+});
+program
+    .command('check')
+    .description('One-shot check all endpoints (no schedule)')
+    .option('-c, --config <path>', 'Path to config file')
+    .action(async (opts) => {
+    const config = loadConfig(opts.config);
+    initBot(config.telegram.bot_token);
+    console.log(`[driftwatch] Checking ${config.endpoints.length} endpoint(s)...`);
+    for (const endpoint of config.endpoints) {
+        console.log(`\nChecking: ${endpoint.name}`);
+        try {
+            const result = await checkEndpoint(endpoint);
+            if (result.isFirstRun) {
+                console.log('  First run — snapshot saved, no alert.');
+            }
+            else if (result.hasDrift) {
+                const { diff } = result;
+                console.log(`  Drift detected!`);
+                diff.added.forEach(e => console.log(`    + ${e.path} (${e.type})`));
+                diff.removed.forEach(e => console.log(`    - ${e.path} (${e.type})`));
+                diff.changed.forEach(e => console.log(`    ~ ${e.path}: ${e.from} → ${e.to}`));
+                await sendDriftAlert(config.telegram.chat_id, result);
+                console.log('  Alert sent.');
+            }
+            else {
+                console.log('  No drift.');
+            }
+        }
+        catch (err) {
+            console.error(`  Error: ${err.message}`);
+        }
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/scheduler.d.ts

@@ -0,0 +1,3 @@
+import type { Config } from './types.js';
+export declare function startScheduler(config: Config): void;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAqCnD"}

package/dist/scheduler.js

@@ -0,0 +1,41 @@
+import cron from 'node-cron';
+import { checkEndpoint } from './checker.js';
+import { sendDriftAlert } from './telegram.js';
+export function startScheduler(config) {
+    const tasks = [];
+    const shutdown = () => {
+        console.log('\n[driftwatch] Shutting down...');
+        tasks.forEach(t => t.stop());
+        process.exit(0);
+    };
+    process.once('SIGINT', shutdown);
+    process.once('SIGTERM', shutdown);
+    for (const endpoint of config.endpoints) {
+        if (!cron.validate(endpoint.interval)) {
+            console.error(`[driftwatch] Invalid cron expression for "${endpoint.name}": ${endpoint.interval}`);
+            continue;
+        }
+        const task = cron.schedule(endpoint.interval, async () => {
+            console.log(`[driftwatch] Checking ${endpoint.name}...`);
+            try {
+                const result = await checkEndpoint(endpoint);
+                if (result.isFirstRun) {
+                    console.log(`[driftwatch] ${endpoint.name}: first run, snapshot saved.`);
+                }
+                else if (result.hasDrift) {
+                    console.log(`[driftwatch] ${endpoint.name}: drift detected! Sending alert.`);
+                    await sendDriftAlert(config.telegram.chat_id, result);
+                }
+                else {
+                    console.log(`[driftwatch] ${endpoint.name}: no drift.`);
+                }
+            }
+            catch (err) {
+                console.error(`[driftwatch] Error checking "${endpoint.name}":`, err.message);
+            }
+        });
+        tasks.push(task);
+        console.log(`[driftwatch] Scheduled "${endpoint.name}" — ${endpoint.interval}`);
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,KAAK,GAAuC,EAAE,CAAC;IAErD,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAElC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,KAAK,CAAC,6CAA6C,QAAQ,CAAC,IAAI,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnG,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YACvD,OAAO,CAAC,GAAG,CAAC,yBAAyB,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC;YACzD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;gBAC7C,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;oBACtB,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,CAAC,IAAI,8BAA8B,CAAC,CAAC;gBAC3E,CAAC;qBAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAC3B,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,CAAC,IAAI,kCAAkC,CAAC,CAAC;oBAC7E,MAAM,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBACxD,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,CAAC,IAAI,aAAa,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,gCAAgC,QAAQ,CAAC,IAAI,IAAI,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEjB,OAAO,CAAC,GAAG,CAAC,2BAA2B,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClF,CAAC;AACH,CAAC"}

package/dist/snapshot.d.ts

@@ -0,0 +1,4 @@
+import type { SnapshotFile, SchemaValue } from './types.js';
+export declare function readSnapshot(endpointName: string): SnapshotFile | null;
+export declare function writeSnapshot(endpointName: string, url: string, schema: SchemaValue): void;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkB5D,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAItE;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAY1F"}

package/dist/snapshot.js

@@ -0,0 +1,34 @@
+import fs from 'fs';
+import path from 'path';
+const SNAPSHOTS_DIR = path.resolve(process.cwd(), '.driftwatch', 'snapshots');
+function toSlug(name) {
+    return name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+}
+function ensureDir() {
+    if (!fs.existsSync(SNAPSHOTS_DIR)) {
+        fs.mkdirSync(SNAPSHOTS_DIR, { recursive: true });
+    }
+}
+function snapshotPath(endpointName) {
+    return path.join(SNAPSHOTS_DIR, `${toSlug(endpointName)}.json`);
+}
+export function readSnapshot(endpointName) {
+    const file = snapshotPath(endpointName);
+    if (!fs.existsSync(file))
+        return null;
+    return JSON.parse(fs.readFileSync(file, 'utf8'));
+}
+export function writeSnapshot(endpointName, url, schema) {
+    ensureDir();
+    const snapshot = {
+        endpoint: endpointName,
+        url,
+        capturedAt: new Date().toISOString(),
+        schema,
+    };
+    const dest = snapshotPath(endpointName);
+    const tmp = `${dest}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(snapshot, null, 2));
+    fs.renameSync(tmp, dest);
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;AAE9E,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,SAAS;IAChB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,MAAM,IAAI,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAiB,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,YAAoB,EAAE,GAAW,EAAE,MAAmB;IAClF,SAAS,EAAE,CAAC;IACZ,MAAM,QAAQ,GAAiB;QAC7B,QAAQ,EAAE,YAAY;QACtB,GAAG;QACH,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,MAAM;KACP,CAAC;IACF,MAAM,IAAI,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC;IAC1B,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACzD,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/telegram.d.ts

@@ -0,0 +1,4 @@
+import type { CheckResult } from './checker.js';
+export declare function initBot(token: string): void;
+export declare function sendDriftAlert(chatId: string, result: CheckResult): Promise<void>;
+//# sourceMappingURL=telegram.d.ts.map

package/dist/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../src/telegram.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE3C;AAiCD,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvF"}

package/dist/telegram.js

@@ -0,0 +1,39 @@
+import TelegramBot from 'node-telegram-bot-api';
+let bot = null;
+export function initBot(token) {
+    bot = new TelegramBot(token);
+}
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function formatDiff(result) {
+    const { endpoint, diff } = result;
+    const lines = [
+        '⚠️ <b>Schema drift detected!</b>',
+        '',
+        `📌 ${escapeHtml(endpoint.name)}`,
+        `🔗 ${escapeHtml(endpoint.method)} ${escapeHtml(endpoint.url)}`,
+        '',
+    ];
+    for (const entry of diff.added) {
+        lines.push(`➕ Added:   ${escapeHtml(entry.path)} (${escapeHtml(entry.type)})`);
+    }
+    for (const entry of diff.removed) {
+        lines.push(`➖ Removed: ${escapeHtml(entry.path)} (${escapeHtml(entry.type)})`);
+    }
+    for (const entry of diff.changed) {
+        lines.push(`🔄 Changed: ${escapeHtml(entry.path)}  ${escapeHtml(entry.from)} → ${escapeHtml(entry.to)}`);
+    }
+    return lines.join('\n');
+}
+export async function sendDriftAlert(chatId, result) {
+    if (!bot)
+        throw new Error('Telegram bot not initialized');
+    const message = formatDiff(result);
+    await bot.sendMessage(chatId, message, { parse_mode: 'HTML' });
+}
+//# sourceMappingURL=telegram.js.map

package/dist/telegram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../src/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAGhD,IAAI,GAAG,GAAuB,IAAI,CAAC;AAEnC,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,GAAG,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG;SACP,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,UAAU,CAAC,MAAmB;IACrC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAClC,MAAM,KAAK,GAAa;QACtB,kCAAkC;QAClC,EAAE;QACF,MAAM,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;QACjC,MAAM,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;QAC/D,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,cAAc,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjF,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,cAAc,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjF,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,eAAe,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,MAAmB;IACtE,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+export type SchemaValue = string | SchemaObject;
+export type SchemaObject = {
+    [key: string]: SchemaValue;
+};
+export interface EndpointConfig {
+    name: string;
+    url: string;
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    headers?: Record<string, string>;
+    body?: unknown;
+    interval: string;
+}
+export interface TelegramConfig {
+    bot_token: string;
+    chat_id: string;
+}
+export interface Config {
+    telegram: TelegramConfig;
+    endpoints: EndpointConfig[];
+}
+export interface SnapshotFile {
+    endpoint: string;
+    url: string;
+    capturedAt: string;
+    schema: SchemaValue;
+}
+export interface DiffEntry {
+    path: string;
+    type: string;
+}
+export interface ChangedEntry {
+    path: string;
+    from: string;
+    to: string;
+}
+export interface DiffResult {
+    added: DiffEntry[];
+    removed: DiffEntry[];
+    changed: ChangedEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,YAAY,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@codigoconelmer/driftwatch",
+  "version": "1.0.0",
+  "description": "External API schema drift detector with Telegram alerts",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "driftwatch": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "pnpm build"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "api",
+    "schema",
+    "drift",
+    "monitor",
+    "telegram",
+    "cli"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.7.9",
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.7",
+    "js-yaml": "^4.1.0",
+    "node-cron": "^3.0.3",
+    "node-telegram-bot-api": "^0.66.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "@types/node-cron": "^3.0.11",
+    "@types/node-telegram-bot-api": "^0.64.14",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": ["esbuild"]
+  }
+}