krontab 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["existsSync","env","delimiter","join","resolve","fs","path","CronExpressionParser","extname","relative","stat","path","readFile","open","path","mkdirSync","statSync","realpathSync","resolve","createHash","net","fs","path","spawn","env","path","performance","__create","__defProp","__getOwnPropDesc","__getOwnPropNames","__getProtoOf","__hasOwnProp","__copyProps","to","from","except","desc","keys","i","n","key","k","__toESM","mod","isNodeMode","target","node_perf_hooks","node_path","node_fs","node_process","cron_parser","node_fs_promises","node_child_process","node_crypto","node_net","Marker","_Marker","isPath","cmd","detectCommand","dir","detectRuntime","tsCmd","jsLike","interpreters","getDefaultInterpreter","runtime","ext","createLogger","write","args","defaultWrite","formatter","tag","DEFAULTS","createFormatter","timezone","createContext","rawConfig","logDir","jobcwd","include","exclude","pattern","absDir","absLogDir","timeFormat","defaultJobcwd","jobcwdFn","writer","tryGlobSync","cx","v","e","nextMinuteBoundary","next","runTask","fn","schedule","now","nextMinute","noSecondDate","ret","parseExp","exp","filepath","matches","expression","d","jstsAllow","line","allows","getAllowFn","parse","text","getShebang","extractCron","trimmedLine","inBlock","relativePath","index","utcIndex","expStart","tokens","sixExpStr","cron","getJobItem","content","allowFn","lines","shebang","firstNotAllowedIndex","list","inCronBlock","group","extracted","MAX_HEADER","readHeader","allowLine","s","fh","buf","bytesRead","loadFiles","filepaths","result","promises","error","r","getMatchedJob","item","count","set","job","getJobs","files","jobs","f","jobItem","orTsx","orPython","ensureDir","checkDirPermissions","name","mode","uid","writableByOthers","lockKeyOf","acquireLock","resolve","reject","LOCK_NAME","server","initialize","run","interpreter","output","closeOutput","logfile","child","code","signal","invocation","nextRunText","prefix","parsed","config","task","performanceNow"],"sources":["../src/consts.ts","../src/context/interpreter.ts","../src/context/logger.ts","../src/context/index.ts","../src/utils.ts","../src/cron/task.ts","../src/cron/parse.ts","../src/syntax/allow.ts","../src/syntax/shebang.ts","../src/syntax/extract.ts","../src/syntax/header.ts","../src/syntax/job.ts","../src/initialize.ts","../src/run.ts","../src/list.ts","../src/index.ts"],"sourcesContent":["export const enum Tag {\n Info = '[INFO]',\n Spawn = '[SPAWN]',\n Error = '[ERROR]',\n Warn = '[WARN]',\n Exit = '[EXIT]',\n Debug = '[DEBUG]',\n}\n\n/**\n * runner 自己建的目录统一按 0755 创建。\n * - 不能沿用 umask:Debian/Ubuntu 的 USERGROUPS_ENAB 默认 umask 002,mkdir 会建出 775,\n * 紧接着被 checkDirPermissions 拒绝,第一次部署就起不来(F44)\n * - 0755 本身不带 group/other 写位,任何 umask 下都只会更收紧,不会更宽松\n */\nexport const DIR_MODE = 0o755;\n\nexport const enum CronjobState {\n Running,\n Paused,\n Stopped,\n}\n\nexport namespace Marker {\n export const CRON = '@cron' as const;\n export const REGEX = /@cron\\b/;\n\n export const BEGIN = '@cronbegin' as const;\n export const BEGIN_REGEX = /@cronbegin\\b/;\n export const END = '@cronend' as const;\n export const END_REGEX = /@cronend\\b/;\n\n /** 行内标记:`@cronutc <5 段>`,只让这一条按 UTC 解析 */\n export const UTC = '@cronutc' as const;\n export const UTC_REGEX = /@cronutc\\b/;\n}\n\nexport type CronBlockMaker = typeof Marker.BEGIN | typeof Marker.END;\n","import type { Interpreter } from '../types/global.js';\nimport { existsSync } from 'node:fs';\nimport { delimiter, join } from 'node:path';\nimport { env } from 'node:process';\n\nconst isPath = (cmd: string) => cmd.includes('/') || cmd.includes('\\\\');\n\n/**\n * 检测系统中可用的运行时命令。\n * - 只查 PATH、不执行命令:`tsx --version` 实测约 740ms,而探测在 cronjob() 的启动路径上,\n * 每个 cx 都要付一次太贵。代价是\"存在但跑不起来\"的命令会被当成可用,启动时不会发现。\n * - 含路径分隔符的命令直接看文件是否存在,不查 PATH\n * - PATH 为空时(某些 pm2 配置)回退到常见系统目录\n * @returns 可用的命令名,都不可用则返回 null\n */\nexport function detectCommand(cmd: string): string | null {\n if (isPath(cmd)) {\n return existsSync(cmd) ? cmd : null;\n }\n for (const dir of (env.PATH || '/usr/local/bin:/usr/bin:/bin').split(delimiter)) {\n if (dir && existsSync(join(dir, cmd))) {\n return cmd;\n }\n }\n return null;\n}\n\n/** 标记\"没有可用解释器\"的占位命令,run() 见到它只记 WARN 不 spawn */\nexport const CMD_NONE = 'none';\n\n/**\n * 探测所有运行时,返回解释器映射表。\n */\nexport function detectRuntime() {\n const tsCmd = detectCommand('tsx') ?? detectCommand('ts-node') ?? process.execPath;\n const jsLike = (cmd: string): Interpreter => ({ cmd, args: [] });\n\n const interpreters: Record<string, Interpreter> = {\n '.ts': jsLike(tsCmd),\n '.mts': jsLike(tsCmd),\n '.cts': jsLike(tsCmd),\n '.js': jsLike(process.execPath),\n '.mjs': jsLike(process.execPath),\n '.cjs': jsLike(process.execPath),\n '.py': {\n cmd: detectCommand('python3') || detectCommand('python') || CMD_NONE,\n args: [],\n },\n '.sh': {\n cmd: detectCommand('bash') || 'sh',\n args: [],\n },\n none: {\n cmd: CMD_NONE,\n args: [],\n },\n };\n\n return {\n interpreters,\n hasTsx: tsCmd !== process.execPath,\n pythonCmd: interpreters['.py'].cmd,\n };\n}\n\nexport type Runtime = ReturnType<typeof detectRuntime>;\n\n/** 取扩展名对应的解释器;没有映射的(或映射成 none)交给 run() 记 WARN */\nexport function getDefaultInterpreter(runtime: Runtime, ext: string): Interpreter {\n return runtime.interpreters[ext] || runtime.interpreters.none;\n}\n","import type { CronjobLogger } from '../types/global.js';\nimport type { UserCronjobConfig } from '../types/config.js';\nimport { Tag } from '../consts.js';\n\n/**\n * 把 cx.write 包装成带 tag 的方法。\n * - write 是唯一的输出出口,消费者可以整条替换(默认写 stdout)\n */\nexport function createLogger(write: UserCronjobConfig['write']): CronjobLogger {\n return {\n info: (...args: any[]) => write(Tag.Info, ...args),\n err: (...args: any[]) => write(Tag.Error, ...args),\n warn: (...args: any[]) => write(Tag.Warn, ...args),\n spawn: (...args: any[]) => write(Tag.Spawn, ...args),\n exit: (...args: any[]) => write(Tag.Exit, ...args),\n debug: (...args: any[]) => write(Tag.Debug, ...args),\n };\n}\n\n/** 默认输出:`<dtm> <TAG> <内容>`,dtm 用 cx.timezone */\nexport function defaultWrite(formatter: Intl.DateTimeFormat): UserCronjobConfig['write'] {\n return (tag: Tag, ...args: any[]) => console.log(formatter.format(new Date()), tag, ...args);\n}\n","import type { CronjobContext, UserCronjobConfig } from '../types/config.js';\nimport type { Runtime } from './interpreter.js';\nimport { resolve } from 'node:path';\n\nimport { CronjobState } from '../consts.js';\nimport { detectRuntime } from './interpreter.js';\nimport { createLogger, defaultWrite } from './logger.js';\n\n/** 默认值:只改一处,测试与 createContext 都从这里断言 */\nexport const DEFAULTS = {\n include: ['**/*.{ts,js,sh}'],\n exclude: [\n '**/node_modules/',\n '**/.git/',\n '**/.vscode/',\n '**/.claude/',\n '**/__pycache__/',\n '**/dist/',\n '**/dist-tsc/',\n '**/coverage/',\n ],\n timezone: 'Asia/Shanghai',\n};\n\nconst createFormatter = (timezone: string) =>\n new Intl.DateTimeFormat('zh-CN', {\n year: 'numeric',\n month: '2-digit',\n day: '2-digit',\n hour: '2-digit',\n minute: '2-digit',\n second: '2-digit',\n fractionalSecondDigits: 3,\n hour12: false,\n timeZone: timezone,\n });\n\n/**\n * 创建上下文:配置校验 + 默认值 + 格式化器 + logger + 运行时映射,一次给齐。\n * - `runtime` 由调用方传入时直接用(便于测试注入);不传就现场探测一次\n * - 探测只查 PATH(见 interpreter.ts),不执行外部命令\n */\nexport function createContext(rawConfig?: Partial<UserCronjobConfig>, runtime: Runtime = detectRuntime()): CronjobContext {\n const {\n dir = process.cwd(),\n logDir = dir,\n jobcwd = dir,\n include = DEFAULTS.include,\n exclude = DEFAULTS.exclude,\n timezone = DEFAULTS.timezone,\n write,\n } = Object(rawConfig) as UserCronjobConfig;\n\n if (typeof dir !== 'string') {\n throw new TypeError('`dir` must be a string');\n }\n\n if (typeof logDir !== 'string') {\n throw new TypeError('`logDir` must be a string');\n }\n\n if (typeof jobcwd !== 'string' && typeof jobcwd !== 'function') {\n throw new TypeError('`jobcwd` must be a string or a function');\n }\n\n if (write !== undefined && typeof write !== 'function') {\n throw new TypeError('`write` must be a function');\n }\n\n // Validate timezone by attempting to create a DateTimeFormat with it\n new Intl.DateTimeFormat('en-US', { timeZone: timezone });\n\n if (!Array.isArray(include) || include.some((pattern) => typeof pattern !== 'string')) {\n throw new TypeError('`include` must be an array of strings');\n }\n if (!Array.isArray(exclude) || exclude.some((pattern) => typeof pattern !== 'string')) {\n throw new TypeError('`exclude` must be an array of strings');\n }\n\n // 统一成绝对路径:单例锁的 key、日志相对路径、glob 的 cwd 都依赖它。\n // 否则 './g'、'/abs/g'、'/abs/g/' 会被当成三个不同的任务目录。\n const absDir = resolve(dir);\n const absLogDir = resolve(logDir);\n\n const timeFormat = createFormatter(timezone);\n\n // jobcwd 是字符串时包装成函数;显式传入的(含默认的 dir)不额外改动\n const defaultJobcwd = typeof jobcwd !== 'function' && jobcwd === dir ? absDir : jobcwd;\n const jobcwdFn = typeof defaultJobcwd === 'function' ? defaultJobcwd : () => defaultJobcwd;\n\n const writer = write === undefined ? defaultWrite(timeFormat) : write;\n\n return {\n dir: absDir,\n logDir: absLogDir,\n jobcwd: jobcwdFn,\n include,\n exclude,\n timezone,\n timeFormat,\n runtime,\n jobState: CronjobState.Running,\n jobTimer: null,\n write: writer,\n log: createLogger(writer),\n };\n}\n","import type { CronjobContext } from './types/config.js';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\n/**\n * 返回要处理的文件的绝对路径\n */\nexport const tryGlobSync = (cx: CronjobContext) => {\n try {\n return fs.globSync(cx.include, { cwd: cx.dir, exclude: cx.exclude }).map((v) => path.resolve(cx.dir, v));\n } catch (e) {\n cx.log.err(`Error while globbing scripts.`, e);\n return null;\n }\n};\n\n/**\n * 用来解决超时问题\n * - 不一定用得上\n */\nexport function nolater<T extends Promise<any>>(cx: CronjobContext, promise: T, ms: number = 2000): T {\n const timeout = new Promise<never>((_, reject) => {\n const id = setTimeout(() => {\n clearTimeout(id);\n reject(new Error(`Promise did not resolve within ${ms}ms`));\n }, ms);\n });\n return Promise.race([promise, timeout]) as T;\n}\n","import type { CronjobContext } from '../types/config.js';\nimport { CronjobState } from '../consts.js';\n\nexport interface TaskController {\n /** 停止调度:清掉还没触发的定时器,状态置为 Stopped */\n stop: () => void;\n /** 暂停:定时器继续走,但到点不执行 */\n pause: () => void;\n /** 恢复 */\n resume: () => void;\n}\n\n/** 下一分钟边界(本地毫秒截断到分钟) */\nconst nextMinuteBoundary = (from: Date) => {\n const next = new Date(from.getTime() + 60000);\n next.setSeconds(0, 0);\n return next;\n};\n\n/**\n * 每分钟执行一次 fn,返回控制对象\n * - 状态全部放在 cx.jobState / cx.jobTimer 里,本函数不持有模块级状态\n * - 每次调度都重新读 cx.jobState,因此 stop/resume 在任意时刻都生效\n */\nexport function runTask(cx: CronjobContext, fn: (now: Date) => void | Promise<void>): TaskController {\n const schedule = () => {\n // 只有 Stopped 才停链;Paused 也要继续排,否则进程会在下一个边界自行退出\n if (cx.jobState === CronjobState.Stopped) {\n return;\n }\n\n const now = new Date();\n const nextMinute = nextMinuteBoundary(now);\n\n cx.jobTimer = setTimeout(() => {\n // 定时器已经触发,句柄作废;stop 时靠它判断是否还有待触发的定时器\n cx.jobTimer = null;\n\n // 到点时状态可能已经变了(stop)\n if (cx.jobState === CronjobState.Stopped) {\n return;\n }\n\n // 暂停期间定时器照常走,只是不执行;否则事件循环会空掉,进程在下一个分钟边界自行退出\n if (cx.jobState === CronjobState.Paused) {\n schedule();\n return;\n }\n\n //! 定时器可能早于边界触发,相当于等了但还没等到呢,再等一会\n if (Date.now() < nextMinute.getTime()) {\n schedule();\n return;\n }\n\n const noSecondDate = new Date();\n noSecondDate.setSeconds(0, 0);\n\n // 先排下一轮:fn 抛错或异步 reject 都不能打断调度链(否则整条链就断了)\n schedule();\n\n try {\n const ret = fn(noSecondDate);\n // 只用一条 Error 记录,不重试、不告警,等下一分钟即可\n if (ret && typeof ret.catch === 'function') {\n ret.catch((e) => cx.log.err(`Task tick failed:`, e));\n }\n } catch (e) {\n cx.log.err(`Task tick failed:`, e);\n }\n }, nextMinute.getTime() - now.getTime());\n };\n\n schedule();\n\n return {\n stop() {\n if (cx.jobTimer) {\n clearTimeout(cx.jobTimer);\n cx.jobTimer = null;\n }\n cx.jobState = CronjobState.Stopped;\n },\n pause() {\n if (cx.jobState === CronjobState.Running) {\n cx.jobState = CronjobState.Paused;\n }\n },\n resume() {\n if (cx.jobState === CronjobState.Stopped) {\n return;\n }\n cx.jobState = CronjobState.Running;\n // 暂停期间定时器没有停,所以这里只需要恢复状态即可;\n // 但如果定时器已经被外部清掉(jobTimer === null),重新排一次\n if (cx.jobTimer === null) {\n schedule();\n }\n },\n };\n}\n","import { type CronExpression, CronExpressionParser } from 'cron-parser';\nimport type { CronjobContext } from '../types/config.js';\n\n/**\n * 非得要try很奇怪,但这是官方推荐的方式\n *\n * @param timezone cron 语义使用的时区;默认是 cx.timezone,`@cronutc` 之后传 'UTC'\n */\nexport const parseExp = (\n cx: CronjobContext,\n exp: string,\n filepath: string,\n timezone: string = cx.timezone,\n): CronExpression | null => {\n try {\n return CronExpressionParser.parse(exp, { tz: timezone, hashSeed: filepath });\n } catch {\n return null;\n }\n};\n\n/**\n * 判断给定日期是否匹配 cron 表达式\n * @param expression cron 表达式\n * @param d 待匹配的日期\n */\nexport function matches(expression: CronExpression, d: Date) {\n // & 已经在task里面完成了这一步:d.setSeconds(0, 0);\n return expression.includesDate(d);\n}\n","/**\n * ! 多行注释以`*`开头是实时标准和社区、行业规范\n */\nconst jstsAllow = (line) =>\n // 单行注释\n line.startsWith('//') ||\n // 多行注释\n line.startsWith('/*') ||\n // 多行注释的第二行\n line.startsWith('*') ||\n // 多行注释的最后一行\n line.startsWith('*/') ||\n // 什么都没有,也可能是多行注释\n line.length === 0;\n\nconst allows = {\n '.ts': jstsAllow,\n '.mts': jstsAllow,\n '.cts': jstsAllow,\n '.js': jstsAllow,\n '.mjs': jstsAllow,\n '.cjs': jstsAllow,\n '.py': (line: string) => /^(#|'''|\"\"\")/.test(line) || line.length === 0,\n '.sh': (line: string) => line.startsWith('#') || line.length === 0,\n};\n\nexport function getAllowFn(ext: string): (line: string) => boolean {\n return allows[ext] || (() => false);\n}\n","import type { Interpreter } from '../types/global.js';\n\nconst parse = (text: string): Interpreter | null => {\n const [cmd, ...args] = text.split(/\\s+/).filter(Boolean);\n return cmd ? { cmd, args } : null;\n};\n\n/**\n * 获取解释器,同时也可用于判定是否存在 shebang\n * - 如果有人只是在第一行写了\"#!\",后面没写任何东西,这里也会返回`null`\n */\nexport const getShebang = (line: string) => (line.startsWith('#!') ? parse(line.slice(2)) : null);\n","import type { CronExpression } from 'cron-parser';\nimport type { CronGroupItem, JobItem } from '../types/global.js';\nimport type { CronjobContext } from '../types/config.js';\n\nimport { extname, relative } from 'node:path';\nimport { type CronBlockMaker, Marker } from '../consts.js';\nimport { parseExp } from '../cron/parse.js';\nimport { getDefaultInterpreter } from '../context/interpreter.js';\nimport { getAllowFn } from './allow.js';\nimport { getShebang } from './shebang.js';\n\n/**\n * 一行解析出来的调度:表达式 + 它实际使用的时区。\n * 时区只在这里决定一次,调用方不要再对整行做第二次标记搜索(F45)。\n */\nexport interface ExtractedCron {\n cron: CronExpression;\n timezone: string;\n}\n\n/**\n * 从一行文本中提取带标记的 cron 表达式\n * - 只接受5位表达式,不支持秒级\n * - `@cronutc <5 段>` 是行内指令:这一条按 UTC 解析,不影响其它行\n *\n * @param trimmedLine 已经去掉前导空格的行文本\n * @param inBlock 是否在 @cronbegin 和 @cronend 块中\n * @param relativePath 相对路径,用于日志输出\n */\nexport function extractCron(\n cx: CronjobContext,\n trimmedLine: string,\n inBlock: boolean,\n relativePath: string,\n): ExtractedCron | CronBlockMaker | null {\n if (trimmedLine.search(Marker.BEGIN_REGEX) !== -1) {\n return Marker.BEGIN;\n }\n if (trimmedLine.search(Marker.END_REGEX) !== -1) {\n return Marker.END;\n }\n\n // @cron的index\n const index = trimmedLine.search(Marker.REGEX);\n // @cronutc的index\n const utcIndex = trimmedLine.search(Marker.UTC_REGEX);\n\n // 同一行两个标记无法判断该按哪个时区跑;宁可拒绝并记 Error,也不猜\n if (index !== -1 && utcIndex !== -1) {\n cx.log.err(`Line contains both ${Marker.CRON} and ${Marker.UTC}, nothing scheduled: ${relativePath}`);\n return null;\n }\n\n let timezone = cx.timezone;\n let expStart = -1;\n\n // 一般都是这个,所以这个排前面,分支预测更好\n if (index !== -1) {\n expStart = index + Marker.CRON.length;\n } else if (utcIndex !== -1) {\n timezone = 'UTC';\n expStart = utcIndex + Marker.UTC.length;\n }\n\n if (expStart === -1) {\n if (inBlock) {\n cx.log.warn(`@cron should be used to mark cron expressions in cron blocks: ${relativePath}`);\n }\n return null;\n }\n\n // 直接切片,从标记后面开始获取字符\n const tokens = trimmedLine.slice(expStart).split(/\\s+/).filter(Boolean);\n\n //! 阻止cron-parser 把 4 段自动补齐成另一条合法表达式\n if (tokens.length < 5) {\n cx.log.err(`Invalid cron expression: \"${tokens.join(' ')}\" in file: ${relativePath}`);\n return null;\n }\n\n // 前 6 段能解析说明写的是秒级定时,本项目只支持 5 段,整行不调度\n if (tokens.length >= 6) {\n const sixExpStr = tokens.slice(0, 6).join(' ');\n if (parseExp(cx, sixExpStr, relativePath, timezone)) {\n cx.log.err(`6 fields cron is not supported, use 5 fields instead. Found \"${sixExpStr}\" in file: ${relativePath}`);\n return null;\n }\n }\n\n // 取前 5 段,之后是说明文字\n const cron = parseExp(cx, tokens.slice(0, 5).join(' '), relativePath, timezone);\n return cron ? { cron, timezone } : null;\n}\n\n/**\n * 从文件内容提取带标记的 cron 表达式,并组合成`JobItem`,一次性提供\n * cron表达式对象、分组信息、文件路径以及解释器信息\n *\n * @param filepath 文件路径,用于日志输出\n * @param content 文件头内容(可以是整文件;第一行正式代码之后的不会用到)\n */\nexport function getJobItem(cx: CronjobContext, filepath: string, content: string): JobItem | null {\n const ext = extname(filepath);\n const allowFn = getAllowFn(ext);\n\n let lines = content.split('\\n').map((line) => line.trim());\n\n if (lines.length === 0) {\n return null;\n }\n\n const shebang = getShebang(lines[0]);\n\n if (shebang) {\n lines.shift();\n }\n\n if (lines.length === 0) {\n return null;\n }\n\n // 第一行放行shebang\n const firstNotAllowedIndex = lines.findIndex((v) => !allowFn(v));\n if (firstNotAllowedIndex !== -1) {\n // 切除到第一行正式代码为止,上面的都可以用来记录@cron\n lines = lines.slice(0, firstNotAllowedIndex);\n }\n\n if (lines.length === 0) {\n return null;\n }\n\n const list: CronGroupItem[] = [];\n // 主日志统一用相对路径(CLAUDE.md 约定)\n const relativePath = relative(cx.dir, filepath);\n\n let inCronBlock = false;\n let group = 0;\n for (const line of lines) {\n const extracted = extractCron(cx, line, inCronBlock, relativePath);\n // 忽略空的\n if (!extracted) {\n continue;\n }\n\n if (extracted === Marker.BEGIN) {\n // 已经在快中,再次碰到begin,则语法错误不予解析\n if (inCronBlock) {\n cx.log.err(`Nested ${Marker.BEGIN} found in file: ${relativePath}`);\n return null;\n }\n group++;\n inCronBlock = true;\n continue;\n }\n\n if (extracted === Marker.END) {\n // 并不在块中,却直接碰到end,语法错误不予解析\n if (!inCronBlock) {\n cx.log.err(`${Marker.END} didn't match ${Marker.BEGIN} in file: ${relativePath}`);\n return null;\n }\n inCronBlock = false;\n continue;\n }\n\n // 时区跟着解析结果走:@cron 与 @cronutc 同时出现时标记不匹配的错误已在 extractCron 里拦下\n list.push({ ...extracted, group: inCronBlock ? group : 0 });\n }\n\n // 语法错误不予解析\n if (inCronBlock) {\n cx.log.err(`Unclosed ${Marker.BEGIN}/${Marker.END} block in file: ${relativePath}`);\n return null;\n }\n\n const interpreter = shebang ?? getDefaultInterpreter(cx.runtime, ext);\n\n return { flatCronGroups: list, interpreter, filepath };\n}\n","import type { CronjobContext } from '../types/config.js';\n\nimport { open, readFile, stat } from 'node:fs/promises';\nimport path from 'node:path';\n\n/** 文件头最多读 64KB;比这小的文件由调用方直接整读 */\nexport const MAX_HEADER = 64 * 1024;\n\n/**\n * 只读大文件的前 MAX_HEADER 字节,一次定位读,不循环。\n * - 读出来的内容可能带上一行正式代码或半行,没关系:getJobItem 会在第一行正式代码处切掉\n * - 只有前 64KB 全是注释(说明文件头真的超长)才记 WARN,避免每个大文件每分钟刷一条\n */\nexport async function readHeader(\n cx: CronjobContext,\n filepath: string,\n allowLine: (line: string) => boolean,\n): Promise<string | null> {\n const s = await stat(filepath);\n if (!s.isFile()) {\n cx.log.warn(`Skipped non-regular file: ${path.relative(cx.dir, filepath)}`);\n return null;\n }\n if (s.size < MAX_HEADER) {\n return await readFile(filepath, 'utf8');\n }\n\n const fh = await open(filepath, 'r');\n try {\n const buf = Buffer.alloc(MAX_HEADER);\n const { bytesRead } = await fh.read(buf, 0, MAX_HEADER, 0);\n const text = buf.subarray(0, bytesRead).toString('utf8');\n if (bytesRead === MAX_HEADER && text.split('\\n').every((line) => allowLine(line.trim()))) {\n cx.log.warn(`Header longer than ${MAX_HEADER} bytes, truncated: ${path.relative(cx.dir, filepath)}`);\n }\n return text;\n } finally {\n await fh.close();\n }\n}\n","import type { Job, JobItem } from '../types/global.js';\nimport type { CronjobContext } from '../types/config.js';\n\nimport path from 'node:path';\n\nimport { getJobItem } from './extract.js';\nimport { matches } from '../cron/parse.js';\nimport { getAllowFn } from './allow.js';\nimport { readHeader } from './header.js';\n\nexport type FileContent =\n | {\n filepath: string;\n /** null = 已跳过(非普通文件),readHeader 已经记过 WARN,不算读取失败 */\n content: string | null;\n error: null;\n }\n | {\n filepath: string;\n content: null;\n error: any;\n };\n\nconst CHUNK_SIZE = 100;\n\n/**\n * stat 并读取文件头,一个文件对应一条结果,失败也包成结果、不抛出。\n * - 先 stat:FIFO、设备、目录等非普通文件直接跳过(对 FIFO 做 readFile 会永久阻塞线程池)\n * - 只读文件头:大文件不再整读进内存\n */\nexport async function loadFiles(cx: CronjobContext, filepaths: string[]): Promise<Array<FileContent>> {\n const result: Array<FileContent> = [];\n for (let i = 0; i < filepaths.length; i += CHUNK_SIZE) {\n const promises = filepaths.slice(i, i + CHUNK_SIZE).map(async (filepath): Promise<FileContent> => {\n try {\n const allower = getAllowFn(path.extname(filepath));\n const content = await readHeader(cx, filepath, allower);\n return { filepath, content, error: null };\n } catch (error) {\n return { filepath, content: null, error };\n }\n });\n const r = await Promise.all(promises);\n result.push(...r);\n }\n\n return result;\n}\n\n/**\n * 获取现在应该运行的job\n * - 不会有人写非常多的 cron 表达式,直接遍历即可\n *\n * ! 仅用于同一个filepath\n *\n * @param cx Cronjob 上下文\n * @param item JobItem 对象\n * @param now 当前时间,**秒数、毫秒数为0**\n */\nexport function getMatchedJob(cx: CronjobContext, item: JobItem, now: Date): Job {\n let count = 0;\n const set = new Set<number>();\n for (let i = 0; i < item.flatCronGroups.length; i++) {\n const job = item.flatCronGroups[i];\n if (job.group === 0 && matches(job.cron, now)) {\n count++;\n continue;\n }\n if (!set.has(job.group) && matches(job.cron, now)) {\n count++;\n set.add(job.group);\n }\n }\n return { filepath: item.filepath, interpreter: item.interpreter, count };\n}\n\n/**\n * 判断文件本轮是否该运行\n *\n * @param cx Cronjob 上下文\n * @param files 文件内容数组\n * @param now 当前时间,**秒数、毫秒数为0**\n * @returns 要跑的 cron,要跑多少次;\n */\nexport function getJobs(cx: CronjobContext, files: FileContent[], now: Date): Job[] {\n const jobs: Job[] = [];\n\n for (let i = 0; i < files.length; i++) {\n const f = files[i];\n if (f.error) {\n cx.log.err(`Error loading file ${path.relative(cx.dir, f.filepath)}: ${f.error}`);\n continue;\n }\n if (f.content === null) {\n // 非普通文件:readHeader 已经记过 WARN,这里不再刷 Error\n continue;\n }\n\n const jobItem = getJobItem(cx, f.filepath, f.content);\n if (!jobItem) {\n continue;\n }\n\n // 这里要把shebang算好,matchedjob要运行多少次直接看数字\n const job = getMatchedJob(cx, jobItem, now);\n if (job.count > 0) {\n jobs.push(job);\n }\n }\n\n return jobs;\n}\n","import type { CronjobContext } from './types/config.js';\nimport { createHash } from 'node:crypto';\nimport { mkdirSync, realpathSync, statSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport net from 'node:net';\n\nimport { CMD_NONE } from './context/interpreter.js';\nimport { DIR_MODE } from './consts.js';\n\n/** 持有引用,防止 unref 后的 server 被 GC,导致锁被提前释放 */\nlet _lock: net.Server | null = null;\n\n/**\n * 检查 tsx 是否可用;没有只警告,纯 js/sh 任务仍可运行\n */\nconst orTsx = (cx: CronjobContext) => {\n if (!cx.runtime.hasTsx) {\n cx.log.warn(`'tsx' not found, .ts files will be run by node directly. Not all nodejs versions supports this.`);\n }\n};\n\nconst orPython = (cx: CronjobContext) => {\n if (cx.runtime.pythonCmd !== CMD_NONE) {\n cx.log.info(`python available, .py files will be run by ${cx.runtime.pythonCmd}`);\n } else {\n cx.log.warn('python not available, .py jobs will be ignored');\n }\n};\n\nconst ensureDir = (cx: CronjobContext) => {\n mkdirSync(cx.dir, { recursive: true, mode: DIR_MODE });\n if (cx.dir !== cx.logDir) {\n mkdirSync(cx.logDir, { recursive: true, mode: DIR_MODE });\n }\n};\n\n/**\n * dir / logDir 必须只有 runner 用户能写。\n * - dir 可写 = 能以 runner 的身份执行任意代码;logDir 可写 = 能往任务日志里追加内容\n * - 属主不是当前用户、或 group/other 有写位,都直接报错(不是告警)\n * - root 除外:root 能写任何目录,这条检查对 root 没有意义\n */\nconst checkDirPermissions = (cx: CronjobContext) => {\n if (typeof process.getuid !== 'function' || process.getuid() === 0) {\n return;\n }\n for (const [name, dir] of [\n ['dir', cx.dir],\n ['logDir', cx.logDir],\n ] as const) {\n const { mode, uid } = statSync(dir);\n const writableByOthers = (mode & 0o022) !== 0;\n if (uid !== process.getuid() || writableByOthers) {\n throw new Error(\n `${name} must be owned by the current user and not group/world-writable: ${dir} ` +\n `(owner=${uid}, mode=${(mode & 0o777).toString(8)})`,\n );\n }\n }\n};\n\n/** 写日志时用:任务输出可能含密钥,不让同机其他用户读 */\nexport const LOG_FILE_MODE = 0o640;\n\n/**\n * 锁名用的目录标识:realpath 兜住符号链接(/a/link 与 /b/real 是同一个目录时也能识别),\n * 目录还不存在时退回 resolve 的结果(ensureDir 在拿锁之后才建目录)。\n */\nconst lockKeyOf = (dir: string) => {\n try {\n return realpathSync(dir);\n } catch {\n return resolve(dir);\n }\n};\n\n/**\n * 绑定成功则 resolve(进程活着就一直占着);\n * 已被占用则 reject —— 不 process.exit,由宿主决定怎么退。\n * @returns {Promise<void>}\n */\nconst acquireLock = (cx: CronjobContext) =>\n new Promise<void>((resolve, reject) => {\n /**\n * 锁名跟着任务目录走,同一台机器跑多个项目时不会互相误伤。\n * \\0 前缀 = 抽象 namespace,不落盘;进程退出(含 kill -9)由内核自动释放。\n * exclusive: true —— cluster 模式下 listen 默认交给 primary 代绑并共享句柄,\n * 每个 worker 都会\"成功\",锁就失效了;exclusive 让每个 worker 自己真绑,第二个拿到 EADDRINUSE。\n */\n const LOCK_NAME = '\\0krontab-' + createHash('sha1').update(lockKeyOf(cx.dir)).digest('hex').slice(0, 8);\n const server = net.createServer();\n server.once('error', (e: NodeJS.ErrnoException) => {\n reject(e.code === 'EADDRINUSE' ? new Error('krontab already running') : e);\n });\n server.listen({ path: LOCK_NAME, exclusive: true }, () => {\n server.unref(); // 不阻止进程退出\n _lock = server;\n resolve();\n });\n });\n\nexport const initialize = async (cx: CronjobContext) => {\n // 先拿锁:重复实例不必再做后面的探测\n await acquireLock(cx);\n ensureDir(cx);\n checkDirPermissions(cx);\n orTsx(cx);\n orPython(cx);\n};\n","import type { Job } from './types/global.js';\nimport type { CronjobContext } from './types/config.js';\n\nimport { spawn } from 'node:child_process';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { env } from 'node:process';\n\nimport { CMD_NONE } from './context/interpreter.js';\nimport { LOG_FILE_MODE } from './initialize.js';\n\nexport function run(cx: CronjobContext, { filepath, interpreter }: Job) {\n let output: number | null = null;\n const closeOutput = () => {\n if (output !== null) {\n fs.closeSync(output);\n output = null; // ! 防止反复close\n }\n };\n // 主日志统一用相对路径,绝对路径只用于 spawn\n const relativePath = path.relative(cx.dir, filepath);\n try {\n // 把相对于cron文件夹的路径也带入到日志路径中,这样符合直觉\n const logfile = path.join(cx.logDir, relativePath + '.log');\n\n // 子目录下的脚本,其日志子目录也要存在,否则 shell 重定向失败、命令不会执行\n fs.mkdirSync(path.dirname(logfile), { recursive: true });\n\n // 运行这个文件\n if (interpreter.cmd === CMD_NONE) {\n cx.log.warn(`path=${relativePath} unsupported extension`);\n return;\n }\n\n const cmd = interpreter.cmd;\n const args = interpreter.args.concat(filepath);\n\n output = fs.openSync(logfile, 'a', LOG_FILE_MODE);\n\n const child = spawn(cmd, args, {\n stdio: ['ignore', output, output],\n detached: true,\n env,\n // 子进程 cwd 默认和主程序一样,或者以--cwd=xxx录入\n cwd: cx.jobcwd(filepath),\n });\n\n child.on('error', (e) => {\n closeOutput();\n cx.log.err(`path=${relativePath} pid=${child.pid ?? '-1'}`, e);\n });\n child.on('spawn', () => {\n closeOutput();\n cx.log.spawn(`path=${relativePath} pid=${child.pid ?? '-1'}`);\n });\n child.on('exit', (code, signal) => {\n closeOutput();\n cx.log.exit(`path=${relativePath} pid=${child.pid ?? '-1'} code=${code} signal=${signal}`);\n });\n child.unref();\n } catch (e) {\n closeOutput();\n // spawn 之前的异常(mkdir/openSync/jobcwd 等)也要进主日志,否则无法定位\n cx.log.err(`path=${relativePath} pid=-1`, e);\n }\n}\n","import path from 'node:path';\n\nimport type { CronjobContext } from './types/config.js';\nimport { tryGlobSync } from './utils.js';\nimport { loadFiles } from './syntax/job.js';\nimport { getJobItem } from './syntax/extract.js';\nimport { parseExp } from './cron/parse.js';\n\n/**\n * 罗列所有定时表达式,效果类似 `crontab -l`\n *\n * 输出四列:下次运行时间、表达式、相对路径、解释器命令\n * - 块内的多条表达式会缩进显示,并标出 group\n * - 同一条表达式每次都重新 parse,避免 next() 改动共享对象的内部游标\n */\nexport async function list(cx: CronjobContext) {\n const filepaths = tryGlobSync(cx);\n if (!filepaths) {\n return;\n }\n if (filepaths.length === 0) {\n cx.log.info(`No scripts found in ${cx.dir}`);\n return;\n }\n\n const files = await loadFiles(cx, filepaths);\n\n for (const f of files) {\n const relativePath = path.relative(cx.dir, f.filepath);\n\n if (f.error) {\n cx.log.err(`Error loading file ${relativePath}: ${f.error}`);\n continue;\n }\n if (f.content === null) {\n // 非普通文件:readHeader 已经记过 WARN\n continue;\n }\n\n const item = getJobItem(cx, f.filepath, f.content);\n if (!item) {\n continue;\n }\n\n if (item.flatCronGroups.length === 0) {\n cx.log.warn(`No cron expression: ${relativePath}`);\n continue;\n }\n\n const invocation = [item.interpreter.cmd, ...item.interpreter.args, relativePath].join(' ');\n\n for (const { cron, group, timezone } of item.flatCronGroups) {\n const exp = cron.stringify();\n const next = nextRunText(cx, exp, f.filepath, timezone);\n const prefix = (group > 0 ? ` [${group}] ` : '') + (timezone === 'UTC' ? 'UTC ' : '');\n console.log(`${next.padEnd(24)} ${(prefix + exp).padEnd(18)} ${relativePath.padEnd(32)} ${invocation}`);\n }\n }\n}\n\n/** 表达式在上一次 parse 后可能因 impossible date 抛错,这里只展示、不中断整个列表 */\nfunction nextRunText(cx: CronjobContext, exp: string, filepath: string, timezone: string) {\n const parsed = parseExp(cx, exp, filepath, timezone);\n if (!parsed) {\n return '(invalid)';\n }\n try {\n return cx.timeFormat.format(parsed.next().toDate());\n } catch {\n return '(no next run)';\n }\n}\n","/**\n * # 全局定时任务主理,以每分钟读取来决定是否运行\n * # 1. 只支持:【分 时 日 月 周】 的写法\n * # 2. cron 表达式写在脚本的文件头注释区(第一条正式代码之前的注释),以注释给出\n */\nimport type { UserCronjobConfig } from './types/config.js';\nimport { performance } from 'node:perf_hooks';\n\nimport { createContext } from './context/index.js';\nimport { CronjobState } from './consts.js';\nimport { tryGlobSync } from './utils.js';\nimport { runTask, type TaskController } from './cron/task.js';\nimport { getJobs, loadFiles } from './syntax/job.js';\nimport { run } from './run.js';\nimport { initialize } from './initialize.js';\nimport { list } from './list.js';\n\nexport type { TaskController } from './cron/task.js';\nexport { UserCronjobConfig };\n\n/**\n * 启动定时任务主理,返回控制器\n * - 只支持 5 段 cron:分 时 日 月 周\n * - 同一 dir 只允许一个实例\n */\nexport async function cronjob(config?: Partial<UserCronjobConfig>): Promise<TaskController> {\n const cx = createContext(config);\n cx.log.info(`Config loaded: ${JSON.stringify(cx)}`);\n\n if (process.argv.includes('--list') || process.argv.includes('-l')) {\n // 列出所有任务看一下效果就退出\n await list(cx);\n process.exit(0);\n }\n\n await initialize(cx);\n\n const taskFn = async (now: Date) => {\n // 1、查找CRONJOB_DIR下面的所有符合suffix的文件\n const filepaths = tryGlobSync(cx);\n if (!filepaths) {\n return;\n }\n if (filepaths.length === 0) {\n cx.log.info(`No scripts found.`);\n return;\n }\n\n const performanceNow = performance.now();\n cx.log.debug(`Start`);\n\n const files = await loadFiles(cx, filepaths);\n const jobs = await getJobs(cx, files, now);\n\n // 读文件期间可能被 stop() / pause()(F33):已不在 Running 就不再 spawn 这一轮\n if (cx.jobState === CronjobState.Stopped) {\n return;\n }\n\n for (let i = 0; i < jobs.length; i++) {\n for (let n = 0; n < jobs[i].count; n++) {\n if (cx.jobState === CronjobState.Running) {\n run(cx, jobs[i]);\n }\n }\n }\n\n cx.log.debug(`Finished in ${(performance.now() - performanceNow).toFixed(6)}ms`);\n };\n\n const task = runTask(cx, taskFn);\n\n cx.log.info(`Cronjob start! pid=${process.pid}`);\n\n return task;\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.cjs","names":["existsSync","env","delimiter","join","resolve","fs","path","CronExpressionParser","extname","relative","stat","path","readFile","open","path","mkdirSync","statSync","realpathSync","resolve","createHash","net","fs","path","spawn","env","path","performance"],"sources":["../src/consts.ts","../src/context/interpreter.ts","../src/context/logger.ts","../src/context/index.ts","../src/utils.ts","../src/cron/task.ts","../src/cron/parse.ts","../src/syntax/allow.ts","../src/syntax/shebang.ts","../src/syntax/extract.ts","../src/syntax/header.ts","../src/syntax/job.ts","../src/initialize.ts","../src/run.ts","../src/list.ts","../src/index.ts"],"sourcesContent":["export const enum Tag {\n Info = '[INFO]',\n Spawn = '[SPAWN]',\n Error = '[ERROR]',\n Warn = '[WARN]',\n Exit = '[EXIT]',\n Debug = '[DEBUG]',\n}\n\n/**\n * runner 自己建的目录统一按 0755 创建。\n * - 不能沿用 umask:Debian/Ubuntu 的 USERGROUPS_ENAB 默认 umask 002,mkdir 会建出 775,\n * 紧接着被 checkDirPermissions 拒绝,第一次部署就起不来(F44)\n * - 0755 本身不带 group/other 写位,任何 umask 下都只会更收紧,不会更宽松\n */\nexport const DIR_MODE = 0o755;\n\nexport const enum CronjobState {\n Running,\n Paused,\n Stopped,\n}\n\nexport namespace Marker {\n export const CRON = '@cron' as const;\n export const REGEX = /@cron\\b/;\n\n export const BEGIN = '@cronbegin' as const;\n export const BEGIN_REGEX = /@cronbegin\\b/;\n export const END = '@cronend' as const;\n export const END_REGEX = /@cronend\\b/;\n\n /** 行内标记:`@cronutc <5 段>`,只让这一条按 UTC 解析 */\n export const UTC = '@cronutc' as const;\n export const UTC_REGEX = /@cronutc\\b/;\n}\n\nexport type CronBlockMaker = typeof Marker.BEGIN | typeof Marker.END;\n","import type { Interpreter } from '../types/global.js';\nimport { existsSync } from 'node:fs';\nimport { delimiter, join } from 'node:path';\nimport { env } from 'node:process';\n\nconst isPath = (cmd: string) => cmd.includes('/') || cmd.includes('\\\\');\n\n/**\n * 检测系统中可用的运行时命令。\n * - 只查 PATH、不执行命令:`tsx --version` 实测约 740ms,而探测在 cronjob() 的启动路径上,\n * 每个 cx 都要付一次太贵。代价是\"存在但跑不起来\"的命令会被当成可用,启动时不会发现。\n * - 含路径分隔符的命令直接看文件是否存在,不查 PATH\n * - PATH 为空时(某些 pm2 配置)回退到常见系统目录\n * @returns 可用的命令名,都不可用则返回 null\n */\nexport function detectCommand(cmd: string): string | null {\n if (isPath(cmd)) {\n return existsSync(cmd) ? cmd : null;\n }\n for (const dir of (env.PATH || '/usr/local/bin:/usr/bin:/bin').split(delimiter)) {\n if (dir && existsSync(join(dir, cmd))) {\n return cmd;\n }\n }\n return null;\n}\n\n/** 标记\"没有可用解释器\"的占位命令,run() 见到它只记 WARN 不 spawn */\nexport const CMD_NONE = 'none';\n\n/**\n * 探测所有运行时,返回解释器映射表。\n */\nexport function detectRuntime() {\n const tsCmd = detectCommand('tsx') ?? detectCommand('ts-node') ?? process.execPath;\n const jsLike = (cmd: string): Interpreter => ({ cmd, args: [] });\n\n const interpreters: Record<string, Interpreter> = {\n '.ts': jsLike(tsCmd),\n '.mts': jsLike(tsCmd),\n '.cts': jsLike(tsCmd),\n '.js': jsLike(process.execPath),\n '.mjs': jsLike(process.execPath),\n '.cjs': jsLike(process.execPath),\n '.py': {\n cmd: detectCommand('python3') || detectCommand('python') || CMD_NONE,\n args: [],\n },\n '.sh': {\n cmd: detectCommand('bash') || 'sh',\n args: [],\n },\n none: {\n cmd: CMD_NONE,\n args: [],\n },\n };\n\n return {\n interpreters,\n hasTsx: tsCmd !== process.execPath,\n pythonCmd: interpreters['.py'].cmd,\n };\n}\n\nexport type Runtime = ReturnType<typeof detectRuntime>;\n\n/** 取扩展名对应的解释器;没有映射的(或映射成 none)交给 run() 记 WARN */\nexport function getDefaultInterpreter(runtime: Runtime, ext: string): Interpreter {\n return runtime.interpreters[ext] || runtime.interpreters.none;\n}\n","import type { CronjobLogger } from '../types/global.js';\nimport type { UserCronjobConfig } from '../types/config.js';\nimport { Tag } from '../consts.js';\n\n/**\n * 把 cx.write 包装成带 tag 的方法。\n * - write 是唯一的输出出口,消费者可以整条替换(默认写 stdout)\n */\nexport function createLogger(write: UserCronjobConfig['write']): CronjobLogger {\n return {\n info: (...args: any[]) => write(Tag.Info, ...args),\n err: (...args: any[]) => write(Tag.Error, ...args),\n warn: (...args: any[]) => write(Tag.Warn, ...args),\n spawn: (...args: any[]) => write(Tag.Spawn, ...args),\n exit: (...args: any[]) => write(Tag.Exit, ...args),\n debug: (...args: any[]) => write(Tag.Debug, ...args),\n };\n}\n\n/** 默认输出:`<dtm> <TAG> <内容>`,dtm 用 cx.timezone */\nexport function defaultWrite(formatter: Intl.DateTimeFormat): UserCronjobConfig['write'] {\n return (tag: Tag, ...args: any[]) => console.log(formatter.format(new Date()), tag, ...args);\n}\n","import type { CronjobContext, UserCronjobConfig } from '../types/config.js';\nimport type { Runtime } from './interpreter.js';\nimport { resolve } from 'node:path';\n\nimport { CronjobState } from '../consts.js';\nimport { detectRuntime } from './interpreter.js';\nimport { createLogger, defaultWrite } from './logger.js';\n\n/** 默认值:只改一处,测试与 createContext 都从这里断言 */\nexport const DEFAULTS = {\n include: ['**/*.{ts,js,sh,cts,mts,cjs,mjs,py}'],\n exclude: [\n '**/node_modules/',\n '**/.git/',\n '**/.vscode/',\n '**/.claude/',\n '**/__pycache__/',\n '**/dist/',\n '**/dist-tsc/',\n '**/coverage/',\n ],\n timezone: 'Asia/Shanghai',\n};\n\nconst createFormatter = (timezone: string) =>\n new Intl.DateTimeFormat('zh-CN', {\n year: 'numeric',\n month: '2-digit',\n day: '2-digit',\n hour: '2-digit',\n minute: '2-digit',\n second: '2-digit',\n fractionalSecondDigits: 3,\n hour12: false,\n timeZone: timezone,\n });\n\n/**\n * 创建上下文:配置校验 + 默认值 + 格式化器 + logger + 运行时映射,一次给齐。\n * - `runtime` 由调用方传入时直接用(便于测试注入);不传就现场探测一次\n * - 探测只查 PATH(见 interpreter.ts),不执行外部命令\n */\nexport function createContext(\n rawConfig?: Partial<UserCronjobConfig>,\n runtime: Runtime = detectRuntime(),\n): CronjobContext {\n const {\n dir = process.cwd(),\n logDir = dir,\n jobcwd = dir,\n include = DEFAULTS.include,\n exclude = DEFAULTS.exclude,\n timezone = DEFAULTS.timezone,\n write,\n } = Object(rawConfig) as UserCronjobConfig;\n\n if (typeof dir !== 'string') {\n throw new TypeError('`dir` must be a string');\n }\n\n if (typeof logDir !== 'string') {\n throw new TypeError('`logDir` must be a string');\n }\n\n if (typeof jobcwd !== 'string' && typeof jobcwd !== 'function') {\n throw new TypeError('`jobcwd` must be a string or a function');\n }\n\n if (write !== undefined && typeof write !== 'function') {\n throw new TypeError('`write` must be a function');\n }\n\n // 用 Intl 构造一次来校验时区,非法时区会抛 RangeError\n new Intl.DateTimeFormat('en-US', { timeZone: timezone });\n\n if (!Array.isArray(include) || include.some((pattern) => typeof pattern !== 'string')) {\n throw new TypeError('`include` must be an array of strings');\n }\n if (!Array.isArray(exclude) || exclude.some((pattern) => typeof pattern !== 'string')) {\n throw new TypeError('`exclude` must be an array of strings');\n }\n\n // 统一成绝对路径:单例锁的 key、日志相对路径、glob 的 cwd 都依赖它。\n // 否则 './g'、'/abs/g'、'/abs/g/' 会被当成三个不同的任务目录。\n const absDir = resolve(dir);\n const absLogDir = resolve(logDir);\n\n const timeFormat = createFormatter(timezone);\n\n // jobcwd 是字符串时包装成函数;显式传入的(含默认的 dir)不额外改动\n const defaultJobcwd = typeof jobcwd !== 'function' && jobcwd === dir ? absDir : jobcwd;\n const jobcwdFn = typeof defaultJobcwd === 'function' ? defaultJobcwd : () => defaultJobcwd;\n\n const writer = write === undefined ? defaultWrite(timeFormat) : write;\n\n return {\n dir: absDir,\n logDir: absLogDir,\n jobcwd: jobcwdFn,\n include,\n exclude,\n timezone,\n timeFormat,\n runtime,\n jobState: CronjobState.Running,\n jobTimer: null,\n write: writer,\n log: createLogger(writer),\n };\n}\n","import type { CronjobContext } from './types/config.js';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\n/**\n * 返回要处理的文件的绝对路径\n */\nexport const tryGlobSync = (cx: CronjobContext) => {\n try {\n return fs.globSync(cx.include, { cwd: cx.dir, exclude: cx.exclude }).map((v) => path.resolve(cx.dir, v));\n } catch (e) {\n cx.log.err(`Error while globbing scripts.`, e);\n return null;\n }\n};\n\n/**\n * 用来解决超时问题\n * - 不一定用得上\n */\nexport function nolater<T extends Promise<any>>(cx: CronjobContext, promise: T, ms: number = 2000): T {\n const timeout = new Promise<never>((_, reject) => {\n const id = setTimeout(() => {\n clearTimeout(id);\n reject(new Error(`Promise did not resolve within ${ms}ms`));\n }, ms);\n });\n return Promise.race([promise, timeout]) as T;\n}\n","import type { CronjobContext } from '../types/config.js';\nimport { CronjobState } from '../consts.js';\n\nexport interface TaskController {\n /** 停止调度:清掉还没触发的定时器,状态置为 Stopped */\n stop: () => void;\n /** 暂停:定时器继续走,但到点不执行 */\n pause: () => void;\n /** 恢复 */\n resume: () => void;\n}\n\n/** 下一分钟边界(本地毫秒截断到分钟) */\nconst nextMinuteBoundary = (from: Date) => {\n const next = new Date(from.getTime() + 60000);\n next.setSeconds(0, 0);\n return next;\n};\n\n/**\n * 每分钟执行一次 fn,返回控制对象\n * - 状态全部放在 cx.jobState / cx.jobTimer 里,本函数不持有模块级状态\n * - 每次调度都重新读 cx.jobState,因此 stop/resume 在任意时刻都生效\n */\nexport function runTask(cx: CronjobContext, fn: (now: Date) => void | Promise<void>): TaskController {\n const schedule = () => {\n // 只有 Stopped 才停链;Paused 也要继续排,否则进程会在下一个边界自行退出\n if (cx.jobState === CronjobState.Stopped) {\n return;\n }\n\n const now = new Date();\n const nextMinute = nextMinuteBoundary(now);\n\n cx.jobTimer = setTimeout(() => {\n // 定时器已经触发,句柄作废;stop 时靠它判断是否还有待触发的定时器\n cx.jobTimer = null;\n\n // 到点时状态可能已经变了(stop)\n if (cx.jobState === CronjobState.Stopped) {\n return;\n }\n\n // 暂停期间定时器照常走,只是不执行;否则事件循环会空掉,进程在下一个分钟边界自行退出\n if (cx.jobState === CronjobState.Paused) {\n schedule();\n return;\n }\n\n //! 定时器可能早于边界触发,相当于等了但还没等到呢,再等一会\n if (Date.now() < nextMinute.getTime()) {\n schedule();\n return;\n }\n\n const noSecondDate = new Date();\n noSecondDate.setSeconds(0, 0);\n\n // 先排下一轮:fn 抛错或异步 reject 都不能打断调度链(否则整条链就断了)\n schedule();\n\n try {\n const ret = fn(noSecondDate);\n // 只用一条 Error 记录,不重试、不告警,等下一分钟即可\n if (ret && typeof ret.catch === 'function') {\n ret.catch((e) => cx.log.err(`Task tick failed:`, e));\n }\n } catch (e) {\n cx.log.err(`Task tick failed:`, e);\n }\n }, nextMinute.getTime() - now.getTime());\n };\n\n schedule();\n\n return {\n stop() {\n if (cx.jobTimer) {\n clearTimeout(cx.jobTimer);\n cx.jobTimer = null;\n }\n cx.jobState = CronjobState.Stopped;\n },\n pause() {\n if (cx.jobState === CronjobState.Running) {\n cx.jobState = CronjobState.Paused;\n }\n },\n resume() {\n if (cx.jobState === CronjobState.Stopped) {\n return;\n }\n cx.jobState = CronjobState.Running;\n // 暂停期间定时器没有停,所以这里只需要恢复状态即可;\n // 但如果定时器已经被外部清掉(jobTimer === null),重新排一次\n if (cx.jobTimer === null) {\n schedule();\n }\n },\n };\n}\n","import { type CronExpression, CronExpressionParser } from 'cron-parser';\nimport type { CronjobContext } from '../types/config.js';\n\n/**\n * 非得要try很奇怪,但这是官方推荐的方式\n *\n * @param timezone cron 语义使用的时区;默认是 cx.timezone,`@cronutc` 之后传 'UTC'\n */\nexport const parseExp = (\n cx: CronjobContext,\n exp: string,\n filepath: string,\n timezone: string = cx.timezone,\n): CronExpression | null => {\n try {\n return CronExpressionParser.parse(exp, { tz: timezone, hashSeed: filepath });\n } catch {\n return null;\n }\n};\n\n/**\n * 判断给定日期是否匹配 cron 表达式\n * @param expression cron 表达式\n * @param d 待匹配的日期\n */\nexport function matches(expression: CronExpression, d: Date) {\n // & 已经在task里面完成了这一步:d.setSeconds(0, 0);\n return expression.includesDate(d);\n}\n","/**\n * ! 多行注释以`*`开头是实时标准和社区、行业规范\n */\nconst jstsAllow = (line) =>\n // 单行注释\n line.startsWith('//') ||\n // 多行注释\n line.startsWith('/*') ||\n // 多行注释的第二行\n line.startsWith('*') ||\n // 多行注释的最后一行\n line.startsWith('*/') ||\n // 什么都没有,也可能是多行注释\n line.length === 0;\n\nconst allows = {\n '.ts': jstsAllow,\n '.mts': jstsAllow,\n '.cts': jstsAllow,\n '.js': jstsAllow,\n '.mjs': jstsAllow,\n '.cjs': jstsAllow,\n '.py': (line: string) => /^(#|'''|\"\"\")/.test(line) || line.length === 0,\n '.sh': (line: string) => line.startsWith('#') || line.length === 0,\n};\n\nexport function getAllowFn(ext: string): (line: string) => boolean {\n return allows[ext] || (() => false);\n}\n","import type { Interpreter } from '../types/global.js';\n\nconst parse = (text: string): Interpreter | null => {\n const [cmd, ...args] = text.split(/\\s+/).filter(Boolean);\n return cmd ? { cmd, args } : null;\n};\n\n/**\n * 获取解释器,同时也可用于判定是否存在 shebang\n * - 如果有人只是在第一行写了\"#!\",后面没写任何东西,这里也会返回`null`\n */\nexport const getShebang = (line: string) => (line.startsWith('#!') ? parse(line.slice(2)) : null);\n","import type { CronExpression } from 'cron-parser';\nimport type { CronGroupItem, JobItem } from '../types/global.js';\nimport type { CronjobContext } from '../types/config.js';\n\nimport { extname, relative } from 'node:path';\nimport { type CronBlockMaker, Marker } from '../consts.js';\nimport { parseExp } from '../cron/parse.js';\nimport { getDefaultInterpreter } from '../context/interpreter.js';\nimport { getAllowFn } from './allow.js';\nimport { getShebang } from './shebang.js';\n\n/**\n * 一行解析出来的调度:表达式 + 它实际使用的时区。\n * 时区只在这里决定一次,调用方不要再对整行做第二次标记搜索(F45)。\n */\nexport interface ExtractedCron {\n cron: CronExpression;\n timezone: string;\n}\n\n/**\n * 从一行文本中提取带标记的 cron 表达式\n * - 只接受5位表达式,不支持秒级\n * - `@cronutc <5 段>` 是行内指令:这一条按 UTC 解析,不影响其它行\n *\n * @param trimmedLine 已经去掉前导空格的行文本\n * @param inBlock 是否在 @cronbegin 和 @cronend 块中\n * @param relativePath 相对路径,用于日志输出\n */\nexport function extractCron(\n cx: CronjobContext,\n trimmedLine: string,\n inBlock: boolean,\n relativePath: string,\n): ExtractedCron | CronBlockMaker | null {\n if (trimmedLine.search(Marker.BEGIN_REGEX) !== -1) {\n return Marker.BEGIN;\n }\n if (trimmedLine.search(Marker.END_REGEX) !== -1) {\n return Marker.END;\n }\n\n // @cron的index\n const index = trimmedLine.search(Marker.REGEX);\n // @cronutc的index\n const utcIndex = trimmedLine.search(Marker.UTC_REGEX);\n\n // 同一行两个标记无法判断该按哪个时区跑;宁可拒绝并记 Error,也不猜\n if (index !== -1 && utcIndex !== -1) {\n cx.log.err(`Line contains both ${Marker.CRON} and ${Marker.UTC}, nothing scheduled: ${relativePath}`);\n return null;\n }\n\n let timezone = cx.timezone;\n let expStart = -1;\n\n // 一般都是这个,所以这个排前面,分支预测更好\n if (index !== -1) {\n expStart = index + Marker.CRON.length;\n } else if (utcIndex !== -1) {\n timezone = 'UTC';\n expStart = utcIndex + Marker.UTC.length;\n }\n\n if (expStart === -1) {\n if (inBlock) {\n cx.log.warn(`@cron should be used to mark cron expressions in cron blocks: ${relativePath}`);\n }\n return null;\n }\n\n // 直接切片,从标记后面开始获取字符\n const tokens = trimmedLine.slice(expStart).split(/\\s+/).filter(Boolean);\n\n //! 阻止cron-parser 把 4 段自动补齐成另一条合法表达式\n if (tokens.length < 5) {\n cx.log.err(`Invalid cron expression: \"${tokens.join(' ')}\" in file: ${relativePath}`);\n return null;\n }\n\n // 前 6 段能解析说明写的是秒级定时,本项目只支持 5 段,整行不调度\n if (tokens.length >= 6) {\n const sixExpStr = tokens.slice(0, 6).join(' ');\n if (parseExp(cx, sixExpStr, relativePath, timezone)) {\n cx.log.err(`6 fields cron is not supported, use 5 fields instead. Found \"${sixExpStr}\" in file: ${relativePath}`);\n return null;\n }\n }\n\n // 取前 5 段,之后是说明文字\n const cron = parseExp(cx, tokens.slice(0, 5).join(' '), relativePath, timezone);\n return cron ? { cron, timezone } : null;\n}\n\n/**\n * 从文件内容提取带标记的 cron 表达式,并组合成`JobItem`,一次性提供\n * cron表达式对象、分组信息、文件路径以及解释器信息\n *\n * @param filepath 文件路径,用于日志输出\n * @param content 文件头内容(可以是整文件;第一行正式代码之后的不会用到)\n */\nexport function getJobItem(cx: CronjobContext, filepath: string, content: string): JobItem | null {\n const ext = extname(filepath);\n const allowFn = getAllowFn(ext);\n\n let lines = content.split('\\n').map((line) => line.trim());\n\n if (lines.length === 0) {\n return null;\n }\n\n const shebang = getShebang(lines[0]);\n\n if (shebang) {\n lines.shift();\n }\n\n if (lines.length === 0) {\n return null;\n }\n\n // 第一行放行shebang\n const firstNotAllowedIndex = lines.findIndex((v) => !allowFn(v));\n if (firstNotAllowedIndex !== -1) {\n // 切除到第一行正式代码为止,上面的都可以用来记录@cron\n lines = lines.slice(0, firstNotAllowedIndex);\n }\n\n if (lines.length === 0) {\n return null;\n }\n\n const list: CronGroupItem[] = [];\n // 主日志统一用相对路径(CLAUDE.md 约定)\n const relativePath = relative(cx.dir, filepath);\n\n let inCronBlock = false;\n let group = 0;\n for (const line of lines) {\n const extracted = extractCron(cx, line, inCronBlock, relativePath);\n // 忽略空的\n if (!extracted) {\n continue;\n }\n\n if (extracted === Marker.BEGIN) {\n // 已经在快中,再次碰到begin,则语法错误不予解析\n if (inCronBlock) {\n cx.log.err(`Nested ${Marker.BEGIN} found in file: ${relativePath}`);\n return null;\n }\n group++;\n inCronBlock = true;\n continue;\n }\n\n if (extracted === Marker.END) {\n // 并不在块中,却直接碰到end,语法错误不予解析\n if (!inCronBlock) {\n cx.log.err(`${Marker.END} didn't match ${Marker.BEGIN} in file: ${relativePath}`);\n return null;\n }\n inCronBlock = false;\n continue;\n }\n\n // 时区跟着解析结果走:@cron 与 @cronutc 同时出现时标记不匹配的错误已在 extractCron 里拦下\n list.push({ ...extracted, group: inCronBlock ? group : 0 });\n }\n\n // 语法错误不予解析\n if (inCronBlock) {\n cx.log.err(`Unclosed ${Marker.BEGIN}/${Marker.END} block in file: ${relativePath}`);\n return null;\n }\n\n const interpreter = shebang ?? getDefaultInterpreter(cx.runtime, ext);\n\n return { flatCronGroups: list, interpreter, filepath };\n}\n","import type { CronjobContext } from '../types/config.js';\n\nimport { open, readFile, stat } from 'node:fs/promises';\nimport path from 'node:path';\n\n/** 文件头最多读 64KB;比这小的文件由调用方直接整读 */\nexport const MAX_HEADER = 64 * 1024;\n\n/**\n * 只读大文件的前 MAX_HEADER 字节,一次定位读,不循环。\n * - 读出来的内容可能带上一行正式代码或半行,没关系:getJobItem 会在第一行正式代码处切掉\n * - 只有前 64KB 全是注释(说明文件头真的超长)才记 WARN,避免每个大文件每分钟刷一条\n */\nexport async function readHeader(\n cx: CronjobContext,\n filepath: string,\n allowLine: (line: string) => boolean,\n): Promise<string | null> {\n const s = await stat(filepath);\n if (!s.isFile()) {\n cx.log.warn(`Skipped non-regular file: ${path.relative(cx.dir, filepath)}`);\n return null;\n }\n if (s.size < MAX_HEADER) {\n return await readFile(filepath, 'utf8');\n }\n\n const fh = await open(filepath, 'r');\n try {\n const buf = Buffer.alloc(MAX_HEADER);\n const { bytesRead } = await fh.read(buf, 0, MAX_HEADER, 0);\n const text = buf.subarray(0, bytesRead).toString('utf8');\n if (bytesRead === MAX_HEADER && text.split('\\n').every((line) => allowLine(line.trim()))) {\n cx.log.warn(`Header longer than ${MAX_HEADER} bytes, truncated: ${path.relative(cx.dir, filepath)}`);\n }\n return text;\n } finally {\n await fh.close();\n }\n}\n","import type { Job, JobItem } from '../types/global.js';\nimport type { CronjobContext } from '../types/config.js';\n\nimport path from 'node:path';\n\nimport { getJobItem } from './extract.js';\nimport { matches } from '../cron/parse.js';\nimport { getAllowFn } from './allow.js';\nimport { readHeader } from './header.js';\n\nexport type FileContent =\n | {\n filepath: string;\n /** null = 已跳过(非普通文件),readHeader 已经记过 WARN,不算读取失败 */\n content: string | null;\n error: null;\n }\n | {\n filepath: string;\n content: null;\n error: any;\n };\n\nconst CHUNK_SIZE = 100;\n\n/**\n * stat 并读取文件头,一个文件对应一条结果,失败也包成结果、不抛出。\n * - 先 stat:FIFO、设备、目录等非普通文件直接跳过(对 FIFO 做 readFile 会永久阻塞线程池)\n * - 只读文件头:大文件不再整读进内存\n */\nexport async function loadFiles(cx: CronjobContext, filepaths: string[]): Promise<Array<FileContent>> {\n const result: Array<FileContent> = [];\n for (let i = 0; i < filepaths.length; i += CHUNK_SIZE) {\n const promises = filepaths.slice(i, i + CHUNK_SIZE).map(async (filepath): Promise<FileContent> => {\n try {\n const allower = getAllowFn(path.extname(filepath));\n const content = await readHeader(cx, filepath, allower);\n return { filepath, content, error: null };\n } catch (error) {\n return { filepath, content: null, error };\n }\n });\n const r = await Promise.all(promises);\n result.push(...r);\n }\n\n return result;\n}\n\n/**\n * 获取现在应该运行的job\n * - 不会有人写非常多的 cron 表达式,直接遍历即可\n *\n * ! 仅用于同一个filepath\n *\n * @param cx Cronjob 上下文\n * @param item JobItem 对象\n * @param now 当前时间,**秒数、毫秒数为0**\n */\nexport function getMatchedJob(cx: CronjobContext, item: JobItem, now: Date): Job {\n let count = 0;\n const set = new Set<number>();\n for (let i = 0; i < item.flatCronGroups.length; i++) {\n const job = item.flatCronGroups[i];\n if (job.group === 0 && matches(job.cron, now)) {\n count++;\n continue;\n }\n if (!set.has(job.group) && matches(job.cron, now)) {\n count++;\n set.add(job.group);\n }\n }\n return { filepath: item.filepath, interpreter: item.interpreter, count };\n}\n\n/**\n * 判断文件本轮是否该运行\n *\n * @param cx Cronjob 上下文\n * @param files 文件内容数组\n * @param now 当前时间,**秒数、毫秒数为0**\n * @returns 要跑的 cron,要跑多少次;\n */\nexport function getJobs(cx: CronjobContext, files: FileContent[], now: Date): Job[] {\n const jobs: Job[] = [];\n\n for (let i = 0; i < files.length; i++) {\n const f = files[i];\n if (f.error) {\n cx.log.err(`Error loading file ${path.relative(cx.dir, f.filepath)}: ${f.error}`);\n continue;\n }\n if (f.content === null) {\n // 非普通文件:readHeader 已经记过 WARN,这里不再刷 Error\n continue;\n }\n\n const jobItem = getJobItem(cx, f.filepath, f.content);\n if (!jobItem) {\n continue;\n }\n\n // 这里要把shebang算好,matchedjob要运行多少次直接看数字\n const job = getMatchedJob(cx, jobItem, now);\n if (job.count > 0) {\n jobs.push(job);\n }\n }\n\n return jobs;\n}\n","import type { CronjobContext } from './types/config.js';\nimport { createHash } from 'node:crypto';\nimport { mkdirSync, realpathSync, statSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport net from 'node:net';\n\nimport { CMD_NONE } from './context/interpreter.js';\nimport { DIR_MODE } from './consts.js';\n\n/** 持有引用,防止 unref 后的 server 被 GC,导致锁被提前释放 */\nlet _lock: net.Server | null = null;\n\n/**\n * 检查 tsx 是否可用;没有只警告,纯 js/sh 任务仍可运行\n */\nconst orTsx = (cx: CronjobContext) => {\n if (!cx.runtime.hasTsx) {\n cx.log.warn(`'tsx' not found, .ts files will be run by node directly. Not all nodejs versions supports this.`);\n }\n};\n\nconst orPython = (cx: CronjobContext) => {\n if (cx.runtime.pythonCmd !== CMD_NONE) {\n cx.log.info(`python available, .py files will be run by ${cx.runtime.pythonCmd}`);\n } else {\n cx.log.warn('python not available, .py jobs will be ignored');\n }\n};\n\nconst ensureDir = (cx: CronjobContext) => {\n mkdirSync(cx.dir, { recursive: true, mode: DIR_MODE });\n if (cx.dir !== cx.logDir) {\n mkdirSync(cx.logDir, { recursive: true, mode: DIR_MODE });\n }\n};\n\n/**\n * dir / logDir 必须只有 runner 用户能写。\n * - dir 可写 = 能以 runner 的身份执行任意代码;logDir 可写 = 能往任务日志里追加内容\n * - 属主不是当前用户、或 group/other 有写位,都直接报错(不是告警)\n * - root 除外:root 能写任何目录,这条检查对 root 没有意义\n */\nconst checkDirPermissions = (cx: CronjobContext) => {\n if (typeof process.getuid !== 'function' || process.getuid() === 0) {\n return;\n }\n for (const [name, dir] of [\n ['dir', cx.dir],\n ['logDir', cx.logDir],\n ] as const) {\n const { mode, uid } = statSync(dir);\n const writableByOthers = (mode & 0o022) !== 0;\n if (uid !== process.getuid() || writableByOthers) {\n throw new Error(\n `${name} must be owned by the current user and not group/world-writable: ${dir} ` +\n `(owner=${uid}, mode=${(mode & 0o777).toString(8)})`,\n );\n }\n }\n};\n\n/** 写日志时用:任务输出可能含密钥,不让同机其他用户读 */\nexport const LOG_FILE_MODE = 0o640;\n\n/**\n * 锁名用的目录标识:realpath 兜住符号链接(/a/link 与 /b/real 是同一个目录时也能识别),\n * 目录还不存在时退回 resolve 的结果(ensureDir 在拿锁之后才建目录)。\n */\nconst lockKeyOf = (dir: string) => {\n try {\n return realpathSync(dir);\n } catch {\n return resolve(dir);\n }\n};\n\n/**\n * 绑定成功则 resolve(进程活着就一直占着);\n * 已被占用则 reject —— 不 process.exit,由宿主决定怎么退。\n * @returns 拿到锁后 resolve;锁已被占用则 reject\n */\nconst acquireLock = (cx: CronjobContext) =>\n new Promise<void>((resolve, reject) => {\n /**\n * 锁名跟着任务目录走,同一台机器跑多个项目时不会互相误伤。\n * \\0 前缀 = 抽象 namespace,不落盘;进程退出(含 kill -9)由内核自动释放。\n * exclusive: true —— cluster 模式下 listen 默认交给 primary 代绑并共享句柄,\n * 每个 worker 都会\"成功\",锁就失效了;exclusive 让每个 worker 自己真绑,第二个拿到 EADDRINUSE。\n */\n const LOCK_NAME = '\\0krontab-' + createHash('sha1').update(lockKeyOf(cx.dir)).digest('hex').slice(0, 8);\n const server = net.createServer();\n server.once('error', (e: NodeJS.ErrnoException) => {\n reject(e.code === 'EADDRINUSE' ? new Error('krontab already running') : e);\n });\n server.listen({ path: LOCK_NAME, exclusive: true }, () => {\n server.unref(); // 不阻止进程退出\n _lock = server;\n resolve();\n });\n });\n\nexport const initialize = async (cx: CronjobContext) => {\n // 先拿锁:重复实例不必再做后面的探测\n await acquireLock(cx);\n ensureDir(cx);\n checkDirPermissions(cx);\n orTsx(cx);\n orPython(cx);\n};\n","import type { Job } from './types/global.js';\nimport type { CronjobContext } from './types/config.js';\n\nimport { spawn } from 'node:child_process';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { env } from 'node:process';\n\nimport { CMD_NONE } from './context/interpreter.js';\nimport { LOG_FILE_MODE } from './initialize.js';\n\nexport function run(cx: CronjobContext, { filepath, interpreter }: Job) {\n let output: number | null = null;\n const closeOutput = () => {\n if (output !== null) {\n fs.closeSync(output);\n output = null; // ! 防止反复close\n }\n };\n // 主日志统一用相对路径,绝对路径只用于 spawn\n const relativePath = path.relative(cx.dir, filepath);\n try {\n // 把相对于cron文件夹的路径也带入到日志路径中,这样符合直觉\n const logfile = path.join(cx.logDir, relativePath + '.log');\n\n // 子目录下的脚本,其日志子目录也要存在,否则 shell 重定向失败、命令不会执行\n fs.mkdirSync(path.dirname(logfile), { recursive: true });\n\n // 运行这个文件\n if (interpreter.cmd === CMD_NONE) {\n cx.log.warn(`path=${relativePath} unsupported extension`);\n return;\n }\n\n const cmd = interpreter.cmd;\n const args = interpreter.args.concat(filepath);\n\n output = fs.openSync(logfile, 'a', LOG_FILE_MODE);\n\n const child = spawn(cmd, args, {\n stdio: ['ignore', output, output],\n detached: true,\n env,\n // 子进程 cwd 默认和主程序一样,或者以--cwd=xxx录入\n cwd: cx.jobcwd(filepath),\n });\n\n child.on('error', (e) => {\n closeOutput();\n cx.log.err(`path=${relativePath} pid=${child.pid ?? '-1'}`, e);\n });\n child.on('spawn', () => {\n closeOutput();\n cx.log.spawn(`path=${relativePath} pid=${child.pid ?? '-1'}`);\n });\n child.on('exit', (code, signal) => {\n closeOutput();\n cx.log.exit(`path=${relativePath} pid=${child.pid ?? '-1'} code=${code} signal=${signal}`);\n });\n child.unref();\n } catch (e) {\n closeOutput();\n // spawn 之前的异常(mkdir/openSync/jobcwd 等)也要进主日志,否则无法定位\n cx.log.err(`path=${relativePath} pid=-1`, e);\n }\n}\n","import path from 'node:path';\n\nimport type { CronjobContext } from './types/config.js';\nimport { tryGlobSync } from './utils.js';\nimport { loadFiles } from './syntax/job.js';\nimport { getJobItem } from './syntax/extract.js';\nimport { parseExp } from './cron/parse.js';\n\n/**\n * 罗列所有定时表达式,效果类似 `crontab -l`\n *\n * 输出四列:下次运行时间、表达式、相对路径、解释器命令\n * - 块内的多条表达式会缩进显示,并标出 group\n * - 同一条表达式每次都重新 parse,避免 next() 改动共享对象的内部游标\n */\nexport async function list(cx: CronjobContext) {\n const filepaths = tryGlobSync(cx);\n if (!filepaths) {\n return;\n }\n if (filepaths.length === 0) {\n cx.log.info(`No scripts found in ${cx.dir}`);\n return;\n }\n\n const files = await loadFiles(cx, filepaths);\n\n for (const f of files) {\n const relativePath = path.relative(cx.dir, f.filepath);\n\n if (f.error) {\n cx.log.err(`Error loading file ${relativePath}: ${f.error}`);\n continue;\n }\n if (f.content === null) {\n // 非普通文件:readHeader 已经记过 WARN\n continue;\n }\n\n const item = getJobItem(cx, f.filepath, f.content);\n if (!item) {\n continue;\n }\n\n if (item.flatCronGroups.length === 0) {\n cx.log.warn(`No cron expression: ${relativePath}`);\n continue;\n }\n\n const invocation = [item.interpreter.cmd, ...item.interpreter.args, relativePath].join(' ');\n\n for (const { cron, group, timezone } of item.flatCronGroups) {\n const exp = cron.stringify();\n const next = nextRunText(cx, exp, f.filepath, timezone);\n const prefix = (group > 0 ? ` [${group}] ` : '') + (timezone === 'UTC' ? 'UTC ' : '');\n console.log(`${next.padEnd(24)} ${(prefix + exp).padEnd(18)} ${relativePath.padEnd(32)} ${invocation}`);\n }\n }\n}\n\n/** 表达式在上一次 parse 后可能因 impossible date 抛错,这里只展示、不中断整个列表 */\nfunction nextRunText(cx: CronjobContext, exp: string, filepath: string, timezone: string) {\n const parsed = parseExp(cx, exp, filepath, timezone);\n if (!parsed) {\n return '(invalid)';\n }\n try {\n return cx.timeFormat.format(parsed.next().toDate());\n } catch {\n return '(no next run)';\n }\n}\n","/**\n * # 全局定时任务主理,以每分钟读取来决定是否运行\n * # 1. 只支持:【分 时 日 月 周】 的写法\n * # 2. cron 表达式写在脚本的文件头注释区(第一条正式代码之前的注释),以注释给出\n */\nimport type { UserCronjobConfig } from './types/config.js';\nimport { performance } from 'node:perf_hooks';\n\nimport { createContext } from './context/index.js';\nimport { CronjobState } from './consts.js';\nimport { tryGlobSync } from './utils.js';\nimport { runTask, type TaskController } from './cron/task.js';\nimport { getJobs, loadFiles } from './syntax/job.js';\nimport { run } from './run.js';\nimport { initialize } from './initialize.js';\nimport { list } from './list.js';\n\nexport type { TaskController } from './cron/task.js';\nexport { UserCronjobConfig };\n\n/**\n * 启动定时任务主理,返回控制器\n * - 只支持 5 段 cron:分 时 日 月 周\n * - 同一 dir 只允许一个实例\n */\nexport async function cronjob(config?: Partial<UserCronjobConfig>): Promise<TaskController> {\n const cx = createContext(config);\n cx.log.info(`Config loaded: ${JSON.stringify(cx)}`);\n\n if (process.argv.includes('--list') || process.argv.includes('-l')) {\n // 列出所有任务看一下效果就退出\n await list(cx);\n process.exit(0);\n }\n\n await initialize(cx);\n\n const taskFn = async (now: Date) => {\n // 1、查找CRONJOB_DIR下面的所有符合suffix的文件\n const filepaths = tryGlobSync(cx);\n if (!filepaths) {\n return;\n }\n if (filepaths.length === 0) {\n cx.log.info(`No scripts found.`);\n return;\n }\n\n const performanceNow = performance.now();\n cx.log.debug(`Start`);\n\n const files = await loadFiles(cx, filepaths);\n const jobs = await getJobs(cx, files, now);\n\n // 读文件期间可能被 stop() / pause()(F33):已不在 Running 就不再 spawn 这一轮\n if (cx.jobState === CronjobState.Stopped) {\n return;\n }\n\n for (let i = 0; i < jobs.length; i++) {\n for (let n = 0; n < jobs[i].count; n++) {\n if (cx.jobState === CronjobState.Running) {\n run(cx, jobs[i]);\n }\n }\n }\n\n cx.log.debug(`Finished in ${(performance.now() - performanceNow).toFixed(6)}ms`);\n };\n\n const task = runTask(cx, taskFn);\n\n cx.log.info(`Cronjob start! pid=${process.pid}`);\n\n return task;\n}\n\n/**\n * 启动定时任务主理,返回控制器\n * - 只支持 5 段 cron:分 时 日 月 周\n * - 同一 dir 只允许一个实例\n */\nexport const krontab = cronjob;\n"],"mappings":"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"}
package/dist/index.d.cts CHANGED
@@ -13,49 +13,49 @@ declare const enum Tag {
13
13
  }
14
14
  interface UserCronjobConfig {
15
15
  /**
16
- * Will scan this directory for cronjob scripts
16
+ * 扫描任务脚本的目录
17
17
  */
18
18
  dir: string;
19
19
  /**
20
- * Will put log files there.
21
- * - Share the same structure as the cronjob scripts directory
22
- * default value is the same as `this.dir`
20
+ * 任务日志的存放目录
21
+ * - 目录结构与任务脚本目录保持一致
22
+ * 默认值与 `dir` 相同
23
23
  */
24
24
  logDir: string;
25
25
  /**
26
- * Glob expressions to get cronjob scripts.
27
- * - Will be passed to fs.glob
26
+ * 用来匹配任务脚本的 glob 表达式
27
+ * - 会原样传给 fs.glob
28
28
  *
29
- * default value is `['**&#47;*.{ts,js,sh}']` (i.e. `**` slash `*.{ts,js,sh}`)
29
+ * 默认值是 `['**&#47;*.{ts,js,sh,cts,mts,cjs,mjs,py}']`(即 `**` 斜杠 `*.{ts,js,sh,cts,mts,cjs,mjs,py}`)
30
30
  */
31
31
  include: string[];
32
32
  /**
33
- * Glob expressions to exclude cronjob scripts.
34
- * - Will be passed to fs.glob as `exclude`
35
- * - Replaces the default entirely (the two arrays are not merged)
36
- * - default value drops node_modules, .git, .vscode, .claude, __pycache__,
37
- * dist, dist-tsc and coverage, each at any depth
33
+ * 排除任务脚本的 glob 表达式
34
+ * - 会作为 `exclude` 传给 fs.glob
35
+ * - 整体替换默认值(两个数组不会合并)
36
+ * - 默认值排除 node_modules、.git、.vscode、.claude、__pycache__、
37
+ * dist、dist-tsc、coverage,任意层级都生效
38
38
  */
39
39
  exclude: string[];
40
40
  /**
41
- * Affects log time and cron parsing.
41
+ * 影响日志时间戳和 cron 解析
42
42
  *
43
- * default value is `"Asia/Shanghai"`
43
+ * 默认值是 `"Asia/Shanghai"`
44
44
  */
45
45
  timezone: string;
46
46
  /**
47
- * The working directory for the running cronjob scripts.
48
- * - Use function to determine dynamic cwd by the script path.
47
+ * 任务进程的工作目录
48
+ * - 传函数可以按脚本路径动态决定
49
49
  *
50
- * default value is the same as `this.dir`
50
+ * 默认值与 `dir` 相同
51
51
  */
52
52
  jobcwd: string | ((scriptPath: string) => string);
53
53
  /**
54
- * Function to write logs.
55
- * @param tag The tag for the log entry.
56
- * @param args The arguments to log.
54
+ * 输出日志的函数
55
+ * @param tag 日志标记
56
+ * @param args 要记录的内容
57
57
  *
58
- * default value writes `<dtm> <tag> <args>` to console
58
+ * 默认值把 `<dtm> <tag> <args>` 写到 console
59
59
  */
60
60
  write: (tag: Tag, ...args: any[]) => void;
61
61
  }
@@ -73,4 +73,10 @@ interface TaskController {
73
73
  * - 同一 dir 只允许一个实例
74
74
  */
75
75
  export declare function cronjob(config?: Partial<UserCronjobConfig>): Promise<TaskController>;
76
+ /**
77
+ * 启动定时任务主理,返回控制器
78
+ * - 只支持 5 段 cron:分 时 日 月 周
79
+ * - 同一 dir 只允许一个实例
80
+ */
81
+ export declare const krontab: typeof cronjob;
76
82
  export type { TaskController, UserCronjobConfig };
package/dist/index.d.mts CHANGED
@@ -14,49 +14,49 @@ declare const enum Tag {
14
14
  }
15
15
  interface UserCronjobConfig {
16
16
  /**
17
- * Will scan this directory for cronjob scripts
17
+ * 扫描任务脚本的目录
18
18
  */
19
19
  dir: string;
20
20
  /**
21
- * Will put log files there.
22
- * - Share the same structure as the cronjob scripts directory
23
- * default value is the same as `this.dir`
21
+ * 任务日志的存放目录
22
+ * - 目录结构与任务脚本目录保持一致
23
+ * 默认值与 `dir` 相同
24
24
  */
25
25
  logDir: string;
26
26
  /**
27
- * Glob expressions to get cronjob scripts.
28
- * - Will be passed to fs.glob
27
+ * 用来匹配任务脚本的 glob 表达式
28
+ * - 会原样传给 fs.glob
29
29
  *
30
- * default value is `['**&#47;*.{ts,js,sh}']` (i.e. `**` slash `*.{ts,js,sh}`)
30
+ * 默认值是 `['**&#47;*.{ts,js,sh,cts,mts,cjs,mjs,py}']`(即 `**` 斜杠 `*.{ts,js,sh,cts,mts,cjs,mjs,py}`)
31
31
  */
32
32
  include: string[];
33
33
  /**
34
- * Glob expressions to exclude cronjob scripts.
35
- * - Will be passed to fs.glob as `exclude`
36
- * - Replaces the default entirely (the two arrays are not merged)
37
- * - default value drops node_modules, .git, .vscode, .claude, __pycache__,
38
- * dist, dist-tsc and coverage, each at any depth
34
+ * 排除任务脚本的 glob 表达式
35
+ * - 会作为 `exclude` 传给 fs.glob
36
+ * - 整体替换默认值(两个数组不会合并)
37
+ * - 默认值排除 node_modules、.git、.vscode、.claude、__pycache__、
38
+ * dist、dist-tsc、coverage,任意层级都生效
39
39
  */
40
40
  exclude: string[];
41
41
  /**
42
- * Affects log time and cron parsing.
42
+ * 影响日志时间戳和 cron 解析
43
43
  *
44
- * default value is `"Asia/Shanghai"`
44
+ * 默认值是 `"Asia/Shanghai"`
45
45
  */
46
46
  timezone: string;
47
47
  /**
48
- * The working directory for the running cronjob scripts.
49
- * - Use function to determine dynamic cwd by the script path.
48
+ * 任务进程的工作目录
49
+ * - 传函数可以按脚本路径动态决定
50
50
  *
51
- * default value is the same as `this.dir`
51
+ * 默认值与 `dir` 相同
52
52
  */
53
53
  jobcwd: string | ((scriptPath: string) => string);
54
54
  /**
55
- * Function to write logs.
56
- * @param tag The tag for the log entry.
57
- * @param args The arguments to log.
55
+ * 输出日志的函数
56
+ * @param tag 日志标记
57
+ * @param args 要记录的内容
58
58
  *
59
- * default value writes `<dtm> <tag> <args>` to console
59
+ * 默认值把 `<dtm> <tag> <args>` 写到 console
60
60
  */
61
61
  write: (tag: Tag, ...args: any[]) => void;
62
62
  }
@@ -74,4 +74,10 @@ interface TaskController {
74
74
  * - 同一 dir 只允许一个实例
75
75
  */
76
76
  export declare function cronjob(config?: Partial<UserCronjobConfig>): Promise<TaskController>;
77
+ /**
78
+ * 启动定时任务主理,返回控制器
79
+ * - 只支持 5 段 cron:分 时 日 月 周
80
+ * - 同一 dir 只允许一个实例
81
+ */
82
+ export declare const krontab: typeof cronjob;
77
83
  export type { TaskController, UserCronjobConfig };