@pisell/core 0.0.2

package/lib/tasks/scheduledTasksExample.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 定时任务示例代码
+ * 本文件展示了如何使用定时任务功能
+ *
+ * 重要提示：
+ * - 定时任务必须添加到 'scheduledTasks' 模块才能生效
+ * - 在其他模块中，scheduled 配置会被忽略，任务将作为普通任务立即执行
+ * - 这是为了性能优化，避免在所有模块中检查定时任务配置
+ */
+import { TasksManager } from './index';
+/**
+ * 示例1：创建一次性定时任务
+ * 在特定时间点执行一次
+ *
+ * 注意：定时任务必须添加到 'scheduledTasks' 模块才能生效
+ */
+export declare function createOnceScheduledTask(tasksManager: TasksManager): void;
+/**
+ * 示例2：创建每日重复的定时任务
+ * 每天在固定时间执行
+ */
+export declare function createDailyScheduledTask(tasksManager: TasksManager): void;
+/**
+ * 示例3：创建带结束时间的重复任务
+ * 在特定时间段内重复执行
+ */
+export declare function createLimitedRepeatTask(tasksManager: TasksManager): void;
+/**
+ * 示例4：创建多个时间点的任务
+ * 在一天中的多个时间点分别执行
+ */
+export declare function createMultiTimeTask(tasksManager: TasksManager): void;
+/**
+ * 示例5：创建每周重复任务
+ * 每周一早上9点执行周报
+ */
+export declare function createWeeklyTask(tasksManager: TasksManager): void;
+/**
+ * 示例6：创建每月重复任务
+ * 每月1号生成月报
+ */
+export declare function createMonthlyTask(tasksManager: TasksManager): void;
+/**
+ * 示例7：查询和管理定时任务
+ */
+export declare function manageScheduledTasks(tasksManager: TasksManager): void;
+/**
+ * 完整使用示例
+ */
+export declare function fullExample(app: any): void;
+declare const _default: {
+    createOnceScheduledTask: typeof createOnceScheduledTask;
+    createDailyScheduledTask: typeof createDailyScheduledTask;
+    createLimitedRepeatTask: typeof createLimitedRepeatTask;
+    createMultiTimeTask: typeof createMultiTimeTask;
+    createWeeklyTask: typeof createWeeklyTask;
+    createMonthlyTask: typeof createMonthlyTask;
+    manageScheduledTasks: typeof manageScheduledTasks;
+    fullExample: typeof fullExample;
+};
+export default _default;

package/lib/tasks/scheduledTasksExample.js

@@ -0,0 +1,267 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/tasks/scheduledTasksExample.ts
+var scheduledTasksExample_exports = {};
+__export(scheduledTasksExample_exports, {
+  createDailyScheduledTask: () => createDailyScheduledTask,
+  createLimitedRepeatTask: () => createLimitedRepeatTask,
+  createMonthlyTask: () => createMonthlyTask,
+  createMultiTimeTask: () => createMultiTimeTask,
+  createOnceScheduledTask: () => createOnceScheduledTask,
+  createWeeklyTask: () => createWeeklyTask,
+  default: () => scheduledTasksExample_default,
+  fullExample: () => fullExample,
+  manageScheduledTasks: () => manageScheduledTasks
+});
+module.exports = __toCommonJS(scheduledTasksExample_exports);
+var import_index = require("./index");
+var import_dayjs = __toESM(require("dayjs"));
+function createOnceScheduledTask(tasksManager) {
+  const executeTime = (0, import_dayjs.default)().add(5, "minute").format("YYYY-MM-DD HH:mm:ss");
+  tasksManager.addTask({
+    module: "scheduledTasks",
+    // 定时任务必须使用 scheduledTasks 模块
+    queueId: "reminder",
+    tasks: [{
+      action: "sendNotification",
+      payload: {
+        message: "这是一个定时提醒",
+        priority: "high"
+      },
+      scheduled: {
+        executeAt: executeTime
+      },
+      maxRetries: 3
+    }]
+  });
+  console.log(`定时任务已创建，将在 ${executeTime} 执行`);
+  tasksManager.run({
+    module: "scheduledTasks",
+    queueId: "reminder",
+    callback: () => {
+      console.log("定时任务执行完成");
+    }
+  });
+}
+function createDailyScheduledTask(tasksManager) {
+  const startTime = (0, import_dayjs.default)().add(1, "day").hour(9).minute(0).second(0).format("YYYY-MM-DD HH:mm:ss");
+  tasksManager.addTask({
+    module: "scheduledTasks",
+    queueId: "daily-report",
+    tasks: [{
+      action: "generateDailyReport",
+      payload: {
+        type: "sales",
+        recipients: ["manager@company.com"]
+      },
+      scheduled: {
+        executeAt: startTime,
+        repeat: true,
+        repeatType: "daily",
+        repeatInterval: 1
+      },
+      maxRetries: 3,
+      destroy: false
+      // 持久化任务，不会在应用卸载时清除
+    }]
+  });
+  console.log(`每日定时任务已创建，首次执行时间: ${startTime}`);
+  tasksManager.run({
+    module: "scheduledTasks",
+    queueId: "daily-report"
+  });
+}
+function createLimitedRepeatTask(tasksManager) {
+  const startTime = (0, import_dayjs.default)().add(1, "hour").format("YYYY-MM-DD HH:mm:ss");
+  const endTime = (0, import_dayjs.default)().add(7, "day").format("YYYY-MM-DD HH:mm:ss");
+  tasksManager.addTask({
+    module: "scheduledTasks",
+    queueId: "campaign",
+    tasks: [{
+      action: "sendPromotionMessage",
+      payload: {
+        campaign: "双十一预热",
+        discount: "8折优惠"
+      },
+      scheduled: {
+        executeAt: startTime,
+        repeat: true,
+        repeatType: "daily",
+        repeatInterval: 1,
+        endAt: endTime
+        // 7天后结束
+      },
+      maxRetries: 2
+    }]
+  });
+  console.log(`限时促销任务已创建`);
+  console.log(`执行时间: ${startTime} 至 ${endTime}`);
+  tasksManager.run({
+    module: "scheduledTasks",
+    queueId: "campaign"
+  });
+}
+function createMultiTimeTask(tasksManager) {
+  const today = (0, import_dayjs.default)().format("YYYY-MM-DD");
+  tasksManager.addTask({
+    module: "scheduledTasks",
+    queueId: "medication",
+    tasks: [{
+      action: "sendMedicationReminder",
+      payload: {
+        medicine: "阿莫西林",
+        dosage: "1片"
+      },
+      scheduled: {
+        executeAt: [
+          `${today} 08:00:00`,
+          // 早上8点
+          `${today} 12:00:00`,
+          // 中午12点
+          `${today} 18:00:00`
+          // 下午6点
+        ]
+      },
+      maxRetries: 3
+    }]
+  });
+  console.log(`多时间点任务已创建，今天将在 8:00, 12:00, 18:00 执行`);
+  tasksManager.run({
+    module: "scheduledTasks",
+    queueId: "medication"
+  });
+}
+function createWeeklyTask(tasksManager) {
+  let nextMonday = (0, import_dayjs.default)();
+  while (nextMonday.day() !== 1) {
+    nextMonday = nextMonday.add(1, "day");
+  }
+  const startTime = nextMonday.hour(9).minute(0).second(0).format("YYYY-MM-DD HH:mm:ss");
+  tasksManager.addTask({
+    module: "scheduledTasks",
+    queueId: "weekly-report",
+    tasks: [{
+      action: "generateWeeklyReport",
+      payload: {
+        type: "team-summary",
+        recipients: ["team@company.com"]
+      },
+      scheduled: {
+        executeAt: startTime,
+        repeat: true,
+        repeatType: "weekly",
+        repeatInterval: 1
+        // 每周执行一次
+      },
+      maxRetries: 3,
+      destroy: false
+    }]
+  });
+  console.log(`周报任务已创建，下次执行时间: ${startTime}`);
+  tasksManager.run({
+    module: "scheduledTasks",
+    queueId: "weekly-report"
+  });
+}
+function createMonthlyTask(tasksManager) {
+  const nextMonth = (0, import_dayjs.default)().add(1, "month").date(1).hour(9).minute(0).second(0);
+  const startTime = nextMonth.format("YYYY-MM-DD HH:mm:ss");
+  tasksManager.addTask({
+    module: "scheduledTasks",
+    queueId: "monthly-billing",
+    tasks: [{
+      action: "generateMonthlyInvoice",
+      payload: {
+        type: "subscription",
+        autoSend: true
+      },
+      scheduled: {
+        executeAt: startTime,
+        repeat: true,
+        repeatType: "monthly",
+        repeatInterval: 1
+        // 每月执行一次
+      },
+      maxRetries: 3,
+      destroy: false
+    }]
+  });
+  console.log(`月度账单任务已创建，下次执行时间: ${startTime}`);
+  tasksManager.run({
+    module: "scheduledTasks",
+    queueId: "monthly-billing"
+  });
+}
+function manageScheduledTasks(tasksManager) {
+  const allTasks = tasksManager.getTasks();
+  console.log("当前所有任务:", allTasks);
+}
+function fullExample(app) {
+  const tasksManager = import_index.TasksManager.getInstance(app);
+  tasksManager.addTaskFunction("sendNotification", async ({ task }) => {
+    const { message, priority } = task.payload;
+    console.log(`[${priority}] 发送通知: ${message}`);
+    return { status: "success" };
+  });
+  tasksManager.addTaskFunction("generateDailyReport", async ({ task }) => {
+    const { type, recipients } = task.payload;
+    console.log(`生成 ${type} 日报，发送给:`, recipients);
+    return { status: "success" };
+  });
+  tasksManager.addTaskFunction("sendPromotionMessage", async ({ task }) => {
+    const { campaign, discount } = task.payload;
+    console.log(`发送促销消息: ${campaign} - ${discount}`);
+    return { status: "success" };
+  });
+  createOnceScheduledTask(tasksManager);
+  tasksManager.watchTask((taskModule) => {
+    console.log("任务状态更新:", taskModule);
+  });
+}
+var scheduledTasksExample_default = {
+  createOnceScheduledTask,
+  createDailyScheduledTask,
+  createLimitedRepeatTask,
+  createMultiTimeTask,
+  createWeeklyTask,
+  createMonthlyTask,
+  manageScheduledTasks,
+  fullExample
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createDailyScheduledTask,
+  createLimitedRepeatTask,
+  createMonthlyTask,
+  createMultiTimeTask,
+  createOnceScheduledTask,
+  createWeeklyTask,
+  fullExample,
+  manageScheduledTasks
+});

package/lib/tasks/type.d.ts

@@ -0,0 +1,100 @@
+export declare type TaskRunStatus = "pending" | "in-progress" | "success" | "failure";
+export interface Task {
+    id?: string;
+    type?: "local" | "cloud";
+    retries?: number;
+    maxRetries?: number;
+    status?: TaskRunStatus;
+    action: string;
+    payload: any;
+    beforeAction?: string;
+    beforePayload?: any;
+    afterAction?: string;
+    afterPayload?: any;
+    polling?: {
+        interval?: number;
+    };
+    pollingResult?: {
+        count: number;
+        timerId?: any;
+    };
+    scheduled?: {
+        executeAt: string | string[];
+        repeat?: boolean;
+        repeatType?: 'daily' | 'weekly' | 'monthly' | 'yearly';
+        repeatInterval?: number;
+        endAt?: string;
+    };
+    scheduledResult?: {
+        count: number;
+        timerId?: any;
+        nextExecuteTime?: string;
+    };
+    manual?: boolean;
+    destroy?: boolean;
+    [key: string]: any;
+}
+export interface TaskConfig {
+    tasks: Task[];
+}
+declare type TaskModuleName = string;
+declare type TaskQueueName = string;
+declare type TaskStatus = "uncompleted" | "completed";
+export interface TaskQueue {
+    status: TaskStatus;
+    tasks: Task[];
+    isRunning?: boolean;
+    progress?: {
+        total: number;
+        completed: number;
+        failed: number;
+        inProgress: number;
+    };
+    lastRunAt?: string;
+}
+export interface RunTaskParams {
+    module: TaskModuleName;
+    queueId: TaskQueueName;
+    callback?: () => void;
+}
+export interface DeleteTaskParams {
+    module: TaskModuleName;
+    queueId: TaskQueueName;
+    taskId: string;
+}
+export interface AddTaskParams {
+    module: TaskModuleName;
+    queueId: TaskQueueName;
+    tasks: Task[];
+}
+export interface AddTaskDataParams {
+    module: TaskModuleName;
+    queueId: TaskQueueName;
+    [key: string]: any;
+}
+export interface TaskRunResult {
+    status: TaskRunStatus;
+    [key: string]: any;
+}
+/**
+ * 任务模块
+ * 注意：'scheduledTasks' 是保留的模块名，专门用于定时任务
+ * 在其他模块中，scheduled 配置会被忽略，任务将作为普通任务执行
+ */
+export interface TasksModule {
+    [key: TaskModuleName]: {
+        [key: TaskQueueName]: {
+            status: TaskStatus;
+            tasks: Task[];
+            isRunning?: boolean;
+            progress?: {
+                total: number;
+                completed: number;
+                failed: number;
+                inProgress: number;
+            };
+            lastRunAt?: string;
+        };
+    };
+}
+export {};

package/lib/tasks/type.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/tasks/type.ts
+var type_exports = {};
+module.exports = __toCommonJS(type_exports);

package/lib/tasks/useTasks.d.ts

@@ -0,0 +1,5 @@
+import { TasksModule } from './type';
+declare const useTasks: () => {
+    tasks: TasksModule;
+};
+export default useTasks;

package/lib/tasks/useTasks.js

@@ -0,0 +1,37 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/tasks/useTasks.tsx
+var useTasks_exports = {};
+__export(useTasks_exports, {
+  default: () => useTasks_default
+});
+module.exports = __toCommonJS(useTasks_exports);
+var import_app = require("../app");
+var import_react = require("react");
+var useTasks = () => {
+  const { app } = (0, import_app.useApp)();
+  const [tasks, setTasks] = (0, import_react.useState)({});
+  (0, import_react.useEffect)(() => {
+    app.tasksManager.watchTask((taskModule) => {
+      setTasks(taskModule);
+    });
+  }, []);
+  return { tasks };
+};
+var useTasks_default = useTasks;

package/lib/type.d.ts

@@ -0,0 +1,2 @@
+export interface CoreConfig {
+}

package/lib/type.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/type.ts
+var type_exports = {};
+module.exports = __toCommonJS(type_exports);

package/lib/utils/adaptiveThrottle/index.d.ts

@@ -0,0 +1,36 @@
+export declare type ThrottleLevel = number;
+export interface ThrottleExecuteContext {
+    /** 事务唯一 key */
+    key: string;
+    /** 当前节流窗口内的触发次数 */
+    count: number;
+    /** 是否首次立即执行 */
+    isFirst: boolean;
+    /** 当前节流等级 */
+    level: ThrottleLevel;
+    /** 上一次执行时间 */
+    lastExecuteTime: number;
+}
+export declare type ThrottleHandler = (ctx: ThrottleExecuteContext) => void | Promise<void>;
+export declare const DEFAULT_THROTTLE_INTERVALS: number[];
+export declare class AdaptiveThrottle {
+    private store;
+    private intervals;
+    constructor(intervals?: number[]);
+    /**
+     * 触发事务
+     */
+    trigger(key: string, handler: ThrottleHandler): void;
+    /**
+     * 调度下一次节流执行
+     */
+    private schedule;
+    /**
+     * 主动清理某个事务
+     */
+    clear(key: string): void;
+    /**
+     * 清空所有事务
+     */
+    clearAll(): void;
+}

package/lib/utils/adaptiveThrottle/index.js

@@ -0,0 +1,121 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/adaptiveThrottle/index.ts
+var adaptiveThrottle_exports = {};
+__export(adaptiveThrottle_exports, {
+  AdaptiveThrottle: () => AdaptiveThrottle,
+  DEFAULT_THROTTLE_INTERVALS: () => DEFAULT_THROTTLE_INTERVALS
+});
+module.exports = __toCommonJS(adaptiveThrottle_exports);
+var DEFAULT_THROTTLE_INTERVALS = [
+  5 * 60 * 1e3,
+  // 5分钟
+  30 * 60 * 1e3,
+  // 30分钟
+  60 * 60 * 1e3,
+  // 1小时
+  6 * 60 * 60 * 1e3,
+  // 6小时
+  24 * 60 * 60 * 1e3
+  // 1天
+];
+var AdaptiveThrottle = class {
+  store = /* @__PURE__ */ new Map();
+  intervals;
+  constructor(intervals = DEFAULT_THROTTLE_INTERVALS) {
+    this.intervals = intervals;
+  }
+  /**
+   * 触发事务
+   */
+  trigger(key, handler) {
+    const now = Date.now();
+    let record = this.store.get(key);
+    if (!record) {
+      handler({
+        key,
+        count: 1,
+        isFirst: true,
+        level: 0,
+        lastExecuteTime: now
+      });
+      record = {
+        key,
+        count: 0,
+        level: 0,
+        lastExecuteTime: now
+      };
+      this.store.set(key, record);
+      this.schedule(key, handler, record);
+      return;
+    }
+    record.count++;
+  }
+  /**
+   * 调度下一次节流执行
+   */
+  schedule(key, handler, record) {
+    const interval = this.intervals[record.level];
+    record.timer = setTimeout(async () => {
+      const count = record.count;
+      if (count > 0) {
+        await handler({
+          key,
+          count,
+          isFirst: false,
+          level: record.level,
+          lastExecuteTime: record.lastExecuteTime
+        });
+      }
+      if (count > 0 && record.level < this.intervals.length - 1) {
+        record.level++;
+      }
+      record.count = 0;
+      record.lastExecuteTime = Date.now();
+      this.schedule(key, handler, record);
+    }, interval);
+  }
+  /**
+   * 主动清理某个事务
+   */
+  clear(key) {
+    const record = this.store.get(key);
+    if (!record) return;
+    if (record.timer) {
+      clearTimeout(record.timer);
+    }
+    this.store.delete(key);
+  }
+  /**
+   * 清空所有事务
+   */
+  clearAll() {
+    this.store.forEach((record) => {
+      if (record.timer) {
+        clearTimeout(record.timer);
+      }
+    });
+    this.store.clear();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AdaptiveThrottle,
+  DEFAULT_THROTTLE_INTERVALS
+});

package/lib/variables/VariablesProvider.d.ts

@@ -0,0 +1,7 @@
+import React from "react";
+export declare const useVariablesContext: () => any;
+interface VariablesProviderProps {
+    children: React.ReactNode;
+}
+export declare const VariablesProvider: React.FC<VariablesProviderProps>;
+export {};