TypeScriptの便利機能まとめ
Utility型とGenerics入門

touch utility.ts
bun --watch run utility.ts

touch src/utility.ts
npx tsc --watch  # 別ターミナルで起動
node dist/utility.js

interface User {
  id:      number;
  name:    string;
  email:   string;
  age:     number;
}

// Partial: 全プロパティを省略可能にする（PATCHリクエストの型に最適）
type UpdateUserInput = Partial<User>;
// { id?: number; name?: string; email?: string; age?: number; }

function updateUser(id: number, input: UpdateUserInput): void {
  console.log(`ユーザー${id}を更新:`, input);
}

// 一部だけ渡せる
updateUser(1, { name: "Alice Updated" });
updateUser(2, { email: "new@example.com", age: 30 });

// Required: 全プロパティを必須にする（デフォルト値補完後の型など）
interface Config {
  host?:    string;
  port?:    number;
  debug?:   boolean;
}

function resolveConfig(input: Config): Required<Config> {
  return {
    host:  input.host  ?? "localhost",
    port:  input.port  ?? 3000,
    debug: input.debug ?? false,
  };
}

console.log(resolveConfig({ port: 8080 }));
// → { host: "localhost", port: 8080, debug: false }

interface Article {
  id:          number;
  title:       string;
  body:        string;
  authorId:    number;
  publishedAt: string | null;
  createdAt:   string;
}

// Pick: 必要なプロパティだけ取り出す（一覧表示用の軽量型）
type ArticleSummary = Pick<Article, "id" | "title" | "publishedAt">;
// { id: number; title: string; publishedAt: string | null }

// Omit: 不要なプロパティを除外する（POST リクエスト用：id/createdAt は自動生成）
type CreateArticleInput = Omit<Article, "id" | "createdAt">;
// { title: string; body: string; authorId: number; publishedAt: string | null }

const summary: ArticleSummary = {
  id: 1,
  title: "TypeScript入門",
  publishedAt: "2025-04-01",
};

const newArticle: CreateArticleInput = {
  title: "Bun入門",
  body:  "Bunとは高速なJSランタイムです",
  authorId: 10,
  publishedAt: null,
};

console.log(summary);
console.log(newArticle);

type Lang = "ja" | "en" | "zh";

// Record<キーの型, 値の型>
const messages: Record<Lang, string> = {
  ja: "こんにちは",
  en: "Hello",
  zh: "你好",
};
// Lang のすべてのキーを網羅しないとエラーになる

console.log(messages.ja); // → こんにちは
console.log(messages.en); // → Hello

// IDをキーにしたキャッシュ構造にも使える
type UserCache = Record<number, { name: string; email: string }>;

const cache: UserCache = {
  1: { name: "Alice", email: "alice@example.com" },
  2: { name: "Bob",   email: "bob@example.com"   },
};

console.log(cache[1].name); // → Alice

bun run utility.ts
#https://api.example.com
#{ x: 0, y: 0 }

npx tsc && node dist/utility.js
#https://api.example.com
#{ x: 0, y: 0 }

bun run utility.ts
#hello
#42
#10
#a
#[ "name", 42 ]

npx tsc && node dist/utility.js
#hello
#42
#10
#a
#[ 'name', 42 ]

// id プロパティを持つ型に絞る
function findById<T extends { id: number }>(
  items: T[],
  id: number
): T | undefined {
  return items.find((item) => item.id === id);
}

const users = [
  { id: 1, name: "Alice", role: "admin"  },
  { id: 2, name: "Bob",   role: "editor" },
];

const posts = [
  { id: 10, title: "TypeScript入門", authorId: 1 },
  { id: 11, title: "Bun入門",         authorId: 2 },
];

// 同じ関数で User も Post も検索できる
console.log(findById(users, 1));   // → { id: 1, name: "Alice", role: "admin" }
console.log(findById(posts, 11));  // → { id: 11, title: "Bun入門", authorId: 2 }

bun run utility.ts
#Alice
#1
#起動: localhost:3000 debug=false
#起動: localhost:8080 debug=true
#{ title: "TypeScript Tips", body: "本文...", authorId: 1 }

npx tsc && node dist/utility.js
#Alice
#1
#起動: localhost:3000 debug=false
#起動: localhost:8080 debug=true
#{ title: 'TypeScript Tips', body: '本文...', authorId: 1 }