@grom.js/effect-tg 0.9.0 → 0.11.0

package/README.md

@@ -1,7 +1,9 @@
 # effect-tg
 
-[![Effectful](https://img.shields.io/badge/Effectful-%23000?style=flat&logo=effect&logoColor=%23fff)](https://effect.website/)
-[![npm](https://img.shields.io/npm/v/%40grom.js%2Feffect-tg?style=flat&logo=npm&logoColor=%23BB443E&logoSize=auto&label=%C2%A0&labelColor=%23fff&color=%23BB443E)](https://www.npmjs.com/package/@grom.js/effect-tg)
+[![Effectful](https://img.shields.io/badge/Yes.-%23fff?style=flat&logo=effect&logoColor=%23000&logoSize=auto&label=Effect%3F&labelColor=%23fff&color=%23000)](https://effect.website/)
+[![Bot API](https://img.shields.io/badge/v9.4-%23fff?style=flat&logo=telegram&logoColor=%2325A3E1&logoSize=auto&label=Bot%20API&labelColor=%23fff&color=%2325A3E1)](https://core.telegram.org/bots/api)
+[![npm](https://img.shields.io/npm/v/%40grom.js%2Feffect-tg?style=flat&logo=npm&logoColor=%23BB443E&logoSize=auto&label=Latest&labelColor=%23fff&color=%23BB443E)](https://www.npmjs.com/package/@grom.js/effect-tg)
+[![codecov](https://img.shields.io/codecov/c/github/grom-dev/effect-tg?style=flat&logo=codecov&logoColor=%23f07&label=Coverage&labelColor=%23fff&color=%23f07)](https://codecov.io/gh/grom-dev/effect-tg)
 
 Effectful library for crafting Telegram bots.
 
@@ -9,6 +11,8 @@ Effectful library for crafting Telegram bots.
 
 - Modular design to build with [Effect](https://effect.website).
 - Complete type definitions for [Bot API](https://core.telegram.org/bots/api) methods and types.
+- Composable API for [sending messages](#sending-messages).
+- [JSX syntax](#jsx-syntax) support for creating formatted text.
 
 ## Installation
 
@@ -18,6 +22,9 @@ npm install @grom.js/effect-tg
 
 # Install Effect dependencies
 npm install effect @effect/platform
+
+# Install JSX runtime for formatted text
+npm install @grom.js/tgx
 ```
 
 ## Working with Bot API
@@ -66,7 +73,7 @@ const program = Effect.gen(function* () {
 `BotApi` has a layered architecture:
 
 ```
-┌• BotApi — typed interface that delegates calls to `BotApiTransport`.
+┌• BotApi — typed interface that delegates calls to BotApiTransport.
 └─┬• BotApiTransport — serializes parameters, sends HTTP requests, parses responses.
   ├──• BotApiUrl — constructs endpoint URLs to methods and files.
   └──• HttpClient — performs HTTP requests.
@@ -78,22 +85,25 @@ This design enables:
 - **Testability**: Mock implementation of `BotApiTransport` or `HttpClient` to test your bot.
 - **Portability:** Provide different `BotApiUrl` to run a bot on test environment or with local Bot API server.
 
-**Example:** Constructing `BotApi` layer.
+**Example:** Constructing `BotApi` layer with method call tracing.
 
 ```ts
 import { FetchHttpClient } from '@effect/platform'
-import { BotApi, BotApiTransport, BotApiUrl } from '@grom.js/effect-tg'
-import { Effect, Layer } from 'effect'
-
-const BotApiLive = BotApi.layer.pipe(
-  Layer.provide(BotApiTransport.layer),
-  Layer.provide(
-    Layer.succeed(
-      BotApiUrl.BotApiUrl,
-      BotApiUrl.makeProd('YOUR_BOT_TOKEN')
-    )
-  ),
-  Layer.provide(FetchHttpClient.layer),
+import { BotApi } from '@grom.js/effect-tg'
+import { Config, Effect, Layer } from 'effect'
+
+const BotApiLive = Layer.provide(
+  BotApi.layerConfig({
+    token: Config.redacted('BOT_TOKEN'),
+    environment: 'prod',
+    transformTransport: transport => ({
+      sendRequest: (method, params) =>
+        transport.sendRequest(method, params).pipe(
+          Effect.withSpan(method),
+        ),
+    }),
+  }),
+  FetchHttpClient.layer
 )
 ```
 
@@ -101,11 +111,11 @@ const BotApiLive = BotApi.layer.pipe(
 
 Failed `BotApi` method calls result in `BotApiError`, which is a union of tagged errors with additional information:
 
-- `TransportError` — HTTP or network failure. `cause` property contains the original error from `HttpClient`.
-- `RateLimited` — bot has exceeded flood limit. `retryAfter` property contains the duration to wait before retry.
-- `GroupUpgraded` — group has been migrated to supergroup. `supergroup` property contains an object with the new ID.
-- `MethodFailed` — response was unsuccessful, but the exact reason could not be determined. `possibleReason` property contains common failure reasons as string literals, determined by error code and description, which are subject to change.
-- `InternalServerError` — Bot API server failed with 5xx error code.
+- **`TransportError`** — HTTP or network failure. The `cause` property contains the original error from `HttpClient`.
+- **`RateLimited`** — bot has exceeded the flood limit. The `retryAfter` property contains the duration to wait before the next attempt.
+- **`GroupUpgraded`** — group has been migrated to a supergroup. The `supergroup` property contains an object with the ID of the new supergroup.
+- **`MethodFailed`** — response was unsuccessful, but the exact reason could not be determined. The `possibleReason` property contains a string literal representing one of the common failure reasons. It is determined by the error code and description of the Bot API response, which are subject to change.
+- **`InternalServerError`** — Bot API server failed with a 5xx error code.
 
 All errors except `TransportError` also have `response` property that contains the original response from Bot API.
 
@@ -125,7 +135,7 @@ const program = BotApi.callMethod('doSomething').pipe(
         RateLimited: ({ retryAfter }) =>
           Effect.logError(`Try again in ${Duration.format(retryAfter)}`),
         GroupUpgraded: ({ supergroup }) =>
-          Effect.logError(`Group now has a new ID: ${supergroup.id}`),
+          Effect.logError(`Group is now a supergroup with ID: ${supergroup.id}`),
         MethodFailed: ({ possibleReason, response }) =>
           Match.value(possibleReason).pipe(
             Match.when('BotBlockedByUser', () =>
@@ -164,3 +174,358 @@ type GiftsCollector = (
   BotApi.BotApi
 >
 ```
+
+## Sending messages
+
+One of the most common tasks for a messenger bot is sending messages.
+
+Bot API exposes multiple methods for sending a message, each corresponding to a different content type:
+
+- `sendMessage` for text;
+- `sendPhoto` for photos;
+- `sendVideo` for videos;
+- and so on.
+
+`Send` module provides a unified, more composable way to send messages of all kinds.
+
+### Basic usage
+
+To send a message, you need:
+
+- **Content** — content of the message to be sent.
+- **Dialog** — target chat and topic where the message will be sent.
+- **Markup** — (optional) markup for replying to the message.
+- **Reply** — (optional) information about the message being replied to.
+- **Options** — (optional) additional options for sending the message.
+
+`Send.sendMessage` function accepts mentioned parameters and returns an `Effect` that sends a message, automatically choosing the appropriate Bot API method based on the content type.
+
+**Example:** Sending messages using `Send.sendMessage`.
+
+```ts
+import { Content, Dialog, File, Markup, Reply, Send, Text } from '@grom.js/effect-tg'
+import { Effect } from 'effect'
+
+const program = Effect.gen(function* () {
+  // Plain text to a user
+  const greeting = yield* Send.sendMessage({
+    content: Content.text(Text.plain('Hey! Wanna roll a dice?')),
+    dialog: Dialog.user(382713),
+  })
+
+  // Photo with formatted caption and inline keyboard
+  yield* Send.sendMessage({
+    content: Content.photo(
+      File.External(new URL('https://cataas.com/cat')),
+      { caption: Text.html('<b>Cat of the day</b>\n<i>Rate this cat:</i>') },
+    ),
+    dialog: Dialog.user(382713),
+    markup: Markup.inlineKeyboard([
+      [Markup.InlineButton.callback('❤️', 'rate_love')],
+      [Markup.InlineButton.callback('👎', 'rate_nope')],
+    ]),
+  })
+
+  // Reply with a dice
+  const roll = yield* Send.sendMessage({
+    content: Content.dice('🎲'),
+    dialog: Dialog.user(382713),
+    reply: Reply.toMessage(greeting),
+  })
+
+  const rolled = roll.dice!.value
+  if (rolled === 6) {
+    // DM channel
+    yield* Send.sendMessage({
+      content: Content.text(Text.plain(`User 382713 rolled ${rolled}.`)),
+      dialog: Dialog.channel(100200).directMessages(42),
+    })
+  }
+  else {
+    // Send silently
+    yield* Send.sendMessage({
+      content: Content.text(Text.plain(`You rolled ${rolled}. Disappointing.`)),
+      dialog: Dialog.user(382713),
+      options: Send.options({ disableNotification: true })
+    })
+  }
+})
+```
+
+#### Content
+
+`Content` module provides constructors for creating objects that represent the content of a message. `Send.sendMessage` uses the content type to choose the appropriate Bot API method automatically.
+
+| Constructor            | Bot API method  | Description            |
+| ---------------------- | --------------- | ---------------------- |
+| `Content.text`         | `sendMessage`   | Text                   |
+| `Content.photo`        | `sendPhoto`     | Photo                  |
+| `Content.video`        | `sendVideo`     | Video                  |
+| `Content.animation`    | `sendAnimation` | GIF or video w/o sound |
+| `Content.audio`        | `sendAudio`     | Audio file             |
+| `Content.voice`        | `sendVoice`     | Voice note             |
+| `Content.videoNote`    | `sendVideoNote` | Round video note       |
+| `Content.document`     | `sendDocument`  | File of any type       |
+| `Content.sticker`      | `sendSticker`   | Sticker                |
+| `Content.location`     | `sendLocation`  | Static location        |
+| `Content.liveLocation` | `sendLocation`  | Live location          |
+| `Content.venue`        | `sendVenue`     | Venue with address     |
+| `Content.contact`      | `sendContact`   | Phone contact          |
+| `Content.dice`         | `sendDice`      | Random dice            |
+
+#### Dialog
+
+`Dialog` module provides utilities for creating target chats:
+
+- `Dialog.user(id)` — private chat with a user.
+- `Dialog.group(id)` — chat of a (basic) group.
+- `Dialog.supergroup(id)` — supergroup chat.
+- `Dialog.channel(id)` — channel.
+
+To target a specific topic, chain a method on the peer:
+
+- `Dialog.user(id).topic(topicId)` — topic in a private chat.
+- `Dialog.supergroup(id).topic(topicId)` — topic in a forum supergroup.
+- `Dialog.channel(id).directMessages(topicId)` — channel direct messages.
+
+`Dialog.ofMessage` helper extracts the dialog from an incoming `Message` object.
+
+##### Dialog and peer IDs
+
+Bot API uses a single integer to encode peer type with its ID — [dialog ID](https://core.telegram.org/api/bots/ids).
+
+This may not be a problem for user IDs, since user IDs map to the same dialog IDs.
+However, this may cause some defects when working with other peers.
+For example, to send a message to a channel with ID `3011378744`, you need to set `chat_id` parameter to `-1003011378744`.
+
+To prevent this confusion, `Dialog` module defines **branded types** that distinguish peer IDs from dialog IDs at the type level:
+
+- `UserId` — number representing a user ID.
+- `GroupId` — number representing a group ID.
+- `ChannelId` — number representing a channel ID.
+- `SupergroupId` — alias to `ChannelId`, since supergroups share ID space with channels.
+- `DialogId` — number encoding peer type and peer ID.
+
+Constructors like `Dialog.user`, `Dialog.channel`, etc. validate and encode IDs internally, so you rarely need to convert manually. When you do, `Dialog` module exports conversion utilities:
+
+- `Dialog.decodeDialogId(dialogId)` — decodes a dialog ID into peer type and peer ID.
+- `Dialog.decodePeerId(peer, dialogId)` — extracts a typed peer ID from a dialog ID.
+- `Dialog.encodePeerId(peer, id)` — encodes a peer type and ID into a dialog ID.
+
+#### Markup
+
+`Markup` module provides reply markup types and constructors:
+
+- `Markup.inlineKeyboard(rows)` — inline keyboard attached to the message.
+- `Markup.replyKeyboard(rows, options?)` — custom keyboard for quick reply or other action.
+- `Markup.replyKeyboardRemove()` — hide a previously shown reply keyboard.
+- `Markup.forceReply()` — forces Telegram client to reply to the message.
+
+**Example:** Creating reply markups.
+
+```ts
+import { Markup } from '@grom.js/effect-tg'
+
+const inline = Markup.inlineKeyboard([
+  [Markup.InlineButton.callback('Like', 'liked')],
+  [Markup.InlineButton.url('Source code', 'https://github.com/grom-dev/effect-tg')],
+])
+
+const reply = Markup.replyKeyboard(
+  [
+    ['Option A', 'Option B'],
+    [Markup.ReplyButton.requestContact('Share phone')],
+  ],
+  { oneTime: true, resizable: true }
+)
+```
+
+### Prepared messages
+
+`Send.message` creates a `MessageToSend` — prepared message that bundles content, markup, reply, and options.
+
+`MessageToSend` is also an `Effect`, which means:
+
+- It can be piped to chain modifiers that customize markup, reply, and options.
+- It can be executed to send the message. To be sent, `Send.TargetDialog` service should be provided.
+
+**Example:** Creating and sending prepared messages.
+
+```ts
+import { Content, Dialog, Send, Text } from '@grom.js/effect-tg'
+import { Effect } from 'effect'
+
+// Reusable template
+const welcomeMessage = Send.message(
+  Content.text(Text.html('<b>Welcome!</b> Thanks for joining.'))
+).pipe(
+  Send.withMarkup(
+    Markup.replyKeyboard([
+      [Markup.ReplyButton.text('Effect?')],
+      [Markup.ReplyButton.text('Die.')],
+    ]),
+  ),
+)
+
+// Send to different dialogs
+const greet1 = Effect.gen(function* () {
+  yield* welcomeMessage.pipe(Send.to(Dialog.user(123)))
+  yield* welcomeMessage.pipe(Send.to(Dialog.channel(321)))
+})
+
+// Send to the same dialog with different options
+const greet2 = Effect.gen(function* () {
+  yield* welcomeMessage.pipe(Send.withoutNotification)
+  yield* welcomeMessage.pipe(Send.withContentProtection)
+}).pipe(
+  Send.to(Dialog.supergroup(4).topic(2)),
+)
+```
+
+### Composing options
+
+Chain modifiers on a `MessageToSend` to customize its behavior:
+
+- `withMarkup`/`withoutMarkup` — set/remove reply markup.
+- `withReply`/`withoutReply` — set/remove reply options.
+- `withNotification`/`withoutNotification` — enable/disable notification sound.
+- `withContentProtection`/`withoutContentProtection` — prevent/allow forwarding and saving.
+- `withPaidBroadcast`/`withoutPaidBroadcast` — enable/disable paid broadcast.
+- `withOptions` — merge with the new send options.
+
+**Example:** Chaining modifiers on a prepared message.
+
+```ts
+import { Content, Markup, Send, Text } from '@grom.js/effect-tg'
+
+const secretPromo = Send.message(Content.text(Text.plain('Shh!'))).pipe(
+  Send.withMarkup(
+    Markup.inlineKeyboard([
+      [Markup.InlineButton.copyText('Copy promo', 'EFFECT_TG')],
+    ]),
+  ),
+  Send.withoutNotification,
+  Send.withContentProtection,
+)
+```
+
+### Text formatting
+
+`Text` module provides utilities for creating [formatted text](https://core.telegram.org/bots/api#formatting-options) to be used in text messages and captions.
+
+**Example:** Formatting text with `Text` module.
+
+```tsx
+import { Text } from '@grom.js/effect-tg'
+
+// Plain text — sent as is
+Text.plain('*Not bold*. _Not italic_.')
+
+// HTML — sent with 'HTML' parse mode
+Text.html('<b>Bold</b> and <i>italic</i>.')
+
+// Markdown — sent with 'MarkdownV2' parse mode
+Text.markdown('*Bold* and _italic_.')
+```
+
+#### JSX syntax
+
+`Text` module also allows to compose formatted text with JSX.
+
+Benefits of using JSX:
+
+- **Validation**: JSX is validated during compilation, so you can't specify invalid HTML or Markdown.
+- **Composability**: JSX allows composing formatted text with custom components.
+- **Auto-escaping**: JSX escapes special characters, saving you from \<s\>bAd\</s\> \_iNpUtS\_.
+- **Type safety**: LSP hints and type checking for text entities and custom components.
+
+`Text.tgx` function accepts a JSX element and returns an instance of `Text.Tgx`, which can then be used as a content of a message.
+
+**Example:** Composing reusable messages with JSX.
+
+```tsx
+import type { PropsWithChildren } from '@grom.js/tgx/types'
+import { Content, Dialog, Send, Text } from '@grom.js/effect-tg'
+import { pipe } from 'effect'
+
+// Reusable component for a key-value field
+const Field = (props: PropsWithChildren<{ label: string }>) => (
+  <><b>{props.label}:</b> {props.children}{'\n'}</>
+)
+
+// Simple component for convenience
+const RocketEmoji = () => (
+  <emoji id="5445284980978621387" alt="🚀" />
+)
+
+// Component that renders a deploy summary
+const DeploySummary = (props: {
+  service: string
+  version: string
+  env: string
+  author: string
+  url: string
+}) => (
+  <>
+    <RocketEmoji /> <b>Deploy to <i>{props.env}</i></b>
+    {'\n\n'}
+    <Field label="Service"><code>{props.service}</code></Field>
+    <Field label="Version"><code>{props.version}</code></Field>
+    <Field label="Author">{props.author}</Field>
+    {'\n'}
+    <a href={props.url}>View in dashboard</a>
+    {'\n\n'}
+    <blockquote expandable>
+      Changelog:{'\n'}
+      - Fix rate limiting on /api/submit{'\n'}
+      - Add retry logic for webhook delivery{'\n'}
+      - Update dependencies
+    </blockquote>
+  </>
+)
+
+// Create summary text
+const summary = Text.tgx(
+  <DeploySummary
+    service="billing-api"
+    version="2.14.0"
+    env="production"
+    author="Alice"
+    url="https://deploy.example.com/runs/4821"
+  />
+)
+
+// Publish a new post
+const publish = Send.message(Content.text(summary)).pipe(
+  Send.to(Dialog.channel(3011378744)),
+)
+```
+
+<details>
+<summary>How it works?</summary>
+
+JSX is just syntactic sugar transformed by the compiler.
+Result of transformation depends on the JSX runtime.
+`effect-tg` relies on JSX runtime from [`@grom.js/tgx`](https://github.com/grom-dev/tgx), which transforms JSX elements to `TgxElement` instances.
+When `Send.sendMessage` encounters an instance of `Text.Tgx`, it converts inner `TgxElement`s to the parameters for a `send*` method.
+
+</details>
+
+To enable JSX support:
+
+1. Install `@grom.js/tgx` package:
+
+   ```sh
+   npm install @grom.js/tgx
+   ```
+
+2. Update your `tsconfig.json`:
+
+   ```json
+   {
+     "compilerOptions": {
+       "jsx": "react-jsx",
+       "jsxImportSource": "@grom.js/tgx"
+     }
+   }
+   ```

package/dist/BotApi.d.ts

@@ -1,8 +1,12 @@
+import type * as Config from 'effect/Config';
+import type * as ConfigError from 'effect/ConfigError';
 import type * as BotApiError from './BotApiError.ts';
 import type { MethodParams, MethodResults, BotApi as Service, Types } from './internal/botApi.gen.ts';
+import * as HttpClient from '@effect/platform/HttpClient';
 import * as Context from 'effect/Context';
 import * as Effect from 'effect/Effect';
 import * as Layer from 'effect/Layer';
+import * as Redacted from 'effect/Redacted';
 import * as BotApiTransport from './BotApiTransport.ts';
 export type { MethodParams, MethodResults, Service, Types };
 declare const BotApi_base: Context.TagClass<BotApi, "@grom.js/effect-tg/BotApi", Service>;
@@ -17,4 +21,32 @@ export declare const make: (args: {
 }) => Service;
 export declare const layer: Layer.Layer<BotApi, never, BotApiTransport.BotApiTransport>;
 type MethodArgs<TMethod extends keyof MethodParams> = void extends MethodParams[TMethod] ? [params?: MethodParams[TMethod]] : [params: MethodParams[TMethod]];
+/**
+ * Constructs a `BotApi` layer from the given configuration.
+ */
+export declare const layerConfig: (options: {
+    /**
+     * Bot API token from [@BotFather](https://t.me/BotFather).
+     */
+    readonly token: Config.Config<Redacted.Redacted>;
+    /**
+     * Target Bot API environment:
+     *
+     * - `prod` — production environment
+     * - `test` — [test environment](https://core.telegram.org/bots/features#dedicated-test-environment)
+     *
+     * @default 'prod'
+     */
+    readonly environment?: "prod" | "test";
+    /**
+     * A function to transform the underlying `BotApiTransport` before
+     * it's used to call Bot API methods.
+     *
+     * Useful for:
+     * - Adding custom middleware (logging, metrics, caching)
+     * - Adding custom retry logic or error handling
+     * - Integrating with monitoring or debugging tools
+     */
+    readonly transformTransport?: (transport: BotApiTransport.Service) => BotApiTransport.Service;
+}) => Layer.Layer<BotApi, ConfigError.ConfigError, HttpClient.HttpClient>;
 //# sourceMappingURL=BotApi.d.ts.map

package/dist/BotApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BotApi.d.ts","sourceRoot":"","sources":["../src/BotApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,WAAW,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,MAAM,IAAI,OAAO,EACjB,KAAK,EACN,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAGvD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;;AAE3D,qBAAa,MAAO,SAAQ,WAGzB;CAAG;AAEN,MAAM,WAAW,YAAY,CAAC,OAAO,SAAS,MAAM,YAAY;IAC9D,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,CAC3C,aAAa,CAAC,OAAO,CAAC,EACtB,WAAW,CAAC,WAAW,EACvB,KAAK,CACN,CAAA;CACF;AAED,eAAO,MAAM,UAAU,EAAE,CAAC,OAAO,SAAS,MAAM,YAAY,EAC1D,MAAM,EAAE,OAAO,EACf,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,KACzB,MAAM,CAAC,MAAM,CAChB,aAAa,CAAC,OAAO,CAAC,EACtB,WAAW,CAAC,WAAW,EACvB,MAAM,CAMA,CAAA;AAER,eAAO,MAAM,IAAI,EAAE,CAAC,IAAI,EAAE;IACxB,SAAS,EAAE,eAAe,CAAC,OAAO,CAAA;CACnC,KAAK,OAAuB,CAAA;AAE7B,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAC7B,MAAM,EACN,KAAK,EACL,eAAe,CAAC,eAAe,CAOhC,CAAA;AAED,KAAK,UAAU,CAAC,OAAO,SAAS,MAAM,YAAY,IAChD,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,GAC9B,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,GAChC,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAA"}
+{"version":3,"file":"BotApi.d.ts","sourceRoot":"","sources":["../src/BotApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,KAAK,WAAW,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,KAAK,WAAW,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,MAAM,IAAI,OAAO,EACjB,KAAK,EACN,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAA;AACzD,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAIvD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;;AAE3D,qBAAa,MAAO,SAAQ,WAGzB;CAAG;AAEN,MAAM,WAAW,YAAY,CAAC,OAAO,SAAS,MAAM,YAAY;IAC9D,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,CAC3C,aAAa,CAAC,OAAO,CAAC,EACtB,WAAW,CAAC,WAAW,EACvB,KAAK,CACN,CAAA;CACF;AAED,eAAO,MAAM,UAAU,EAAE,CAAC,OAAO,SAAS,MAAM,YAAY,EAC1D,MAAM,EAAE,OAAO,EACf,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,KACzB,MAAM,CAAC,MAAM,CAChB,aAAa,CAAC,OAAO,CAAC,EACtB,WAAW,CAAC,WAAW,EACvB,MAAM,CAMA,CAAA;AAER,eAAO,MAAM,IAAI,EAAE,CAAC,IAAI,EAAE;IACxB,SAAS,EAAE,eAAe,CAAC,OAAO,CAAA;CACnC,KAAK,OAAuB,CAAA;AAE7B,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAC7B,MAAM,EACN,KAAK,EACL,eAAe,CAAC,eAAe,CAOhC,CAAA;AAED,KAAK,UAAU,CAAC,OAAO,SAAS,MAAM,YAAY,IAChD,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,GAC9B,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,GAChC,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAA;AAErC;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS;IACnC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAEhD;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAEtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC,OAAO,KAAK,eAAe,CAAC,OAAO,CAAA;CAC9F,KAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,WAAW,EAAE,UAAU,CAAC,UAAU,CAyBrE,CAAA"}

package/dist/BotApi.js

@@ -1,11 +1,27 @@
+import * as HttpClient from '@effect/platform/HttpClient';
 import * as Context from 'effect/Context';
 import * as Effect from 'effect/Effect';
+import * as Function from 'effect/Function';
 import * as Layer from 'effect/Layer';
+import * as Redacted from 'effect/Redacted';
 import * as BotApiTransport from "./BotApiTransport.js";
+import * as BotApiUrl from "./BotApiUrl.js";
 import * as internal from "./internal/botApi.js";
 export class BotApi extends Context.Tag('@grom.js/effect-tg/BotApi')() {
 }
 export const callMethod = (method, params = undefined) => BotApi.pipe(Effect.flatMap(api => api[method](params)));
 export const make = internal.make;
 export const layer = Layer.effect(BotApi, Effect.andThen(BotApiTransport.BotApiTransport, transport => internal.make({ transport })));
+/**
+ * Constructs a `BotApi` layer from the given configuration.
+ */
+export const layerConfig = (options) => {
+    const { token, environment = 'prod', transformTransport, } = options;
+    return Layer.provide(layer, Layer.effect(BotApiTransport.BotApiTransport, Effect.all([
+        HttpClient.HttpClient,
+        token.pipe(Effect.map(token => (environment === 'prod'
+            ? BotApiUrl.makeProd(Redacted.value(token))
+            : BotApiUrl.makeTest(Redacted.value(token))))),
+    ]).pipe(Effect.map(([httpClient, botApiUrl]) => BotApiTransport.make({ httpClient, botApiUrl })), Effect.map(transformTransport ?? Function.identity))));
+};
 //# sourceMappingURL=BotApi.js.map

package/dist/BotApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"BotApi.js","sourceRoot":"","sources":["../src/BotApi.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAA;AAIhD,MAAM,OAAO,MAAO,SAAQ,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,EAGjE;CAAG;AAUN,MAAM,CAAC,MAAM,UAAU,GAOnB,CACF,MAAc,EACd,SAAkB,SAAS,EAC3B,EAAE,CAAC,MAAM,CAAC,IAAI,CACd,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAE,GAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAC7C,CAAA;AAER,MAAM,CAAC,MAAM,IAAI,GAED,QAAQ,CAAC,IAAI,CAAA;AAE7B,MAAM,CAAC,MAAM,KAAK,GAId,KAAK,CAAC,MAAM,CACd,MAAM,EACN,MAAM,CAAC,OAAO,CACZ,eAAe,CAAC,eAAe,EAC/B,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAC1C,CACF,CAAA"}
+{"version":3,"file":"BotApi.js","sourceRoot":"","sources":["../src/BotApi.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAA;AACzD,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAA;AAIhD,MAAM,OAAO,MAAO,SAAQ,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,EAGjE;CAAG;AAUN,MAAM,CAAC,MAAM,UAAU,GAOnB,CACF,MAAc,EACd,SAAkB,SAAS,EAC3B,EAAE,CAAC,MAAM,CAAC,IAAI,CACd,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAE,GAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAC7C,CAAA;AAER,MAAM,CAAC,MAAM,IAAI,GAED,QAAQ,CAAC,IAAI,CAAA;AAE7B,MAAM,CAAC,MAAM,KAAK,GAId,KAAK,CAAC,MAAM,CACd,MAAM,EACN,MAAM,CAAC,OAAO,CACZ,eAAe,CAAC,eAAe,EAC/B,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAC1C,CACF,CAAA;AAOD;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OA0B3B,EAAuE,EAAE;IACxE,MAAM,EACJ,KAAK,EACL,WAAW,GAAG,MAAM,EACpB,kBAAkB,GACnB,GAAG,OAAO,CAAA;IACX,OAAO,KAAK,CAAC,OAAO,CAClB,KAAK,EACL,KAAK,CAAC,MAAM,CACV,eAAe,CAAC,eAAe,EAC/B,MAAM,CAAC,GAAG,CAAC;QACT,UAAU,CAAC,UAAU;QACrB,KAAK,CAAC,IAAI,CACR,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAClB,WAAW,KAAK,MAAM;YACpB,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3C,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAC9C,CAAC,CACH;KACF,CAAC,CAAC,IAAI,CACL,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC,EACxF,MAAM,CAAC,GAAG,CAAC,kBAAkB,IAAI,QAAQ,CAAC,QAAQ,CAAC,CACpD,CACF,CACF,CAAA;AACH,CAAC,CAAA"}

package/dist/BotApiError.js

@@ -54,7 +54,7 @@ export const fromResponse = (response) => {
     if (response.error_code === 400 && response.parameters?.migrate_to_chat_id != null) {
         return new GroupUpgraded({
             response,
-            supergroup: Dialog.supergroup(Option.getOrThrow(Dialog.decodePeerId('supergroup', response.parameters.migrate_to_chat_id))),
+            supergroup: Dialog.supergroup(Option.getOrThrow(Dialog.decodePeerId('channel', response.parameters.migrate_to_chat_id))),
         });
     }
     if (response.error_code >= 500) {

package/dist/BotApiError.js.map

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