第03章：最初のQueueを作ろう 🛠️

ここからは、実際にQueueを作る準備をします。
Windows、VS Code、Node、Wranglerを使う前提で進めます。

---

1. Queueを作成する 📬

WranglerでQueueを作ります。

npx wrangler queues create contact-jobs

名前は、用途が分かるものにします。

contact-jobs
email-jobs
image-processing-jobs
ai-embedding-jobs

あとから見て分かる名前が大切です。

---

2. Producer bindingを書く ⚙️

wrangler.jsonc にproducer bindingを追加します。

{
  "queues": {
    "producers": [
      {
        "binding": "CONTACT_QUEUE",
        "queue": "contact-jobs"
      }
    ]
  }
}

Workerでは env.CONTACT_QUEUE として使えます。

---

3. Env型を書く 🧩

TypeScriptではEnv型も用意します。

export interface Env {
  CONTACT_QUEUE: Queue<ContactJob>;
}

type ContactJob = {
  jobId: string;
  name: string;
  message: string;
};

型があると、メッセージの形を間違えにくくなります。

---

4. まずは小さく始める 🌱

最初からメールAPIやAI APIまでつなぐと混乱します。
まずはQueueへ入れて、consumerで console.log() するだけで十分です。

第1段階: sendしてlog
第2段階: D1へ保存
第3段階: 外部APIを呼ぶ

段階を分けると、エラーの場所を見つけやすくなります。

---

5. 章末チェック ✅

• WranglerでQueueを作れる
• queues.producers のbindingを書ける
• Env型に Queue<T> を書ける
• Queue名は用途が分かる名前にすると分かる
• 最初はlogだけで試せばよいと分かる

この章で覚える一言はこれです。
Queueは、作成・binding・型定義の3点セットで準備します 🛠️