{"_id":"@buujs/sati-croner","name":"@buujs/sati-croner","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@buujs/sati-croner","version":"0.1.0","license":"MIT","author":{"name":"Forte Zhuo"},"repository":{"type":"git","url":"git+https://github.com/buu-js/sati.git"},"type":"module","main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./package.json":"./package.json"},"scripts":{"dev":"tsdx dev","build":"tsdx build","test":"vitest run","test:watch":"vitest","lint":"tsdx lint","format":"tsdx format","format:check":"tsdx format --check","typecheck":"tsdx typecheck","prepublishOnly":"pnpm run build"},"devDependencies":{"@buujs/sati-utils":"workspace:*"},"peerDependencies":{"@buujs/sati":"workspace:*","croner":"^10.0.1"},"engines":{"node":">=20"},"gitHead":"16ea81bc26f304e3bcec91c4f609c07626c326cc","_id":"@buujs/sati-croner@0.1.0","description":"A seamless, type-safe cron scheduling integration extension for the Buu SATI ecosystem, powered by `croner`.","bugs":{"url":"https://github.com/buu-js/sati/issues"},"homepage":"https://github.com/buu-js/sati#readme","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-LwtcyCQNnNRwF7JJEcjIXnszwR9p1KvKdTXrKAzEyhhrIPwnoiowYvCvqo2q+S2xbdJ0J9UJxGz6K9wl7rqC5Q==","shasum":"8d3022c91b5411f04e81501430da4d456d973e6c","tarball":"https://registry.npmjs.org/@buujs/sati-croner/-/sati-croner-0.1.0.tgz","fileCount":8,"unpackedSize":6728,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGQ0jbwHFbH18PoXozvJYtv4lVL8TZuX07tyhpbmOCZPAiAs6Mps1RLOa5EyCEL8WbsQaNy7ERxPpfJdjYzw0cj16Q=="}]},"_npmUser":{"name":"forte.zhuo","email":"forte.zhuo@gmail.com"},"directories":{},"maintainers":[{"name":"forte.zhuo","email":"forte.zhuo@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sati-croner_0.1.0_1784087174338_0.030545960144577666"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-15T03:46:14.058Z","0.1.0":"2026-07-15T03:46:14.478Z","modified":"2026-07-15T03:46:14.743Z"},"maintainers":[{"name":"forte.zhuo","email":"forte.zhuo@gmail.com"}],"description":"A seamless, type-safe cron scheduling integration extension for the Buu SATI ecosystem, powered by `croner`.","homepage":"https://github.com/buu-js/sati#readme","repository":{"type":"git","url":"git+https://github.com/buu-js/sati.git"},"author":{"name":"Forte Zhuo"},"bugs":{"url":"https://github.com/buu-js/sati/issues"},"license":"MIT","readme":"# 👻 Buu SATI Croner (`@buujs/sati-croner`)\nA seamless, type-safe cron scheduling integration extension for the Buu SATI ecosystem, powered by `croner`.\n\nEffortlessly manage cron tasks with automatic lifecycle orchestration, graceful shutdown termination hooks, structured runtime execution logging, and fluent control methods.\n\n---\n\n## Features\n\n* ⏰ **Engineered with Croner**: Built on top of the robust `croner` engine to manage execution patterns cleanly.\n* 🛡️ **Auto Graceful Unregistration**: Integrates directly into your application lifecycle, ensuring tasks unregister automatically during process shutdowns.\n* 📝 **Contextual Logger Monitoring**: Features comprehensive automated logging for operations, warnings on re-registrations, and caught runtime failures.\n* 🎛️ **Fluent Task Control**: Supports chaining API syntax with runtime methods to programmatically `trigger()` or `stop()` scheduled instances on demand.\n\n---\n\n## Installation\n\n```sh\npnpm add @buujs/sati-croner croner\n```\n\n--\n\n## Usage\n\n```sh\nimport { createScheduler } from \"@buujs/sati-croner\";\n\n// 1. Initialize the scheduler factory with core dependencies\nconst scheduler = createScheduler({ \n  logger, \n  gracefulShutdown \n});\n\n// 2. Register, chain, and orchestrate jobs smoothly\nscheduler.register(\n  { \n    name: \"analytics-rollup\", \n    cronTime: \"0 */2 * * *\" // Every 2 hours\n  }, \n  async () => {\n    // Perform recurring background execution tasks\n    console.log(\"Compiling cluster metrics...\");\n  }\n);\n\n// 3. Trigger or stop jobs manually when necessary\nscheduler.trigger();\n```","readmeFilename":"README.md","_rev":"1-a7217d5a846b1904d34f1e9e22dae69c"}