@grom.js/effect-tg 0.2.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025–PRESENT Vladislav Deryabkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,9 @@
+Effectful library for crafting Telegram bots.
+
+> [!WARNING]
+> Work in progress.
+
+## Features
+
+- Effectful and typesafe API.
+- Up-to-date and documented Bot API methods and types.

package/dist/BotApi.d.ts

@@ -0,0 +1,27 @@
+import type { MethodParams, MethodResults } from './internal/botApiMethods.gen.ts';
+import type { BotApiShape } from './internal/botApiShape.gen.ts';
+import type * as Types from './internal/botApiTypes.gen.ts';
+import * as Context from 'effect/Context';
+export type { MethodParams, MethodResults, Types };
+declare const BotApi_base: Context.TagClass<BotApi, "@grom.js/effect-tg/BotApi", BotApiShape>;
+export declare class BotApi extends BotApi_base {
+}
+declare const BotApiError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "@grom.js/effect-tg/BotApiError";
+} & Readonly<A>;
+/**
+ * Error returned from the Bot API server in case of unsuccessful method call.
+ */
+export declare class BotApiError extends BotApiError_base<{
+    code: number;
+    description: string;
+    parameters?: Types.ResponseParameters;
+}> {
+    get message(): string;
+}
+export declare const make: (options: {
+    transport: {
+        sendRequest: (method: string, params: unknown) => import("effect/Effect").Effect<import("./BotApiTransport.ts").BotApiResponse, import("./BotApiTransport.ts").BotApiTransportError>;
+    };
+}) => import("effect/Effect").Effect<BotApiShape, never, never>;
+//# sourceMappingURL=BotApi.d.ts.map

package/dist/BotApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotApi.d.ts","sourceRoot":"","sources":["../src/BotApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,KAAK,KAAK,KAAK,MAAM,+BAA+B,CAAA;AAC3D,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAIzC,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,CAAA;;AAElD,qBAAa,MAAO,SAAQ,WAGzB;CAAG;;;;AAEN;;GAEG;AACH,qBAAa,WAAY,SAAQ,iBAAmD;IAClF,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC,kBAAkB,CAAA;CACtC,CAAC;IACA,IAAa,OAAO,WAEnB;CACF;AAED,eAAO,MAAM,IAAI;;;;+DAAgB,CAAA"}

package/dist/BotApi.js

@@ -0,0 +1,14 @@
+import * as Context from 'effect/Context';
+import * as Data from 'effect/Data';
+import * as internal from "./internal/botApi.js";
+export class BotApi extends Context.Tag('@grom.js/effect-tg/BotApi')() {
+}
+/**
+ * Error returned from the Bot API server in case of unsuccessful method call.
+ */
+export class BotApiError extends Data.TaggedError('@grom.js/effect-tg/BotApiError') {
+    get message() {
+        return `(${this.code}) ${this.description}`;
+    }
+}
+export const make = internal.make;

package/dist/BotApiTransport.d.ts

@@ -0,0 +1,44 @@
+import type * as Effect from 'effect/Effect';
+import type * as Types from './internal/botApiTypes.gen.ts';
+import * as Context from 'effect/Context';
+declare const BotApiTransport_base: Context.TagClass<BotApiTransport, "@grom.js/effect-tg/BotApiTransport", {
+    sendRequest: (method: string, params: unknown) => Effect.Effect<BotApiResponse, BotApiTransportError>;
+}>;
+export declare class BotApiTransport extends BotApiTransport_base {
+}
+/**
+ * @see https://core.telegram.org/bots/api#making-requests
+ */
+export type BotApiResponse = {
+    ok: true;
+    result: unknown;
+    description?: string;
+} | {
+    ok: false;
+    error_code: number;
+    description: string;
+    parameters?: Types.ResponseParameters;
+};
+declare const BotApiTransportError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "@grom.js/effect-tg/BotApiTransportError";
+} & Readonly<A>;
+/**
+ * Error caused by the transport when accessing Bot API.
+ */
+export declare class BotApiTransportError extends BotApiTransportError_base<{
+    cause: unknown;
+}> {
+}
+export declare const makeWith: (options: {
+    makeUrl: (method: string) => URL;
+}) => Effect.Effect<{
+    sendRequest: (method: string, params: unknown) => Effect.Effect<BotApiResponse, BotApiTransportError>;
+}, never, import("@effect/platform/HttpClient").HttpClient>;
+export declare const makeProd: (token: string) => Effect.Effect<{
+    sendRequest: (method: string, params: unknown) => Effect.Effect<BotApiResponse, BotApiTransportError>;
+}, never, import("@effect/platform/HttpClient").HttpClient>;
+export declare const makeTest: (token: string) => Effect.Effect<{
+    sendRequest: (method: string, params: unknown) => Effect.Effect<BotApiResponse, BotApiTransportError>;
+}, never, import("@effect/platform/HttpClient").HttpClient>;
+export {};
+//# sourceMappingURL=BotApiTransport.d.ts.map

package/dist/BotApiTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotApiTransport.d.ts","sourceRoot":"","sources":["../src/BotApiTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,KAAK,KAAK,MAAM,+BAA+B,CAAA;AAC3D,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;;iBAOxB,CACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,KACZ,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,oBAAoB,CAAC;;AAN5D,qBAAa,eAAgB,SAAQ,oBAQlC;CACF;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB;IACA,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG;IACF,EAAE,EAAE,KAAK,CAAA;IACT,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC,kBAAkB,CAAA;CACtC,CAAA;;;;AAEH;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,0BAA4D;IACpG,KAAK,EAAE,OAAO,CAAA;CACf,CAAC;CAAG;AAEL,eAAO,MAAM,QAAQ;;;iBA9BJ,CACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,KACZ,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,oBAAoB,CAAC;2DA2BnB,CAAA;AAEzC,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM;iBAhCrB,CACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,KACZ,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,oBAAoB,CAAC;2DAiC3D,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM;iBAtCrB,CACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,KACZ,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,oBAAoB,CAAC;2DAuC3D,CAAA"}

package/dist/BotApiTransport.js

@@ -0,0 +1,17 @@
+import * as Context from 'effect/Context';
+import * as Data from 'effect/Data';
+import * as internal from "./internal/botApiTransport.js";
+export class BotApiTransport extends Context.Tag('@grom.js/effect-tg/BotApiTransport')() {
+}
+/**
+ * Error caused by the transport when accessing Bot API.
+ */
+export class BotApiTransportError extends Data.TaggedError('@grom.js/effect-tg/BotApiTransportError') {
+}
+export const makeWith = internal.makeWith;
+export const makeProd = (token) => (makeWith({
+    makeUrl: method => new URL(`https://api.telegram.org/bot${token}/${method}`),
+}));
+export const makeTest = (token) => (makeWith({
+    makeUrl: method => new URL(`https://api.telegram.org/bot${token}/test/${method}`),
+}));

package/dist/BotApiWebhook.d.ts

@@ -0,0 +1,37 @@
+/**
+ * This module implements Telegram Bot API webhook requests verification.
+ *
+ * @see https://core.telegram.org/bots/api#setwebhook
+ */
+import type * as BotApi from './BotApi.ts';
+import * as HttpApiMiddleware from '@effect/platform/HttpApiMiddleware';
+import * as Context from 'effect/Context';
+import * as Layer from 'effect/Layer';
+import * as Redacted from 'effect/Redacted';
+import * as Schema from 'effect/Schema';
+export declare const SECRET_HEADER = "x-telegram-bot-api-secret-token";
+declare const VerificationFailedError_base: Schema.TaggedErrorClass<VerificationFailedError, "@grom.js/effect-tg/BotApiWebhook/VerificationFailedError", {
+    readonly _tag: Schema.tag<"@grom.js/effect-tg/BotApiWebhook/VerificationFailedError">;
+} & {
+    reason: Schema.Literal<["MISSING_HEADER", "INVALID_SECRET", "INVALID_REQUEST", "BROKEN_TRANSPORT"]>;
+}>;
+export declare class VerificationFailedError extends VerificationFailedError_base {
+}
+declare const Update_base: Context.TagClass<Update, "@grom.js/effect-tg/BotApiWebhook/Update", BotApi.Types.Update>;
+export declare class Update extends Update_base {
+}
+declare const VerifyMiddleware_base: HttpApiMiddleware.TagClass.Base<VerifyMiddleware, "@grom.js/effect-tg/BotApiWebhook/VerifyMiddleware", {
+    readonly optional: false;
+    readonly failure: typeof VerificationFailedError;
+    readonly provides: typeof Update;
+}, HttpApiMiddleware.HttpApiMiddleware<BotApi.Types.Update, VerificationFailedError>>;
+export declare class VerifyMiddleware extends VerifyMiddleware_base {
+    static live(options: {
+        /**
+         * Telegram webhook secret token.
+         */
+        secret: Redacted.Redacted<string>;
+    }): Layer.Layer<VerifyMiddleware, never, never>;
+}
+export {};
+//# sourceMappingURL=BotApiWebhook.d.ts.map

package/dist/BotApiWebhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotApiWebhook.d.ts","sourceRoot":"","sources":["../src/BotApiWebhook.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAG1C,OAAO,KAAK,iBAAiB,MAAM,oCAAoC,CAAA;AAGvE,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,eAAO,MAAM,aAAa,oCAAoC,CAAA;;;;;;AAG9D,qBAAa,uBAAwB,SAAQ,4BAc5C;CAAG;;AAEJ,qBAAa,MAAO,SAAQ,WAGzB;CAAG;;;;;;AAEN,qBAAa,gBAAiB,SAAQ,qBAOrC;WACe,IAAI,CAAC,OAAO,EAAE;QAC1B;;WAEG;QACH,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;KAClC;CA+BF"}

package/dist/BotApiWebhook.js

@@ -0,0 +1,50 @@
+/**
+ * This module implements Telegram Bot API webhook requests verification.
+ *
+ * @see https://core.telegram.org/bots/api#setwebhook
+ */
+import { Buffer } from 'node:buffer';
+import * as crypto from 'node:crypto';
+import * as HttpApiMiddleware from '@effect/platform/HttpApiMiddleware';
+import * as HttpApiSchema from '@effect/platform/HttpApiSchema';
+import * as HttpServerRequest from '@effect/platform/HttpServerRequest';
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+import * as Match from 'effect/Match';
+import * as Redacted from 'effect/Redacted';
+import * as Schema from 'effect/Schema';
+export const SECRET_HEADER = 'x-telegram-bot-api-secret-token';
+// eslint-disable-next-line unicorn/throw-new-error
+export class VerificationFailedError extends Schema.TaggedError()('@grom.js/effect-tg/BotApiWebhook/VerificationFailedError', Schema.Struct({
+    reason: Schema.Literal('MISSING_HEADER', 'INVALID_SECRET', 'INVALID_REQUEST', 'BROKEN_TRANSPORT'),
+}), HttpApiSchema.annotations({
+    status: 401,
+    description: 'Webhook verification failed.',
+})) {
+}
+export class Update extends Context.Tag('@grom.js/effect-tg/BotApiWebhook/Update')() {
+}
+export class VerifyMiddleware extends HttpApiMiddleware.Tag()('@grom.js/effect-tg/BotApiWebhook/VerifyMiddleware', {
+    optional: false,
+    failure: VerificationFailedError,
+    provides: Update,
+}) {
+    static live(options) {
+        return Layer.succeed(VerifyMiddleware, Effect.gen(function* () {
+            const req = yield* HttpServerRequest.HttpServerRequest;
+            const actual = req.headers[SECRET_HEADER];
+            if (actual == null) {
+                return yield* new VerificationFailedError({ reason: 'MISSING_HEADER' });
+            }
+            const equal = crypto.timingSafeEqual(Buffer.from(Redacted.value(options.secret)), Buffer.from(actual));
+            if (!equal) {
+                return yield* new VerificationFailedError({ reason: 'INVALID_SECRET' });
+            }
+            const update = yield* req.json.pipe(Effect.catchTag('RequestError', error => (new VerificationFailedError({
+                reason: Match.value(error.reason).pipe(Match.when('Decode', () => 'INVALID_REQUEST'), Match.when('Transport', () => 'BROKEN_TRANSPORT'), Match.exhaustive),
+            }))));
+            return update;
+        }));
+    }
+}

package/dist/Chat.d.ts

@@ -0,0 +1,96 @@
+import * as Data from 'effect/Data';
+export type Chat = PeerUser | PeerGroup | PeerChannel | PeerSupergroup | PublicChannel | PublicSupergroup | ForumTopic | ChannelDm;
+declare const PeerUser_base: new (options: {
+    id: number;
+}) => {
+    readonly id: number;
+    readonly dialogId: number;
+    sendParams: () => {
+        chat_id: number | string;
+        message_thread_id?: number | undefined;
+        direct_messages_topic_id?: number | undefined;
+    };
+};
+export declare class PeerUser extends PeerUser_base {
+}
+declare const PeerGroup_base: new (options: {
+    id: number;
+}) => {
+    readonly id: number;
+    readonly dialogId: number;
+    sendParams: () => {
+        chat_id: number | string;
+        message_thread_id?: number | undefined;
+        direct_messages_topic_id?: number | undefined;
+    };
+};
+export declare class PeerGroup extends PeerGroup_base {
+}
+declare const PeerChannel_base: new (options: {
+    id: number;
+}) => {
+    readonly id: number;
+    readonly dialogId: number;
+    sendParams: () => {
+        chat_id: number | string;
+        message_thread_id?: number | undefined;
+        direct_messages_topic_id?: number | undefined;
+    };
+};
+export declare class PeerChannel extends PeerChannel_base {
+}
+declare const PeerSupergroup_base: new (options: {
+    id: number;
+}) => {
+    readonly id: number;
+    readonly dialogId: number;
+    sendParams: () => {
+        chat_id: number | string;
+        message_thread_id?: number | undefined;
+        direct_messages_topic_id?: number | undefined;
+    };
+};
+export declare class PeerSupergroup extends PeerSupergroup_base {
+}
+export declare class PublicChannel extends Data.Class<{
+    username: string;
+}> {
+    sendParams(): {
+        chat_id: string;
+    };
+}
+export declare class PublicSupergroup extends Data.Class<{
+    username: string;
+}> {
+    sendParams(): {
+        chat_id: string;
+    };
+}
+export declare class ForumTopic extends Data.Class<{
+    forum: PeerSupergroup | PublicSupergroup;
+    topicId: number;
+}> {
+    sendParams(): {
+        message_thread_id: number;
+        chat_id: number | string;
+        direct_messages_topic_id?: number | undefined;
+    } | {
+        message_thread_id: number;
+        chat_id: string;
+    };
+}
+export declare class ChannelDm extends Data.Class<{
+    channel: PeerChannel | PublicChannel;
+    userId: number;
+}> {
+    sendParams(): {
+        direct_messages_topic_id: number;
+        chat_id: number | string;
+        message_thread_id?: number | undefined;
+    } | {
+        direct_messages_topic_id: number;
+        chat_id: string;
+    };
+}
+export {};
+//# sourceMappingURL=Chat.d.ts.map

package/dist/Chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../src/Chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AAGnC,MAAM,MAAM,IAAI,GACV,QAAQ,GACR,SAAS,GACT,WAAW,GACX,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,UAAU,GACV,SAAS,CAAA;;;;;;;;;;;;AAEf,qBAAa,QAAS,SAAQ,aAG5B;CAAG;;;;;;;;;;;;AAEL,qBAAa,SAAU,SAAQ,cAG7B;CAAG;;;;;;;;;;;;AAEL,qBAAa,WAAY,SAAQ,gBAG/B;CAAG;;;;;;;;;;;;AAEL,qBAAa,cAAe,SAAQ,mBAGlC;CAAG;AAEL,qBAAa,aAAc,SAAQ,IAAI,CAAC,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;IACjE,UAAU;;;CAGX;AAED,qBAAa,gBAAiB,SAAQ,IAAI,CAAC,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;IACpE,UAAU;;;CAGX;AAED,qBAAa,UAAW,SAAQ,IAAI,CAAC,KAAK,CAAC;IACzC,KAAK,EAAE,cAAc,GAAG,gBAAgB,CAAA;IACxC,OAAO,EAAE,MAAM,CAAA;CAChB,CAAC;IACA,UAAU;;;;;;;;CAMX;AAED,qBAAa,SAAU,SAAQ,IAAI,CAAC,KAAK,CAAC;IACxC,OAAO,EAAE,WAAW,GAAG,aAAa,CAAA;IACpC,MAAM,EAAE,MAAM,CAAA;CACf,CAAC;IACA,UAAU;;;;;;;;CAMX"}

package/dist/Chat.js

@@ -0,0 +1,48 @@
+import * as Data from 'effect/Data';
+import * as internal from "./internal/chat.js";
+export class PeerUser extends internal.Peer({
+    validatePeerId: id => (id >= 1 && id <= 0xFFFFFFFFFF),
+    peerIdToDialogId: id => id,
+}) {
+}
+export class PeerGroup extends internal.Peer({
+    validatePeerId: id => (id >= 1 && id <= 999999999999),
+    peerIdToDialogId: id => -id,
+}) {
+}
+export class PeerChannel extends internal.Peer({
+    validatePeerId: id => (id >= 1 && id <= 997852516352),
+    peerIdToDialogId: id => -(1000000000000 + id),
+}) {
+}
+export class PeerSupergroup extends internal.Peer({
+    validatePeerId: id => (id >= 1 && id <= 997852516352),
+    peerIdToDialogId: id => -(1000000000000 + id),
+}) {
+}
+export class PublicChannel extends Data.Class {
+    sendParams() {
+        return { chat_id: this.username };
+    }
+}
+export class PublicSupergroup extends Data.Class {
+    sendParams() {
+        return { chat_id: this.username };
+    }
+}
+export class ForumTopic extends Data.Class {
+    sendParams() {
+        return {
+            ...this.forum.sendParams(),
+            message_thread_id: this.topicId,
+        };
+    }
+}
+export class ChannelDm extends Data.Class {
+    sendParams() {
+        return {
+            ...this.channel.sendParams(),
+            direct_messages_topic_id: this.userId,
+        };
+    }
+}

package/dist/Content.d.ts

@@ -0,0 +1,43 @@
+import type { MethodParams } from './BotApi.ts';
+import type { InputFile } from './InputFile.ts';
+import type { LinkPreview } from './LinkPreview.ts';
+import type { Text as Text$ } from './Text.ts';
+import * as Option from 'effect/Option';
+/**
+ * Content of a message to be sent.
+ *
+ * @see {@link https://core.telegram.org/tdlib/docs/classtd_1_1td__api_1_1_input_message_content.html td.td_api.InputMessageContent}
+ */
+export type Content = Text | Photo;
+declare const Text_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => Readonly<A> & {
+    readonly _tag: "text";
+};
+/**
+ * Content of a text message.
+ *
+ * @see {@link https://core.telegram.org/tdlib/docs/classtd_1_1td__api_1_1input_message_text.html td.td_api.inputMessageText}
+ */
+export declare class Text extends Text_base<{
+    text: Text$;
+    linkPreview: Option.Option<LinkPreview>;
+}> {
+    sendParams(): Pick<MethodParams['sendMessage'], 'text' | 'entities' | 'parse_mode' | 'link_preview_options'>;
+}
+declare const Photo_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => Readonly<A> & {
+    readonly _tag: "photo";
+};
+/**
+ * Content of a photo message.
+ *
+ * @see {@link https://core.telegram.org/tdlib/docs/classtd_1_1td__api_1_1input_message_photo.html td.td_api.inputMessagePhoto}
+ */
+export declare class Photo extends Photo_base<{
+    file: InputFile;
+    caption: Option.Option<Text>;
+    layout: 'caption-above' | 'caption-below';
+    spoiler: boolean;
+}> {
+    sendParams(): Pick<MethodParams['sendPhoto'], 'photo' | 'caption' | 'caption_entities' | 'parse_mode' | 'show_caption_above_media' | 'has_spoiler'>;
+}
+export {};
+//# sourceMappingURL=Content.d.ts.map

package/dist/Content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Content.d.ts","sourceRoot":"","sources":["../src/Content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,WAAW,CAAA;AAE9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC;;;;GAIG;AACH,MAAM,MAAM,OAAO,GACb,IAAI,GACJ,KAAK,CAAA;;;;AAEX;;;;GAIG;AACH,qBAAa,IAAK,SAAQ,UAAyB;IACjD,IAAI,EAAE,KAAK,CAAA;IACX,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;CACxC,CAAC;IACA,UAAU,IAAI,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,sBAAsB,CAAC;CAS7G;;;;AAED;;;;GAIG;AACH,qBAAa,KAAM,SAAQ,WAA0B;IACnD,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC5B,MAAM,EAAE,eAAe,GAAG,eAAe,CAAA;IACzC,OAAO,EAAE,OAAO,CAAA;CACjB,CAAC;IACA,UAAU,IAAI,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,kBAAkB,GAAG,YAAY,GAAG,0BAA0B,GAAG,aAAa,CAAC;CAkBpJ"}

package/dist/Content.js

@@ -0,0 +1,39 @@
+import * as Data from 'effect/Data';
+import * as Option from 'effect/Option';
+/**
+ * Content of a text message.
+ *
+ * @see {@link https://core.telegram.org/tdlib/docs/classtd_1_1td__api_1_1input_message_text.html td.td_api.inputMessageText}
+ */
+export class Text extends Data.TaggedClass('text') {
+    sendParams() {
+        return {
+            ...this.text.sendParams(),
+            link_preview_options: Option.match(this.linkPreview, {
+                onNone: () => ({ is_disabled: true }),
+                onSome: lp => lp.options(),
+            }),
+        };
+    }
+}
+/**
+ * Content of a photo message.
+ *
+ * @see {@link https://core.telegram.org/tdlib/docs/classtd_1_1td__api_1_1input_message_photo.html td.td_api.inputMessagePhoto}
+ */
+export class Photo extends Data.TaggedClass('photo') {
+    sendParams() {
+        const { text: caption, entities: caption_entities, parse_mode, } = Option.match(this.caption, {
+            onNone: () => ({}),
+            onSome: caption => caption.sendParams(),
+        });
+        return {
+            photo: this.file,
+            caption,
+            caption_entities,
+            parse_mode,
+            show_caption_above_media: this.layout === 'caption-above',
+            has_spoiler: this.spoiler,
+        };
+    }
+}

package/dist/InputFile.d.ts

@@ -0,0 +1,4 @@
+/** @todo */
+export declare class InputFile {
+}
+//# sourceMappingURL=InputFile.d.ts.map

package/dist/InputFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputFile.d.ts","sourceRoot":"","sources":["../src/InputFile.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,qBAAa,SAAS;CAAG"}

package/dist/InputFile.js

@@ -0,0 +1,3 @@
+/** @todo */
+export class InputFile {
+}

package/dist/LinkPreview.d.ts

@@ -0,0 +1,11 @@
+import type { Types } from './BotApi.ts';
+import * as Data from 'effect/Data';
+import * as Option from 'effect/Option';
+export declare class LinkPreview extends Data.Class<{
+    url: Option.Option<string>;
+    position: 'above' | 'below';
+    mediaSize: 'large' | 'small';
+}> {
+    options(): Types.LinkPreviewOptions;
+}
+//# sourceMappingURL=LinkPreview.d.ts.map

package/dist/LinkPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkPreview.d.ts","sourceRoot":"","sources":["../src/LinkPreview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,qBAAa,WAAY,SAAQ,IAAI,CAAC,KAAK,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC1B,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAA;IAC3B,SAAS,EAAE,OAAO,GAAG,OAAO,CAAA;CAC7B,CAAC;IACA,OAAO,IAAI,KAAK,CAAC,kBAAkB;CAgBpC"}

package/dist/LinkPreview.js

@@ -0,0 +1,20 @@
+import * as Data from 'effect/Data';
+import * as Option from 'effect/Option';
+export class LinkPreview extends Data.Class {
+    options() {
+        const opts = { is_disabled: false };
+        if (Option.isSome(this.url)) {
+            opts.url = this.url.value;
+        }
+        if (this.position === 'above') {
+            opts.show_above_text = true;
+        }
+        if (this.mediaSize === 'large') {
+            opts.prefer_large_media = true;
+        }
+        else if (this.mediaSize === 'small') {
+            opts.prefer_small_media = true;
+        }
+        return opts;
+    }
+}

package/dist/Send.d.ts

@@ -0,0 +1,25 @@
+import type { MethodParams } from './BotApi.ts';
+import type { Chat } from './Chat.ts';
+import type { Content } from './Content.ts';
+import * as Data from 'effect/Data';
+import * as Effect from 'effect/Effect';
+import * as BotApi from './BotApi.ts';
+/**
+ * Creates an effect that sends a message.
+ *
+ * @todo Reply options are not supported.
+ * @todo Reply markup is not supported.
+ */
+export declare const message: (args: {
+    chat: Chat;
+    content: Content;
+    options?: Options;
+}) => Effect.Effect<BotApi.Types.Message, import("./BotApiTransport.ts").BotApiTransportError | BotApi.BotApiError, BotApi.BotApi>;
+export declare class Options extends Data.Class<{
+    disableNotification?: boolean;
+    protectContent?: boolean;
+    allowPaidBroadcast?: boolean;
+}> {
+    sendParams(): Pick<MethodParams['sendMessage'], 'disable_notification' | 'protect_content' | 'allow_paid_broadcast'>;
+}
+//# sourceMappingURL=Send.d.ts.map

package/dist/Send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Send.d.ts","sourceRoot":"","sources":["../src/Send.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM;IAC5B,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,iIAcA,CAAA;AAED,qBAAa,OAAQ,SAAQ,IAAI,CAAC,KAAK,CAAC;IACtC,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B,CAAC;IACA,UAAU,IAAI,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,sBAAsB,GAAG,iBAAiB,GAAG,sBAAsB,CAAC;CAOrH"}

package/dist/Send.js

@@ -0,0 +1,26 @@
+import * as Data from 'effect/Data';
+import * as Effect from 'effect/Effect';
+import * as Match from 'effect/Match';
+import * as BotApi from "./BotApi.js";
+/**
+ * Creates an effect that sends a message.
+ *
+ * @todo Reply options are not supported.
+ * @todo Reply markup is not supported.
+ */
+export const message = (args) => {
+    const rest = {
+        ...args.chat.sendParams(),
+        ...args.options?.sendParams(),
+    };
+    return BotApi.BotApi.pipe(Effect.andThen(api => Match.value(args.content).pipe(Match.tag('text', content => api.sendMessage({ ...rest, ...content.sendParams() })), Match.tag('photo', content => api.sendPhoto({ ...rest, ...content.sendParams() })), Match.exhaustive)));
+};
+export class Options extends Data.Class {
+    sendParams() {
+        return {
+            disable_notification: this.disableNotification || undefined,
+            protect_content: this.protectContent || undefined,
+            allow_paid_broadcast: this.allowPaidBroadcast || undefined,
+        };
+    }
+}

package/dist/Text.d.ts

@@ -0,0 +1,25 @@
+import type { MethodParams, Types } from './BotApi.ts';
+import * as Data from 'effect/Data';
+/**
+ * Formatted text.
+ */
+export type Text = Plain | Html | Markdown;
+export declare class Plain extends Data.Class<{
+    text: string;
+    entities?: Array<Types.MessageEntity>;
+}> {
+    sendParams(): SendParams;
+}
+export declare class Html extends Data.Class<{
+    html: string;
+}> {
+    sendParams(): SendParams;
+}
+export declare class Markdown extends Data.Class<{
+    markdown: string;
+}> {
+    sendParams(): SendParams;
+}
+type SendParams = Pick<MethodParams['sendMessage'], 'text' | 'entities' | 'parse_mode'>;
+export {};
+//# sourceMappingURL=Text.d.ts.map

package/dist/Text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Text.d.ts","sourceRoot":"","sources":["../src/Text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AAEnC;;GAEG;AACH,MAAM,MAAM,IAAI,GACV,KAAK,GACL,IAAI,GACJ,QAAQ,CAAA;AAEd,qBAAa,KAAM,SAAQ,IAAI,CAAC,KAAK,CAAC;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;CACtC,CAAC;IACA,UAAU,IAAI,UAAU;CAGzB;AAED,qBAAa,IAAK,SAAQ,IAAI,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;IACpD,UAAU,IAAI,UAAU;CAGzB;AAED,qBAAa,QAAS,SAAQ,IAAI,CAAC,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;IAC5D,UAAU,IAAI,UAAU;CAGzB;AAED,KAAK,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC,CAAA"}

package/dist/Text.js

@@ -0,0 +1,16 @@
+import * as Data from 'effect/Data';
+export class Plain extends Data.Class {
+    sendParams() {
+        return { text: this.text, entities: this.entities };
+    }
+}
+export class Html extends Data.Class {
+    sendParams() {
+        return { text: this.html, parse_mode: 'HTML' };
+    }
+}
+export class Markdown extends Data.Class {
+    sendParams() {
+        return { text: this.markdown, parse_mode: 'MarkdownV2' };
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * as BotApi from './BotApi.ts';
+export * as BotApiTransport from './BotApiTransport.ts';
+export * as BotApiWebhook from './BotApiWebhook.ts';
+export * as Chat from './Chat.ts';
+export * as Content from './Content.ts';
+export * as InputFile from './InputFile.ts';
+export * as LinkPreview from './LinkPreview.ts';
+export * as Send from './Send.ts';
+export * as Text from './Text.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * as BotApi from "./BotApi.js";
+export * as BotApiTransport from "./BotApiTransport.js";
+export * as BotApiWebhook from "./BotApiWebhook.js";
+export * as Chat from "./Chat.js";
+export * as Content from "./Content.js";
+export * as InputFile from "./InputFile.js";
+export * as LinkPreview from "./LinkPreview.js";
+export * as Send from "./Send.js";
+export * as Text from "./Text.js";