@joymerrevent/porters-connect 0.9.0 → 0.11.0

package/CHANGELOG.md

@@ -5,6 +5,150 @@
 
 ## [Unreleased]
 
+## [0.11.0] - 2026-08-30
+
+**参照先の項目を 1 往復で読めるようにし、`field` の語彙をクエリ全体と揃えた版**です。
+どちらも「**要求したものが黙って返らない**」を潰す変更で、`field` に接頭辞を書かなくなる
+**破壊的変更**を含みます（移行は接頭辞を消すだけ）。
+
+### Added
+
+- **参照型の展開 `expand`**（[ADR-0058][adr58]）。`System[Reference]` の項目（`Job.P_Client` など）から
+  **参照先の項目そのもの**を取得できるようになりました。これまでは参照先の **ID だけ**を取り出し、
+  入れ子で返ってきた残りを**黙って捨てて**いました。
+
+  ```ts
+  const page = await t.job.search({ expand: { P_Client: ["P_Id", "P_Name"] } });
+  page.items[0]?.P_Client; // { P_Id: number | null; P_Name: string | null } | null
+
+  const plain = await t.job.search();
+  plain.items[0]?.P_Client; // number | null（従来どおり）
+  ```
+
+  - **参照先の接頭辞は書きません**。`condition` / `order` / `field` と同じ素の alias で指定すると、
+    ライブラリが `field=Job.P_Client(Client.P_Id,Client.P_Name)` を組み立てます。
+    Candidate を参照するときの `Person.` も同様です。
+  - **`expand` を書いた項目だけ**戻り型が変わります。基底の型は `number | null` のままなので、
+    **参照を ID として使っているコードは無変更**です。展開しなかった参照も ID のまま返ります。
+  - `search` / `searchAll` / `get(id, { expand })` で使えます。`get` は第 2 引数が増えただけで、
+    既存の `get(id)` はそのままです。
+  - 展開した alias は**素のエントリを置き換えて**送られます。同じ alias を `()` 有り・無しで 2 回送ったとき
+    どちらが優先されるかは PORTERS のドキュメントに記述が無いため、**そもそも送りません**。
+  - 展開できるのは**参照先をライブラリが実装している項目**だけです。`P_Recruiter`（Recruiter は未実装）と
+    カスタム項目（`U_`/`A_`）の参照型は対象外で、**従来どおり ID として読めます**。書くと型エラーです。
+  - `field` に `"Job.P_Client(Client.P_Id)"` のような展開文字列を書くと、送信前に
+    `PortersConfigError` で止まり `expand` を案内します。
+  - `()` の中に付ける参照先の接頭辞と入れ子の形は**実機で未確認**です
+    （[live-verification][lv] LV-10 / LV-16）。応答の解釈はタグ名に依存しない実装です。
+
+- **型の export**: `Expand` / `ExpandedReadRecord` / `ReferenceMap` / `ResourcePageOf` /
+  `ReferenceRecord` / `ReadFieldAlias`。`FieldValue` に `ReferenceRecord`（展開された参照の値）が加わります。
+
+### Changed
+
+- **（破壊的）Read の `field` は接頭辞なしの alias で書きます**（[ADR-0059][adr59]）。
+  接頭辞はリソースごとの定数なので、**ライブラリが付けます**。
+
+  ```diff
+  - field: ["Person.P_Id", "Person.P_Name"]
+  + field: ["P_Id", "P_Name"]
+  ```
+
+  - 移行は**接頭辞を消すだけ**です。送られる URL は従来と同じで、変わるのは書き方と、
+    **どこで間違いに気づけるか**だけです。
+  - `condition` / `order` / `expand` はもともと素の alias を受けていたため、
+    **同じクエリの中で語彙が 2 つあった**状態が解消されます。
+  - **間違いがコンパイルエラーになります** — 綴り間違い（`P_Nmae`）・接頭辞付き（`Person.P_Name`）・
+    リソース名との取り違え（`Candidate.P_Name`。Candidate の接頭辞は `Person` です）・展開文字列。
+    これまでは型（`string[]`）でも送信前ガードでも素通りし、**PORTERS 側で黙って無視される**だけでした。
+  - **未宣言のカスタム項目は引き続き書けます**（`U_` / `A_` で始まる名前）。ただし `U_` 以降の綴りは
+    検査できないので、よく使うものは `defineFields` で宣言してください（宣言すれば綴りも検査されます）。
+  - 実行時は接頭辞付きが来ても**剥がして受けます**（応答側と対称の寛容さ）。cast 経由の古い形も壊れません。
+  - 対象は `SearchQuery.field`（データ 5 リソース）と `UserSearchQuery.field`（マスタ User）。
+    **Attachment は元から接頭辞なし**なので変更ありません。`field: []`（主キーのみ）と
+    省略時の既定 field（[ADR-0020][adr20]）の意味も変わりません。
+  - **pre-1.0 のため minor**（[ADR-0055][adr55] と同じ扱い）。
+
+- **明示した `field` も既定 field と同じ組み立てを通る**ようになりました。`User` 型の項目を
+  `field` で明示すると **4 サブ項目に展開**されます（`Job.P_Owner(User.P_Id,User.P_Type,User.P_Name,User.P_Mail)`）。
+  これまでは `()` 無しで送られ、PORTERS が ID を返すため、**型が `UserRef` を約束するのに実体は `null`**
+  になっていました。
+
+### Fixed
+
+- **参照 ID の読み取りが、リソース名と alias 接頭辞の食い違いで `null` に落ちていました**。
+  入れ子の**包みタグはリソース名**なのに**中の alias は接頭辞付き**で、この 2 つが異なる Candidate
+  （`<Candidate>` に `Person.P_Id`）では従来の照合が外れていました。**素の alias で照合**するようにしたので、
+  どちらの表記でも読めます。
+  - 影響していたのは `Process.P_Candidate` / `Resume.P_Candidate`（Candidate を参照する項目）です。
+    包みタグの実際の値は**実機で未確認**（[live-verification][lv] LV-10）で、フェイクサーバーは
+    これまで中立な包みを返していたため、テストでは露出していませんでした。
+
+## [0.10.0] - 2026-08-22
+
+**partition の束ね方を 1 つに絞り、削除済みレコードを判別できるようにした版**です。
+`PortersClient` から `partition` を外した**破壊的変更**を含みます（移行は下記）。
+併せて、削除済みを読めるのに**どれが削除済みか分からなかった**穴を塞ぎました。
+
+### Added
+
+- **削除フラグ `P_Deleted`**（[ADR-0056][adr56]）。データ系 5 リソース（Candidate / Job / Client /
+  Process / Resume）の公開型に加わり、`itemstate: "all"` の結果から削除済みを**判別できる**ようになりました。
+
+  ```ts
+  const page = await t.candidate.search({ itemstate: "all" });
+  const deleted = page.items.filter((c) => c.P_Deleted === "1");
+  ```
+
+  - **値は文字列**の `"0"`（生存）／`"1"`（削除済み）です。`number` でも `boolean` でもありません。
+    PORTERS がこの項目に **Data Type を与えていない**（reference の Field Type / Data Type 欄がともに「ー」）ため、
+    変換の基準がありません。勝手に決めればライブラリの発明になるので、**生の値のまま**返します。
+  - **`condition` にも `order` にも指定できず、Write もできません**（PORTERS の制約）。
+    いずれも型で表現されているので、書くとコンパイルエラーになります。
+  - `field` を省略すれば**自動で要求**されます。自分で `field` を渡すときは
+    `"Person.P_Deleted"` のように接頭辞付きで明示してください。
+  - 削除 API が無い PORTERS では「削除済みを読む」こと自体が運用手段（同期・監査・復元の判断材料）ですが、
+    これまでは**読めるのに解釈できない**状態でした。
+  - 応答での出現条件と値域は**実機で未確認**です（[live-verification][lv] LV-14）。
+
+### Changed
+
+- **（破壊的）`PortersClient` から `partition` を外しました**（[ADR-0055][adr55]）。
+  partition（Company DB）スコープのリソースは **`porters.tenant(id)` 経由でのみ**取得します。
+  **単一テナントでも同じ形**です。
+
+  ```diff
+  - const porters = new PortersClient({ host, appId, appSecret, partition: 123 });
+  - await porters.candidate.search();
+  + const porters = new PortersClient({ host, appId, appSecret });
+  + const t = porters.tenant(123);
+  + await t.candidate.search();
+  ```
+
+  - 影響するのは `candidate` / `job` / `client` / `process` / `resume` / `attachment` /
+    `user` / `field` / `option` の 9 アクセサ。`t` は以降クライアントのように使えるので、
+    **呼び出し側の書き味は変わりません**。
+  - **App レベルのものは `porters` 側に残ります**（いずれも `partition` を取りません）—
+    `porters.auth.*`（OAuth）と `porters.partition.search()`（partition の発見）。
+  - 理由: `partition` 未設定のクライアントは**`partition=0`** を全リクエストに載せていました。
+    `0` は PORTERS のドキュメントに存在しない値で、由来は最初の PoC の穴埋めです。実際には
+    Result Code **404** を招くため、**設定漏れが「サーバーが 404 を返す」形に化け**ていました。
+    `tenant(id)` を唯一の経路にすることで、**「partition を束ね忘れたクライアント」という状態が
+    型として存在しなくなります**。実行時ガードを足すのではなく、設計で防ぐ形にしました。
+  - **pre-1.0 のため minor**。誤った partition を渡すこと自体は妨げません（404 はサーバーが答えます）。
+
+### Fixed
+
+- **`itemstate: "existing"` を明示指定したとき、省略せずそのまま送る**ようになりました
+  （[ADR-0057][adr57]）。**返るデータは変わりません** — 変わるのは送信 URL だけです。
+  - これまでは `existing` が API の既定であることを理由に、明示指定でも param を省いていました。
+    しかし**省略（「既定に委ねる」）と明示（「生存レコードのみが欲しい」）は別の意思表示**です。
+    いま結果が同じなのは PORTERS の既定が `existing` だからで、**もし将来この既定が変われば、
+    生存のみを求めたコードに削除済みが混ざり始めます**（例外も Result Code も出ないので気づけません）。
+  - 生存のみであることが業務上重要なら、省略せず `itemstate: "existing"` と書いてください。
+    省略した場合はこれまでどおり API の既定に従います。
+  - `itemstate=existing` の実機送信実績はまだありません（[live-verification][lv] LV-15）。
+
 ## [0.9.0] - 2026-08-20
 
 **Candidate でメモ・住所詳細が扱えるようになった版**です。標準項目でありながらカタログから漏れていた
@@ -288,9 +432,17 @@
 [adr35]: docs/adr/0035-usage-documentation-structure.md
 [custom-fields-guide]: docs/guide/custom-fields.md
 [read-query-guide]: docs/guide/read-query.md
+[adr55]: docs/adr/0055-partition-binding-guard.md
+[adr56]: docs/adr/0056-deleted-flag-typing.md
+[adr57]: docs/adr/0057-itemstate-existing-explicit.md
+[adr58]: docs/adr/0058-reference-expansion-read.md
+[adr59]: docs/adr/0059-read-field-bare-alias.md
+[lv]: docs/live-verification.md
 [kac]: https://keepachangelog.com/en/1.1.0/
 [semver]: https://semver.org/
-[unreleased]: https://github.com/Joymerrevent/porters-connect/compare/v0.9.0...HEAD
+[unreleased]: https://github.com/Joymerrevent/porters-connect/compare/v0.11.0...HEAD
+[0.11.0]: https://github.com/Joymerrevent/porters-connect/compare/v0.10.0...v0.11.0
+[0.10.0]: https://github.com/Joymerrevent/porters-connect/compare/v0.9.0...v0.10.0
 [0.9.0]: https://github.com/Joymerrevent/porters-connect/compare/v0.8.0...v0.9.0
 [0.8.0]: https://github.com/Joymerrevent/porters-connect/compare/v0.7.0...v0.8.0
 [0.7.0]: https://github.com/Joymerrevent/porters-connect/compare/v0.6.2...v0.7.0

package/README.md

@@ -58,15 +58,14 @@ const porters = new PortersClient({
   scheme: process.env.PORTERS_SCHEME === "http" ? "http" : undefined,
   appId: process.env.PORTERS_APP_ID!,
   appSecret: process.env.PORTERS_APP_SECRET!,
-  partition: 123, // 既定 Partition（Company DB）Id
 });
 
-// 複数 partition を 1 つの App で扱う SaaS は porters.tenant(id) で束ねる
+// partition（Company DB）は tenant で一度だけ束ねる。**単一テナントでもこの形**
+// 以降は `t` をクライアントのように使う（client 直下には auth と partition マスタだけ）
 const t = porters.tenant(456);
-await t.candidate.search({ condition: { P_Name: { part: "鈴木" } } }); // partition=456
 
 // 検索（最大 200 件/ページ）。condition は項目の Data Type ごとに型付き
-const page = await porters.candidate.search({
+const page = await t.candidate.search({
   condition: { P_Name: { part: "山田" } }, // テキストは part（部分一致）/ full（完全一致）
   order: [{ P_UpdateDate: "desc" }], // 並び順（数値・日時・System のみ）
   count: 50,
@@ -74,18 +73,21 @@ const page = await porters.candidate.search({
 console.log(page.total, page.items.length);
 
 // 1 件取得
-const one = await porters.candidate.get(10001);
+const one = await t.candidate.get(10001);
 console.log(one?.P_Name);
 
 // 全件を自動ページング（200 件刻み）
-for await (const c of porters.candidate.searchAll({
+for await (const c of t.candidate.searchAll({
   condition: { P_Prefecture: { full: "東京都" } },
 })) {
   // c は 1 件ずつ
 }
 ```
 
-> 複数 partition を 1 つの App で扱う（マルチテナント SaaS）場合の `porters.tenant(id)` スコープ・テナント別 client・partition 発見は [マルチテナント ガイド][multi-tenancy] にまとめています。
+> **`partition` はクライアントに持たせません**（ADR-0055）。PORTERS は partition スコープの全リクエストで
+> `partition` を要求するので、`tenant(id)` で**明示的に一度だけ**束ねる形にしています。
+> 複数 partition を 1 つの App で扱う場合・テナント別 client・partition の発見は
+> [マルチテナント ガイド][multi-tenancy] にまとめています。
 >
 > 認証情報やホスト名は**コミットしない**でください。`.env.example` を参考に `.env` で渡します。
 
@@ -103,7 +105,6 @@ const porters = new PortersClient({
   host: "sandbox.invalid",
   appId: "demo",
   appSecret: "demo",
-  partition: 1,
   transport: createMockTransport((req) =>
     req.url.includes("/v1/candidate")
       ? `<Candidate Total="1" Count="1" Start="0"><Code>0</Code><Item><Person.P_Id>1</Person.P_Id><Person.P_Name>山田 太郎</Person.P_Name></Item></Candidate>`
@@ -111,7 +112,7 @@ const porters = new PortersClient({
   ), // 未モックのリクエストは明示エラー（フェイルセーフ）
 });
 
-const page = await porters.candidate.search();
+const page = await t.candidate.search();
 console.log(page.items[0]?.P_Name); // 山田 太郎
 ```
 
@@ -141,7 +142,7 @@ const tokenStore: TokenStore = {
     /* 破棄 */
   },
 };
-new PortersClient({ host, appId, appSecret, partition, tokenStore });
+new PortersClient({ host, appId, appSecret, tokenStore });
 ```
 
 `transport`（HTTP 注入）や `auth`（独自 `TokenProvider`）も差し替え可能です。
@@ -166,26 +167,29 @@ await porters.auth.exchangeAuthorizationCode(code);
 
 すべてのデータ系リソースは同じ形のアクセサを持ちます。
 
-| アクセサ             | リソース     | メソッド                                             |
-| -------------------- | ------------ | ---------------------------------------------------- |
-| `porters.candidate`  | 個人連絡先   | `search` / `searchAll` / `get` / `create` / `update` |
-| `porters.job`        | JOB          | `search` / `searchAll` / `get` / `create` / `update` |
-| `porters.client`     | 企業         | `search` / `searchAll` / `get` / `create` / `update` |
-| `porters.process`    | 選考プロセス | `search` / `searchAll` / `get` / `create` / `update` |
-| `porters.resume`     | レジュメ     | `search` / `searchAll` / `get` / `create` / `update` |
-| `porters.attachment` | 添付ファイル | `search` / `get` / `create` / `update`               |
+| アクセサ       | リソース     | メソッド                                             |
+| -------------- | ------------ | ---------------------------------------------------- |
+| `t.candidate`  | 個人連絡先   | `search` / `searchAll` / `get` / `create` / `update` |
+| `t.job`        | JOB          | `search` / `searchAll` / `get` / `create` / `update` |
+| `t.client`     | 企業         | `search` / `searchAll` / `get` / `create` / `update` |
+| `t.process`    | 選考プロセス | `search` / `searchAll` / `get` / `create` / `update` |
+| `t.resume`     | レジュメ     | `search` / `searchAll` / `get` / `create` / `update` |
+| `t.attachment` | 添付ファイル | `search` / `get` / `create` / `update`               |
 
 - `search(query?)` → `{ items, total, count, start }`（オフセット式ページング）。
 - `searchAll(query?)` → `AsyncIterable`（200 件刻みで全件 yield）。
-- `get(id)` → 1 件 or `undefined`。
+- `get(id, options?)` → 1 件 or `undefined`（`options.expand` で参照先の項目も読めます）。
 - `create(input)` → 採番された **id（number）**。
 - `update(id, input)` → その **id**。
 
 **検索クエリ**（`query`）の主なキー（すべて型安全。**項目の Data Type が許す演算子だけ**を受けます）：
 
-- `field`：取得する項目（接頭辞付き alias の配列。例 `["Person.P_Id", "Person.P_Name"]`）。
+- `field`：取得する項目（**接頭辞なし**の alias の配列。例 `["P_Id", "P_Name"]`。接頭辞はライブラリが付けます）。
+  綴り間違いや接頭辞付きは**コンパイルエラー**になります。
   **省略するとカタログ上の全項目を既定取得**します（PORTERS は field 未指定だと主キーのみ返すため、
   ライブラリが既定 field を補います）。`field: []`（空配列）を渡すと API 仕様どおり**主キーのみ**を返します（件数取得など）。
+- `expand`：参照型（`System[Reference]`）の項目について、**参照先の項目も読む**（`{ P_Client: ["P_Id", "P_Name"] }`）。
+  書かなければ従来どおり**参照先の ID**が返り、**書いた項目だけ**戻り型が参照レコードに変わります。1 往復で済みます。
 - `condition`：検索条件。`{ 項目: { 演算子: 値 } }` 形式（複数項目は AND）。演算子は Data Type ごとに
   `eq`/`gt`/`ge`/`le`/`lt`（数値・日時・Id）、`part`/`full`（テキスト）、`or`/`and`（Option・参照/ユーザー型は ID）。
   **日時の値は ISO 8601（UTC `…Z`）**で渡すと PORTERS 形式へ自動変換します。
@@ -197,8 +201,9 @@ await porters.auth.exchangeAuthorizationCode(code);
 > **削除 API はありません**（PORTERS 仕様）。`delete()` メソッドは提供しません。削除済みは `itemstate: "deleted"` で読みます
 > （`condition` は `P_Id` / `P_UpdateDate` / `P_UpdatedBy` に限られ、更新日は 90 日以内）。
 >
-> `field` の 3 通りの意味（省略＝全項目 / `[]`＝主キーのみ / 明示）、Data Type ごとの演算子一覧、
-> 削除済み Read の制約、送信前に落ちる条件は [Read クエリ ガイド][read-query-guide] にまとめています。
+> `field` の 3 通りの意味（省略＝全項目 / `[]`＝主キーのみ / 明示）、`expand` で展開できる項目、
+> Data Type ごとの演算子一覧、削除済み Read の制約、送信前に落ちる条件は
+> [Read クエリ ガイド][read-query-guide] にまとめています。
 
 ### カスタム項目（`U_` / `A_`）
 
@@ -214,11 +219,10 @@ const porters = new PortersClient({
   host,
   appId,
   appSecret,
-  partition,
   fields,
 });
 
-const one = await porters.candidate.get(10001);
+const one = await t.candidate.get(10001);
 one?.U_score; // number | null | undefined
 ```
 
@@ -234,25 +238,25 @@ one?.U_score; // number | null | undefined
 | アクセサ            | リソース          | メソッド                           | 主なクエリ                                |
 | ------------------- | ----------------- | ---------------------------------- | ----------------------------------------- |
 | `porters.partition` | Partition         | `search` / `searchAll`             | `requestType`（1=アクセス可能一覧・既定） |
-| `porters.user`      | User              | `search` / `searchAll` / `current` | `requestType` / `userType` / `field`      |
-| `porters.field`     | Field（項目定義） | `search` / `searchAll`             | `resource`（必須）/ `active`              |
-| `porters.option`    | Option（選択肢）  | `search`                           | `alias` / `level` / `enabled`             |
+| `t.user`            | User              | `search` / `searchAll` / `current` | `requestType` / `userType` / `field`      |
+| `t.field`           | Field（項目定義） | `search` / `searchAll`             | `resource`（必須）/ `active`              |
+| `t.option`          | Option（選択肢）  | `search`                           | `alias` / `level` / `enabled`             |
 
 ```ts
 // アクセス可能な Partition（Company DB）を発見
 const partitions = await porters.partition.search();
 
 // 現在の API ユーザー（code_direct ではアプリ自身の User）＝自己同定
-const me = await porters.user.current();
+const me = await t.user.current();
 
 // Job リソースの項目定義（U_/A_ カスタム項目を含む）を取得
-const fields = await porters.field.search({ resource: "job" });
+const fields = await t.field.search({ resource: "job" });
 
 // 選択肢マスタをフラットな配列で取得（親子は P_ParentId で復元）
-const options = await porters.option.search({ alias: "Option.P_Gender" });
+const options = await t.option.search({ alias: "Option.P_Gender" });
 ```
 
-- `porters.option.search()` は入れ子の選択肢ツリーを**深さ優先でフラット化**して返します（全ノード・`P_ParentId`/`P_Order` で階層復元可）。`start` が無いため `searchAll` はありません。
+- `t.option.search()` は入れ子の選択肢ツリーを**深さ優先でフラット化**して返します（全ノード・`P_ParentId`/`P_Order` で階層復元可）。`start` が無いため `searchAll` はありません。
 - `porters.partition.current()` は提供しません（`request_type=0` は既定の `code_direct` 認証では 403 になるため）。一覧は `search()`（既定 `requestType: 1`）で取得します。
 
 ## 読み取り値の表現
@@ -272,7 +276,7 @@ PORTERS の Field Type に応じてデコードされます。
 | 空・未設定                                          | `null`                                          |
 
 ```ts
-const c = await porters.candidate.get(10001);
+const c = await t.candidate.get(10001);
 c?.P_Id; // number
 c?.P_Name; // string | null
 c?.P_RegistrationDate; // "2026-01-02T03:04:05Z" | null
@@ -295,17 +299,17 @@ c?.P_Owner; // { P_Id, P_Name, ... } | null
 
 ```ts
 // 作成（新規）
-const newId = await porters.candidate.create({
+const newId = await t.candidate.create({
   P_Owner: 5, // User 項目は id
   P_Name: "鈴木 一郎",
   P_Reading: "すずき いちろう",
 });
 
 // 更新
-await porters.candidate.update(newId, { P_Mail: "ichiro@example.com" });
+await t.candidate.update(newId, { P_Mail: "ichiro@example.com" });
 
 // 選考プロセス（関連 id を指定）
-await porters.process.create({
+await t.process.create({
   P_Owner: 1,
   P_Client: 100,
   P_Recruiter: 200,
@@ -315,7 +319,7 @@ await porters.process.create({
 });
 
 // 一括作成／更新（200 件＋サイズで自動分割・部分成功を返す）
-const bulk = await porters.candidate.createMany([
+const bulk = await t.candidate.createMany([
   { P_Owner: 5, P_Name: "山田 太郎" },
   { P_Owner: 5, P_Name: "鈴木 花子" },
 ]);
@@ -331,7 +335,7 @@ if (bulk.hasFailures) console.warn(bulk.failed); // per-item は throw せず結
 ```ts
 import { bytesToBase64 } from "@joymerrevent/porters-connect";
 
-const id = await porters.attachment.create({
+const id = await t.attachment.create({
   resource: 17, // 関連リソース種別コード（Resource List 参照）
   resourceId: 10001, // 関連レコードの id
   contentType: "application/pdf",
@@ -351,7 +355,7 @@ const id = await porters.attachment.create({
 import { PortersError } from "@joymerrevent/porters-connect";
 
 try {
-  await porters.candidate.get(1);
+  await t.candidate.get(1);
 } catch (e) {
   if (e instanceof PortersError) {
     e.category; // "auth" | "permission" | "notFound" | "conflict" | "network" | ...
@@ -365,7 +369,7 @@ try {
 
 - トークン失効は内側で自動回復します。設定ミスは `PortersConfigError` で早期に落とします。
 - **`Promise` を返す公開メソッドは同期 throw しません**（[ADR-0046][adr46]）。設定ミスも含め常に **reject** で届くので、
-  `porters.candidate.search(q).catch(handler)` でも捕まえられます（`string` を返す `auth.authorizationUrl` や
+  `t.candidate.search(q).catch(handler)` でも捕まえられます（`string` を返す `auth.authorizationUrl` や
   コンストラクタなど、Promise を返さない API は同期 throw のままです）。
 - 一時エラー・ネットワークは内蔵リトライ。非冪等な `create` はネットワーク不確実時に握り潰さず表面化します。
 - レート制限超過時、PORTERS は判別可能なコードを返さず接続を切るため、`PortersNetworkError`（category `"network"`）として表面化します。