@joymerrevent/porters-connect 0.12.1 → 0.13.0

package/CHANGELOG.md

@@ -5,6 +5,36 @@
 
 ## [Unreleased]
 
+## [0.13.0] - 2026-09-06
+
+**User マスタが PORTERS の全 17 項目を返すようになった版**です。破壊的変更はありませんが、
+`field` を省略したときの既定の挙動が変わります（下記 Changed）。
+
+### Added
+
+- **User マスタが reference の全 17 項目を返すようになりました**（[ADR-0060][adr60] D2）。
+  これまでカタログは 4 項目（`P_Id` / `P_Type` / `P_Name` / `P_Mail`）だけで、部署・電話・利用開始日・
+  登録者といった項目は**型にも存在せず、読む手段がありませんでした**。追加された 13 項目はこちらです。
+
+  `P_Department`（`System[Department]` — 入れ子で `P_Id` / `P_Name`）／ `P_Telephone` ／ `P_Mobile` ／
+  `P_MobileMail` ／ `P_UserName` ／ `P_TimeZone` ／ `P_Language` ／ `P_StartDate` ／ `P_EndDate` ／
+  `P_RegistrationDate` ／ `P_RegisteredBy` ／ `P_UpdateDate` ／ `P_UpdatedBy`
+
+  ```ts
+  const page = await t.user.search();
+  page.items[0]?.P_Department; // { P_Id: number | null; P_Name: string | null } | null
+  page.items[0]?.P_StartDate; // ISO 8601（"2026-04-01"）
+  ```
+
+### Changed
+
+- **`field` を省略した User Read が、カタログの全項目を要求するようになりました**（他のリソースと
+  同じ既定の扱い）。PORTERS は `field` 省略時に 4 項目しか返さないため、そのままでは
+  **型が約束する 13 項目が黙って `null` になる**からです。
+
+  4 項目だけで十分な場合は、`field` に必要なものだけを並べてください。
+  `field: []` は従来どおり「PORTERS 既定の 4 項目に委ねる」意味です。
+
 ## [0.12.1] - 2026-09-03
 
 **フェイルセーフの修正 2 件**です。どちらも「黙って壊れる／安全側に倒しすぎている」場面を直したもので、
@@ -547,6 +577,7 @@
 [kac]: https://keepachangelog.com/en/1.1.0/
 [semver]: https://semver.org/
 [unreleased]: https://github.com/Joymerrevent/porters-connect/compare/v0.12.1...HEAD
+[0.13.0]: https://github.com/Joymerrevent/porters-connect/compare/v0.12.1...v0.13.0
 [0.12.1]: https://github.com/Joymerrevent/porters-connect/compare/v0.12.0...v0.12.1
 [0.12.0]: https://github.com/Joymerrevent/porters-connect/compare/v0.11.0...v0.12.0
 [0.11.0]: https://github.com/Joymerrevent/porters-connect/compare/v0.10.0...v0.11.0

package/dist/index.d.ts

@@ -2041,6 +2041,19 @@ declare const FIELDS$2: {
     readonly P_Type: "Number";
     readonly P_Name: "SinglelineText";
     readonly P_Mail: "Mail";
+    readonly P_Department: "System[Department]";
+    readonly P_Telephone: "Telephone";
+    readonly P_Mobile: "Telephone";
+    readonly P_MobileMail: "Mail";
+    readonly P_UserName: "SinglelineText";
+    readonly P_TimeZone: "SinglelineText";
+    readonly P_Language: "SinglelineText";
+    readonly P_StartDate: "Date";
+    readonly P_EndDate: "Date";
+    readonly P_RegistrationDate: "System[DateTime]";
+    readonly P_RegisteredBy: "User";
+    readonly P_UpdateDate: "System[DateTime]";
+    readonly P_UpdatedBy: "User";
 };
 /** A decoded User (PORTERS operator). `P_Type`: 0 = standard user, 1 = system admin. */
 type User = ReadRecord<typeof FIELDS$2>;
@@ -2053,7 +2066,9 @@ type UserSearchQuery = {
     userType?: -1 | 0 | 1;
     /**
      * Output fields as **bare aliases** (`P_Name`); the library adds the `User.` prefix (ADR-0059).
-     * Omit to get the 4 core fields (this catalog).
+     * **Omit** to fetch every catalogued field (ADR-0020); narrow it when the extra HR fields
+     * (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>[];
     count?: number;

package/dist/index.js

@@ -2062,7 +2062,24 @@ var FIELDS14 = {
   P_Id: "System[Id]",
   P_Type: "Number",
   P_Name: "SinglelineText",
-  P_Mail: "Mail"
+  P_Mail: "Mail",
+  // 部署は User と同じ入れ子で返る（`<Department><Department.P_Id>…` — ADR-0061 案3a）。
+  P_Department: "System[Department]",
+  P_Telephone: "Telephone",
+  P_Mobile: "Telephone",
+  P_MobileMail: "Mail",
+  P_UserName: "SinglelineText",
+  // タイムゾーン名（`Asia/Tokyo` 等）。PORTERS は Timezone List の名前をそのまま返す。
+  P_TimeZone: "SinglelineText",
+  P_Language: "SinglelineText",
+  P_StartDate: "Date",
+  P_EndDate: "Date",
+  P_RegistrationDate: "System[DateTime]",
+  // 登録者・更新者は `User` 型＝汎用の組み立てが `(User.P_Id,…)` を付けて要求する。
+  // VERIFY(live): User Read で User 型の項目を `()` 付きで要求できるかは未確認（LV-17 と同型）。
+  P_RegisteredBy: "User",
+  P_UpdateDate: "System[DateTime]",
+  P_UpdatedBy: "User"
 };
 var USER_DESCRIPTOR = {
   name: "User",
@@ -2071,15 +2088,17 @@ var USER_DESCRIPTOR = {
   fields: FIELDS14
 };
 var FIELD_MAP = new Map(Object.entries(FIELDS14));
+var DEFAULT_FIELDS2 = Object.keys(FIELDS14);
 var buildParams2 = (partition, q) => {
   const p = new URLSearchParams();
   p.set("partition", String(partition));
   p.set("request_type", String(q.requestType ?? 1));
   p.set("user_type", String(q.userType ?? -1));
-  if (q.field && q.field.length > 0) {
+  const field = q.field ?? DEFAULT_FIELDS2;
+  if (field.length > 0) {
     p.set(
       "field",
-      qualifyReadFields(USER_DESCRIPTOR.prefix, FIELD_MAP, q.field).join(",")
+      qualifyReadFields(USER_DESCRIPTOR.prefix, FIELD_MAP, field).join(",")
     );
   }
   return p;