Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

7.0 KB
Raw Blame
/**
 * 移动推送注册的纯逻辑模型(无 expo / RN 依赖,可直接单测)。
 *
 * 链路:手机拿 APNs device token → PUT device-link server /push-token 注册;
 * 桌面端任务终态发 notify 帧 → server 查账号 token → APNs 下发。
 * 契约见本仓 packages/device-link-protocol 与 cindy-server docs/device-link-server.md。
 */

export type PushAppVariant = 'cn' | 'global';

/**
 * 构建线 → server 侧 appVariant(决定 APNs topic/bundleId)。
 * dev 是内部开发身份且行为语义归 cn 系:开发环境用 APNS_TOPIC_CN
 * 配置 com.xd.cindydev,因此注册时复用 appVariant='cn'。
 */
export function resolvePushAppVariant(region: 'cn' | 'global' | 'dev'): PushAppVariant {
  return region === 'global' ? 'global' : 'cn';
}

export interface PushTokenRegistrationBody {
  token: string;
  platform: 'ios' | 'android';
  provider: 'apns' | 'fcm';
  appVariant: PushAppVariant;
  apnsEnv?: 'prod' | 'sandbox';
}

/**
 * 组装 PUT /push-token 的 body;空 token 返回 null。
 * apnsEnv:dev client(Xcode debug 签名)走 sandbox APNs,TestFlight / App Store /
 * 自建 release 走 prod —— 与 __DEV__ 语义一致。
 */
export function buildPushTokenRegistrationBody(opts: {
  token: string;
  region: 'cn' | 'global' | 'dev';
  isDevBuild: boolean;
  platform?: 'ios' | 'android';
}): PushTokenRegistrationBody | null {
  const appVariant = resolvePushAppVariant(opts.region);
  const token = opts.token.trim();
  if (!token) return null;
  return {
    token,
    platform: opts.platform ?? 'ios',
    provider: opts.platform === 'android' ? 'fcm' : 'apns',
    appVariant,
    ...(opts.platform === 'android' ? {} : { apnsEnv: opts.isDevBuild ? 'sandbox' as const : 'prod' as const }),
  };
}

const BOT_GROUP_DEEP_LINK = /^\/companions\/groups\/([^/?#]+)\?([^#]*)$/;
const MAX_DEEP_LINK_ID_CHARS = 256;

function hasControlCharacter(value: string): boolean {
  for (let index = 0; index < value.length; index += 1) {
    if (value.charCodeAt(index) < 0x20 || value.charCodeAt(index) === 0x7f) return true;
  }
  return false;
}

function decodedDeepLinkId(value: string): string | null {
  try {
    const decoded = decodeURIComponent(value);
    return decoded && decoded.length <= MAX_DEEP_LINK_ID_CHARS && !hasControlCharacter(decoded) ? decoded : null;
  } catch {
    return null;
  }
}

/**
 * 分工一步停下时的群聊提醒(bot-group-chat.md §8.3):`/companions/groups/<groupId>?deviceId=<id>`。
 * 云端群消息可不带电脑,但必须带规范消息 ID;旧分工通知继续接受 deviceId。
 * 通过后按规范形式重建,绝不原样转发。
 */
function parseBotGroupDeepLink(deepLink: string): string | null {
  const match = BOT_GROUP_DEEP_LINK.exec(deepLink);
  if (!match) return null;
  const [, encodedGroupId, query] = match;
  const groupId = decodedDeepLinkId(encodedGroupId!);
  if (!groupId || encodeURIComponent(groupId) !== encodedGroupId) return null;
  const params = new URLSearchParams(query);
  const keys = [...params.keys()];
  if (new Set(keys).size !== keys.length || keys.some(key => !['deviceId', 'messageId', 'threadRootId'].includes(key))) return null;
  const deviceId = params.get('deviceId') ?? '';
  const messageId = params.get('messageId');
  const threadRootId = params.get('threadRootId');
  const uuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
  if ((!deviceId && (!messageId || !uuid.test(groupId))) || (params.has('deviceId') && !deviceId)
    || deviceId.length > MAX_DEEP_LINK_ID_CHARS || hasControlCharacter(deviceId)
    || (messageId !== null && !uuid.test(messageId)) || (threadRootId !== null && (!messageId || !uuid.test(threadRootId)))) return null;
  const clean = new URLSearchParams();
  if (deviceId) clean.set('deviceId', deviceId);
  if (messageId) clean.set('messageId', messageId);
  if (threadRootId) clean.set('threadRootId', threadRootId);
  return `/companions/groups/${encodeURIComponent(groupId)}?${clean}`;
}

/**
 * 从通知 data 中解析深链。只接受桌面端契约内的应用内路径(/sessions/... 与群聊
 * /companions/groups/...),拒绝任意 URL / 其它路径 —— 推送 payload 经第三方通道,按不可信输入对待。
 */
export function parseNotificationDeepLink(data: unknown): string | null {
  if (!data || typeof data !== 'object') return null;
  const deepLink = (data as Record<string, unknown>).deepLink;
  if (typeof deepLink !== 'string') return null;
  if (deepLink.includes('://') || deepLink.startsWith('//')) return null;
  if (deepLink.startsWith('/companions/groups/')) return parseBotGroupDeepLink(deepLink);
  if (!deepLink.startsWith('/sessions/')) return null;
  return deepLink;
}

function parseNotificationPayloadDeepLink(data: unknown): string | null {
  const direct = parseNotificationDeepLink(data);
  if (direct) return direct;
  if (!data || typeof data !== 'object') return null;
  const record = data as Record<string, unknown>;
  // APNs relay implementations may wrap custom fields under `body` or `data`.
  // Keep the fallback explicit rather than recursively walking untrusted payloads.
  return parseNotificationDeepLink(record.body) ?? parseNotificationDeepLink(record.data);
}

/** Local navigation hint only; neither the push payload nor the device-link protocol changes. */
export function notificationRecoveryRoute(deepLink: string, responseKey: string): string {
  const hashIndex = deepLink.indexOf('#');
  const path = hashIndex < 0 ? deepLink : deepLink.slice(0, hashIndex);
  const fragment = hashIndex < 0 ? '' : deepLink.slice(hashIndex);
  const queryIndex = path.indexOf('?');
  const pathname = queryIndex < 0 ? path : path.slice(0, queryIndex);
  const query = new URLSearchParams(queryIndex < 0 ? '' : path.slice(queryIndex + 1));
  query.set('notificationResponse', responseKey);
  return `${pathname}?${query.toString()}${fragment}`;
}

/**
 * 从 expo-notifications 的点击响应中解析任务深链。
 *
 * iOS 远程通知在 Expo 56 有两条数据出口:`content.data` 通常来自 APNs
 * userInfo 的 `body` 字段,而完整的 APNs userInfo 保存在
 * `request.trigger.payload`。两者都支持,避免 relay 的 payload 包装方式
 * 让点击事件静默失效。
 */
export function parseNotificationResponseDeepLink(response: unknown): string | null {
  if (!response || typeof response !== 'object') return null;
  const notification = (response as Record<string, unknown>).notification;
  if (!notification || typeof notification !== 'object') return null;
  const request = (notification as Record<string, unknown>).request;
  if (!request || typeof request !== 'object') return null;
  const requestRecord = request as Record<string, unknown>;
  const content = requestRecord.content;
  if (content && typeof content === 'object') {
    const contentData = (content as Record<string, unknown>).data;
    const fromContent = parseNotificationPayloadDeepLink(contentData);
    if (fromContent) return fromContent;
  }
  const trigger = requestRecord.trigger;
  if (!trigger || typeof trigger !== 'object') return null;
  return parseNotificationPayloadDeepLink((trigger as Record<string, unknown>).payload);
}