@wrongstack/telegram 0.293.0 → 0.295.1

package/README.md

@@ -52,7 +52,7 @@ you to open a credential-bearing Bot API URL.
 ### 4. Configure manually (optional)
 
 The setup command writes this configuration securely. For custom hosts, the
-equivalent shape in `~/.wrongstack/config.json` or `.wrongstack/config.json` is:
+equivalent shape in the active `~/.wrongstack/profiles/<name>/config.json` is:
 
 ```jsonc
 {

package/dist/api-client.d.ts

@@ -92,6 +92,8 @@ export interface TelegramApiClientOptions {
 }
 export interface TelegramRequestOptions {
     signal?: AbortSignal | undefined;
+    /** Optional parse_mode override for this call. */
+    parseMode?: '' | 'HTML' | 'MarkdownV2' | undefined;
 }
 export interface TelegramGetUpdatesOptions extends TelegramRequestOptions {
     deadlineMs?: number | undefined;

package/dist/api-client.d.ts.map

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

package/dist/bot-queue.d.ts

@@ -1,4 +1,4 @@
-import type { Logger } from '@wrongstack/core';
+import type { Logger } from '@wrongstack/core/types';
 import type { TelegramApiMessage } from './api-client.js';
 import type { TelegramBot, TelegramBotResponse } from './bot.js';
 export interface BotOutboundOptions {
@@ -9,6 +9,21 @@ export interface BotOutboundOptions {
     readonly maxPerChat?: number;
     /** Optional override; defaults to 4 concurrent sends. */
     readonly maxConcurrency?: number;
+    /**
+     * Live getter for tokens per second on the per-chat rate limiter.
+     * Default: 0.33 (≈20 messages/minute, safe for groups).
+     * Private chats can safely use 30.
+     * Passed as a getter so config hot-reload takes effect on the next new
+     * bucket (existing buckets retain their captured parameters for the
+     * queue lifetime, which is the intended lifetime of the bot).
+     */
+    readonly getRateLimitTokensPerSecond?: (() => number) | undefined;
+    /**
+     * Live getter for maximum burst size on the per-chat rate limiter.
+     * Default: 4. Read lazily per new-bucket creation so config
+     * hot-reload propagates without queue rebuild.
+     */
+    readonly getRateLimitBurst?: (() => number) | undefined;
 }
 export declare class TelegramBotOutbound {
     #private;

package/dist/bot-queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bot-queue.d.ts","sourceRoot":"","sources":["../src/bot-queue.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGjE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,wFAAwF;IACxF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,qBAAa,mBAAmB;;IAM9B,YAAY,IAAI,EAAE,kBAAkB,EAenC;IAED,gFAAgF;IAC1E,UAAU,CACd,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC,CASlD;IAED;;;;OAIG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAW/D;IAED,KAAK,qDAEJ;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1B;CACF"}
+{"version":3,"file":"bot-queue.d.ts","sourceRoot":"","sources":["../src/bot-queue.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAIjE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,wFAAwF;IACxF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,2BAA2B,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;IAClE;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;CACzD;AAKD,qBAAa,mBAAmB;;IAU9B,YAAY,IAAI,EAAE,kBAAkB,EAmBnC;IAsCD,gFAAgF;IAC1E,UAAU,CACd,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC,CASlD;IAED;;;;OAIG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAS/D;IAED,KAAK,qDAEJ;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAI1B;CACF"}

package/dist/bot.d.ts

@@ -1,4 +1,4 @@
-import type { Logger } from '@wrongstack/core';
+import type { Logger } from '@wrongstack/core/types';
 import { type TelegramApiMessage } from './api-client.js';
 import type { OffsetStore } from './offset-store.js';
 import type { PollLock } from './poll-lock.js';
@@ -39,6 +39,12 @@ export interface TelegramBotOptions {
     /** Max messages to buffer for the agent to read. Default: 50. */
     bufferSize: number;
     log: Logger;
+    /**
+     * Resolved on every outbound send so live `parseMode` config changes
+     * (via `api.onConfigChange`) take effect without restarting the plugin.
+     * Empty string or `undefined` → plain text. See `TelegramPluginConfig.parseMode`.
+     */
+    getParseMode?: () => '' | 'HTML' | 'MarkdownV2' | undefined;
     /** Called for each incoming message that passes allowlist checks. */
     onMessage(msg: TelegramIncomingMessage): void;
     /**
@@ -84,6 +90,7 @@ export declare class TelegramBot {
     /** Single-poller election across wstack instances sharing this token. */
     private readonly lock?;
     private readonly standbyRetryMs;
+    private readonly getParseMode?;
     private standbyTimer;
     private standbyAnnounced;
     private readonly bufferMax;

package/dist/bot.d.ts.map

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

package/dist/config-classifier.d.ts

@@ -1,56 +1,5 @@
-import type { TelegramPluginConfig } from './config.js';
-/**
- * Keys the Telegram plugin can apply live without restarting the bot.
- *
- * Rationale per key:
- * - `inboundMode` / `allowedUsers` / `allowedChats` — `processMessage`
- *   and `dispatchCallback` re-read the allowlist on every inbound call,
- *   so toggling the mode or editing the lists takes effect immediately.
- * - `notifyOnSessionEnd` / `notifyOnDelegate` — re-evaluated on each
- *   event subscription; no in-flight state to restart.
- * - `longToolThresholdMs` — pure threshold read inside the tool-notify
- *   handler; the next long-tool event uses the new value.
- * - `maxMessageLength` / `allowedOutboundChats` — re-read on every
- *   `sendMessage` / outbound-target resolution, so the next send reflects
- *   the change.
- * - `pollIntervalSec` — the poller reads this on each iteration of its
- *   wait loop; the next tick uses the new interval.
- * - `outboundQueuePerChat` / `outboundQueueConcurrency` — the outbound
- *   queue reads these only at construction. They are documented as
- *   hot-reload in spirit (the queue can be re-evaluated) but the live
- *   queue owns a stable copy. Marking them HOT would silently mislead,
- *   so they are intentionally EXCLUDED until the queue supports
- *   mid-flight reconfiguration. See `restart-required` below.
- */
-export declare const HOT_RELOAD_KEYS: Set<keyof TelegramPluginConfig>;
-/**
- * Keys that require restarting the Telegram plugin (or wstack itself)
- * for the new value to take effect.
- *
- * - `botToken` — every Telegram transport object is constructed once with
- *   the token baked into the base URL; changing it requires a new
- *   `TelegramBot` instance.
- * - `notifyChatId` — bound into the optional-allowedUsers fallback at
- *   setup (`inboundAllowlist`) and read by every notification callback;
- *   the inbound allowlist does not rebuild without a setup re-run.
- * - `offsetStoragePath` — the `OffsetStore` is opened once at setup;
- *   changing the path would orphan any persisted cursor.
- * - `singleInstanceLock` — the cross-process `PollLock` is acquired at
- *   startup; flipping this flag requires a fresh setup to acquire /
- *   release the right lock file.
- * - `outboundQueuePerChat` / `outboundQueueConcurrency` — the
- *   `OutboundQueue` reads these at construction only.
- */
-export declare const RESTART_REQUIRED_KEYS: Set<keyof TelegramPluginConfig>;
+import { type TelegramPluginConfig } from './config.js';
 export type ConfigReloadClass = 'hot' | 'restart-required';
-/**
- * Classify a single key. Returns `'hot'` for keys in `HOT_RELOAD_KEYS`,
- * `'restart-required'` for keys in `RESTART_REQUIRED_KEYS`, and
- * `'restart-required'` as a conservative default for keys that are not
- * registered in either set — preventing a new field from silently
- * pretending to be hot-reloadable before the classifier is updated.
- */
-export declare function classifyReload(key: keyof TelegramPluginConfig): ConfigReloadClass;
 /**
  * Diff two configs and return the keys whose values differ, each tagged
  * with its reload classification. Keys present in `previous` but absent in

package/dist/config-classifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-classifier.d.ts","sourceRoot":"","sources":["../src/config-classifier.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,eAAe,iCAU1B,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,iCAOhC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,kBAAkB,CAAC;AAE3D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,oBAAoB,GAAG,iBAAiB,CAGjF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,oBAAoB,EAC9B,IAAI,EAAE,oBAAoB,GACzB,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;IAAC,cAAc,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAc/E"}
+{"version":3,"file":"config-classifier.d.ts","sourceRoot":"","sources":["../src/config-classifier.ts"],"names":[],"mappings":"AAmBA,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,kBAAkB,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,oBAAoB,EAC9B,IAAI,EAAE,oBAAoB,GACzB,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;IAAC,cAAc,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAY/E"}

package/dist/config.d.ts

@@ -1,5 +1,7 @@
-import type { PluginAPI } from '@wrongstack/core';
+import { type PluginAPI } from '@wrongstack/core/plugin';
+import type { Config } from '@wrongstack/core/types';
 export declare const PLUGIN_NAME = "telegram";
+export declare const PLUGIN_CONFIG_ALIASES: readonly ['@wrongstack/telegram'];
 export type TelegramInboundMode = 'disabled' | 'paired' | 'allowlist' | 'public';
 export interface TelegramPluginConfig {
     /** Telegram Bot API token (from @BotFather). */
@@ -54,8 +56,84 @@ export interface TelegramPluginConfig {
     outboundQueuePerChat?: number | undefined;
     /** Maximum concurrent outbound sends across all chats. Default: 4. */
     outboundQueueConcurrency?: number | undefined;
+    /** Permit group-chat approvals only when an explicit user allowlist also matches. */
+    allowGroupApprovals?: boolean | undefined;
+    /** Per-chat rate limit (tokens per second). Default: 0.33 (≈20 msg/min). */
+    rateLimitTokensPerSecond?: number | undefined;
+    /** Per-chat rate limit burst size. Default: 4. */
+    rateLimitBurst?: number | undefined;
+    /**
+     * Telegram parse mode for message text formatting. Supports:
+     * - `'HTML'` — `<b>bold</b>`, `<i>italic</i>`, `<a href="...">link</a>`, `<code>mono</code>`, `<pre>code block</pre>`
+     * - `'MarkdownV2'` — `*bold*`, `_italic_`, `[link](url)`, `` `code` ``, ```pre```
+     * - unset / `''` — plain text (no formatting)
+     */
+    parseMode?: '' | 'HTML' | 'MarkdownV2' | undefined;
 }
 export declare const DEFAULT_CONFIG: Required<Omit<TelegramPluginConfig, 'botToken' | 'notifyChatId' | 'offsetStoragePath'>>;
+export declare const TELEGRAM_CONFIG_FIELDS: {
+    readonly botToken: {
+        readonly lifecycle: 'restart';
+        readonly secret: true;
+    };
+    readonly notifyChatId: {
+        readonly lifecycle: 'restart';
+    };
+    readonly inboundMode: {
+        readonly lifecycle: 'hot';
+    };
+    readonly allowedUsers: {
+        readonly lifecycle: 'hot';
+    };
+    readonly allowedChats: {
+        readonly lifecycle: 'hot';
+    };
+    readonly allowedOutboundChats: {
+        readonly lifecycle: 'hot';
+    };
+    readonly allowGroupApprovals: {
+        readonly lifecycle: 'hot';
+    };
+    readonly pollIntervalSec: {
+        readonly lifecycle: 'hot';
+    };
+    readonly notifyOnSessionEnd: {
+        readonly lifecycle: 'hot';
+    };
+    readonly longToolThresholdMs: {
+        readonly lifecycle: 'hot';
+    };
+    readonly notifyOnDelegate: {
+        readonly lifecycle: 'hot';
+    };
+    readonly maxMessageLength: {
+        readonly lifecycle: 'hot';
+    };
+    readonly offsetStoragePath: {
+        readonly lifecycle: 'immutable';
+    };
+    readonly singleInstanceLock: {
+        readonly lifecycle: 'restart';
+    };
+    readonly outboundQueuePerChat: {
+        readonly lifecycle: 'restart';
+    };
+    readonly outboundQueueConcurrency: {
+        readonly lifecycle: 'restart';
+    };
+    readonly rateLimitTokensPerSecond: {
+        readonly lifecycle: 'hot';
+        readonly description: 'Per-chat rate limit (tokens/sec)';
+    };
+    readonly rateLimitBurst: {
+        readonly lifecycle: 'hot';
+        readonly description: 'Per-chat rate limit burst size';
+    };
+    readonly parseMode: {
+        readonly lifecycle: 'hot';
+        readonly description: 'Telegram parse mode: HTML, MarkdownV2, or empty for plain text';
+    };
+};
 export declare const telegramConfigSchema: {
     type: string;
     properties: {
@@ -123,6 +201,9 @@ export declare const telegramConfigSchema: {
             minimum: number;
             maximum: number;
         };
+        offsetStoragePath: {
+            type: string;
+        };
         singleInstanceLock: {
             type: string;
             description: string;
@@ -139,8 +220,36 @@ export declare const telegramConfigSchema: {
             maximum: number;
             description: string;
         };
+        allowGroupApprovals: {
+            type: string;
+        };
+        rateLimitTokensPerSecond: {
+            type: string;
+            minimum: number;
+            maximum: number;
+            description: string;
+        };
+        rateLimitBurst: {
+            type: string;
+            minimum: number;
+            maximum: number;
+            description: string;
+        };
+        parseMode: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
     };
     required: string[];
 };
 export declare function readTelegramConfig(api: Pick<PluginAPI, 'config'> & Partial<Pick<PluginAPI, 'log'>>): Required<Omit<TelegramPluginConfig, 'notifyChatId' | 'offsetStoragePath'>> & Pick<TelegramPluginConfig, 'notifyChatId' | 'offsetStoragePath'>;
+/**
+ * Read the Telegram config section from a raw `Config` snapshot.
+ * Used by `api.onConfigChange` callbacks that receive `(next: Config, prev: Config)`
+ * rather than a `PluginAPI`.  Delegates to {@link readTelegramConfig} so the
+ * merge logic (legacy plugins, extension opts, inbound-mode resolution,
+ * defaults) stays in one place.
+ */
+export declare function readTelegramConfigFromConfig(cfg: Config): TelegramPluginConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,eAAO,MAAM,WAAW,aAAa,CAAC;AAEtC,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAIjF,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C;;;;OAIG;IACH,WAAW,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC9C,mEAAmE;IACnE,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC;IAClD,mEAAmE;IACnE,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC;IAClD,2EAA2E;IAC3E,oBAAoB,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC;IAC1D,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,sEAAsE;IACtE,wBAAwB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/C;AAED,eAAO,MAAM,cAAc,EAAE,QAAQ,CACnC,IAAI,CAAC,oBAAoB,EAAE,UAAU,GAAG,cAAc,GAAG,mBAAmB,CAAC,CAc9E,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;YAGjB,IAAI;YAAY,WAAW;;;;;;;;;YAMrC,IAAI;YACJ,IAAI;YACJ,OAAO;YACP,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAmBX,IAAI;YACJ,OAAO;YACP,OAAO;YACP,WAAW;;;YAES,IAAI;;;YACH,IAAI;YAAa,OAAO;;;YAC3B,IAAI;;;YACJ,IAAI;YAAa,OAAO;YAAO,OAAO;;;YAExD,IAAI;YACJ,WAAW;;;YAIX,IAAI;YACJ,OAAO;YACP,OAAO;YACP,WAAW;;;YAGX,IAAI;YACJ,OAAO;YACP,OAAO;YACP,WAAW;;;;CAIhB,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,GAC/D,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,cAAc,GAAG,mBAAmB,CAAC,CAAC,GAC3E,IAAI,CAAC,oBAAoB,EAAE,cAAc,GAAG,mBAAmB,CAAC,CAuBjE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { Plugin } from '@wrongstack/core';
+import type { Plugin } from '@wrongstack/core/types';
 import { TelegramBot } from './bot.js';
 import { TelegramBotOutbound } from './bot-queue.js';
 interface RuntimeState {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,MAAM,EAA2B,MAAM,kBAAkB,CAAC;AAGxF,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AASvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAwBrD,UAAU,YAAY;IACpB,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;CAC7B;AAED,QAAA,IAAI,aAAa,EAAE,YAAY,GAAG,IAAW,CAAC;AA+F9C,QAAA,MAAM,MAAM,EAAE,MAyUb,CAAC;eAEa,MAAM;AAGrB,OAAO,EAAE,aAAa,EAAE,CAAC;AAGzB,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,YAAY,EAAE,kCAAkC,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,MAAM,EAAgB,MAAM,wBAAwB,CAAC;AAGnF,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAiBvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AA+BrD,UAAU,YAAY;IACpB,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;CAC7B;AAED,QAAA,IAAI,aAAa,EAAE,YAAY,GAAG,IAAW,CAAC;AAiH9C,QAAA,MAAM,MAAM,EAAE,MAgab,CAAC;eAEa,MAAM;AAGrB,OAAO,EAAE,aAAa,EAAE,CAAC;AAGzB,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,YAAY,EAAE,kCAAkC,EAAE,MAAM,2BAA2B,CAAC"}