@downcity/plugins 1.0.4

package/bin/auth/runtime/AuthorizationStore.js

@@ -0,0 +1,179 @@
+/**
+ * Auth 授权运行时状态存储。
+ *
+ * 关键点（中文）
+ * - 所有动态状态（观测用户 / 会话）统一落盘到 `.downcity/chat/authorization/state.json`。
+ * - 静态授权配置保存在同目录下的 `config.json`，不和运行时观测数据混写。
+ */
+import fs from "fs-extra";
+import path from "node:path";
+import { readChatAuthorizationConfig } from "../../auth/runtime/AuthorizationConfig.js";
+function getAuthorizationStatePath(rootPath) {
+    return path.join(rootPath, ".downcity", "chat", "authorization", "state.json");
+}
+function normalizeText(value) {
+    const text = String(value || "").trim();
+    return text ? text : undefined;
+}
+function buildUserKey(channel, userId) {
+    return `${channel}:${userId}`;
+}
+function buildChatKey(channel, chatId) {
+    return `${channel}:${chatId}`;
+}
+function createEmptyState() {
+    return {
+        v: 1,
+        updatedAt: Date.now(),
+        usersByKey: {},
+        chatsByKey: {},
+    };
+}
+function normalizeObservedUser(input) {
+    if (!input || typeof input !== "object")
+        return null;
+    const channel = normalizeText(input.channel);
+    const userId = normalizeText(input.userId);
+    if (!channel || !userId)
+        return null;
+    return {
+        v: 1,
+        channel,
+        userId,
+        ...(normalizeText(input.username) ? { username: normalizeText(input.username) } : {}),
+        ...(normalizeText(input.lastChatId) ? { lastChatId: normalizeText(input.lastChatId) } : {}),
+        ...(normalizeText(input.lastChatTitle)
+            ? { lastChatTitle: normalizeText(input.lastChatTitle) }
+            : {}),
+        ...(normalizeText(input.lastChatType)
+            ? { lastChatType: normalizeText(input.lastChatType) }
+            : {}),
+        firstSeenAt: typeof input.firstSeenAt === "number" && Number.isFinite(input.firstSeenAt)
+            ? input.firstSeenAt
+            : Date.now(),
+        lastSeenAt: typeof input.lastSeenAt === "number" && Number.isFinite(input.lastSeenAt)
+            ? input.lastSeenAt
+            : Date.now(),
+    };
+}
+function normalizeObservedChat(input) {
+    if (!input || typeof input !== "object")
+        return null;
+    const channel = normalizeText(input.channel);
+    const chatId = normalizeText(input.chatId);
+    if (!channel || !chatId)
+        return null;
+    return {
+        v: 1,
+        channel,
+        chatId,
+        ...(normalizeText(input.chatTitle) ? { chatTitle: normalizeText(input.chatTitle) } : {}),
+        ...(normalizeText(input.chatType) ? { chatType: normalizeText(input.chatType) } : {}),
+        ...(normalizeText(input.lastActorId)
+            ? { lastActorId: normalizeText(input.lastActorId) }
+            : {}),
+        ...(normalizeText(input.lastActorName)
+            ? { lastActorName: normalizeText(input.lastActorName) }
+            : {}),
+        firstSeenAt: typeof input.firstSeenAt === "number" && Number.isFinite(input.firstSeenAt)
+            ? input.firstSeenAt
+            : Date.now(),
+        lastSeenAt: typeof input.lastSeenAt === "number" && Number.isFinite(input.lastSeenAt)
+            ? input.lastSeenAt
+            : Date.now(),
+    };
+}
+function normalizeStateFile(input) {
+    const out = createEmptyState();
+    out.updatedAt =
+        typeof input?.updatedAt === "number" && Number.isFinite(input.updatedAt)
+            ? input.updatedAt
+            : Date.now();
+    const users = input?.usersByKey;
+    if (users && typeof users === "object") {
+        for (const [key, value] of Object.entries(users)) {
+            const normalized = normalizeObservedUser(value);
+            if (!normalized)
+                continue;
+            out.usersByKey[key] = normalized;
+        }
+    }
+    const chats = input?.chatsByKey;
+    if (chats && typeof chats === "object") {
+        for (const [key, value] of Object.entries(chats)) {
+            const normalized = normalizeObservedChat(value);
+            if (!normalized)
+                continue;
+            out.chatsByKey[key] = normalized;
+        }
+    }
+    return out;
+}
+async function readState(rootPath) {
+    const file = getAuthorizationStatePath(rootPath);
+    const raw = (await fs.readJson(file).catch(() => null));
+    return normalizeStateFile(raw);
+}
+async function writeState(rootPath, state) {
+    const file = getAuthorizationStatePath(rootPath);
+    await fs.ensureDir(path.dirname(file));
+    await fs.writeJson(file, state, { spaces: 2 });
+}
+function readAuthorizationConfig(context) {
+    return readChatAuthorizationConfig(context.rootPath);
+}
+/**
+ * 记录观测到的用户 / 会话。
+ */
+export async function recordObservedAuthorizationPrincipal(params) {
+    const chatId = normalizeText(params.chatId);
+    if (!chatId)
+        return;
+    const now = Date.now();
+    const state = await readState(params.context.rootPath);
+    const chatKey = buildChatKey(params.channel, chatId);
+    const prevChat = state.chatsByKey[chatKey];
+    state.chatsByKey[chatKey] = {
+        v: 1,
+        channel: params.channel,
+        chatId,
+        ...(normalizeText(params.chatTitle) ? { chatTitle: normalizeText(params.chatTitle) } : {}),
+        ...(normalizeText(params.chatType) ? { chatType: normalizeText(params.chatType) } : {}),
+        ...(normalizeText(params.userId) ? { lastActorId: normalizeText(params.userId) } : {}),
+        ...(normalizeText(params.username) ? { lastActorName: normalizeText(params.username) } : {}),
+        firstSeenAt: prevChat?.firstSeenAt ?? now,
+        lastSeenAt: now,
+    };
+    const userId = normalizeText(params.userId);
+    if (userId) {
+        const userKey = buildUserKey(params.channel, userId);
+        const prevUser = state.usersByKey[userKey];
+        state.usersByKey[userKey] = {
+            v: 1,
+            channel: params.channel,
+            userId,
+            ...(normalizeText(params.username) ? { username: normalizeText(params.username) } : {}),
+            lastChatId: chatId,
+            ...(normalizeText(params.chatTitle)
+                ? { lastChatTitle: normalizeText(params.chatTitle) }
+                : {}),
+            ...(normalizeText(params.chatType) ? { lastChatType: normalizeText(params.chatType) } : {}),
+            firstSeenAt: prevUser?.firstSeenAt ?? now,
+            lastSeenAt: now,
+        };
+    }
+    state.updatedAt = now;
+    await writeState(params.context.rootPath, state);
+}
+/**
+ * 读取授权快照（配置 + 动态状态）。
+ */
+export async function readAuthorizationSnapshot(params) {
+    const state = await readState(params.context.rootPath);
+    return {
+        config: readAuthorizationConfig(params.context),
+        users: Object.values(state.usersByKey).sort((a, b) => b.lastSeenAt - a.lastSeenAt),
+        chats: Object.values(state.chatsByKey).sort((a, b) => b.lastSeenAt - a.lastSeenAt),
+    };
+}
+//# sourceMappingURL=AuthorizationStore.js.map

package/bin/auth/runtime/AuthorizationStore.js.map

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

package/bin/auth/types/AuthPlugin.d.ts

@@ -0,0 +1,407 @@
+/**
+ * Auth Plugin 类型与契约定义。
+ *
+ * 关键点（中文）
+ * - 统一维护 auth plugin 的领域类型、扩展点/action 名称、payload 契约。
+ * - 业务层不应散落硬编码字符串，如 `chat.authorizeIncoming`、`set-user-role`。
+ * - chat / console / plugin 执行链路都从这里共享同一份边界定义。
+ */
+import type { ChatDispatchChannel } from "../../chat/types/ChatDispatcher.js";
+/**
+ * auth plugin 稳定名称。
+ */
+export declare const AUTH_PLUGIN_NAME = "auth";
+/**
+ * auth 支持的渠道目录。
+ */
+export declare const CHAT_AUTHORIZATION_CHANNELS: readonly ["telegram", "feishu", "qq"];
+/**
+ * 鉴权渠道类型。
+ */
+export type ChatAuthorizationChannel = (typeof CHAT_AUTHORIZATION_CHANNELS)[number];
+/**
+ * auth 扩展点名称集合。
+ */
+export declare const AUTH_PLUGIN_POINTS: {
+    readonly observePrincipal: "chat.observePrincipal";
+    readonly authorizeIncoming: "chat.authorizeIncoming";
+    readonly resolveUserRole: "chat.resolveUserRole";
+};
+/**
+ * auth action 名称集合。
+ */
+export declare const AUTH_ACTIONS: {
+    readonly snapshot: "snapshot";
+    readonly readConfig: "read-config";
+    readonly writeConfig: "write-config";
+    readonly setUserRole: "set-user-role";
+};
+/**
+ * 可配置的授权权限目录。
+ */
+export declare const CHAT_AUTHORIZATION_PERMISSIONS: readonly ["chat.dm.use", "chat.group.use", "auth.manage.users", "auth.manage.roles", "agent.view.logs", "agent.manage"];
+/**
+ * 可配置的授权权限。
+ */
+export type ChatAuthorizationPermission = (typeof CHAT_AUTHORIZATION_PERMISSIONS)[number];
+/**
+ * 权限展示文案映射。
+ */
+export declare const CHAT_AUTHORIZATION_PERMISSION_LABELS: Record<ChatAuthorizationPermission, string>;
+/**
+ * 权限说明文案映射。
+ */
+export declare const CHAT_AUTHORIZATION_PERMISSION_DESCRIPTIONS: Record<ChatAuthorizationPermission, string>;
+/**
+ * 单个权限展示元信息。
+ */
+export interface ChatAuthorizationPermissionMeta {
+    /**
+     * 权限稳定标识。
+     */
+    permission: ChatAuthorizationPermission;
+    /**
+     * 权限展示名。
+     */
+    name: string;
+    /**
+     * 权限说明。
+     */
+    description: string;
+}
+/**
+ * auth 目录快照。
+ */
+export interface ChatAuthorizationCatalog {
+    /**
+     * auth 支持的渠道列表。
+     */
+    channels: ChatAuthorizationChannel[];
+    /**
+     * 权限列表。
+     */
+    permissions: ChatAuthorizationPermission[];
+    /**
+     * 权限展示文案映射。
+     */
+    permissionLabels: Record<ChatAuthorizationPermission, string>;
+    /**
+     * 权限展示元信息。
+     */
+    permissionMeta: Record<ChatAuthorizationPermission, ChatAuthorizationPermissionMeta>;
+}
+/**
+ * auth 统一目录常量。
+ */
+export declare const CHAT_AUTHORIZATION_CATALOG: ChatAuthorizationCatalog;
+/**
+ * 单个角色定义。
+ */
+export interface ChatAuthorizationRole {
+    /**
+     * 角色唯一标识。
+     */
+    roleId: string;
+    /**
+     * 角色展示名。
+     */
+    name: string;
+    /**
+     * 角色说明。
+     */
+    description?: string;
+    /**
+     * 角色拥有的权限集合。
+     */
+    permissions: ChatAuthorizationPermission[];
+}
+/**
+ * 构建默认权限组。
+ */
+export declare function createDefaultChatAuthorizationRoles(): Record<string, ChatAuthorizationRole>;
+/**
+ * 判断给定值是否为 auth 支持的渠道。
+ */
+export declare function isChatAuthorizationChannel(value: unknown): value is ChatAuthorizationChannel;
+/**
+ * 单个渠道的授权配置。
+ */
+export interface ChatChannelAuthorizationConfig {
+    /**
+     * 新用户默认角色 ID。
+     */
+    defaultUserRoleId?: string;
+    /**
+     * 用户角色绑定表。
+     */
+    userRoles?: Record<string, string>;
+}
+/**
+ * 授权总配置。
+ */
+export interface ChatAuthorizationConfig {
+    /**
+     * 全局角色定义表。
+     */
+    roles?: Record<string, ChatAuthorizationRole>;
+    /**
+     * 各渠道授权绑定配置。
+     */
+    channels?: Partial<Record<ChatDispatchChannel, ChatChannelAuthorizationConfig>>;
+}
+/**
+ * 入站授权判定输入。
+ */
+export interface ChatAuthorizationEvaluateInput {
+    /**
+     * 当前消息来源渠道。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 当前消息所属会话 ID。
+     */
+    chatId: string;
+    /**
+     * 当前消息所属会话类型。
+     */
+    chatType?: string;
+    /**
+     * 当前消息发送者用户 ID。
+     */
+    userId?: string;
+    /**
+     * 当前消息发送者展示名。
+     */
+    username?: string;
+    /**
+     * 当前会话展示名。
+     */
+    chatTitle?: string;
+}
+/**
+ * 授权判定结果。
+ */
+export type ChatAuthorizationDecision = "allow" | "block";
+/**
+ * 运行时授权结果。
+ */
+export interface ChatAuthorizationEvaluateResult {
+    /**
+     * 最终判定结果。
+     */
+    decision: ChatAuthorizationDecision;
+    /**
+     * 当前用户是否拥有高权限。
+     */
+    isOwner: boolean;
+    /**
+     * 当前用户匹配到的角色 ID。
+     */
+    userRoleId: string;
+    /**
+     * 当前用户匹配到的权限列表。
+     */
+    userPermissions: ChatAuthorizationPermission[];
+    /**
+     * 结果原因。
+     */
+    reason: string;
+}
+/**
+ * 观测到的用户主体快照。
+ */
+export interface ChatAuthorizationObservedUser {
+    /**
+     * 记录版本号。
+     */
+    v: 1;
+    /**
+     * 渠道名。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 用户 ID。
+     */
+    userId: string;
+    /**
+     * 最近一次观测到的用户名 / 展示名。
+     */
+    username?: string;
+    /**
+     * 最近一次发言所在会话 ID。
+     */
+    lastChatId?: string;
+    /**
+     * 最近一次发言所在会话标题。
+     */
+    lastChatTitle?: string;
+    /**
+     * 最近一次发言所在会话类型。
+     */
+    lastChatType?: string;
+    /**
+     * 首次观测时间戳（毫秒）。
+     */
+    firstSeenAt: number;
+    /**
+     * 最近观测时间戳（毫秒）。
+     */
+    lastSeenAt: number;
+}
+/**
+ * 观测到的会话主体快照。
+ */
+export interface ChatAuthorizationObservedChat {
+    /**
+     * 记录版本号。
+     */
+    v: 1;
+    /**
+     * 渠道名。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 会话 ID。
+     */
+    chatId: string;
+    /**
+     * 最近一次观测到的会话标题。
+     */
+    chatTitle?: string;
+    /**
+     * 会话类型。
+     */
+    chatType?: string;
+    /**
+     * 最近一次发言用户 ID。
+     */
+    lastActorId?: string;
+    /**
+     * 最近一次发言用户名 / 展示名。
+     */
+    lastActorName?: string;
+    /**
+     * 首次观测时间戳（毫秒）。
+     */
+    firstSeenAt: number;
+    /**
+     * 最近观测时间戳（毫秒）。
+     */
+    lastSeenAt: number;
+}
+/**
+ * 授权快照。
+ */
+export interface ChatAuthorizationSnapshot {
+    /**
+     * 当前静态授权配置。
+     */
+    config: ChatAuthorizationConfig;
+    /**
+     * 已观测用户列表。
+     */
+    users: ChatAuthorizationObservedUser[];
+    /**
+     * 已观测会话列表。
+     */
+    chats: ChatAuthorizationObservedChat[];
+}
+/**
+ * 运行时状态文件结构。
+ */
+export interface ChatAuthorizationStateFile {
+    /**
+     * 状态文件版本号。
+     */
+    v: 1;
+    /**
+     * 最近更新时间戳（毫秒）。
+     */
+    updatedAt: number;
+    /**
+     * 用户快照索引。
+     */
+    usersByKey: Record<string, ChatAuthorizationObservedUser>;
+    /**
+     * 会话快照索引。
+     */
+    chatsByKey: Record<string, ChatAuthorizationObservedChat>;
+}
+/**
+ * plugin effect 输入：记录观测主体。
+ */
+export interface AuthObservePrincipalPayload {
+    /**
+     * 当前渠道。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 当前会话 ID。
+     */
+    chatId: string;
+    /**
+     * 当前会话类型。
+     */
+    chatType?: string;
+    /**
+     * 当前会话展示名。
+     */
+    chatTitle?: string;
+    /**
+     * 当前用户 ID。
+     */
+    userId?: string;
+    /**
+     * 当前用户展示名。
+     */
+    username?: string;
+}
+/**
+ * plugin effect 输出：记录观测主体结果。
+ */
+export interface AuthObservePrincipalResult {
+    /**
+     * 是否成功落盘。
+     */
+    observed: true;
+}
+/**
+ * plugin resolve 输入：查询用户角色。
+ */
+export interface AuthResolveUserRolePayload {
+    /**
+     * 当前渠道。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 用户 ID。
+     */
+    userId?: string;
+}
+/**
+ * action: 覆盖写入配置输入。
+ */
+export interface AuthWriteConfigPayload {
+    /**
+     * 新配置。
+     */
+    config: ChatAuthorizationConfig;
+}
+/**
+ * action: 设置用户角色输入。
+ */
+export interface AuthSetUserRolePayload {
+    /**
+     * 当前渠道。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 用户 ID。
+     */
+    userId: string;
+    /**
+     * 目标角色 ID。
+     */
+    roleId: string;
+}
+//# sourceMappingURL=AuthPlugin.d.ts.map

package/bin/auth/types/AuthPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthPlugin.d.ts","sourceRoot":"","sources":["../../../src/auth/types/AuthPlugin.ts"],"names":[],"mappings":"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"}