@youjunhuang/entity-core 1.0.0

package/dist/models/event.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubjectType = exports.EventStatus = exports.EventSubTypeEnum = exports.MedicalSubType = exports.UserBehaviorSubType = exports.SystemSubType = exports.VisualSubType = void 0;
+/**
+ * 視覺辨識類事件子類型 (VisualSubType)
+ *
+ * @enum {string}
+ * @description
+ *   此枚舉列出所有視覺辨識相關的事件子類型，
+ *   例如超速、車禍、倒地等。
+ */
+var VisualSubType;
+(function (VisualSubType) {
+    /** 超速 */
+    VisualSubType["OverSpeed"] = "overSpeed";
+    /** 車禍 */
+    VisualSubType["CarAccident"] = "carAccident";
+    /** 倒地 */
+    VisualSubType["FallDown"] = "fallDown";
+    /** 違規右轉 */
+    VisualSubType["IllegalRightTurn"] = "illegalRightTurn";
+    /** 異常停留 */
+    VisualSubType["AbnormalStay"] = "abnormalStay";
+    /** 穿著不正確 */
+    VisualSubType["ImproperDress"] = "improperDress";
+    /** 器械數量錯誤 */
+    VisualSubType["EquipmentCountError"] = "equipmentCountError";
+    /** 器械順序錯誤 */
+    VisualSubType["EquipmentOrderError"] = "equipmentOrderError";
+})(VisualSubType || (exports.VisualSubType = VisualSubType = {}));
+/**
+* 系統類事件子類型 (SystemSubType)
+*
+* @enum {string}
+* @description
+*   此枚舉列出所有系統相關的事件子類型，
+*   例如設備故障、服務崩潰、數據異常等。
+*/
+var SystemSubType;
+(function (SystemSubType) {
+    /** 設備故障 */
+    SystemSubType["DeviceFailure"] = "deviceFailure";
+    /** 服務崩潰 */
+    SystemSubType["ServiceCrash"] = "serviceCrash";
+    /** 數據異常 */
+    SystemSubType["DataAnomaly"] = "dataAnomaly";
+})(SystemSubType || (exports.SystemSubType = SystemSubType = {}));
+/**
+* 使用者行為類事件子類型 (UserBehaviorSubType)
+*
+* @enum {string}
+* @description
+*   此枚舉列出所有使用者行為相關的事件子類型，
+*   例如異常登入、權限違規操作等。
+*/
+var UserBehaviorSubType;
+(function (UserBehaviorSubType) {
+    /** 異常登入 */
+    UserBehaviorSubType["AbnormalLogin"] = "abnormalLogin";
+    /** 權限違規操作 */
+    UserBehaviorSubType["PermissionViolation"] = "permissionViolation";
+})(UserBehaviorSubType || (exports.UserBehaviorSubType = UserBehaviorSubType = {}));
+/**
+ * 醫療類事件子類型 (MedicalSubType)
+ *
+ * @enum {string}
+ * @description
+ *   此枚舉列出所有醫療相關的事件子類型，
+ *   例如抵達等候室時間、手術開始時間等。
+ */
+var MedicalSubType;
+(function (MedicalSubType) {
+    /** 抵達等候室時間 */
+    MedicalSubType["ArriveWaitingRoomTime"] = "arriveWaitingRoomTime";
+    /** 入手術房時間 */
+    MedicalSubType["EnterOperatingRoomTime"] = "enterOperatingRoomTime";
+    /** 麻醉開始時間 */
+    MedicalSubType["AnesthesiaStartTime"] = "anesthesiaStartTime";
+    /** 手術開始時間 */
+    MedicalSubType["SurgeryStartTime"] = "surgeryStartTime";
+    /** 手術結束時間 */
+    MedicalSubType["SurgeryEndTime"] = "surgeryEndTime";
+    /** 病人至下個單位時間 */
+    MedicalSubType["PatientToNextUnitTime"] = "patientToNextUnitTime";
+    /** 手術類別 */
+    MedicalSubType["SurgeryType"] = "surgeryType";
+    /** 麻醉方式 */
+    MedicalSubType["AnesthesiaType"] = "anesthesiaType";
+    /** 照會其他科手術 */
+    MedicalSubType["ConsultOtherDepartmentSurgery"] = "consultOtherDepartmentSurgery";
+    /** 擺位正確 */
+    MedicalSubType["CorrectPositioning"] = "correctPositioning";
+    /** 植入物 */
+    MedicalSubType["Implant"] = "implant";
+    /** Timeout查核項目/時間 */
+    MedicalSubType["TimeoutCheckItemTime"] = "timeoutCheckItemTime";
+    /** 確認血品 */
+    MedicalSubType["ConfirmBloodProduct"] = "confirmBloodProduct";
+    /** 畫刀前六十分鐘內給予預防性抗生素 */
+    MedicalSubType["AdministerProphylacticAntibioticWithin60MinutesBeforeIncision"] = "administerProphylacticAntibioticWithin60MinutesBeforeIncision";
+})(MedicalSubType || (exports.MedicalSubType = MedicalSubType = {}));
+/**
+* 統合的事件子類型 (EventSubType)
+*
+* @typedef {VisualSubType | SystemSubType | UserBehaviorSubType} EventSubType
+* @description
+*   利用 TypeScript 聯合型別 (Union) 將三個不同的大類事件子類型合併。
+*   若程式中某處需要一個既能表示「視覺辨識類」、
+*   「系統異常類」或「使用者行為類」的子類型，則可使用本型別。
+*/
+// export type EventSubType = VisualSubType |
+//   SystemSubType |
+//   UserBehaviorSubType |
+//   MedicalSubType;
+exports.EventSubTypeEnum = [
+    ...Object.values(VisualSubType),
+    ...Object.values(SystemSubType),
+    ...Object.values(UserBehaviorSubType),
+    ...Object.values(MedicalSubType),
+];
+// /**
+//  * **事件介面**  
+//  * 用於記錄系統內發生的各種事件。
+//  *
+//  * - **`type`**：事件大分類（視覺辨識 / 系統類 / 使用者行為）。  
+//  * - **`subType`**：具體事件子類型，例如 `overspeed`、`carAccident` 等。  
+//  * - **`freeTags`**：可額外標註任何關鍵字或標籤，讓系統可彈性紀錄事件。  
+//  * - **`description`**：事件描述文字。  
+//  * - **`[scheduleId]`** _(可選)_：需要循環時才關聯 Schedule。 
+//  * - **`[templateId]`** _(可選)_：根據模板產生。  
+//  *
+//  * @interface Event
+//  */
+// export interface IEvent extends Base {
+//   /**
+//    * 事件大分類，如視覺辨識 (visual)、系統類 (system) 或使用者行為 (userBehavior)。
+//    */
+//   type: EventType;
+//   /**
+//    * 事件子類型，具體類型視 type 欄位而定，例如 overSpeed、deviceFailure、abnormalLogin。
+//    */
+//   subType: string;
+//   /**
+//    * 與此事件相關的父實體種類，例如 'SurgicalReport'、'Camera' 等。
+//    */
+//   relateType?: string;
+//   /**
+//    * 此事件關聯的父實體 ID（由 relateType 指明所屬實體的主鍵或 UUID）。
+//    */
+//   relateId?: string;
+//   /**
+//    * 可自由添加的標籤，用於更靈活地分類和搜尋事件。
+//    * 例如：['緊急', '需處理', '高風險'] 或 ['定期檢查', '維護']
+//    */
+//   freeTags: string[];
+//   /**
+//    * 事件的詳細描述，說明事件的具體情況。
+//    * 例如：'攝影機A偵測到一輛車速超過80km/h，地點：中山路口。'
+//    */
+//   description: string;
+//   /**
+//    * 關聯的排程ID，僅當事件需要循環執行時才設定。
+//    */
+//   scheduleId?: string;
+//   /**
+//    * 關聯的模板ID，表示此事件是根據特定模板產生的。
+//    */
+//   templateId?: string;
+// }
+/**
+ * **事件狀態 (EventStatus)**
+ *
+ * 定義事件處理的常見狀態：
+ * - **`Unprocessed`**：事件尚未處理（初始狀態）。
+ * - **`Notified`**：事件已通知相關人員，但尚未開始處理。
+ * - **`Processing`**：事件正在處理中。
+ * - **`Completed`**：事件處理完成。
+ *
+ * @enum {string}
+ */
+var EventStatus;
+(function (EventStatus) {
+    EventStatus["Unprocessed"] = "unprocessed";
+    EventStatus["Notified"] = "notified";
+    EventStatus["Processing"] = "processing";
+    EventStatus["Completed"] = "completed";
+})(EventStatus || (exports.EventStatus = EventStatus = {}));
+var SubjectType;
+(function (SubjectType) {
+    SubjectType["Entrance"] = "Entrance";
+    SubjectType["Camera"] = "Camera";
+    SubjectType["Device"] = "Device";
+    SubjectType["User"] = "User";
+})(SubjectType || (exports.SubjectType = SubjectType = {}));
+//# sourceMappingURL=event.js.map

package/dist/models/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../models/event.ts"],"names":[],"mappings":"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"}

package/dist/models/index.d.ts

@@ -0,0 +1,19 @@
+export * from './account';
+export * from './attachment';
+export * from './camera';
+export * from './chatroom';
+export * from './device';
+export * from './event';
+export * from './map';
+export * from './inform';
+export * from './permission';
+export * from './report';
+export * from './role';
+export * from './schedule';
+export * from './task';
+export * from './template';
+export * from './user';
+export * from './utils';
+export * from './auth-credential';
+export * from './ui-item';
+//# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../models/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC"}

package/dist/models/index.js

@@ -0,0 +1,35 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./account"), exports);
+__exportStar(require("./attachment"), exports);
+__exportStar(require("./camera"), exports);
+__exportStar(require("./chatroom"), exports);
+__exportStar(require("./device"), exports);
+__exportStar(require("./event"), exports);
+__exportStar(require("./map"), exports);
+__exportStar(require("./inform"), exports);
+__exportStar(require("./permission"), exports);
+__exportStar(require("./report"), exports);
+__exportStar(require("./role"), exports);
+__exportStar(require("./schedule"), exports);
+__exportStar(require("./task"), exports);
+__exportStar(require("./template"), exports);
+__exportStar(require("./user"), exports);
+__exportStar(require("./utils"), exports);
+__exportStar(require("./auth-credential"), exports);
+__exportStar(require("./ui-item"), exports);
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,+CAA6B;AAC7B,2CAAyB;AACzB,6CAA2B;AAC3B,2CAAyB;AACzB,0CAAwB;AACxB,wCAAsB;AACtB,2CAAyB;AACzB,+CAA6B;AAC7B,2CAAyB;AACzB,yCAAuB;AACvB,6CAA2B;AAC3B,yCAAuB;AACvB,6CAA2B;AAC3B,yCAAuB;AACvB,0CAAwB;AACxB,oDAAkC;AAClC,4CAA0B"}

package/dist/models/inform.d.ts

@@ -0,0 +1,146 @@
+import { Attachment } from "./attachment";
+import { EventSubType } from "./event";
+import { EventInformTemplate, EventType } from "./template";
+import { Base } from "./utils";
+/**
+ * **通知發送渠道**
+ *
+ * 定義通知的傳送方式：
+ * - **`Email`**：透過電子郵件發送通知。
+ * - **`SMS`**：透過簡訊發送通知。
+ * - **`FCM`**：透過 Firebase Cloud Messaging (Android/Web) 推送通知。
+ * - **`APNs`**：透過 Apple Push Inform Service (iOS) 推送通知。
+ * - **`Web`**：透過通知 Web 。
+ * - **`Webhook`**：透過 Webhook 送達通知。
+ */
+export declare enum InformChannel {
+    /** 電子郵件 */
+    Email = "email",
+    /** 簡訊 (SMS) */
+    SMS = "sms",
+    /** Firebase Cloud Messaging */
+    FCM = "fcm",
+    /** Apple Push Inform Service */
+    APNs = "apns",
+    /** Web */
+    Web = "web",
+    /** Webhook */
+    Webhook = "webhook"
+}
+/**
+ * **通知狀態**
+ *
+ * 定義通知的處理狀態：
+ * - **`Pending`**：尚未發送。
+ * - **`Sent`**：已發送。
+ * - **`Read`**：已讀取。
+ * - **`Failed`**：發送失敗。
+ */
+export declare enum InformStatus {
+    /** 通知已建立，尚未發送。 */
+    Pending = "pending",
+    /** 通知已發送。 */
+    Sent = "sent",
+    /** 通知已讀取。 */
+    Read = "read",
+    /** 通知發送失敗。 */
+    Failed = "failed"
+}
+/**
+ * **通知主表**
+ *
+ * - **`subject`**：通知主旨。
+ * - **`content`**：通知內容。
+ * - **`[templateId]`** _(可選)_: 根據模板設定什麼事件需要通知。
+ */
+export interface Inform extends Base {
+    /** 通知的主旨。 */
+    subject: string;
+    /** 通知的內容。 */
+    content: string;
+    /** 根據模板設定什麼事件需要通知。 */
+    templateId?: EventInformTemplate;
+}
+export type InformAttachment = Attachment & {
+    attachTo?: never;
+    /** 關聯的通知 ID。 */
+    informId: Inform['id'];
+};
+/**
+ * **通知狀態表**
+ *
+ * 每個收件人對應一條記錄，追蹤其通知的讀取與發送狀態。
+ *
+ * - **`informId`**：關聯的通知 ID。
+ * - **`recipientId`**：收件者 ID (使用者 ID / Webhook URL)。
+ * - **`channel`**：通知發送渠道（Email/SMS/FCM/APNs/Webhook）。
+ * - **`status`**：通知的狀態（Pending/Sent/Read/Failed）。
+ * - **`[readAt]`** _(可選)_：通知讀取時間。
+ */
+export interface InformStatusRecord extends Base {
+    /** 關聯的通知 ID */
+    informId: Inform["id"];
+    /**
+     * 收件者 ID：
+     * - 若 `channel` 為 Email / SMS / FCM / APNs，則此處為使用者 ID。
+     * - 若 `channel` 為 Webhook，則此處為 Webhook URL。
+     */
+    recipientId: string;
+    /** 發送渠道 (Email / SMS / FCM / APNs / Webhook)。 */
+    channel: InformChannel;
+    /** 通知狀態。 */
+    status: InformStatus;
+    /** 通知讀取時間，若尚未讀取則為 `undefined`。 */
+    readAt?: Date;
+}
+/**
+ * **通知策略類型**
+ *
+ * - `Repeated`：持續通知 X 次，每次間隔 Y 分鐘，直到 Z 分鐘或者被 attachment 標記已處理。
+ * - `Difference`：當 event 的同一種類的子類型 T1 和 T0 出現差異時通知。
+ */
+export declare enum InformStrategyType {
+    Repeated = "repeated",
+    Difference = "difference"
+}
+/**
+ * **持續通知策略**
+ *
+ * 當事件發生時，按照設定的次數與時間間隔發送通知，直到條件滿足。
+ *
+ * - `maxAttempts`：最大通知次數 (X)。
+ * - `intervalMinutes`：每次通知的時間間隔 (Y)（分鐘）。
+ * - `coolDownMinutes`：通知冷卻時間 (Z)（分鐘）。
+ * - `attachmentIdToResolve`：當特定附件標記已處理時停止通知。
+ */
+export interface RepeatedInformStrategy {
+    strategy: InformStrategyType.Repeated;
+    /** 最大通知次數 (X) */
+    maxAttempts: number;
+    /** 每次通知的時間間隔 (Y)（分鐘） */
+    intervalMinutes: number;
+    /** 通知冷卻時間 (Z)（分鐘） */
+    coolDownMinutes: number;
+    /** 若指定附件 ID 被標記已處理，則提前終止通知 */
+    attachmentIdToResolve?: string;
+}
+/**
+ * **子類型變化通知策略**
+ *
+ * 當同一事件類別 (`type`) 下的不同子類型 (`subType`) 出現變化時觸發通知。
+ *
+ * - `type`：事件類別，如 `visual`、`system`。
+ * - `previousSubType`：之前的事件子類型 (T0)。
+ * - `currentSubType`：新的事件子類型 (T1)。
+ */
+export interface SubTypeDifferenceInformStrategy {
+    strategy: InformStrategyType.Difference;
+    /** 事件類別 (例如 `visual` 或 `system`) */
+    type: EventType;
+    /** 之前的事件子類型 (T0) */
+    previousSubType: EventSubType;
+    /** 當前的事件子類型 (T1) */
+    currentSubType: EventSubType;
+}
+export type InformStrategyConfig = RepeatedInformStrategy | SubTypeDifferenceInformStrategy;
+//# sourceMappingURL=inform.d.ts.map

package/dist/models/inform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inform.d.ts","sourceRoot":"","sources":["../../models/inform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG/B;;;;;;;;;;GAUG;AACH,oBAAY,aAAa;IACvB,WAAW;IACX,KAAK,UAAU;IAEf,eAAe;IACf,GAAG,QAAQ;IAEX,+BAA+B;IAC/B,GAAG,QAAQ;IAEX,gCAAgC;IAChC,IAAI,SAAS;IAEb,UAAU;IACV,GAAG,QAAQ;IAEX,cAAc;IACd,OAAO,YAAY;CACpB;AAED;;;;;;;;GAQG;AACH,oBAAY,YAAY;IACtB,kBAAkB;IAClB,OAAO,YAAY;IAEnB,aAAa;IACb,IAAI,SAAS;IAEb,aAAa;IACb,IAAI,SAAS;IAEb,cAAc;IACd,MAAM,WAAW;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,MAAO,SAAQ,IAAI;IAClC,aAAa;IACb,OAAO,EAAE,MAAM,CAAC;IAEhB,aAAa;IACb,OAAO,EAAE,MAAM,CAAC;IAEhB,sBAAsB;IACtB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AACD,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG;IAC1C,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;CACxB,CAAA;AAGD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI;IAC9C,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB,iDAAiD;IACjD,OAAO,EAAE,aAAa,CAAC;IAEvB,YAAY;IACZ,MAAM,EAAE,YAAY,CAAC;IAErB,kCAAkC;IAClC,MAAM,CAAC,EAAE,IAAI,CAAC;CACf;AAGD;;;;;GAKG;AACH,oBAAY,kBAAkB;IAC5B,QAAQ,aAAa;IACrB,UAAU,eAAe;CAC1B;AACD;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,CAAC;IAEtC,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAC;IAEpB,wBAAwB;IACxB,eAAe,EAAE,MAAM,CAAC;IAExB,qBAAqB;IACrB,eAAe,EAAE,MAAM,CAAC;IAExB,8BAA8B;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC;IAExC,oCAAoC;IACpC,IAAI,EAAE,SAAS,CAAC;IAEhB,oBAAoB;IACpB,eAAe,EAAE,YAAY,CAAC;IAE9B,oBAAoB;IACpB,cAAc,EAAE,YAAY,CAAC;CAC9B;AACD,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,GACvD,+BAA+B,CAAC"}

package/dist/models/inform.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InformStrategyType = exports.InformStatus = exports.InformChannel = void 0;
+/**
+ * **通知發送渠道**
+ *
+ * 定義通知的傳送方式：
+ * - **`Email`**：透過電子郵件發送通知。
+ * - **`SMS`**：透過簡訊發送通知。
+ * - **`FCM`**：透過 Firebase Cloud Messaging (Android/Web) 推送通知。
+ * - **`APNs`**：透過 Apple Push Inform Service (iOS) 推送通知。
+ * - **`Web`**：透過通知 Web 。
+ * - **`Webhook`**：透過 Webhook 送達通知。
+ */
+var InformChannel;
+(function (InformChannel) {
+    /** 電子郵件 */
+    InformChannel["Email"] = "email";
+    /** 簡訊 (SMS) */
+    InformChannel["SMS"] = "sms";
+    /** Firebase Cloud Messaging */
+    InformChannel["FCM"] = "fcm";
+    /** Apple Push Inform Service */
+    InformChannel["APNs"] = "apns";
+    /** Web */
+    InformChannel["Web"] = "web";
+    /** Webhook */
+    InformChannel["Webhook"] = "webhook";
+})(InformChannel || (exports.InformChannel = InformChannel = {}));
+/**
+ * **通知狀態**
+ *
+ * 定義通知的處理狀態：
+ * - **`Pending`**：尚未發送。
+ * - **`Sent`**：已發送。
+ * - **`Read`**：已讀取。
+ * - **`Failed`**：發送失敗。
+ */
+var InformStatus;
+(function (InformStatus) {
+    /** 通知已建立，尚未發送。 */
+    InformStatus["Pending"] = "pending";
+    /** 通知已發送。 */
+    InformStatus["Sent"] = "sent";
+    /** 通知已讀取。 */
+    InformStatus["Read"] = "read";
+    /** 通知發送失敗。 */
+    InformStatus["Failed"] = "failed";
+})(InformStatus || (exports.InformStatus = InformStatus = {}));
+/**
+ * **通知策略類型**
+ *
+ * - `Repeated`：持續通知 X 次，每次間隔 Y 分鐘，直到 Z 分鐘或者被 attachment 標記已處理。
+ * - `Difference`：當 event 的同一種類的子類型 T1 和 T0 出現差異時通知。
+ */
+var InformStrategyType;
+(function (InformStrategyType) {
+    InformStrategyType["Repeated"] = "repeated";
+    InformStrategyType["Difference"] = "difference";
+})(InformStrategyType || (exports.InformStrategyType = InformStrategyType = {}));
+//# sourceMappingURL=inform.js.map

package/dist/models/inform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inform.js","sourceRoot":"","sources":["../../models/inform.ts"],"names":[],"mappings":";;;AAMA;;;;;;;;;;GAUG;AACH,IAAY,aAkBX;AAlBD,WAAY,aAAa;IACvB,WAAW;IACX,gCAAe,CAAA;IAEf,eAAe;IACf,4BAAW,CAAA;IAEX,+BAA+B;IAC/B,4BAAW,CAAA;IAEX,gCAAgC;IAChC,8BAAa,CAAA;IAEb,UAAU;IACV,4BAAW,CAAA;IAEX,cAAc;IACd,oCAAmB,CAAA;AACrB,CAAC,EAlBW,aAAa,6BAAb,aAAa,QAkBxB;AAED;;;;;;;;GAQG;AACH,IAAY,YAYX;AAZD,WAAY,YAAY;IACtB,kBAAkB;IAClB,mCAAmB,CAAA;IAEnB,aAAa;IACb,6BAAa,CAAA;IAEb,aAAa;IACb,6BAAa,CAAA;IAEb,cAAc;IACd,iCAAiB,CAAA;AACnB,CAAC,EAZW,YAAY,4BAAZ,YAAY,QAYvB;AA2DD;;;;;GAKG;AACH,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC5B,2CAAqB,CAAA;IACrB,+CAAyB,CAAA;AAC3B,CAAC,EAHW,kBAAkB,kCAAlB,kBAAkB,QAG7B"}

package/dist/models/map.d.ts

@@ -0,0 +1,26 @@
+import { Base } from './utils';
+/**
+ * **地圖介面**
+ * 用於儲存地圖的基本資訊，例如室內平面圖片及說明等。
+ *
+ * - **`name`**：地圖名稱。
+ * - **`imageUrl`**：地圖圖片的 URL，描述室內平面的圖片。
+ * - **`width`**：圖片長。
+ * - **`height`**圖片寬。
+ * - **`[description]`** _(可選)_：對地圖的附加說明，若無則為 `undefined`。
+ *
+ * @interface Map
+ */
+export interface Map extends Base {
+    /** 地圖名稱。 */
+    name: string;
+    /** 地圖圖片的 URL，描述室內平面的圖片。 */
+    imageUrl: string;
+    /** 圖片長 */
+    width: number;
+    /** 圖片寬 */
+    height: number;
+    /** 對地圖的附加說明，若無則為 `undefined`。 */
+    description?: string;
+}
+//# sourceMappingURL=map.d.ts.map

package/dist/models/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../models/map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,GAAI,SAAQ,IAAI;IAC/B,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IAEb,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IAEd,UAAU;IACV,MAAM,EAAE,MAAM,CAAC;IAEf,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/models/map.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=map.js.map

package/dist/models/map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../models/map.ts"],"names":[],"mappings":""}

package/dist/models/permission.d.ts

@@ -0,0 +1,83 @@
+/**
+ * **權限類別 (PermissionCategory)**
+ *
+ * 列舉所有權限的領域，讓每個權限可以歸屬到特定類別。
+ * 定義本系統中所有可能的功能/子系統。
+ * 例如：Chatroom, Inform, Event, Group, Server ...
+ * 未來若出現新功能，可在此擴充。
+ */
+export declare enum PermissionCategory {
+    /** 聊天室 */
+    Chatroom = "chatroom",
+    Inform = "inform",
+    Event = "event",
+    Report = "report",
+    Group = "group",
+    Server = "server"
+}
+/**
+ * **聊天室可用動作 (ChatroomPermissionAction)**
+ */
+export declare enum ChatroomPermissionAction {
+    /** 可讀取訊息 */
+    ReadMessage = "readMessage",
+    /** 可傳送訊息 */
+    SendMessage = "sendMessage",
+    /** 可編輯/刪除他人訊息 */
+    ManageMessages = "manageMessages",
+    /** 可管理聊天室 (新增移除成員、修改設定) */
+    ManageChatroom = "manageChatroom"
+}
+export declare enum ServerPermissionAction {
+    RestartServer = "restartServer",
+    ManageUsers = "manageUsers",
+    ConfigureSettings = "configureSettings"
+}
+export declare enum ReportPermissionAction {
+    ViewReport = "viewReport",
+    GenerateReport = "generateReport"
+}
+export declare enum GroupPermissionAction {
+    ViewGroup = "viewGroup",
+    CreateGroup = "createGroup",
+    EditGroup = "editGroup",
+    DeleteGroup = "deleteGroup",
+    ManageMembers = "manageMembers"
+}
+export declare enum InformPermissionAction {
+    ViewNotifications = "viewNotifications",
+    SendNotifications = "sendNotifications",
+    ManageNotifications = "manageNotifications"
+}
+export declare enum EventPermissionAction {
+    ViewEvent = "viewEvent",
+    CreateEvent = "createEvent",
+    EditEvent = "editEvent",
+    DeleteEvent = "deleteEvent",
+    ManageParticipants = "manageParticipants"
+}
+export type PermissionAction = ChatroomPermissionAction | ServerPermissionAction | ReportPermissionAction | GroupPermissionAction | InformPermissionAction | EventPermissionAction;
+export declare const PermissionActionMap: Record<PermissionCategory, Record<string, string>>;
+/**
+ * **權限 (Permission)**
+ *
+ * - **`id`**：唯一識別碼，用於標識該物件。
+ * - **`category`**：權限所屬的類別
+ * - **`action`**：可執行的動作 (如 "read", "create", "manageMessages" ...)
+ * - **`[description]`** _(可選)_：補充說明此權限在系統中代表的含義
+ */
+export interface Permission {
+    /** 唯一識別碼，用於標識該物件。 */
+    id: string;
+    /** 權限所屬的類別 */
+    category: PermissionCategory;
+    /**
+     * 權限的動作名稱，可用於程式邏輯判斷。
+     * 例如 "read", "write", "manageMessages", "viewAnalytics"...
+     * 視實際需求而定，可以自由定義。
+     */
+    action: PermissionAction;
+    /** 權限的補充說明，若無則為 `undefined` */
+    description?: string;
+}
+//# sourceMappingURL=permission.d.ts.map

package/dist/models/permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.d.ts","sourceRoot":"","sources":["../../models/permission.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AACH,oBAAY,kBAAkB;IAC5B,UAAU;IACV,QAAQ,aAAa;IAErB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,MAAM,WAAW;CAElB;AAGD;;GAEG;AACH,oBAAY,wBAAwB;IAClC,YAAY;IACZ,WAAW,gBAAgB;IAE3B,YAAY;IACZ,WAAW,gBAAgB;IAE3B,iBAAiB;IACjB,cAAc,mBAAmB;IAEjC,2BAA2B;IAC3B,cAAc,mBAAmB;CAClC;AAED,oBAAY,sBAAsB;IAChC,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,iBAAiB,sBAAsB;CACxC;AAED,oBAAY,sBAAsB;IAChC,UAAU,eAAe;IACzB,cAAc,mBAAmB;CAClC;AAED,oBAAY,qBAAqB;IAC/B,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;CAChC;AAED,oBAAY,sBAAsB;IAChC,iBAAiB,sBAAsB;IACvC,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;CAC5C;AAED,oBAAY,qBAAqB;IAC/B,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,kBAAkB,uBAAuB;CAC1C;AAED,MAAM,MAAM,gBAAgB,GAC1B,wBAAwB,GACxB,sBAAsB,GACtB,sBAAsB,GACtB,qBAAqB,GACrB,sBAAsB,GACtB,qBAAqB,CAAA;AAEvB,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOlF,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IAEX,cAAc;IACd,QAAQ,EAAE,kBAAkB,CAAC;IAE7B;;;;OAIG;IACH,MAAM,EAAE,gBAAgB,CAAC;IAEzB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}