@youjunhuang/entity-core 1.0.0

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

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

package/dist/models/attachment.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.imagePurposeArray = exports.textPurposeArray = void 0;
+// note = 人工備註（人員輸入的說明）
+// analysis = 系統自動分析結論（例如 AI summary）
+// ocr = 影像轉文字結果
+// systemLog = 系統內部 log/trace
+exports.textPurposeArray = ["note", "analysis", "ocr", "systemLog"];
+/**
+ * **圖片用途類型**
+ *
+ * 定義圖片在系統中的不同用途分類：
+ * - **`cover`**：封面圖片 - 用作事件、報告或內容的主要展示圖片
+ * - **`reference`**：參考圖片 - 提供額外的參考信息或背景資料
+ * - **`evidence`**：證據圖片 - 用於記錄或證明特定事實、狀況的圖片
+ * - **`derived`**：衍生圖片 - 從其他圖片處理、分析或生成的圖片
+ *
+ * @example
+ * ```typescript
+ * const coverImage: ImagePurpose = "cover";
+ * const evidencePhoto: ImagePurpose = "evidence";
+ * ```
+ */
+exports.imagePurposeArray = ["cover", "reference", "evidence", "derived"];
+//# sourceMappingURL=attachment.js.map

package/dist/models/attachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.js","sourceRoot":"","sources":["../../models/attachment.ts"],"names":[],"mappings":";;;AA6CA,uBAAuB;AACvB,qCAAqC;AACrC,gBAAgB;AAChB,6BAA6B;AAChB,QAAA,gBAAgB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,CAAA;AAkBxE;;;;;;;;;;;;;;GAcG;AACU,QAAA,iBAAiB,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC"}

package/dist/models/auth-credential.d.ts

@@ -0,0 +1,46 @@
+import { User } from "./user";
+import { Base } from "./utils";
+export declare enum BiometricType {
+    Face = "face",
+    Voice = "voice",
+    Fingerprint = "fingerprint"
+}
+export interface PasswordCredential extends Base {
+    /** 關聯的使用者 ID。 */
+    userId: User["id"];
+    /** 密碼 */
+    passwordHash: string;
+    /** 是否啟用此密碼登入 */
+    isActive: boolean;
+}
+export interface BiometricCredential extends Base {
+    /** 關聯的使用者 ID。 */
+    userId: User["id"];
+    /** 生物識別憑證類型 */
+    biometricType: BiometricType;
+    /** 特徵檔案的儲存路徑 */
+    embeddingFilePath: string;
+    /** 原始檔案的儲存路徑 */
+    rawFilePath: string;
+    /** 是否啟用此生物識別憑證 */
+    isActive: boolean;
+    /** 描述此生物識別憑證 (例如: 右手食指) */
+    description: string;
+}
+export interface ThirdPartyCredential extends Base {
+    /** 關聯的使用者 ID。 */
+    userId: User["id"];
+    /** 第三方服務提供者名稱 (例如: Google, Facebook) */
+    providerName: string;
+    /** 第三方服務提供者的使用者 ID */
+    providerUserId: string;
+    /** 第三方服務提供者的電子郵件地址 */
+    providerEmail: string;
+    /** 第三方服務提供者的顯示名稱 */
+    providerDisplayName: string;
+    /** 第三方服務提供者的頭像 URL */
+    providerAvatarUrl: string;
+    /** 是否啟用此第三方登入憑證 */
+    isActive: boolean;
+}
+//# sourceMappingURL=auth-credential.d.ts.map

package/dist/models/auth-credential.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-credential.d.ts","sourceRoot":"","sources":["../../models/auth-credential.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,WAAW,gBAAgB;CAC5B;AAED,MAAM,WAAW,kBAAmB,SAAQ,IAAI;IAC9C,iBAAiB;IACjB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEnB,SAAS;IACT,YAAY,EAAE,MAAM,CAAC;IAErB,gBAAgB;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAoB,SAAQ,IAAI;IAC/C,iBAAiB;IACjB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEnB,eAAe;IACf,aAAa,EAAE,aAAa,CAAC;IAE7B,gBAAgB;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAE1B,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;IAEpB,kBAAkB;IAClB,QAAQ,EAAE,OAAO,CAAC;IAElB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAqB,SAAQ,IAAI;IAChD,iBAAiB;IACjB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEnB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IAErB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IAEvB,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;IAEtB,oBAAoB;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAE5B,sBAAsB;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAE1B,mBAAmB;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/models/auth-credential.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiometricType = void 0;
+var BiometricType;
+(function (BiometricType) {
+    BiometricType["Face"] = "face";
+    BiometricType["Voice"] = "voice";
+    BiometricType["Fingerprint"] = "fingerprint";
+})(BiometricType || (exports.BiometricType = BiometricType = {}));
+//# sourceMappingURL=auth-credential.js.map

package/dist/models/auth-credential.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-credential.js","sourceRoot":"","sources":["../../models/auth-credential.ts"],"names":[],"mappings":";;;AAGA,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,gCAAe,CAAA;IACf,4CAA2B,CAAA;AAC7B,CAAC,EAJW,aAAa,6BAAb,aAAa,QAIxB"}

package/dist/models/camera.d.ts

@@ -0,0 +1,156 @@
+import { Device } from './device';
+import { Base } from './utils';
+import { Map } from './map';
+/**
+ * **攝影機狀態 (CameraStatus)**
+ * - **`Inactive`**：系統層面「禁用」此攝影機
+ * - **`NoStream`**：尚未開始串流
+ * - **`Offline`**：已開始串流，但物理/網路層無法連線
+ * - **`Online`**：攝影機正在串流
+ */
+export declare enum CameraStatus {
+    Inactive = "inactive",
+    NoStream = "no_stream",
+    Offline = "offline",
+    Online = "online"
+}
+export declare const CameraStatusMap: Record<string, CameraStatus>;
+/**
+ * **攝影機類型 (CameraType)**
+ * - **`Shotgun`**：槍型攝影機
+ * - **`Panoramic`**：全景攝影機
+ */
+export declare enum CameraType {
+    SHOTGUN = "shotgun",
+    PANORAMIC = "panoramic"
+}
+/**
+ * **攝影機 (Camera)**
+ *
+ * 繼承自通用的 `Device`，並額外加入攝影機相關的欄位：
+ * - **`[rtspUrl]`** (若為 RTSP 型)
+ * - **`status`** (Disabled/Offline/NoStream/Online)
+ * - **`fps`** _(可選)_: 每秒影格數 (Frames Per Second)
+ * - **`encodingFormat`** _(可選)_: 影像編碼格式 (例如 "H.264", "H.265")
+ * - **`[mapId]`, `[x]`, `[y]`** _(可選)_: 地圖、定位X, Y座標
+ * - **`resolutionWidth`, `resolutionHeight`** _(可選)_: 解析度寬、長
+ */
+export interface Camera extends Device {
+    /**
+     * 攝影機類型 (槍型/全景)
+     * @default CameraType.SHOTGUN
+     */
+    type: CameraType;
+    /**
+     * 攝影機串流 URL (若為 RTSP)
+     * @example "rtsp://192.168.1.100/live/1"
+     *
+     * - 對 USB 來說可能不適用，可以選擇性處理
+     */
+    rtspUrl?: string;
+    /**
+     * 攝影機狀態
+     * @default CameraStatus.Offline
+     */
+    status: CameraStatus;
+    /**
+     * 解析度寬度 (px)
+     * @example 1920
+     */
+    resolutionWidth?: number;
+    /**
+     * 解析度高度 (px)
+     * @example 1080
+     */
+    resolutionHeight?: number;
+    /**
+     * 每秒影格數 (Frames Per Second)。
+     * @example 30
+     */
+    fps?: number;
+    /**
+     * 影像編碼格式，例如 "H.264" 或 "H.265"。
+     * @example "H.264"
+     */
+    encodingFormat?: string;
+    /**
+     * 攝影機名稱 (可選)
+     * @example "Front Door Camera"
+     */
+    name: string;
+    /**
+     * 攝影機代碼 (可選)
+     * @example "CAM001"
+     */
+    code: string;
+    /**
+     * 攝影機的型號 (DeviceModel)
+     * @example "D-Link DCS-930L"
+     */
+    deviceModel: string;
+    /**
+     * 裝置/攝影機描述
+     * @example "監看大門人流，連接至 NVR-01"
+     */
+    description?: string;
+    location?: {
+        coordinates: [string, string];
+        area?: string;
+    };
+    /**
+    * 對應的地圖 ID，用於標識此攝影機隸屬哪個地圖
+    */
+    mapId?: Map['id'];
+    localPosition?: {
+        /**
+       * 攝影機在地圖上的 X 座標 (可選)
+       * @example 150
+       */
+        x: number;
+        /**
+         * 攝影機在地圖上的 Y 座標 (可選)
+         * @example 80
+         */
+        y: number;
+    };
+}
+/**
+ * **攝影機歷史影像 (CameraRecording)**
+ *
+ * 繼承自通用的 `Base`，並額外加入攝影機相關的欄位：
+ */
+export interface CameraRecording extends Base {
+    /**
+     * 攝影機 ID
+     */
+    cameraId: Camera['id'];
+    /**
+     * 開始時間
+     */
+    startTime: Date;
+    /**
+     * 結束時間
+     */
+    endTime: Date;
+    /**
+     * 錄影時長 (單位: 秒)
+     * @example 300 // 5分鐘
+     */
+    during: number;
+    /**
+     * 影片檔案路徑
+     * @example "https://example.com/recordings/video123.mp4"
+     */
+    videoUrl: string;
+    /**
+     * 縮圖路徑
+     * @example "https://example.com/recordings/snapshot123.jpg"
+     */
+    snapshotUrl: string;
+    /**
+     * 影片解析度
+     * @example "1920x1080"
+     */
+    resolution: string;
+}
+//# sourceMappingURL=camera.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../models/camera.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B;;;;;;GAMG;AACH,oBAAY,YAAY;IACtB,QAAQ,aAAa;IACrB,QAAQ,cAAc;IACtB,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAKxD,CAAC;AAEF;;;;GAIG;AACH,oBAAY,UAAU;IACpB,OAAO,YAAY;IACnB,SAAS,cAAc;CACxB;AAGD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,MAAO,SAAQ,MAAM;IACpC;;;OAGG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,MAAM,EAAE,YAAY,CAAC;IAErB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,QAAQ,CAAC,EAAE;QACT,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAIF;;MAEE;IACF,KAAK,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAClB,aAAa,CAAC,EAAE;QACd;;;SAGC;QACD,CAAC,EAAE,MAAM,CAAC;QAEV;;;WAGG;QACH,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;CACH;AAED;;;;GAIG;AAEH,MAAM,WAAW,eAAgB,SAAQ,IAAI;IAC3C;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,SAAS,EAAE,IAAI,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,IAAI,CAAC;IAEd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/models/camera.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CameraType = exports.CameraStatusMap = exports.CameraStatus = void 0;
+/**
+ * **攝影機狀態 (CameraStatus)**
+ * - **`Inactive`**：系統層面「禁用」此攝影機
+ * - **`NoStream`**：尚未開始串流
+ * - **`Offline`**：已開始串流，但物理/網路層無法連線
+ * - **`Online`**：攝影機正在串流
+ */
+var CameraStatus;
+(function (CameraStatus) {
+    CameraStatus["Inactive"] = "inactive";
+    CameraStatus["NoStream"] = "no_stream";
+    CameraStatus["Offline"] = "offline";
+    CameraStatus["Online"] = "online";
+})(CameraStatus || (exports.CameraStatus = CameraStatus = {}));
+exports.CameraStatusMap = {
+    '在線': CameraStatus.Online,
+    '離線': CameraStatus.Offline,
+    '無串流': CameraStatus.NoStream,
+    '未啟用': CameraStatus.Inactive,
+};
+/**
+ * **攝影機類型 (CameraType)**
+ * - **`Shotgun`**：槍型攝影機
+ * - **`Panoramic`**：全景攝影機
+ */
+var CameraType;
+(function (CameraType) {
+    CameraType["SHOTGUN"] = "shotgun";
+    CameraType["PANORAMIC"] = "panoramic";
+})(CameraType || (exports.CameraType = CameraType = {}));
+//# sourceMappingURL=camera.js.map

package/dist/models/camera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.js","sourceRoot":"","sources":["../../models/camera.ts"],"names":[],"mappings":";;;AAIA;;;;;;GAMG;AACH,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,sCAAsB,CAAA;IACtB,mCAAmB,CAAA;IACnB,iCAAiB,CAAA;AACnB,CAAC,EALW,YAAY,4BAAZ,YAAY,QAKvB;AAEY,QAAA,eAAe,GAAiC;IAC3D,IAAI,EAAE,YAAY,CAAC,MAAM;IACzB,IAAI,EAAE,YAAY,CAAC,OAAO;IAC1B,KAAK,EAAE,YAAY,CAAC,QAAQ;IAC5B,KAAK,EAAE,YAAY,CAAC,QAAQ;CAC7B,CAAC;AAEF;;;;GAIG;AACH,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,qCAAuB,CAAA;AACzB,CAAC,EAHW,UAAU,0BAAV,UAAU,QAGrB"}

package/dist/models/chatroom.d.ts

@@ -0,0 +1,55 @@
+import { Base } from './utils';
+import { Membership } from './role';
+import { Attachment } from './attachment';
+/**
+ * **聊天室 (Chatroom)**
+ *
+ * - **`name`**：聊天室名稱
+ */
+export interface Chatroom extends Base {
+    /** 聊天室名稱 */
+    name: string;
+}
+export type Message = Attachment & {
+    attachTo?: never;
+    chatroomId: Chatroom['id'];
+};
+export type ChatroomMember = Membership & {
+    ownerType?: never;
+    ownerId?: never;
+    chatroomId: Chatroom['id'];
+};
+/**
+ * ======================================
+ *  Channel / Category
+ * ======================================
+ *
+ * 若您需要像 Discord 一樣，在 Server 底下有多個 Category (分類)，
+ * 在 Category 底下再有多個 Channel (頻道)。
+ */
+/**
+ * **分類 (Category)**
+ * - `serverId`: 隸屬哪個伺服器
+ * - `name`: 分類名稱，如 "文字頻道", "語音頻道"
+ */
+export interface Category extends Base {
+    /** 隸屬哪個伺服器 */
+    serverId: string;
+    /** 分類名稱 */
+    name: string;
+}
+/**
+ * **頻道 (Channel)**
+ * - `serverId`: 隸屬哪個伺服器
+ * - `categoryId`: 所屬的分類 (可選，可能有些頻道不屬於分類)
+ * - `name`: 頻道名稱，如 "公告", "閒聊"
+ */
+export interface Channel extends Base {
+    /** 隸屬哪個伺服器 */
+    serverId: string;
+    /** 所屬分類 ID，若無則為 undefined */
+    categoryId?: Category['id'];
+    /** 頻道名稱 */
+    name: string;
+}
+//# sourceMappingURL=chatroom.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chatroom.d.ts","sourceRoot":"","sources":["../../models/chatroom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAQ,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,QAAS,SAAQ,IAAI;IACpC,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG;IACjC,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;CAC3B,CAAA;AAGD,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;IACxC,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAA;AAED;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,WAAW,QAAS,SAAQ,IAAI;IACpC,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IAEjB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAQ,SAAQ,IAAI;IACnC,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IAEjB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE5B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/models/chatroom.js

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

package/dist/models/chatroom.js.map

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

package/dist/models/device.d.ts

@@ -0,0 +1,50 @@
+import { Base } from './utils';
+/**
+ * **裝置 (Device)**
+ *
+ * 作為所有可管理設備的基礎介面，包含通用的欄位：
+ * - 名稱、廠牌、型號
+ * - 序號、韌體版本
+ * - 安裝日期
+ * - 心跳時間 (只暫存於記憶體，不進 DB)
+ */
+export interface Device extends Base {
+    /**
+     * 設備名稱
+     * @example "大門口攝影機" 或 "溫度感測器 #1"
+     */
+    name: string;
+    /**
+     * 廠牌 (如 Dahua, HikVision, 自家廠牌)
+     * @example "Dahua"
+     */
+    manufacturer?: string;
+    /**
+     * 型號 (如 IPC-HDW2431T-AS)
+     * @example "IPC-HDW2431T-AS"
+     */
+    model?: string;
+    /**
+     * 設備序號，方便設備管理
+     * @example "SN1234567890"
+     */
+    serialNumber?: string;
+    /**
+     * 韌體版本，用於維護或更新追蹤
+     * @example "v2.3.4"
+     */
+    firmwareVersion?: string;
+    /**
+     * 安裝日期，用於記錄何時開始使用
+     * @example new Date("2025-01-15")
+     */
+    installationDate?: Date;
+    /**
+     * 最後一次健康檢查或心跳 (heartbeat) 時間
+     * - **只存在於 RAM 中，不會寫入資料庫**
+     * - 可用於判斷裝置是否長期未回報
+     * @example new Date()
+     */
+    lastHeartbeatAt?: Date;
+}
+//# sourceMappingURL=device.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../models/device.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B;;;;;;;;GAQG;AACH,MAAM,WAAW,MAAO,SAAQ,IAAI;IAChC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,IAAI,CAAC;IAExB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,IAAI,CAAC;CAC1B"}

package/dist/models/device.js

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

package/dist/models/device.js.map

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

package/dist/models/event.d.ts

@@ -0,0 +1,170 @@
+import { EventCategory, EventType, EventTemplate } from './template';
+import { Base } from './utils';
+/**
+ * 視覺辨識類事件子類型 (VisualSubType)
+ *
+ * @enum {string}
+ * @description
+ *   此枚舉列出所有視覺辨識相關的事件子類型，
+ *   例如超速、車禍、倒地等。
+ */
+export declare enum VisualSubType {
+    /** 超速 */
+    OverSpeed = "overSpeed",
+    /** 車禍 */
+    CarAccident = "carAccident",
+    /** 倒地 */
+    FallDown = "fallDown",
+    /** 違規右轉 */
+    IllegalRightTurn = "illegalRightTurn",
+    /** 異常停留 */
+    AbnormalStay = "abnormalStay",
+    /** 穿著不正確 */
+    ImproperDress = "improperDress",
+    /** 器械數量錯誤 */
+    EquipmentCountError = "equipmentCountError",
+    /** 器械順序錯誤 */
+    EquipmentOrderError = "equipmentOrderError"
+}
+/**
+* 系統類事件子類型 (SystemSubType)
+*
+* @enum {string}
+* @description
+*   此枚舉列出所有系統相關的事件子類型，
+*   例如設備故障、服務崩潰、數據異常等。
+*/
+export declare enum SystemSubType {
+    /** 設備故障 */
+    DeviceFailure = "deviceFailure",
+    /** 服務崩潰 */
+    ServiceCrash = "serviceCrash",
+    /** 數據異常 */
+    DataAnomaly = "dataAnomaly"
+}
+/**
+* 使用者行為類事件子類型 (UserBehaviorSubType)
+*
+* @enum {string}
+* @description
+*   此枚舉列出所有使用者行為相關的事件子類型，
+*   例如異常登入、權限違規操作等。
+*/
+export declare enum UserBehaviorSubType {
+    /** 異常登入 */
+    AbnormalLogin = "abnormalLogin",
+    /** 權限違規操作 */
+    PermissionViolation = "permissionViolation"
+}
+/**
+ * 醫療類事件子類型 (MedicalSubType)
+ *
+ * @enum {string}
+ * @description
+ *   此枚舉列出所有醫療相關的事件子類型，
+ *   例如抵達等候室時間、手術開始時間等。
+ */
+export declare enum MedicalSubType {
+    /** 抵達等候室時間 */
+    ArriveWaitingRoomTime = "arriveWaitingRoomTime",
+    /** 入手術房時間 */
+    EnterOperatingRoomTime = "enterOperatingRoomTime",
+    /** 麻醉開始時間 */
+    AnesthesiaStartTime = "anesthesiaStartTime",
+    /** 手術開始時間 */
+    SurgeryStartTime = "surgeryStartTime",
+    /** 手術結束時間 */
+    SurgeryEndTime = "surgeryEndTime",
+    /** 病人至下個單位時間 */
+    PatientToNextUnitTime = "patientToNextUnitTime",
+    /** 手術類別 */
+    SurgeryType = "surgeryType",
+    /** 麻醉方式 */
+    AnesthesiaType = "anesthesiaType",
+    /** 照會其他科手術 */
+    ConsultOtherDepartmentSurgery = "consultOtherDepartmentSurgery",
+    /** 擺位正確 */
+    CorrectPositioning = "correctPositioning",
+    /** 植入物 */
+    Implant = "implant",
+    /** Timeout查核項目/時間 */
+    TimeoutCheckItemTime = "timeoutCheckItemTime",
+    /** 確認血品 */
+    ConfirmBloodProduct = "confirmBloodProduct",
+    /** 畫刀前六十分鐘內給予預防性抗生素 */
+    AdministerProphylacticAntibioticWithin60MinutesBeforeIncision = "administerProphylacticAntibioticWithin60MinutesBeforeIncision"
+}
+/**
+* 統合的事件子類型 (EventSubType)
+*
+* @typedef {VisualSubType | SystemSubType | UserBehaviorSubType} EventSubType
+* @description
+*   利用 TypeScript 聯合型別 (Union) 將三個不同的大類事件子類型合併。
+*   若程式中某處需要一個既能表示「視覺辨識類」、
+*   「系統異常類」或「使用者行為類」的子類型，則可使用本型別。
+*/
+export declare const EventSubTypeEnum: readonly (VisualSubType | SystemSubType | UserBehaviorSubType | MedicalSubType)[];
+export type EventSubType = (typeof EventSubTypeEnum)[number];
+/**
+ * **事件狀態 (EventStatus)**
+ *
+ * 定義事件處理的常見狀態：
+ * - **`Unprocessed`**：事件尚未處理（初始狀態）。
+ * - **`Notified`**：事件已通知相關人員，但尚未開始處理。
+ * - **`Processing`**：事件正在處理中。
+ * - **`Completed`**：事件處理完成。
+ *
+ * @enum {string}
+ */
+export declare enum EventStatus {
+    Unprocessed = "unprocessed",
+    Notified = "notified",
+    Processing = "processing",
+    Completed = "completed"
+}
+export declare enum SubjectType {
+    Entrance = "Entrance",
+    Camera = "Camera",
+    Device = "Device",
+    User = "User"
+}
+export interface Event extends Base {
+    /** 關聯樣板 */
+    readonly templateId: EventTemplate['id'];
+    /** 冗餘寫入，便於查詢（避免 Join/Lookup） */
+    readonly category: EventCategory;
+    readonly type: EventType;
+    /** 主體（來源） */
+    readonly subjectType: SubjectType;
+    readonly subjectId: string;
+    /** 嚴重度（可覆蓋 Template 預設；建議一經寫入不再改動） */
+    readonly severity?: number;
+    /** （可選）事件狀態；若遵循「事件不可動」可不放此欄位，改由 Note 追蹤 */
+    readonly status?: EventStatus;
+    /** 描述文（AI 或人為產生）；建議寫入後不再變更 */
+    readonly description?: string | null;
+    /** 事件實際發生時間（來源設備/AI 的時間） */
+    readonly occurredAt: Date;
+    /** （可選）事件群組/事故 ID（做關聯彙整） */
+    readonly groupId?: string | null;
+    /** （可選）去重指紋，用於抑制重複事件 */
+    readonly fingerprint?: string | null;
+    /** （可選）標準化子型與自由標籤（若需要可加在 event_data.norm） */
+    readonly subTypes?: string[];
+    readonly freeTags?: string[];
+    /** （可選）人臉reid */
+    readonly reId?: string | null;
+    /** （可選）處理截圖URL */
+    readonly snapshotUrl?: string | null;
+}
+export interface EventData {
+    id: string;
+    eventId: Event['id'];
+    schemaRef?: string | null;
+    version: string;
+    payload: {
+        norm?: Record<string, unknown>;
+        raw?: Record<string, unknown>;
+    };
+}
+//# sourceMappingURL=event.d.ts.map

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

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