アプリの設定値を三層で解決する — 既定・ユーザー・リモートを境界付きにマージするレイヤー設計

// config/resolver.ts
import { z } from "zod";
 
// 既定値のスキーマ。型と初期値の source of truth はここだけ
const ConfigSchema = z.object({
  interstitialCooldownSec: z.number().int().min(30).max(600),
  reviewPromptAfterOpens: z.number().int().min(3).max(50),
  imagePrefetchCount: z.number().int().min(0).max(40),
  showOnboardingV2: z.boolean(),
});
 
export type AppConfig = z.infer<typeof ConfigSchema>;
 
const DEFAULTS: AppConfig = {
  interstitialCooldownSec: 90,
  reviewPromptAfterOpens: 8,
  imagePrefetchCount: 12,
  showOnboardingV2: false,
};
 
// キーごとの上書きポリシー
//   locked … リモートもユーザーも触れない
//   user   … ユーザー設定だけが既定を上書きできる
//   remote … リモートが上書きできるが min/max に必ずクランプ
type Policy =
  | { kind: "locked" }
  | { kind: "user" }
  | { kind: "remote"; min: number; max: number };
 
const POLICIES: Record<keyof AppConfig, Policy> = {
  interstitialCooldownSec: { kind: "remote", min: 60, max: 300 },
  reviewPromptAfterOpens: { kind: "remote", min: 5, max: 20 },
  imagePrefetchCount: { kind: "user" },
  showOnboardingV2: { kind: "locked" },
};

type Sources = {
  user: Partial<AppConfig>;
  remote: Record<string, unknown>; // 信頼できない外部入力
};
 
const clamp = (v: number, min: number, max: number) =>
  Math.min(max, Math.max(min, v));
 
export function resolveConfig(sources: Sources): {
  config: AppConfig;
  rejected: string[];
} {
  const out: AppConfig = { ...DEFAULTS };
  const rejected: string[] = [];
 
  for (const key of Object.keys(DEFAULTS) as (keyof AppConfig)[]) {
    const policy = POLICIES[key];
 
    if (policy.kind === "locked") continue; // 既定のまま動かさない
 
    if (policy.kind === "user") {
      const val = sources.user[key];
      if (val !== undefined) (out[key] as unknown) = val;
      continue;
    }
 
    // policy.kind === "remote"
    const raw = sources.remote[key];
    if (raw === undefined) continue;
 
    // 型がずれていたら、その1キーだけ既定に残す（全体は壊さない）
    const field = ConfigSchema.shape[key];
    const parsed = field.safeParse(raw);
    if (!parsed.success) {
      rejected.push(`${key}: ${parsed.error.issues[0]?.message ?? "invalid"}`);
      continue;
    }
 
    // 数値はポリシーの境界に必ず収める
    const value = parsed.data;
    (out[key] as unknown) =
      typeof value === "number" ? clamp(value, policy.min, policy.max) : value;
  }
 
  return { config: out, rejected };
}

// resolver.test.ts
import { resolveConfig } from "./resolver";
 
test("壊れたリモート値でもアプリ既定に落ちる", () => {
  const { config, rejected } = resolveConfig({
    user: { imagePrefetchCount: 24 },
    remote: {
      interstitialCooldownSec: 3,      // 短すぎ → 下限60にクランプ
      reviewPromptAfterOpens: "soon",  // 型違反 → 既定8に落とす
      showOnboardingV2: true,          // locked → 無視
    },
  });
 
  expect(config.interstitialCooldownSec).toBe(60); // クランプ
  expect(config.reviewPromptAfterOpens).toBe(8);   // フォールバック
  expect(config.imagePrefetchCount).toBe(24);      // ユーザーが上書き
  expect(config.showOnboardingV2).toBe(false);     // locked のまま
  expect(rejected.length).toBe(1);
});

// config/useConfig.ts
import { useMemo } from "react";
import { resolveConfig, type AppConfig } from "./resolver";
import { useUserPrefs } from "./userPrefs";   // 端末ローカル
import { useRemoteConfig } from "./remoteConfig"; // Firebase 等の生値
 
export function useConfig(): AppConfig {
  const user = useUserPrefs();
  const remote = useRemoteConfig();
 
  return useMemo(() => {
    const { config, rejected } = resolveConfig({ user, remote });
    if (rejected.length > 0) {
      // 本番では捨てずに必ず記録する。ここが後で効く
      console.warn("[config] rejected keys", rejected);
    }
    return config;
  }, [user, remote]);
}