@molecule/api-scheduler-cloudflare 1.0.2 → 1.0.3

package/dist/index.d.ts

@@ -10,34 +10,31 @@
  * change — only the bond wired in `bonds/`.
  *
  * @example
- * ```ts
- * // bonds/scheduler-cloudflare.ts
- * import { bond } from '@molecule/api-bond'
+ * ```typescript
+ * import { schedule, setProvider, start } from '@molecule/api-scheduler'
  * import { createProvider } from '@molecule/api-scheduler-cloudflare'
  *
- * export const scheduler = createProvider()
- * export function setupSchedulerCloudflare(): void {
- *   bond('scheduler', scheduler)
- * }
- * ```
- *
- * ```ts
- * // worker.ts — the Cron Trigger entry point
- * import { scheduler } from './bonds/scheduler-cloudflare.js'
- * import { setupBonds } from './bonds/index.js'
+ * const scheduler = createProvider()
+ * setProvider(scheduler)
  *
- * export default {
- *   async scheduled(_event, _env, ctx) {
- *     await setupBonds()          // registers tasks via schedule() + start()
- *     ctx.waitUntil(scheduler.runDueTasks())
+ * schedule({
+ *   name: 'monitor-sweep',
+ *   intervalMs: 60000,
+ *   async handler() {
+ *     // ...
  *   },
- * }
- * ```
+ * })
+ *
+ * // REQUIRED, same as the default provider: nothing runs until start().
+ * // Unlike it, start() begins no timers — a Worker has no process to hold one.
+ * start()
  *
- * ```toml
- * # wrangler.toml
- * [triggers]
- * crons = ["*/1 * * * *"]   # the trigger schedule IS the schedule
+ * // Then, from the Worker's scheduled() handler, wrapped in ctx.waitUntil():
+ * //   export default { async scheduled(event, env, ctx) {
+ * //     ctx.waitUntil(scheduler.runDueTasks())
+ * //   } }
+ * // and in wrangler.toml:  [triggers] crons = ["* * * * *"]
+ * void scheduler.runDueTasks()
  * ```
  *
  * @remarks

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -10,34 +10,31 @@
  * change — only the bond wired in `bonds/`.
  *
  * @example
- * ```ts
- * // bonds/scheduler-cloudflare.ts
- * import { bond } from '@molecule/api-bond'
+ * ```typescript
+ * import { schedule, setProvider, start } from '@molecule/api-scheduler'
  * import { createProvider } from '@molecule/api-scheduler-cloudflare'
  *
- * export const scheduler = createProvider()
- * export function setupSchedulerCloudflare(): void {
- *   bond('scheduler', scheduler)
- * }
- * ```
- *
- * ```ts
- * // worker.ts — the Cron Trigger entry point
- * import { scheduler } from './bonds/scheduler-cloudflare.js'
- * import { setupBonds } from './bonds/index.js'
+ * const scheduler = createProvider()
+ * setProvider(scheduler)
  *
- * export default {
- *   async scheduled(_event, _env, ctx) {
- *     await setupBonds()          // registers tasks via schedule() + start()
- *     ctx.waitUntil(scheduler.runDueTasks())
+ * schedule({
+ *   name: 'monitor-sweep',
+ *   intervalMs: 60000,
+ *   async handler() {
+ *     // ...
  *   },
- * }
- * ```
+ * })
+ *
+ * // REQUIRED, same as the default provider: nothing runs until start().
+ * // Unlike it, start() begins no timers — a Worker has no process to hold one.
+ * start()
  *
- * ```toml
- * # wrangler.toml
- * [triggers]
- * crons = ["*/1 * * * *"]   # the trigger schedule IS the schedule
+ * // Then, from the Worker's scheduled() handler, wrapped in ctx.waitUntil():
+ * //   export default { async scheduled(event, env, ctx) {
+ * //     ctx.waitUntil(scheduler.runDueTasks())
+ * //   } }
+ * // and in wrangler.toml:  [triggers] crons = ["* * * * *"]
+ * void scheduler.runDueTasks()
  * ```
  *
  * @remarks

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@molecule/api-scheduler-cloudflare",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Scheduler provider for Cloudflare Workers Cron Triggers — the platform owns the clock, so tasks run from the scheduled() handler instead of an in-process timer.",
+  "homepage": "https://www.molecule.dev/packages/api-scheduler-cloudflare",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -32,11 +33,11 @@
     "directory": "packages/api/bonds/scheduler/cloudflare"
   },
   "devDependencies": {
-    "@molecule/api-bond": "1.0.1",
-    "@molecule/api-scheduler": "1.0.1",
+    "@molecule/api-bond": "1.0.2",
+    "@molecule/api-scheduler": "1.0.2",
     "@types/node": "26.1.2",
     "typescript": "6.0.3",
-    "vitest": "4.1.10"
+    "vitest": "4.1.11"
   },
   "peerDependencies": {
     "@molecule/api-scheduler": "^1.0.1",