lansenger-sdk-ts 1.0.0

package/dist/todos.js

@@ -0,0 +1,282 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TODO_TYPE_APPROVAL = exports.TODO_TYPE_NOTIFICATION = exports.TODO_TODO_STATUS_DONE = exports.TODO_TODO_STATUS_PENDING_DO = exports.TODO_TODO_STATUS_READ = exports.TODO_TODO_STATUS_PENDING_READ = void 0;
+exports.createTodoTask = createTodoTask;
+exports.updateTodoTask = updateTodoTask;
+exports.updateTodoTaskStatus = updateTodoTaskStatus;
+exports.deleteTodoTask = deleteTodoTask;
+exports.fetchTodoTaskList = fetchTodoTaskList;
+exports.fetchTodoTaskBySourceId = fetchTodoTaskBySourceId;
+exports.fetchTodoTaskById = fetchTodoTaskById;
+exports.fetchTodoTaskStatusCounts = fetchTodoTaskStatusCounts;
+exports.updateExecutorStatus = updateExecutorStatus;
+exports.addExecutors = addExecutors;
+exports.deleteExecutors = deleteExecutors;
+exports.fetchExecutorList = fetchExecutorList;
+const urlHelpers_1 = require("./urlHelpers");
+const http_1 = require("./http");
+const models_1 = require("./models");
+exports.TODO_TODO_STATUS_PENDING_READ = "11";
+exports.TODO_TODO_STATUS_READ = "12";
+exports.TODO_TODO_STATUS_PENDING_DO = "21";
+exports.TODO_TODO_STATUS_DONE = "22";
+exports.TODO_TYPE_NOTIFICATION = 1;
+exports.TODO_TYPE_APPROVAL = 2;
+async function createTodoTask(config, appToken, title, link, pcLink, executorIds, orgId, type = 1, opts) {
+    if (!title)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "title is required" });
+    if (!link)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "link is required" });
+    if (!pcLink)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "pc_link is required" });
+    if (!executorIds || !executorIds.length)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "executor_ids is required" });
+    if (!orgId)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "org_id is required" });
+    const userToken = opts?.user_token || "";
+    const url = (0, urlHelpers_1.buildApiUrl)(config, "todo", "create", appToken, { userToken });
+    const body = { title, type, link, pcLink: pcLink, executorIds, orgId };
+    if (opts?.source_id)
+        body.sourceId = opts.source_id;
+    if (opts?.desc)
+        body.desc = opts.desc;
+    if (opts?.sender_id)
+        body.senderId = opts.sender_id;
+    const [data, httpErr] = await (0, http_1.doPost)(url, body, opts?.fetchFn);
+    if (httpErr)
+        return new models_1.TodoTaskCreateResult({ success: false, error: httpErr });
+    const [ok, apiErr] = (0, http_1.parseApiResponse)(data);
+    if (!ok)
+        return new models_1.TodoTaskCreateResult({ success: false, error: apiErr });
+    const d = data.data || {};
+    return new models_1.TodoTaskCreateResult({ success: true, todotask_id: d.todotaskId, raw_response: data });
+}
+async function updateTodoTask(config, appToken, todotaskId, title, link, pcLink, orgId, opts) {
+    if (!todotaskId)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "todotask_id is required" });
+    if (!title)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "title is required" });
+    if (!orgId)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "org_id is required" });
+    const userToken = opts?.user_token || "";
+    const url = (0, urlHelpers_1.buildApiUrl)(config, "todo", "info_update", appToken, { userToken });
+    const body = { todotaskId, title, link, pcLink: pcLink, orgId };
+    if (opts?.desc)
+        body.desc = opts.desc;
+    const [data, httpErr] = await (0, http_1.doPost)(url, body, opts?.fetchFn);
+    if (httpErr)
+        return new models_1.TodoTaskCreateResult({ success: false, error: httpErr });
+    const [ok, apiErr] = (0, http_1.parseApiResponse)(data);
+    if (!ok)
+        return new models_1.TodoTaskCreateResult({ success: false, error: apiErr });
+    return new models_1.TodoTaskCreateResult({ success: true, todotask_id: todotaskId, raw_response: data });
+}
+async function updateTodoTaskStatus(config, appToken, todotaskId, status, orgId, opts) {
+    const valid = ["11", "12", "21", "22"];
+    if (!valid.includes(status))
+        return new models_1.TodoTaskCreateResult({ success: false, error: `status must be one of: ${valid.join(", ")}` });
+    if (!todotaskId)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "todotask_id is required" });
+    if (!orgId)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "org_id is required" });
+    const userToken = opts?.user_token || "";
+    const url = (0, urlHelpers_1.buildApiUrl)(config, "todo", "status_update", appToken, { userToken });
+    const body = { todotaskId, status, orgId };
+    if (opts?.staff_id)
+        body.staffId = opts.staff_id;
+    const [data, httpErr] = await (0, http_1.doPost)(url, body, opts?.fetchFn);
+    if (httpErr)
+        return new models_1.TodoTaskCreateResult({ success: false, error: httpErr });
+    const [ok, apiErr] = (0, http_1.parseApiResponse)(data);
+    if (!ok)
+        return new models_1.TodoTaskCreateResult({ success: false, error: apiErr });
+    return new models_1.TodoTaskCreateResult({ success: true, todotask_id: todotaskId, raw_response: data });
+}
+async function deleteTodoTask(config, appToken, todotaskId, orgId, opts) {
+    if (!todotaskId)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "todotask_id is required" });
+    if (!orgId)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "org_id is required" });
+    const userToken = opts?.user_token || "";
+    const url = (0, urlHelpers_1.buildApiUrl)(config, "todo", "sender_delete", appToken, { userToken });
+    const body = { todotaskId, orgId };
+    if (opts?.staff_id)
+        body.staffId = opts.staff_id;
+    const [data, httpErr] = await (0, http_1.doPost)(url, body, opts?.fetchFn);
+    if (httpErr)
+        return new models_1.TodoTaskCreateResult({ success: false, error: httpErr });
+    const [ok, apiErr] = (0, http_1.parseApiResponse)(data);
+    if (!ok)
+        return new models_1.TodoTaskCreateResult({ success: false, error: apiErr });
+    return new models_1.TodoTaskCreateResult({ success: true, todotask_id: todotaskId, raw_response: data });
+}
+async function fetchTodoTaskList(config, appToken, orgId, opts) {
+    if (!orgId)
+        return new models_1.TodoTaskListResult({ success: false, error: "org_id is required" });
+    const userToken = opts?.user_token || "";
+    const url = (0, urlHelpers_1.buildApiUrl)(config, "todo", "list_fetch", appToken, { userToken });
+    const body = { orgId };
+    if (opts?.app_ids)
+        body.appIds = opts.app_ids;
+    if (opts?.staff_id)
+        body.staffId = opts.staff_id;
+    if (opts?.status_list)
+        body.statusList = opts.status_list;
+    const [data, httpErr] = await (0, http_1.doPost)(url, body, opts?.fetchFn);
+    if (httpErr)
+        return new models_1.TodoTaskListResult({ success: false, error: httpErr });
+    const [ok, apiErr] = (0, http_1.parseApiResponse)(data);
+    if (!ok)
+        return new models_1.TodoTaskListResult({ success: false, error: apiErr });
+    const d = data.data || {};
+    return new models_1.TodoTaskListResult({ success: true, total: d.total || 0, todotask_list: d.todotaskList, raw_response: data });
+}
+async function fetchTodoTaskBySourceId(config, appToken, sourceId, orgId, opts) {
+    if (!sourceId)
+        return new models_1.TodoTaskInfoResult({ success: false, error: "source_id is required" });
+    if (!orgId)
+        return new models_1.TodoTaskInfoResult({ success: false, error: "org_id is required" });
+    const userToken = opts?.user_token || "";
+    const url = (0, urlHelpers_1.buildApiUrl)(config, "todo", "info_fetch_by_source_id", appToken, { userToken });
+    const body = { sourceId, orgId };
+    if (opts?.staff_id)
+        body.staffId = opts.staff_id;
+    const [data, httpErr] = await (0, http_1.doPost)(url, body, opts?.fetchFn);
+    if (httpErr)
+        return new models_1.TodoTaskInfoResult({ success: false, error: httpErr });
+    const [ok, apiErr] = (0, http_1.parseApiResponse)(data);
+    if (!ok)
+        return new models_1.TodoTaskInfoResult({ success: false, error: apiErr });
+    const d = data.data || {};
+    return new models_1.TodoTaskInfoResult({
+        success: true, todotask_id: d.todotaskId, source_id: d.sourceId,
+        title: d.title, desc: d.desc, status: d.status, type: d.type,
+        link: d.link, pc_link: d.pcLink, sender_id: d.senderId,
+        executor_ids: d.executorIds, create_time: d.createTime, app_id: d.appId,
+        raw_response: data,
+    });
+}
+async function fetchTodoTaskById(config, appToken, todotaskId, orgId, opts) {
+    if (!todotaskId)
+        return new models_1.TodoTaskInfoResult({ success: false, error: "todotask_id is required" });
+    if (!orgId)
+        return new models_1.TodoTaskInfoResult({ success: false, error: "org_id is required" });
+    const userToken = opts?.user_token || "";
+    const url = (0, urlHelpers_1.buildApiUrl)(config, "todo", "info_fetch", appToken, { userToken });
+    const body = { todotaskId, orgId };
+    if (opts?.staff_id)
+        body.staffId = opts.staff_id;
+    const [data, httpErr] = await (0, http_1.doPost)(url, body, opts?.fetchFn);
+    if (httpErr)
+        return new models_1.TodoTaskInfoResult({ success: false, error: httpErr });
+    const [ok, apiErr] = (0, http_1.parseApiResponse)(data);
+    if (!ok)
+        return new models_1.TodoTaskInfoResult({ success: false, error: apiErr });
+    const d = data.data || {};
+    return new models_1.TodoTaskInfoResult({
+        success: true, todotask_id: d.todotaskId, source_id: d.sourceId,
+        title: d.title, desc: d.desc, status: d.status, type: d.type,
+        link: d.link, pc_link: d.pcLink, sender_id: d.senderId,
+        executor_ids: d.executorIds, create_time: d.createTime, app_id: d.appId,
+        raw_response: data,
+    });
+}
+async function fetchTodoTaskStatusCounts(config, appToken, staffId, orgId, opts) {
+    if (!staffId)
+        return new models_1.TodoTaskStatusCountResult({ success: false, error: "staff_id is required" });
+    if (!orgId)
+        return new models_1.TodoTaskStatusCountResult({ success: false, error: "org_id is required" });
+    const userToken = opts?.user_token || "";
+    const url = (0, urlHelpers_1.buildApiUrl)(config, "todo", "status_count_list_fetch", appToken, { userToken });
+    const body = { staffId, orgId };
+    if (opts?.app_id)
+        body.appId = opts.app_id;
+    if (opts?.status_list)
+        body.status = opts.status_list;
+    const [data, httpErr] = await (0, http_1.doPost)(url, body, opts?.fetchFn);
+    if (httpErr)
+        return new models_1.TodoTaskStatusCountResult({ success: false, error: httpErr });
+    const [ok, apiErr] = (0, http_1.parseApiResponse)(data);
+    if (!ok)
+        return new models_1.TodoTaskStatusCountResult({ success: false, error: apiErr });
+    const d = data.data || [];
+    return new models_1.TodoTaskStatusCountResult({ success: true, status_counts: Array.isArray(d) ? d : [], raw_response: data });
+}
+async function updateExecutorStatus(config, appToken, executorStatusList, orgId, opts) {
+    if (!executorStatusList || !executorStatusList.length)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "executor_status_list is required" });
+    if (!orgId)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "org_id is required" });
+    const userToken = opts?.user_token || "";
+    const url = (0, urlHelpers_1.buildApiUrl)(config, "todo", "executor_status_update", appToken, { userToken });
+    const body = { executorStatusList, orgId };
+    if (opts?.todotask_id)
+        body.todotaskId = opts.todotask_id;
+    const [data, httpErr] = await (0, http_1.doPost)(url, body, opts?.fetchFn);
+    if (httpErr)
+        return new models_1.TodoTaskCreateResult({ success: false, error: httpErr });
+    const [ok, apiErr] = (0, http_1.parseApiResponse)(data);
+    if (!ok)
+        return new models_1.TodoTaskCreateResult({ success: false, error: apiErr });
+    return new models_1.TodoTaskCreateResult({ success: true, todotask_id: opts?.todotask_id || "", raw_response: data });
+}
+async function addExecutors(config, appToken, executorIds, orgId, opts) {
+    if (!executorIds || !executorIds.length)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "executor_ids is required" });
+    if (!orgId)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "org_id is required" });
+    const userToken = opts?.user_token || "";
+    const url = (0, urlHelpers_1.buildApiUrl)(config, "todo", "executor_create", appToken, { userToken });
+    const body = { executorIds, orgId };
+    if (opts?.todotask_id)
+        body.todotaskId = opts.todotask_id;
+    const [data, httpErr] = await (0, http_1.doPost)(url, body, opts?.fetchFn);
+    if (httpErr)
+        return new models_1.TodoTaskCreateResult({ success: false, error: httpErr });
+    const [ok, apiErr] = (0, http_1.parseApiResponse)(data);
+    if (!ok)
+        return new models_1.TodoTaskCreateResult({ success: false, error: apiErr });
+    return new models_1.TodoTaskCreateResult({ success: true, todotask_id: opts?.todotask_id || "", raw_response: data });
+}
+async function deleteExecutors(config, appToken, executorIds, orgId, opts) {
+    if (!executorIds || !executorIds.length)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "executor_ids is required" });
+    if (!orgId)
+        return new models_1.TodoTaskCreateResult({ success: false, error: "org_id is required" });
+    const userToken = opts?.user_token || "";
+    const url = (0, urlHelpers_1.buildApiUrl)(config, "todo", "executor_delete", appToken, { userToken });
+    const body = { executorIds, orgId };
+    if (opts?.todotask_id)
+        body.todotaskId = opts.todotask_id;
+    const [data, httpErr] = await (0, http_1.doPost)(url, body, opts?.fetchFn);
+    if (httpErr)
+        return new models_1.TodoTaskCreateResult({ success: false, error: httpErr });
+    const [ok, apiErr] = (0, http_1.parseApiResponse)(data);
+    if (!ok)
+        return new models_1.TodoTaskCreateResult({ success: false, error: apiErr });
+    return new models_1.TodoTaskCreateResult({ success: true, todotask_id: opts?.todotask_id || "", raw_response: data });
+}
+async function fetchExecutorList(config, appToken, todotaskId, orgId, opts) {
+    if (!todotaskId)
+        return new models_1.TodoTaskExecutorListResult({ success: false, error: "todotask_id is required" });
+    if (!orgId)
+        return new models_1.TodoTaskExecutorListResult({ success: false, error: "org_id is required" });
+    const userToken = opts?.user_token || "";
+    const url = (0, urlHelpers_1.buildApiUrl)(config, "todo", "executor_list_fetch", appToken, { userToken });
+    const body = { todotaskId, orgId };
+    if (opts?.staff_id)
+        body.staffId = opts.staff_id;
+    if (opts?.status_list)
+        body.statusList = opts.status_list;
+    const [data, httpErr] = await (0, http_1.doPost)(url, body, opts?.fetchFn);
+    if (httpErr)
+        return new models_1.TodoTaskExecutorListResult({ success: false, error: httpErr });
+    const [ok, apiErr] = (0, http_1.parseApiResponse)(data);
+    if (!ok)
+        return new models_1.TodoTaskExecutorListResult({ success: false, error: apiErr });
+    const d = data.data || {};
+    return new models_1.TodoTaskExecutorListResult({
+        success: true, total: d.total || 0, executor_list: d.executorList, raw_response: data,
+    });
+}
+//# sourceMappingURL=todos.js.map

package/dist/urlHelpers.d.ts

@@ -0,0 +1,7 @@
+import { LansengerConfig } from "./config";
+export interface BuildApiUrlOptions {
+    userToken?: string;
+    userId?: string;
+    pathVars?: Record<string, string>;
+}
+export declare function buildApiUrl(config: LansengerConfig, category: string, endpoint: string, appToken: string, options?: BuildApiUrlOptions): string;

package/dist/urlHelpers.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildApiUrl = buildApiUrl;
+const constants_1 = require("./constants");
+function buildApiUrl(config, category, endpoint, appToken, options) {
+    const opts = options || {};
+    const pathTemplate = constants_1.API_ENDPOINTS[category][endpoint];
+    let apiPath = pathTemplate;
+    const pathVars = opts.pathVars || {};
+    for (const [varName, varValue] of Object.entries(pathVars)) {
+        apiPath = apiPath.replace(`{${varName}}`, encodeURIComponent(varValue));
+    }
+    let url = `${config.api_gateway_url}${apiPath}?app_token=${encodeURIComponent(appToken)}`;
+    if (opts.userToken) {
+        url += `&user_token=${encodeURIComponent(opts.userToken)}`;
+    }
+    if (opts.userId) {
+        url += `&user_id=${encodeURIComponent(opts.userId)}`;
+    }
+    return url;
+}
+//# sourceMappingURL=urlHelpers.js.map

package/dist/userMessages.d.ts

@@ -0,0 +1,8 @@
+import { LansengerConfig } from "./config";
+import { FetchFn } from "./http";
+import { UserMessageResult } from "./models";
+export declare function sendUserMessage(config: LansengerConfig, appToken: string, userToken: string, receiverId: string, msgType: string, msgData: Record<string, any>, opts?: {
+    common?: Record<string, any>;
+    uuid?: string;
+    fetchFn?: FetchFn;
+}): Promise<UserMessageResult>;

package/dist/userMessages.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendUserMessage = sendUserMessage;
+const urlHelpers_1 = require("./urlHelpers");
+const http_1 = require("./http");
+const models_1 = require("./models");
+async function sendUserMessage(config, appToken, userToken, receiverId, msgType, msgData, opts) {
+    if (!userToken)
+        return new models_1.UserMessageResult({ success: false, error: "user_token is required for user private chat messages" });
+    if (!receiverId)
+        return new models_1.UserMessageResult({ success: false, error: "receiver_id is required" });
+    if (!msgType)
+        return new models_1.UserMessageResult({ success: false, error: "msg_type is required" });
+    if (!msgData)
+        return new models_1.UserMessageResult({ success: false, error: "msg_data is required" });
+    const url = (0, urlHelpers_1.buildApiUrl)(config, "user_message", "create", appToken, { userToken });
+    const finalMsgData = { ...msgData };
+    if (opts?.common)
+        finalMsgData.common = opts.common;
+    const payload = { receiverId, msgType, msgData: finalMsgData };
+    if (opts?.uuid)
+        payload.uuid = opts.uuid;
+    const [data, httpErr] = await (0, http_1.doPost)(url, payload, opts?.fetchFn);
+    if (httpErr)
+        return new models_1.UserMessageResult({ success: false, error: httpErr });
+    const errCode = data.errCode ?? -1;
+    if (errCode !== 0) {
+        const msg = data.errMsg || "Unknown error";
+        return new models_1.UserMessageResult({ success: false, error: `API error (errCode=${errCode}): ${msg}` });
+    }
+    const d = data.data || {};
+    return new models_1.UserMessageResult({ success: true, message_id: d.msgId, raw_response: data });
+}
+//# sourceMappingURL=userMessages.js.map

package/dist/users.d.ts

@@ -0,0 +1,6 @@
+import { LansengerConfig } from "./config";
+import { FetchFn } from "./http";
+import { UserInfoResult } from "./models";
+export declare function fetchUserInfo(config: LansengerConfig, appToken: string, userToken: string, opts?: {
+    fetchFn?: FetchFn;
+}): Promise<UserInfoResult>;

package/dist/users.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchUserInfo = fetchUserInfo;
+const urlHelpers_1 = require("./urlHelpers");
+const http_1 = require("./http");
+const models_1 = require("./models");
+async function fetchUserInfo(config, appToken, userToken, opts) {
+    if (!userToken)
+        return new models_1.UserInfoResult({ success: false, error: "user_token is required" });
+    if (!appToken)
+        return new models_1.UserInfoResult({ success: false, error: "app_token is required" });
+    const url = (0, urlHelpers_1.buildApiUrl)(config, "users", "fetch", appToken, { userToken });
+    const [data, httpErr] = await (0, http_1.doGet)(url, opts?.fetchFn);
+    if (httpErr)
+        return new models_1.UserInfoResult({ success: false, error: httpErr });
+    const errCode = data.errCode ?? -1;
+    if (errCode !== 0) {
+        const msg = data.errMsg || "Unknown error";
+        return new models_1.UserInfoResult({ success: false, error: `API error (errCode=${errCode}): ${msg}` });
+    }
+    const d = data.data || {};
+    return new models_1.UserInfoResult({
+        success: true, staff_id: d.staffId, name: d.name,
+        org_id: d.orgId, org_name: d.orgid || d.orgName || d.orgname,
+        avatar_id: d.avatarId, avatar_url: d.avatarUrl,
+        mobile_phone: d.mobilePhone, email: d.email,
+        employee_number: d.employeeNumber, login_name: d.loginName,
+        external_id: d.externalId, department: d.department,
+        raw_response: data,
+    });
+}
+//# sourceMappingURL=users.js.map

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "lansenger-sdk-ts",
+  "version": "1.0.0",
+  "description": "Lansenger SDK — TypeScript SDK for Lansenger Smart Bot API",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "lint": "tsc --noEmit"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "node-fetch": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.0.0",
+    "@types/node": "^20.0.0",
+    "@types/node-fetch": "^2.6.13",
+    "jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.0.0"
+  },
+  "license": "MIT"
+}