@zhin.js/adapter-qq 5.0.1 → 5.0.3

package/src/outbound-markdown.ts

@@ -1,203 +0,0 @@
-/**
- * 将 AI 出站纯文本段合并为 QQ Markdown 消息（msg_type=2）。
- * 图文混排时合并为单条 Markdown（图片语法见 QQ 官方文档）。
- */
-import { segment, type MessageElement, type MessageSegment, type SendContent } from "zhin.js";
-import { resolveMediaFile } from "./outbound-media.js";
-
-function isMessageSegment(seg: MessageElement): seg is MessageSegment {
-  return typeof seg.type === "string";
-}
-
-export type OutboundMarkdownMode = boolean | "auto";
-
-/** 常见 AI Markdown 输出特征（auto 模式） */
-const MARKDOWN_HINT =
-  /(?:\*\*|__|`|\[.+\]\(.+\)|^#{1,6}\s|^>\s|^\s*[-*+]\s|^```|\|.+\|)/m;
-
-const BLOCKING_RICH_TYPES = new Set([
-  "audio",
-  "video",
-  "file",
-  "markdown",
-  "ark",
-  "embed",
-  "keyboard",
-  "button",
-  "face",
-]);
-
-const TEXT_IMAGE_MIX_TYPES = new Set(["text", "at", "image"]);
-
-function textSegment(text: string): MessageSegment {
-  return { type: "text", data: { text } };
-}
-
-export function asOutboundSegments(content: SendContent): MessageSegment[] {
-  if (typeof content === "string") return [textSegment(content)];
-  if (!Array.isArray(content)) {
-    return isMessageSegment(content) ? [content] : [];
-  }
-  return content.flatMap((item) =>
-    typeof item === "string" ? [textSegment(item)] : isMessageSegment(item) ? [item] : [],
-  );
-}
-
-export function splitReplyPrefix(segments: MessageSegment[]): {
-  prefix: MessageSegment[];
-  body: MessageSegment[];
-} {
-  const prefix: MessageSegment[] = [];
-  let i = 0;
-  while (i < segments.length && segments[i].type === "reply") {
-    prefix.push(segments[i]);
-    i++;
-  }
-  return { prefix, body: segments.slice(i) };
-}
-
-function textFromSegment(seg: MessageSegment): string {
-  if (seg.type !== "text") return "";
-  return seg.data.text ?? seg.data.content ?? "";
-}
-
-function isRemoteUrl(value: string): boolean {
-  return /^https?:\/\//i.test(value);
-}
-
-function isInlineMedia(value: string): boolean {
-  return value.startsWith("base64://")
-    || /^data:[^/]+\/[^;]+;base64,/i.test(value)
-    || value.startsWith("file://")
-    || (value.startsWith("/") && !isRemoteUrl(value));
-}
-
-/** QQ Markdown 图片语法：![说明 #宽 #高](公网 URL) */
-export function formatQqMarkdownImage(
-  url: string,
-  data: Record<string, unknown> = {},
-): string {
-  const width = typeof data.width === "number" && data.width > 0 ? data.width : 200;
-  const height = typeof data.height === "number" && data.height > 0 ? data.height : width;
-  const label = typeof data.name === "string" && data.name.trim() ? data.name.trim() : "图片";
-  return `![${label} #${width}px #${height}px](${url})`;
-}
-
-/** 将 image 段解析为 Markdown 可嵌入的 URL（https 或 data URI） */
-export function resolveImageMarkdownUrl(data: Record<string, unknown>): string | null {
-  const url = typeof data.url === "string" ? data.url : undefined;
-  const file = resolveMediaFile(data);
-
-  if (url && isRemoteUrl(url)) return url;
-  if (file && isRemoteUrl(file)) return file;
-
-  const inline = file ?? (url && isInlineMedia(url) ? url : undefined);
-  if (!inline) return null;
-
-  if (inline.startsWith("base64://")) {
-    return `data:image/png;base64,${inline.slice(9)}`;
-  }
-  if (/^data:[^/]+\/[^;]+;base64,/i.test(inline)) {
-    return inline;
-  }
-  return null;
-}
-
-export function isTextImageMixedBody(body: MessageSegment[]): boolean {
-  if (body.length === 0) return false;
-  if (body.some((seg) => !TEXT_IMAGE_MIX_TYPES.has(seg.type))) return false;
-  const hasImage = body.some((seg) => seg.type === "image");
-  const hasText = body.some((seg) => seg.type === "text" || seg.type === "at");
-  return hasImage && hasText;
-}
-
-/** 图文混排且含 base64/本地图（无法直接嵌入 Markdown 公网 URL） */
-export function isTextImageMixedWithInlineMedia(body: MessageSegment[]): boolean {
-  if (!isTextImageMixedBody(body)) return false;
-  return body.some((seg) => {
-    if (seg.type !== "image") return false;
-    const url = typeof seg.data.url === "string" ? seg.data.url : undefined;
-    const file = resolveMediaFile(seg.data);
-    if (url && isRemoteUrl(url)) return false;
-    if (file && isRemoteUrl(file)) return false;
-    return Boolean(resolveMediaFile(seg.data) || (url && isInlineMedia(url)));
-  });
-}
-
-function segmentToMarkdownPart(seg: MessageSegment): string {
-  if (seg.type === "text") return textFromSegment(seg);
-  if (seg.type === "at") return `<@${String(seg.data.user_id ?? "")}>`;
-  if (seg.type === "image") {
-    const src = resolveImageMarkdownUrl(seg.data);
-    return src ? formatQqMarkdownImage(src, seg.data) : "";
-  }
-  return "";
-}
-
-function shouldConvertTextOnly(mode: OutboundMarkdownMode | undefined, bodyText: string): boolean {
-  if (mode === false) return false;
-  if (mode === true) return bodyText.trim().length > 0;
-  return MARKDOWN_HINT.test(bodyText);
-}
-
-function mergeTextImageToMarkdown(
-  prefix: MessageSegment[],
-  body: MessageSegment[],
-): SendContent | null {
-  if (body.some((seg) => seg.type === "image" && !resolveImageMarkdownUrl(seg.data))) {
-    return null;
-  }
-  const merged = body.map(segmentToMarkdownPart).join("");
-  if (!merged.trim()) return null;
-  return [...prefix, segment("markdown", { content: merged })];
-}
-
-/**
- * 出站归一化：保留 leading `reply`，将连续 text 或 text+image 合并为单条 markdown 段。
- * 含内联 base64 图的图文混排须走 outbound-mixed-media（msg_type=7），此处不处理。
- */
-export function normalizeOutboundMarkdown(
-  content: SendContent,
-  mode: OutboundMarkdownMode | undefined = "auto",
-): SendContent {
-  const segments = asOutboundSegments(content);
-  if (segments.length === 0) return content;
-
-  const { prefix, body } = splitReplyPrefix(segments);
-  if (body.length === 0) return content;
-  if (mode === false) return content;
-
-  if (body.some((seg) => BLOCKING_RICH_TYPES.has(seg.type))) {
-    return content;
-  }
-
-  if (body.some((seg) => seg.type === "markdown")) {
-    return content;
-  }
-
-  if (isTextImageMixedBody(body)) {
-    if (isTextImageMixedWithInlineMedia(body)) {
-      return content;
-    }
-    const mixed = mergeTextImageToMarkdown(prefix, body);
-    return mixed ?? content;
-  }
-
-  if (body.some((seg) => seg.type === "image")) {
-    return content;
-  }
-
-  if (body.some((seg) => seg.type !== "text" && seg.type !== "at")) {
-    return content;
-  }
-
-  const merged = body
-    .map((seg) => (seg.type === "at"
-      ? `<@${String(seg.data.user_id ?? "")}>`
-      : textFromSegment(seg)))
-    .join("");
-
-  if (!shouldConvertTextOnly(mode, merged)) return content;
-
-  return [...prefix, segment("markdown", { content: merged })];
-}

package/src/outbound-media.ts

@@ -1,58 +0,0 @@
-/**
- * QQ 官方出站媒体归一化。
- * qq-official-bot 的 formatMediaData 对 data.url 直接当远程 URL 上传；
- * base64:// / data:...;base64 须走 data.file 才会解析为 file_data。
- */
-import type { MessageElement, MessageSegment, SendContent } from "zhin.js";
-
-const MEDIA_TYPES = new Set(["image", "audio", "video", "file"]);
-
-function isMessageSegment(seg: MessageElement): seg is MessageSegment {
-  return typeof seg.type === "string";
-}
-
-function isRemoteUrl(value: string): boolean {
-  return /^https?:\/\//i.test(value);
-}
-
-function isInlineBase64(value: string): boolean {
-  return value.startsWith("base64://") || /^data:[^/]+\/[^;]+;base64,/i.test(value);
-}
-
-/** 解析 image/audio/video/file 段的本地或内联 payload（供 mixed-media 上传复用） */
-export function resolveMediaFile(data: Record<string, unknown>): string | undefined {
-  const url = typeof data.url === "string" ? data.url : undefined;
-  const file = typeof data.file === "string" ? data.file : undefined;
-  const base64 = typeof data.base64 === "string" ? data.base64 : undefined;
-
-  if (file && !isRemoteUrl(file)) return file;
-  if (url && isInlineBase64(url)) return url;
-  if (url && !isRemoteUrl(url) && (url.startsWith("file://") || url.startsWith("/"))) return url;
-  if (base64) return base64.startsWith("base64://") ? base64 : `base64://${base64}`;
-  return undefined;
-}
-
-function normalizeMediaSegment(seg: MessageSegment): MessageSegment {
-  if (!MEDIA_TYPES.has(seg.type)) return seg;
-
-  const data = { ...seg.data } as Record<string, unknown>;
-  const file = resolveMediaFile(data);
-  if (!file) return seg;
-
-  delete data.url;
-  delete data.base64;
-  data.file = file;
-  return { type: seg.type, data } as MessageSegment;
-}
-
-/** 将 Zhin 出站 image/base64 段转为 qq-official-bot 可识别的 file 字段 */
-export function normalizeOutboundMedia(content: SendContent): SendContent {
-  if (typeof content === "string") return content;
-  if (!Array.isArray(content)) {
-    return isMessageSegment(content) ? normalizeMediaSegment(content) : content;
-  }
-  return content.map((item) => {
-    if (typeof item === "string") return item;
-    return isMessageSegment(item) ? normalizeMediaSegment(item) : item;
-  });
-}

package/src/outbound-mixed-media.ts

@@ -1,101 +0,0 @@
-/**
- * QQ 群/私聊图文混排（msg_type=7）。
- * 内联 base64 图无法作为 Markdown 公网 URL，须先上传 file_info 再与文本同条发送。
- */
-import { randomInt } from "node:crypto";
-import type { MessageSegment, SendContent } from "zhin.js";
-import {
-  asOutboundSegments,
-  isTextImageMixedWithInlineMedia,
-  splitReplyPrefix,
-} from "./outbound-markdown.js";
-import { resolveMediaFile } from "./outbound-media.js";
-
-function textFromSegment(seg: MessageSegment): string {
-  if (seg.type !== "text") return "";
-  return seg.data.text ?? seg.data.content ?? "";
-}
-
-function isRemoteUrl(value: string): boolean {
-  return /^https?:\/\//i.test(value);
-}
-
-function extractInlineFileData(source: string): string {
-  if (source.startsWith("base64://")) return source.slice(9);
-  if (/^data:[^/]+\/[^;]+;base64,/i.test(source)) {
-    return source.replace(/^data:[^/]+\/[^;]+;base64,/i, "");
-  }
-  return source;
-}
-
-export function buildQqImageUploadPayload(
-  imageSeg: MessageSegment,
-): { file_type: 1; url?: string; file_data?: string } {
-  const data = imageSeg.data;
-  const url = typeof data.url === "string" ? data.url : undefined;
-  const file = resolveMediaFile(data);
-  const remote = [url, file].find((item) => item && isRemoteUrl(item));
-  if (remote) {
-    return { file_type: 1, url: remote };
-  }
-  const inline = file ?? url;
-  if (!inline) {
-    throw new Error("QQ 图文混排：图片段缺少 url/file/base64");
-  }
-  return { file_type: 1, file_data: extractInlineFileData(inline) };
-}
-
-export function buildTextImageMixedBodyText(body: MessageSegment[]): string {
-  return body
-    .map((seg) => {
-      if (seg.type === "text") return textFromSegment(seg);
-      if (seg.type === "at") return `<@${String(seg.data.user_id ?? "")}>`;
-      return "";
-    })
-    .join("");
-}
-
-export function firstImageSegment(body: MessageSegment[]): MessageSegment | undefined {
-  return body.find((seg) => seg.type === "image");
-}
-
-export function shouldSendTextImageMixedMedia(
-  content: SendContent,
-  mode: boolean | "auto" | undefined,
-): boolean {
-  if (mode === false) return false;
-  const { body } = splitReplyPrefix(asOutboundSegments(content));
-  return isTextImageMixedWithInlineMedia(body);
-}
-
-export interface QqMixedMediaMessagePayload {
-  msg_type: 7;
-  content: string;
-  media: { file_info: string };
-  msg_seq: number;
-  msg_id?: string;
-  event_id?: string;
-}
-
-export function buildMixedMediaMessagePayload(
-  content: SendContent,
-  fileInfo: string,
-): QqMixedMediaMessagePayload {
-  const segments = asOutboundSegments(content);
-  const { prefix, body } = splitReplyPrefix(segments);
-  const payload: QqMixedMediaMessagePayload = {
-    msg_type: 7,
-    content: buildTextImageMixedBodyText(body),
-    media: { file_info: fileInfo },
-    msg_seq: randomInt(1, 1_000_000),
-  };
-  const reply = prefix[prefix.length - 1];
-  if (reply?.type === "reply") {
-    if (typeof reply.data.event_id === "string") {
-      payload.event_id = reply.data.event_id;
-    } else if (reply.data.id != null) {
-      payload.msg_id = String(reply.data.id);
-    }
-  }
-  return payload;
-}

package/src/qq-bind-api.ts

@@ -1,145 +0,0 @@
-/**
- * QQ Bot 扫码绑定协议（内联）
- * Protocol aligned with @tencent-connect/qqbot-connector@1.1.0 qqbot-session — inlined to avoid runtime dependency.
- */
-import { createDecipheriv, randomBytes } from 'node:crypto';
-
-export type QQBotEnv = 'production' | 'test';
-
-const HOSTS: Record<QQBotEnv, string> = {
-  production: 'q.qq.com',
-  test: 'test.q.qq.com',
-};
-
-export enum BindStatus {
-  NONE = 0,
-  PENDING = 1,
-  COMPLETED = 2,
-  EXPIRED = 3,
-}
-
-export function getQQBotHost(env: QQBotEnv = 'production'): string {
-  return HOSTS[env];
-}
-
-export function generateBindKey(): string {
-  return randomBytes(32).toString('base64');
-}
-
-export function buildConnectUrl(taskId: string, source = 'zhin'): string {
-  return `https://${getQQBotHost('production')}/qqbot/openclaw/connect.html?task_id=${encodeURIComponent(taskId)}&source=${encodeURIComponent(source)}&_wv=2`;
-}
-
-/**
- * AES-256-GCM 解密 base64 密文。
- * 密文格式: IV(12 bytes) + ciphertext + AuthTag(16 bytes)
- */
-export function decryptSecret(encryptedBase64: string, keyBase64: string): string {
-  const key = Buffer.from(keyBase64, 'base64');
-  const payload = Buffer.from(encryptedBase64, 'base64');
-  const iv = payload.subarray(0, 12);
-  const authTag = payload.subarray(payload.length - 16);
-  const ciphertext = payload.subarray(12, payload.length - 16);
-  const decipher = createDecipheriv('aes-256-gcm', key, iv);
-  decipher.setAuthTag(authTag);
-  return Buffer.concat([decipher.update(ciphertext), decipher.final()]).toString('utf8');
-}
-
-interface LiteApiResponse<T> {
-  retcode: number;
-  msg?: string;
-  data?: T;
-}
-
-async function postJson<T>(
-  url: string,
-  body: Record<string, unknown>,
-  timeoutMs: number,
-): Promise<LiteApiResponse<T>> {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
-  try {
-    const res = await fetch(url, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        Accept: 'application/json',
-      },
-      body: JSON.stringify(body),
-      signal: controller.signal,
-    });
-    if (!res.ok) {
-      throw new Error(`HTTP ${res.status} from ${url}`);
-    }
-    return (await res.json()) as LiteApiResponse<T>;
-  } finally {
-    clearTimeout(timer);
-  }
-}
-
-export interface BindTaskResult {
-  taskId: string;
-  key: string;
-}
-
-export async function createBindTask(
-  env: QQBotEnv = 'production',
-  timeoutMs = 10_000,
-): Promise<BindTaskResult> {
-  const url = `https://${getQQBotHost(env)}/lite/create_bind_task`;
-  const key = generateBindKey();
-  const res = await postJson<{ task_id?: string }>(url, { key }, timeoutMs);
-  if (res.retcode !== 0) {
-    throw new Error(res.msg ?? 'create_bind_task failed');
-  }
-  if (!res.data?.task_id) {
-    throw new Error('create_bind_task: missing task_id');
-  }
-  return { taskId: res.data.task_id, key };
-}
-
-export interface PollBindResultOk {
-  status: BindStatus;
-  botAppId: string;
-  botEncryptSecret: string;
-  /** 扫码绑定开发者 QQ 的 OpenID（poll_bind_result 返回） */
-  userOpenId: string;
-}
-
-export function parsePollBindResultData(data: {
-  status?: number;
-  bot_appid?: string | number;
-  bot_encrypt_secret?: string;
-  user_openid?: string;
-  userOpenid?: string;
-  openid?: string;
-} | undefined): PollBindResultOk {
-  return {
-    status: (data?.status ?? BindStatus.NONE) as BindStatus,
-    botAppId: String(data?.bot_appid ?? ''),
-    botEncryptSecret: data?.bot_encrypt_secret ?? '',
-    userOpenId: String(
-      data?.user_openid ?? data?.userOpenid ?? data?.openid ?? '',
-    ),
-  };
-}
-
-export async function pollBindResult(
-  taskId: string,
-  env: QQBotEnv = 'production',
-  timeoutMs = 10_000,
-): Promise<PollBindResultOk> {
-  const url = `https://${getQQBotHost(env)}/lite/poll_bind_result`;
-  const res = await postJson<{
-    status?: number;
-    bot_appid?: string | number;
-    bot_encrypt_secret?: string;
-    user_openid?: string;
-    userOpenid?: string;
-    openid?: string;
-  }>(url, { task_id: taskId }, timeoutMs);
-  if (res.retcode !== 0) {
-    throw new Error(res.msg ?? 'poll_bind_result failed');
-  }
-  return parsePollBindResultData(res.data);
-}

package/src/qq-bind-flow.ts

@@ -1,127 +0,0 @@
-/**
- * QQ Bot 扫码绑定流程（内联，等价 qqbot-connector startQrConnect）
- */
-import {
-  BindStatus,
-  buildConnectUrl,
-  createBindTask,
-  decryptSecret,
-  pollBindResult,
-} from './qq-bind-api.js';
-
-const POLL_INTERVAL_MS = 2000;
-
-export interface QqBindCredentials {
-  appId: string;
-  appSecret: string;
-  userOpenId?: string;
-}
-
-export interface QqBindCallbacks {
-  onSuccess: (credentials: QqBindCredentials[]) => void;
-  onFailure: (error: Error) => void;
-  onQrDisplayed?: (url: string) => void | Promise<void>;
-  onQrExpired?: () => void | Promise<void>;
-}
-
-export interface QqBindFlowOptions {
-  signal?: AbortSignal;
-  source?: string;
-}
-
-function sleep(ms: number, signal?: AbortSignal): Promise<void> {
-  return new Promise((resolve, reject) => {
-    if (signal?.aborted) {
-      reject(new DOMException('Aborted', 'AbortError'));
-      return;
-    }
-    const timer = setTimeout(resolve, ms);
-    signal?.addEventListener(
-      'abort',
-      () => {
-        clearTimeout(timer);
-        reject(new DOMException('Aborted', 'AbortError'));
-      },
-      { once: true },
-    );
-  });
-}
-
-async function pollUntilResult(
-  taskId: string,
-  key: string,
-  signal?: AbortSignal,
-): Promise<{ outcome: 'scanned'; appId: string; appSecret: string; userOpenId: string } | { outcome: 'expired' }> {
-  while (!signal?.aborted) {
-    let result;
-    try {
-      result = await pollBindResult(taskId);
-    } catch {
-      await sleep(POLL_INTERVAL_MS, signal);
-      continue;
-    }
-    if (result.status === BindStatus.COMPLETED) {
-      const appSecret = decryptSecret(result.botEncryptSecret, key);
-      return {
-        outcome: 'scanned',
-        appId: result.botAppId,
-        appSecret,
-        userOpenId: result.userOpenId,
-      };
-    }
-    if (result.status === BindStatus.EXPIRED) {
-      return { outcome: 'expired' };
-    }
-    await sleep(POLL_INTERVAL_MS, signal);
-  }
-  throw new DOMException('Aborted', 'AbortError');
-}
-
-/**
- * 轮询等待扫码结果（回调风格）。返回 stop 函数可中止流程。
- */
-export function startQqBindFlow(
-  callbacks: QqBindCallbacks,
-  options: QqBindFlowOptions = {},
-): () => void {
-  const controller = new AbortController();
-  const signal = options.signal
-    ? AbortSignal.any([controller.signal, options.signal])
-    : controller.signal;
-
-  void (async () => {
-    for (;;) {
-      if (signal.aborted) {
-        throw new DOMException('Aborted', 'AbortError');
-      }
-      let task;
-      try {
-        task = await createBindTask();
-      } catch (err) {
-        throw new Error(
-          `获取绑定任务失败: ${err instanceof Error ? err.message : String(err)}`,
-          { cause: err },
-        );
-      }
-      const connectUrl = buildConnectUrl(task.taskId, options.source ?? 'zhin');
-      await callbacks.onQrDisplayed?.(connectUrl);
-      const pollResult = await pollUntilResult(task.taskId, task.key, signal);
-      if (pollResult.outcome === 'scanned') {
-        callbacks.onSuccess([{
-          appId: pollResult.appId,
-          appSecret: pollResult.appSecret,
-          userOpenId: pollResult.userOpenId || undefined,
-        }]);
-        return;
-      }
-      await callbacks.onQrExpired?.();
-    }
-  })().catch((err) => {
-    if (err instanceof DOMException && err.name === 'AbortError') {
-      return;
-    }
-    callbacks.onFailure(err instanceof Error ? err : new Error(String(err)));
-  });
-
-  return () => controller.abort();
-}

package/src/qq-bind-persist.ts

@@ -1,71 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { runtimeCwd } from 'zhin.js';
-
-export interface QqCredentialEnvKeys {
-  appidKey: string;
-  secretKey: string;
-  appidRef: string;
-  secretRef: string;
-}
-
-/** 按 endpoint 名称生成唯一 env 键（如 `QQ_MOCK_QQ_BOT_APPID`） */
-export function buildQqCredentialEnvKeys(endpointName: string): QqCredentialEnvKeys {
-  const slug = endpointName.replace(/[^a-zA-Z0-9_]/g, '_').toUpperCase();
-  const appidKey = `QQ_${slug}_APPID`;
-  const secretKey = `QQ_${slug}_SECRET`;
-  return {
-    appidKey,
-    secretKey,
-    appidRef: `\${${appidKey}}`,
-    secretRef: `\${${secretKey}}`,
-  };
-}
-
-function resolveProjectRoot(): string {
-  const envRoot = process.env.ZHIN_PROJECT_ROOT?.trim();
-  return path.resolve(envRoot || runtimeCwd());
-}
-
-function escapeRegExp(text: string): string {
-  return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-function upsertEnvLine(content: string, key: string, value: string): string {
-  const lineRe = new RegExp(`^${escapeRegExp(key)}\\s*=.*$`, 'm');
-  const newLine = `${key}=${value}`;
-  if (lineRe.test(content)) {
-    return content.replace(lineRe, newLine);
-  }
-  const trimmed = content.replace(/\s*$/, '');
-  if (trimmed.length === 0) {
-    return `${newLine}\n`;
-  }
-  return `${trimmed}\n${newLine}\n`;
-}
-
-/** 写入或更新 `.env` 中的键值，并同步到当前进程 `process.env` */
-export function persistQqCredentialsToEnv(
-  endpointName: string,
-  appId: string,
-  appSecret: string,
-  projectRoot?: string,
-): QqCredentialEnvKeys {
-  const keys = buildQqCredentialEnvKeys(endpointName);
-  const root = projectRoot ?? resolveProjectRoot();
-  const envPath = path.join(root, '.env');
-  let content = fs.existsSync(envPath) ? fs.readFileSync(envPath, 'utf-8') : '';
-
-  const entries: Record<string, string> = {
-    [keys.appidKey]: appId,
-    [keys.secretKey]: appSecret,
-  };
-
-  for (const [key, value] of Object.entries(entries)) {
-    content = upsertEnvLine(content, key, value);
-    process.env[key] = value;
-  }
-
-  fs.writeFileSync(envPath, content);
-  return keys;
-}