@spooled/sdk 1.0.33 → 1.0.34

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

@@ -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;
 }
 /** 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;
 }
 /** 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 {

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

@@ -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;
 }
 /** 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;
 }
 /** 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 {

package/dist/index.cjs

@@ -3288,7 +3288,7 @@ var SpooledWorker = class {
       ...DEFAULT_OPTIONS,
       hostname: os.hostname(),
       workerType: "nodejs",
-      version: "1.0.26",
+      version: "1.0.34",
       metadata: {},
       ...options
     };
@@ -3533,7 +3533,8 @@ var SpooledWorker = class {
     try {
       await this.client.jobs.complete(job.id, {
         workerId: this.workerId,
-        result
+        result,
+        ...job.leaseId !== void 0 && { leaseId: job.leaseId }
       });
       this.emit("job:completed", {
         jobId: job.id,
@@ -3550,7 +3551,8 @@ var SpooledWorker = class {
     try {
       await this.client.jobs.fail(job.id, {
         workerId: this.workerId,
-        error: errorMessage
+        error: errorMessage,
+        ...job.leaseId !== void 0 && { leaseId: job.leaseId }
       });
       this.emit("job:failed", {
         jobId: job.id,
@@ -3571,10 +3573,12 @@ var SpooledWorker = class {
   }
   async sendJobHeartbeat(jobId) {
     if (!this.workerId) return;
+    const leaseId = this.activeJobs.get(jobId)?.job.leaseId;
     try {
       await this.client.jobs.heartbeat(jobId, {
         workerId: this.workerId,
-        leaseDurationSecs: this.options.leaseDuration
+        leaseDurationSecs: this.options.leaseDuration,
+        ...leaseId !== void 0 && { leaseId }
       });
     } catch (error) {
       this.debug(`Job heartbeat failed for ${jobId}`, error);