@panguard-ai/core 0.1.0

package/dist/utils/logger.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Structured JSON logger for Panguard AI
+ * Panguard 安全平台結構化 JSON 日誌記錄器
+ *
+ * @module @panguard-ai/core/utils/logger
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/**
+ * Set the minimum log level
+ * 設定最低日誌等級
+ *
+ * @param level - Minimum log level / 最低日誌等級
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * Logger interface with module-scoped methods
+ * 具有模組範圍方法的日誌記錄器介面
+ */
+export interface Logger {
+    /** Log debug message / 記錄除錯訊息 */
+    debug: (message: string, context?: Record<string, unknown>) => void;
+    /** Log info message / 記錄資訊訊息 */
+    info: (message: string, context?: Record<string, unknown>) => void;
+    /** Log warning message / 記錄警告訊息 */
+    warn: (message: string, context?: Record<string, unknown>) => void;
+    /** Log error message / 記錄錯誤訊息 */
+    error: (message: string, context?: Record<string, unknown>) => void;
+}
+/**
+ * Create a logger scoped to a specific module
+ * 建立範圍限定於特定模組的日誌記錄器
+ *
+ * @param module - Module name / 模組名稱
+ * @returns Logger instance / 日誌記錄器實例
+ */
+export declare function createLogger(module: string): Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAY/D;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAyCD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,iCAAiC;IACjC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpE,gCAAgC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACnE,mCAAmC;IACnC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACnE,iCAAiC;IACjC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACrE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWnD"}

package/dist/utils/logger.js

@@ -0,0 +1,71 @@
+/**
+ * Structured JSON logger for Panguard AI
+ * Panguard 安全平台結構化 JSON 日誌記錄器
+ *
+ * @module @panguard-ai/core/utils/logger
+ */
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+let currentLevel = 'info';
+/**
+ * Set the minimum log level
+ * 設定最低日誌等級
+ *
+ * @param level - Minimum log level / 最低日誌等級
+ */
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+/**
+ * Create a structured log entry and output to stderr
+ * 建立結構化日誌條目並輸出到 stderr
+ *
+ * @param level - Log level / 日誌等級
+ * @param message - Log message / 日誌訊息
+ * @param module - Module name / 模組名稱
+ * @param context - Additional context / 額外上下文
+ */
+function log(level, message, module, context) {
+    if (LOG_LEVELS[level] < LOG_LEVELS[currentLevel]) {
+        return;
+    }
+    const entry = {
+        timestamp: new Date().toISOString(),
+        level,
+        message,
+        module,
+        ...(context ? { context } : {}),
+    };
+    const output = JSON.stringify(entry);
+    if (level === 'error') {
+        console.error(output);
+    }
+    else if (level === 'warn') {
+        console.warn(output);
+    }
+    else {
+        // Use stderr to avoid polluting stdout for info/debug
+        process.stderr.write(output + '\n');
+    }
+}
+/**
+ * Create a logger scoped to a specific module
+ * 建立範圍限定於特定模組的日誌記錄器
+ *
+ * @param module - Module name / 模組名稱
+ * @returns Logger instance / 日誌記錄器實例
+ */
+export function createLogger(module) {
+    return {
+        debug: (message, context) => log('debug', message, module, context),
+        info: (message, context) => log('info', message, module, context),
+        warn: (message, context) => log('warn', message, module, context),
+        error: (message, context) => log('error', message, module, context),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACV,CAAC;AAEF,IAAI,YAAY,GAAa,MAAM,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,GAAG,CACV,KAA0C,EAC1C,OAAe,EACf,MAAc,EACd,OAAiC;IAEjC,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjD,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK;QACL,OAAO;QACP,MAAM;QACN,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAErC,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;SAAM,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,sDAAsD;QACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAiBD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO;QACL,KAAK,EAAE,CAAC,OAAe,EAAE,OAAiC,EAAE,EAAE,CAC5D,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;QACxC,IAAI,EAAE,CAAC,OAAe,EAAE,OAAiC,EAAE,EAAE,CAC3D,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;QACvC,IAAI,EAAE,CAAC,OAAe,EAAE,OAAiC,EAAE,EAAE,CAC3D,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;QACvC,KAAK,EAAE,CAAC,OAAe,EAAE,OAAiC,EAAE,EAAE,CAC5D,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;KACzC,CAAC;AACJ,CAAC"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Input validation utilities using Zod
+ * 使用 Zod 的輸入驗證工具
+ *
+ * @module @panguard-ai/core/utils/validation
+ */
+import { z } from 'zod';
+/**
+ * Validate input data against a Zod schema
+ * 使用 Zod schema 驗證輸入資料
+ *
+ * @param schema - Zod validation schema / Zod 驗證 schema
+ * @param data - Data to validate / 要驗證的資料
+ * @returns Validated and typed data / 驗證後的型別化資料
+ * @throws Error if validation fails / 驗證失敗時拋出錯誤
+ */
+export declare function validateInput<T>(schema: z.ZodSchema<T>, data: unknown): T;
+/**
+ * Sanitize a string by removing potentially dangerous characters
+ * 清理字串，移除潛在危險字元
+ *
+ * @param input - Raw string input / 原始字串輸入
+ * @returns Sanitized string / 清理後的字串
+ */
+export declare function sanitizeString(input: string): string;
+/**
+ * Validate and sanitize a file path to prevent directory traversal
+ * 驗證並清理檔案路徑以防止目錄遍歷攻擊
+ *
+ * @param filePath - File path to validate / 要驗證的檔案路徑
+ * @returns Sanitized file path / 清理後的檔案路徑
+ * @throws Error if path contains traversal patterns / 路徑包含遍歷模式時拋出錯誤
+ */
+export declare function validateFilePath(filePath: string): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAOzE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASzD"}

package/dist/utils/validation.js

@@ -0,0 +1,56 @@
+/**
+ * Input validation utilities using Zod
+ * 使用 Zod 的輸入驗證工具
+ *
+ * @module @panguard-ai/core/utils/validation
+ */
+/**
+ * Validate input data against a Zod schema
+ * 使用 Zod schema 驗證輸入資料
+ *
+ * @param schema - Zod validation schema / Zod 驗證 schema
+ * @param data - Data to validate / 要驗證的資料
+ * @returns Validated and typed data / 驗證後的型別化資料
+ * @throws Error if validation fails / 驗證失敗時拋出錯誤
+ */
+export function validateInput(schema, data) {
+    const result = schema.safeParse(data);
+    if (!result.success) {
+        const messages = result.error.errors.map((e) => `${e.path.join('.')}: ${e.message}`).join('; ');
+        throw new Error(`Validation failed: ${messages}`);
+    }
+    return result.data;
+}
+/**
+ * Sanitize a string by removing potentially dangerous characters
+ * 清理字串，移除潛在危險字元
+ *
+ * @param input - Raw string input / 原始字串輸入
+ * @returns Sanitized string / 清理後的字串
+ */
+export function sanitizeString(input) {
+    return input
+        .replace(/[<>]/g, '')
+        .replace(/javascript:/gi, '')
+        .replace(/on\w+=/gi, '')
+        .trim();
+}
+/**
+ * Validate and sanitize a file path to prevent directory traversal
+ * 驗證並清理檔案路徑以防止目錄遍歷攻擊
+ *
+ * @param filePath - File path to validate / 要驗證的檔案路徑
+ * @returns Sanitized file path / 清理後的檔案路徑
+ * @throws Error if path contains traversal patterns / 路徑包含遍歷模式時拋出錯誤
+ */
+export function validateFilePath(filePath) {
+    const normalized = filePath.replace(/\\/g, '/');
+    if (normalized.includes('..')) {
+        throw new Error('Directory traversal detected in file path / 偵測到檔案路徑中的目錄遍歷');
+    }
+    if (normalized.includes('\0')) {
+        throw new Error('Null byte detected in file path / 偵測到檔案路徑中的空位元組');
+    }
+    return normalized;
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAI,MAAsB,EAAE,IAAa;IACpE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChG,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK;SACT,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;SAC5B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@panguard-ai/core",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Core shared modules for Panguard AI / Panguard 安全平台核心共用模組",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./i18n": {
+      "import": "./dist/i18n/index.js",
+      "types": "./dist/i18n/index.d.ts"
+    },
+    "./utils": {
+      "import": "./dist/utils/index.js",
+      "types": "./dist/utils/index.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "dev": "tsc --build --watch",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "i18next": "^24.2.2",
+    "js-yaml": "^4.1.0",
+    "zod": "^3.24.0"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": ">=0.30.0",
+    "openai": ">=4.70.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    },
+    "openai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.14.0",
+    "typescript": "~5.7.3"
+  }
+}