sa2kit 3.2.0 → 3.2.1

package/dist/business/calendar/routes/index.d.mts

@@ -0,0 +1,191 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+/** Better Auth 实例（运行时完整 API，类型刻意保持宽松以便跨插件版本） */
+type Sa2kitAuthInstance = {
+    handler: (request: Request) => Promise<Response>;
+    api: {
+        getSession: (ctx: {
+            headers: Headers;
+        }) => Promise<{
+            user: Record<string, unknown>;
+        } | null>;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+};
+
+type CalendarAuthValidator = (request: NextRequest) => Promise<{
+    id: number;
+} | null>;
+/**
+ * 注入 calendar API 路由使用的 session 校验（应用启动时调用一次）
+ */
+declare function configureCalendarApiAuth(validateAuth: CalendarAuthValidator): void;
+/** 重置（测试用） */
+declare function resetCalendarApiAuth(): void;
+/**
+ * 使用 Better Auth session 一键配置 calendar API
+ */
+declare function configureCalendarApiWithBetterAuth(auth: Sa2kitAuthInstance, options?: {
+    db?: unknown;
+}): void;
+
+/**
+ * 创建 calendar 路由所需的 validateAuth（由 Better Auth session 注入）
+ *
+ * @example
+ * ```ts
+ * configureCalendarApiWithBetterAuth(auth, { db });
+ * const routeConfig = createDefaultCalendarRouteConfig();
+ * export const GET = createGetEventsHandler(routeConfig);
+ * ```
+ */
+declare function createCalendarAuthRequirement(validateAuth: CalendarAuthValidator): CalendarAuthValidator;
+declare function createDefaultCalendarRouteConfig(validateAuth?: CalendarAuthValidator): CalendarRouteConfig;
+declare function withCalendarDbGuard<T extends unknown[]>(handler: (...args: T) => Promise<Response>): (...args: T) => Promise<Response>;
+
+declare function createCalendarEventsRouteHandlers(config?: CalendarRouteConfig): {
+    GET: (request: NextRequest) => Promise<Response>;
+    POST: (request: NextRequest) => Promise<Response>;
+};
+declare function createCalendarEventByIdRouteHandlers(config?: CalendarRouteConfig): {
+    GET: (request: NextRequest, routeParams: {
+        params: {
+            id: string;
+        };
+    }) => Promise<Response>;
+    PUT: (request: NextRequest, routeParams: {
+        params: {
+            id: string;
+        };
+    }) => Promise<Response>;
+    DELETE: (request: NextRequest, routeParams: {
+        params: {
+            id: string;
+        };
+    }) => Promise<Response>;
+};
+declare function createCalendarBatchDeleteRouteHandlers(config?: CalendarRouteConfig): {
+    DELETE: (request: NextRequest) => Promise<Response>;
+};
+declare function createCalendarConfigRouteHandlers(config?: CalendarRouteConfig): {
+    GET: (request: NextRequest) => Promise<Response>;
+    PUT: (request: NextRequest) => Promise<Response>;
+};
+
+interface CalendarRouteConfig {
+    /**
+     * Drizzle 数据库实例
+     * 如果提供，将自动初始化 calendarDbService
+     */
+    db?: any;
+    /**
+     * 验证用户身份的函数
+     * 应该返回用户信息或 null
+     */
+    validateAuth: (request: NextRequest) => Promise<{
+        id: number;
+    } | null>;
+}
+/**
+ * 创建获取日历事件列表的处理器
+ */
+declare function createGetEventsHandler(config: CalendarRouteConfig): (request: NextRequest) => Promise<NextResponse<{
+    success: boolean;
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    data: any;
+    message: string;
+}>>;
+/**
+ * 创建日历事件的处理器
+ */
+declare function createCreateEventHandler(config: CalendarRouteConfig): (request: NextRequest) => Promise<NextResponse<{
+    success: boolean;
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    data: any;
+    message: string;
+}>>;
+/**
+ * 创建获取单个事件的处理器
+ */
+declare function createGetEventByIdHandler(config: CalendarRouteConfig): (request: NextRequest, { params }: {
+    params: {
+        id: string;
+    };
+}) => Promise<NextResponse<{
+    success: boolean;
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    data: any;
+    message: string;
+}>>;
+/**
+ * 创建更新事件的处理器
+ */
+declare function createUpdateEventHandler(config: CalendarRouteConfig): (request: NextRequest, { params }: {
+    params: {
+        id: string;
+    };
+}) => Promise<NextResponse<{
+    success: boolean;
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    data: any;
+    message: string;
+}>>;
+/**
+ * 创建删除事件的处理器
+ */
+declare function createDeleteEventHandler(config: CalendarRouteConfig): (request: NextRequest, { params }: {
+    params: {
+        id: string;
+    };
+}) => Promise<NextResponse<{
+    success: boolean;
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    message: string;
+}>>;
+/**
+ * 创建批量删除事件的处理器
+ */
+declare function createBatchDeleteEventsHandler(config: CalendarRouteConfig): (request: NextRequest) => Promise<NextResponse<{
+    success: boolean;
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    data: {
+        deletedCount: number;
+    };
+    message: string;
+}>>;
+/**
+ * 创建配置处理器的工厂
+ */
+declare function createConfigHandler(config: CalendarRouteConfig): {
+    GET: (request: NextRequest) => Promise<NextResponse<{
+        success: boolean;
+        error: string;
+    }> | NextResponse<{
+        success: boolean;
+        data: any;
+        message: string;
+    }>>;
+    PUT: (request: NextRequest) => Promise<NextResponse<{
+        success: boolean;
+        error: string;
+    }> | NextResponse<{
+        success: boolean;
+        data: any;
+        message: string;
+    }>>;
+};
+
+export { type CalendarAuthValidator, type CalendarRouteConfig, configureCalendarApiAuth, configureCalendarApiWithBetterAuth, createBatchDeleteEventsHandler, createCalendarAuthRequirement, createCalendarBatchDeleteRouteHandlers, createCalendarConfigRouteHandlers, createCalendarEventByIdRouteHandlers, createCalendarEventsRouteHandlers, createConfigHandler, createCreateEventHandler, createDefaultCalendarRouteConfig, createDeleteEventHandler, createGetEventByIdHandler, createGetEventsHandler, createUpdateEventHandler, resetCalendarApiAuth, withCalendarDbGuard };

package/dist/business/calendar/routes/index.d.ts

@@ -0,0 +1,191 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+/** Better Auth 实例（运行时完整 API，类型刻意保持宽松以便跨插件版本） */
+type Sa2kitAuthInstance = {
+    handler: (request: Request) => Promise<Response>;
+    api: {
+        getSession: (ctx: {
+            headers: Headers;
+        }) => Promise<{
+            user: Record<string, unknown>;
+        } | null>;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+};
+
+type CalendarAuthValidator = (request: NextRequest) => Promise<{
+    id: number;
+} | null>;
+/**
+ * 注入 calendar API 路由使用的 session 校验（应用启动时调用一次）
+ */
+declare function configureCalendarApiAuth(validateAuth: CalendarAuthValidator): void;
+/** 重置（测试用） */
+declare function resetCalendarApiAuth(): void;
+/**
+ * 使用 Better Auth session 一键配置 calendar API
+ */
+declare function configureCalendarApiWithBetterAuth(auth: Sa2kitAuthInstance, options?: {
+    db?: unknown;
+}): void;
+
+/**
+ * 创建 calendar 路由所需的 validateAuth（由 Better Auth session 注入）
+ *
+ * @example
+ * ```ts
+ * configureCalendarApiWithBetterAuth(auth, { db });
+ * const routeConfig = createDefaultCalendarRouteConfig();
+ * export const GET = createGetEventsHandler(routeConfig);
+ * ```
+ */
+declare function createCalendarAuthRequirement(validateAuth: CalendarAuthValidator): CalendarAuthValidator;
+declare function createDefaultCalendarRouteConfig(validateAuth?: CalendarAuthValidator): CalendarRouteConfig;
+declare function withCalendarDbGuard<T extends unknown[]>(handler: (...args: T) => Promise<Response>): (...args: T) => Promise<Response>;
+
+declare function createCalendarEventsRouteHandlers(config?: CalendarRouteConfig): {
+    GET: (request: NextRequest) => Promise<Response>;
+    POST: (request: NextRequest) => Promise<Response>;
+};
+declare function createCalendarEventByIdRouteHandlers(config?: CalendarRouteConfig): {
+    GET: (request: NextRequest, routeParams: {
+        params: {
+            id: string;
+        };
+    }) => Promise<Response>;
+    PUT: (request: NextRequest, routeParams: {
+        params: {
+            id: string;
+        };
+    }) => Promise<Response>;
+    DELETE: (request: NextRequest, routeParams: {
+        params: {
+            id: string;
+        };
+    }) => Promise<Response>;
+};
+declare function createCalendarBatchDeleteRouteHandlers(config?: CalendarRouteConfig): {
+    DELETE: (request: NextRequest) => Promise<Response>;
+};
+declare function createCalendarConfigRouteHandlers(config?: CalendarRouteConfig): {
+    GET: (request: NextRequest) => Promise<Response>;
+    PUT: (request: NextRequest) => Promise<Response>;
+};
+
+interface CalendarRouteConfig {
+    /**
+     * Drizzle 数据库实例
+     * 如果提供，将自动初始化 calendarDbService
+     */
+    db?: any;
+    /**
+     * 验证用户身份的函数
+     * 应该返回用户信息或 null
+     */
+    validateAuth: (request: NextRequest) => Promise<{
+        id: number;
+    } | null>;
+}
+/**
+ * 创建获取日历事件列表的处理器
+ */
+declare function createGetEventsHandler(config: CalendarRouteConfig): (request: NextRequest) => Promise<NextResponse<{
+    success: boolean;
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    data: any;
+    message: string;
+}>>;
+/**
+ * 创建日历事件的处理器
+ */
+declare function createCreateEventHandler(config: CalendarRouteConfig): (request: NextRequest) => Promise<NextResponse<{
+    success: boolean;
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    data: any;
+    message: string;
+}>>;
+/**
+ * 创建获取单个事件的处理器
+ */
+declare function createGetEventByIdHandler(config: CalendarRouteConfig): (request: NextRequest, { params }: {
+    params: {
+        id: string;
+    };
+}) => Promise<NextResponse<{
+    success: boolean;
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    data: any;
+    message: string;
+}>>;
+/**
+ * 创建更新事件的处理器
+ */
+declare function createUpdateEventHandler(config: CalendarRouteConfig): (request: NextRequest, { params }: {
+    params: {
+        id: string;
+    };
+}) => Promise<NextResponse<{
+    success: boolean;
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    data: any;
+    message: string;
+}>>;
+/**
+ * 创建删除事件的处理器
+ */
+declare function createDeleteEventHandler(config: CalendarRouteConfig): (request: NextRequest, { params }: {
+    params: {
+        id: string;
+    };
+}) => Promise<NextResponse<{
+    success: boolean;
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    message: string;
+}>>;
+/**
+ * 创建批量删除事件的处理器
+ */
+declare function createBatchDeleteEventsHandler(config: CalendarRouteConfig): (request: NextRequest) => Promise<NextResponse<{
+    success: boolean;
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    data: {
+        deletedCount: number;
+    };
+    message: string;
+}>>;
+/**
+ * 创建配置处理器的工厂
+ */
+declare function createConfigHandler(config: CalendarRouteConfig): {
+    GET: (request: NextRequest) => Promise<NextResponse<{
+        success: boolean;
+        error: string;
+    }> | NextResponse<{
+        success: boolean;
+        data: any;
+        message: string;
+    }>>;
+    PUT: (request: NextRequest) => Promise<NextResponse<{
+        success: boolean;
+        error: string;
+    }> | NextResponse<{
+        success: boolean;
+        data: any;
+        message: string;
+    }>>;
+};
+
+export { type CalendarAuthValidator, type CalendarRouteConfig, configureCalendarApiAuth, configureCalendarApiWithBetterAuth, createBatchDeleteEventsHandler, createCalendarAuthRequirement, createCalendarBatchDeleteRouteHandlers, createCalendarConfigRouteHandlers, createCalendarEventByIdRouteHandlers, createCalendarEventsRouteHandlers, createConfigHandler, createCreateEventHandler, createDefaultCalendarRouteConfig, createDeleteEventHandler, createGetEventByIdHandler, createGetEventsHandler, createUpdateEventHandler, resetCalendarApiAuth, withCalendarDbGuard };