hik-iot-sdk 1.0.0

package/dist/core/http.js

@@ -0,0 +1,134 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const pino_1 = __importDefault(require("pino"));
+const zod_1 = require("zod");
+const errors_1 = require("./errors");
+const crypto_1 = require("./crypto");
+const logger = (0, pino_1.default)({ name: 'hik-http' });
+const BaseResponseSchema = zod_1.z.object({
+    code: zod_1.z.number(),
+    msg: zod_1.z.string(),
+    data: zod_1.z.unknown().optional(),
+    detail: zod_1.z.string().optional().nullable(),
+    count: zod_1.z.number().optional(),
+});
+class HttpClient {
+    constructor(config, authManager) {
+        this.config = config;
+        this.authManager = authManager;
+        this.crypto = new crypto_1.HikCrypto(config.appSecret);
+        this.client = axios_1.default.create({
+            baseURL: config.baseUrl,
+            timeout: config.timeout,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        this.setupInterceptors();
+    }
+    setupInterceptors() {
+        this.client.interceptors.request.use(async (config) => {
+            const appAccessToken = await this.authManager.getAppAccessToken();
+            config.headers = config.headers ?? {};
+            config.headers['App-Access-Token'] = appAccessToken;
+            const userAccessToken = await this.authManager.getUserAccessToken();
+            config.headers['User-Access-Token'] = userAccessToken;
+            logger.debug({
+                method: config.method,
+                url: config.url,
+                data: config.data,
+            }, 'HTTP Request');
+            return config;
+        }, (error) => {
+            logger.error({ error }, 'Request interceptor error');
+            return Promise.reject(error);
+        });
+        this.client.interceptors.response.use((response) => {
+            logger.debug({
+                status: response.status,
+                data: response.data,
+            }, 'HTTP Response');
+            return response;
+        }, async (error) => {
+            if (axios_1.default.isAxiosError(error) && error.response) {
+                const { status, data } = error.response;
+                const errorCode = typeof data === 'object' &&
+                    data !== null &&
+                    'code' in data &&
+                    typeof data.code === 'number'
+                    ? data.code
+                    : undefined;
+                if (status === 401 || errorCode === errors_1.ERROR_CODES.INVALID_APP_ACCESS_TOKEN) {
+                    logger.info('Token expired, refreshing and retrying');
+                    this.authManager.clearAppToken();
+                    const originalRequest = error.config;
+                    if (originalRequest && !originalRequest._retry) {
+                        originalRequest._retry = true;
+                        const newToken = await this.authManager.getAppAccessToken();
+                        originalRequest.headers = originalRequest.headers ?? {};
+                        originalRequest.headers['App-Access-Token'] = newToken;
+                        return this.client(originalRequest);
+                    }
+                }
+                logger.error({ status, data }, 'HTTP Error Response');
+            }
+            return Promise.reject(error);
+        });
+    }
+    async post(path, data, schema) {
+        let requestData = data;
+        // 加密请求体
+        if (this.config.enableEncrypt && data && Object.keys(data).length > 0) {
+            requestData = this.crypto.encryptBody(data);
+        }
+        const response = await this.client.post(path, requestData);
+        return this.handleResponse(response, schema);
+    }
+    async get(path, config, schema) {
+        let requestConfig = config || {};
+        // 加密查询参数
+        if (this.config.enableEncrypt && requestConfig.params && Object.keys(requestConfig.params).length > 0) {
+            const querySecret = this.crypto.encryptParams(requestConfig.params);
+            requestConfig = { ...requestConfig, params: { querySecret } };
+        }
+        const response = await this.client.get(path, requestConfig);
+        return this.handleResponse(response, schema);
+    }
+    handleResponse(response, schema) {
+        let responseData = response.data;
+        // 解密响应数据
+        if (this.config.enableEncrypt && responseData.data && typeof responseData.data === 'string') {
+            try {
+                const decryptedData = this.crypto.decrypt(responseData.data);
+                responseData = {
+                    ...responseData,
+                    data: JSON.parse(decryptedData),
+                };
+            }
+            catch (error) {
+                logger.warn({ error }, 'Failed to decrypt response data');
+            }
+        }
+        const baseResult = BaseResponseSchema.parse(responseData);
+        if (baseResult.code !== 0) {
+            if (baseResult.code >= 160000 && baseResult.code < 170000) {
+                throw new errors_1.HikDeviceError(baseResult.code, baseResult.msg, baseResult.detail ?? undefined);
+            }
+            throw errors_1.HikError.fromResponse({
+                code: baseResult.code,
+                msg: baseResult.msg,
+                detail: baseResult.detail ?? undefined,
+            });
+        }
+        if (schema) {
+            return schema.parse(responseData);
+        }
+        return responseData;
+    }
+}
+exports.HttpClient = HttpClient;

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { HikSdk } from './sdk';
+export { HikError, HikAuthError, HikDeviceError, ERROR_CODES } from './core/errors';
+export type { HikConfig, HikSdkOptions } from './core/config';
+export type { CreatePersonInput, DeletePersonInput, BatchDeletePersonInput, SearchPersonInput, PersonInfo, PersonValid, PersonRightPlan, DoorRightPlan, TraceIdResponse, UserType, } from './modules/person/person.types';
+export type { AddFaceInput, DeleteFaceInput, FaceTraceIdResponse, FaceLibType, } from './modules/face/face.types';
+export type { AddCardInput, DeleteCardInput, BatchDeleteCardInput, CardTraceIdResponse, CardType, } from './modules/card/card.types';
+export type { RemoteControlDoorInput, GetDoorStatusInput, GetStorageCountInput, ClearStorageInput, DoorStatusResponse, StorageCountResponse, StorageCount, DeviceTraceIdResponse, DoorControlCmd, ControlType, } from './modules/device/device.types';
+export type { PersonRef, DeviceRef, AddAuthorityConfigInput, UpdateAuthorityConfigInput, AuthorityConfigDetail, AuthorityConfigListItem, SaveDeviceGroupInput, DeviceGroupDetail, PersonDevicePageInput, PersonDeviceItem, WaitIssueInfo, PasswordInfo, ManualIssueInput, SelectIssueInput, CoverIssueInput, AccessEventPageInput, AccessEventItem, AuthPicUrlInput, AuthPicUrlResult, HolidayGroupInput, UpdateHolidayGroupInput, HolidayGroupDetail, TimePlanInput, UpdateTimePlanInput, TimePlanDetail, InfoStatus, DoorVO, WorkdayPeriod, WorkdayDetail, PersonResponse, DeviceResponse, } from './modules/access/access.types';

package/dist/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERROR_CODES = exports.HikDeviceError = exports.HikAuthError = exports.HikError = exports.HikSdk = void 0;
+var sdk_1 = require("./sdk");
+Object.defineProperty(exports, "HikSdk", { enumerable: true, get: function () { return sdk_1.HikSdk; } });
+var errors_1 = require("./core/errors");
+Object.defineProperty(exports, "HikError", { enumerable: true, get: function () { return errors_1.HikError; } });
+Object.defineProperty(exports, "HikAuthError", { enumerable: true, get: function () { return errors_1.HikAuthError; } });
+Object.defineProperty(exports, "HikDeviceError", { enumerable: true, get: function () { return errors_1.HikDeviceError; } });
+Object.defineProperty(exports, "ERROR_CODES", { enumerable: true, get: function () { return errors_1.ERROR_CODES; } });