@kengcom202/kcore-ui 0.5.0 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kengcom202/kcore-ui",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Angular UI กลาง: ช่องเลือกวันที่แบบ พ.ศ., ช่องเลือกเวลาแบบหน้าปัด, dropdown ค้นหาได้, ตัวแก้ข้อความไทยที่คัดลอกจาก PDF และชุดหน้าเข้าสู่ระบบ/ลงทะเบียน/ข้อมูลส่วนตัว/config (ไม่พึ่งไลบรารีภายนอก)",
   "license": "UNLICENSED",
   "repository": {

package/types/kengcom202-kcore-ui.d.ts

@@ -324,6 +324,8 @@ export declare function fixThaiText(text: string): string;
  * ผ่าน execCommand('insertText') เพื่อให้ ngModel / formControl ได้ event input และ Ctrl+Z ย้อนได้
  */
 export declare function provideThaiPasteFix(): EnvironmentProviders;
+/** โหมดลงทะเบียนผู้ใช้ใหม่ — ดู KcAuthOptions.register */
+export type KcRegisterMode = 'none' | 'form' | 'sso' | 'thaid';
 /** ค่าที่โปรเจกต์ส่งให้ provideKcAuth() — ทุกค่ายกเว้น appName มีค่าเริ่มต้น */
 export interface KcAuthOptions {
   /** ชื่อระบบ แสดงบนหน้าเข้าสู่ระบบ/ลงทะเบียน */
@@ -339,7 +341,7 @@ export interface KcAuthOptions {
     label?: string;
   };
   /**
-   * เปิดปุ่ม ThaiD (แอปยืนยันตัวตนของกรมการปกครอง) — เข้าสู่ระบบอย่างเดียว ไม่ใช้ลงทะเบียน
+   * เปิดปุ่ม ThaiD (แอปยืนยันตัวตนของกรมการปกครอง) — เข้าสู่ระบบอย่างเดียว ไม่ใช้ลงทะเบียน (ยกเว้น register: 'thaid')
    * API จับคู่เลขบัตรประชาชนกับบัญชีที่มีอยู่แล้ว ไม่พบ = แจ้งให้ติดต่อผู้ดูแล; label ค่าเริ่มต้น 'ThaiD'; false/ไม่ใส่ = ปิด
    */
   thaid?: false | {
@@ -355,8 +357,16 @@ export interface KcAuthOptions {
    *   'none' — ไม่เปิดให้สมัครเอง (ผู้ดูแลเพิ่มให้) — ค่าเริ่มต้น
    *   'form' — กรอกฟอร์มเองที่ /register
    *   'sso'  — ยืนยันตัวตนผ่าน SSO ก่อน แล้ว API ส่งตั๋วลงทะเบียนมาให้กรอกต่อที่ /register
+   *   'thaid' — ยืนยันตัวตนผ่าน ThaiD ก่อน แล้ว API ส่งตั๋วลงทะเบียนมาให้กรอกต่อที่ /register (ต้องเปิด thaid)
+   *             สำหรับระบบที่เป็นหลังบ้านของ SSO เท่านั้น — SSO ไม่พบบัญชีตอบ { mode: 'thaid' } ส่งต่อไป ThaiD ได้
    */
-  register?: 'none' | 'form' | 'sso';
+  register?: KcRegisterMode;
+  /**
+   * ให้ผู้ใช้ขอย้ายหน่วยงานเองที่หน้าบัญชีของฉัน ค่าเริ่มต้น false (ย้ายได้โดยผู้ดูแลที่หน้า config เท่านั้น)
+   * true = แสดงช่องเลือกหน่วยงานเมื่อ GET {api}/user/me ส่ง orgs มา แล้วส่ง org ไปกับ PUT {api}/user/me
+   * (API ตัดสินเองว่าย้ายทันทีหรือรออนุมัติ แล้วตอบ { message })
+   */
+  profileOrgChange?: boolean;
   /** ชื่อเรียกหน่วยงานที่สังกัด เช่น 'หน่วยงาน', 'โรงพยาบาล', 'แผนก' ค่าเริ่มต้น 'หน่วยงาน' */
   orgLabel?: string;
   /** ค่า role ที่ถือว่าเป็นผู้ดูแล (เข้า kcAdminGuard ได้) ค่าเริ่มต้น ['admin'] */
@@ -379,7 +389,8 @@ export interface KcAuthConfig {
     label: string;
   } | null;
   passwordLogin: boolean;
-  register: 'none' | 'form' | 'sso';
+  register: KcRegisterMode;
+  profileOrgChange: boolean;
   orgLabel: string;
   adminRoles: string[];
   passwordMinLength: number;
@@ -442,12 +453,25 @@ export interface KcLoginMethods {
   sso: boolean;
   thaid: boolean;
 }
-/** POST {api}/user/sso/callback { code } */
+/**
+ * POST {api}/user/sso/callback { code }
+ *   thaid — ไม่พบบัญชี ให้ยืนยันตัวตนด้วย ThaiD ต่อ (ใช้ได้เฉพาะ register: 'thaid')
+ */
 export type KcSsoCallbackResult = ({
   mode: 'signed-in';
 } & KcSession) | {
   mode: 'register';
   ticket: string;
+} | {
+  mode: 'thaid';
+};
+/**
+ * POST {api}/user/thaid/callback { code } — พบบัญชี = KcSession
+ * ไม่พบบัญชี: ปกติ 403 { message }; register: 'thaid' ตอบตั๋วลงทะเบียนแทนได้
+ */
+export type KcThaidCallbackResult = KcSession | {
+  mode: 'register';
+  ticket: string;
 };
 /** GET {api}/user/register-info[?ticket=] — ตั๋วจาก SSO ทำให้ได้ชื่อ-สกุล (และหน่วยงาน) ที่ยืนยันแล้ว */
 export interface KcRegisterInfo {
@@ -485,6 +509,8 @@ export interface KcProfile {
   orgName: string;
   email: string;
   mobile: string;
+  /** หน่วยงานที่ขอย้ายไปได้ — ใช้เมื่อ profileOrgChange: true (ไม่ส่ง/ว่าง = แสดงหน่วยงานแบบอ่านอย่างเดียว) */
+  orgs?: SearchOption[];
 }
 /** PUT {api}/user/me — password ว่าง = ไม่เปลี่ยน */
 export interface KcProfileUpdate {
@@ -492,6 +518,8 @@ export interface KcProfileUpdate {
   email: string;
   mobile: string;
   password: string;
+  /** ส่งเฉพาะเมื่อ profileOrgChange: true และ GET user/me ส่ง orgs มา */
+  org?: string;
 }
 /** แถวในหน้า config ผู้ใช้ */
 export interface KcConfigUser {
@@ -635,7 +663,7 @@ export declare const KC_LOGIN_LOCK_KEY = "kc_login_lock";
  * หน้าเข้าสู่ระบบ (route /login จาก kcAuthRoutes())
  *   ชื่อผู้ใช้/รหัสผ่าน → POST {api}/user/login → KcSession (ผิดครบ 3 ครั้ง API ตอบ 429 → นับถอยหลังตาม retryAfter และปิดปุ่ม)
  *   ปุ่ม SSO (ถ้าเปิด) → GET {api}/user/sso/authorize-url → ไปหน้า SSO แล้วกลับมาที่ /sso-callback
- *   ปุ่ม ThaiD (ถ้าเปิด) → GET {api}/user/thaid/authorize-url → ไปหน้า ThaiD แล้วกลับมาที่ /thaid-callback (ไม่มีลงทะเบียน)
+ *   ปุ่ม ThaiD (ถ้าเปิด) → GET {api}/user/thaid/authorize-url → ไปหน้า ThaiD แล้วกลับมาที่ /thaid-callback (ลงทะเบียนเฉพาะ register: 'thaid')
  * วิธีที่แสดงตาม GET {api}/user/login-methods (ผู้ดูแลเปิด/ปิดที่หน้า config ผู้ใช้) — ไม่มี endpoint = ตาม provideKcAuth
  * query: returnUrl = หน้าที่จะกลับไปหลังเข้าสู่ระบบ, expired=1 = แจ้งหมดเวลาการใช้งาน
  * เนื้อหาที่ใส่ไว้ใน <kc-login>...</kc-login> แสดงท้ายการ์ด (เช่นเบอร์ติดต่อผู้ดูแล)
@@ -653,7 +681,7 @@ export declare class KcLoginComponent implements OnInit {
   private readonly router;
   private readonly route;
   private readonly doc;
-  protected readonly busy: import("@angular/core").WritableSignal<"" | "sso" | "password" | "thaid">;
+  protected readonly busy: import("@angular/core").WritableSignal<"" | "sso" | "thaid" | "password">;
   /**
    * วิธีที่ผู้ดูแลเปิดไว้ (GET {api}/user/login-methods) — ก่อนได้คำตอบ หรือ API ยังไม่มี endpoint นี้ ใช้ค่าจาก provideKcAuth
    * แต่ละวิธีแสดงเมื่อทั้ง provideKcAuth เปิดไว้ (passwordLogin / sso / thaid) และผู้ดูแลเปิด
@@ -707,6 +735,7 @@ export declare class KcLoginComponent implements OnInit {
  * หน้าลงทะเบียนผู้ใช้ใหม่ (route /register) — รูปแบบตาม ictprocure: กล่องเดียว ช่องเรียงแถวเดียว
  * ทำงานตาม register ใน provideKcAuth()
  *   'sso'  — ต้องมาจาก /sso-callback พร้อมตั๋ว ชื่อ-สกุล / เลขบัตรประชาชน (และหน่วยงานถ้า orgLocked) มาจาก API แก้ไม่ได้
+ *   'thaid' — เหมือน 'sso' แต่ตั๋วมาจาก /thaid-callback
  *   'form' — กรอกชื่อ-สกุลเอง
  *   'none' — แจ้งว่าไม่เปิดให้ลงทะเบียน
  * อีเมล / มือถือไม่ถามตอนลงทะเบียน — ผู้ใช้กรอกต่อที่หน้าบัญชีของฉัน
@@ -720,6 +749,7 @@ export declare class KcRegisterComponent implements OnInit {
     readonly ssoCallback: "/sso-callback";
     readonly thaidCallback: "/thaid-callback";
   };
+  /** ผู้ยืนยันตัวตนของตั๋วลงทะเบียน — แสดงใน "(จาก ...)" และข้อความเมื่อยังไม่มีตั๋ว */
   protected readonly ssoLabel: string;
   private readonly auth;
   private readonly http;
@@ -775,6 +805,10 @@ declare abstract class KcExternalCallbackBase implements OnInit {
   /** แลก code แล้วจัดการผล */
   protected abstract exchange(code: string): void;
   ngOnInit(): void;
+  /** ขอ url ของผู้ให้บริการ เก็บ state แล้วพาไปหน้านั้น */
+  protected startFlow(endpoint: string, stateKey: string, label: string): void;
+  /** เก็บตั๋วลงทะเบียนแล้วไปหน้า /register (ตั๋วจาก SSO และ ThaiD ใช้คีย์เดียวกัน) */
+  protected toRegister(ticket: string): void;
   protected signIn(session: KcSession): void;
   protected fail(message: string): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<KcExternalCallbackBase, never>;
@@ -786,6 +820,7 @@ declare abstract class KcExternalCallbackBase implements OnInit {
  *   ?code=&state= → ตรวจ state → POST {api}/user/sso/callback { code }
  *     signed-in → เริ่ม session แล้วกลับหน้าเดิม / homeUrl
  *     register  → เก็บตั๋วไว้ใน sessionStorage แล้วไป /register
+ *     thaid     → (register: 'thaid') ไม่พบบัญชี ส่งต่อไปยืนยันตัวตนด้วย ThaiD
  *   ไม่มี code (เช่นเปิดจากเมนูของ SSO portal) → เริ่ม flow ใหม่เอง
  */
 export declare class KcSsoCallbackComponent extends KcExternalCallbackBase {
@@ -800,6 +835,7 @@ export declare class KcSsoCallbackComponent extends KcExternalCallbackBase {
  * หน้ารับ redirect กลับจาก ThaiD (route /thaid-callback) — เข้าสู่ระบบอย่างเดียว ไม่มีการลงทะเบียน
  *   ?code=&state= → ตรวจ state → POST {api}/user/thaid/callback { code } → KcSession
  *   API ไม่พบบัญชีที่ผูกกับเลขบัตรประชาชน = ตอบ 403 { message } แสดงข้อความนั้น (ให้ติดต่อผู้ดูแล)
+ *   ยกเว้น register: 'thaid' — API ตอบ { mode: 'register', ticket } ได้ → เก็บตั๋วแล้วไป /register
  */
 export declare class KcThaidCallbackComponent extends KcExternalCallbackBase {
   protected readonly label: string;
@@ -813,6 +849,7 @@ export declare class KcThaidCallbackComponent extends KcExternalCallbackBase {
  * หน้า "บัญชีของฉัน" (user/detail) — รูปแบบตาม ictprocure: กล่องเดียวกลางหน้า ช่องเรียงแถวเดียว
  * วางใน layout ของโปรเจกต์พร้อม canActivate: [kcAuthGuard]
  * ชื่อ-สกุลและหน่วยงานแสดงอย่างเดียว (หน่วยงานกำหนดสิทธิ์การเห็นข้อมูล ย้ายได้โดยผู้ดูแลที่หน้า config)
+ *   ยกเว้น profileOrgChange: true และ API ส่ง orgs มา — เลือกหน่วยงานได้ ส่ง org ไปกับ PUT (API ตัดสินว่ารออนุมัติไหม)
  * แก้ได้: อีเมล มือถือ ชื่อผู้ใช้ รหัสผ่าน — เปลี่ยนรหัสผ่านไม่ต้องกรอกรหัสเดิม เว้นว่าง = ไม่เปลี่ยน
  * GET {api}/user/me → KcProfile, PUT {api}/user/me ← KcProfileUpdate
  */
@@ -828,10 +865,13 @@ export declare class KcProfileComponent implements OnInit {
   protected readonly success: import("@angular/core").WritableSignal<string>;
   protected readonly fullName: import("@angular/core").WritableSignal<string>;
   protected readonly orgName: import("@angular/core").WritableSignal<string>;
+  /** หน่วยงานที่เลือกย้ายได้ — ว่าง = แสดงแบบอ่านอย่างเดียว */
+  protected readonly orgs: import("@angular/core").WritableSignal<SearchOption[]>;
   protected readonly form: import("@angular/forms").FormGroup<{
     email: import("@angular/forms").FormControl<string>;
     mobile: import("@angular/forms").FormControl<string>;
     username: import("@angular/forms").FormControl<string>;
+    org: import("@angular/forms").FormControl<string>;
     password: import("@angular/forms").FormControl<string>;
     confirmPassword: import("@angular/forms").FormControl<string>;
   }>;