wjx-api-sdk 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { getWjxBaseUrl, getWjxApiUrl, getWjxUserSystemApiUrl, getWjxSubuserApiUrl, getWjxContactsApiUrl, getWjxSsoSubaccountUrl, getWjxSsoUserSystemUrl, getWjxSsoPartnerUrl, getWjxSurveyCreateUrl, getWjxSurveyEditUrl, Action, DEFAULT_TIMEOUT_MS, DEFAULT_MAX_RETRIES, RETRY_DELAY_MS, } from "./core/constants.js";
+export type { WjxCredentials, WjxApiSuccess, WjxApiFailure, WjxApiResponse, FetchLike, RequestOptions, Logger, } from "./core/types.js";
+export { setCredentialProvider, getWjxCredentials, validateQuestionsJson, callWjxApi, callWjxUserSystemApi, callWjxSubuserApi, callWjxContactsApi, getCorpId, } from "./core/api-client.js";
+export { createSurvey, getSurvey, listSurveys, updateSurveyStatus, getSurveySettings, updateSurveySettings, deleteSurvey, getQuestionTags, getTagDetails, clearRecycleBin, uploadFile, } from "./modules/survey/client.js";
+export { surveyToText, typeToLabel, stripHtml } from "./modules/survey/survey-to-text.js";
+export { textToSurvey } from "./modules/survey/text-to-survey.js";
+export type { CreateSurveyInput, GetSurveyInput, ListSurveysInput, UpdateSurveyStatusInput, GetSurveySettingsInput, UpdateSurveySettingsInput, DeleteSurveyInput, GetQuestionTagsInput, GetTagDetailsInput, ClearRecycleBinInput, UploadFileInput, SurveyQuestionItem, SurveyQuestion, SurveyDetail, ParsedQuestion, ParsedSurvey, } from "./modules/survey/types.js";
+export { queryResponses, queryResponsesRealtime, downloadResponses, getReport, submitResponse, getFileLinks, getWinners, modifyResponse, get360Report, clearResponses, } from "./modules/response/client.js";
+export type { QueryResponsesInput, QueryResponsesRealtimeInput, DownloadResponsesInput, GetReportInput, SubmitResponseInput, GetFileLinksInput, GetWinnersInput, ModifyResponseInput, Get360ReportInput, ClearResponsesInput, } from "./modules/response/types.js";
+export { queryContacts, addContacts, deleteContacts, addAdmin, deleteAdmin, restoreAdmin, listDepartments, addDepartment, modifyDepartment, deleteDepartment, listTags, addTag, modifyTag, deleteTag, } from "./modules/contacts/client.js";
+export type { QueryContactsInput, AddContactsInput, DeleteContactsInput, AddAdminInput, DeleteAdminInput, RestoreAdminInput, ListDepartmentsInput, AddDepartmentInput, ModifyDepartmentInput, DeleteDepartmentInput, ListTagsInput, AddTagInput, ModifyTagInput, DeleteTagInput, } from "./modules/contacts/types.js";
+export { addParticipants, modifyParticipants, deleteParticipants, bindActivity, querySurveyBinding, queryUserSurveys, } from "./modules/user-system/client.js";
+export type { AddParticipantsInput, ModifyParticipantsInput, DeleteParticipantsInput, BindActivityInput, QuerySurveyBindingInput, QueryUserSurveysInput, } from "./modules/user-system/types.js";
+export { addSubAccount, modifySubAccount, deleteSubAccount, restoreSubAccount, querySubAccounts, } from "./modules/multi-user/client.js";
+export type { AddSubAccountInput, ModifySubAccountInput, DeleteSubAccountInput, RestoreSubAccountInput, QuerySubAccountsInput, } from "./modules/multi-user/types.js";
+export { buildSsoSubaccountUrl, buildSsoUserSystemUrl, buildSsoPartnerUrl, buildSurveyUrl, buildPreviewUrl, } from "./modules/sso/client.js";
+export type { SsoSubaccountInput, SsoUserSystemInput, SsoPartnerInput, BuildSurveyUrlInput, BuildPreviewUrlInput, } from "./modules/sso/types.js";
+export { decodeResponses, calculateNps, calculateCsat, detectAnomalies, compareMetrics, } from "./modules/analytics/compute.js";
+export { decodePushPayload } from "./modules/analytics/push-decode.js";
+export type { DecodedAnswer, DecodeResponsesResult, NpsResult, CsatResult, AnomalyFlag, AnomalyResult, MetricComparison, CompareResult, PushDecodeResult, } from "./modules/analytics/types.js";

package/dist/index.js

@@ -0,0 +1,21 @@
+// Core exports
+export { getWjxBaseUrl, getWjxApiUrl, getWjxUserSystemApiUrl, getWjxSubuserApiUrl, getWjxContactsApiUrl, getWjxSsoSubaccountUrl, getWjxSsoUserSystemUrl, getWjxSsoPartnerUrl, getWjxSurveyCreateUrl, getWjxSurveyEditUrl, Action, DEFAULT_TIMEOUT_MS, DEFAULT_MAX_RETRIES, RETRY_DELAY_MS, } from "./core/constants.js";
+export { setCredentialProvider, getWjxCredentials, validateQuestionsJson, callWjxApi, callWjxUserSystemApi, callWjxSubuserApi, callWjxContactsApi, getCorpId, } from "./core/api-client.js";
+// Survey module
+export { createSurvey, getSurvey, listSurveys, updateSurveyStatus, getSurveySettings, updateSurveySettings, deleteSurvey, getQuestionTags, getTagDetails, clearRecycleBin, uploadFile, } from "./modules/survey/client.js";
+export { surveyToText, typeToLabel, stripHtml } from "./modules/survey/survey-to-text.js";
+export { textToSurvey } from "./modules/survey/text-to-survey.js";
+// Response module
+export { queryResponses, queryResponsesRealtime, downloadResponses, getReport, submitResponse, getFileLinks, getWinners, modifyResponse, get360Report, clearResponses, } from "./modules/response/client.js";
+// Contacts module
+export { queryContacts, addContacts, deleteContacts, addAdmin, deleteAdmin, restoreAdmin, listDepartments, addDepartment, modifyDepartment, deleteDepartment, listTags, addTag, modifyTag, deleteTag, } from "./modules/contacts/client.js";
+// User System module
+export { addParticipants, modifyParticipants, deleteParticipants, bindActivity, querySurveyBinding, queryUserSurveys, } from "./modules/user-system/client.js";
+// Multi-User module
+export { addSubAccount, modifySubAccount, deleteSubAccount, restoreSubAccount, querySubAccounts, } from "./modules/multi-user/client.js";
+// SSO module
+export { buildSsoSubaccountUrl, buildSsoUserSystemUrl, buildSsoPartnerUrl, buildSurveyUrl, buildPreviewUrl, } from "./modules/sso/client.js";
+// Analytics module
+export { decodeResponses, calculateNps, calculateCsat, detectAnomalies, compareMetrics, } from "./modules/analytics/compute.js";
+export { decodePushPayload } from "./modules/analytics/push-decode.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EACL,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,MAAM,EACN,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAU7B,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,SAAS,EACT,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,eAAe,EACf,UAAU,GACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAoBlE,kBAAkB;AAClB,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,YAAY,EACZ,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,8BAA8B,CAAC;AActC,kBAAkB;AAClB,OAAO,EACL,aAAa,EACb,WAAW,EACX,cAAc,EACd,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,MAAM,EACN,SAAS,EACT,SAAS,GACV,MAAM,8BAA8B,CAAC;AAkBtC,qBAAqB;AACrB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AAUzC,oBAAoB;AACpB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AASxC,aAAa;AACb,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,eAAe,GAChB,MAAM,yBAAyB,CAAC;AASjC,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/modules/analytics/compute.d.ts

@@ -0,0 +1,14 @@
+import type { DecodeResponsesResult, NpsResult, CsatResult, AnomalyResult, CompareResult } from "./types.js";
+export declare function decodeResponses(submitdata: string): DecodeResponsesResult;
+export declare function calculateNps(scores: number[]): NpsResult;
+export declare function calculateCsat(scores: number[], scaleType?: "5-point" | "7-point"): CsatResult;
+interface ResponseRecord {
+    id: string | number;
+    answers?: (string | number)[];
+    duration_seconds?: number;
+    ip?: string;
+    [key: string]: unknown;
+}
+export declare function detectAnomalies(responses: ResponseRecord[]): AnomalyResult;
+export declare function compareMetrics(setA: Record<string, number>, setB: Record<string, number>): CompareResult;
+export {};

package/dist/modules/analytics/compute.js

@@ -0,0 +1,205 @@
+// ─── decodeResponses ─────────────────────────────────────────────────────────
+// Format: "题号$答案}题号$答案"
+// Multi-choice answers use pipe separator: "1|2|3"
+// Matrix answers use comma-separated sub-answers: "row1_col1,row1_col2"
+// Fill-in answers are plain text
+//
+// NOTE: Without question metadata, type detection is heuristic-based.
+// Pure numeric fill-in answers (e.g. "42") will be classified as "single"
+// (single-choice) since we cannot distinguish them from option indices.
+export function decodeResponses(submitdata) {
+    if (!submitdata || submitdata.trim() === "") {
+        return { answers: [], count: 0 };
+    }
+    const segments = submitdata.split("}");
+    const answers = [];
+    for (const seg of segments) {
+        const trimmed = seg.trim();
+        if (!trimmed)
+            continue;
+        const dollarIdx = trimmed.indexOf("$");
+        if (dollarIdx === -1)
+            continue;
+        const qIdx = parseInt(trimmed.substring(0, dollarIdx), 10);
+        if (Number.isNaN(qIdx))
+            continue;
+        const rawValue = trimmed.substring(dollarIdx + 1);
+        // Detect type based on content patterns
+        if (rawValue.includes("|")) {
+            // Multi-choice: values separated by pipe
+            answers.push({
+                questionIndex: qIdx,
+                type: "multi",
+                value: rawValue.split("|"),
+            });
+        }
+        else if (rawValue.includes(",") && rawValue.split(",").every((p) => p.includes("_"))) {
+            // Matrix: "row_col,row_col" pattern
+            const pairs = {};
+            for (const pair of rawValue.split(",")) {
+                const underIdx = pair.indexOf("_");
+                if (underIdx !== -1) {
+                    pairs[pair.substring(0, underIdx)] = pair.substring(underIdx + 1);
+                }
+            }
+            answers.push({
+                questionIndex: qIdx,
+                type: "matrix",
+                value: pairs,
+            });
+        }
+        else if (/^\d+$/.test(rawValue)) {
+            // Single choice: numeric answer
+            answers.push({
+                questionIndex: qIdx,
+                type: "single",
+                value: rawValue,
+            });
+        }
+        else {
+            // Fill-in: everything else
+            answers.push({
+                questionIndex: qIdx,
+                type: "fill",
+                value: rawValue,
+            });
+        }
+    }
+    return { answers, count: answers.length };
+}
+// ─── calculateNps ────────────────────────────────────────────────────────────
+// NPS = %Promoters - %Detractors (scale 0-10)
+// Promoters: 9-10, Passives: 7-8, Detractors: 0-6
+export function calculateNps(scores) {
+    if (scores.length === 0) {
+        return {
+            score: 0,
+            promoters: { count: 0, ratio: 0 },
+            passives: { count: 0, ratio: 0 },
+            detractors: { count: 0, ratio: 0 },
+            total: 0,
+            rating: "一般",
+        };
+    }
+    const total = scores.length;
+    let promoters = 0;
+    let passives = 0;
+    let detractors = 0;
+    for (const s of scores) {
+        if (s >= 9)
+            promoters++;
+        else if (s >= 7)
+            passives++;
+        else
+            detractors++;
+    }
+    const score = Math.round(((promoters - detractors) / total) * 100);
+    let rating;
+    if (score > 70)
+        rating = "优秀";
+    else if (score >= 50)
+        rating = "良好";
+    else if (score >= 0)
+        rating = "一般";
+    else
+        rating = "较差";
+    return {
+        score,
+        promoters: { count: promoters, ratio: round4(promoters / total) },
+        passives: { count: passives, ratio: round4(passives / total) },
+        detractors: { count: detractors, ratio: round4(detractors / total) },
+        total,
+        rating,
+    };
+}
+// ─── calculateCsat ───────────────────────────────────────────────────────────
+// 5-point: satisfied = 4-5; 7-point: satisfied = 5-7
+export function calculateCsat(scores, scaleType = "5-point") {
+    if (scores.length === 0) {
+        return { csat: 0, satisfiedCount: 0, total: 0, distribution: {} };
+    }
+    const total = scores.length;
+    const distribution = {};
+    let satisfiedCount = 0;
+    const satisfiedMin = scaleType === "5-point" ? 4 : 5;
+    for (const s of scores) {
+        const key = String(s);
+        distribution[key] = (distribution[key] || 0) + 1;
+        if (s >= satisfiedMin)
+            satisfiedCount++;
+    }
+    return {
+        csat: round4(satisfiedCount / total),
+        satisfiedCount,
+        total,
+        distribution,
+    };
+}
+export function detectAnomalies(responses) {
+    const flagged = [];
+    // Compute median duration for speed anomaly detection
+    const durations = responses
+        .map((r) => r.duration_seconds)
+        .filter((d) => typeof d === "number" && d > 0);
+    const medianDuration = durations.length > 0 ? median(durations) : 0;
+    const speedThreshold = medianDuration * 0.3; // < 30% of median is suspicious
+    // Build IP+content map for duplicate detection
+    const ipContentMap = new Map();
+    for (const r of responses) {
+        const reasons = [];
+        // 1. Straight-lining: all answers identical
+        if (r.answers && r.answers.length > 2) {
+            const unique = new Set(r.answers.map(String));
+            if (unique.size === 1) {
+                reasons.push("straight-lining");
+            }
+        }
+        // 2. Speed anomaly: completed too fast
+        if (typeof r.duration_seconds === "number" &&
+            medianDuration > 0 &&
+            r.duration_seconds > 0 &&
+            r.duration_seconds < speedThreshold) {
+            reasons.push("speed-anomaly");
+        }
+        // 3. IP + content duplicate
+        if (r.ip && r.answers) {
+            const contentKey = `${r.ip}:${r.answers.map(String).join(",")}`;
+            const existing = ipContentMap.get(contentKey);
+            if (existing) {
+                existing.push(r.id);
+                reasons.push("ip-content-duplicate");
+            }
+            else {
+                ipContentMap.set(contentKey, [r.id]);
+            }
+        }
+        if (reasons.length > 0) {
+            flagged.push({ responseId: r.id, reasons });
+        }
+    }
+    return { flagged, totalChecked: responses.length };
+}
+// ─── compareMetrics ──────────────────────────────────────────────────────────
+export function compareMetrics(setA, setB) {
+    const allKeys = new Set([...Object.keys(setA), ...Object.keys(setB)]);
+    const comparisons = [];
+    for (const metric of allKeys) {
+        const valueA = setA[metric] ?? 0;
+        const valueB = setB[metric] ?? 0;
+        const delta = valueB - valueA;
+        const changeRate = valueA === 0 ? (valueB === 0 ? 0 : 1) : round4(delta / Math.abs(valueA));
+        const significant = Math.abs(changeRate) > 0.1;
+        comparisons.push({ metric, valueA, valueB, delta, changeRate, significant });
+    }
+    return { comparisons };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function round4(n) {
+    return Math.round(n * 10000) / 10000;
+}
+function median(arr) {
+    const sorted = [...arr].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 0 ? (sorted[mid - 1] + sorted[mid]) / 2 : sorted[mid];
+}
+//# sourceMappingURL=compute.js.map

package/dist/modules/analytics/compute.js.map

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

package/dist/modules/analytics/push-decode.d.ts

@@ -0,0 +1,12 @@
+import type { PushDecodeResult } from "./types.js";
+/**
+ * Decode an AES-128-CBC encrypted push payload from WJX.
+ *
+ * - key = MD5(appKey).substring(0, 16)
+ * - encrypted_data is base64-encoded
+ * - IV is the first 16 bytes of the ciphertext
+ * - PKCS7 padding
+ *
+ * Optional: verify SHA1(rawBody + appKey) signature if signature + rawBody provided.
+ */
+export declare function decodePushPayload(encryptedData: string, appKey: string, signature?: string, rawBody?: string): PushDecodeResult;

package/dist/modules/analytics/push-decode.js

@@ -0,0 +1,46 @@
+import { createDecipheriv, createHash, timingSafeEqual } from "node:crypto";
+/**
+ * Decode an AES-128-CBC encrypted push payload from WJX.
+ *
+ * - key = MD5(appKey).substring(0, 16)
+ * - encrypted_data is base64-encoded
+ * - IV is the first 16 bytes of the ciphertext
+ * - PKCS7 padding
+ *
+ * Optional: verify SHA1(rawBody + appKey) signature if signature + rawBody provided.
+ */
+export function decodePushPayload(encryptedData, appKey, signature, rawBody) {
+    // Derive AES key: MD5(appKey) first 16 chars → 16-byte key
+    const md5Hex = createHash("md5").update(appKey, "utf-8").digest("hex");
+    const aesKey = Buffer.from(md5Hex.substring(0, 16), "utf-8");
+    // Decode base64 ciphertext
+    const ciphertext = Buffer.from(encryptedData, "base64");
+    if (ciphertext.length < 16) {
+        throw new Error("Encrypted data too short — must be at least 16 bytes for IV");
+    }
+    // IV = first 16 bytes
+    const iv = ciphertext.subarray(0, 16);
+    const encrypted = ciphertext.subarray(16);
+    // Decrypt with AES-128-CBC + PKCS7 (Node default)
+    const decipher = createDecipheriv("aes-128-cbc", aesKey, iv);
+    const decrypted = Buffer.concat([decipher.update(encrypted), decipher.final()]);
+    const plaintext = decrypted.toString("utf-8");
+    // Parse JSON
+    let parsed;
+    try {
+        parsed = JSON.parse(plaintext);
+    }
+    catch {
+        parsed = plaintext;
+    }
+    // Optional signature verification (timing-safe)
+    let signatureValid;
+    if (signature && rawBody) {
+        const expected = createHash("sha1").update(rawBody + appKey, "utf-8").digest("hex");
+        signatureValid =
+            expected.length === signature.length &&
+                timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
+    }
+    return { decrypted: parsed, signatureValid };
+}
+//# sourceMappingURL=push-decode.js.map

package/dist/modules/analytics/push-decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-decode.js","sourceRoot":"","sources":["../../../src/modules/analytics/push-decode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG5E;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,aAAqB,EACrB,MAAc,EACd,SAAkB,EAClB,OAAgB;IAEhB,2DAA2D;IAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAE7D,2BAA2B;IAC3B,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACxD,IAAI,UAAU,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IAED,sBAAsB;IACtB,MAAM,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAE1C,kDAAkD;IAClD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChF,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE9C,aAAa;IACb,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,SAAS,CAAC;IACrB,CAAC;IAED,gDAAgD;IAChD,IAAI,cAAmC,CAAC;IACxC,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpF,cAAc;YACZ,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;gBACpC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;AAC/C,CAAC"}

package/dist/modules/analytics/types.d.ts

@@ -0,0 +1,61 @@
+/** Single decoded answer entry */
+export interface DecodedAnswer {
+    questionIndex: number;
+    type: "single" | "multi" | "fill" | "matrix";
+    value: string | string[] | Record<string, string>;
+}
+export interface DecodeResponsesResult {
+    answers: DecodedAnswer[];
+    count: number;
+}
+/** NPS categories */
+export interface NpsResult {
+    score: number;
+    promoters: {
+        count: number;
+        ratio: number;
+    };
+    passives: {
+        count: number;
+        ratio: number;
+    };
+    detractors: {
+        count: number;
+        ratio: number;
+    };
+    total: number;
+    rating: string;
+}
+/** CSAT result */
+export interface CsatResult {
+    csat: number;
+    satisfiedCount: number;
+    total: number;
+    distribution: Record<string, number>;
+}
+/** Anomaly detection */
+export interface AnomalyFlag {
+    responseId: string | number;
+    reasons: string[];
+}
+export interface AnomalyResult {
+    flagged: AnomalyFlag[];
+    totalChecked: number;
+}
+/** Metric comparison */
+export interface MetricComparison {
+    metric: string;
+    valueA: number;
+    valueB: number;
+    delta: number;
+    changeRate: number;
+    significant: boolean;
+}
+export interface CompareResult {
+    comparisons: MetricComparison[];
+}
+/** Push decode result */
+export interface PushDecodeResult {
+    decrypted: unknown;
+    signatureValid?: boolean;
+}

package/dist/modules/analytics/types.js

@@ -0,0 +1,3 @@
+// ─── Input / Output types for analytics computation tools ────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/modules/analytics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/modules/analytics/types.ts"],"names":[],"mappings":"AAAA,gFAAgF"}

package/dist/modules/contacts/client.d.ts

@@ -0,0 +1,16 @@
+import type { WjxApiResponse, WjxCredentials, FetchLike } from "../../core/types.js";
+import type { QueryContactsInput, AddContactsInput, DeleteContactsInput, AddAdminInput, DeleteAdminInput, RestoreAdminInput, ListDepartmentsInput, AddDepartmentInput, ModifyDepartmentInput, DeleteDepartmentInput, ListTagsInput, AddTagInput, ModifyTagInput, DeleteTagInput } from "./types.js";
+export declare function queryContacts<T = unknown>(input: QueryContactsInput, credentials?: WjxCredentials, fetchImpl?: FetchLike): Promise<WjxApiResponse<T>>;
+export declare function addContacts<T = unknown>(input: AddContactsInput, credentials?: WjxCredentials, fetchImpl?: FetchLike): Promise<WjxApiResponse<T>>;
+export declare function deleteContacts<T = unknown>(input: DeleteContactsInput, credentials?: WjxCredentials, fetchImpl?: FetchLike): Promise<WjxApiResponse<T>>;
+export declare function addAdmin<T = unknown>(input: AddAdminInput, credentials?: WjxCredentials, fetchImpl?: FetchLike): Promise<WjxApiResponse<T>>;
+export declare function deleteAdmin<T = unknown>(input: DeleteAdminInput, credentials?: WjxCredentials, fetchImpl?: FetchLike): Promise<WjxApiResponse<T>>;
+export declare function restoreAdmin<T = unknown>(input: RestoreAdminInput, credentials?: WjxCredentials, fetchImpl?: FetchLike): Promise<WjxApiResponse<T>>;
+export declare function listDepartments<T = unknown>(input: ListDepartmentsInput, credentials?: WjxCredentials, fetchImpl?: FetchLike): Promise<WjxApiResponse<T>>;
+export declare function addDepartment<T = unknown>(input: AddDepartmentInput, credentials?: WjxCredentials, fetchImpl?: FetchLike): Promise<WjxApiResponse<T>>;
+export declare function modifyDepartment<T = unknown>(input: ModifyDepartmentInput, credentials?: WjxCredentials, fetchImpl?: FetchLike): Promise<WjxApiResponse<T>>;
+export declare function deleteDepartment<T = unknown>(input: DeleteDepartmentInput, credentials?: WjxCredentials, fetchImpl?: FetchLike): Promise<WjxApiResponse<T>>;
+export declare function listTags<T = unknown>(input: ListTagsInput, credentials?: WjxCredentials, fetchImpl?: FetchLike): Promise<WjxApiResponse<T>>;
+export declare function addTag<T = unknown>(input: AddTagInput, credentials?: WjxCredentials, fetchImpl?: FetchLike): Promise<WjxApiResponse<T>>;
+export declare function modifyTag<T = unknown>(input: ModifyTagInput, credentials?: WjxCredentials, fetchImpl?: FetchLike): Promise<WjxApiResponse<T>>;
+export declare function deleteTag<T = unknown>(input: DeleteTagInput, credentials?: WjxCredentials, fetchImpl?: FetchLike): Promise<WjxApiResponse<T>>;

package/dist/modules/contacts/client.js

@@ -0,0 +1,129 @@
+import { Action } from "../../core/constants.js";
+import { callWjxContactsApi, getWjxCredentials, getCorpId } from "../../core/api-client.js";
+function resolveCorpId(input) {
+    const corpid = input.corpid || getCorpId();
+    if (!corpid) {
+        throw new Error("corpid is required: set WJX_CORP_ID env var or pass corpid parameter");
+    }
+    return corpid;
+}
+export async function queryContacts(input, credentials = getWjxCredentials(), fetchImpl = fetch) {
+    const params = {
+        action: Action.QUERY_CONTACTS,
+        corpid: resolveCorpId(input),
+        uid: input.uid,
+    };
+    return callWjxContactsApi(params, { credentials, fetchImpl });
+}
+export async function addContacts(input, credentials = getWjxCredentials(), fetchImpl = fetch) {
+    const params = {
+        action: Action.ADD_CONTACTS,
+        corpid: resolveCorpId(input),
+        users: input.users,
+    };
+    if (input.auto_create_udept !== undefined)
+        params.auto_create_udept = input.auto_create_udept ? "1" : "0";
+    if (input.auto_create_tag !== undefined)
+        params.auto_create_tag = input.auto_create_tag ? "1" : "0";
+    return callWjxContactsApi(params, { credentials, fetchImpl, maxRetries: 0 });
+}
+export async function deleteContacts(input, credentials = getWjxCredentials(), fetchImpl = fetch) {
+    return callWjxContactsApi({
+        action: Action.MANAGE_CONTACTS,
+        corpid: resolveCorpId(input),
+        uids: input.uids,
+    }, { credentials, fetchImpl, maxRetries: 0 });
+}
+// ─── Admin ───────────────────────────────────────────────────────────
+export async function addAdmin(input, credentials = getWjxCredentials(), fetchImpl = fetch) {
+    return callWjxContactsApi({
+        action: Action.ADD_ADMIN,
+        corpid: resolveCorpId(input),
+        users: input.users,
+    }, { credentials, fetchImpl, maxRetries: 0 });
+}
+export async function deleteAdmin(input, credentials = getWjxCredentials(), fetchImpl = fetch) {
+    return callWjxContactsApi({
+        action: Action.DELETE_ADMIN,
+        corpid: resolveCorpId(input),
+        uids: input.uids,
+    }, { credentials, fetchImpl, maxRetries: 0 });
+}
+export async function restoreAdmin(input, credentials = getWjxCredentials(), fetchImpl = fetch) {
+    return callWjxContactsApi({
+        action: Action.RESTORE_ADMIN,
+        corpid: resolveCorpId(input),
+        uids: input.uids,
+    }, { credentials, fetchImpl, maxRetries: 0 });
+}
+// ─── Department ──────────────────────────────────────────────────────
+export async function listDepartments(input, credentials = getWjxCredentials(), fetchImpl = fetch) {
+    const params = {
+        action: Action.LIST_DEPARTMENTS,
+        corpid: resolveCorpId(input),
+    };
+    return callWjxContactsApi(params, { credentials, fetchImpl });
+}
+export async function addDepartment(input, credentials = getWjxCredentials(), fetchImpl = fetch) {
+    return callWjxContactsApi({
+        action: Action.ADD_DEPARTMENT,
+        corpid: resolveCorpId(input),
+        depts: input.depts,
+    }, { credentials, fetchImpl, maxRetries: 0 });
+}
+export async function modifyDepartment(input, credentials = getWjxCredentials(), fetchImpl = fetch) {
+    return callWjxContactsApi({
+        action: Action.MODIFY_DEPARTMENT,
+        corpid: resolveCorpId(input),
+        depts: input.depts,
+    }, { credentials, fetchImpl, maxRetries: 0 });
+}
+export async function deleteDepartment(input, credentials = getWjxCredentials(), fetchImpl = fetch) {
+    const params = {
+        action: Action.DELETE_DEPARTMENT,
+        corpid: resolveCorpId(input),
+        type: input.type,
+        depts: input.depts,
+    };
+    if (input.del_child !== undefined)
+        params.del_child = input.del_child ? "1" : "0";
+    return callWjxContactsApi(params, { credentials, fetchImpl, maxRetries: 0 });
+}
+// ─── Tag ─────────────────────────────────────────────────────────────
+export async function listTags(input, credentials = getWjxCredentials(), fetchImpl = fetch) {
+    return callWjxContactsApi({
+        action: Action.LIST_TAGS,
+        corpid: resolveCorpId(input),
+    }, { credentials, fetchImpl });
+}
+export async function addTag(input, credentials = getWjxCredentials(), fetchImpl = fetch) {
+    const params = {
+        action: Action.ADD_TAG,
+        corpid: resolveCorpId(input),
+        child_names: input.child_names,
+    };
+    if (input.is_radio !== undefined)
+        params.is_radio = input.is_radio ? "1" : "0";
+    return callWjxContactsApi(params, { credentials, fetchImpl, maxRetries: 0 });
+}
+export async function modifyTag(input, credentials = getWjxCredentials(), fetchImpl = fetch) {
+    const params = {
+        action: Action.MODIFY_TAG,
+        corpid: resolveCorpId(input),
+        tp_id: input.tp_id,
+    };
+    if (input.tp_name !== undefined)
+        params.tp_name = input.tp_name;
+    if (input.child_names !== undefined)
+        params.child_names = input.child_names;
+    return callWjxContactsApi(params, { credentials, fetchImpl, maxRetries: 0 });
+}
+export async function deleteTag(input, credentials = getWjxCredentials(), fetchImpl = fetch) {
+    return callWjxContactsApi({
+        action: Action.DELETE_TAG,
+        corpid: resolveCorpId(input),
+        type: input.type,
+        tags: input.tags,
+    }, { credentials, fetchImpl, maxRetries: 0 });
+}
+//# sourceMappingURL=client.js.map

package/dist/modules/contacts/client.js.map

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

package/dist/modules/contacts/types.d.ts

@@ -0,0 +1,62 @@
+export interface QueryContactsInput {
+    corpid?: string;
+    uid: string;
+}
+export interface AddContactsInput {
+    corpid?: string;
+    users: string;
+    auto_create_udept?: boolean;
+    auto_create_tag?: boolean;
+}
+export interface DeleteContactsInput {
+    corpid?: string;
+    uids: string;
+}
+export interface AddAdminInput {
+    corpid?: string;
+    users: string;
+}
+export interface DeleteAdminInput {
+    corpid?: string;
+    uids: string;
+}
+export interface RestoreAdminInput {
+    corpid?: string;
+    uids: string;
+}
+export interface ListDepartmentsInput {
+    corpid?: string;
+}
+export interface AddDepartmentInput {
+    corpid?: string;
+    depts: string;
+}
+export interface ModifyDepartmentInput {
+    corpid?: string;
+    depts: string;
+}
+export interface DeleteDepartmentInput {
+    corpid?: string;
+    type: string;
+    depts: string;
+    del_child?: boolean;
+}
+export interface ListTagsInput {
+    corpid?: string;
+}
+export interface AddTagInput {
+    corpid?: string;
+    child_names: string;
+    is_radio?: boolean;
+}
+export interface ModifyTagInput {
+    corpid?: string;
+    tp_id: string;
+    tp_name?: string;
+    child_names?: string;
+}
+export interface DeleteTagInput {
+    corpid?: string;
+    type: string;
+    tags: string;
+}

package/dist/modules/contacts/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map