@huo15/dingtalk-connector-pro 1.0.5 → 1.0.12

package/dist/src/config/schema.js

@@ -0,0 +1,135 @@
+import { normalizeAccountId } from "../sdk/helpers.js";
+import { z } from "zod";
+export { z };
+import { buildSecretInputSchema } from "../secret-input.js";
+const DmPolicySchema = z.enum(["open", "pairing", "allowlist"]);
+const GroupPolicySchema = z.enum(["open", "allowlist", "disabled"]);
+const ToolPolicySchema = z
+    .object({
+    allow: z.array(z.string()).optional(),
+    deny: z.array(z.string()).optional(),
+})
+    .strict()
+    .optional();
+/**
+ * Group session scope for routing DingTalk group messages.
+ * - "group" (default): one session per group chat
+ * - "group_sender": one session per (group + sender)
+ */
+const GroupSessionScopeSchema = z
+    .enum(["group", "group_sender"])
+    .optional();
+/**
+ * Dingtalk tools configuration.
+ * Controls which tool categories are enabled.
+ */
+const DingtalkToolsConfigSchema = z
+    .object({
+    docs: z.boolean().optional(), // Document operations (default: true)
+    media: z.boolean().optional(), // Media upload operations (default: true)
+})
+    .strict()
+    .optional();
+export const DingtalkGroupSchema = z
+    .object({
+    requireMention: z.boolean().optional(),
+    tools: ToolPolicySchema,
+    enabled: z.boolean().optional(),
+    allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
+    systemPrompt: z.string().optional(),
+    groupSessionScope: GroupSessionScopeSchema,
+})
+    .strict();
+const DingtalkSharedConfigShape = {
+    dmPolicy: DmPolicySchema.optional(),
+    allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
+    groupPolicy: GroupPolicySchema.optional(),
+    groupAllowFrom: z.array(z.union([z.string(), z.number()])).optional(),
+    requireMention: z.boolean().optional(),
+    groups: z.record(z.string(), DingtalkGroupSchema.optional()).optional(),
+    historyLimit: z.number().int().min(0).optional(),
+    textChunkLimit: z.number().int().positive().optional(),
+    mediaMaxMb: z.number().positive().optional(),
+    tools: DingtalkToolsConfigSchema,
+    typingIndicator: z.boolean().optional(),
+    resolveSenderNames: z.boolean().optional(),
+    separateSessionByConversation: z.boolean().optional(),
+    sharedMemoryAcrossConversations: z.boolean().optional(),
+    groupSessionScope: GroupSessionScopeSchema,
+    asyncMode: z.boolean().optional(),
+    ackText: z.string().optional(),
+    endpoint: z.string().optional(), // DWClient gateway endpoint
+    debug: z.boolean().optional(), // DWClient debug mode
+};
+/**
+ * Per-account configuration.
+ * All fields are optional - missing fields inherit from top-level config.
+ */
+export const DingtalkAccountConfigSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    name: z.string().optional(), // Display name for this account
+    clientId: z.union([z.string(), z.number()]).optional(),
+    clientSecret: buildSecretInputSchema().optional(),
+    ...DingtalkSharedConfigShape,
+})
+    .strict();
+/**
+ * Base schema (ZodObject) without superRefine, used for JSON Schema generation (Web UI).
+ * superRefine turns the schema into ZodEffects which is not compatible with buildChannelConfigSchema.
+ */
+export const DingtalkConfigBaseSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    defaultAccount: z.string().optional(),
+    // Top-level credentials (backward compatible for single-account mode)
+    clientId: z.union([z.string(), z.number()]).optional(),
+    clientSecret: buildSecretInputSchema().optional(),
+    enableMediaUpload: z.boolean().optional(),
+    systemPrompt: z.string().optional(),
+    ...DingtalkSharedConfigShape,
+    dmPolicy: DmPolicySchema.optional().default("open"),
+    groupPolicy: GroupPolicySchema.optional().default("open"),
+    requireMention: z.boolean().optional().default(true),
+    separateSessionByConversation: z.boolean().optional().default(true),
+    sharedMemoryAcrossConversations: z.boolean().optional().default(false),
+    groupSessionScope: GroupSessionScopeSchema.optional().default("group"),
+    // Multi-account configuration
+    accounts: z.record(z.string(), DingtalkAccountConfigSchema.optional()).optional(),
+})
+    .strict();
+export const DingtalkConfigSchema = DingtalkConfigBaseSchema.superRefine((value, ctx) => {
+    const defaultAccount = value.defaultAccount?.trim();
+    if (defaultAccount && value.accounts && Object.keys(value.accounts).length > 0) {
+        const normalizedDefaultAccount = normalizeAccountId(defaultAccount);
+        if (!Object.prototype.hasOwnProperty.call(value.accounts, normalizedDefaultAccount)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["defaultAccount"],
+                message: `channels.dingtalk-connector.defaultAccount="${defaultAccount}" does not match a configured account key`,
+            });
+        }
+    }
+    // Validate dmPolicy and allowFrom consistency
+    if (value.dmPolicy === "allowlist") {
+        const allowFrom = value.allowFrom ?? [];
+        if (allowFrom.length === 0) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["allowFrom"],
+                message: 'channels.dingtalk-connector.dmPolicy="allowlist" requires channels.dingtalk-connector.allowFrom to contain at least one entry',
+            });
+        }
+    }
+    // Validate groupPolicy and groupAllowFrom consistency
+    if (value.groupPolicy === "allowlist") {
+        const groupAllowFrom = value.groupAllowFrom ?? [];
+        if (groupAllowFrom.length === 0) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["groupAllowFrom"],
+                message: 'channels.dingtalk-connector.groupPolicy="allowlist" requires channels.dingtalk-connector.groupAllowFrom to contain at least one entry',
+            });
+        }
+    }
+});