@joymerrevent/porters-connect 0.19.1 → 0.20.0

package/CHANGELOG.md

@@ -5,6 +5,72 @@
 
 ## [Unreleased]
 
+## [0.20.0] - 2026-09-21
+
+**PORTERS ヘルプセンターを再取得して見つかった、追いついていなかった変更 2 つを埋めた版**です。
+破壊的変更はありません。
+
+2026-06 以来はじめて出典を取り直したところ、**Department - Read API**（2025/03・Connect API 8.2.1）が
+reference にも実装にも無く、**時分型**（2026/08・PORTERS 9.3.0）はライブラリが型として知らない
+状態でした。前者はマスタ 5 種目として実装し、後者は型を増やさず変換関数で扱います（[ADR-0086][adr86]）。
+
+### Added
+
+- **Department マスタの Read（`t.department`）**。ユーザー部署型（Link）項目や `User.P_Department` が
+  指す部署を、Partition 単位で一覧できます（[reference][ref-department]）。
+
+  ```ts
+  const t = porters.tenant(123);
+  const page = await t.department.search(); // { total, count, start, items }
+  for await (const d of t.department.searchAll()) {
+    d.P_Id;
+    d.P_Name;
+    d.P_Hidden;
+    d.P_SortNo;
+    d.P_RegistrationDate;
+    d.P_UpdateDate;
+  }
+  ```
+
+  - **読み取り専用**。PORTERS に Write API はありません（お知らせ記事が「read のみ」と明記）。
+  - クエリは `field` / `count` / `start` だけ。`condition` / `get(id)` / `request_type` はありません
+    （出典が挙げないものは公開しない — 他のマスタと同じ）。
+  - **スコープは `user_r`** です。PORTERS は `department_r` を定義していません。
+  - `field` 省略時は 6 項目すべてを要求します（省略すると PORTERS は `P_Id` しか返さないため）。
+    Link 参照からは読めない `P_Hidden` / `P_SortNo` / 登録日 / 更新日も、ここでは読めます。
+  - 型は `Department` / `DepartmentPage` / `DepartmentSearchQuery` / `DepartmentResource` を公開します。
+
+- **時分型（PORTERS 9.3.0）の項目を扱う変換関数 `decodeTimeOfDay` / `encodeTimeOfDay`**（[ADR-0086][adr86]）。
+  時分型は時刻だけ（`00:00`〜`47:59`）を持つカスタム項目ですが、API 上は年月日時分型と同じ
+  `DateTime`（Field Type 12）で、`1970/01/01` を基準日にした日時として運ばれます（`26:00` は
+  `1970/01/02 02:00:00`）。Field Read からも区別できないため、ライブラリは**型を増やさず**、時分型の
+  項目も `f.dateTime()` のまま宣言して ISO で読み書きします。基準日の規則は、その項目が時分型だと
+  知っているところで変換関数に任せます。
+
+  ```ts
+  const job = await t.job.get(1);
+  const start =
+    job?.U_startTime == null ? null : decodeTimeOfDay(job.U_startTime); // "09:00"
+  await t.job.update(1, { U_startTime: encodeTimeOfDay("26:00") }); // → 1970/01/02 02:00:00
+  await t.job.search({
+    condition: { U_startTime: { ge: encodeTimeOfDay("15:00") } },
+  });
+  ```
+
+  - `encodeTimeOfDay` は `"HH:mm"` / `"HH:mm:ss"`（00:00〜47:59）以外を `PortersConfigError`
+    （`category: "validation"`）で**送る前に**止めます（PORTERS の Code 103 / Code 100 を手前で）。
+  - `decodeTimeOfDay` は基準日以外の ISO を同じエラーで止めます（その項目はたぶん時分型ではない、
+    というヒント付き）。秒が `00` でなければ `"HH:mm:ss"` で保持します。
+  - 既存の型・宣言・読み書きは変わりません。変換を呼ぶかどうかは利用者の責務です。
+
+### Changed
+
+- **`generateFieldDecls` が Field Type 12 の行に注記を出すようになりました**
+  （`f.dateTime(), // FT-12: …`）。時分型は年月日時分型と同じ `12` で Field Read からは区別できないため、
+  宣言が生まれる場所で「時刻だけの項目なら変換関数を」と伝えます。
+- 開発用のフェイクサーバー（npm には同梱しません）に `departments` オプションと `/v1/department` を
+  足しました。
+
 ## [0.19.1] - 2026-09-20
 
 **定期レビューで見つけた 7 件を塞いだ版**です。破壊的変更はありません。公開 API の形は変わらず、
@@ -1129,7 +1195,8 @@ Attachment）あるのに、受け口の形が 3 つとも違っていました
 [ref]: docs/usage/reference/README.md
 [kac]: https://keepachangelog.com/en/1.1.0/
 [semver]: https://semver.org/
-[unreleased]: https://github.com/Joymerrevent/porters-connect/compare/v0.19.1...HEAD
+[unreleased]: https://github.com/Joymerrevent/porters-connect/compare/v0.20.0...HEAD
+[0.20.0]: https://github.com/Joymerrevent/porters-connect/compare/v0.19.1...v0.20.0
 [0.19.1]: https://github.com/Joymerrevent/porters-connect/compare/v0.19.0...v0.19.1
 [0.19.0]: https://github.com/Joymerrevent/porters-connect/compare/v0.18.0...v0.19.0
 [0.18.0]: https://github.com/Joymerrevent/porters-connect/compare/v0.17.0...v0.18.0
@@ -1162,3 +1229,5 @@ Attachment）あるのに、受け口の形が 3 つとも違っていました
 [gh4]: https://github.com/advisories/GHSA-4mjr-xmp4-gh2g
 [gh5]: https://github.com/advisories/GHSA-7w5x-hrqm-74c2
 [fastcheck]: https://github.com/dubzzz/fast-check
+[adr86]: docs/adr/0086-time-of-day-fields.md
+[ref-department]: docs/usage/reference/resource-api/resources/department.md

package/README.md

@@ -21,7 +21,7 @@ XML レスポンスを型付きオブジェクトに変換し、独自仕様の
 - **独自 OAuth を透過**：`code_direct` によるトークン取得・キャッシュ・更新を自動化。
 - **上限内に自制する**：スロットリング・リトライ（指数バックオフ）・リクエストサイズガード内蔵。
 - **日時は ISO 8601（UTC）に正規化**。業務タイムゾーン変換はしません（利用側の責務）。
-- **PORTERS の全リソースに対応**：データ系 13 種 ＋ Phase ＋ マスタ Read 4 種。
+- **PORTERS の全リソースに対応**：データ系 13 種 ＋ Phase ＋ マスタ Read 5 種。
 
 ## 前提
 
@@ -87,7 +87,7 @@ console.log(page.total, page.items[0]?.P_Name);
 | `t.opportunity` | 商談管理       | `t.phase`      | フェーズ履歴 |
 | `t.activity`    | アクティビティ |                |              |
 
-マスタ Read は `porters.partition` / `t.user` / `t.field` / `t.option` の 4 種（読み取り専用）。
+マスタ Read は `porters.partition` / `t.user` / `t.department` / `t.field` / `t.option` の 5 種（読み取り専用）。
 
 **どのメソッドが呼べるかはリソースごとに違います**（`searchAll` が無いもの、先に `of()` で
 束ねるものがあります）。一覧は[リソースと操作][docs-resources]、引数・戻り値・項目の一覧は

package/dist/index.d.cts

@@ -746,7 +746,7 @@ Bound extends WritableKeys<F> = never> = {
     }[]): Promise<BulkWriteResult>;
 };
 
-declare const FIELDS$f: {
+declare const FIELDS$g: {
     readonly P_Id: "System[Id]";
     readonly P_Owner: "User";
     readonly P_RegistrationDate: "System[DateTime]";
@@ -773,17 +773,17 @@ declare const FIELDS$f: {
 };
 declare const REQUIRED_ON_CREATE$b: readonly ["P_Owner"];
 /** A decoded Candidate: known `P_` fields, each requested field `value | null`. */
-type Candidate = ReadRecord<typeof FIELDS$f>;
-type CandidatePage = ResourcePage<typeof FIELDS$f>;
-type CandidateSearchQuery = SearchQuery<typeof FIELDS$f>;
+type Candidate = ReadRecord<typeof FIELDS$g>;
+type CandidatePage = ResourcePage<typeof FIELDS$g>;
+type CandidateSearchQuery = SearchQuery<typeof FIELDS$g>;
 /** Fields for `create`: `P_Owner` is required; `P_Id` / system timestamps are not settable. */
-type CandidateCreateInput = CreateInput<typeof FIELDS$f, (typeof REQUIRED_ON_CREATE$b)[number]>;
+type CandidateCreateInput = CreateInput<typeof FIELDS$g, (typeof REQUIRED_ON_CREATE$b)[number]>;
 /** Fields for `update`: all optional (`null` omits, `""` clears a text field). */
-type CandidateUpdateInput = UpdateInput<typeof FIELDS$f>;
+type CandidateUpdateInput = UpdateInput<typeof FIELDS$g>;
 /** The Candidate accessor; `C` is the declared custom-field catalog merged on (ADR-0023). */
-type CandidateResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$f & C, (typeof REQUIRED_ON_CREATE$b)[number]>;
+type CandidateResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$g & C, (typeof REQUIRED_ON_CREATE$b)[number]>;
 
-declare const FIELDS$e: {
+declare const FIELDS$f: {
     readonly P_Id: "System[Id]";
     readonly P_Owner: "User";
     readonly P_Client: "System[Reference]";
@@ -911,17 +911,17 @@ declare const REFERENCES$7: {
     };
 };
 /** A decoded Job: known `P_` fields, each requested field `value | null`. */
-type Job = ReadRecord<typeof FIELDS$e>;
-type JobPage = ResourcePage<typeof FIELDS$e>;
-type JobSearchQuery = SearchQuery<typeof FIELDS$e, typeof REFERENCES$7>;
+type Job = ReadRecord<typeof FIELDS$f>;
+type JobPage = ResourcePage<typeof FIELDS$f>;
+type JobSearchQuery = SearchQuery<typeof FIELDS$f, typeof REFERENCES$7>;
 /** Fields for `create`: `P_Owner` required; `P_Id` / system timestamps are not settable. */
-type JobCreateInput = CreateInput<typeof FIELDS$e, (typeof REQUIRED_ON_CREATE$a)[number]>;
+type JobCreateInput = CreateInput<typeof FIELDS$f, (typeof REQUIRED_ON_CREATE$a)[number]>;
 /** Fields for `update`: all optional (`null` omits, `""` clears a text field). */
-type JobUpdateInput = UpdateInput<typeof FIELDS$e>;
+type JobUpdateInput = UpdateInput<typeof FIELDS$f>;
 /** The Job accessor; `C` is the declared custom-field catalog merged on (ADR-0023). */
-type JobResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$e & C, (typeof REQUIRED_ON_CREATE$a)[number], typeof REFERENCES$7>;
+type JobResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$f & C, (typeof REQUIRED_ON_CREATE$a)[number], typeof REFERENCES$7>;
 
-declare const FIELDS$d: {
+declare const FIELDS$e: {
     readonly P_Id: "System[Id]";
     readonly P_Owner: "User";
     readonly P_RegistrationDate: "System[DateTime]";
@@ -944,17 +944,17 @@ declare const FIELDS$d: {
 };
 declare const REQUIRED_ON_CREATE$9: readonly ["P_Owner"];
 /** A decoded Client (company): known `P_` fields, each requested field `value | null`. */
-type Client = ReadRecord<typeof FIELDS$d>;
-type ClientPage = ResourcePage<typeof FIELDS$d>;
-type ClientSearchQuery = SearchQuery<typeof FIELDS$d>;
+type Client = ReadRecord<typeof FIELDS$e>;
+type ClientPage = ResourcePage<typeof FIELDS$e>;
+type ClientSearchQuery = SearchQuery<typeof FIELDS$e>;
 /** Fields for `create`: `P_Owner` required; `P_Id` / system timestamps are not settable. */
-type ClientCreateInput = CreateInput<typeof FIELDS$d, (typeof REQUIRED_ON_CREATE$9)[number]>;
+type ClientCreateInput = CreateInput<typeof FIELDS$e, (typeof REQUIRED_ON_CREATE$9)[number]>;
 /** Fields for `update`: all optional (`null` omits, `""` clears a text field). */
-type ClientUpdateInput = UpdateInput<typeof FIELDS$d>;
+type ClientUpdateInput = UpdateInput<typeof FIELDS$e>;
 /** The Client accessor; `C` is the declared custom-field catalog merged on (ADR-0023). */
-type ClientResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$d & C, (typeof REQUIRED_ON_CREATE$9)[number]>;
+type ClientResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$e & C, (typeof REQUIRED_ON_CREATE$9)[number]>;
 
-declare const FIELDS$c: {
+declare const FIELDS$d: {
     readonly P_Id: "System[Id]";
     readonly P_Owner: "User";
     readonly P_Client: "System[Reference]";
@@ -1012,17 +1012,17 @@ declare const REFERENCES$6: {
     };
 };
 /** A decoded Recruiter (a person at a client company): known `P_` fields, each `value | null`. */
-type Recruiter = ReadRecord<typeof FIELDS$c>;
-type RecruiterPage = ResourcePage<typeof FIELDS$c>;
-type RecruiterSearchQuery = SearchQuery<typeof FIELDS$c, typeof REFERENCES$6>;
+type Recruiter = ReadRecord<typeof FIELDS$d>;
+type RecruiterPage = ResourcePage<typeof FIELDS$d>;
+type RecruiterSearchQuery = SearchQuery<typeof FIELDS$d, typeof REFERENCES$6>;
 /** Fields for `create`: `P_Owner` / `P_Client` required; `P_Id` / system timestamps are not settable. */
-type RecruiterCreateInput = CreateInput<typeof FIELDS$c, (typeof REQUIRED_ON_CREATE$8)[number]>;
+type RecruiterCreateInput = CreateInput<typeof FIELDS$d, (typeof REQUIRED_ON_CREATE$8)[number]>;
 /** Fields for `update`: all optional (`null` omits, `""` clears a text field). */
-type RecruiterUpdateInput = UpdateInput<typeof FIELDS$c>;
+type RecruiterUpdateInput = UpdateInput<typeof FIELDS$d>;
 /** The Recruiter accessor; `C` is the declared custom-field catalog merged on (ADR-0023). */
-type RecruiterResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$c & C, (typeof REQUIRED_ON_CREATE$8)[number], typeof REFERENCES$6>;
+type RecruiterResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$d & C, (typeof REQUIRED_ON_CREATE$8)[number], typeof REFERENCES$6>;
 
-declare const FIELDS$b: {
+declare const FIELDS$c: {
     readonly P_Id: "System[Id]";
     readonly P_Owner: "User";
     readonly P_Client: "System[Reference]";
@@ -1080,17 +1080,17 @@ declare const REFERENCES$5: {
     };
 };
 /** A decoded Contact (a contact person at a client company): known `P_` fields, each `value | null`. */
-type Contact = ReadRecord<typeof FIELDS$b>;
-type ContactPage = ResourcePage<typeof FIELDS$b>;
-type ContactSearchQuery = SearchQuery<typeof FIELDS$b, typeof REFERENCES$5>;
+type Contact = ReadRecord<typeof FIELDS$c>;
+type ContactPage = ResourcePage<typeof FIELDS$c>;
+type ContactSearchQuery = SearchQuery<typeof FIELDS$c, typeof REFERENCES$5>;
 /** Fields for `create`: `P_Owner` / `P_Client` required; `P_Id` / system timestamps are not settable. */
-type ContactCreateInput = CreateInput<typeof FIELDS$b, (typeof REQUIRED_ON_CREATE$7)[number]>;
+type ContactCreateInput = CreateInput<typeof FIELDS$c, (typeof REQUIRED_ON_CREATE$7)[number]>;
 /** Fields for `update`: all optional (`null` omits, `""` clears a text field). */
-type ContactUpdateInput = UpdateInput<typeof FIELDS$b>;
+type ContactUpdateInput = UpdateInput<typeof FIELDS$c>;
 /** The Contact accessor; `C` is the declared custom-field catalog merged on (ADR-0023). */
-type ContactResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$b & C, (typeof REQUIRED_ON_CREATE$7)[number], typeof REFERENCES$5>;
+type ContactResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$c & C, (typeof REQUIRED_ON_CREATE$7)[number], typeof REFERENCES$5>;
 
-declare const FIELDS$a: {
+declare const FIELDS$b: {
     readonly P_Id: "System[Id]";
     readonly P_Owner: "User";
     readonly P_Client: "System[Reference]";
@@ -1195,17 +1195,17 @@ declare const REFERENCES$4: {
     };
 };
 /** A decoded Opportunity (a sales opportunity): known `P_` fields, each `value | null`. */
-type Opportunity = ReadRecord<typeof FIELDS$a>;
-type OpportunityPage = ResourcePage<typeof FIELDS$a>;
-type OpportunitySearchQuery = SearchQuery<typeof FIELDS$a, typeof REFERENCES$4>;
+type Opportunity = ReadRecord<typeof FIELDS$b>;
+type OpportunityPage = ResourcePage<typeof FIELDS$b>;
+type OpportunitySearchQuery = SearchQuery<typeof FIELDS$b, typeof REFERENCES$4>;
 /** Fields for `create`: owner and both references required; `P_Id` / timestamps are not settable. */
-type OpportunityCreateInput = CreateInput<typeof FIELDS$a, (typeof REQUIRED_ON_CREATE$6)[number]>;
+type OpportunityCreateInput = CreateInput<typeof FIELDS$b, (typeof REQUIRED_ON_CREATE$6)[number]>;
 /** Fields for `update`: all optional (`null` omits, `""` clears a text field). */
-type OpportunityUpdateInput = UpdateInput<typeof FIELDS$a>;
+type OpportunityUpdateInput = UpdateInput<typeof FIELDS$b>;
 /** The Opportunity accessor; `C` is the declared custom-field catalog merged on (ADR-0023). */
-type OpportunityResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$a & C, (typeof REQUIRED_ON_CREATE$6)[number], typeof REFERENCES$4>;
+type OpportunityResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$b & C, (typeof REQUIRED_ON_CREATE$6)[number], typeof REFERENCES$4>;
 
-declare const FIELDS$9: {
+declare const FIELDS$a: {
     readonly P_Id: "System[Id]";
     readonly P_Owner: "User";
     readonly P_Title: "SinglelineText";
@@ -1227,17 +1227,17 @@ declare const FIELDS$9: {
 };
 declare const REQUIRED_ON_CREATE$5: readonly ["P_Owner", "P_Title"];
 /** A decoded Activity (an action logged against another record): known `P_` fields, each `value | null`. */
-type Activity = ReadRecord<typeof FIELDS$9>;
-type ActivityPage = ResourcePage<typeof FIELDS$9>;
-type ActivitySearchQuery = SearchQuery<typeof FIELDS$9>;
+type Activity = ReadRecord<typeof FIELDS$a>;
+type ActivityPage = ResourcePage<typeof FIELDS$a>;
+type ActivitySearchQuery = SearchQuery<typeof FIELDS$a>;
 /** Fields for `create`: `P_Owner` / `P_Title` required; `P_Id` / timestamps are not settable. */
-type ActivityCreateInput = CreateInput<typeof FIELDS$9, (typeof REQUIRED_ON_CREATE$5)[number]>;
+type ActivityCreateInput = CreateInput<typeof FIELDS$a, (typeof REQUIRED_ON_CREATE$5)[number]>;
 /** Fields for `update`: all optional (`null` omits, `""` clears a text field). */
-type ActivityUpdateInput = UpdateInput<typeof FIELDS$9>;
+type ActivityUpdateInput = UpdateInput<typeof FIELDS$a>;
 /** The Activity accessor; `C` is the declared custom-field catalog merged on (ADR-0023). */
-type ActivityResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$9 & C, (typeof REQUIRED_ON_CREATE$5)[number]>;
+type ActivityResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$a & C, (typeof REQUIRED_ON_CREATE$5)[number]>;
 
-declare const FIELDS$8: {
+declare const FIELDS$9: {
     readonly P_Id: "System[Id]";
     readonly P_Client: "System[Reference]";
     readonly P_RegistrationDate: "System[DateTime]";
@@ -1308,17 +1308,17 @@ declare const REFERENCES$3: {
     };
 };
 /** A decoded Contract (an agreement with a client): known `P_` fields, each `value | null`. */
-type Contract = ReadRecord<typeof FIELDS$8>;
-type ContractPage = ResourcePage<typeof FIELDS$8>;
-type ContractSearchQuery = SearchQuery<typeof FIELDS$8, typeof REFERENCES$3>;
+type Contract = ReadRecord<typeof FIELDS$9>;
+type ContractPage = ResourcePage<typeof FIELDS$9>;
+type ContractSearchQuery = SearchQuery<typeof FIELDS$9, typeof REFERENCES$3>;
 /** Fields for `create`: only `P_Client` required (Contract has no owner field). */
-type ContractCreateInput = CreateInput<typeof FIELDS$8, (typeof REQUIRED_ON_CREATE$4)[number]>;
+type ContractCreateInput = CreateInput<typeof FIELDS$9, (typeof REQUIRED_ON_CREATE$4)[number]>;
 /** Fields for `update`: all optional (`null` omits, `""` clears a text field). */
-type ContractUpdateInput = UpdateInput<typeof FIELDS$8>;
+type ContractUpdateInput = UpdateInput<typeof FIELDS$9>;
 /** The Contract accessor; `C` is the declared custom-field catalog merged on (ADR-0023). */
-type ContractResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$8 & C, (typeof REQUIRED_ON_CREATE$4)[number], typeof REFERENCES$3>;
+type ContractResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$9 & C, (typeof REQUIRED_ON_CREATE$4)[number], typeof REFERENCES$3>;
 
-declare const FIELDS$7: {
+declare const FIELDS$8: {
     readonly P_Id: "System[Id]";
     readonly P_Owner: "User";
     readonly P_Client: "System[Reference]";
@@ -1744,19 +1744,19 @@ declare const REFERENCES$2: {
     };
 };
 /** A decoded Sales (a placement / revenue record): known `P_` fields, each `value | null`. */
-type Sales = ReadRecord<typeof FIELDS$7>;
-type SalesPage = ResourcePage<typeof FIELDS$7>;
-type SalesSearchQuery = SearchQuery<typeof FIELDS$7, typeof REFERENCES$2>;
+type Sales = ReadRecord<typeof FIELDS$8>;
+type SalesPage = ResourcePage<typeof FIELDS$8>;
+type SalesSearchQuery = SearchQuery<typeof FIELDS$8, typeof REFERENCES$2>;
 /**
  * Fields for `create`: only `P_Owner` is unconditionally required. The six references are
  * required *conditionally* (a dependency chain PORTERS validates server-side), so they stay
  * optional here (ADR-0083) — see the module comment and docs/usage/concepts/limits.md.
  */
-type SalesCreateInput = CreateInput<typeof FIELDS$7, (typeof REQUIRED_ON_CREATE$3)[number]>;
+type SalesCreateInput = CreateInput<typeof FIELDS$8, (typeof REQUIRED_ON_CREATE$3)[number]>;
 /** Fields for `update`: all optional (`null` omits, `""` clears a text field). */
-type SalesUpdateInput = UpdateInput<typeof FIELDS$7>;
+type SalesUpdateInput = UpdateInput<typeof FIELDS$8>;
 /** The Sales accessor; `C` is the declared custom-field catalog merged on (ADR-0023). */
-type SalesResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$7 & C, (typeof REQUIRED_ON_CREATE$3)[number], typeof REFERENCES$2>;
+type SalesResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$8 & C, (typeof REQUIRED_ON_CREATE$3)[number], typeof REFERENCES$2>;
 
 /** Resource name -> the numeric id PORTERS uses for it (docs/usage/reference resources-list.md). */
 declare const RESOURCE_VALUES: {
@@ -1809,7 +1809,7 @@ declare const resourceValueOf: (name: ResourceName) => number;
  */
 declare const resourceNameOf: (value: number) => ResourceName | number;
 
-declare const FIELDS$6: {
+declare const FIELDS$7: {
     readonly Id: "System[Id]";
     readonly Resource: "Number";
     readonly ResourceId: "Number";
@@ -1830,27 +1830,27 @@ declare const FIELDS$6: {
 };
 declare const REQUIRED_ON_CREATE$2: readonly ["ResourceId"];
 /** A decoded Phase entry: known aliases, each requested field `value | null`. */
-type Phase = ReadRecord<typeof FIELDS$6>;
-type PhasePage = ResourcePage<typeof FIELDS$6>;
+type Phase = ReadRecord<typeof FIELDS$7>;
+type PhasePage = ResourcePage<typeof FIELDS$7>;
 type PhaseUnsupportedQuery = "keywords" | "itemstate";
 /**
  * Phase's Read query: the common vocabulary **minus `keywords` / `itemstate`**, which
  * `Phase - Read` does not list (ADR-0076).
  */
-type PhaseSearchQuery = Omit<SearchQuery<typeof FIELDS$6>, PhaseUnsupportedQuery> & {
+type PhaseSearchQuery = Omit<SearchQuery<typeof FIELDS$7>, PhaseUnsupportedQuery> & {
     [K in PhaseUnsupportedQuery]?: never;
 };
 /** Fields for `create`: `ResourceId` required (`Id` and `Resource` are supplied for you). */
-type PhaseCreateInput = CreateInput<typeof FIELDS$6, (typeof REQUIRED_ON_CREATE$2)[number]>;
+type PhaseCreateInput = CreateInput<typeof FIELDS$7, (typeof REQUIRED_ON_CREATE$2)[number]>;
 /** Fields for `update`: all optional (`null` omits, `""` clears a text field). */
-type PhaseUpdateInput = UpdateInput<typeof FIELDS$6>;
+type PhaseUpdateInput = UpdateInput<typeof FIELDS$7>;
 /**
  * The Phase accessor for one bound resource — the same shape as every other resource, except that
  * `search` / `searchAll` do not take `keywords` / `itemstate` (ADR-0076) and the write inputs do
  * not take `Resource`: `of()` binds it, and supplying it again could only contradict the binding
  * (RV-47).
  */
-type PhaseResource = Resource<typeof FIELDS$6, (typeof REQUIRED_ON_CREATE$2)[number], EmptyReferences, PhaseUnsupportedQuery, "Resource">;
+type PhaseResource = Resource<typeof FIELDS$7, (typeof REQUIRED_ON_CREATE$2)[number], EmptyReferences, PhaseUnsupportedQuery, "Resource">;
 /**
  * Phase is reached through the resource whose history you want (ADR-0061 案2a):
  *
@@ -1866,7 +1866,7 @@ type PhaseAccessor = {
     of(resource: ResourceName): PhaseResource;
 };
 
-declare const FIELDS$5: {
+declare const FIELDS$6: {
     readonly P_Id: "System[Id]";
     readonly P_Owner: "User";
     readonly P_Client: "System[Reference]";
@@ -2210,17 +2210,17 @@ declare const REFERENCES$1: {
 };
 /** A decoded Process (a Candidate's progress through a Job): known `P_` fields, each
  *  requested field `value | null`. */
-type Process = ReadRecord<typeof FIELDS$5>;
-type ProcessPage = ResourcePage<typeof FIELDS$5>;
-type ProcessSearchQuery = SearchQuery<typeof FIELDS$5, typeof REFERENCES$1>;
+type Process = ReadRecord<typeof FIELDS$6>;
+type ProcessPage = ResourcePage<typeof FIELDS$6>;
+type ProcessSearchQuery = SearchQuery<typeof FIELDS$6, typeof REFERENCES$1>;
 /** Fields for `create`: `P_Owner` required; `P_Id` / system timestamps are not settable. */
-type ProcessCreateInput = CreateInput<typeof FIELDS$5, (typeof REQUIRED_ON_CREATE$1)[number]>;
+type ProcessCreateInput = CreateInput<typeof FIELDS$6, (typeof REQUIRED_ON_CREATE$1)[number]>;
 /** Fields for `update`: all optional (`null` omits, `""` clears a text field). */
-type ProcessUpdateInput = UpdateInput<typeof FIELDS$5>;
+type ProcessUpdateInput = UpdateInput<typeof FIELDS$6>;
 /** The Process accessor; `C` is the declared custom-field catalog merged on (ADR-0023). */
-type ProcessResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$5 & C, (typeof REQUIRED_ON_CREATE$1)[number], typeof REFERENCES$1>;
+type ProcessResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$6 & C, (typeof REQUIRED_ON_CREATE$1)[number], typeof REFERENCES$1>;
 
-declare const FIELDS$4: {
+declare const FIELDS$5: {
     readonly P_Id: "System[Id]";
     readonly P_Owner: "User";
     readonly P_Candidate: "System[Reference]";
@@ -2288,15 +2288,15 @@ declare const REFERENCES: {
 };
 /** A decoded Resume (a Candidate's CV / profile): known `P_` fields, each requested field
  *  `value | null`. */
-type Resume = ReadRecord<typeof FIELDS$4>;
-type ResumePage = ResourcePage<typeof FIELDS$4>;
-type ResumeSearchQuery = SearchQuery<typeof FIELDS$4, typeof REFERENCES>;
+type Resume = ReadRecord<typeof FIELDS$5>;
+type ResumePage = ResourcePage<typeof FIELDS$5>;
+type ResumeSearchQuery = SearchQuery<typeof FIELDS$5, typeof REFERENCES>;
 /** Fields for `create`: `P_Owner` required; `P_Id` / system timestamps are not settable. */
-type ResumeCreateInput = CreateInput<typeof FIELDS$4, (typeof REQUIRED_ON_CREATE)[number]>;
+type ResumeCreateInput = CreateInput<typeof FIELDS$5, (typeof REQUIRED_ON_CREATE)[number]>;
 /** Fields for `update`: all optional (`null` omits, `""` clears a text field). */
-type ResumeUpdateInput = UpdateInput<typeof FIELDS$4>;
+type ResumeUpdateInput = UpdateInput<typeof FIELDS$5>;
 /** The Resume accessor; `C` is the declared custom-field catalog merged on (ADR-0023). */
-type ResumeResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$4 & C, (typeof REQUIRED_ON_CREATE)[number], typeof REFERENCES>;
+type ResumeResource<C extends FieldCatalog = EmptyCatalog> = Resource<typeof FIELDS$5 & C, (typeof REQUIRED_ON_CREATE)[number], typeof REFERENCES>;
 
 /** A decoded Attachment. A field is `null` unless it was returned (see `field`). */
 type Attachment = {
@@ -2379,14 +2379,14 @@ type AttachmentResource = {
     update(id: number, input: AttachmentUpdate): Promise<number>;
 };
 
-declare const FIELDS$3: {
+declare const FIELDS$4: {
     readonly P_Id: "System[Id]";
     readonly P_Name: "SinglelineText";
     readonly P_CompanyId: "SinglelineText";
 };
 /** A decoded Partition (a PORTERS contract company / Company DB). */
-type Partition = ReadRecord<typeof FIELDS$3>;
-type PartitionPage = ResourcePage<typeof FIELDS$3>;
+type Partition = ReadRecord<typeof FIELDS$4>;
+type PartitionPage = ResourcePage<typeof FIELDS$4>;
 /** Partition Read query. `requestType` 1 = partitions this App can access (default). */
 type PartitionSearchQuery = {
     /** 1 = accessible partitions (default). 0 = login partition (browser `code` grant only). */
@@ -2400,7 +2400,7 @@ type PartitionResource = {
     searchAll(query?: Omit<PartitionSearchQuery, "count" | "start">): AsyncIterable<Partition>;
 };
 
-declare const FIELDS$2: {
+declare const FIELDS$3: {
     readonly P_Id: "System[Id]";
     readonly P_Type: "Number";
     readonly P_Name: "SinglelineText";
@@ -2420,8 +2420,8 @@ declare const FIELDS$2: {
     readonly P_UpdatedBy: "User";
 };
 /** A decoded User (PORTERS operator). `P_Type`: 0 = standard user, 1 = system admin. */
-type User = ReadRecord<typeof FIELDS$2>;
-type UserPage = ResourcePage<typeof FIELDS$2>;
+type User = ReadRecord<typeof FIELDS$3>;
+type UserPage = ResourcePage<typeof FIELDS$3>;
 /** User Read query. `requestType` 1 = all users (default); `userType` -1 = any (default). */
 type UserSearchQuery = {
     /** 1 = all users (default). 0 = the current user (code_direct → the App's own user). */
@@ -2434,7 +2434,7 @@ type UserSearchQuery = {
      * (department / telephone / dates) are not interesting. Pass `[]` for PORTERS' own default —
      * the 4 core fields it returns for a fieldless read.
      */
-    field?: ReadFieldAlias<typeof FIELDS$2>[];
+    field?: ReadFieldAlias<typeof FIELDS$3>[];
     count?: number;
     start?: number;
 };
@@ -2450,6 +2450,34 @@ type UserResource = {
     current(): Promise<User | undefined>;
 };
 
+declare const FIELDS$2: {
+    readonly P_Id: "System[Id]";
+    readonly P_Name: "SinglelineText";
+    readonly P_Hidden: "Number";
+    readonly P_SortNo: "Number";
+    readonly P_RegistrationDate: "System[DateTime]";
+    readonly P_UpdateDate: "System[DateTime]";
+};
+/** A decoded Department (a PORTERS user department). `P_Hidden`: 0 = shown, 1 = hidden. */
+type Department = ReadRecord<typeof FIELDS$2>;
+type DepartmentPage = ResourcePage<typeof FIELDS$2>;
+/** Department Read query. The API takes no filter: every department of the partition is listed. */
+type DepartmentSearchQuery = {
+    /**
+     * Output fields as **bare aliases** (`P_Name`); the library adds the `Department.` prefix
+     * (ADR-0059). **Omit** to fetch every catalogued field (ADR-0020). Pass `[]` for PORTERS' own
+     * default — `P_Id` alone, which is what a fieldless read returns.
+     */
+    field?: ReadFieldAlias<typeof FIELDS$2>[];
+    count?: number;
+    start?: number;
+};
+type DepartmentResource = {
+    search(query?: DepartmentSearchQuery): Promise<DepartmentPage>;
+    /** Auto-paginating search: yields every department of the partition. */
+    searchAll(query?: Omit<DepartmentSearchQuery, "count" | "start">): AsyncIterable<Department>;
+};
+
 /**
  * A resource whose field catalog can be read (Field Read `resource` selector).
  *
@@ -2890,6 +2918,12 @@ type TenantScope<C extends DeclaredCatalogs = EmptyCatalog> = {
      */
     readonly attachment: AttachmentAccessor;
     readonly user: UserResource;
+    /**
+     * Department master Read (Connect API 8.2.1+): the user departments a department-typed Link field
+     * or `User.P_Department` points at. Read-only, listed whole — no filter, no `get(id)`. Covered
+     * by the `user_r` scope (PORTERS defines no `department_r`).
+     */
+    readonly department: DepartmentResource;
     /**
      * Field master Read, reached through the resource whose catalog you want:
      * `t.field.of("candidate")`. PORTERS requires `resource=` on every Field Read, so it is bound
@@ -3003,4 +3037,42 @@ declare const bytesToBase64: (bytes: Uint8Array) => string;
 /** Decode a Base64 string back to raw bytes. */
 declare const base64ToBytes: (b64: string) => Uint8Array;
 
-export { type Activity, type ActivityCreateInput, type ActivityPage, type ActivityResource, type ActivitySearchQuery, type ActivityUpdateInput, type Attachment, type AttachmentAccessor, type AttachmentCreate, type AttachmentPage, type AttachmentResource, type AttachmentSearchQuery, type AttachmentUpdate, type AttachmentWalkQuery, type AuthApi, type AuthorizationUrlOptions, type BulkWriteResult, type BulkWriteResultItem, type Candidate, type CandidateCreateInput, type CandidatePage, type CandidateResource, type CandidateSearchQuery, type CandidateUpdateInput, type Client, type ClientCreateInput, type ClientPage, type ClientResource, type ClientSearchQuery, type ClientUpdateInput, type Condition, type Contact, type ContactCreateInput, type ContactPage, type ContactResource, type ContactSearchQuery, type ContactUpdateInput, type Contract, type ContractCreateInput, type ContractPage, type ContractResource, type ContractSearchQuery, type ContractUpdateInput, type CustomDataType, type CustomFieldResource, type CustomFor, type DeclaredCatalogs, type DefinedFields, type DepartmentRef, type ErrorCategory, type Expand, type ExpandedReadRecord, type FetchTransportOptions, type Field, type FieldAccessor, type FieldBuilder, type FieldCatalogSource, type FieldDecls, type FieldDef, type FieldPage, type FieldResource, type FieldSearchQuery, type FieldTypeMismatch, type FieldValue, type FieldVerification, type GenerateFieldDeclsOptions, type GetAccessTokenOptions, type ImageContentType, type ImageOption, type ImageReadRecord, type ImageSelectedValue, type ImageSubField, type ImageValue, type ImageWriteValue, type ItemState, type Job, type JobCreateInput, type JobPage, type JobResource, type JobSearchQuery, type JobUpdateInput, type LinkValue, type MissingField, type MockHandler, type MockReply, type MockTransportOptions, type Opportunity, type OpportunityCreateInput, type OpportunityPage, type OpportunityResource, type OpportunitySearchQuery, type OpportunityUpdateInput, type Option, type OptionResource, type OptionSearchQuery, type Order, type Partition, type PartitionId, type PartitionPage, type PartitionResource, type PartitionSearchQuery, type Phase, type PhaseAccessor, type PhaseCreateInput, type PhasePage, type PhaseResource, type PhaseSearchQuery, type PhaseUpdateInput, PortersAuthError, PortersClient, type PortersClientOptions, PortersConfigError, PortersError, type PortersErrorContext, type PortersErrorOptions, PortersNetworkError, PortersResourceError, type Process, type ProcessCreateInput, type ProcessPage, type ProcessResource, type ProcessSearchQuery, type ProcessUpdateInput, type ReadCustomCatalogOptions, type ReadFieldAlias, type Recruiter, type RecruiterCreateInput, type RecruiterPage, type RecruiterResource, type RecruiterSearchQuery, type RecruiterUpdateInput, type ReferenceMap, type ReferenceRecord, type ResourceName, type ResourcePageOf, type ResourceType, type Resume, type ResumeCreateInput, type ResumePage, type ResumeResource, type ResumeSearchQuery, type ResumeUpdateInput, type RevokeUrlOptions, type Sales, type SalesCreateInput, type SalesPage, type SalesResource, type SalesSearchQuery, type SalesUpdateInput, type Scheme, type Scope, type SearchQuery, type StoredTokens, type TenantCustomCatalog, type TenantScope, type Throttle, type ThrottleOptions, type TokenProvider, type TokenStore, type Transport, type TransportRequest, type TransportResponse, type UndeclarableField, type UndeclarableReason, type UndeclarableTenantField, type UndeclaredField, type UnverifiableResource, type User, type UserPage, type UserRef, type UserResource, type UserSearchQuery, type VerifyFieldsOptions, assertFieldsMatch, base64ToBytes, bytesToBase64, createFetchTransport, createMockTransport, createThrottle, defineFields, generateFieldDecls, rawValue, readCustomCatalog, resourceNameOf, resourceValueOf, verifyFields };
+/**
+ * Read a **time-of-day** (時分型) field's value as a clock time.
+ *
+ * PORTERS stores a time-of-day field as a DateTime anchored to 1970/01/01 (`24:00`–`47:59` land on
+ * 1970/01/02) and Field Read cannot tell it from a date-time field (ADR-0086). Read the field as
+ * usual — it decodes to ISO — and pass that ISO string here to get the clock time back:
+ * `"1970-01-01T09:00:00Z"` → `"09:00"`, `"1970-01-02T02:00:00Z"` → `"26:00"`.
+ *
+ * Seconds are kept when they are not `00` (`"09:00:30"`) — PORTERS' UI takes hours and minutes
+ * only, but the wire format carries seconds, and dropping them would lose data silently.
+ *
+ * @throws PortersConfigError (`category: "validation"`) when the value is not an ISO date-time on
+ *   1970-01-01 / 1970-01-02 — which usually means the field is a date-time, not a time-of-day.
+ * @example
+ * // doccheck: fields
+ * const job = await t.job.get(1);
+ * const start = job?.U_startTime == null ? null : decodeTimeOfDay(job.U_startTime); // "09:00"
+ */
+declare const decodeTimeOfDay: (iso: string) => string;
+/**
+ * Write (or search on) a **time-of-day** (時分型) field from a clock time.
+ *
+ * Turns `"HH:mm"` / `"HH:mm:ss"` (`00:00`–`47:59`, PORTERS' own range) into the anchored ISO
+ * date-time the field takes — `"09:00"` → `"1970-01-01T09:00:00Z"`, `"26:00"` →
+ * `"1970-01-02T02:00:00Z"` — so the value goes through `update` / `create` / `condition` like any
+ * DateTime (ADR-0086). PORTERS answers any other date with Code 103 on write and Code 100 on
+ * condition (the search is not run), so an out-of-range or malformed clock time is refused here,
+ * before anything is sent.
+ *
+ * @throws PortersConfigError (`category: "validation"`) unless the value is `HH:mm` or `HH:mm:ss`
+ *   with hours 00–47 and minutes / seconds 00–59.
+ * @example
+ * // doccheck: fields
+ * await t.job.update(1, { U_startTime: encodeTimeOfDay("26:00") });
+ * await t.job.search({ condition: { U_startTime: { ge: encodeTimeOfDay("15:00") } } });
+ */
+declare const encodeTimeOfDay: (time: string) => string;
+
+export { type Activity, type ActivityCreateInput, type ActivityPage, type ActivityResource, type ActivitySearchQuery, type ActivityUpdateInput, type Attachment, type AttachmentAccessor, type AttachmentCreate, type AttachmentPage, type AttachmentResource, type AttachmentSearchQuery, type AttachmentUpdate, type AttachmentWalkQuery, type AuthApi, type AuthorizationUrlOptions, type BulkWriteResult, type BulkWriteResultItem, type Candidate, type CandidateCreateInput, type CandidatePage, type CandidateResource, type CandidateSearchQuery, type CandidateUpdateInput, type Client, type ClientCreateInput, type ClientPage, type ClientResource, type ClientSearchQuery, type ClientUpdateInput, type Condition, type Contact, type ContactCreateInput, type ContactPage, type ContactResource, type ContactSearchQuery, type ContactUpdateInput, type Contract, type ContractCreateInput, type ContractPage, type ContractResource, type ContractSearchQuery, type ContractUpdateInput, type CustomDataType, type CustomFieldResource, type CustomFor, type DeclaredCatalogs, type DefinedFields, type Department, type DepartmentPage, type DepartmentRef, type DepartmentResource, type DepartmentSearchQuery, type ErrorCategory, type Expand, type ExpandedReadRecord, type FetchTransportOptions, type Field, type FieldAccessor, type FieldBuilder, type FieldCatalogSource, type FieldDecls, type FieldDef, type FieldPage, type FieldResource, type FieldSearchQuery, type FieldTypeMismatch, type FieldValue, type FieldVerification, type GenerateFieldDeclsOptions, type GetAccessTokenOptions, type ImageContentType, type ImageOption, type ImageReadRecord, type ImageSelectedValue, type ImageSubField, type ImageValue, type ImageWriteValue, type ItemState, type Job, type JobCreateInput, type JobPage, type JobResource, type JobSearchQuery, type JobUpdateInput, type LinkValue, type MissingField, type MockHandler, type MockReply, type MockTransportOptions, type Opportunity, type OpportunityCreateInput, type OpportunityPage, type OpportunityResource, type OpportunitySearchQuery, type OpportunityUpdateInput, type Option, type OptionResource, type OptionSearchQuery, type Order, type Partition, type PartitionId, type PartitionPage, type PartitionResource, type PartitionSearchQuery, type Phase, type PhaseAccessor, type PhaseCreateInput, type PhasePage, type PhaseResource, type PhaseSearchQuery, type PhaseUpdateInput, PortersAuthError, PortersClient, type PortersClientOptions, PortersConfigError, PortersError, type PortersErrorContext, type PortersErrorOptions, PortersNetworkError, PortersResourceError, type Process, type ProcessCreateInput, type ProcessPage, type ProcessResource, type ProcessSearchQuery, type ProcessUpdateInput, type ReadCustomCatalogOptions, type ReadFieldAlias, type Recruiter, type RecruiterCreateInput, type RecruiterPage, type RecruiterResource, type RecruiterSearchQuery, type RecruiterUpdateInput, type ReferenceMap, type ReferenceRecord, type ResourceName, type ResourcePageOf, type ResourceType, type Resume, type ResumeCreateInput, type ResumePage, type ResumeResource, type ResumeSearchQuery, type ResumeUpdateInput, type RevokeUrlOptions, type Sales, type SalesCreateInput, type SalesPage, type SalesResource, type SalesSearchQuery, type SalesUpdateInput, type Scheme, type Scope, type SearchQuery, type StoredTokens, type TenantCustomCatalog, type TenantScope, type Throttle, type ThrottleOptions, type TokenProvider, type TokenStore, type Transport, type TransportRequest, type TransportResponse, type UndeclarableField, type UndeclarableReason, type UndeclarableTenantField, type UndeclaredField, type UnverifiableResource, type User, type UserPage, type UserRef, type UserResource, type UserSearchQuery, type VerifyFieldsOptions, assertFieldsMatch, base64ToBytes, bytesToBase64, createFetchTransport, createMockTransport, createThrottle, decodeTimeOfDay, defineFields, encodeTimeOfDay, generateFieldDecls, rawValue, readCustomCatalog, resourceNameOf, resourceValueOf, verifyFields };