@pangza/schedule 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,3 @@
-# Temporary Holding Version
+# @pangza/schedule
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+定时任务

package/dist/ScheduleManager.d.ts

@@ -0,0 +1,36 @@
+export interface ScheduleJobEntity {
+    id: string;
+    title?: string;
+    cron: string;
+    beanName: string;
+    status?: number | null;
+}
+/** 业务侧注入：加载启用中的定时任务列表 */
+export type ScheduleJobLoader = () => ScheduleJobEntity[] | Promise<ScheduleJobEntity[]>;
+export interface ScheduleModuleOptions {
+    loadJobs?: ScheduleJobLoader;
+}
+export declare function configureSchedule(options?: ScheduleModuleOptions): void;
+/**
+ * Quartz 风格 Cron → node-cron：
+ * - 将 `?` 替换为 `*`
+ * - 6 段（含秒）原样交给 node-cron
+ */
+export declare function convertQuartzCron(cronExpr: string): string;
+export declare function validateCron(cronExpr: string): string;
+/**
+ * 定时任务调度管理（node-cron）。
+ * 任务列表由业务通过 loadJobs 注入，framework 不依赖 business Service。
+ */
+declare class ScheduleManagerImpl {
+    private readonly jobs;
+    scheduleJob(entity: ScheduleJobEntity): void;
+    unschedule(id: string): void;
+    runOnce(beanName: string): Promise<void>;
+    loadEnabled(): Promise<void>;
+}
+export declare const ScheduleManager: ScheduleManagerImpl;
+/** 启动后加载启用中的定时任务 */
+export declare function initScheduleJobs(options?: ScheduleModuleOptions): Promise<void>;
+export {};
+//# sourceMappingURL=ScheduleManager.d.ts.map

package/dist/ScheduleManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduleManager.d.ts","sourceRoot":"","sources":["../src/ScheduleManager.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,yBAAyB;AACzB,MAAM,MAAM,iBAAiB,GAAG,MAC5B,iBAAiB,EAAE,GACnB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAEjC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAID,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,qBAA0B,GAAG,IAAI,CAI3E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS1D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMrD;AAqBD;;;GAGG;AACH,cAAM,mBAAmB;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IAEzD,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAkC5C,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQtB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CA0BnC;AAED,eAAO,MAAM,eAAe,qBAA4B,CAAC;AAEzD,oBAAoB;AACpB,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/ScheduleManager.js

@@ -0,0 +1,135 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScheduleManager = void 0;
+exports.configureSchedule = configureSchedule;
+exports.convertQuartzCron = convertQuartzCron;
+exports.validateCron = validateCron;
+exports.initScheduleJobs = initScheduleJobs;
+const node_cron_1 = __importDefault(require("node-cron"));
+const Service_1 = require("@pangza/core/Service");
+const orm_1 = require("@pangza/orm");
+let jobLoader = null;
+function configureSchedule(options = {}) {
+    if (options.loadJobs) {
+        jobLoader = options.loadJobs;
+    }
+}
+/**
+ * Quartz 风格 Cron → node-cron：
+ * - 将 `?` 替换为 `*`
+ * - 6 段（含秒）原样交给 node-cron
+ */
+function convertQuartzCron(cronExpr) {
+    const raw = String(cronExpr ?? "").trim();
+    if (!raw)
+        throw new orm_1.OrmError("Cron 表达式不能为空");
+    const converted = raw.replace(/\?/g, "*");
+    const parts = converted.split(/\s+/).filter(Boolean);
+    if (parts.length !== 5 && parts.length !== 6) {
+        throw new orm_1.OrmError(`Cron 表达式不合法：${cronExpr}`);
+    }
+    return parts.join(" ");
+}
+function validateCron(cronExpr) {
+    const expr = convertQuartzCron(cronExpr);
+    if (!node_cron_1.default.validate(expr)) {
+        throw new orm_1.OrmError(`Cron 表达式不合法：${cronExpr}`);
+    }
+    return expr;
+}
+async function invokeBean(beanName) {
+    if (!beanName?.trim()) {
+        throw new orm_1.OrmError("执行类（Bean 名称）不能为空");
+    }
+    if (!Service_1.Container.has(beanName)) {
+        throw new orm_1.OrmError(`未找到 Bean：${beanName}`);
+    }
+    const bean = Service_1.Container.get(beanName);
+    if (typeof bean?.execute === "function") {
+        await bean.execute();
+        return;
+    }
+    if (typeof bean?.run === "function") {
+        await bean.run();
+        return;
+    }
+    throw new orm_1.OrmError(`Bean [${beanName}] 需实现 execute() 或 run()`);
+}
+/**
+ * 定时任务调度管理（node-cron）。
+ * 任务列表由业务通过 loadJobs 注入，framework 不依赖 business Service。
+ */
+class ScheduleManagerImpl {
+    constructor() {
+        this.jobs = new Map();
+    }
+    scheduleJob(entity) {
+        const id = String(entity.id);
+        this.unschedule(id);
+        if (entity.status == null || Number(entity.status) === 0) {
+            console.log(`[Schedule] 任务已停用，已从调度器移除 id=${id}`);
+            return;
+        }
+        const expr = validateCron(entity.cron);
+        const beanName = entity.beanName;
+        if (!Service_1.Container.has(beanName)) {
+            throw new orm_1.OrmError(`未找到 Bean：${beanName}`);
+        }
+        const task = node_cron_1.default.schedule(expr, () => {
+            void (async () => {
+                try {
+                    console.log(`[Schedule] 触发任务 id=${id}, title=${entity.title ?? ""}, bean=${beanName}`);
+                    await invokeBean(beanName);
+                }
+                catch (e) {
+                    console.error(`[Schedule] 任务执行失败 id=${id}:`, e instanceof Error ? e.message : e);
+                }
+            })();
+        });
+        this.jobs.set(id, task);
+        console.log(`[Schedule] 已注册任务 id=${id}, cron=${expr}`);
+    }
+    unschedule(id) {
+        const task = this.jobs.get(String(id));
+        if (task) {
+            task.stop();
+            this.jobs.delete(String(id));
+        }
+    }
+    async runOnce(beanName) {
+        await invokeBean(beanName);
+    }
+    async loadEnabled() {
+        if (!jobLoader) {
+            console.warn("[Schedule] 未配置 loadJobs，跳过初始化");
+            return;
+        }
+        try {
+            const list = await jobLoader();
+            for (const row of list) {
+                try {
+                    this.scheduleJob(row);
+                }
+                catch (e) {
+                    console.error(`[Schedule] 启动加载失败 id=${row.id}:`, e instanceof Error ? e.message : e);
+                }
+            }
+            console.log(`[Schedule] 初始化完成，已加载 ${list.length} 个启用任务`);
+        }
+        catch (e) {
+            console.warn("[Schedule] 初始化跳过：", e instanceof Error ? e.message : e);
+        }
+    }
+}
+exports.ScheduleManager = new ScheduleManagerImpl();
+/** 启动后加载启用中的定时任务 */
+async function initScheduleJobs(options = {}) {
+    if (options.loadJobs) {
+        configureSchedule(options);
+    }
+    await exports.ScheduleManager.loadEnabled();
+}
+//# sourceMappingURL=ScheduleManager.js.map

package/dist/ScheduleManager.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./ScheduleManager";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ScheduleManager"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC"}

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@pangza/schedule",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "定时任务",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "require": "./dist/*.js",
+      "default": "./dist/*.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
+  },
+  "dependencies": {
+    "@pangza/core": "^1.0.1",
+    "node-cron": "^4.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}