@effect-uai/telegram 0.14.0

package/dist/internal/api.mjs

@@ -0,0 +1,66 @@
+import { Array, Data, Duration, Effect, Redacted, Result, Schema, pipe } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/unstable/http";
+import * as MessengerError from "@effect-uai/core/MessengerError";
+import * as Multipart from "@effect-uai/core/Multipart";
+//#region src/internal/api.ts
+const provider = "telegram";
+/**
+* A Bot API call that came back `ok: false` or never came back at all.
+* `code` mirrors the HTTP status Telegram puts in `error_code`; each verb
+* maps this onto its own `MessengerError`.
+*/
+var ApiFailure = class extends Data.TaggedError("TelegramApiFailure") {};
+const Envelope = Schema.Struct({
+	ok: Schema.Boolean,
+	result: Schema.optional(Schema.Unknown),
+	description: Schema.optional(Schema.String),
+	error_code: Schema.optional(Schema.Number),
+	parameters: Schema.optional(Schema.Struct({ retry_after: Schema.optional(Schema.Number) }))
+});
+const endpoint = (cfg, method) => `${cfg.baseUrl ?? "https://api.telegram.org"}/bot${Redacted.value(cfg.token)}/${method}`;
+const transportFailure = (method) => (raw) => new ApiFailure({
+	method,
+	description: "transport failure",
+	raw
+});
+const rejected = (method, envelope) => envelope.parameters?.retry_after !== void 0 ? new MessengerError.MessengerRateLimited({
+	provider,
+	retryAfter: Duration.seconds(envelope.parameters.retry_after),
+	raw: envelope
+}) : new ApiFailure({
+	method,
+	...envelope.error_code !== void 0 && { code: envelope.error_code },
+	description: envelope.description ?? "unknown error",
+	raw: envelope
+});
+const send = (method, request) => Effect.gen(function* () {
+	const json = yield* (yield* (yield* HttpClient.HttpClient).execute(request).pipe(Effect.mapError(transportFailure(method)))).json.pipe(Effect.mapError(transportFailure(method)));
+	const envelope = yield* Schema.decodeUnknownEffect(Envelope)(json).pipe(Effect.mapError(() => new ApiFailure({
+		method,
+		description: "malformed envelope",
+		raw: json
+	})));
+	return envelope.ok ? envelope.result : yield* rejected(method, envelope);
+});
+/** One JSON-bodied method call. `result` comes back undecoded. */
+const call = (cfg) => (method, params = {}) => send(method, HttpClientRequest.post(endpoint(cfg, method)).pipe(HttpClientRequest.bodyJsonUnsafe(params)));
+const entries = (params, file) => pipe(Object.entries(params), Array.filterMap(([name, value]) => value === void 0 ? Result.failVoid : Result.succeed([name, String(value)])), Array.append([file.field, new File([file.bytes], file.filename, { type: file.mimeType })]));
+const formData = (fields) => fields.reduce((form, [name, value]) => (form.append(name, value), form), new FormData());
+/** One multipart method call: string fields plus a single file part. */
+const upload = (cfg) => (method, params, file) => Effect.gen(function* () {
+	const body = yield* Multipart.bodyMultipart(formData(entries(params, file))).pipe(Effect.mapError(transportFailure(method)));
+	return yield* send(method, HttpClientRequest.post(endpoint(cfg, method)).pipe(body));
+});
+/** Decode a call's `result`; a shape mismatch is a malformed response, not a defect. */
+const decoded = (method, schema) => (result) => Effect.gen(function* () {
+	const raw = yield* result;
+	return yield* Schema.decodeUnknownEffect(schema)(raw).pipe(Effect.mapError(() => new ApiFailure({
+		method,
+		description: "malformed result",
+		raw
+	})));
+});
+//#endregion
+export { ApiFailure, call, decoded, provider, upload };
+
+//# sourceMappingURL=api.mjs.map

package/dist/internal/api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.mjs","names":["Arr"],"sources":["../../src/internal/api.ts"],"sourcesContent":["import { Array as Arr, Data, Duration, Effect, Redacted, Result, Schema, pipe } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as MessengerError from \"@effect-uai/core/MessengerError\"\nimport * as Multipart from \"@effect-uai/core/Multipart\"\n\nexport const provider = \"telegram\"\n\nexport type Config = {\n  readonly token: Redacted.Redacted\n  /** Defaults to `https://api.telegram.org`. */\n  readonly baseUrl?: string\n}\n\n/**\n * A Bot API call that came back `ok: false` or never came back at all.\n * `code` mirrors the HTTP status Telegram puts in `error_code`; each verb\n * maps this onto its own `MessengerError`.\n */\nexport class ApiFailure extends Data.TaggedError(\"TelegramApiFailure\")<{\n  readonly method: string\n  readonly code?: number\n  readonly description: string\n  readonly raw: unknown\n}> {}\n\nexport type ApiError = ApiFailure | MessengerError.MessengerRateLimited\n\nconst Envelope = Schema.Struct({\n  ok: Schema.Boolean,\n  result: Schema.optional(Schema.Unknown),\n  description: Schema.optional(Schema.String),\n  error_code: Schema.optional(Schema.Number),\n  parameters: Schema.optional(Schema.Struct({ retry_after: Schema.optional(Schema.Number) })),\n})\n\nexport type Params = Readonly<Record<string, unknown>>\n\n/** The file part of a multipart upload. */\nexport type Upload = {\n  readonly field: string\n  readonly bytes: Uint8Array\n  readonly filename: string\n  readonly mimeType: string\n}\n\nconst endpoint = (cfg: Config, method: string): string =>\n  `${cfg.baseUrl ?? \"https://api.telegram.org\"}/bot${Redacted.value(cfg.token)}/${method}`\n\nconst transportFailure = (method: string) => (raw: unknown) =>\n  new ApiFailure({ method, description: \"transport failure\", raw })\n\nconst rejected = (method: string, envelope: typeof Envelope.Type): ApiError =>\n  envelope.parameters?.retry_after !== undefined\n    ? new MessengerError.MessengerRateLimited({\n        provider,\n        retryAfter: Duration.seconds(envelope.parameters.retry_after),\n        raw: envelope,\n      })\n    : new ApiFailure({\n        method,\n        ...(envelope.error_code !== undefined && { code: envelope.error_code }),\n        description: envelope.description ?? \"unknown error\",\n        raw: envelope,\n      })\n\nconst send = (\n  method: string,\n  request: HttpClientRequest.HttpClientRequest,\n): Effect.Effect<unknown, ApiError, HttpClient.HttpClient> =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const response = yield* client.execute(request).pipe(Effect.mapError(transportFailure(method)))\n    const json = yield* response.json.pipe(Effect.mapError(transportFailure(method)))\n    const envelope = yield* Schema.decodeUnknownEffect(Envelope)(json).pipe(\n      Effect.mapError(\n        () => new ApiFailure({ method, description: \"malformed envelope\", raw: json }),\n      ),\n    )\n    return envelope.ok ? envelope.result : yield* rejected(method, envelope)\n  })\n\n/** One JSON-bodied method call. `result` comes back undecoded. */\nexport const call =\n  (cfg: Config) =>\n  (method: string, params: Params = {}): Effect.Effect<unknown, ApiError, HttpClient.HttpClient> =>\n    send(\n      method,\n      HttpClientRequest.post(endpoint(cfg, method)).pipe(HttpClientRequest.bodyJsonUnsafe(params)),\n    )\n\ntype Entry = readonly [name: string, value: string | File]\n\n// A `File` carries its own filename, so one entry shape covers both kinds.\nconst entries = (params: Params, file: Upload): ReadonlyArray<Entry> =>\n  pipe(\n    Object.entries(params),\n    Arr.filterMap(([name, value]) =>\n      value === undefined ? Result.failVoid : Result.succeed([name, String(value)] as const),\n    ),\n    Arr.append([\n      file.field,\n      new File([file.bytes as Uint8Array<ArrayBuffer>], file.filename, { type: file.mimeType }),\n    ] as const),\n  )\n\nconst formData = (fields: ReadonlyArray<Entry>): FormData =>\n  fields.reduce((form, [name, value]) => (form.append(name, value), form), new FormData())\n\n/** One multipart method call: string fields plus a single file part. */\nexport const upload =\n  (cfg: Config) =>\n  (\n    method: string,\n    params: Params,\n    file: Upload,\n  ): Effect.Effect<unknown, ApiError, HttpClient.HttpClient> =>\n    Effect.gen(function* () {\n      const body = yield* Multipart.bodyMultipart(formData(entries(params, file))).pipe(\n        Effect.mapError(transportFailure(method)),\n      )\n      return yield* send(method, HttpClientRequest.post(endpoint(cfg, method)).pipe(body))\n    })\n\n/** Decode a call's `result`; a shape mismatch is a malformed response, not a defect. */\nexport const decoded =\n  <A>(method: string, schema: Schema.Decoder<A>) =>\n  <E, R>(result: Effect.Effect<unknown, E, R>): Effect.Effect<A, E | ApiFailure, R> =>\n    Effect.gen(function* () {\n      const raw = yield* result\n      return yield* Schema.decodeUnknownEffect(schema)(raw).pipe(\n        Effect.mapError(() => new ApiFailure({ method, description: \"malformed result\", raw })),\n      )\n    })\n"],"mappings":"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"}

package/dist/internal/events.d.mts

@@ -0,0 +1,2 @@
+import { a as Message, c as Reaction, d as User, f as allowedUpdates, i as Entity, l as ReplyTarget, n as CallbackQuery, o as MessageReaction, p as toEvents, r as Chat, s as Placement, t as BotIdentity, u as Update } from "../events-BkljYfG6.mjs";
+export { BotIdentity, CallbackQuery, Chat, Entity, Message, MessageReaction, Placement, Reaction, ReplyTarget, Update, User, allowedUpdates, toEvents };

package/dist/internal/events.mjs

@@ -0,0 +1,137 @@
+import { Array, Match, Option, Schema } from "effect";
+import { ChannelId, InboundEvent, MessageId, ThreadId, UserId } from "@effect-uai/core/Messenger";
+//#region src/internal/events.ts
+const User = Schema.Struct({
+	id: Schema.Number,
+	is_bot: Schema.Boolean,
+	username: Schema.optional(Schema.String)
+});
+const Chat = Schema.Struct({
+	id: Schema.Number,
+	type: Schema.String
+});
+const Entity = Schema.Struct({
+	type: Schema.String,
+	offset: Schema.Number,
+	length: Schema.Number
+});
+/** Where a message sits: its chat, and its forum topic when it is in one. */
+const Placement = Schema.Struct({
+	chat: Chat,
+	message_thread_id: Schema.optional(Schema.Number),
+	is_topic_message: Schema.optional(Schema.Boolean)
+});
+const ReplyTarget = Schema.Struct({
+	message_id: Schema.Number,
+	from: Schema.optional(User)
+});
+const Message = Schema.Struct({
+	...Placement.fields,
+	message_id: Schema.Number,
+	from: Schema.optional(User),
+	text: Schema.optional(Schema.String),
+	caption: Schema.optional(Schema.String),
+	entities: Schema.optional(Schema.Array(Entity)),
+	reply_to_message: Schema.optional(ReplyTarget)
+});
+const Reaction = Schema.Struct({
+	type: Schema.String,
+	emoji: Schema.optional(Schema.String)
+});
+const MessageReaction = Schema.Struct({
+	chat: Chat,
+	message_id: Schema.Number,
+	user: Schema.optional(User),
+	new_reaction: Schema.Array(Reaction)
+});
+const CallbackQuery = Schema.Struct({
+	id: Schema.String,
+	from: User,
+	data: Schema.optional(Schema.String),
+	message: Schema.optional(Schema.Struct({
+		...Placement.fields,
+		message_id: Schema.Number
+	}))
+});
+const Update = Schema.Struct({
+	update_id: Schema.Number,
+	message: Schema.optional(Message),
+	edited_message: Schema.optional(Message),
+	message_reaction: Schema.optional(MessageReaction),
+	callback_query: Schema.optional(CallbackQuery)
+});
+/** Requested on every `getUpdates`; without it Telegram never delivers reactions. */
+const allowedUpdates = [
+	"message",
+	"edited_message",
+	"callback_query",
+	"message_reaction"
+];
+const conversation = (at) => ({
+	channel: ChannelId(String(at.chat.id)),
+	...at.is_topic_message === true && at.message_thread_id !== void 0 && { thread: ThreadId(String(at.message_thread_id)) }
+});
+const slice = (text, entity) => text.slice(entity.offset, entity.offset + entity.length);
+const isOwnHandle = (bot, handle) => handle.toLowerCase() === `@${bot.username}`.toLowerCase();
+const entitiesOf = (message) => message.entities ?? [];
+const ownMentions = (bot, message, text) => entitiesOf(message).filter((entity) => entity.type === "mention" && isOwnHandle(bot, slice(text, entity)));
+/** `/name@bot args` at offset 0 is a command; a mid-text `/word` is just text. */
+const command = (bot, message, text) => Array.findFirst(entitiesOf(message), (entity) => entity.type === "bot_command" && entity.offset === 0).pipe(Option.flatMap((entity) => {
+	const [name = "", suffix] = slice(text, entity).slice(1).split("@");
+	return suffix !== void 0 && !isOwnHandle(bot, `@${suffix}`) ? Option.none() : Option.some({
+		name,
+		args: text.slice(entity.length).trim()
+	});
+}));
+/** The bot's own `@handle` removed, right to left so earlier offsets stay valid. */
+const withoutMention = (bot, message, text) => Array.reverse(ownMentions(bot, message, text)).reduce((acc, entity) => acc.slice(0, entity.offset) + acc.slice(entity.offset + entity.length), text).trim();
+const isAddressed = (bot, message, text) => message.chat.type === "private" || ownMentions(bot, message, text).length > 0 || message.reply_to_message?.from?.id === bot.id;
+const fromMessage = (bot, message, raw) => Option.map(Option.fromNullishOr(message.from), (from) => {
+	const text = message.text ?? message.caption ?? "";
+	const author = UserId(String(from.id));
+	const at = conversation(message);
+	return Option.match(command(bot, message, text), {
+		onSome: ({ name, args }) => InboundEvent.Command({
+			conversation: at,
+			name,
+			args,
+			author,
+			raw
+		}),
+		onNone: () => InboundEvent.Message({
+			conversation: at,
+			id: MessageId(String(message.message_id)),
+			author,
+			text: withoutMention(bot, message, text),
+			addressed: isAddressed(bot, message, text),
+			...message.reply_to_message !== void 0 && { replyTo: MessageId(String(message.reply_to_message.message_id)) },
+			raw
+		})
+	});
+});
+const fromReaction = (reaction, raw) => Option.match(Option.fromNullishOr(reaction.user), {
+	onNone: () => [],
+	onSome: (user) => Array.flatMap(reaction.new_reaction, (r) => Array.fromNullishOr(r.emoji).map((emoji) => InboundEvent.Reaction({
+		conversation: conversation({ chat: reaction.chat }),
+		message: MessageId(String(reaction.message_id)),
+		emoji,
+		author: UserId(String(user.id)),
+		raw
+	})))
+});
+const fromCallback = (query, raw) => Option.map(Option.fromNullishOr(query.message), (message) => InboundEvent.Action({
+	conversation: conversation(message),
+	actionId: query.data ?? "",
+	author: UserId(String(query.from.id)),
+	raw
+}));
+/**
+* Everything one `Update` says to the agent. Edited messages are received
+* (so the offset advances past them) but not re-delivered: a turn already
+* answered them.
+*/
+const toEvents = (bot) => (update) => Match.value(update).pipe(Match.when({ message: Match.defined }, ({ message }) => Array.fromOption(fromMessage(bot, message, update))), Match.when({ message_reaction: Match.defined }, ({ message_reaction }) => fromReaction(message_reaction, update)), Match.when({ callback_query: Match.defined }, ({ callback_query }) => Array.fromOption(fromCallback(callback_query, update))), Match.orElse(() => []));
+//#endregion
+export { CallbackQuery, Chat, Entity, Message, MessageReaction, Placement, Reaction, ReplyTarget, Update, User, allowedUpdates, toEvents };
+
+//# sourceMappingURL=events.mjs.map

package/dist/internal/events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.mjs","names":["Arr"],"sources":["../../src/internal/events.ts"],"sourcesContent":["import { Array as Arr, Match, Option, Schema } from \"effect\"\nimport {\n  ChannelId,\n  type ConversationRef,\n  InboundEvent,\n  MessageId,\n  ThreadId,\n  UserId,\n} from \"@effect-uai/core/Messenger\"\n\n// ---------------------------------------------------------------------------\n// Wire shapes: the fields this adapter reads. The rest survives on `raw`.\n// ---------------------------------------------------------------------------\n\nexport const User = Schema.Struct({\n  id: Schema.Number,\n  is_bot: Schema.Boolean,\n  username: Schema.optional(Schema.String),\n})\nexport type User = typeof User.Type\n\nexport const Chat = Schema.Struct({\n  id: Schema.Number,\n  type: Schema.String,\n})\nexport type Chat = typeof Chat.Type\n\nexport const Entity = Schema.Struct({\n  type: Schema.String,\n  offset: Schema.Number,\n  length: Schema.Number,\n})\nexport type Entity = typeof Entity.Type\n\n/** Where a message sits: its chat, and its forum topic when it is in one. */\nexport const Placement = Schema.Struct({\n  chat: Chat,\n  message_thread_id: Schema.optional(Schema.Number),\n  is_topic_message: Schema.optional(Schema.Boolean),\n})\nexport type Placement = typeof Placement.Type\n\nexport const ReplyTarget = Schema.Struct({\n  message_id: Schema.Number,\n  from: Schema.optional(User),\n})\nexport type ReplyTarget = typeof ReplyTarget.Type\n\nexport const Message = Schema.Struct({\n  ...Placement.fields,\n  message_id: Schema.Number,\n  from: Schema.optional(User),\n  text: Schema.optional(Schema.String),\n  caption: Schema.optional(Schema.String),\n  entities: Schema.optional(Schema.Array(Entity)),\n  reply_to_message: Schema.optional(ReplyTarget),\n})\nexport type Message = typeof Message.Type\n\nexport const Reaction = Schema.Struct({\n  type: Schema.String,\n  emoji: Schema.optional(Schema.String),\n})\nexport type Reaction = typeof Reaction.Type\n\nexport const MessageReaction = Schema.Struct({\n  chat: Chat,\n  message_id: Schema.Number,\n  user: Schema.optional(User),\n  new_reaction: Schema.Array(Reaction),\n})\nexport type MessageReaction = typeof MessageReaction.Type\n\nexport const CallbackQuery = Schema.Struct({\n  id: Schema.String,\n  from: User,\n  data: Schema.optional(Schema.String),\n  message: Schema.optional(Schema.Struct({ ...Placement.fields, message_id: Schema.Number })),\n})\nexport type CallbackQuery = typeof CallbackQuery.Type\n\nexport const Update = Schema.Struct({\n  update_id: Schema.Number,\n  message: Schema.optional(Message),\n  edited_message: Schema.optional(Message),\n  message_reaction: Schema.optional(MessageReaction),\n  callback_query: Schema.optional(CallbackQuery),\n})\nexport type Update = typeof Update.Type\n\n/** Requested on every `getUpdates`; without it Telegram never delivers reactions. */\nexport const allowedUpdates = [\n  \"message\",\n  \"edited_message\",\n  \"callback_query\",\n  \"message_reaction\",\n] as const\n\nexport type BotIdentity = {\n  readonly id: number\n  readonly username: string\n}\n\n// ---------------------------------------------------------------------------\n// Mapping\n// ---------------------------------------------------------------------------\n\nconst conversation = (at: Placement): ConversationRef => ({\n  channel: ChannelId(String(at.chat.id)),\n  // Forum topics are threads; reply chains are not (they carry no thread id).\n  ...(at.is_topic_message === true &&\n    at.message_thread_id !== undefined && { thread: ThreadId(String(at.message_thread_id)) }),\n})\n\nconst slice = (text: string, entity: Entity): string =>\n  text.slice(entity.offset, entity.offset + entity.length)\n\nconst isOwnHandle = (bot: BotIdentity, handle: string): boolean =>\n  handle.toLowerCase() === `@${bot.username}`.toLowerCase()\n\nconst entitiesOf = (message: Message): ReadonlyArray<Entity> => message.entities ?? []\n\nconst ownMentions = (bot: BotIdentity, message: Message, text: string): ReadonlyArray<Entity> =>\n  entitiesOf(message).filter(\n    (entity) => entity.type === \"mention\" && isOwnHandle(bot, slice(text, entity)),\n  )\n\ntype Command = { readonly name: string; readonly args: string }\n\n/** `/name@bot args` at offset 0 is a command; a mid-text `/word` is just text. */\nconst command = (bot: BotIdentity, message: Message, text: string): Option.Option<Command> =>\n  Arr.findFirst(\n    entitiesOf(message),\n    (entity) => entity.type === \"bot_command\" && entity.offset === 0,\n  ).pipe(\n    Option.flatMap((entity) => {\n      const [name = \"\", suffix] = slice(text, entity).slice(1).split(\"@\")\n      // A command aimed at another bot arrives under privacy-off, but is not ours.\n      return suffix !== undefined && !isOwnHandle(bot, `@${suffix}`)\n        ? Option.none()\n        : Option.some({ name, args: text.slice(entity.length).trim() })\n    }),\n  )\n\n/** The bot's own `@handle` removed, right to left so earlier offsets stay valid. */\nconst withoutMention = (bot: BotIdentity, message: Message, text: string): string =>\n  Arr.reverse(ownMentions(bot, message, text))\n    .reduce(\n      (acc, entity) => acc.slice(0, entity.offset) + acc.slice(entity.offset + entity.length),\n      text,\n    )\n    .trim()\n\nconst isAddressed = (bot: BotIdentity, message: Message, text: string): boolean =>\n  message.chat.type === \"private\" ||\n  ownMentions(bot, message, text).length > 0 ||\n  message.reply_to_message?.from?.id === bot.id\n\nconst fromMessage = (\n  bot: BotIdentity,\n  message: Message,\n  raw: unknown,\n): Option.Option<InboundEvent> =>\n  Option.map(Option.fromNullishOr(message.from), (from) => {\n    const text = message.text ?? message.caption ?? \"\"\n    const author = UserId(String(from.id))\n    const at = conversation(message)\n    return Option.match(command(bot, message, text), {\n      onSome: ({ name, args }) =>\n        InboundEvent.Command({ conversation: at, name, args, author, raw }),\n      onNone: () =>\n        InboundEvent.Message({\n          conversation: at,\n          id: MessageId(String(message.message_id)),\n          author,\n          text: withoutMention(bot, message, text),\n          addressed: isAddressed(bot, message, text),\n          ...(message.reply_to_message !== undefined && {\n            replyTo: MessageId(String(message.reply_to_message.message_id)),\n          }),\n          raw,\n        }),\n    })\n  })\n\nconst fromReaction = (reaction: MessageReaction, raw: unknown): ReadonlyArray<InboundEvent> =>\n  Option.match(Option.fromNullishOr(reaction.user), {\n    onNone: () => [],\n    onSome: (user) =>\n      Arr.flatMap(reaction.new_reaction, (r) =>\n        Arr.fromNullishOr(r.emoji).map((emoji) =>\n          InboundEvent.Reaction({\n            conversation: conversation({ chat: reaction.chat }),\n            message: MessageId(String(reaction.message_id)),\n            emoji,\n            author: UserId(String(user.id)),\n            raw,\n          }),\n        ),\n      ),\n  })\n\nconst fromCallback = (query: CallbackQuery, raw: unknown): Option.Option<InboundEvent> =>\n  Option.map(Option.fromNullishOr(query.message), (message) =>\n    InboundEvent.Action({\n      conversation: conversation(message),\n      actionId: query.data ?? \"\",\n      author: UserId(String(query.from.id)),\n      raw,\n    }),\n  )\n\n/**\n * Everything one `Update` says to the agent. Edited messages are received\n * (so the offset advances past them) but not re-delivered: a turn already\n * answered them.\n */\nexport const toEvents =\n  (bot: BotIdentity) =>\n  (update: Update): ReadonlyArray<InboundEvent> =>\n    Match.value(update).pipe(\n      Match.when({ message: Match.defined }, ({ message }) =>\n        Arr.fromOption(fromMessage(bot, message, update)),\n      ),\n      Match.when({ message_reaction: Match.defined }, ({ message_reaction }) =>\n        fromReaction(message_reaction, update),\n      ),\n      Match.when({ callback_query: Match.defined }, ({ callback_query }) =>\n        Arr.fromOption(fromCallback(callback_query, update)),\n      ),\n      Match.orElse(() => []),\n    )\n"],"mappings":"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"}

package/dist/internal/events.test.d.mts

@@ -0,0 +1 @@
+export {}