feat: add isExpired method to Job class

src/job/index.ts

@@ -236,6 +236,10 @@ class Job<T extends JobAttributesData = JobAttributesData> {
     return this.bindMethod('isRunning', isRunning);
   }
 
+  get isExpired(): IsExpiredMethod {
+    return this.bindMethod('isExpired', isExpired);
+  }
+
   get save(): SaveMethod {
     return this.bindMethod('save', save);
   }

src/job/is-expired.ts

@@ -0,0 +1,16 @@
+import { Job } from '.';
+
+export type IsExpiredMethod = (useRealStatus?: boolean) => boolean;
+export const isExpired: IsExpiredMethod = function (this: Job, useRealStatus = false) {
+  if (useRealStatus) {
+    this.fetchStatus();
+  }
+  const definition = this.pulse._definitions[this.attrs.name];
+
+  const lockDeadline = new Date(Date.now() - definition.lockLifetime);
+
+  if (this.attrs.lockedAt && this.attrs.lockedAt < lockDeadline) {
+    return true;
+  }
+  return false;
+};