pg-boss 12.34.0 → 12.35.0

package/dist/schema.json

@@ -1,6 +1,6 @@
 {
     "_generated": "Generated by scripts/gen-manifest.ts — do not edit by hand. Run `npm run gen:manifest`.",
-    "version": 42,
+    "version": 43,
     "schemaToken": "{{schema}}",
     "partitioned": {
         "tables": [
@@ -296,6 +296,13 @@
                 "notNull": false,
                 "default": null
             },
+            {
+                "table": "job_common",
+                "column": "source_output",
+                "type": "jsonb",
+                "notNull": false,
+                "default": null
+            },
             {
                 "table": "job_common",
                 "column": "source_retry_count",
@@ -303,6 +310,13 @@
                 "notNull": false,
                 "default": null
             },
+            {
+                "table": "job_common",
+                "column": "source_root_id",
+                "type": "uuid",
+                "notNull": false,
+                "default": null
+            },
             {
                 "table": "job_common",
                 "column": "start_after",
@@ -555,6 +569,13 @@
                 "notNull": false,
                 "default": null
             },
+            {
+                "table": "job",
+                "column": "source_output",
+                "type": "jsonb",
+                "notNull": false,
+                "default": null
+            },
             {
                 "table": "job",
                 "column": "source_retry_count",
@@ -562,6 +583,13 @@
                 "notNull": false,
                 "default": null
             },
+            {
+                "table": "job",
+                "column": "source_root_id",
+                "type": "uuid",
+                "notNull": false,
+                "default": null
+            },
             {
                 "table": "job",
                 "column": "start_after",
@@ -597,6 +625,20 @@
                 "notNull": true,
                 "default": "now()"
             },
+            {
+                "table": "queue_stats",
+                "column": "completed_delta",
+                "type": "integer",
+                "notNull": false,
+                "default": null
+            },
+            {
+                "table": "queue_stats",
+                "column": "created_delta",
+                "type": "integer",
+                "notNull": false,
+                "default": null
+            },
             {
                 "table": "queue_stats",
                 "column": "deferred_count",
@@ -604,6 +646,20 @@
                 "notNull": true,
                 "default": "0"
             },
+            {
+                "table": "queue_stats",
+                "column": "delta_on",
+                "type": "timestamp with time zone",
+                "notNull": false,
+                "default": null
+            },
+            {
+                "table": "queue_stats",
+                "column": "delta_seconds",
+                "type": "integer",
+                "notNull": false,
+                "default": null
+            },
             {
                 "table": "queue_stats",
                 "column": "failed_count",
@@ -611,6 +667,13 @@
                 "notNull": true,
                 "default": "0"
             },
+            {
+                "table": "queue_stats",
+                "column": "failed_delta",
+                "type": "integer",
+                "notNull": false,
+                "default": null
+            },
             {
                 "table": "queue_stats",
                 "column": "id",
@@ -653,6 +716,20 @@
                 "notNull": true,
                 "default": "0"
             },
+            {
+                "table": "queue",
+                "column": "completed_delta",
+                "type": "integer",
+                "notNull": true,
+                "default": "0"
+            },
+            {
+                "table": "queue",
+                "column": "created_delta",
+                "type": "integer",
+                "notNull": true,
+                "default": "0"
+            },
             {
                 "table": "queue",
                 "column": "created_on",
@@ -681,6 +758,20 @@
                 "notNull": true,
                 "default": null
             },
+            {
+                "table": "queue",
+                "column": "delta_on",
+                "type": "timestamp with time zone",
+                "notNull": false,
+                "default": null
+            },
+            {
+                "table": "queue",
+                "column": "delta_seconds",
+                "type": "integer",
+                "notNull": false,
+                "default": null
+            },
             {
                 "table": "queue",
                 "column": "expire_seconds",
@@ -695,6 +786,13 @@
                 "notNull": true,
                 "default": "0"
             },
+            {
+                "table": "queue",
+                "column": "failed_delta",
+                "type": "integer",
+                "notNull": true,
+                "default": "0"
+            },
             {
                 "table": "queue",
                 "column": "heartbeat_seconds",
@@ -1111,6 +1209,12 @@
                 "valid": true,
                 "def": "CREATE INDEX job_common_i11 ON {{schema}}.job_common USING btree (name, priority DESC, created_on, start_after) WHERE ((state < 'active'::{{schema}}.job_state) AND (NOT blocked))"
             },
+            {
+                "name": "job_common_i12",
+                "table": "job_common",
+                "valid": true,
+                "def": "CREATE INDEX job_common_i12 ON {{schema}}.job_common USING btree (source_root_id) WHERE (source_root_id IS NOT NULL)"
+            },
             {
                 "name": "job_common_i2",
                 "table": "job_common",
@@ -1175,7 +1279,7 @@
         "functions": [
             {
                 "name": "create_queue",
-                "def": "CREATE OR REPLACE FUNCTION {{schema}}.create_queue(queue_name text, options jsonb)\n RETURNS void\n LANGUAGE plpgsql\nAS $function$\n    DECLARE\n      tablename varchar := CASE WHEN options->>'partition' = 'true'\n                            THEN 'j' || encode(sha224(queue_name::bytea), 'hex')\n                            ELSE 'job_common'\n                            END;\n      queue_created_on timestamptz;\n    BEGIN\n\n      WITH q as (\n        INSERT INTO {{schema}}.queue (\n          name,\n          policy,\n          retry_limit,\n          retry_delay,\n          retry_backoff,\n          retry_delay_max,\n          expire_seconds,\n          retention_seconds,\n          deletion_seconds,\n          warning_queued,\n          dead_letter,\n          partition,\n          table_name,\n          heartbeat_seconds,\n          notify,\n          created_on,\n          updated_on\n        )\n        VALUES (\n          queue_name,\n          options->>'policy',\n          COALESCE((options->>'retryLimit')::int, 2),\n          COALESCE((options->>'retryDelay')::int, 0),\n          COALESCE((options->>'retryBackoff')::bool, false),\n          (options->>'retryDelayMax')::int,\n          COALESCE((options->>'expireInSeconds')::int, 900),\n          COALESCE((options->>'retentionSeconds')::int, 1209600),\n          COALESCE((options->>'deleteAfterSeconds')::int, 604800),\n          COALESCE((options->>'warningQueueSize')::int, 0),\n          options->>'deadLetter',\n          COALESCE((options->>'partition')::bool, false),\n          tablename,\n          (options->>'heartbeatSeconds')::int,\n          COALESCE((options->>'notify')::bool, false),\n          {{schema}}.job_now(),\n          {{schema}}.job_now()\n        )\n        ON CONFLICT DO NOTHING\n        RETURNING created_on\n      )\n      SELECT created_on into queue_created_on from q;\n\n      IF queue_created_on IS NULL OR options->>'partition' IS DISTINCT FROM 'true' THEN\n        RETURN;\n      END IF;\n\n      EXECUTE format('CREATE TABLE {{schema}}.%I (LIKE {{schema}}.job INCLUDING DEFAULTS)', tablename);\n\n      EXECUTE {{schema}}.job_table_format($cmd$ALTER TABLE {{schema}}.job ADD PRIMARY KEY (name, id)$cmd$, tablename);\n      EXECUTE {{schema}}.job_table_format($cmd$ALTER TABLE {{schema}}.job ADD CONSTRAINT q_fkey FOREIGN KEY (name) REFERENCES {{schema}}.queue (name) ON DELETE RESTRICT DEFERRABLE INITIALLY DEFERRED$cmd$, tablename);\n      EXECUTE {{schema}}.job_table_format($cmd$ALTER TABLE {{schema}}.job ADD CONSTRAINT dlq_fkey FOREIGN KEY (dead_letter) REFERENCES {{schema}}.queue (name) ON DELETE RESTRICT DEFERRABLE INITIALLY DEFERRED$cmd$, tablename);\n\n      EXECUTE {{schema}}.job_table_format($cmd$CREATE INDEX job_i11 ON {{schema}}.job (name, priority DESC, created_on, start_after) WHERE state < 'active' AND NOT blocked$cmd$, tablename);\n      EXECUTE {{schema}}.job_table_format($cmd$CREATE UNIQUE INDEX job_i4 ON {{schema}}.job (name, singleton_on, COALESCE(singleton_key, '')) WHERE state <> 'cancelled' AND singleton_on IS NOT NULL$cmd$, tablename);\n      EXECUTE {{schema}}.job_table_format($cmd$CREATE INDEX job_i7 ON {{schema}}.job (name, group_id) WHERE state = 'active' AND group_id IS NOT NULL$cmd$, tablename);\n      EXECUTE {{schema}}.job_table_format($cmd$CREATE INDEX job_i9 ON {{schema}}.job (name, id) WHERE blocking AND state = 'completed'$cmd$, tablename);\n\n      IF options->>'policy' = 'short' THEN\n        EXECUTE {{schema}}.job_table_format($cmd$CREATE UNIQUE INDEX job_i1 ON {{schema}}.job (name, COALESCE(singleton_key, '')) WHERE state = 'created' AND policy = 'short'$cmd$, tablename);\n      ELSIF options->>'policy' = 'singleton' THEN\n        EXECUTE {{schema}}.job_table_format($cmd$CREATE UNIQUE INDEX job_i2 ON {{schema}}.job (name, COALESCE(singleton_key, '')) WHERE state = 'active' AND policy = 'singleton'$cmd$, tablename);\n      ELSIF options->>'policy' = 'stately' THEN\n        EXECUTE {{schema}}.job_table_format($cmd$CREATE UNIQUE INDEX job_i3 ON {{schema}}.job (name, state, COALESCE(singleton_key, '')) WHERE state <= 'active' AND policy = 'stately'$cmd$, tablename);\n      ELSIF options->>'policy' = 'exclusive' THEN\n        EXECUTE {{schema}}.job_table_format($cmd$CREATE UNIQUE INDEX job_i6 ON {{schema}}.job (name, COALESCE(singleton_key, '')) WHERE state <= 'active' AND policy = 'exclusive'$cmd$, tablename);\n      ELSIF options->>'policy' = 'key_strict_fifo' THEN\n        EXECUTE {{schema}}.job_table_format($cmd$CREATE UNIQUE INDEX job_i8 ON {{schema}}.job (name, singleton_key) WHERE state IN ('active', 'retry', 'failed') AND policy = 'key_strict_fifo'$cmd$, tablename);\n        EXECUTE {{schema}}.job_table_format($cmd$CREATE INDEX job_i10 ON {{schema}}.job (name, singleton_key, state DESC, created_on, id) INCLUDE (start_after) WHERE state < 'active' AND NOT blocked AND policy = 'key_strict_fifo'$cmd$, tablename);\n        EXECUTE {{schema}}.job_table_format($cmd$ALTER TABLE {{schema}}.job ADD CONSTRAINT job_key_strict_fifo_singleton_key_check CHECK (NOT (policy = 'key_strict_fifo' AND singleton_key IS NULL))$cmd$, tablename);\n      END IF;\n\n      EXECUTE format('ALTER TABLE {{schema}}.%I ADD CONSTRAINT cjc CHECK (name=%L)', tablename, queue_name);\n      EXECUTE format('ALTER TABLE {{schema}}.job ATTACH PARTITION {{schema}}.%I FOR VALUES IN (%L)', tablename, queue_name);\n    END;\n    $function$\n"
+                "def": "CREATE OR REPLACE FUNCTION {{schema}}.create_queue(queue_name text, options jsonb)\n RETURNS void\n LANGUAGE plpgsql\nAS $function$\n    DECLARE\n      tablename varchar := CASE WHEN options->>'partition' = 'true'\n                            THEN 'j' || encode(sha224(queue_name::bytea), 'hex')\n                            ELSE 'job_common'\n                            END;\n      queue_created_on timestamptz;\n    BEGIN\n\n      WITH q as (\n        INSERT INTO {{schema}}.queue (\n          name,\n          policy,\n          retry_limit,\n          retry_delay,\n          retry_backoff,\n          retry_delay_max,\n          expire_seconds,\n          retention_seconds,\n          deletion_seconds,\n          warning_queued,\n          dead_letter,\n          partition,\n          table_name,\n          heartbeat_seconds,\n          notify,\n          created_on,\n          updated_on\n        )\n        VALUES (\n          queue_name,\n          options->>'policy',\n          COALESCE((options->>'retryLimit')::int, 2),\n          COALESCE((options->>'retryDelay')::int, 0),\n          COALESCE((options->>'retryBackoff')::bool, false),\n          (options->>'retryDelayMax')::int,\n          COALESCE((options->>'expireInSeconds')::int, 900),\n          COALESCE((options->>'retentionSeconds')::int, 1209600),\n          COALESCE((options->>'deleteAfterSeconds')::int, 604800),\n          COALESCE((options->>'warningQueueSize')::int, 0),\n          options->>'deadLetter',\n          COALESCE((options->>'partition')::bool, false),\n          tablename,\n          (options->>'heartbeatSeconds')::int,\n          COALESCE((options->>'notify')::bool, false),\n          {{schema}}.job_now(),\n          {{schema}}.job_now()\n        )\n        ON CONFLICT DO NOTHING\n        RETURNING created_on\n      )\n      SELECT created_on into queue_created_on from q;\n\n      IF queue_created_on IS NULL OR options->>'partition' IS DISTINCT FROM 'true' THEN\n        RETURN;\n      END IF;\n\n      EXECUTE format('CREATE TABLE {{schema}}.%I (LIKE {{schema}}.job INCLUDING DEFAULTS)', tablename);\n\n      EXECUTE {{schema}}.job_table_format($cmd$ALTER TABLE {{schema}}.job ADD PRIMARY KEY (name, id)$cmd$, tablename);\n      EXECUTE {{schema}}.job_table_format($cmd$ALTER TABLE {{schema}}.job ADD CONSTRAINT q_fkey FOREIGN KEY (name) REFERENCES {{schema}}.queue (name) ON DELETE RESTRICT DEFERRABLE INITIALLY DEFERRED$cmd$, tablename);\n      EXECUTE {{schema}}.job_table_format($cmd$ALTER TABLE {{schema}}.job ADD CONSTRAINT dlq_fkey FOREIGN KEY (dead_letter) REFERENCES {{schema}}.queue (name) ON DELETE RESTRICT DEFERRABLE INITIALLY DEFERRED$cmd$, tablename);\n\n      EXECUTE {{schema}}.job_table_format($cmd$CREATE INDEX job_i11 ON {{schema}}.job (name, priority DESC, created_on, start_after) WHERE state < 'active' AND NOT blocked$cmd$, tablename);\n      EXECUTE {{schema}}.job_table_format($cmd$CREATE UNIQUE INDEX job_i4 ON {{schema}}.job (name, singleton_on, COALESCE(singleton_key, '')) WHERE state <> 'cancelled' AND singleton_on IS NOT NULL$cmd$, tablename);\n      EXECUTE {{schema}}.job_table_format($cmd$CREATE INDEX job_i7 ON {{schema}}.job (name, group_id) WHERE state = 'active' AND group_id IS NOT NULL$cmd$, tablename);\n      EXECUTE {{schema}}.job_table_format($cmd$CREATE INDEX job_i9 ON {{schema}}.job (name, id) WHERE blocking AND state = 'completed'$cmd$, tablename);\n      EXECUTE {{schema}}.job_table_format($cmd$CREATE INDEX job_i12 ON {{schema}}.job (source_root_id) WHERE source_root_id IS NOT NULL$cmd$, tablename);\n\n      IF options->>'policy' = 'short' THEN\n        EXECUTE {{schema}}.job_table_format($cmd$CREATE UNIQUE INDEX job_i1 ON {{schema}}.job (name, COALESCE(singleton_key, '')) WHERE state = 'created' AND policy = 'short'$cmd$, tablename);\n      ELSIF options->>'policy' = 'singleton' THEN\n        EXECUTE {{schema}}.job_table_format($cmd$CREATE UNIQUE INDEX job_i2 ON {{schema}}.job (name, COALESCE(singleton_key, '')) WHERE state = 'active' AND policy = 'singleton'$cmd$, tablename);\n      ELSIF options->>'policy' = 'stately' THEN\n        EXECUTE {{schema}}.job_table_format($cmd$CREATE UNIQUE INDEX job_i3 ON {{schema}}.job (name, state, COALESCE(singleton_key, '')) WHERE state <= 'active' AND policy = 'stately'$cmd$, tablename);\n      ELSIF options->>'policy' = 'exclusive' THEN\n        EXECUTE {{schema}}.job_table_format($cmd$CREATE UNIQUE INDEX job_i6 ON {{schema}}.job (name, COALESCE(singleton_key, '')) WHERE state <= 'active' AND policy = 'exclusive'$cmd$, tablename);\n      ELSIF options->>'policy' = 'key_strict_fifo' THEN\n        EXECUTE {{schema}}.job_table_format($cmd$CREATE UNIQUE INDEX job_i8 ON {{schema}}.job (name, singleton_key) WHERE state IN ('active', 'retry', 'failed') AND policy = 'key_strict_fifo'$cmd$, tablename);\n        EXECUTE {{schema}}.job_table_format($cmd$CREATE INDEX job_i10 ON {{schema}}.job (name, singleton_key, state DESC, created_on, id) INCLUDE (start_after) WHERE state < 'active' AND NOT blocked AND policy = 'key_strict_fifo'$cmd$, tablename);\n        EXECUTE {{schema}}.job_table_format($cmd$ALTER TABLE {{schema}}.job ADD CONSTRAINT job_key_strict_fifo_singleton_key_check CHECK (NOT (policy = 'key_strict_fifo' AND singleton_key IS NULL))$cmd$, tablename);\n      END IF;\n\n      EXECUTE format('ALTER TABLE {{schema}}.%I ADD CONSTRAINT cjc CHECK (name=%L)', tablename, queue_name);\n      EXECUTE format('ALTER TABLE {{schema}}.job ATTACH PARTITION {{schema}}.%I FOR VALUES IN (%L)', tablename, queue_name);\n    END;\n    $function$\n"
             },
             {
                 "name": "delete_queue",
@@ -1528,6 +1632,13 @@
                 "notNull": false,
                 "default": null
             },
+            {
+                "table": "job",
+                "column": "source_output",
+                "type": "jsonb",
+                "notNull": false,
+                "default": null
+            },
             {
                 "table": "job",
                 "column": "source_retry_count",
@@ -1535,6 +1646,13 @@
                 "notNull": false,
                 "default": null
             },
+            {
+                "table": "job",
+                "column": "source_root_id",
+                "type": "uuid",
+                "notNull": false,
+                "default": null
+            },
             {
                 "table": "job",
                 "column": "start_after",
@@ -1570,6 +1688,20 @@
                 "notNull": true,
                 "default": "now()"
             },
+            {
+                "table": "queue_stats",
+                "column": "completed_delta",
+                "type": "integer",
+                "notNull": false,
+                "default": null
+            },
+            {
+                "table": "queue_stats",
+                "column": "created_delta",
+                "type": "integer",
+                "notNull": false,
+                "default": null
+            },
             {
                 "table": "queue_stats",
                 "column": "deferred_count",
@@ -1577,6 +1709,20 @@
                 "notNull": true,
                 "default": "0"
             },
+            {
+                "table": "queue_stats",
+                "column": "delta_on",
+                "type": "timestamp with time zone",
+                "notNull": false,
+                "default": null
+            },
+            {
+                "table": "queue_stats",
+                "column": "delta_seconds",
+                "type": "integer",
+                "notNull": false,
+                "default": null
+            },
             {
                 "table": "queue_stats",
                 "column": "failed_count",
@@ -1584,6 +1730,13 @@
                 "notNull": true,
                 "default": "0"
             },
+            {
+                "table": "queue_stats",
+                "column": "failed_delta",
+                "type": "integer",
+                "notNull": false,
+                "default": null
+            },
             {
                 "table": "queue_stats",
                 "column": "id",
@@ -1626,6 +1779,20 @@
                 "notNull": true,
                 "default": "0"
             },
+            {
+                "table": "queue",
+                "column": "completed_delta",
+                "type": "integer",
+                "notNull": true,
+                "default": "0"
+            },
+            {
+                "table": "queue",
+                "column": "created_delta",
+                "type": "integer",
+                "notNull": true,
+                "default": "0"
+            },
             {
                 "table": "queue",
                 "column": "created_on",
@@ -1654,6 +1821,20 @@
                 "notNull": true,
                 "default": null
             },
+            {
+                "table": "queue",
+                "column": "delta_on",
+                "type": "timestamp with time zone",
+                "notNull": false,
+                "default": null
+            },
+            {
+                "table": "queue",
+                "column": "delta_seconds",
+                "type": "integer",
+                "notNull": false,
+                "default": null
+            },
             {
                 "table": "queue",
                 "column": "expire_seconds",
@@ -1668,6 +1849,13 @@
                 "notNull": true,
                 "default": "0"
             },
+            {
+                "table": "queue",
+                "column": "failed_delta",
+                "type": "integer",
+                "notNull": true,
+                "default": "0"
+            },
             {
                 "table": "queue",
                 "column": "heartbeat_seconds",
@@ -2086,6 +2274,12 @@
                 "valid": true,
                 "def": "CREATE INDEX job_i11 ON {{schema}}.job USING btree (name, priority DESC, created_on, start_after) WHERE ((state < 'active'::{{schema}}.job_state) AND (NOT blocked))"
             },
+            {
+                "name": "job_i12",
+                "table": "job",
+                "valid": true,
+                "def": "CREATE INDEX job_i12 ON {{schema}}.job USING btree (source_root_id) WHERE (source_root_id IS NOT NULL)"
+            },
             {
                 "name": "job_i2",
                 "table": "job",

package/dist/timekeeper.d.ts

@@ -13,7 +13,7 @@ declare class Timekeeper extends EventEmitter implements types.EventsMixin {
     private stopped;
     private cronMonitorTimer;
     private skewMonitorTimer;
-    private timekeeping;
+    private _timekeeping;
     private _checkingSkew;
     private warnedSchedules;
     clockSkew: number;
@@ -24,6 +24,7 @@ declare class Timekeeper extends EventEmitter implements types.EventsMixin {
     };
     constructor(db: types.IDatabase, manager: Manager, config: types.ResolvedConstructorOptions);
     get checkingSkew(): boolean;
+    get timekeeping(): boolean;
     private get databaseTime();
     private get warningContext();
     start(): Promise<void>;

package/dist/timekeeper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timekeeper.d.ts","sourceRoot":"","sources":["../src/timekeeper.ts"],"names":[],"mappings":"AAEA,OAAO,YAAY,MAAM,aAAa,CAAA;AAItC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAKvC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAGnC,eAAO,MAAM,MAAM;;CAElB,CAAA;AAwBD,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,OAAO,CAAA;AA8MrC,cAAM,UAAW,SAAQ,YAAa,YAAW,KAAK,CAAC,WAAW;IAChE,EAAE,EAAE,KAAK,CAAC,SAAS,CAAA;IACnB,MAAM,EAAE,KAAK,CAAC,0BAA0B,CAAA;IACxC,OAAO,EAAE,OAAO,CAAA;IAEhB,OAAO,CAAC,OAAO,CAAO;IACtB,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,gBAAgB,CAAqC;IAC7D,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,aAAa,CAAQ;IAS7B,OAAO,CAAC,eAAe,CAAoB;IAE3C,SAAS,SAAI;IACb,MAAM;;;;MAAS;gBAEF,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,0BAA0B;IAQ5F,IAAI,YAAY,IAAK,OAAO,CAE3B;IAMD,OAAO,KAAK,YAAY,GAEvB;IAED,OAAO,KAAK,cAAc,GASzB;IAEK,KAAK;IA4BL,IAAI;IAmCV,OAAO,CAAC,mBAAmB;IAUrB,cAAc;IA8Cd,MAAM;IAgDZ;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;;OAKG;IACG,IAAI,CAAE,WAAW,GAAE,OAAc;IAoIvC,YAAY,CAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,KAAK,CAAC,YAAwC;IAIlG;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,iBAAiB;YAQX,QAAQ;YAsDR,aAAa;IAerB,YAAY,CAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAiBrE,WAAW,CAAE,IAAI,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IAe1E;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,KAAK,CAAC,sBAA2B,GAAG,IAAI,EAAE;IA0C5E,QAAQ,CAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,GAAE,KAAK,CAAC,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CzG,UAAU,CAAE,IAAI,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;CAIzD;AAED,eAAe,UAAU,CAAA"}
+{"version":3,"file":"timekeeper.d.ts","sourceRoot":"","sources":["../src/timekeeper.ts"],"names":[],"mappings":"AAEA,OAAO,YAAY,MAAM,aAAa,CAAA;AAItC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAKvC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAGnC,eAAO,MAAM,MAAM;;CAElB,CAAA;AAwBD,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,OAAO,CAAA;AA8MrC,cAAM,UAAW,SAAQ,YAAa,YAAW,KAAK,CAAC,WAAW;IAChE,EAAE,EAAE,KAAK,CAAC,SAAS,CAAA;IACnB,MAAM,EAAE,KAAK,CAAC,0BAA0B,CAAA;IACxC,OAAO,EAAE,OAAO,CAAA;IAEhB,OAAO,CAAC,OAAO,CAAO;IACtB,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,gBAAgB,CAAqC;IAC7D,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,aAAa,CAAQ;IAS7B,OAAO,CAAC,eAAe,CAAoB;IAE3C,SAAS,SAAI;IACb,MAAM;;;;MAAS;gBAEF,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,0BAA0B;IAQ5F,IAAI,YAAY,IAAK,OAAO,CAE3B;IAED,IAAI,WAAW,IAAK,OAAO,CAE1B;IAMD,OAAO,KAAK,YAAY,GAEvB;IAED,OAAO,KAAK,cAAc,GASzB;IAEK,KAAK;IA4BL,IAAI;IAmCV,OAAO,CAAC,mBAAmB;IAUrB,cAAc;IA8Cd,MAAM;IAuDZ;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;;OAKG;IACG,IAAI,CAAE,WAAW,GAAE,OAAc;IAoIvC,YAAY,CAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,KAAK,CAAC,YAAwC;IAIlG;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,iBAAiB;YAQX,QAAQ;YAsDR,aAAa;IAerB,YAAY,CAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAiBrE,WAAW,CAAE,IAAI,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IAe1E;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,KAAK,CAAC,sBAA2B,GAAG,IAAI,EAAE;IA0C5E,QAAQ,CAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,GAAE,KAAK,CAAC,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CzG,UAAU,CAAE,IAAI,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;CAIzD;AAED,eAAe,UAAU,CAAA"}

package/dist/timekeeper.js

@@ -197,13 +197,13 @@ class Timekeeper extends EventEmitter {
     stopped = true;
     cronMonitorTimer;
     skewMonitorTimer;
-    timekeeping;
+    _timekeeping;
     _checkingSkew = false;
     // Rows already warned about, keyed on (name, key, cron, timezone). Unlike every other warning
     // type, an unusable schedule never heals on its own: clock skew converges, a backlog drains, a
     // slow query is a one-off, but a bad row sits there until a human edits it. Warning every pass
-    // would persist a row every cronMonitorIntervalSeconds forever, and warningRetentionDays has no
-    // default, so a single typo could grow the warning table without bound. Rebuilt each pass from
+    // would persist a row every cronMonitorIntervalSeconds for as long as it stayed broken, a year's
+    // worth under the default warningRetentionDays from a single typo. Rebuilt each pass from
     // the rows still broken, so a fixed or deleted schedule drops out and would warn again if it
     // came back.
     warnedSchedules = new Set();
@@ -218,6 +218,9 @@ class Timekeeper extends EventEmitter {
     get checkingSkew() {
         return this._checkingSkew;
     }
+    get timekeeping() {
+        return !!this._timekeeping;
+    }
     // The instance's reading of the database clock. previewSchedule() promises the reference point the
     // cron pass evaluates against, so both read it here rather than each repeating the arithmetic.
     // Zero skew until cacheClockSkew() has run, which start() only reaches when the instance was
@@ -271,7 +274,7 @@ class Timekeeper extends EventEmitter {
             this.cronMonitorTimer.stop();
             this.cronMonitorTimer = null;
         }
-        while (this.timekeeping || this._checkingSkew) {
+        while (this._timekeeping || this._checkingSkew) {
             await delay(10);
         }
     }
@@ -330,13 +333,19 @@ class Timekeeper extends EventEmitter {
         }
     }
     async onCron() {
+        // Outside the try: the pass that is running owns the flag, and finally runs for every path
+        // through it, so an attempt that skips inside would clear the flag that pass is holding and let
+        // stop() return while it is still going. Same shape as Bam.#onPoll and cacheClockSkew above.
+        if (this.stopped || this._timekeeping)
+            return;
+        this._timekeeping = true;
         try {
-            if (this.stopped || this.timekeeping)
-                return;
             if (this.config.__test__force_cron_monitoring_error) {
                 throw new Error(this.config.__test__force_cron_monitoring_error);
             }
-            this.timekeeping = true;
+            if (this.config.__test__delay_cron_ms) {
+                await delay(this.config.__test__delay_cron_ms);
+            }
             const sql = plans.trySetCronTime(this.config.schema, this.config.cronMonitorIntervalSeconds);
             if (!this.stopped) {
                 const { rows } = await this.db.executeSql(sql);
@@ -370,7 +379,7 @@ class Timekeeper extends EventEmitter {
             this.emit(this.events.error, err);
         }
         finally {
-            this.timekeeping = false;
+            this._timekeeping = false;
         }
     }
     /**