@spooled/sdk 1.0.39 → 1.1.0

package/dist/index.cjs

@@ -50,10 +50,10 @@ var DEFAULT_CONFIG = {
     successThreshold: 3,
     timeout: 3e4
   },
-  userAgent: "@spooled/sdk-nodejs/1.0.39",
+  userAgent: "@spooled/sdk-nodejs/1.1.0",
   autoRefreshToken: true
 };
-var SDK_VERSION = "1.0.39";
+var SDK_VERSION = "1.1.0";
 var API_VERSION = "v1";
 var API_BASE_PATH = `/api/${API_VERSION}`;
 function normalizeCredential(value) {
@@ -379,13 +379,31 @@ async function createErrorFromResponse(response) {
       return new PayloadTooLargeError(message, code, details, requestId);
     case 429: {
       const rateLimitInfo = parseRateLimitHeaders(response.headers);
-      return new RateLimitError(message, code, rateLimitInfo, details, requestId);
+      return new RateLimitError(
+        message,
+        code,
+        rateLimitInfo,
+        details,
+        requestId
+      );
     }
     default:
       if (response.status >= 500) {
-        return new ServerError(message, response.status, code, details, requestId);
+        return new ServerError(
+          message,
+          response.status,
+          code,
+          details,
+          requestId
+        );
       }
-      return new SpooledError(message, response.status, code, details, requestId);
+      return new SpooledError(
+        message,
+        response.status,
+        code,
+        details,
+        requestId
+      );
   }
 }
 function isSpooledError(error) {
@@ -643,7 +661,9 @@ var HttpClient = class {
       if (externalSignal.aborted) {
         controller.abort();
       } else {
-        externalSignal.addEventListener("abort", () => controller.abort(), { once: true });
+        externalSignal.addEventListener("abort", () => controller.abort(), {
+          once: true
+        });
       }
     }
     const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
@@ -658,7 +678,10 @@ var HttpClient = class {
         if (externalSignal?.aborted) {
           throw error;
         }
-        throw new TimeoutError(`Request timed out after ${timeoutMs}ms`, timeoutMs);
+        throw new TimeoutError(
+          `Request timed out after ${timeoutMs}ms`,
+          timeoutMs
+        );
       }
       throw error;
     } finally {
@@ -687,13 +710,21 @@ var HttpClient = class {
     this.debug?.(`${method} ${url}`, { timeout, hasBody: !!options.body });
     let response;
     try {
-      response = await this.fetchWithTimeout(url, init, timeout, options.signal);
+      response = await this.fetchWithTimeout(
+        url,
+        init,
+        timeout,
+        options.signal
+      );
     } catch (error) {
       if (error instanceof TimeoutError || error instanceof SpooledError) {
         throw error;
       }
       const cause = error instanceof Error ? error : void 0;
-      throw new NetworkError(`Network request failed: ${cause?.message ?? "Unknown error"}`, cause);
+      throw new NetworkError(
+        `Network request failed: ${cause?.message ?? "Unknown error"}`,
+        cause
+      );
     }
     this.debug?.(`Response: ${response.status}`, { url });
     if (!response.ok) {
@@ -740,7 +771,9 @@ var HttpClient = class {
     const url = this.buildUrl(path, options.params, options.skipApiPrefix);
     const method = options.method ?? "GET";
     const execute = async () => {
-      return this.circuitBreaker.execute(() => this.executeRequest(url, options));
+      return this.circuitBreaker.execute(
+        () => this.executeRequest(url, options)
+      );
     };
     if (options.skipRetry) {
       return execute();
@@ -749,7 +782,9 @@ var HttpClient = class {
       config: this.resolveRetryConfig(method, options),
       signal: options.signal,
       onRetry: (attempt, error, delayMs) => {
-        this.debug?.(`Retry attempt ${attempt} after ${delayMs}ms`, { error: error.message });
+        this.debug?.(`Retry attempt ${attempt} after ${delayMs}ms`, {
+          error: error.message
+        });
       }
     });
   }
@@ -761,7 +796,9 @@ var HttpClient = class {
     if (!options.headers) {
       return false;
     }
-    return Object.keys(options.headers).some((key) => key.toLowerCase() === "idempotency-key");
+    return Object.keys(options.headers).some(
+      (key) => key.toLowerCase() === "idempotency-key"
+    );
   }
   /**
    * Resolve the retry configuration for a request.
@@ -799,28 +836,43 @@ var HttpClient = class {
    * Make a POST request
    */
   async post(path, body, options) {
-    const response = await this.request(path, { ...options, method: "POST", body });
+    const response = await this.request(path, {
+      ...options,
+      method: "POST",
+      body
+    });
     return response.data;
   }
   /**
    * Make a PUT request
    */
   async put(path, body, options) {
-    const response = await this.request(path, { ...options, method: "PUT", body });
+    const response = await this.request(path, {
+      ...options,
+      method: "PUT",
+      body
+    });
     return response.data;
   }
   /**
    * Make a PATCH request
    */
   async patch(path, body, options) {
-    const response = await this.request(path, { ...options, method: "PATCH", body });
+    const response = await this.request(path, {
+      ...options,
+      method: "PATCH",
+      body
+    });
     return response.data;
   }
   /**
    * Make a DELETE request
    */
   async delete(path, options) {
-    const response = await this.request(path, { ...options, method: "DELETE" });
+    const response = await this.request(path, {
+      ...options,
+      method: "DELETE"
+    });
     return response.data;
   }
 };
@@ -1014,7 +1066,10 @@ var AuthResource = class {
    */
   async logout(refreshToken) {
     const token = refreshToken ?? this.getRefreshToken?.();
-    await this.http.post("/auth/logout", token ? { refreshToken: token } : void 0);
+    await this.http.post(
+      "/auth/logout",
+      token ? { refreshToken: token } : void 0
+    );
   }
   /**
    * Get current user/session info
@@ -1032,7 +1087,10 @@ var AuthResource = class {
    * Start email-based login flow (sends magic link)
    */
   async startEmailLogin(email) {
-    return this.http.post("/auth/email/start", { email });
+    return this.http.post(
+      "/auth/email/start",
+      { email }
+    );
   }
   /**
    * Check if an email address exists in the system
@@ -1073,7 +1131,9 @@ var JobsResource = class {
    * List jobs with optional filtering
    */
   async list(params) {
-    return this.http.get("/jobs", { params });
+    return this.http.get("/jobs", {
+      params
+    });
   }
   /**
    * Get a job by ID
@@ -1097,7 +1157,9 @@ var JobsResource = class {
    * Boost job priority
    */
   async boostPriority(id, priority) {
-    return this.http.put(`/jobs/${id}/priority`, { priority });
+    return this.http.put(`/jobs/${id}/priority`, {
+      priority
+    });
   }
   /**
    * Get job statistics
@@ -1142,17 +1204,25 @@ var JobsResource = class {
    * Fail a job (worker nack)
    */
   async fail(id, params) {
-    return this.http.post(`/jobs/${id}/fail`, params);
+    return this.http.post(
+      `/jobs/${id}/fail`,
+      params
+    );
   }
   /**
    * Extend job lease (heartbeat)
    */
   async heartbeat(id, params) {
-    return this.http.post(`/jobs/${id}/heartbeat`, params);
+    return this.http.post(
+      `/jobs/${id}/heartbeat`,
+      params
+    );
   }
   // DLQ operations (private implementations)
   async listDlq(params) {
-    return this.http.get("/jobs/dlq", { params });
+    return this.http.get("/jobs/dlq", {
+      params
+    });
   }
   async retryDlq(params) {
     return this.http.post("/jobs/dlq/retry", params);
@@ -1183,13 +1253,18 @@ var QueuesResource = class {
    * Update queue configuration
    */
   async updateConfig(name, params) {
-    return this.http.put(`/queues/${encodeURIComponent(name)}/config`, params);
+    return this.http.put(
+      `/queues/${encodeURIComponent(name)}/config`,
+      params
+    );
   }
   /**
    * Get queue statistics
    */
   async getStats(name) {
-    return this.http.get(`/queues/${encodeURIComponent(name)}/stats`);
+    return this.http.get(
+      `/queues/${encodeURIComponent(name)}/stats`
+    );
   }
   /**
    * Pause a queue
@@ -1204,7 +1279,9 @@ var QueuesResource = class {
    * Resume a paused queue
    */
   async resume(name) {
-    return this.http.post(`/queues/${encodeURIComponent(name)}/resume`);
+    return this.http.post(
+      `/queues/${encodeURIComponent(name)}/resume`
+    );
   }
   /**
    * Delete a queue configuration
@@ -1260,7 +1337,9 @@ var SchedulesResource = class {
    * List all schedules
    */
   async list(params) {
-    return this.http.get("/schedules", { params });
+    return this.http.get("/schedules", {
+      params
+    });
   }
   /**
    * Create a new schedule
@@ -1332,7 +1411,9 @@ var WorkflowsResource = class {
    * List all workflows
    */
   async list(params) {
-    return this.http.get("/workflows", { params });
+    return this.http.get("/workflows", {
+      params
+    });
   }
   /**
    * Create a new workflow
@@ -1369,13 +1450,18 @@ var WorkflowsResource = class {
     return this.http.get(`/workflows/${workflowId}/jobs/${jobId}`);
   }
   async getWorkflowJobsStatus(workflowId) {
-    return this.http.get(`/workflows/${workflowId}/jobs/status`);
+    return this.http.get(
+      `/workflows/${workflowId}/jobs/status`
+    );
   }
   async getJobDependencies(jobId) {
     return this.http.get(`/jobs/${jobId}/dependencies`);
   }
   async addJobDependencies(jobId, params) {
-    return this.http.post(`/jobs/${jobId}/dependencies`, params);
+    return this.http.post(
+      `/jobs/${jobId}/dependencies`,
+      params
+    );
   }
 };
 
@@ -1424,7 +1510,9 @@ var WebhooksResource = class {
    * Get webhook delivery history
    */
   async getDeliveries(id) {
-    return this.http.get(`/outgoing-webhooks/${id}/deliveries`);
+    return this.http.get(
+      `/outgoing-webhooks/${id}/deliveries`
+    );
   }
   /**
    * Retry a specific webhook delivery
@@ -1532,7 +1620,9 @@ var OrganizationsResource = class {
    * Generate a unique slug from an organization name
    */
   async generateSlug(name) {
-    return this.http.post("/organizations/generate-slug", { name });
+    return this.http.post("/organizations/generate-slug", {
+      name
+    });
   }
   /**
    * Get the webhook token for the current organization.
@@ -1562,7 +1652,9 @@ var OrganizationsResource = class {
    * ```
    */
   async regenerateWebhookToken() {
-    return this.http.post("/organizations/webhook-token/regenerate");
+    return this.http.post(
+      "/organizations/webhook-token/regenerate"
+    );
   }
   /**
    * Clear/delete the webhook token for the current organization.
@@ -1599,7 +1691,10 @@ var BillingResource = class {
    * POST /api/v1/billing/portal
    */
   async createPortal(params) {
-    return this.http.post("/billing/portal", params);
+    return this.http.post(
+      "/billing/portal",
+      params
+    );
   }
 };
 
@@ -1694,7 +1789,9 @@ var AdminResource = class {
   }
   headers() {
     if (!this.adminKey) {
-      throw new AuthenticationError("Admin key is required for admin endpoints. Provide `adminKey` in SpooledClient config.");
+      throw new AuthenticationError(
+        "Admin key is required for admin endpoints. Provide `adminKey` in SpooledClient config."
+      );
     }
     return { "X-Admin-Key": this.adminKey };
   }
@@ -1715,15 +1812,22 @@ var AdminResource = class {
   }
   /** POST /api/v1/admin/organizations */
   async createOrganization(params) {
-    return this.http.post("/admin/organizations", params, {
-      headers: this.headers()
-    });
+    return this.http.post(
+      "/admin/organizations",
+      params,
+      {
+        headers: this.headers()
+      }
+    );
   }
   /** GET /api/v1/admin/organizations/{id} */
   async getOrganization(id) {
-    return this.http.get(`/admin/organizations/${id}`, {
-      headers: this.headers()
-    });
+    return this.http.get(
+      `/admin/organizations/${id}`,
+      {
+        headers: this.headers()
+      }
+    );
   }
   /** PATCH /api/v1/admin/organizations/{id} */
   async updateOrganization(id, params) {
@@ -1741,15 +1845,23 @@ var AdminResource = class {
   }
   /** POST /api/v1/admin/organizations/{id}/api-keys */
   async createApiKey(orgId, params) {
-    return this.http.post(`/admin/organizations/${orgId}/api-keys`, params, {
-      headers: this.headers()
-    });
+    return this.http.post(
+      `/admin/organizations/${orgId}/api-keys`,
+      params,
+      {
+        headers: this.headers()
+      }
+    );
   }
   /** POST /api/v1/admin/organizations/{id}/reset-usage */
   async resetUsage(orgId) {
-    await this.http.post(`/admin/organizations/${orgId}/reset-usage`, void 0, {
-      headers: this.headers()
-    });
+    await this.http.post(
+      `/admin/organizations/${orgId}/reset-usage`,
+      void 0,
+      {
+        headers: this.headers()
+      }
+    );
   }
   /** GET /api/v1/admin/stats */
   async getStats() {
@@ -1795,7 +1907,9 @@ var WebhookIngestionResource = class {
     const bytes = toBytes(body);
     const signature = options.signature ?? (options.secret ? githubSignature(options.secret, bytes) : void 0);
     if (!signature) {
-      throw new ValidationError("GitHub webhook signature is required (provide `signature` or `secret`)");
+      throw new ValidationError(
+        "GitHub webhook signature is required (provide `signature` or `secret`)"
+      );
     }
     const headers = {
       "Content-Type": "application/json",
@@ -1826,7 +1940,9 @@ var WebhookIngestionResource = class {
     const timestamp = options.timestamp ?? Math.floor(Date.now() / 1e3);
     const signature = options.signature ?? (options.secret ? stripeSignature(options.secret, bytes, timestamp) : void 0);
     if (!signature) {
-      throw new ValidationError("Stripe webhook signature is required (provide `signature` or `secret`)");
+      throw new ValidationError(
+        "Stripe webhook signature is required (provide `signature` or `secret`)"
+      );
     }
     const headers = {
       "Content-Type": "application/json",
@@ -1963,14 +2079,20 @@ var WebSocketRealtimeClient = class {
           resolve();
         };
         this.ws.onmessage = (event) => {
-          this.handleMessage(typeof event.data === "string" ? event.data : String(event.data));
+          this.handleMessage(
+            typeof event.data === "string" ? event.data : String(event.data)
+          );
         };
         this.ws.onclose = (event) => {
           this.options.debug(`WebSocket closed: ${event.code} ${event.reason}`);
           const wasConnecting = this.state === "connecting";
           this.handleDisconnect();
           if (wasConnecting) {
-            reject(new Error(`WebSocket connection failed: ${event.reason || "Unknown error"}`));
+            reject(
+              new Error(
+                `WebSocket connection failed: ${event.reason || "Unknown error"}`
+              )
+            );
           }
         };
         this.ws.onerror = (event) => {
@@ -2125,7 +2247,9 @@ var WebSocketRealtimeClient = class {
       this.options.maxReconnectDelay
     );
     const delay = Math.floor(baseDelay + Math.random() * baseDelay * 0.25);
-    this.options.debug(`Scheduling reconnect attempt ${this.reconnectAttempts} in ${delay}ms`);
+    this.options.debug(
+      `Scheduling reconnect attempt ${this.reconnectAttempts} in ${delay}ms`
+    );
     this.reconnectTimer = setTimeout(async () => {
       try {
         await this.connect();
@@ -2178,11 +2302,13 @@ function isAuthFailureEvent(event) {
   if (!event) {
     return false;
   }
-  const status = event.status ?? event.statusCode ?? event.error?.status;
-  if (status === 401 || status === 403) {
+  const status2 = event.status ?? event.statusCode ?? event.error?.status;
+  if (status2 === 401 || status2 === 403) {
     return true;
   }
-  const text = String(event.message ?? event.error?.message ?? event.reason ?? "");
+  const text = String(
+    event.message ?? event.error?.message ?? event.reason ?? ""
+  );
   return /\b(401|403)\b/.test(text);
 }
 
@@ -2245,7 +2371,9 @@ var SseRealtimeClient = class {
         EventSourceImpl = mod.default || mod.EventSource || mod;
       } catch {
         this.setState("disconnected");
-        throw new Error("eventsource package is required for SSE in Node.js. Install it with: npm install eventsource");
+        throw new Error(
+          "eventsource package is required for SSE in Node.js. Install it with: npm install eventsource"
+        );
       }
     }
     let token;
@@ -2414,7 +2542,9 @@ var SseRealtimeClient = class {
       this.options.maxReconnectDelay
     );
     const delay = Math.floor(baseDelay + Math.random() * baseDelay * 0.25);
-    this.options.debug(`Scheduling SSE reconnect attempt ${this.reconnectAttempts} in ${delay}ms`);
+    this.options.debug(
+      `Scheduling SSE reconnect attempt ${this.reconnectAttempts} in ${delay}ms`
+    );
     this.reconnectTimer = setTimeout(async () => {
       try {
         await this.connect(this.filter || void 0);
@@ -2590,7 +2720,10 @@ function loadProtoDefinition() {
     return cachedDefinition;
   }
   const protoPath = getProtoPath();
-  const packageDefinition = protoLoader__namespace.loadSync(protoPath, PROTO_LOADER_OPTIONS);
+  const packageDefinition = protoLoader__namespace.loadSync(
+    protoPath,
+    PROTO_LOADER_OPTIONS
+  );
   const grpcObject = grpc2__namespace.loadPackageDefinition(packageDefinition);
   cachedDefinition = grpcObject;
   return cachedDefinition;
@@ -2600,7 +2733,10 @@ async function loadProtoDefinitionAsync() {
     return cachedDefinition;
   }
   const protoPath = getProtoPath();
-  const packageDefinition = await protoLoader__namespace.load(protoPath, PROTO_LOADER_OPTIONS);
+  const packageDefinition = await protoLoader__namespace.load(
+    protoPath,
+    PROTO_LOADER_OPTIONS
+  );
   const grpcObject = grpc2__namespace.loadPackageDefinition(packageDefinition);
   cachedDefinition = grpcObject;
   return cachedDefinition;
@@ -2617,7 +2753,11 @@ async function* asyncIterableFromStream(stream, options) {
       stream.cancel();
     });
   }
-  return yield* new AsyncIterableStream(stream, { onConnected, onError, onEnd });
+  return yield* new AsyncIterableStream(stream, {
+    onConnected,
+    onError,
+    onEnd
+  });
 }
 var AsyncIterableStream = class {
   stream;
@@ -2646,8 +2786,8 @@ var AsyncIterableStream = class {
       onEnd?.();
       resolve?.();
     });
-    this.stream.on("status", (status) => {
-      if (status.code === 0) {
+    this.stream.on("status", (status2) => {
+      if (status2.code === 0) {
         onConnected?.();
       }
     });
@@ -2748,7 +2888,9 @@ function decodeStruct(value) {
     return value;
   }
   const fields = value.fields ?? {};
-  return Object.fromEntries(Object.entries(fields).map(([key, entry]) => [key, decodeValue(entry)]));
+  return Object.fromEntries(
+    Object.entries(fields).map(([key, entry]) => [key, decodeValue(entry)])
+  );
 }
 function decodeValue(value) {
   if ("nullValue" in value) {
@@ -2797,7 +2939,10 @@ function encodeEnqueueRequest(params) {
   return encoded;
 }
 function encodeCompleteRequest(params) {
-  return { ...params, result: encodeStruct(params.result) };
+  return {
+    ...params,
+    result: encodeStruct(params.result)
+  };
 }
 function decodeJob(job) {
   return {
@@ -2806,17 +2951,60 @@ function decodeJob(job) {
     result: decodeStruct(job.result)
   };
 }
-function promisify(client, method, request, metadata) {
+function promisify(client, method, request, metadata, timeoutMs) {
   return new Promise((resolve, reject) => {
-    method.call(client, request, metadata, (error, response) => {
+    const callback = (error, response) => {
       if (error) {
-        reject(error);
+        reject(mapGrpcError(error, timeoutMs));
       } else {
         resolve(response);
       }
-    });
+    };
+    method.call(
+      client,
+      request,
+      metadata,
+      createUnaryCallOptions(timeoutMs),
+      callback
+    );
   });
 }
+function createUnaryCallOptions(timeoutMs) {
+  if (timeoutMs === void 0) {
+    return {};
+  }
+  return { deadline: new Date(Date.now() + timeoutMs) };
+}
+function mapGrpcError(error, timeoutMs) {
+  const message = error.details || error.message || "gRPC request failed";
+  switch (error.code) {
+    case grpc2__namespace.status.DEADLINE_EXCEEDED:
+      return new TimeoutError(message, timeoutMs ?? 0);
+    case grpc2__namespace.status.UNAUTHENTICATED:
+      return new AuthenticationError(message, "AUTHENTICATION_FAILED");
+    case grpc2__namespace.status.PERMISSION_DENIED:
+      return new AuthorizationError(message, "ACCESS_DENIED");
+    case grpc2__namespace.status.NOT_FOUND:
+      return new NotFoundError(message, "NOT_FOUND");
+    case grpc2__namespace.status.INVALID_ARGUMENT:
+    case grpc2__namespace.status.OUT_OF_RANGE:
+      return new ValidationError(message, "VALIDATION_ERROR");
+    case grpc2__namespace.status.ALREADY_EXISTS:
+    case grpc2__namespace.status.ABORTED:
+    case grpc2__namespace.status.FAILED_PRECONDITION:
+      return new ConflictError(message, "CONFLICT");
+    case grpc2__namespace.status.RESOURCE_EXHAUSTED:
+      return new RateLimitError(message, "RATE_LIMIT_EXCEEDED");
+    case grpc2__namespace.status.UNAVAILABLE:
+    case grpc2__namespace.status.CANCELLED:
+      return new NetworkError(message, error);
+    default:
+      if (error.code >= grpc2__namespace.status.INTERNAL) {
+        return new ServerError(message, 500, "GRPC_SERVER_ERROR");
+      }
+      return new ServerError(message, 500, "GRPC_ERROR");
+  }
+}
 function shouldUseTls(address, explicitTls) {
   if (explicitTls !== void 0) {
     return explicitTls;
@@ -2825,53 +3013,99 @@ function shouldUseTls(address, explicitTls) {
   return host !== "localhost" && host !== "127.0.0.1" && !host.startsWith("[::1]");
 }
 var GrpcQueueOperations = class {
-  constructor(client, metadata) {
+  constructor(client, metadata, timeoutMs) {
     this.client = client;
     this.metadata = metadata;
+    this.timeoutMs = timeoutMs;
   }
   /**
    * Enqueue a new job
    */
   async enqueue(params) {
-    return promisify(this.client, this.client.Enqueue, encodeEnqueueRequest(params), this.metadata);
+    return promisify(
+      this.client,
+      this.client.Enqueue,
+      encodeEnqueueRequest(params),
+      this.metadata,
+      this.timeoutMs
+    );
   }
   /**
    * Dequeue a job (for workers)
    */
   async dequeue(params) {
-    const response = await promisify(this.client, this.client.Dequeue, params, this.metadata);
+    const response = await promisify(
+      this.client,
+      this.client.Dequeue,
+      params,
+      this.metadata,
+      this.timeoutMs
+    );
     return { ...response, jobs: response.jobs.map(decodeJob) };
   }
   /**
    * Complete a job successfully
    */
   async complete(params) {
-    return promisify(this.client, this.client.Complete, encodeCompleteRequest(params), this.metadata);
+    return promisify(
+      this.client,
+      this.client.Complete,
+      encodeCompleteRequest(params),
+      this.metadata,
+      this.timeoutMs
+    );
   }
   /**
    * Fail a job
    */
   async fail(params) {
-    return promisify(this.client, this.client.Fail, params, this.metadata);
+    return promisify(
+      this.client,
+      this.client.Fail,
+      params,
+      this.metadata,
+      this.timeoutMs
+    );
   }
   /**
    * Renew a job's lease
    */
   async renewLease(params) {
-    return promisify(this.client, this.client.RenewLease, params, this.metadata);
+    return promisify(
+      this.client,
+      this.client.RenewLease,
+      params,
+      this.metadata,
+      this.timeoutMs
+    );
   }
   /**
    * Get a job by ID
    */
   async getJob(jobId) {
-    const response = await promisify(this.client, this.client.GetJob, { jobId }, this.metadata);
-    return { ...response, job: response.job ? decodeJob(response.job) : response.job };
+    const response = await promisify(
+      this.client,
+      this.client.GetJob,
+      { jobId },
+      this.metadata,
+      this.timeoutMs
+    );
+    return {
+      ...response,
+      job: response.job ? decodeJob(response.job) : response.job
+    };
   }
   /**
    * Get queue statistics
    */
   async getQueueStats(queueName) {
-    return promisify(this.client, this.client.GetQueueStats, { queueName }, this.metadata);
+    return promisify(
+      this.client,
+      this.client.GetQueueStats,
+      { queueName },
+      this.metadata,
+      this.timeoutMs
+    );
   }
   /**
    * Stream jobs from a queue (server-side streaming)
@@ -2919,27 +3153,46 @@ var GrpcQueueOperations = class {
   }
 };
 var GrpcWorkerOperations = class {
-  constructor(client, metadata) {
+  constructor(client, metadata, timeoutMs) {
     this.client = client;
     this.metadata = metadata;
+    this.timeoutMs = timeoutMs;
   }
   /**
    * Register a new worker
    */
   async register(params) {
-    return promisify(this.client, this.client.Register, params, this.metadata);
+    return promisify(
+      this.client,
+      this.client.Register,
+      params,
+      this.metadata,
+      this.timeoutMs
+    );
   }
   /**
    * Send heartbeat
    */
   async heartbeat(params) {
-    return promisify(this.client, this.client.Heartbeat, params, this.metadata);
+    return promisify(
+      this.client,
+      this.client.Heartbeat,
+      params,
+      this.metadata,
+      this.timeoutMs
+    );
   }
   /**
    * Deregister a worker
    */
   async deregister(workerId) {
-    return promisify(this.client, this.client.Deregister, { workerId }, this.metadata);
+    return promisify(
+      this.client,
+      this.client.Deregister,
+      { workerId },
+      this.metadata,
+      this.timeoutMs
+    );
   }
 };
 var SpooledGrpcClient = class {
@@ -2951,7 +3204,7 @@ var SpooledGrpcClient = class {
   /** Worker operations */
   workers;
   constructor(options) {
-    const { address, apiKey, useTls, credentials: credentials2, channelOptions } = options;
+    const { address, apiKey, useTls, credentials: credentials2, channelOptions, timeout } = options;
     const creds = credentials2 ?? (shouldUseTls(address, useTls) ? grpc2__namespace.credentials.createSsl() : grpc2__namespace.credentials.createInsecure());
     this.metadata = new grpc2__namespace.Metadata();
     this.metadata.add("x-api-key", apiKey);
@@ -2966,8 +3219,16 @@ var SpooledGrpcClient = class {
       creds,
       channelOptions
     );
-    this.queue = new GrpcQueueOperations(this.queueClient, this.metadata);
-    this.workers = new GrpcWorkerOperations(this.workerClient, this.metadata);
+    this.queue = new GrpcQueueOperations(
+      this.queueClient,
+      this.metadata,
+      timeout
+    );
+    this.workers = new GrpcWorkerOperations(
+      this.workerClient,
+      this.metadata,
+      timeout
+    );
   }
   /**
    * Close all gRPC connections
@@ -3116,7 +3377,8 @@ var SpooledClient = class _SpooledClient {
       }
       this._grpc = new SpooledGrpcClient({
         address: grpcAddress,
-        apiKey
+        apiKey,
+        timeout: this.config.timeout
       });
     }
     return this._grpc;
@@ -3183,7 +3445,9 @@ var SpooledClient = class _SpooledClient {
       }
       return this.loginForJwt();
     }
-    throw new AuthenticationError("No authentication method available for realtime connection");
+    throw new AuthenticationError(
+      "No authentication method available for realtime connection"
+    );
   }
   /**
    * Exchange the API key for a JWT via /auth/login and cache the result.
@@ -3397,6 +3661,11 @@ var DEFAULT_OPTIONS = {
 };
 var SpooledWorker = class {
   client;
+  /**
+   * Options with every defaultable field filled in. `workerId` stays optional:
+   * there is no sensible default for it, and omitting it is what makes the
+   * server mint a UUID.
+   */
   options;
   debug;
   state = "idle";
@@ -3467,6 +3736,7 @@ var SpooledWorker = class {
     try {
       const registration = await this.client.workers.register({
         queueName: this.options.queueName,
+        workerId: this.options.workerId,
         hostname: this.options.hostname,
         workerType: this.options.workerType,
         maxConcurrency: this.options.concurrency,
@@ -3480,7 +3750,10 @@ var SpooledWorker = class {
         this.sendWorkerHeartbeat();
       }, heartbeatInterval);
       this.state = "running";
-      this.emit("started", { workerId: this.workerId, queueName: this.options.queueName });
+      this.emit("started", {
+        workerId: this.workerId,
+        queueName: this.options.queueName
+      });
       this.schedulePoll();
     } catch (error) {
       this.state = "error";
@@ -3516,14 +3789,18 @@ var SpooledWorker = class {
       active.abortController.abort();
     }
     if (this.activeJobs.size > 0) {
-      this.debug(`Waiting for ${this.activeJobs.size} active jobs to complete...`);
+      this.debug(
+        `Waiting for ${this.activeJobs.size} active jobs to complete...`
+      );
       await Promise.race([
         this.waitForActiveJobs(),
         this.sleep(this.options.shutdownTimeout)
       ]);
       const remaining = Array.from(this.activeJobs.values());
       for (const active of remaining) {
-        this.debug(`Force-failing job ${active.job.id} due to shutdown timeout`);
+        this.debug(
+          `Force-failing job ${active.job.id} due to shutdown timeout`
+        );
         await this.failJob(active.job, "Worker shutdown timeout");
         this.cleanupJob(active);
       }
@@ -3631,7 +3908,9 @@ var SpooledWorker = class {
       retryCount: job.retryCount,
       maxRetries: job.maxRetries,
       signal,
-      progress: async (_percent, _message) => {
+      progress: async (percent, message) => {
+        const boundedPercent = Math.max(0, Math.min(100, percent));
+        this.debug(`[${job.id}] progress ${boundedPercent}%`, message);
       },
       log: (level, message, meta) => {
         this.debug(`[${job.id}] [${level}] ${message}`, meta);