mikrotik-telegram 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `mikrotik-telegram` are documented here.
 
 The project follows [Semantic Versioning](https://semver.org/).
 
+## [0.2.0] - 2026-09-12
+
+### Added
+
+- Complete `examples/production-bot` Node.js production example.
+- Webhook server, operational command catalogue, alert loop, automation rules, and audit commands.
+
+### Fixed
+
+- Published ESM declarations now use Node.js-compatible `.js` import specifiers.
+- Package builds with a standalone NodeNext configuration for external consumers.
+
 ## [0.1.0] - 2026-09-12
 
 ### Added

package/README.md

@@ -168,6 +168,10 @@ The library owns RouterOS and Telegram behavior but does not own your web framew
 
 The public entry point exports configuration, REST transport, services, command registry, runtime adapters, alerting, automation, protected actions, types, and audit helpers from `src/index.ts`.
 
+## Complete example
+
+See [`examples/production-bot`](./examples/production-bot) for a complete Node.js 20 bot with webhook handling, role-based commands, vouchers, CRUD operations, protected mutations, alerts, automation, and audit export.
+
 ## Versioning
 
 This package follows [Semantic Versioning](https://semver.org/):

package/dist/alerts.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import type { HotspotProfile, SystemHealth, TrafficMetrics } from './types';
+import type { HotspotProfile, SystemHealth, TrafficMetrics } from './types.js';
 export declare const AlertSeveritySchema: z.ZodEnum<{
     info: "info";
     warning: "warning";

package/dist/automation.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import type { Alert } from './alerts';
+import type { Alert } from './alerts.js';
 export declare const AutomationActionSchema: z.ZodEnum<{
     "health-check": "health-check";
     "stock-check": "stock-check";

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-export * from './config';
-export * from './errors';
-export * from './rest-client';
-export * from './mikrotik-service';
-export * from './telegram-client';
-export * from './telegram-commands';
-export * from './runtime';
-export * from './runtime-adapters';
-export * from './alerts';
-export * from './automation';
-export * from './actions';
-export * from './types';
-export * from './audit';
+export * from './config.js';
+export * from './errors.js';
+export * from './rest-client.js';
+export * from './mikrotik-service.js';
+export * from './telegram-client.js';
+export * from './telegram-commands.js';
+export * from './runtime.js';
+export * from './runtime-adapters.js';
+export * from './alerts.js';
+export * from './automation.js';
+export * from './actions.js';
+export * from './types.js';
+export * from './audit.js';

package/dist/index.js

@@ -1,13 +1,13 @@
-export * from './config';
-export * from './errors';
-export * from './rest-client';
-export * from './mikrotik-service';
-export * from './telegram-client';
-export * from './telegram-commands';
-export * from './runtime';
-export * from './runtime-adapters';
-export * from './alerts';
-export * from './automation';
-export * from './actions';
-export * from './types';
-export * from './audit';
+export * from './config.js';
+export * from './errors.js';
+export * from './rest-client.js';
+export * from './mikrotik-service.js';
+export * from './telegram-client.js';
+export * from './telegram-commands.js';
+export * from './runtime.js';
+export * from './runtime-adapters.js';
+export * from './alerts.js';
+export * from './automation.js';
+export * from './actions.js';
+export * from './types.js';
+export * from './audit.js';

package/dist/mikrotik-service.d.ts

@@ -1,5 +1,5 @@
-import { RouterOsRestClient } from './rest-client';
-import type { ActiveSession, CreateHotspotUserInput, CreateProfileInput, CreateSchedulerInput, CreateScriptInput, HotspotProfile, HotspotUser, MutationResult, RouterId, RouterScheduler, RouterScript, SystemHealth, UpdateHotspotUserInput, UpdateProfileInput, UpdateSchedulerInput, UserQuery, GenerateVouchersInput, GenerateVouchersResult, BanUserInput, BanResult, UnbanUserInput, DeleteUserInput, DisconnectUserInput } from './types';
+import { RouterOsRestClient } from './rest-client.js';
+import type { ActiveSession, CreateHotspotUserInput, CreateProfileInput, CreateSchedulerInput, CreateScriptInput, HotspotProfile, HotspotUser, MutationResult, RouterId, RouterScheduler, RouterScript, SystemHealth, UpdateHotspotUserInput, UpdateProfileInput, UpdateSchedulerInput, UserQuery, GenerateVouchersInput, GenerateVouchersResult, BanUserInput, BanResult, UnbanUserInput, DeleteUserInput, DisconnectUserInput } from './types.js';
 export declare class MikroTikService {
     private readonly client;
     constructor(client: RouterOsRestClient);

package/dist/rest-client.d.ts

@@ -1,4 +1,4 @@
-import type { RouterPayload, RouterRecord, RouterResponse } from './types';
+import type { RouterPayload, RouterRecord, RouterResponse } from './types.js';
 export interface RestClientOptions {
     readonly host: string;
     readonly port: number;

package/dist/rest-client.js

@@ -1,4 +1,4 @@
-import { RouterOsHttpError } from './errors';
+import { RouterOsHttpError } from './errors.js';
 export class RouterOsRestClient {
     baseUrl;
     authorization;

package/dist/runtime-adapters.d.ts

@@ -1,4 +1,4 @@
-import type { TelegramUpdate } from './types';
+import type { TelegramUpdate } from './types.js';
 export interface RuntimeAdapter {
     readonly fetch: typeof fetch;
     now(): Date;

package/dist/runtime.d.ts

@@ -1,7 +1,7 @@
-import type { PackageConfig } from './config';
-import { MikroTikService } from './mikrotik-service';
-import { TelegramCommandRegistry } from './telegram-commands';
-import type { CommandResponse, TelegramUpdate } from './types';
+import type { PackageConfig } from './config.js';
+import { MikroTikService } from './mikrotik-service.js';
+import { TelegramCommandRegistry } from './telegram-commands.js';
+import type { CommandResponse, TelegramUpdate } from './types.js';
 export interface NetPulseRuntime {
     readonly registry: TelegramCommandRegistry;
     readonly mikrotik: MikroTikService;

package/dist/runtime.js

@@ -1,8 +1,8 @@
-import { AuthorizationError } from './errors';
-import { RouterOsRestClient } from './rest-client';
-import { MikroTikService } from './mikrotik-service';
-import { TelegramClient } from './telegram-client';
-import { TelegramCommandRegistry } from './telegram-commands';
+import { AuthorizationError } from './errors.js';
+import { RouterOsRestClient } from './rest-client.js';
+import { MikroTikService } from './mikrotik-service.js';
+import { TelegramClient } from './telegram-client.js';
+import { TelegramCommandRegistry } from './telegram-commands.js';
 function roleFor(config, chatId) {
     if (config.security.adminChatIds.includes(chatId))
         return 'admin';

package/dist/telegram-client.d.ts

@@ -1,4 +1,4 @@
-import type { CommandResponse } from './types';
+import type { CommandResponse } from './types.js';
 export interface TelegramClientOptions {
     readonly token: string;
     readonly fetch?: typeof fetch;

package/dist/telegram-commands.d.ts

@@ -1,4 +1,4 @@
-import type { CommandContext, CommandDefinition, CommandResponse } from './types';
+import type { CommandContext, CommandDefinition, CommandResponse } from './types.js';
 export interface CommandRegistryOptions {
     readonly confirmationTtlMs?: number;
     readonly now?: () => number;

package/dist/telegram-commands.js

@@ -1,4 +1,4 @@
-import { AuthorizationError, ConfirmationRequiredError } from './errors';
+import { AuthorizationError, ConfirmationRequiredError } from './errors.js';
 const ROLE_WEIGHT = { viewer: 1, operator: 2, admin: 3 };
 export function parseCommand(text) {
     const tokens = text.trim().split(/\s+/).filter(Boolean);

package/examples/production-bot/.env.example

@@ -0,0 +1,16 @@
+MIKROTIK_HOST=192.168.1.64
+MIKROTIK_USER=netpulse-bot
+MIKROTIK_PASSWORD=replace-me
+MIKROTIK_HTTP_PORT=443
+MIKROTIK_HTTPS=true
+MIKROTIK_TIMEOUT_MS=10000
+
+TELEGRAM_BOT_TOKEN=replace-me
+TELEGRAM_ALLOWED_CHAT_IDS=123456789
+TELEGRAM_ADMIN_CHAT_IDS=123456789
+TELEGRAM_OPERATOR_CHAT_IDS=123456789
+TELEGRAM_WEBHOOK_SECRET=use-at-least-16-characters
+TELEGRAM_CONFIRMATION_TTL_SECONDS=60
+
+BOT_PORT=8787
+ALERT_INTERVAL_MS=300000

package/examples/production-bot/README.md

@@ -0,0 +1,48 @@
+# Production bot example
+
+A complete Node.js 20 example using the published `mikrotik-telegram` package.
+It is deliberately independent from Next.js, the parent application database, and the legacy Telegram bot.
+
+## Features exercised
+
+- Environment validation with `createConfigFromEnv()`.
+- RouterOS REST health, users, profiles, sessions, vouchers, scripts, and schedulers.
+- Telegram commands with viewer/operator/admin roles.
+- Expiring confirmation flow for `/ban` and `/disconnect`.
+- Protected action catalog and batch guardrails.
+- Router, traffic, and profile-stock alert evaluation.
+- Scheduled automation with health, stock, cleanup, and report rules.
+- Audit logging with JSON and CSV export commands.
+- Node HTTP webhook adapter with Telegram secret validation.
+
+## Run
+
+```bash
+cp .env.example .env
+# Fill in .env, then:
+npm install
+npm run build
+npm start
+```
+
+The webhook endpoint is `POST http://localhost:${BOT_PORT:-8787}/telegram/webhook`.
+Configure Telegram with `setWebhook` and the same `TELEGRAM_WEBHOOK_SECRET`.
+
+## Command catalogue
+
+- `/start` or `/help`: command list
+- `/health`: RouterOS health
+- `/users profile=guest-2h limit=20`: hotspot users
+- `/profiles`: hotspot profiles
+- `/sessions`: active sessions
+- `/vouchers count=10 profile=guest-2h dryRun=true`: preview or create vouchers
+- `/create-user name=alice password=secret profile=guest-2h`: create a user
+- `/ban address=192.0.2.10`: protected ban confirmation
+- `/disconnect session=*1`: protected session disconnect
+- `/create-script name=backup source=/system backup save name=nightly`: create script
+- `/create-scheduler name=nightly interval=1d onEvent=/system backup save name=nightly`: create scheduler
+- `/alerts`: run anomaly checks immediately
+- `/automation`: list configured rules
+- `/audit format=csv`: export the in-memory audit log
+
+The example intentionally keeps destructive actions explicit. In production, persist audit entries and automation state in your own durable store.

package/examples/production-bot/package-lock.json

@@ -0,0 +1,590 @@
+{
+  "name": "mikrotik-telegram-production-example",
+  "version": "0.1.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "mikrotik-telegram-production-example",
+      "version": "0.1.0",
+      "dependencies": {
+        "mikrotik-telegram": "file:../.."
+      },
+      "devDependencies": {
+        "@types/node": "^22.0.0",
+        "tsx": "^4.19.0",
+        "typescript": "^5.9.3"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "../..": {
+      "name": "mikrotik-telegram",
+      "version": "0.2.0",
+      "license": "MIT",
+      "dependencies": {
+        "zod": "^4.6.1"
+      },
+      "devDependencies": {
+        "typescript": "^5.9.3"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz",
+      "integrity": "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.2.tgz",
+      "integrity": "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.2.tgz",
+      "integrity": "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.2.tgz",
+      "integrity": "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.2.tgz",
+      "integrity": "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.2.tgz",
+      "integrity": "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.2.tgz",
+      "integrity": "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.2.tgz",
+      "integrity": "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.2.tgz",
+      "integrity": "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.2.tgz",
+      "integrity": "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.2.tgz",
+      "integrity": "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.2.tgz",
+      "integrity": "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.2.tgz",
+      "integrity": "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.2.tgz",
+      "integrity": "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.2.tgz",
+      "integrity": "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.2.tgz",
+      "integrity": "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.2.tgz",
+      "integrity": "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.2.tgz",
+      "integrity": "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.2.tgz",
+      "integrity": "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.2.tgz",
+      "integrity": "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.2.tgz",
+      "integrity": "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.2.tgz",
+      "integrity": "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.2.tgz",
+      "integrity": "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.2.tgz",
+      "integrity": "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.2.tgz",
+      "integrity": "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.2.tgz",
+      "integrity": "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@types/node": {
+      "version": "22.20.2",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.20.2.tgz",
+      "integrity": "sha512-xlvWf4Vs9n1PEVYwP1n4vvG07M6y8WgvJ2t0vbrWTmijsIHp1cS+uJ2kMIRdY3nHZK0nCYKrPeD171+SzF4/zw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.21.0"
+      }
+    },
+    "node_modules/esbuild": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.2.tgz",
+      "integrity": "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.28.2",
+        "@esbuild/android-arm": "0.28.2",
+        "@esbuild/android-arm64": "0.28.2",
+        "@esbuild/android-x64": "0.28.2",
+        "@esbuild/darwin-arm64": "0.28.2",
+        "@esbuild/darwin-x64": "0.28.2",
+        "@esbuild/freebsd-arm64": "0.28.2",
+        "@esbuild/freebsd-x64": "0.28.2",
+        "@esbuild/linux-arm": "0.28.2",
+        "@esbuild/linux-arm64": "0.28.2",
+        "@esbuild/linux-ia32": "0.28.2",
+        "@esbuild/linux-loong64": "0.28.2",
+        "@esbuild/linux-mips64el": "0.28.2",
+        "@esbuild/linux-ppc64": "0.28.2",
+        "@esbuild/linux-riscv64": "0.28.2",
+        "@esbuild/linux-s390x": "0.28.2",
+        "@esbuild/linux-x64": "0.28.2",
+        "@esbuild/netbsd-arm64": "0.28.2",
+        "@esbuild/netbsd-x64": "0.28.2",
+        "@esbuild/openbsd-arm64": "0.28.2",
+        "@esbuild/openbsd-x64": "0.28.2",
+        "@esbuild/openharmony-arm64": "0.28.2",
+        "@esbuild/sunos-x64": "0.28.2",
+        "@esbuild/win32-arm64": "0.28.2",
+        "@esbuild/win32-ia32": "0.28.2",
+        "@esbuild/win32-x64": "0.28.2"
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/mikrotik-telegram": {
+      "resolved": "../..",
+      "link": true
+    },
+    "node_modules/tsx": {
+      "version": "4.23.13",
+      "resolved": "https://registry.npmjs.org/tsx/-/tsx-4.23.13.tgz",
+      "integrity": "sha512-BL5MGkRln6aDYhb0xbQlEAGw743BaZYWdbWtdJOBriYJboKgUUYCadFp2/FpBBZquBC/ezNBn7wMMPx7FDZUDw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "~0.28.0"
+      },
+      "bin": {
+        "tsx": "dist/cli.mjs"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      }
+    },
+    "node_modules/typescript": {
+      "version": "5.9.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "6.21.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
+      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+      "dev": true,
+      "license": "MIT"
+    }
+  }
+}

package/examples/production-bot/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "mikrotik-telegram-production-example",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "mikrotik-telegram": "file:../.."
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.9.3"
+  }
+}

package/examples/production-bot/src/index.ts

@@ -0,0 +1,194 @@
+import { createServer, type IncomingMessage } from 'node:http';
+import {
+    AlertEngine,
+    AutomationEngine,
+    createAuditLogger,
+    createConfigFromEnv,
+    createProtectedAction,
+    createRouterActionCatalog,
+    createRuntime,
+    createWebhookHandler,
+    evaluateRouterAnomalies,
+    evaluateStockAnomalies,
+    evaluateTrafficAnomalies,
+    exportAuditLog,
+    TelegramClient,
+    type ActionContext,
+    type Alert,
+    type AutomationAction,
+    type CommandContext,
+    type CommandResponse,
+    type TelegramUpdate,
+} from 'mikrotik-telegram';
+
+const config = createConfigFromEnv(process.env);
+const runtime = createRuntime(config);
+const telegram = new TelegramClient({ token: config.telegram.token });
+const audit = createAuditLogger('production-bot');
+const alertEngine = new AlertEngine(15 * 60_000);
+const automation = new AutomationEngine();
+
+function response(text: string): CommandResponse {
+  return { text };
+}
+
+function formatAlerts(alerts: readonly Alert[]): string {
+  return alerts.length
+    ? alerts.map((alert) => `${alert.severity.toUpperCase()}: ${alert.title}\n${alert.message}`).join('\n\n')
+    : 'Aucune anomalie détectée.';
+}
+
+async function notifyOperators(alerts: readonly Alert[]): Promise<void> {
+  if (!alerts.length) return;
+  const message = formatAlerts(alerts);
+  for (const chatId of config.security.operatorChatIds) {
+    await telegram.sendMessage(chatId, response(`🚨 NetPulse alertes\n\n${message}`));
+  }
+}
+
+function actionContext(context: CommandContext): ActionContext {
+  return { chatId: context.chatId, userId: context.userId, role: context.role };
+}
+
+const actions = createRouterActionCatalog({
+  async health() {
+    return { ok: true, data: await runtime.mikrotik.getSystemHealth() };
+  },
+  async disconnectUser(input) {
+    return { ok: true, data: await runtime.mikrotik.disconnectUser(input) };
+  },
+  async banUser(input) {
+    return { ok: true, data: await runtime.mikrotik.banUser(input) };
+  },
+});
+
+const disconnectAction = createProtectedAction(
+  'disconnect-session',
+  async (input: { sessionId: string }, context) => {
+    const result = await actions.disconnectUser(input);
+    audit.log({ action: 'session.disconnect', actor: context.userId, resource: input.sessionId, status: result.ok ? 'success' : 'failure', metadata: { result: result.data } });
+    return result;
+  },
+  { requiredRole: 'operator', requiresConfirmation: true, maxBatchSize: 1, confirm: async () => ({ ok: true }) },
+);
+
+const banAction = createProtectedAction(
+  'ban-user',
+  async (input: { address: string; timeout?: string }, context) => {
+    const result = await actions.banUser(input);
+    audit.log({ action: 'user.ban', actor: context.userId, resource: input.address, status: result.ok ? 'success' : 'failure', metadata: { result: result.data } });
+    return result;
+  },
+  { requiredRole: 'admin', requiresConfirmation: true, confirm: async () => ({ ok: true }) },
+);
+
+async function runHealthCheck(): Promise<{ alerts: readonly Alert[] }> {
+  try {
+    const health = await runtime.mikrotik.getSystemHealth();
+    const evaluation = evaluateRouterAnomalies({ online: true, health });
+    const filtered = alertEngine.filter(evaluation.alerts);
+    audit.log({ action: 'automation.health-check', resource: health.identity, status: 'success', metadata: { alerts: filtered.alerts.length } });
+    await notifyOperators(filtered.alerts);
+    return filtered;
+  } catch (error) {
+    const evaluation = evaluateRouterAnomalies({ online: false });
+    const filtered = alertEngine.filter(evaluation.alerts);
+    audit.log({ action: 'automation.health-check', status: 'failure', metadata: { error: String(error) } });
+    await notifyOperators(filtered.alerts);
+    return filtered;
+  }
+}
+
+async function runStockCheck(): Promise<{ alerts: readonly Alert[] }> {
+  const profiles = await runtime.mikrotik.listProfiles();
+  const filtered = alertEngine.filter(evaluateStockAnomalies(profiles).alerts);
+  audit.log({ action: 'automation.stock-check', status: 'success', metadata: { profiles: profiles.length, alerts: filtered.alerts.length } });
+  await notifyOperators(filtered.alerts);
+  return filtered;
+}
+
+async function executeAutomation(action: AutomationAction, rule: { id: string }) {
+  const startedAt = new Date().toISOString();
+  if (action === 'health-check') {
+    const result = await runHealthCheck();
+    return { ruleId: rule.id, action, success: true, startedAt, finishedAt: new Date().toISOString(), alerts: result.alerts };
+  }
+  if (action === 'stock-check') {
+    const result = await runStockCheck();
+    return { ruleId: rule.id, action, success: true, startedAt, finishedAt: new Date().toISOString(), alerts: result.alerts };
+  }
+  if (action === 'cleanup-sessions') {
+    const sessions = await runtime.mikrotik.listActiveSessions();
+    audit.log({ action: 'automation.cleanup-sessions', status: 'success', metadata: { activeSessions: sessions.length } });
+    return { ruleId: rule.id, action, success: true, startedAt, finishedAt: new Date().toISOString() };
+  }
+  audit.log({ action: `automation.${action}`, status: 'success' });
+  return { ruleId: rule.id, action, success: true, startedAt, finishedAt: new Date().toISOString() };
+}
+
+automation.register({ id: 'health', name: 'Router health', action: 'health-check', intervalMs: Number(process.env.ALERT_INTERVAL_MS || 300_000), enabled: true, runImmediately: true });
+automation.register({ id: 'stock', name: 'Profile capacity', action: 'stock-check', intervalMs: 900_000, enabled: true, runImmediately: false });
+automation.register({ id: 'sessions', name: 'Session inventory', action: 'cleanup-sessions', intervalMs: 600_000, enabled: true, runImmediately: false });
+
+runtime.registry.registerMany([
+  { name: 'automation', description: 'Lister les automatisations', minimumRole: 'viewer', execute: async () => response(automation.list().map((rule) => `• ${rule.id}: ${rule.action} (${rule.enabled ? 'active' : 'pause'})`).join('\n')) },
+  { name: 'health', aliases: ['status'], description: 'État du routeur', minimumRole: 'viewer', execute: async () => { const health = await runtime.mikrotik.getSystemHealth(); return response(`🟢 ${health.identity} · ${health.model}\nCPU: ${health.cpuLoadPercent}%\nRAM libre: ${Math.round(health.freeMemoryBytes / 1048576)} MB\nREST: ${health.latencyMs} ms`); } },
+  { name: 'users', description: 'Lister les utilisateurs hotspot', minimumRole: 'viewer', execute: async (context) => { const users = await runtime.mikrotik.listHotspotUsers({ profile: context.args.profile, limit: Number(context.args.limit || 20) }); return response(users.length ? users.map((user) => `• ${user.name} · ${user.profile || 'default'} · ${user.id}`).join('\n') : 'Aucun utilisateur.'); } },
+  { name: 'profiles', description: 'Lister les profils', minimumRole: 'viewer', execute: async () => { const profiles = await runtime.mikrotik.listProfiles(); return response(profiles.map((profile) => `• ${profile.name} · ${profile.rateLimit || 'illimité'} · shared=${profile.sharedUsers ?? 0}`).join('\n') || 'Aucun profil.'); } },
+  { name: 'sessions', description: 'Lister les sessions', minimumRole: 'viewer', execute: async () => { const sessions = await runtime.mikrotik.listActiveSessions(); return response(sessions.map((session) => `• ${session.user} · ${session.address || '?'} · ${session.id}`).join('\n') || 'Aucune session.'); } },
+  { name: 'vouchers', aliases: ['generate'], description: 'Générer des vouchers', minimumRole: 'operator', execute: async (context) => { const result = await runtime.mikrotik.generateVouchers({ count: Number(context.args.count || context.positional[0] || 1), profile: context.args.profile || 'default', prefix: context.args.prefix || 'NET', limitUptime: context.args.duration, comment: context.args.comment, dryRun: context.args.dryRun === 'true' }); audit.log({ action: 'voucher.generate', actor: context.userId, status: 'success', metadata: { requested: result.requested, created: result.created, dryRun: result.dryRun } }); return response(`${result.dryRun ? 'Aperçu' : 'Créés'}: ${result.created || result.requested}\n${result.vouchers.map((voucher) => `${voucher.name} · ${voucher.password}`).join('\n')}`); } },
+  { name: 'create-user', description: 'Créer un utilisateur', minimumRole: 'operator', execute: async (context) => { const name = context.args.name || context.positional[0]; const password = context.args.password; const profile = context.args.profile || 'default'; if (!name || !password) return response('Usage: /create-user name=alice password=secret profile=guest-2h'); const user = await runtime.mikrotik.createHotspotUser({ name, password, profile, comment: context.args.comment }); audit.log({ action: 'user.create', actor: context.userId, resource: user.id, status: 'success', metadata: { name, profile } }); return response(`Utilisateur créé: ${user.name} · ${user.id}`); } },
+  { name: 'ban', description: 'Bannir une adresse', minimumRole: 'admin', execute: async (context) => { const address = context.args.address || context.positional[0]; if (!address) return response('Usage: /ban address=192.0.2.10'); if (context.args.confirm !== 'yes') return runtime.registry.requestConfirmation(context, `/ban address=${address} confirm=yes`); const result = await banAction({ address, timeout: context.args.timeout }, actionContext(context)); return response(result.ok ? `Adresse bannie: ${address}` : result.error || 'Échec du bannissement.'); } },
+  { name: 'disconnect', description: 'Déconnecter une session', minimumRole: 'operator', execute: async (context) => { const sessionId = context.args.session || context.positional[0]; if (!sessionId) return response('Usage: /disconnect session=*1'); if (context.args.confirm !== 'yes') return runtime.registry.requestConfirmation(context, `/disconnect session=${sessionId} confirm=yes`); const result = await disconnectAction({ sessionId }, actionContext(context)); return response(result.ok ? `Session déconnectée: ${sessionId}` : result.error || 'Échec de la déconnexion.'); } },
+  { name: 'create-script', description: 'Créer un script RouterOS', minimumRole: 'admin', execute: async (context) => { const name = context.args.name; const source = context.args.source || context.positional.slice(1).join(' '); if (!name || !source) return response('Usage: /create-script name=backup source=/system backup save'); const script = await runtime.mikrotik.createScript({ name, source }); audit.log({ action: 'script.create', actor: context.userId, resource: script.id, status: 'success' }); return response(`Script créé: ${script.name} · ${script.id}`); } },
+  { name: 'create-scheduler', description: 'Créer un scheduler RouterOS', minimumRole: 'admin', execute: async (context) => { const name = context.args.name; const interval = context.args.interval; const onEvent = context.args.onEvent; if (!name || !interval || !onEvent) return response('Usage: /create-scheduler name=nightly interval=1d onEvent=/system backup save'); const scheduler = await runtime.mikrotik.createScheduler({ name, interval, onEvent }); audit.log({ action: 'scheduler.create', actor: context.userId, resource: scheduler.id, status: 'success' }); return response(`Scheduler créé: ${scheduler.name} · ${scheduler.id}`); } },
+  { name: 'alerts', description: 'Lancer les contrôles', minimumRole: 'operator', execute: async () => { const health = await runHealthCheck(); const stock = await runStockCheck(); const traffic = evaluateTrafficAnomalies({ online: true, totalSessions: (await runtime.mikrotik.listActiveSessions()).length, peakSessions: 100 }); const filtered = alertEngine.filter(traffic.alerts); await notifyOperators(filtered.alerts); return response(formatAlerts([...health.alerts, ...stock.alerts, ...filtered.alerts])); } },
+  { name: 'audit', description: 'Exporter les audits', minimumRole: 'admin', execute: async (context) => { const format = context.args.format === 'csv' ? 'csv' : 'json'; return response(exportAuditLog(audit.snapshot(), format)); } },
+]);
+
+async function handleUpdate(update: TelegramUpdate): Promise<unknown> {
+  if (update.callback_query?.data && update.callback_query.message) {
+    const chatId = String(update.callback_query.message.chat.id);
+    const callbackResponse = await runtime.registry.executeCallback(update.callback_query.data, chatId);
+    await telegram.answerCallbackQuery(update.callback_query.id, callbackResponse.text);
+    const confirmedCommand = callbackResponse.text.match(/^Action confirmée: (.+)$/)?.[1];
+    if (confirmedCommand) return runtime.handleUpdate({ update_id: update.update_id, message: { message_id: update.update_id, text: confirmedCommand, chat: { id: chatId, type: 'private' }, from: { id: update.callback_query.from.id } } });
+    return telegram.sendMessage(chatId, callbackResponse);
+  }
+  return runtime.handleUpdate(update);
+}
+
+function toRequest(request: IncomingMessage, body: string): Request {
+  const protocol = 'http';
+  const host = request.headers.host || 'localhost';
+  return new Request(`${protocol}://${host}${request.url || '/'}`, { method: request.method, headers: request.headers as Record<string, string>, body: request.method === 'POST' ? body : undefined });
+}
+
+const webhook = createWebhookHandler(handleUpdate, { secret: config.telegram.webhookSecret });
+const server = createServer(async (request, response) => {
+  const chunks: Buffer[] = [];
+  request.on('data', (chunk: Buffer) => chunks.push(chunk));
+  request.on('end', async () => {
+    if (request.url !== '/telegram/webhook') { response.writeHead(404).end('Not Found'); return; }
+    const result = await webhook(toRequest(request, Buffer.concat(chunks).toString('utf8')));
+    response.writeHead(result.status, Object.fromEntries(result.headers.entries())).end(await result.text());
+  });
+});
+
+const port = Number(process.env.BOT_PORT || 8787);
+server.listen(port, () => console.log(`Production bot listening on http://localhost:${port}/telegram/webhook`));
+
+const automationTimer = setInterval(async () => {
+  const results = await automation.runDue({ now: new Date(), execute: executeAutomation });
+  for (const result of results) if (!result.success) audit.log({ action: `automation.${result.action}`, status: 'failure', metadata: { result } });
+}, 30_000);
+
+automationTimer.unref();
+
+function shutdown(signal: string): void {
+  clearInterval(automationTimer);
+  server.close(() => { console.log(`Stopped on ${signal}`); process.exit(0); });
+}
+
+process.once('SIGINT', () => shutdown('SIGINT'));
+process.once('SIGTERM', () => shutdown('SIGTERM'));

package/examples/production-bot/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mikrotik-telegram",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Type-safe RouterOS REST automation and Telegram bot package for modern MikroTik operations.",
   "license": "MIT",
   "private": false,
@@ -23,7 +23,8 @@
     "dist",
     "README.md",
     "LICENSE",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "examples"
   ],
   "publishConfig": {
     "access": "public"