アプリから外部の AI にユーザーの文章を送るとき、Play の「データの安全性」に何を書くか

// src/net/outbound.ts
// 外部へ出す通信は、この関数だけを経由させます。
// destination の宣言が、そのままデータ安全性フォームの下書きになります。
 
export type Retention = "none" | "shortTerm" | "persisted";
 
export type Destination = {
  id: string;            // 申告時に人が読む名前
  host: string;          // 実際の送信先
  retention: Retention;  // 相手がどれだけ持つか（契約・ドキュメントで確認した値）
  usedByThirdParty: boolean; // 相手が自分たちの目的で使うか
};
 
export const DESTINATIONS = {
  assistant: {
    id: "文章整理アシスタント",
    host: "api.example-model.com",
    retention: "shortTerm",     // 不正利用監視のため一定期間保持されるとの記載あり
    usedByThirdParty: false,
  },
} satisfies Record<string, Destination>;
 
type SendOptions = {
  destination: Destination;
  body: unknown;
  signal?: AbortSignal;
};
 
export async function sendOutbound({ destination, body, signal }: SendOptions) {
  const startedAt = Date.now();
  const requestId = Math.random().toString(36).slice(2, 10);
 
  try {
    const res = await fetch(`https://${destination.host}/v1/complete`, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(body),
      signal,
    });
    if (!res.ok) throw new Error(`upstream ${res.status}`);
    return await res.json();
  } finally {
    // 本文はログに残しません。残すのは追跡に要る最小限だけです。
    console.log(
      `[outbound] id=${requestId} to=${destination.id} ms=${Date.now() - startedAt}`
    );
  }
}

// src/net/redact.ts
const EMAIL = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g;
const LONG_DIGITS = /\d{10,}/g;   // 注文番号・会員番号。ハイフン無しの連番
const PHONE_JP = /(?:\+81[-\s]?|0)\d{1,4}[-\s]?\d{1,4}[-\s]?\d{3,4}/g;
 
export function redact(input: string) {
  const hits = { email: 0, longDigits: 0, phone: 0 };
  let out = input.replace(EMAIL, () => { hits.email++; return "[email]"; });
  out = out.replace(LONG_DIGITS, () => { hits.longDigits++; return "[number]"; }); // 先に確定
  out = out.replace(PHONE_JP, () => { hits.phone++; return "[phone]"; });
  return { text: out, hits, before: [...input].length, after: [...out].length };
}

// src/dev/outboundAudit.ts
// __DEV__ のときだけ有効化します。本番ビルドには入れません。
 
const seen = new Map<string, number>();
 
export function installOutboundAudit() {
  if (!__DEV__) return;
  const original = global.fetch;
 
  global.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
    const url = typeof input === "string" ? input : input.toString();
    try {
      const host = new URL(url).host;
      seen.set(host, (seen.get(host) ?? 0) + 1);
    } catch {
      // 相対 URL 等は数えません
    }
    return original(input, init);
  };
}
 
export function dumpOutboundHosts() {
  const rows = [...seen.entries()].sort((a, b) => b[1] - a[1]);
  console.log("[outbound-audit] " + JSON.stringify(Object.fromEntries(rows)));
}