@spooled/sdk 1.0.33 → 1.0.35

package/dist/{index-QIsnz4Bc.d.cts → index-B96n0WUe.d.cts}

@@ -107,11 +107,11 @@ declare const DEFAULT_CONFIG: {
         successThreshold: number;
         timeout: number;
     };
-    readonly userAgent: "@spooled/sdk-nodejs/1.0.33";
+    readonly userAgent: "@spooled/sdk-nodejs/1.0.35";
     readonly autoRefreshToken: true;
 };
 /** SDK version */
-declare const SDK_VERSION = "1.0.33";
+declare const SDK_VERSION = "1.0.35";
 /** API version prefix */
 declare const API_VERSION = "v1";
 /**
@@ -559,7 +559,7 @@ interface Job {
     parentJobId?: string;
     completionWebhook?: string;
     assignedWorkerId?: string;
-    leaseId?: string;
+    leaseId?: string | null;
     leaseExpiresAt?: string;
     idempotencyKey?: string;
     updatedAt: string;
@@ -647,6 +647,13 @@ interface ClaimedJob {
     maxRetries: number;
     timeoutSeconds: number;
     leaseExpiresAt?: string;
+    /**
+     * Lease fencing token for this claim. Echo it back on
+     * complete/fail/heartbeat so the operation applies only to the lease this
+     * worker actually holds (backend rejects stale leases with 409
+     * LEASE_EXPIRED). Omitted = legacy behavior.
+     */
+    leaseId?: string | null;
 }
 /** Parameters for claiming jobs */
 interface ClaimJobsParams {
@@ -669,6 +676,8 @@ interface CompleteJobParams {
     workerId: string;
     /** Optional result payload */
     result?: JsonObject;
+    /** Lease fencing token from the claimed job (rejects stale leases when set) */
+    leaseId?: string;
 }
 /** Parameters for failing a job */
 interface FailJobParams {
@@ -676,6 +685,8 @@ interface FailJobParams {
     workerId: string;
     /** Error message (1-2048 chars) */
     error: string;
+    /** Lease fencing token from the claimed job (rejects stale leases when set) */
+    leaseId?: string;
 }
 /** Parameters for job heartbeat */
 interface HeartbeatJobParams {
@@ -683,6 +694,8 @@ interface HeartbeatJobParams {
     workerId: string;
     /** Lease duration in seconds (5-3600) */
     leaseDurationSecs: number;
+    /** Lease fencing token from the claimed job (rejects stale leases when set) */
+    leaseId?: string;
 }
 /** Response for priority boost */
 interface BoostPriorityResponse {
@@ -2602,6 +2615,12 @@ interface GrpcJob {
     leaseExpiresAt?: GrpcTimestamp | string | null;
     assignedWorkerId?: string | null;
     idempotencyKey?: string | null;
+    /**
+     * Lease fencing token (proto `lease_id`). Returned on dequeue; echo it back
+     * in Complete/Fail/RenewLease so the operation applies only to the lease
+     * this worker actually holds (empty = legacy worker_id fence).
+     */
+    leaseId?: string | null;
 }
 /** Enqueue request */
 interface GrpcEnqueueRequest {
@@ -2637,6 +2656,8 @@ interface GrpcCompleteRequest {
     workerId: string;
     /** Result as object (will be converted to google.protobuf.Struct) */
     result?: Record<string, unknown>;
+    /** Lease fencing token from the dequeued job (proto `lease_id`) */
+    leaseId?: string;
 }
 /** Complete response */
 interface GrpcCompleteResponse {
@@ -2648,6 +2669,8 @@ interface GrpcFailRequest {
     workerId: string;
     error: string;
     retry?: boolean;
+    /** Lease fencing token from the dequeued job (proto `lease_id`) */
+    leaseId?: string;
 }
 /** Fail response */
 interface GrpcFailResponse {
@@ -2660,6 +2683,8 @@ interface GrpcRenewLeaseRequest {
     jobId: string;
     workerId: string;
     extensionSecs: number;
+    /** Lease fencing token from the dequeued job (proto `lease_id`) */
+    leaseId?: string;
 }
 /** Renew lease response */
 interface GrpcRenewLeaseResponse {
@@ -3344,6 +3369,7 @@ interface WorkerEventData {
 }
 /** Active job tracking */
 interface ActiveJob {
+    readonly executionId: symbol;
     job: ClaimedJob;
     startedAt: Date;
     heartbeatTimer?: ReturnType<typeof setInterval>;

package/dist/{index-QIsnz4Bc.d.ts → index-B96n0WUe.d.ts}

@@ -107,11 +107,11 @@ declare const DEFAULT_CONFIG: {
         successThreshold: number;
         timeout: number;
     };
-    readonly userAgent: "@spooled/sdk-nodejs/1.0.33";
+    readonly userAgent: "@spooled/sdk-nodejs/1.0.35";
     readonly autoRefreshToken: true;
 };
 /** SDK version */
-declare const SDK_VERSION = "1.0.33";
+declare const SDK_VERSION = "1.0.35";
 /** API version prefix */
 declare const API_VERSION = "v1";
 /**
@@ -559,7 +559,7 @@ interface Job {
     parentJobId?: string;
     completionWebhook?: string;
     assignedWorkerId?: string;
-    leaseId?: string;
+    leaseId?: string | null;
     leaseExpiresAt?: string;
     idempotencyKey?: string;
     updatedAt: string;
@@ -647,6 +647,13 @@ interface ClaimedJob {
     maxRetries: number;
     timeoutSeconds: number;
     leaseExpiresAt?: string;
+    /**
+     * Lease fencing token for this claim. Echo it back on
+     * complete/fail/heartbeat so the operation applies only to the lease this
+     * worker actually holds (backend rejects stale leases with 409
+     * LEASE_EXPIRED). Omitted = legacy behavior.
+     */
+    leaseId?: string | null;
 }
 /** Parameters for claiming jobs */
 interface ClaimJobsParams {
@@ -669,6 +676,8 @@ interface CompleteJobParams {
     workerId: string;
     /** Optional result payload */
     result?: JsonObject;
+    /** Lease fencing token from the claimed job (rejects stale leases when set) */
+    leaseId?: string;
 }
 /** Parameters for failing a job */
 interface FailJobParams {
@@ -676,6 +685,8 @@ interface FailJobParams {
     workerId: string;
     /** Error message (1-2048 chars) */
     error: string;
+    /** Lease fencing token from the claimed job (rejects stale leases when set) */
+    leaseId?: string;
 }
 /** Parameters for job heartbeat */
 interface HeartbeatJobParams {
@@ -683,6 +694,8 @@ interface HeartbeatJobParams {
     workerId: string;
     /** Lease duration in seconds (5-3600) */
     leaseDurationSecs: number;
+    /** Lease fencing token from the claimed job (rejects stale leases when set) */
+    leaseId?: string;
 }
 /** Response for priority boost */
 interface BoostPriorityResponse {
@@ -2602,6 +2615,12 @@ interface GrpcJob {
     leaseExpiresAt?: GrpcTimestamp | string | null;
     assignedWorkerId?: string | null;
     idempotencyKey?: string | null;
+    /**
+     * Lease fencing token (proto `lease_id`). Returned on dequeue; echo it back
+     * in Complete/Fail/RenewLease so the operation applies only to the lease
+     * this worker actually holds (empty = legacy worker_id fence).
+     */
+    leaseId?: string | null;
 }
 /** Enqueue request */
 interface GrpcEnqueueRequest {
@@ -2637,6 +2656,8 @@ interface GrpcCompleteRequest {
     workerId: string;
     /** Result as object (will be converted to google.protobuf.Struct) */
     result?: Record<string, unknown>;
+    /** Lease fencing token from the dequeued job (proto `lease_id`) */
+    leaseId?: string;
 }
 /** Complete response */
 interface GrpcCompleteResponse {
@@ -2648,6 +2669,8 @@ interface GrpcFailRequest {
     workerId: string;
     error: string;
     retry?: boolean;
+    /** Lease fencing token from the dequeued job (proto `lease_id`) */
+    leaseId?: string;
 }
 /** Fail response */
 interface GrpcFailResponse {
@@ -2660,6 +2683,8 @@ interface GrpcRenewLeaseRequest {
     jobId: string;
     workerId: string;
     extensionSecs: number;
+    /** Lease fencing token from the dequeued job (proto `lease_id`) */
+    leaseId?: string;
 }
 /** Renew lease response */
 interface GrpcRenewLeaseResponse {
@@ -3344,6 +3369,7 @@ interface WorkerEventData {
 }
 /** Active job tracking */
 interface ActiveJob {
+    readonly executionId: symbol;
     job: ClaimedJob;
     startedAt: Date;
     heartbeatTimer?: ReturnType<typeof setInterval>;

package/dist/index.cjs

@@ -49,10 +49,10 @@ var DEFAULT_CONFIG = {
     successThreshold: 3,
     timeout: 3e4
   },
-  userAgent: "@spooled/sdk-nodejs/1.0.33",
+  userAgent: "@spooled/sdk-nodejs/1.0.35",
   autoRefreshToken: true
 };
-var SDK_VERSION = "1.0.33";
+var SDK_VERSION = "1.0.35";
 var API_VERSION = "v1";
 var API_BASE_PATH = `/api/${API_VERSION}`;
 function normalizeCredential(value) {
@@ -3288,7 +3288,7 @@ var SpooledWorker = class {
       ...DEFAULT_OPTIONS,
       hostname: os.hostname(),
       workerType: "nodejs",
-      version: "1.0.26",
+      version: SDK_VERSION,
       metadata: {},
       ...options
     };
@@ -3395,11 +3395,11 @@ var SpooledWorker = class {
         this.waitForActiveJobs(),
         this.sleep(this.options.shutdownTimeout)
       ]);
-      const remaining = Array.from(this.activeJobs.entries());
-      for (const [jobId, active] of remaining) {
-        this.debug(`Force-failing job ${jobId} due to shutdown timeout`);
+      const remaining = Array.from(this.activeJobs.values());
+      for (const active of remaining) {
+        this.debug(`Force-failing job ${active.job.id} due to shutdown timeout`);
         await this.failJob(active.job, "Worker shutdown timeout");
-        this.cleanupJob(jobId);
+        this.cleanupJob(active);
       }
     }
     if (this.workerId) {
@@ -3482,14 +3482,15 @@ var SpooledWorker = class {
     this.emit("job:claimed", { jobId: job.id, queueName: job.queueName });
     const abortController = new AbortController();
     const activeJob = {
+      executionId: Symbol(job.id),
       job,
       startedAt: /* @__PURE__ */ new Date(),
       abortController
     };
-    this.activeJobs.set(job.id, activeJob);
+    this.activeJobs.set(activeJob.executionId, activeJob);
     const heartbeatInterval = this.options.leaseDuration * this.options.heartbeatFraction * 1e3;
     activeJob.heartbeatTimer = setInterval(() => {
-      this.sendJobHeartbeat(job.id);
+      this.sendJobHeartbeat(activeJob);
     }, heartbeatInterval);
     this.executeHandler(activeJob);
   }
@@ -3525,7 +3526,7 @@ var SpooledWorker = class {
       const errorMessage = error instanceof Error ? error.message : String(error);
       await this.failJob(job, errorMessage);
     } finally {
-      this.cleanupJob(job.id);
+      this.cleanupJob(activeJob);
     }
   }
   async completeJob(job, result) {
@@ -3533,7 +3534,8 @@ var SpooledWorker = class {
     try {
       await this.client.jobs.complete(job.id, {
         workerId: this.workerId,
-        result
+        result,
+        ...job.leaseId != null && { leaseId: job.leaseId }
       });
       this.emit("job:completed", {
         jobId: job.id,
@@ -3550,7 +3552,8 @@ var SpooledWorker = class {
     try {
       await this.client.jobs.fail(job.id, {
         workerId: this.workerId,
-        error: errorMessage
+        error: errorMessage,
+        ...job.leaseId != null && { leaseId: job.leaseId }
       });
       this.emit("job:failed", {
         jobId: job.id,
@@ -3562,22 +3565,26 @@ var SpooledWorker = class {
       this.debug(`Failed to fail job ${job.id}`, error);
     }
   }
-  cleanupJob(jobId) {
-    const activeJob = this.activeJobs.get(jobId);
-    if (activeJob?.heartbeatTimer) {
+  cleanupJob(activeJob) {
+    if (activeJob.heartbeatTimer) {
       clearInterval(activeJob.heartbeatTimer);
+      activeJob.heartbeatTimer = void 0;
+    }
+    if (this.activeJobs.get(activeJob.executionId) === activeJob) {
+      this.activeJobs.delete(activeJob.executionId);
     }
-    this.activeJobs.delete(jobId);
   }
-  async sendJobHeartbeat(jobId) {
+  async sendJobHeartbeat(activeJob) {
     if (!this.workerId) return;
+    const { job } = activeJob;
     try {
-      await this.client.jobs.heartbeat(jobId, {
+      await this.client.jobs.heartbeat(job.id, {
         workerId: this.workerId,
-        leaseDurationSecs: this.options.leaseDuration
+        leaseDurationSecs: this.options.leaseDuration,
+        ...job.leaseId != null && { leaseId: job.leaseId }
       });
     } catch (error) {
-      this.debug(`Job heartbeat failed for ${jobId}`, error);
+      this.debug(`Job heartbeat failed for ${job.id}`, error);
     }
   }
   async sendWorkerHeartbeat() {