@yolk-sdk/emulators 0.1.0-canary.96

package/dist/telegram/api.mjs

@@ -0,0 +1,257 @@
+import { isNotEmulated, notEmulated, statefulRoute } from "../stateful-emulator.mjs";
+import { Predicate } from "effect";
+//#region src/telegram/api.ts
+/**
+* Telegram Bot API emulator API: the route table (evidence, query allowlist, guarded path,
+* handler) and the token-aware route resolution (internal; re-exported by `src/telegram.ts`, which
+* runs the table on the shared stateful wrapper, `src/stateful-emulator.ts`, in its resolved
+* mode).
+*
+* The bot token is part of every Bot API URL (`/bot<token>/<method>`, `/file/bot<token>/<path>`).
+* It is required, but it never reaches the core, the state, the ledger, a not-emulated message, or
+* a response. Resolution fails closed: only a request whose raw path is exactly an emulated route
+* shape is recognised, and its token is taken from that exact segment; every other request is
+* ledgered and answered with constant text only. For a recognised request the ledgered path reads
+* `/bot<redacted>/...`, the routes learn only whether the token names a bot, and the wrapper
+* scrubs the token and its secret part from the ledger and refuses a path, query, or body that
+* repeats them (raw, percent-decoded, or in any parsed JSON key, string value, or number).
+*
+* Only the routes the four Telegram conformance cases need are emulated, with wire shapes copied
+* from the synthetic fixtures; everything else answers the wrapper's ledgered 400 not-emulated.
+*
+* @experimental
+*/
+/**
+* The route parameter the resolution supplies instead of the token: whether the token names a bot
+* (`known`) or not (`none`). The token itself never reaches a route.
+*/
+const botParam = "bot";
+const validateCase = "telegram.validate.get-chat";
+const errorCase = "telegram.errors.error-envelope";
+const fileCase = "telegram.files.get-file-path";
+const sendCase = "telegram.messages.send-message";
+/** Bot API JSON answers, as the fixtures record them. */
+const json = (status, body) => new Response(JSON.stringify(body), {
+	status,
+	headers: { "content-type": "application/json" }
+});
+/** A chat id: an integer (negative for groups and channels) or a public `@username`. */
+const chatIdPattern = /^(?:-?[1-9][0-9]{0,19}|@[A-Za-z][A-Za-z0-9_]{3,31})$/;
+const isJsonObject = (value) => value !== void 0 && value !== null && Predicate.isObject(value) && !Array.isArray(value);
+const mediaType = (contentType) => contentType?.split(";", 1)[0]?.trim().toLowerCase();
+/**
+* A JSON body with exactly the `keys` the fixture records, or a refusal. Refusals never name a
+* request key or value (constant text).
+*/
+const bodyObject = (request, keys) => {
+	if (mediaType(request.contentType) !== "application/json") return notEmulated("Bot API bodies other than application/json are not emulated");
+	if (!isJsonObject(request.body)) return notEmulated("a request body that is not a JSON object is not emulated");
+	const sent = Object.keys(request.body);
+	if (sent.some((key) => !keys.includes(key))) return notEmulated("a body field this method does not take is not emulated");
+	return keys.every((key) => sent.includes(key)) ? request.body : notEmulated(`requests without each of the recorded body fields (${keys.join(", ")}) are not emulated`);
+};
+const noBody = (request) => request.hasBody ? notEmulated("a request body is not emulated on this method") : void 0;
+/** The chat a well-formed `chat_id` names, `null` for none, or a refusal. */
+const chatOf = (state, chatId) => {
+	if (!Predicate.isString(chatId) || !chatIdPattern.test(chatId)) return notEmulated("chat_id must be a chat id string (an integer or a public @username)");
+	return state.chats.find((chat) => String(chat.id) === chatId) ?? null;
+};
+/** The Bot API error envelope of the error fixture. */
+const botApiError = (env, status, description) => json(env.drills.errorsAs200 ? 200 : status, {
+	ok: false,
+	error_code: status,
+	description
+});
+const knownBotOnly = (request) => request.knownBot ? void 0 : notEmulated("a bot token that names no bot is emulated only on getChat (as recorded)");
+const getChat = (state, request, env) => {
+	const body = bodyObject(request, ["chat_id"]);
+	if (isNotEmulated(body)) return body;
+	const chat = chatOf(state, body.chat_id);
+	if (isNotEmulated(chat)) return chat;
+	if (!request.knownBot) return () => botApiError(env, 401, "Unauthorized");
+	if (chat === null) return () => botApiError(env, 400, "Bad Request: chat not found");
+	return () => json(200, {
+		ok: !env.drills.getChatOkFalse,
+		result: {
+			id: chat.id,
+			title: chat.title,
+			type: chat.type,
+			permissions: { can_send_messages: chat.permissions.can_send_messages },
+			accent_color_id: chat.accent_color_id,
+			max_reaction_count: chat.max_reaction_count
+		}
+	});
+};
+const getFile = (state, request, env) => {
+	const refused = noBody(request) ?? knownBotOnly(request);
+	if (refused !== void 0) return refused;
+	const fileId = request.query.get("file_id");
+	const file = state.files.find((item) => item.file_id === fileId);
+	if (file === void 0) return notEmulated("getFile of a file id the bot did not receive is not emulated");
+	return () => json(200, {
+		ok: true,
+		result: {
+			file_id: file.file_id,
+			file_unique_id: file.file_unique_id,
+			file_size: file.file_size + (env.drills.fileSizeOffByOne ? 1 : 0),
+			file_path: file.file_path
+		}
+	});
+};
+const downloadFile = (state, request) => {
+	const refused = noBody(request) ?? knownBotOnly(request);
+	if (refused !== void 0) return refused;
+	const file = state.files.find((item) => item.file_path === request.filePath);
+	if (file === void 0) return notEmulated("a file path getFile did not answer is not emulated");
+	return () => new Response(new TextEncoder().encode(file.content), {
+		status: 200,
+		headers: { "content-type": "application/octet-stream" }
+	});
+};
+const sendMessage = (state, request, env) => {
+	const refused = knownBotOnly(request);
+	if (refused !== void 0) return refused;
+	const body = bodyObject(request, [
+		"chat_id",
+		"text",
+		"disable_web_page_preview"
+	]);
+	if (isNotEmulated(body)) return body;
+	const chat = chatOf(state, body.chat_id);
+	if (isNotEmulated(chat)) return chat;
+	if (chat === null) return notEmulated("sendMessage to a chat the bot is not a member of is not emulated");
+	const { text, disable_web_page_preview: disablePreview } = body;
+	if (!Predicate.isString(text) || text === "") return notEmulated("text must be a non-empty string");
+	if (disablePreview !== true) return notEmulated("disable_web_page_preview other than true (as recorded) is not emulated");
+	return () => {
+		const now = env.now();
+		if (!Number.isFinite(now)) throw new Error("the emulator clock is not a finite instant");
+		const date = Math.floor(now / 1e3);
+		const messageId = state.counters.nextMessageId;
+		state.counters = {
+			...state.counters,
+			nextMessageId: messageId + 1
+		};
+		state.sentMessages = [...state.sentMessages, {
+			message_id: messageId,
+			chat_id: chat.id,
+			text,
+			date,
+			disable_web_page_preview: true
+		}];
+		return json(200, {
+			ok: !env.drills.sendOkFalse,
+			result: {
+				message_id: messageId,
+				from: {
+					id: state.bot.id,
+					is_bot: true,
+					first_name: state.bot.first_name,
+					username: state.bot.username
+				},
+				chat: {
+					id: chat.id,
+					title: chat.title,
+					type: chat.type
+				},
+				date,
+				text
+			}
+		});
+	};
+};
+/** The route's request, as the handlers see it (the wrapper checked and parsed the body). */
+const routeRequest = (request) => ({
+	query: request.query,
+	filePath: request.params.filePath,
+	body: request.json,
+	hasBody: request.json !== void 0,
+	contentType: request.header("content-type") ?? null,
+	knownBot: request.params[botParam] === "known"
+});
+const route = (method, path, guardedPath, write, caseIds, handler, queryKeys = []) => ({
+	route: statefulRoute({
+		method,
+		path,
+		kind: "connector",
+		write,
+		caseIds,
+		evidence: "unverified"
+	}, "json-or-empty", routeRequest, (state, request, context) => handler(state, request, context.env)),
+	queryKeys,
+	guardedPath
+});
+/** The route table: evidence plus handler. `telegramEmulatorRoutes` is its evidence part. */
+const telegramApiRoutes = [
+	route("POST", "/bot{token}/getChat", "/getChat", false, [validateCase, errorCase], getChat),
+	route("GET", "/bot{token}/getFile", "/getFile", false, [fileCase], getFile, ["file_id"]),
+	route("GET", "/file/bot{token}/{filePath}", "/file", false, [fileCase], downloadFile),
+	route("POST", "/bot{token}/sendMessage", "/sendMessage", true, [sendCase], sendMessage)
+];
+/**
+* A Bot API token as the connector sends it: `<bot id>:<secret>`, with a secret of at least 8
+* characters, so the secret part of every accepted token is long enough to be guarded on its own.
+* Matched on the RAW path segment: a percent-encoded character makes the request unrecognised.
+*/
+const tokenSource = "[0-9]+:[A-Za-z0-9_-]{8,}";
+/** `/bot<token>/<method>`, exactly: one of the emulated Bot API methods, no other path text. */
+const botPathPattern = new RegExp(`^/bot(${tokenSource})/(getChat|getFile|sendMessage)$`);
+/**
+* `/file/bot<token>/<file_path>`, exactly: a relative file path of letters, digits, and `_ . -`
+* segments (no percent-encoding, no empty or dot segments), the shape the download helper sends.
+*/
+const filePathPattern = new RegExp(`^/file/bot(${tokenSource})/((?:[A-Za-z0-9_.-]+/)*[A-Za-z0-9_.-]+)$`);
+const isPlainFilePath = (path) => path.split("/").every((part) => part !== "." && part !== "..");
+/** The constant reason of every unrecognised request (no method, path, or query is quoted). */
+const unrecognisedReason = "no emulated Bot API route for this method and path";
+/**
+* Resolve one Bot API request, failing closed. Only a request whose raw path is exactly an
+* emulated route shape (`/bot<token>/<method>` or `/file/bot<token>/<file_path>`, the strict token
+* on the raw segment, an emulated method, and no other path text) under that route's HTTP method
+* is recognised; the token is extracted from that exact segment, never searched for elsewhere.
+* Every other request is `unrecognised`: the wrapper ledgers and answers it with constant text
+* only, so nothing it carries can leak.
+*/
+const resolveTelegramRequest = (request, url) => {
+	const method = request.method.toUpperCase();
+	const fileMatch = filePathPattern.exec(url.pathname);
+	const botMatch = fileMatch === null ? botPathPattern.exec(url.pathname) : null;
+	const token = fileMatch?.[1] ?? botMatch?.[1];
+	const template = fileMatch !== null ? "/file/bot{token}/{filePath}" : botMatch === null ? void 0 : `/bot{token}/${botMatch[2] ?? ""}`;
+	const matched = telegramApiRoutes.find((candidate) => candidate.route.method === method && candidate.route.path === template);
+	const filePath = fileMatch?.[2];
+	if (matched === void 0 || token === void 0 || filePath !== void 0 && !isPlainFilePath(filePath)) return {
+		kind: "unrecognised",
+		reason: unrecognisedReason
+	};
+	const secrets = [token, token.slice(token.indexOf(":") + 1)];
+	const ledgerPath = filePath === void 0 ? `/bot<redacted>/${botMatch?.[2] ?? ""}` : `/file/bot<redacted>/${filePath}`;
+	const refuse = (reason) => ({
+		kind: "refused",
+		ledgerPath,
+		reason,
+		route: matched.route,
+		secrets
+	});
+	const keys = [...url.searchParams.keys()];
+	if (keys.some((key) => !matched.queryKeys.includes(key))) return refuse("a query parameter this method does not take is not emulated");
+	const missing = matched.queryKeys.find((key) => !keys.includes(key));
+	if (missing !== void 0) return refuse(`requests without the query parameter ${missing} are not emulated`);
+	if (keys.length !== matched.queryKeys.length) return refuse("repeated query parameters are not emulated");
+	const bot = /^0+:/.test(token) ? "none" : "known";
+	return {
+		kind: "route",
+		ledgerPath,
+		route: matched.route,
+		params: filePath === void 0 ? { [botParam]: bot } : {
+			[botParam]: bot,
+			filePath
+		},
+		guardedPath: filePath === void 0 ? `${matched.guardedPath}${url.search}` : `${matched.guardedPath}/${encodeURIComponent(filePath)}`,
+		secrets
+	};
+};
+//#endregion
+export { resolveTelegramRequest, telegramApiRoutes };
+
+//# sourceMappingURL=api.mjs.map

package/dist/telegram/api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.mjs","names":[],"sources":["../../src/telegram/api.ts"],"sourcesContent":["/**\n * Telegram Bot API emulator API: the route table (evidence, query allowlist, guarded path,\n * handler) and the token-aware route resolution (internal; re-exported by `src/telegram.ts`, which\n * runs the table on the shared stateful wrapper, `src/stateful-emulator.ts`, in its resolved\n * mode).\n *\n * The bot token is part of every Bot API URL (`/bot<token>/<method>`, `/file/bot<token>/<path>`).\n * It is required, but it never reaches the core, the state, the ledger, a not-emulated message, or\n * a response. Resolution fails closed: only a request whose raw path is exactly an emulated route\n * shape is recognised, and its token is taken from that exact segment; every other request is\n * ledgered and answered with constant text only. For a recognised request the ledgered path reads\n * `/bot<redacted>/...`, the routes learn only whether the token names a bot, and the wrapper\n * scrubs the token and its secret part from the ledger and refuses a path, query, or body that\n * repeats them (raw, percent-decoded, or in any parsed JSON key, string value, or number).\n *\n * Only the routes the four Telegram conformance cases need are emulated, with wire shapes copied\n * from the synthetic fixtures; everything else answers the wrapper's ledgered 400 not-emulated.\n *\n * @experimental\n */\nimport { Predicate } from 'effect'\nimport type * as Schema from 'effect/Schema'\nimport {\n  isNotEmulated,\n  notEmulated,\n  statefulRoute,\n  type Commit,\n  type EmulatedRequest,\n  type NotEmulated,\n  type StatefulResolution,\n  type StatefulRoute\n} from '../stateful-emulator.ts'\nimport type { TelegramEmulatorChat, TelegramEmulatorState } from './state.ts'\n\n/** Drill knobs (tests only): each makes the emulator disagree with one conformance claim. */\nexport type TelegramEmulatorDrills = {\n  /** `true`: `getChat` of a member chat answers 200 with `ok: false`. */\n  readonly getChatOkFalse?: boolean\n  /** `true`: the `getChat` errors (absent chat, token naming no bot) answer 200, not 4xx. */\n  readonly errorsAs200?: boolean\n  /** `true`: `getFile` reports a `file_size` one byte larger than the file. */\n  readonly fileSizeOffByOne?: boolean\n  /** `true`: `sendMessage` answers 200 with `ok: false` (the message is still recorded as sent). */\n  readonly sendOkFalse?: boolean\n}\n\nexport type TelegramApiEnv = {\n  /** Clock in epoch milliseconds (`date` of sent messages). */\n  readonly now: () => number\n  readonly drills: Required<TelegramEmulatorDrills>\n}\n\n/**\n * The route parameter the resolution supplies instead of the token: whether the token names a bot\n * (`known`) or not (`none`). The token itself never reaches a route.\n */\nconst botParam = 'bot'\n\ntype RouteRequest = {\n  readonly query: URLSearchParams\n  /** Decoded file path of the file route. */\n  readonly filePath: string | undefined\n  readonly body: Schema.Json | undefined\n  readonly hasBody: boolean\n  readonly contentType: string | null\n  /** The token names a bot (its bot id is not 0). */\n  readonly knownBot: boolean\n}\n\n/** A route handler (the wrapper's plan): validate without writing, then return the commit. */\ntype RouteHandler = (\n  state: TelegramEmulatorState,\n  request: RouteRequest,\n  env: TelegramApiEnv\n) => Commit | NotEmulated\n\ntype TelegramApiRoute = {\n  readonly route: StatefulRoute<TelegramEmulatorState, TelegramApiEnv>\n  readonly queryKeys: ReadonlyArray<string>\n  /** The token-free path the request must not repeat the token in (the method, or `/file`). */\n  readonly guardedPath: string\n}\n\nconst validateCase = 'telegram.validate.get-chat'\n\nconst errorCase = 'telegram.errors.error-envelope'\n\nconst fileCase = 'telegram.files.get-file-path'\n\nconst sendCase = 'telegram.messages.send-message'\n\n/** Bot API JSON answers, as the fixtures record them. */\nconst json = (status: number, body: unknown): Response =>\n  new Response(JSON.stringify(body), {\n    status,\n    headers: { 'content-type': 'application/json' }\n  })\n\n/** A chat id: an integer (negative for groups and channels) or a public `@username`. */\nconst chatIdPattern = /^(?:-?[1-9][0-9]{0,19}|@[A-Za-z][A-Za-z0-9_]{3,31})$/\n\nconst isJsonObject = (value: Schema.Json | undefined): value is Schema.JsonObject =>\n  value !== undefined && value !== null && Predicate.isObject(value) && !Array.isArray(value)\n\nconst mediaType = (contentType: string | null): string | undefined =>\n  contentType?.split(';', 1)[0]?.trim().toLowerCase()\n\n/**\n * A JSON body with exactly the `keys` the fixture records, or a refusal. Refusals never name a\n * request key or value (constant text).\n */\nconst bodyObject = (\n  request: RouteRequest,\n  keys: ReadonlyArray<string>\n): Schema.JsonObject | NotEmulated => {\n  if (mediaType(request.contentType) !== 'application/json') {\n    return notEmulated('Bot API bodies other than application/json are not emulated')\n  }\n\n  if (!isJsonObject(request.body)) {\n    return notEmulated('a request body that is not a JSON object is not emulated')\n  }\n\n  const sent = Object.keys(request.body)\n\n  if (sent.some(key => !keys.includes(key))) {\n    return notEmulated('a body field this method does not take is not emulated')\n  }\n\n  return keys.every(key => sent.includes(key))\n    ? request.body\n    : notEmulated(\n        `requests without each of the recorded body fields (${keys.join(', ')}) are not emulated`\n      )\n}\n\nconst noBody = (request: RouteRequest): NotEmulated | undefined =>\n  request.hasBody ? notEmulated('a request body is not emulated on this method') : undefined\n\n/** The chat a well-formed `chat_id` names, `null` for none, or a refusal. */\nconst chatOf = (\n  state: TelegramEmulatorState,\n  chatId: Schema.Json | undefined\n): TelegramEmulatorChat | null | NotEmulated => {\n  if (!Predicate.isString(chatId) || !chatIdPattern.test(chatId)) {\n    return notEmulated('chat_id must be a chat id string (an integer or a public @username)')\n  }\n\n  return state.chats.find(chat => String(chat.id) === chatId) ?? null\n}\n\n/** The Bot API error envelope of the error fixture. */\nconst botApiError = (env: TelegramApiEnv, status: number, description: string): Response =>\n  json(env.drills.errorsAs200 ? 200 : status, { ok: false, error_code: status, description })\n\nconst knownBotOnly = (request: RouteRequest): NotEmulated | undefined =>\n  request.knownBot\n    ? undefined\n    : notEmulated('a bot token that names no bot is emulated only on getChat (as recorded)')\n\n// Handlers: validate (not emulated) first, then return the commit that writes.\n\nconst getChat: RouteHandler = (state, request, env) => {\n  const body = bodyObject(request, ['chat_id'])\n\n  if (isNotEmulated(body)) return body\n\n  const chat = chatOf(state, body.chat_id)\n\n  if (isNotEmulated(chat)) return chat\n\n  if (!request.knownBot) return () => botApiError(env, 401, 'Unauthorized')\n\n  if (chat === null) return () => botApiError(env, 400, 'Bad Request: chat not found')\n\n  return () =>\n    json(200, {\n      ok: !env.drills.getChatOkFalse,\n      result: {\n        id: chat.id,\n        title: chat.title,\n        type: chat.type,\n        permissions: { can_send_messages: chat.permissions.can_send_messages },\n        accent_color_id: chat.accent_color_id,\n        max_reaction_count: chat.max_reaction_count\n      }\n    })\n}\n\nconst getFile: RouteHandler = (state, request, env) => {\n  const refused = noBody(request) ?? knownBotOnly(request)\n\n  if (refused !== undefined) return refused\n\n  const fileId = request.query.get('file_id')\n  const file = state.files.find(item => item.file_id === fileId)\n\n  if (file === undefined) {\n    return notEmulated('getFile of a file id the bot did not receive is not emulated')\n  }\n\n  return () =>\n    json(200, {\n      ok: true,\n      result: {\n        file_id: file.file_id,\n        file_unique_id: file.file_unique_id,\n        file_size: file.file_size + (env.drills.fileSizeOffByOne ? 1 : 0),\n        file_path: file.file_path\n      }\n    })\n}\n\nconst downloadFile: RouteHandler = (state, request) => {\n  const refused = noBody(request) ?? knownBotOnly(request)\n\n  if (refused !== undefined) return refused\n\n  const file = state.files.find(item => item.file_path === request.filePath)\n\n  if (file === undefined) return notEmulated('a file path getFile did not answer is not emulated')\n\n  return () =>\n    new Response(new TextEncoder().encode(file.content), {\n      status: 200,\n      headers: { 'content-type': 'application/octet-stream' }\n    })\n}\n\nconst sendMessage: RouteHandler = (state, request, env) => {\n  const refused = knownBotOnly(request)\n\n  if (refused !== undefined) return refused\n\n  const body = bodyObject(request, ['chat_id', 'text', 'disable_web_page_preview'])\n\n  if (isNotEmulated(body)) return body\n\n  const chat = chatOf(state, body.chat_id)\n\n  if (isNotEmulated(chat)) return chat\n\n  if (chat === null) {\n    return notEmulated('sendMessage to a chat the bot is not a member of is not emulated')\n  }\n\n  const { text, disable_web_page_preview: disablePreview } = body\n\n  if (!Predicate.isString(text) || text === '') {\n    return notEmulated('text must be a non-empty string')\n  }\n\n  if (disablePreview !== true) {\n    return notEmulated('disable_web_page_preview other than true (as recorded) is not emulated')\n  }\n\n  return () => {\n    // Read the clock before anything is written: a failing clock sends nothing.\n    const now = env.now()\n\n    if (!Number.isFinite(now)) throw new Error('the emulator clock is not a finite instant')\n\n    const date = Math.floor(now / 1000)\n    const messageId = state.counters.nextMessageId\n\n    state.counters = { ...state.counters, nextMessageId: messageId + 1 }\n    state.sentMessages = [\n      ...state.sentMessages,\n      { message_id: messageId, chat_id: chat.id, text, date, disable_web_page_preview: true }\n    ]\n\n    return json(200, {\n      ok: !env.drills.sendOkFalse,\n      result: {\n        message_id: messageId,\n        from: {\n          id: state.bot.id,\n          is_bot: true,\n          first_name: state.bot.first_name,\n          username: state.bot.username\n        },\n        chat: { id: chat.id, title: chat.title, type: chat.type },\n        date,\n        text\n      }\n    })\n  }\n}\n\n/** The route's request, as the handlers see it (the wrapper checked and parsed the body). */\nconst routeRequest = (request: EmulatedRequest): RouteRequest => ({\n  query: request.query,\n  filePath: request.params.filePath,\n  body: request.json,\n  // A non-empty body is valid JSON by now (`json-or-empty`), so it always parses.\n  hasBody: request.json !== undefined,\n  contentType: request.header('content-type') ?? null,\n  knownBot: request.params[botParam] === 'known'\n})\n\nconst route = (\n  method: string,\n  path: string,\n  guardedPath: string,\n  write: boolean,\n  caseIds: ReadonlyArray<string>,\n  handler: RouteHandler,\n  queryKeys: ReadonlyArray<string> = []\n): TelegramApiRoute => ({\n  route: statefulRoute(\n    { method, path, kind: 'connector', write, caseIds, evidence: 'unverified' },\n    'json-or-empty',\n    routeRequest,\n    (state, request, context) => handler(state, request, context.env)\n  ),\n  queryKeys,\n  guardedPath\n})\n\n/** The route table: evidence plus handler. `telegramEmulatorRoutes` is its evidence part. */\nexport const telegramApiRoutes: ReadonlyArray<TelegramApiRoute> = [\n  route('POST', '/bot{token}/getChat', '/getChat', false, [validateCase, errorCase], getChat),\n  route('GET', '/bot{token}/getFile', '/getFile', false, [fileCase], getFile, ['file_id']),\n  route('GET', '/file/bot{token}/{filePath}', '/file', false, [fileCase], downloadFile),\n  route('POST', '/bot{token}/sendMessage', '/sendMessage', true, [sendCase], sendMessage)\n]\n\n/**\n * A Bot API token as the connector sends it: `<bot id>:<secret>`, with a secret of at least 8\n * characters, so the secret part of every accepted token is long enough to be guarded on its own.\n * Matched on the RAW path segment: a percent-encoded character makes the request unrecognised.\n */\nconst tokenSource = '[0-9]+:[A-Za-z0-9_-]{8,}'\n\n/** `/bot<token>/<method>`, exactly: one of the emulated Bot API methods, no other path text. */\nconst botPathPattern = new RegExp(`^/bot(${tokenSource})/(getChat|getFile|sendMessage)$`)\n\n/**\n * `/file/bot<token>/<file_path>`, exactly: a relative file path of letters, digits, and `_ . -`\n * segments (no percent-encoding, no empty or dot segments), the shape the download helper sends.\n */\nconst filePathPattern = new RegExp(\n  `^/file/bot(${tokenSource})/((?:[A-Za-z0-9_.-]+/)*[A-Za-z0-9_.-]+)$`\n)\n\nconst isPlainFilePath = (path: string): boolean =>\n  path.split('/').every(part => part !== '.' && part !== '..')\n\n/** The constant reason of every unrecognised request (no method, path, or query is quoted). */\nconst unrecognisedReason = 'no emulated Bot API route for this method and path'\n\n/**\n * Resolve one Bot API request, failing closed. Only a request whose raw path is exactly an\n * emulated route shape (`/bot<token>/<method>` or `/file/bot<token>/<file_path>`, the strict token\n * on the raw segment, an emulated method, and no other path text) under that route's HTTP method\n * is recognised; the token is extracted from that exact segment, never searched for elsewhere.\n * Every other request is `unrecognised`: the wrapper ledgers and answers it with constant text\n * only, so nothing it carries can leak.\n */\nexport const resolveTelegramRequest = (\n  request: Request,\n  url: URL\n): StatefulResolution<TelegramEmulatorState, TelegramApiEnv> => {\n  const method = request.method.toUpperCase()\n  const fileMatch = filePathPattern.exec(url.pathname)\n  const botMatch = fileMatch === null ? botPathPattern.exec(url.pathname) : null\n  const token = fileMatch?.[1] ?? botMatch?.[1]\n\n  const template =\n    fileMatch !== null\n      ? '/file/bot{token}/{filePath}'\n      : botMatch === null\n        ? undefined\n        : `/bot{token}/${botMatch[2] ?? ''}`\n\n  const matched = telegramApiRoutes.find(\n    candidate => candidate.route.method === method && candidate.route.path === template\n  )\n\n  const filePath = fileMatch?.[2]\n\n  if (\n    matched === undefined ||\n    token === undefined ||\n    (filePath !== undefined && !isPlainFilePath(filePath))\n  ) {\n    return { kind: 'unrecognised', reason: unrecognisedReason }\n  }\n\n  // The guarded values: the token and its secret part (plain text: the segment is unencoded).\n  const secrets = [token, token.slice(token.indexOf(':') + 1)]\n\n  const ledgerPath =\n    filePath === undefined\n      ? `/bot<redacted>/${botMatch?.[2] ?? ''}`\n      : `/file/bot<redacted>/${filePath}`\n\n  const refuse = (reason: string): StatefulResolution<TelegramEmulatorState, TelegramApiEnv> => ({\n    kind: 'refused',\n    ledgerPath,\n    reason,\n    route: matched.route,\n    secrets\n  })\n\n  const keys = [...url.searchParams.keys()]\n\n  // Constant text: a query key may carry anything, the token included.\n  if (keys.some(key => !matched.queryKeys.includes(key))) {\n    return refuse('a query parameter this method does not take is not emulated')\n  }\n\n  const missing = matched.queryKeys.find(key => !keys.includes(key))\n\n  if (missing !== undefined) {\n    return refuse(`requests without the query parameter ${missing} are not emulated`)\n  }\n\n  if (keys.length !== matched.queryKeys.length) {\n    return refuse('repeated query parameters are not emulated')\n  }\n\n  // Routes see whether the token names a bot and the file path, never the token.\n  const bot = /^0+:/.test(token) ? 'none' : 'known'\n\n  return {\n    kind: 'route',\n    ledgerPath,\n    route: matched.route,\n    params: filePath === undefined ? { [botParam]: bot } : { [botParam]: bot, filePath },\n    guardedPath:\n      filePath === undefined\n        ? `${matched.guardedPath}${url.search}`\n        : `${matched.guardedPath}/${encodeURIComponent(filePath)}`,\n    secrets\n  }\n}\n"],"mappings":"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"}

package/dist/telegram/state.d.mts

@@ -0,0 +1,128 @@
+import * as Schema from "effect/Schema";
+
+//#region src/telegram/state.d.ts
+/** The bot every token with a non-zero bot id answers as (`from` of sent messages). */
+declare const TelegramEmulatorBot: Schema.Struct<{
+  readonly id: Schema.Int;
+  readonly first_name: Schema.String;
+  readonly username: Schema.String;
+}>;
+type TelegramEmulatorBot = typeof TelegramEmulatorBot.Type;
+/** A chat the bot is a member of, in the `getChat` fixture's wire shape. */
+declare const TelegramEmulatorChat: Schema.Struct<{
+  readonly id: Schema.Int;
+  readonly title: Schema.String;
+  readonly type: Schema.String;
+  readonly permissions: Schema.Struct<{
+    readonly can_send_messages: Schema.Boolean;
+  }>;
+  readonly accent_color_id: Schema.Int;
+  readonly max_reaction_count: Schema.Int;
+}>;
+type TelegramEmulatorChat = typeof TelegramEmulatorChat.Type;
+/** A file the bot received: its `getFile` answer and its UTF-8 text content. */
+declare const TelegramEmulatorFile: Schema.Struct<{
+  readonly file_id: Schema.String;
+  readonly file_unique_id: Schema.String;
+  readonly file_size: Schema.Int;
+  readonly file_path: Schema.String; /** UTF-8 text; `file_size` must equal its byte length. */
+  readonly content: Schema.String;
+}>;
+type TelegramEmulatorFile = typeof TelegramEmulatorFile.Type;
+/** A message the bot sent (irreversible: kept until reset or seed). */
+declare const TelegramEmulatorSentMessage: Schema.Struct<{
+  readonly message_id: Schema.Int;
+  readonly chat_id: Schema.Int;
+  readonly text: Schema.String;
+  readonly date: Schema.Int;
+  readonly disable_web_page_preview: Schema.Boolean;
+}>;
+type TelegramEmulatorSentMessage = typeof TelegramEmulatorSentMessage.Type;
+declare const Counters: Schema.Struct<{
+  /** Next `message_id` of a sent message. */readonly nextMessageId: Schema.Int;
+}>;
+/** The whole emulator state (JSON-compatible; what `snapshot()` returns). */
+declare const TelegramEmulatorStateSchema: Schema.Struct<{
+  readonly bot: Schema.Struct<{
+    readonly id: Schema.Int;
+    readonly first_name: Schema.String;
+    readonly username: Schema.String;
+  }>;
+  readonly chats: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Int;
+    readonly title: Schema.String;
+    readonly type: Schema.String;
+    readonly permissions: Schema.Struct<{
+      readonly can_send_messages: Schema.Boolean;
+    }>;
+    readonly accent_color_id: Schema.Int;
+    readonly max_reaction_count: Schema.Int;
+  }>>;
+  readonly files: Schema.$Array<Schema.Struct<{
+    readonly file_id: Schema.String;
+    readonly file_unique_id: Schema.String;
+    readonly file_size: Schema.Int;
+    readonly file_path: Schema.String; /** UTF-8 text; `file_size` must equal its byte length. */
+    readonly content: Schema.String;
+  }>>;
+  readonly sentMessages: Schema.$Array<Schema.Struct<{
+    readonly message_id: Schema.Int;
+    readonly chat_id: Schema.Int;
+    readonly text: Schema.String;
+    readonly date: Schema.Int;
+    readonly disable_web_page_preview: Schema.Boolean;
+  }>>;
+  readonly counters: Schema.Struct<{
+    /** Next `message_id` of a sent message. */readonly nextMessageId: Schema.Int;
+  }>;
+}>;
+/** The emulator state. The container is mutable; entities are replaced, never edited in place. */
+type TelegramEmulatorState = {
+  bot: TelegramEmulatorBot;
+  chats: ReadonlyArray<TelegramEmulatorChat>;
+  files: ReadonlyArray<TelegramEmulatorFile>;
+  sentMessages: ReadonlyArray<TelegramEmulatorSentMessage>;
+  counters: typeof Counters.Type;
+};
+/** Account-variance profiles for the default seed. */
+declare const TelegramEmulatorProfile: Schema.Literals<readonly ["default", "empty"]>;
+type TelegramEmulatorProfile = typeof TelegramEmulatorProfile.Type;
+/**
+ * A typed seed. Start from `profile` (default `'default'`, the fixture entities; `'empty'` keeps
+ * only the bot); every other key, when given, replaces that part of the profile.
+ * `nextMessageId` defaults to 101 (the send fixture's `message_id`).
+ */
+declare const TelegramEmulatorSeed: Schema.Struct<{
+  readonly profile: Schema.optionalKey<Schema.Literals<readonly ["default", "empty"]>>;
+  readonly bot: Schema.optionalKey<Schema.Struct<{
+    readonly id: Schema.Int;
+    readonly first_name: Schema.String;
+    readonly username: Schema.String;
+  }>>;
+  readonly chats: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Int;
+    readonly title: Schema.String;
+    readonly type: Schema.String;
+    readonly permissions: Schema.Struct<{
+      readonly can_send_messages: Schema.Boolean;
+    }>;
+    readonly accent_color_id: Schema.Int;
+    readonly max_reaction_count: Schema.Int;
+  }>>>;
+  readonly files: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+    readonly file_id: Schema.String;
+    readonly file_unique_id: Schema.String;
+    readonly file_size: Schema.Int;
+    readonly file_path: Schema.String; /** UTF-8 text; `file_size` must equal its byte length. */
+    readonly content: Schema.String;
+  }>>>;
+  readonly nextMessageId: Schema.optionalKey<Schema.Int>;
+}>;
+type TelegramEmulatorSeed = typeof TelegramEmulatorSeed.Type;
+/** Decode and build a seed; a string is the reason it is invalid. */
+declare const buildTelegramSeedState: (input: unknown) => TelegramEmulatorState | string;
+/** Decode a full state (a restored snapshot); a string is the reason it is invalid. */
+declare const decodeTelegramState: (input: unknown) => TelegramEmulatorState | string;
+//#endregion
+export { TelegramEmulatorBot, TelegramEmulatorChat, TelegramEmulatorFile, TelegramEmulatorProfile, TelegramEmulatorSeed, TelegramEmulatorSentMessage, TelegramEmulatorState, TelegramEmulatorStateSchema, buildTelegramSeedState, decodeTelegramState };
+//# sourceMappingURL=state.d.mts.map

package/dist/telegram/state.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.mts","names":[],"sources":["../../src/telegram/state.ts"],"mappings":";;;;cAea,mBAAA,EAAmB,MAAA,CAAA,MAAA;EAAA;;;;KAMpB,mBAAA,UAA6B,mBAAA,CAAoB,IAAI;;cAGpD,oBAAA,EAAoB,MAAA,CAAA,MAAA;EAAA;;;;;;;;;KASrB,oBAAA,UAA8B,oBAAA,CAAqB,IAAI;;cAgBtD,oBAAA,EAAoB,MAAA,CAAA,MAAA;EAAA;;;qCA5BF;EAAA;;KAqCnB,oBAAA,UAA8B,oBAAA,CAAqB,IAAI;AAlCnE;AAAA,cAqCa,2BAAA,EAA2B,MAAA,CAAA,MAAA;EAAA;;;;;;KAQ5B,2BAAA,UAAqC,2BAAA,CAA4B,IAAI;AAAA,cAE3E,QAAA,EAAQ,MAAA,CAAA,MAAA;EA/CmB,mEAkD/B,MAAA,CAAA,GAAA;AAAA;;cAGW,2BAAA,EAA2B,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAS5B,qBAAA;EACV,GAAA,EAAK,mBAAA;EACL,KAAA,EAAO,aAAA,CAAc,oBAAA;EACrB,KAAA,EAAO,aAAA,CAAc,oBAAA;EACrB,YAAA,EAAc,aAAA,CAAc,2BAAA;EAC5B,QAAA,SAAiB,QAAA,CAAS,IAAA;AAAA;;cAIf,uBAAA,EAAuB,MAAA,CAAA,QAAA;AAAA,KAExB,uBAAA,UAAiC,uBAAA,CAAwB,IAAI;;;;;;cAO5D,oBAAA,EAAoB,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;uCA3CO;IAAA;;;;KAmD5B,oBAAA,UAA8B,oBAAA,CAAqB,IAAI;;cAuGtD,sBAAA,GAA0B,KAAA,cAAiB,qBAAqB;;cAShE,mBAAA,GAAuB,KAAA,cAAiB,qBAAqB"}

package/dist/telegram/state.mjs

@@ -0,0 +1,154 @@
+import { Result } from "effect";
+import * as Schema from "effect/Schema";
+//#region src/telegram/state.ts
+/**
+* Telegram Bot API emulator state: the typed entities, the seed input, the default seed, and the
+* profiles (internal; re-exported by `src/telegram.ts`).
+*
+* Entity shapes and the default entities are copied as data from the synthetic Telegram
+* conformance fixtures (the same chat and file ids as `telegramConformanceFixtureSeeds`, the bot
+* the send fixture answers as `from`, and the 32-byte synthetic file), never imported from SDK
+* code. The state holds no bot token: tokens are never stored.
+*
+* @experimental
+*/
+/** The bot every token with a non-zero bot id answers as (`from` of sent messages). */
+const TelegramEmulatorBot = Schema.Struct({
+	id: Schema.Int,
+	first_name: Schema.String,
+	username: Schema.String
+});
+/** A chat the bot is a member of, in the `getChat` fixture's wire shape. */
+const TelegramEmulatorChat = Schema.Struct({
+	id: Schema.Int,
+	title: Schema.String,
+	type: Schema.String,
+	permissions: Schema.Struct({ can_send_messages: Schema.Boolean }),
+	accent_color_id: Schema.Int,
+	max_reaction_count: Schema.Int
+});
+const FileId = Schema.String.check(Schema.isPattern(/^[A-Za-z0-9_-]{1,256}$/));
+/** A relative file path the download helper accepts (no empty or dot segments). */
+const FilePath = Schema.String.check(Schema.makeFilter((path) => /^[A-Za-z0-9_./-]+$/.test(path) && !path.startsWith("/") && path.split("/").every((part) => part !== "" && part !== "." && part !== "..") ? void 0 : "a relative path of letters, digits, and _ . / - without empty or dot segments"));
+/** A file the bot received: its `getFile` answer and its UTF-8 text content. */
+const TelegramEmulatorFile = Schema.Struct({
+	file_id: FileId,
+	file_unique_id: FileId,
+	file_size: Schema.Int,
+	file_path: FilePath,
+	/** UTF-8 text; `file_size` must equal its byte length. */
+	content: Schema.String
+});
+/** A message the bot sent (irreversible: kept until reset or seed). */
+const TelegramEmulatorSentMessage = Schema.Struct({
+	message_id: Schema.Int,
+	chat_id: Schema.Int,
+	text: Schema.String,
+	date: Schema.Int,
+	disable_web_page_preview: Schema.Boolean
+});
+const Counters = Schema.Struct({ 
+/** Next `message_id` of a sent message. */
+nextMessageId: Schema.Int.check(Schema.isGreaterThanOrEqualTo(1)) });
+/** The whole emulator state (JSON-compatible; what `snapshot()` returns). */
+const TelegramEmulatorStateSchema = Schema.Struct({
+	bot: TelegramEmulatorBot,
+	chats: Schema.Array(TelegramEmulatorChat),
+	files: Schema.Array(TelegramEmulatorFile),
+	sentMessages: Schema.Array(TelegramEmulatorSentMessage),
+	counters: Counters
+});
+/** Account-variance profiles for the default seed. */
+const TelegramEmulatorProfile = Schema.Literals(["default", "empty"]);
+/**
+* A typed seed. Start from `profile` (default `'default'`, the fixture entities; `'empty'` keeps
+* only the bot); every other key, when given, replaces that part of the profile.
+* `nextMessageId` defaults to 101 (the send fixture's `message_id`).
+*/
+const TelegramEmulatorSeed = Schema.Struct({
+	profile: Schema.optionalKey(TelegramEmulatorProfile),
+	bot: Schema.optionalKey(TelegramEmulatorBot),
+	chats: Schema.optionalKey(Schema.Array(TelegramEmulatorChat)),
+	files: Schema.optionalKey(Schema.Array(TelegramEmulatorFile)),
+	nextMessageId: Schema.optionalKey(Schema.Int.check(Schema.isGreaterThanOrEqualTo(1)))
+});
+const strict = { onExcessProperty: "error" };
+const decodeSeedInput = Schema.decodeUnknownResult(TelegramEmulatorSeed, strict);
+const decodeStateInput = Schema.decodeUnknownResult(TelegramEmulatorStateSchema, strict);
+const issueMessage = (issue) => new Schema.SchemaError(issue).message;
+const defaultBot = {
+	id: 123456789,
+	first_name: "Synthetic Practice Bot",
+	username: "yolk_synthetic_bot"
+};
+const defaultChats = [{
+	id: -0xe9103fda01,
+	title: "Synthetic practice group",
+	type: "supergroup",
+	permissions: { can_send_messages: true },
+	accent_color_id: 0,
+	max_reaction_count: 11
+}];
+const defaultFiles = [{
+	file_id: "BQACAgIAAxkDAAIC-yolk_synthetic_file_0001",
+	file_unique_id: "AgADyolkSynthetic01",
+	file_size: 32,
+	file_path: "documents/file_0.txt",
+	content: "yolk-conformance synthetic file\n"
+}];
+const profileEntities = (profile) => {
+	switch (profile) {
+		case "default": return {
+			bot: defaultBot,
+			chats: defaultChats,
+			files: defaultFiles
+		};
+		case "empty": return {
+			bot: defaultBot,
+			chats: [],
+			files: []
+		};
+	}
+};
+const duplicate = (values) => values.find((value, index) => values.indexOf(value) !== index);
+const utf8Length = (text) => new TextEncoder().encode(text).byteLength;
+const seedProblem = (entities) => {
+	if (entities.bot.id <= 0) return "the bot id must be positive";
+	const chat = duplicate(entities.chats.map((item) => item.id));
+	if (chat !== void 0) return `duplicate chat id ${chat}`;
+	const fileId = duplicate(entities.files.map((item) => item.file_id));
+	if (fileId !== void 0) return `duplicate file id ${fileId}`;
+	const filePath = duplicate(entities.files.map((item) => item.file_path));
+	if (filePath !== void 0) return `duplicate file path ${filePath}`;
+	const sized = entities.files.find((item) => item.file_size !== utf8Length(item.content));
+	return sized === void 0 ? void 0 : `file ${sized.file_id} has a file_size other than its content's byte length`;
+};
+const stateFromSeed = (seed) => {
+	const profile = profileEntities(seed.profile ?? "default");
+	const entities = {
+		bot: seed.bot ?? profile.bot,
+		chats: seed.chats ?? profile.chats,
+		files: seed.files ?? profile.files
+	};
+	const problem = seedProblem(entities);
+	if (problem !== void 0) return problem;
+	return {
+		...entities,
+		sentMessages: [],
+		counters: { nextMessageId: seed.nextMessageId ?? 101 }
+	};
+};
+/** Decode and build a seed; a string is the reason it is invalid. */
+const buildTelegramSeedState = (input) => {
+	const decoded = decodeSeedInput(input);
+	return Result.isFailure(decoded) ? issueMessage(decoded.failure.issue) : stateFromSeed(decoded.success);
+};
+/** Decode a full state (a restored snapshot); a string is the reason it is invalid. */
+const decodeTelegramState = (input) => {
+	const decoded = decodeStateInput(input);
+	return Result.isFailure(decoded) ? issueMessage(decoded.failure.issue) : { ...decoded.success };
+};
+//#endregion
+export { TelegramEmulatorBot, TelegramEmulatorChat, TelegramEmulatorFile, TelegramEmulatorProfile, TelegramEmulatorSeed, TelegramEmulatorSentMessage, TelegramEmulatorStateSchema, buildTelegramSeedState, decodeTelegramState };
+
+//# sourceMappingURL=state.mjs.map

package/dist/telegram/state.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.mjs","names":[],"sources":["../../src/telegram/state.ts"],"sourcesContent":["/**\n * Telegram Bot API emulator state: the typed entities, the seed input, the default seed, and the\n * profiles (internal; re-exported by `src/telegram.ts`).\n *\n * Entity shapes and the default entities are copied as data from the synthetic Telegram\n * conformance fixtures (the same chat and file ids as `telegramConformanceFixtureSeeds`, the bot\n * the send fixture answers as `from`, and the 32-byte synthetic file), never imported from SDK\n * code. The state holds no bot token: tokens are never stored.\n *\n * @experimental\n */\nimport { Result } from 'effect'\nimport * as Schema from 'effect/Schema'\n\n/** The bot every token with a non-zero bot id answers as (`from` of sent messages). */\nexport const TelegramEmulatorBot = Schema.Struct({\n  id: Schema.Int,\n  first_name: Schema.String,\n  username: Schema.String\n})\n\nexport type TelegramEmulatorBot = typeof TelegramEmulatorBot.Type\n\n/** A chat the bot is a member of, in the `getChat` fixture's wire shape. */\nexport const TelegramEmulatorChat = Schema.Struct({\n  id: Schema.Int,\n  title: Schema.String,\n  type: Schema.String,\n  permissions: Schema.Struct({ can_send_messages: Schema.Boolean }),\n  accent_color_id: Schema.Int,\n  max_reaction_count: Schema.Int\n})\n\nexport type TelegramEmulatorChat = typeof TelegramEmulatorChat.Type\n\nconst FileId = Schema.String.check(Schema.isPattern(/^[A-Za-z0-9_-]{1,256}$/))\n\n/** A relative file path the download helper accepts (no empty or dot segments). */\nconst FilePath = Schema.String.check(\n  Schema.makeFilter(path =>\n    /^[A-Za-z0-9_./-]+$/.test(path) &&\n    !path.startsWith('/') &&\n    path.split('/').every(part => part !== '' && part !== '.' && part !== '..')\n      ? undefined\n      : 'a relative path of letters, digits, and _ . / - without empty or dot segments'\n  )\n)\n\n/** A file the bot received: its `getFile` answer and its UTF-8 text content. */\nexport const TelegramEmulatorFile = Schema.Struct({\n  file_id: FileId,\n  file_unique_id: FileId,\n  file_size: Schema.Int,\n  file_path: FilePath,\n  /** UTF-8 text; `file_size` must equal its byte length. */\n  content: Schema.String\n})\n\nexport type TelegramEmulatorFile = typeof TelegramEmulatorFile.Type\n\n/** A message the bot sent (irreversible: kept until reset or seed). */\nexport const TelegramEmulatorSentMessage = Schema.Struct({\n  message_id: Schema.Int,\n  chat_id: Schema.Int,\n  text: Schema.String,\n  date: Schema.Int,\n  disable_web_page_preview: Schema.Boolean\n})\n\nexport type TelegramEmulatorSentMessage = typeof TelegramEmulatorSentMessage.Type\n\nconst Counters = Schema.Struct({\n  /** Next `message_id` of a sent message. */\n  nextMessageId: Schema.Int.check(Schema.isGreaterThanOrEqualTo(1))\n})\n\n/** The whole emulator state (JSON-compatible; what `snapshot()` returns). */\nexport const TelegramEmulatorStateSchema = Schema.Struct({\n  bot: TelegramEmulatorBot,\n  chats: Schema.Array(TelegramEmulatorChat),\n  files: Schema.Array(TelegramEmulatorFile),\n  sentMessages: Schema.Array(TelegramEmulatorSentMessage),\n  counters: Counters\n})\n\n/** The emulator state. The container is mutable; entities are replaced, never edited in place. */\nexport type TelegramEmulatorState = {\n  bot: TelegramEmulatorBot\n  chats: ReadonlyArray<TelegramEmulatorChat>\n  files: ReadonlyArray<TelegramEmulatorFile>\n  sentMessages: ReadonlyArray<TelegramEmulatorSentMessage>\n  counters: typeof Counters.Type\n}\n\n/** Account-variance profiles for the default seed. */\nexport const TelegramEmulatorProfile = Schema.Literals(['default', 'empty'])\n\nexport type TelegramEmulatorProfile = typeof TelegramEmulatorProfile.Type\n\n/**\n * A typed seed. Start from `profile` (default `'default'`, the fixture entities; `'empty'` keeps\n * only the bot); every other key, when given, replaces that part of the profile.\n * `nextMessageId` defaults to 101 (the send fixture's `message_id`).\n */\nexport const TelegramEmulatorSeed = Schema.Struct({\n  profile: Schema.optionalKey(TelegramEmulatorProfile),\n  bot: Schema.optionalKey(TelegramEmulatorBot),\n  chats: Schema.optionalKey(Schema.Array(TelegramEmulatorChat)),\n  files: Schema.optionalKey(Schema.Array(TelegramEmulatorFile)),\n  nextMessageId: Schema.optionalKey(Schema.Int.check(Schema.isGreaterThanOrEqualTo(1)))\n})\n\nexport type TelegramEmulatorSeed = typeof TelegramEmulatorSeed.Type\n\nconst strict = { onExcessProperty: 'error' } as const\n\nconst decodeSeedInput = Schema.decodeUnknownResult(TelegramEmulatorSeed, strict)\n\nconst decodeStateInput = Schema.decodeUnknownResult(TelegramEmulatorStateSchema, strict)\n\nconst issueMessage = (issue: Schema.SchemaError['issue']): string =>\n  new Schema.SchemaError(issue).message\n\n// Default entities, copied from the fixtures.\n\nconst defaultBot: TelegramEmulatorBot = {\n  id: 123456789,\n  first_name: 'Synthetic Practice Bot',\n  username: 'yolk_synthetic_bot'\n}\n\nconst defaultChats: ReadonlyArray<TelegramEmulatorChat> = [\n  {\n    id: -1001000000001,\n    title: 'Synthetic practice group',\n    type: 'supergroup',\n    permissions: { can_send_messages: true },\n    accent_color_id: 0,\n    max_reaction_count: 11\n  }\n]\n\nconst defaultFiles: ReadonlyArray<TelegramEmulatorFile> = [\n  {\n    file_id: 'BQACAgIAAxkDAAIC-yolk_synthetic_file_0001',\n    file_unique_id: 'AgADyolkSynthetic01',\n    file_size: 32,\n    file_path: 'documents/file_0.txt',\n    content: 'yolk-conformance synthetic file\\n'\n  }\n]\n\ntype ProfileEntities = {\n  readonly bot: TelegramEmulatorBot\n  readonly chats: ReadonlyArray<TelegramEmulatorChat>\n  readonly files: ReadonlyArray<TelegramEmulatorFile>\n}\n\nconst profileEntities = (profile: TelegramEmulatorProfile): ProfileEntities => {\n  switch (profile) {\n    case 'default':\n      return { bot: defaultBot, chats: defaultChats, files: defaultFiles }\n    case 'empty':\n      return { bot: defaultBot, chats: [], files: [] }\n  }\n}\n\nconst duplicate = <A>(values: ReadonlyArray<A>): A | undefined =>\n  values.find((value, index) => values.indexOf(value) !== index)\n\nconst utf8Length = (text: string): number => new TextEncoder().encode(text).byteLength\n\nconst seedProblem = (entities: ProfileEntities): string | undefined => {\n  if (entities.bot.id <= 0) return 'the bot id must be positive'\n\n  const chat = duplicate(entities.chats.map(item => item.id))\n\n  if (chat !== undefined) return `duplicate chat id ${chat}`\n\n  const fileId = duplicate(entities.files.map(item => item.file_id))\n\n  if (fileId !== undefined) return `duplicate file id ${fileId}`\n\n  const filePath = duplicate(entities.files.map(item => item.file_path))\n\n  if (filePath !== undefined) return `duplicate file path ${filePath}`\n\n  const sized = entities.files.find(item => item.file_size !== utf8Length(item.content))\n\n  return sized === undefined\n    ? undefined\n    : `file ${sized.file_id} has a file_size other than its content's byte length`\n}\n\nconst stateFromSeed = (seed: TelegramEmulatorSeed): TelegramEmulatorState | string => {\n  const profile = profileEntities(seed.profile ?? 'default')\n\n  const entities: ProfileEntities = {\n    bot: seed.bot ?? profile.bot,\n    chats: seed.chats ?? profile.chats,\n    files: seed.files ?? profile.files\n  }\n\n  const problem = seedProblem(entities)\n\n  if (problem !== undefined) return problem\n\n  return {\n    ...entities,\n    sentMessages: [],\n    counters: { nextMessageId: seed.nextMessageId ?? 101 }\n  }\n}\n\n/** Decode and build a seed; a string is the reason it is invalid. */\nexport const buildTelegramSeedState = (input: unknown): TelegramEmulatorState | string => {\n  const decoded = decodeSeedInput(input)\n\n  return Result.isFailure(decoded)\n    ? issueMessage(decoded.failure.issue)\n    : stateFromSeed(decoded.success)\n}\n\n/** Decode a full state (a restored snapshot); a string is the reason it is invalid. */\nexport const decodeTelegramState = (input: unknown): TelegramEmulatorState | string => {\n  const decoded = decodeStateInput(input)\n\n  return Result.isFailure(decoded) ? issueMessage(decoded.failure.issue) : { ...decoded.success }\n}\n"],"mappings":"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"}