@pcontext/api 0.0.1

package/dist/shared/deps.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.mjs","names":[],"sources":["../../src/shared/deps.ts"],"sourcesContent":["import type { IDocRepository } from '@/modules/doc/doc.repo.interface'\nimport type { ITaskRepository } from '@/modules/task/task.repo.interface'\nimport type { IUserRepository } from '@/modules/user/domain/user.repo.interface'\n\nimport { ChatService } from '@/modules/doc/chat.service'\nimport { DocService } from '@/modules/doc/doc.service'\nimport { PgDocRepository } from '@/modules/doc/infrastructure/doc.repo.pg'\nimport { SqliteDocRepository } from '@/modules/doc/infrastructure/doc.repo.sqlite'\nimport { RankService } from '@/modules/rank/rank.service'\nimport { PgTaskRepository } from '@/modules/task/infrastructure/task.repo.pg'\nimport { SqliteTaskRepository } from '@/modules/task/infrastructure/task.repo.sqlite'\nimport { TaskService } from '@/modules/task/task.service'\nimport { userPg, userSqlite } from '@/modules/user/infrastructure/user.po'\nimport { PgUserRepository } from '@/modules/user/infrastructure/user.repo.pg'\nimport { SqliteUserRepository } from '@/modules/user/infrastructure/user.repo.sqlite'\nimport { getDbProvider, getPgDb, getSqliteDb } from '@/shared/db/connection'\n\nexport type DatabaseProvider = 'postgresql' | 'sqlite'\n\nexport interface RepoDeps {\n  provider: DatabaseProvider\n  userRepo: IUserRepository\n  docRepo: IDocRepository\n  taskRepo: ITaskRepository\n  ping: () => Promise<boolean>\n}\n\nexport interface ServiceDeps {\n  taskService: TaskService\n  rankService: RankService\n  chatService: ChatService\n  docService: DocService\n}\n\nlet repoDeps: RepoDeps | null = null\n\nlet serviceDeps: ServiceDeps | null = null\n\nexport function getRepoDeps(): RepoDeps {\n  if (repoDeps)\n    return repoDeps\n\n  const provider = getDbProvider()\n\n  if (provider === 'postgresql') {\n    const db = getPgDb()\n    const userRepo = new PgUserRepository(db)\n    const docRepo = new PgDocRepository(db)\n    const taskRepo = new PgTaskRepository(db)\n\n    repoDeps = {\n      provider,\n      userRepo,\n      docRepo,\n      taskRepo,\n      async ping() {\n        try {\n          await db.select().from(userPg).limit(1)\n          return true\n        }\n        catch {\n          return false\n        }\n      },\n    }\n\n    return repoDeps\n  }\n\n  const db = getSqliteDb()\n  const userRepo = new SqliteUserRepository(db)\n  const docRepo = new SqliteDocRepository(db)\n  const taskRepo = new SqliteTaskRepository(db)\n\n  repoDeps = {\n    provider,\n    userRepo,\n    docRepo,\n    taskRepo,\n    async ping() {\n      try {\n        await db.select().from(userSqlite).limit(1)\n        return true\n      }\n      catch {\n        return false\n      }\n    },\n  }\n\n  return repoDeps\n}\n\nexport function getServiceDeps() {\n  if (serviceDeps)\n    return serviceDeps\n\n  const docRepo = getRepoDeps().docRepo\n\n  serviceDeps = {\n    taskService: new TaskService(),\n    rankService: new RankService(docRepo),\n    chatService: new ChatService(),\n    docService: new DocService(),\n  }\n\n  return serviceDeps\n}\n"],"mappings":";;;;;;;;;;;;;;AAkCA,IAAI,WAA4B;AAEhC,IAAI,cAAkC;AAEtC,SAAgB,cAAwB;AACtC,KAAI,SACF,QAAO;CAET,MAAM,WAAW,eAAe;AAEhC,KAAI,aAAa,cAAc;EAC7B,MAAM,KAAK,SAAS;AAKpB,aAAW;GACT;GACA,UANe,IAAI,iBAAiB,GAAG;GAOvC,SANc,IAAI,gBAAgB,GAAG;GAOrC,UANe,IAAI,iBAAiB,GAAG;GAOvC,MAAM,OAAO;AACX,QAAI;AACF,WAAM,GAAG,QAAQ,CAAC,KAAK,OAAO,CAAC,MAAM,EAAE;AACvC,YAAO;YAEH;AACJ,YAAO;;;GAGZ;AAED,SAAO;;CAGT,MAAM,KAAK,aAAa;AAKxB,YAAW;EACT;EACA,UANe,IAAI,qBAAqB,GAAG;EAO3C,SANc,IAAI,oBAAoB,GAAG;EAOzC,UANe,IAAI,qBAAqB,GAAG;EAO3C,MAAM,OAAO;AACX,OAAI;AACF,UAAM,GAAG,QAAQ,CAAC,KAAK,WAAW,CAAC,MAAM,EAAE;AAC3C,WAAO;WAEH;AACJ,WAAO;;;EAGZ;AAED,QAAO;;AAGT,SAAgB,iBAAiB;AAC/B,KAAI,YACF,QAAO;CAET,MAAM,UAAU,aAAa,CAAC;AAE9B,eAAc;EACZ,aAAa,IAAI,aAAa;EAC9B,aAAa,IAAI,YAAY,QAAQ;EACrC,aAAa,IAAI,aAAa;EAC9B,YAAY,IAAI,YAAY;EAC7B;AAED,QAAO"}

package/dist/shared/dto/index.d.mts

@@ -0,0 +1,11 @@
+import { z as z$1 } from "zod";
+
+//#region src/shared/dto/index.d.ts
+declare const paginationQuerySchema: z$1.ZodObject<{
+  page: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodCoercedNumber<unknown>>>;
+  pageSize: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodCoercedNumber<unknown>>>;
+}, z$1.core.$strip>;
+type PaginationQueryDTO = z$1.infer<typeof paginationQuerySchema>;
+//#endregion
+export { PaginationQueryDTO, paginationQuerySchema };
+//# sourceMappingURL=index.d.mts.map

package/dist/shared/dto/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/shared/dto/index.ts"],"mappings":";;;cAEa,qBAAA,EAAqB,GAAA,CAAA,SAAA;;;;KAKtB,kBAAA,GAAqB,GAAA,CAAE,KAAA,QAAa,qBAAA"}

package/dist/shared/dto/index.mjs

@@ -0,0 +1,11 @@
+import { z as z$1 } from "zod";
+
+//#region src/shared/dto/index.ts
+const paginationQuerySchema = z$1.object({
+	page: z$1.coerce.number().int().min(1).optional().default(1),
+	pageSize: z$1.coerce.number().int().min(1).max(100).optional().default(10)
+});
+
+//#endregion
+export { paginationQuerySchema };
+//# sourceMappingURL=index.mjs.map

package/dist/shared/dto/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["z"],"sources":["../../../src/shared/dto/index.ts"],"sourcesContent":["import { z } from 'zod'\n\nexport const paginationQuerySchema = z.object({\n  page: z.coerce.number().int().min(1).optional().default(1),\n  pageSize: z.coerce.number().int().min(1).max(100).optional().default(10),\n})\n\nexport type PaginationQueryDTO = z.infer<typeof paginationQuerySchema>\n"],"mappings":";;;AAEA,MAAa,wBAAwBA,IAAE,OAAO;CAC5C,MAAMA,IAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE;CAC1D,UAAUA,IAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG;CACzE,CAAC"}

package/dist/shared/logger.d.mts

@@ -0,0 +1,14 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import pino from "pino";
+
+//#region src/shared/logger.d.ts
+interface TraceContext {
+  traceId: string;
+  taskId?: string;
+}
+declare const traceStorage: AsyncLocalStorage<TraceContext>;
+declare const logger: pino.Logger<never, boolean>;
+declare function runInContext<T>(traceId: string, fn: () => T, taskId?: string): T;
+//#endregion
+export { logger, runInContext, traceStorage };
+//# sourceMappingURL=logger.d.mts.map

package/dist/shared/logger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.mts","names":[],"sources":["../../src/shared/logger.ts"],"mappings":";;;;UAMU,YAAA;EACR,OAAA;EACA,MAAA;AAAA;AAAA,cAGW,YAAA,EAAY,iBAAA,CAAA,YAAA;AAAA,cAaZ,MAAA,EAAM,IAAA,CAAA,MAAA;AAAA,iBAeH,YAAA,GAAA,CAAgB,OAAA,UAAiB,EAAA,QAAU,CAAA,EAAG,MAAA,YAAkB,CAAA"}

package/dist/shared/logger.mjs

@@ -0,0 +1,37 @@
+import AppSettings from "../settings.mjs";
+import { AsyncLocalStorage } from "node:async_hooks";
+import pino from "pino";
+
+//#region src/shared/logger.ts
+const { config } = AppSettings;
+const traceStorage = new AsyncLocalStorage();
+const transport = config.log.pretty && config.is_dev ? pino.transport({
+	target: "pino-pretty",
+	options: {
+		colorize: true,
+		translateTime: "SYS:standard",
+		singleLine: false
+	}
+}) : void 0;
+const logger = pino({
+	level: config.log.level,
+	enabled: config.log.enabled,
+	redact: config.log.redact,
+	mixin() {
+		const store = traceStorage.getStore();
+		if (!store) return {};
+		const base = {};
+		if (store.traceId) base.traceId = store.traceId;
+		return base;
+	}
+}, transport);
+function runInContext(traceId, fn, taskId) {
+	return traceStorage.run({
+		traceId,
+		taskId
+	}, fn);
+}
+
+//#endregion
+export { logger, runInContext, traceStorage };
+//# sourceMappingURL=logger.mjs.map

package/dist/shared/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","names":[],"sources":["../../src/shared/logger.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\nimport pino from 'pino'\nimport AppSettings from '@/settings'\n\nconst { config } = AppSettings\n\ninterface TraceContext {\n  traceId: string\n  taskId?: string\n}\n\nexport const traceStorage = new AsyncLocalStorage<TraceContext>()\n\nconst transport = config.log.pretty && config.is_dev\n  ? pino.transport({\n      target: 'pino-pretty',\n      options: {\n        colorize: true,\n        translateTime: 'SYS:standard',\n        singleLine: false,\n      },\n    })\n  : undefined\n\nexport const logger = pino({\n  level: config.log.level,\n  enabled: config.log.enabled,\n  redact: config.log.redact,\n  mixin() {\n    const store = traceStorage.getStore()\n    if (!store)\n      return {}\n    const base: Record<string, string> = {}\n    if (store.traceId)\n      base.traceId = store.traceId\n    return base\n  },\n}, transport)\n\nexport function runInContext<T>(traceId: string, fn: () => T, taskId?: string): T {\n  return traceStorage.run({ traceId, taskId }, fn)\n}\n"],"mappings":";;;;;AAIA,MAAM,EAAE,WAAW;AAOnB,MAAa,eAAe,IAAI,mBAAiC;AAEjE,MAAM,YAAY,OAAO,IAAI,UAAU,OAAO,SAC1C,KAAK,UAAU;CACb,QAAQ;CACR,SAAS;EACP,UAAU;EACV,eAAe;EACf,YAAY;EACb;CACF,CAAC,GACF;AAEJ,MAAa,SAAS,KAAK;CACzB,OAAO,OAAO,IAAI;CAClB,SAAS,OAAO,IAAI;CACpB,QAAQ,OAAO,IAAI;CACnB,QAAQ;EACN,MAAM,QAAQ,aAAa,UAAU;AACrC,MAAI,CAAC,MACH,QAAO,EAAE;EACX,MAAM,OAA+B,EAAE;AACvC,MAAI,MAAM,QACR,MAAK,UAAU,MAAM;AACvB,SAAO;;CAEV,EAAE,UAAU;AAEb,SAAgB,aAAgB,SAAiB,IAAa,QAAoB;AAChF,QAAO,aAAa,IAAI;EAAE;EAAS;EAAQ,EAAE,GAAG"}

package/dist/shared/mcp/createTool.d.mts

@@ -0,0 +1,15 @@
+import { ZodTypeAny, infer as __Infer } from "zod";
+
+//#region src/shared/mcp/createTool.d.ts
+interface ToolDefinition<TInputSchema extends ZodTypeAny, TOutputSchema extends ZodTypeAny | undefined = undefined> {
+  name: string;
+  title?: string;
+  description: string;
+  schema: TInputSchema;
+  outputSchema?: TOutputSchema;
+  handler: (input: __Infer<TInputSchema>) => Promise<unknown> | unknown;
+}
+declare function createTool<TInputSchema extends ZodTypeAny, TOutputSchema extends ZodTypeAny | undefined = undefined>(tool: ToolDefinition<TInputSchema, TOutputSchema>): ToolDefinition<TInputSchema, TOutputSchema>;
+//#endregion
+export { ToolDefinition, createTool };
+//# sourceMappingURL=createTool.d.mts.map

package/dist/shared/mcp/createTool.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTool.d.mts","names":[],"sources":["../../../src/shared/mcp/createTool.ts"],"mappings":";;;UAEiB,cAAA,sBACM,UAAA,wBACC,UAAA;EAEtB,IAAA;EACA,KAAA;EACA,WAAA;EACA,MAAA,EAAQ,YAAA;EACR,YAAA,GAAe,aAAA;EACf,OAAA,GAAU,KAAA,EAAO,OAAA,CAAS,YAAA,MAAkB,OAAA;AAAA;AAAA,iBAG9B,UAAA,sBACO,UAAA,wBACC,UAAA,yBAAA,CACtB,IAAA,EAAM,cAAA,CAAe,YAAA,EAAc,aAAA,IAAc,cAAA,CAAA,YAAA,EAAA,aAAA"}

package/dist/shared/mcp/createTool.mjs

@@ -0,0 +1,8 @@
+//#region src/shared/mcp/createTool.ts
+function createTool(tool) {
+	return tool;
+}
+
+//#endregion
+export { createTool };
+//# sourceMappingURL=createTool.mjs.map

package/dist/shared/mcp/createTool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTool.mjs","names":[],"sources":["../../../src/shared/mcp/createTool.ts"],"sourcesContent":["import type { infer as ZodInfer, ZodTypeAny } from 'zod'\n\nexport interface ToolDefinition<\n  TInputSchema extends ZodTypeAny,\n  TOutputSchema extends ZodTypeAny | undefined = undefined,\n> {\n  name: string\n  title?: string\n  description: string\n  schema: TInputSchema\n  outputSchema?: TOutputSchema\n  handler: (input: ZodInfer<TInputSchema>) => Promise<unknown> | unknown\n}\n\nexport function createTool<\n  TInputSchema extends ZodTypeAny,\n  TOutputSchema extends ZodTypeAny | undefined = undefined,\n>(tool: ToolDefinition<TInputSchema, TOutputSchema>) {\n  return tool\n}\n"],"mappings":";AAcA,SAAgB,WAGd,MAAmD;AACnD,QAAO"}

package/dist/shared/middleware/authorization.d.mts

@@ -0,0 +1,15 @@
+import * as hono from "hono";
+import { Context, Next } from "hono";
+
+//#region src/shared/middleware/authorization.d.ts
+declare function authorization(config?: {
+  safeMethods?: string[];
+  safePaths?: string[];
+}): (c: Context, next: Next) => Promise<void | (Response & hono.TypedResponse<{
+  message: string;
+}, 403, "json">) | (Response & hono.TypedResponse<{
+  message: string;
+}, 401, "json">)>;
+//#endregion
+export { authorization };
+//# sourceMappingURL=authorization.d.mts.map

package/dist/shared/middleware/authorization.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization.d.mts","names":[],"sources":["../../../src/shared/middleware/authorization.ts"],"mappings":";;;;iBAQgB,aAAA,CAAc,MAAA;EAC5B,WAAA;EACA,SAAA;AAAA,KAMc,CAAA,EAAG,OAAA,EAAS,IAAA,EAAM,IAAA,KAAI,OAAA,SAAA,QAAA,GAAA,IAAA,CAAA,aAAA"}

package/dist/shared/middleware/authorization.mjs

@@ -0,0 +1,46 @@
+import { logger } from "../logger.mjs";
+import { getEnforcer } from "../../modules/user/infrastructure/casbin/enforcer.mjs";
+import { getCookie } from "hono/cookie";
+
+//#region src/shared/middleware/authorization.ts
+const SAFE_METHODS = [
+	"GET",
+	"HEAD",
+	"OPTIONS"
+];
+const SAFE_PATHS = [
+	"/api/users/login",
+	"/api/chat",
+	"/api/ranking/docs",
+	"/mcp"
+];
+function authorization(config) {
+	const { safeMethods = SAFE_METHODS, safePaths = SAFE_PATHS } = config || {};
+	return async (c, next) => {
+		if (c.req.method === "OPTIONS") return next();
+		const user = c.get("user");
+		const hasRole = typeof user?.role === "string" && user.role.length > 0;
+		if (!safeMethods.includes(c.req.method) && !safePaths.includes(c.req.path)) {
+			const csrfCookie = getCookie(c, "csrf_token");
+			const csrfHeader = c.req.header("X-CSRF-Token");
+			if (!csrfCookie || !csrfHeader || csrfCookie !== csrfHeader) {
+				logger.warn(`CSRF Token Mismatch, cookie csrf_token: ${csrfCookie}, header X-CSRF-Token: ${csrfHeader}`);
+				return c.json({ message: "CSRF Token Mismatch" }, 403);
+			}
+		}
+		const enforcer = getEnforcer();
+		const role = hasRole ? user.role : "guest";
+		const obj = c.req.path;
+		const act = c.req.method;
+		logger.info(`Authorization, role: ${role}, obj: ${obj}, act: ${act}`);
+		if (!await enforcer.enforce(role, obj, act)) {
+			if (hasRole) return c.json({ message: "无权限" }, 403);
+			return c.json({ message: "未登录或登录状态异常" }, 401);
+		}
+		return next();
+	};
+}
+
+//#endregion
+export { authorization };
+//# sourceMappingURL=authorization.mjs.map

package/dist/shared/middleware/authorization.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization.mjs","names":[],"sources":["../../../src/shared/middleware/authorization.ts"],"sourcesContent":["import type { Context, Next } from 'hono'\nimport { getCookie } from 'hono/cookie'\nimport { getEnforcer } from '@/modules/user/infrastructure/casbin/enforcer'\nimport { logger } from '@/shared/logger'\n\nconst SAFE_METHODS = ['GET', 'HEAD', 'OPTIONS']\nconst SAFE_PATHS = ['/api/users/login', '/api/chat', '/api/ranking/docs', '/mcp']\n\nexport function authorization(config?: {\n  safeMethods?: string[]\n  safePaths?: string[]\n}) {\n  const {\n    safeMethods = SAFE_METHODS,\n    safePaths = SAFE_PATHS,\n  } = config || {}\n  return async (c: Context, next: Next) => {\n    if (c.req.method === 'OPTIONS')\n      return next()\n    const user = c.get('user') as { id: number, username: string, role: string | null } | undefined\n    const hasRole = typeof user?.role === 'string' && user.role.length > 0\n    // TODO: 进一步考虑guest 身份 和 资源权限\n    if (!safeMethods.includes(c.req.method) && !safePaths.includes(c.req.path)) {\n      const csrfCookie = getCookie(c, 'csrf_token')\n      const csrfHeader = c.req.header('X-CSRF-Token')\n      if (!csrfCookie || !csrfHeader || csrfCookie !== csrfHeader) {\n        logger.warn(`CSRF Token Mismatch, cookie csrf_token: ${csrfCookie}, header X-CSRF-Token: ${csrfHeader}`)\n        return c.json({ message: 'CSRF Token Mismatch' }, 403)\n      }\n    }\n\n    const enforcer = getEnforcer()\n    const role = hasRole ? user!.role : 'guest'\n    const obj = c.req.path\n    const act = c.req.method\n    logger.info(`Authorization, role: ${role}, obj: ${obj}, act: ${act}`)\n\n    const allowed = await enforcer.enforce(role, obj, act)\n    if (!allowed) {\n      if (hasRole) {\n        return c.json({ message: '无权限' }, 403)\n      }\n      return c.json({ message: '未登录或登录状态异常' }, 401)\n    }\n    return next()\n  }\n}\n"],"mappings":";;;;;AAKA,MAAM,eAAe;CAAC;CAAO;CAAQ;CAAU;AAC/C,MAAM,aAAa;CAAC;CAAoB;CAAa;CAAqB;CAAO;AAEjF,SAAgB,cAAc,QAG3B;CACD,MAAM,EACJ,cAAc,cACd,YAAY,eACV,UAAU,EAAE;AAChB,QAAO,OAAO,GAAY,SAAe;AACvC,MAAI,EAAE,IAAI,WAAW,UACnB,QAAO,MAAM;EACf,MAAM,OAAO,EAAE,IAAI,OAAO;EAC1B,MAAM,UAAU,OAAO,MAAM,SAAS,YAAY,KAAK,KAAK,SAAS;AAErE,MAAI,CAAC,YAAY,SAAS,EAAE,IAAI,OAAO,IAAI,CAAC,UAAU,SAAS,EAAE,IAAI,KAAK,EAAE;GAC1E,MAAM,aAAa,UAAU,GAAG,aAAa;GAC7C,MAAM,aAAa,EAAE,IAAI,OAAO,eAAe;AAC/C,OAAI,CAAC,cAAc,CAAC,cAAc,eAAe,YAAY;AAC3D,WAAO,KAAK,2CAA2C,WAAW,yBAAyB,aAAa;AACxG,WAAO,EAAE,KAAK,EAAE,SAAS,uBAAuB,EAAE,IAAI;;;EAI1D,MAAM,WAAW,aAAa;EAC9B,MAAM,OAAO,UAAU,KAAM,OAAO;EACpC,MAAM,MAAM,EAAE,IAAI;EAClB,MAAM,MAAM,EAAE,IAAI;AAClB,SAAO,KAAK,wBAAwB,KAAK,SAAS,IAAI,SAAS,MAAM;AAGrE,MAAI,CADY,MAAM,SAAS,QAAQ,MAAM,KAAK,IAAI,EACxC;AACZ,OAAI,QACF,QAAO,EAAE,KAAK,EAAE,SAAS,OAAO,EAAE,IAAI;AAExC,UAAO,EAAE,KAAK,EAAE,SAAS,cAAc,EAAE,IAAI;;AAE/C,SAAO,MAAM"}

package/dist/shared/middleware/http-logger.d.mts

@@ -0,0 +1,7 @@
+import { MiddlewareHandler } from "hono";
+
+//#region src/shared/middleware/http-logger.d.ts
+declare function httpLogger(): MiddlewareHandler;
+//#endregion
+export { httpLogger };
+//# sourceMappingURL=http-logger.d.mts.map

package/dist/shared/middleware/http-logger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-logger.d.mts","names":[],"sources":["../../../src/shared/middleware/http-logger.ts"],"mappings":";;;iBAOgB,UAAA,CAAA,GAAc,iBAAA"}

package/dist/shared/middleware/http-logger.mjs

@@ -0,0 +1,40 @@
+import AppSettings from "../../settings.mjs";
+import { logger, runInContext } from "../logger.mjs";
+import { randomUUID } from "node:crypto";
+
+//#region src/shared/middleware/http-logger.ts
+const { config } = AppSettings;
+function httpLogger() {
+	return async (c, next) => {
+		const start = Date.now();
+		const requestId = c.get("requestId");
+		const traceId = typeof requestId === "string" && requestId.length > 0 ? requestId : randomUUID();
+		return runInContext(traceId, async () => {
+			const scoped = logger.child({});
+			c.set("logger", scoped);
+			c.set("traceId", traceId);
+			await next();
+			const url = c.req.path;
+			const method = c.req.method;
+			const status = c.res.status;
+			const duration = Date.now() - start;
+			if (!config.log.autoLoggingIgnorePaths.some((path) => url.startsWith(path))) {
+				const user = c.get("user");
+				scoped.info({
+					method,
+					url,
+					status,
+					duration,
+					user: {
+						name: user?.username,
+						role: user?.role || "guest"
+					}
+				}, "request completed");
+			}
+		});
+	};
+}
+
+//#endregion
+export { httpLogger };
+//# sourceMappingURL=http-logger.mjs.map

package/dist/shared/middleware/http-logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-logger.mjs","names":[],"sources":["../../../src/shared/middleware/http-logger.ts"],"sourcesContent":["import type { MiddlewareHandler } from 'hono'\nimport { randomUUID } from 'node:crypto'\nimport AppSettings from '@/settings'\nimport { logger, runInContext } from '@/shared/logger'\n\nconst { config } = AppSettings\n\nexport function httpLogger(): MiddlewareHandler {\n  return async (c, next) => {\n    const start = Date.now()\n    const requestId = c.get('requestId')\n    const traceId = typeof requestId === 'string' && requestId.length > 0 ? requestId : randomUUID()\n\n    return runInContext(traceId, async () => {\n      const scoped = logger.child({})\n      c.set('logger', scoped)\n      c.set('traceId', traceId)\n\n      await next()\n\n      const url = c.req.path\n      const method = c.req.method\n      const status = c.res.status\n      const duration = Date.now() - start\n\n      const ignore = config.log.autoLoggingIgnorePaths.some((path: string) => url.startsWith(path))\n      if (!ignore) {\n        const user = c.get('user')\n        scoped.info({ method, url, status, duration, user: {\n          name: user?.username,\n          role: user?.role || 'guest',\n        } }, 'request completed')\n      }\n    })\n  }\n}\n"],"mappings":";;;;;AAKA,MAAM,EAAE,WAAW;AAEnB,SAAgB,aAAgC;AAC9C,QAAO,OAAO,GAAG,SAAS;EACxB,MAAM,QAAQ,KAAK,KAAK;EACxB,MAAM,YAAY,EAAE,IAAI,YAAY;EACpC,MAAM,UAAU,OAAO,cAAc,YAAY,UAAU,SAAS,IAAI,YAAY,YAAY;AAEhG,SAAO,aAAa,SAAS,YAAY;GACvC,MAAM,SAAS,OAAO,MAAM,EAAE,CAAC;AAC/B,KAAE,IAAI,UAAU,OAAO;AACvB,KAAE,IAAI,WAAW,QAAQ;AAEzB,SAAM,MAAM;GAEZ,MAAM,MAAM,EAAE,IAAI;GAClB,MAAM,SAAS,EAAE,IAAI;GACrB,MAAM,SAAS,EAAE,IAAI;GACrB,MAAM,WAAW,KAAK,KAAK,GAAG;AAG9B,OAAI,CADW,OAAO,IAAI,uBAAuB,MAAM,SAAiB,IAAI,WAAW,KAAK,CAAC,EAChF;IACX,MAAM,OAAO,EAAE,IAAI,OAAO;AAC1B,WAAO,KAAK;KAAE;KAAQ;KAAK;KAAQ;KAAU,MAAM;MACjD,MAAM,MAAM;MACZ,MAAM,MAAM,QAAQ;MACrB;KAAE,EAAE,oBAAoB;;IAE3B"}

package/dist/shared/middleware/jwt.d.mts

@@ -0,0 +1,7 @@
+import { MiddlewareHandler } from "hono";
+
+//#region src/shared/middleware/jwt.d.ts
+declare function jwt(): MiddlewareHandler;
+//#endregion
+export { jwt };
+//# sourceMappingURL=jwt.d.mts.map

package/dist/shared/middleware/jwt.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.d.mts","names":[],"sources":["../../../src/shared/middleware/jwt.ts"],"mappings":";;;iBAMgB,GAAA,CAAA,GAAO,iBAAA"}

package/dist/shared/middleware/jwt.mjs

@@ -0,0 +1,34 @@
+import AppSettings from "../../settings.mjs";
+import { logger } from "../logger.mjs";
+import { getCookie } from "hono/cookie";
+import { verify } from "hono/jwt";
+
+//#region src/shared/middleware/jwt.ts
+function jwt() {
+	return async (c, next) => {
+		const accessToken = getCookie(c, "access_token");
+		if (accessToken) try {
+			const payload = await verify(accessToken, AppSettings.config.jwt_secret, "HS256");
+			if (payload && typeof payload === "object") {
+				const sub = typeof payload.sub === "string" ? Number.parseInt(payload.sub, 10) : typeof payload.sub === "number" ? payload.sub : NaN;
+				const id = Number.isFinite(sub) ? sub : null;
+				const username = typeof payload.username === "string" ? payload.username : "";
+				const role = payload.role === "admin" || payload.role === "user" ? payload.role : null;
+				if (id) c.set("user", {
+					id,
+					username,
+					role
+				});
+			}
+		} catch (err) {
+			c.set("user", null);
+			logger.error("JWT verification failed:", err);
+		}
+		else c.set("user", null);
+		await next();
+	};
+}
+
+//#endregion
+export { jwt };
+//# sourceMappingURL=jwt.mjs.map

package/dist/shared/middleware/jwt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.mjs","names":[],"sources":["../../../src/shared/middleware/jwt.ts"],"sourcesContent":["import type { MiddlewareHandler } from 'hono'\nimport { getCookie } from 'hono/cookie'\nimport { verify } from 'hono/jwt'\nimport AppSettings from '@/settings'\nimport { logger } from '@/shared/logger'\n\nexport function jwt(): MiddlewareHandler {\n  return async (c, next) => {\n    const accessToken = getCookie(c, 'access_token')\n    // console.log('JWT Middleware, access_token:', accessToken)\n    if (accessToken) {\n      try {\n        const payload = await verify(accessToken, AppSettings.config.jwt_secret, 'HS256')\n        if (payload && typeof payload === 'object') {\n          const sub = typeof payload.sub === 'string'\n            ? Number.parseInt(payload.sub, 10)\n            : (typeof payload.sub === 'number' ? payload.sub : Number.NaN)\n          const id = Number.isFinite(sub) ? sub : null\n          const username = typeof (payload as any).username === 'string' ? (payload as any).username : ''\n          const role = (payload as any).role === 'admin' || (payload as any).role === 'user' ? (payload as any).role : null\n          if (id) {\n            c.set('user', { id, username, role })\n          }\n        }\n      }\n      catch (err: any) {\n        c.set('user', null)\n        logger.error('JWT verification failed:', err)\n      }\n    }\n    else {\n      c.set('user', null)\n    }\n\n    await next()\n  }\n}\n"],"mappings":";;;;;;AAMA,SAAgB,MAAyB;AACvC,QAAO,OAAO,GAAG,SAAS;EACxB,MAAM,cAAc,UAAU,GAAG,eAAe;AAEhD,MAAI,YACF,KAAI;GACF,MAAM,UAAU,MAAM,OAAO,aAAa,YAAY,OAAO,YAAY,QAAQ;AACjF,OAAI,WAAW,OAAO,YAAY,UAAU;IAC1C,MAAM,MAAM,OAAO,QAAQ,QAAQ,WAC/B,OAAO,SAAS,QAAQ,KAAK,GAAG,GAC/B,OAAO,QAAQ,QAAQ,WAAW,QAAQ,MAAM;IACrD,MAAM,KAAK,OAAO,SAAS,IAAI,GAAG,MAAM;IACxC,MAAM,WAAW,OAAQ,QAAgB,aAAa,WAAY,QAAgB,WAAW;IAC7F,MAAM,OAAQ,QAAgB,SAAS,WAAY,QAAgB,SAAS,SAAU,QAAgB,OAAO;AAC7G,QAAI,GACF,GAAE,IAAI,QAAQ;KAAE;KAAI;KAAU;KAAM,CAAC;;WAIpC,KAAU;AACf,KAAE,IAAI,QAAQ,KAAK;AACnB,UAAO,MAAM,4BAA4B,IAAI;;MAI/C,GAAE,IAAI,QAAQ,KAAK;AAGrB,QAAM,MAAM"}

package/dist/shared/middleware/limiter.d.mts

@@ -0,0 +1,7 @@
+import { MiddlewareHandler } from "hono";
+
+//#region src/shared/middleware/limiter.d.ts
+declare function limiter(_limit: number): MiddlewareHandler;
+//#endregion
+export { limiter };
+//# sourceMappingURL=limiter.d.mts.map

package/dist/shared/middleware/limiter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limiter.d.mts","names":[],"sources":["../../../src/shared/middleware/limiter.ts"],"mappings":";;;iBAEgB,OAAA,CAAQ,MAAA,WAAiB,iBAAA"}

package/dist/shared/middleware/limiter.mjs

@@ -0,0 +1,10 @@
+//#region src/shared/middleware/limiter.ts
+function limiter(_limit) {
+	return async (_c, next) => {
+		await next();
+	};
+}
+
+//#endregion
+export { limiter };
+//# sourceMappingURL=limiter.mjs.map

package/dist/shared/middleware/limiter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"limiter.mjs","names":[],"sources":["../../../src/shared/middleware/limiter.ts"],"sourcesContent":["import type { MiddlewareHandler } from 'hono'\n\nexport function limiter(_limit: number): MiddlewareHandler {\n  return async (_c, next) => {\n    await next()\n  }\n}\n"],"mappings":";AAEA,SAAgB,QAAQ,QAAmC;AACzD,QAAO,OAAO,IAAI,SAAS;AACzB,QAAM,MAAM"}

package/dist/shared/middleware/services.d.mts

@@ -0,0 +1,8 @@
+import { AppBindings } from "../types.mjs";
+import * as hono from "hono";
+
+//#region src/shared/middleware/services.d.ts
+declare function services(): hono.MiddlewareHandler<AppBindings, string, {}, Response>;
+//#endregion
+export { services };
+//# sourceMappingURL=services.d.mts.map

package/dist/shared/middleware/services.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.mts","names":[],"sources":["../../../src/shared/middleware/services.ts"],"mappings":";;;;iBAIgB,QAAA,CAAA,GAAQ,IAAA,CAAA,iBAAA,CAAA,WAAA,cAAA,QAAA"}

package/dist/shared/middleware/services.mjs

@@ -0,0 +1,19 @@
+import "../../rank.service-D2h-2iJA.mjs";
+import { getServiceDeps } from "../deps.mjs";
+import { createMiddleware } from "hono/factory";
+
+//#region src/shared/middleware/services.ts
+function services() {
+	return createMiddleware(async (c, next) => {
+		const serviceDeps = getServiceDeps();
+		c.set("taskService", serviceDeps.taskService);
+		c.set("rankService", serviceDeps.rankService);
+		c.set("chatService", serviceDeps.chatService);
+		c.set("docService", serviceDeps.docService);
+		await next();
+	});
+}
+
+//#endregion
+export { services };
+//# sourceMappingURL=services.mjs.map

package/dist/shared/middleware/services.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.mjs","names":[],"sources":["../../../src/shared/middleware/services.ts"],"sourcesContent":["import type { AppBindings } from '../types'\nimport { createMiddleware } from 'hono/factory'\nimport { getServiceDeps } from '@/shared/deps'\n\nexport function services() {\n  return createMiddleware<AppBindings>(async (c, next) => {\n    const serviceDeps = getServiceDeps()\n    c.set('taskService', serviceDeps.taskService)\n    c.set('rankService', serviceDeps.rankService)\n    c.set('chatService', serviceDeps.chatService)\n    c.set('docService', serviceDeps.docService)\n    await next()\n  })\n}\n"],"mappings":";;;;;AAIA,SAAgB,WAAW;AACzB,QAAO,iBAA8B,OAAO,GAAG,SAAS;EACtD,MAAM,cAAc,gBAAgB;AACpC,IAAE,IAAI,eAAe,YAAY,YAAY;AAC7C,IAAE,IAAI,eAAe,YAAY,YAAY;AAC7C,IAAE,IAAI,eAAe,YAAY,YAAY;AAC7C,IAAE,IAAI,cAAc,YAAY,WAAW;AAC3C,QAAM,MAAM;GACZ"}

package/dist/shared/redis/decorator.d.mts

@@ -0,0 +1,113 @@
+//#region src/shared/redis/decorator.d.ts
+interface CacheOptions {
+  /** 缓存 key，优先级高于 keyGenerator */
+  key?: string | ((...args: any[]) => string);
+  /** TTL 秒数，默认 3600 (1小时) */
+  ttl?: number;
+  /** 缓存标签，用于批量失效 */
+  tags?: (...args: any[]) => string[];
+}
+interface InvalidateOptions {
+  /** 要失效的缓存 key 列表 */
+  keys?: (...args: any[]) => string[];
+  /** 是否清除该 service 下所有缓存 */
+  all?: boolean;
+  /** 要失效的标签（推荐使用 tag 机制） */
+  tags?: (...args: any[]) => string[];
+  /** 目标命名空间，指定要失效哪些 namespace 下的缓存 */
+  namespace?: string | string[] | '*';
+}
+/**
+ * 标记为缓存服务
+ * - 为每个 service 创建 cache namespace
+ * - 提供统一 key 生成器
+ *
+ * @param namespace 自定义命名空间，默认使用类名
+ *
+ * @example
+ * ```ts
+ * @CacheableService()
+ * class UserService {
+ *   @Cache({ key: (id) => `user:${id}` })
+ *   async getUser(id: number) { ... }
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * @CacheableService('customNamespace')
+ * class CustomService { ... }
+ * ```
+ */
+declare function CacheableService(namespace?: string): <T extends new (...args: any[]) => any>(constructor: T) => T;
+/**
+ * 缓存装饰器
+ * - 从 Redis 获取/存储缓存
+ * - 支持自定义 key 和 TTL
+ * - 支持标签机制
+ *
+ * @param options 配置选项
+ *
+ * @example
+ * // 基础用法
+ * @Cache()
+ * async getUser(id: number) { ... }
+ *
+ * @example
+ * // 自定义 TTL
+ * @Cache({ ttl: 600 })
+ * async getData() { ... }
+ *
+ * @example
+ * // 自定义 key 函数
+ * @Cache({ key: (id, name) => `user:${id}:${name}` })
+ * async getUser(id: number, name: string) { ... }
+ *
+ * @example
+ * // 使用标签（推荐）
+ * @Cache({ tags: (id) => [`user:${id}`] })
+ * async getUser(id: number) { ... }
+ */
+declare function Cache(options?: CacheOptions): (target: any, _key: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * 缓存失效装饰器
+ * - 支持指定 key 失效（仅当前 namespace）
+ * - 支持清除该 service 下所有缓存
+ * - 支持标签失效（推荐，支持跨 namespace）
+ *
+ * @param options 配置选项
+ *
+ * @example
+ * // 指定 key 失效（仅当前 namespace）
+ * @Invalidate({ keys: (id) => [`getUser:${id}`] })
+ * async updateUser(id: number) { ... }
+ *
+ * @example
+ * // 使用标签失效（推荐，仅当前 namespace）
+ * @Invalidate({ tags: (id) => [`user:${id}`] })
+ * async updateUser(id: number) { ... }
+ *
+ * @example
+ * // 清除该 service 下所有缓存
+ * @Invalidate({ all: true })
+ * async clearAllCache() { ... }
+ *
+ * @example
+ * // 跨 namespace 失效 - 使用标签失效指定 namespace 的缓存
+ * @Invalidate({ tags: (id) => ['task:123'], namespace: 'DocService' })
+ * async updateTask(id: number) { ... }
+ *
+ * @example
+ * // 跨 namespace 失效 - 使用标签失效多个 namespace 的缓存
+ * @Invalidate({ tags: (id) => ['task:123'], namespace: ['DocService', 'RankService'] })
+ * async updateTask(id: number) { ... }
+ *
+ * @example
+ * // 跨 namespace 失效 - 使用标签失效所有 namespace 的缓存
+ * @Invalidate({ tags: (id) => ['task:123'], namespace: '*' })
+ * async updateTask(id: number) { ... }
+ */
+declare function Invalidate(options?: InvalidateOptions): (target: any, _key: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//#endregion
+export { Cache, type CacheOptions, CacheableService, Invalidate, type InvalidateOptions };
+//# sourceMappingURL=decorator.d.mts.map

package/dist/shared/redis/decorator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator.d.mts","names":[],"sources":["../../../src/shared/redis/decorator.ts"],"mappings":";UAIU,YAAA;EAAA;EAER,GAAA,iBAAoB,IAAA;;EAEpB,GAAA;EAFA;EAIA,IAAA,OAAW,IAAA;AAAA;AAAA,UAGH,iBAAA;EAHG;EAKX,IAAA,OAAW,IAAA;EALI;EAOf,GAAA;EAJyB;EAMzB,IAAA,OAAW,IAAA;EANc;EAQzB,SAAA;AAAA;;;;;;;AAAS;;;;;;;;;;;;AAiH6D;;;;iBAD/D,gBAAA,CAAiB,SAAA,+BACW,IAAA,iBAAqB,WAAA,EAAa,CAAA,KAAC,CAAA;;;;;;;;;;;;;AAwCI;;;;;;;;;;;;;;;;iBAHnE,KAAA,CAAM,OAAA,GAAS,YAAA,IAGL,MAAA,OAAa,IAAA,UAAc,UAAA,EAAY,kBAAA,KAAkB,kBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyFnE,UAAA,CAAW,OAAA,GAAS,iBAAA,IACV,MAAA,OAAa,IAAA,UAAc,UAAA,EAAY,kBAAA,KAAkB,kBAAA"}