@spooled/sdk 1.2.1 → 1.3.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { R as RealtimeConnectionOptions, C as ConnectionState, S as SubscriptionFilter, a as RealtimeEventType, b as RealtimeEvent, c as RetryConfig } from './index-CWVI9LRo.cjs';
-export { A as API_VERSION, d as AddDependenciesParams, e as AddDependenciesResponse, f as AdminApiKeyResponse, g as AdminCreateApiKeyParams, h as AdminCreateOrganizationParams, i as AdminCreateOrganizationResponse, j as AdminDeleteOrganizationParams, k as AdminListOrganizationsParams, l as AdminOrganizationDetail, m as AdminOrganizationList, n as AdminOrganizationSummary, o as AdminPlanLimits, p as AdminPlatformStats, q as AdminResource, r as AdminUpdateOrganizationParams, s as AdminUsageStats, t as ApiKeySummary, u as ApiKeysResource, v as AuthResource, B as BatchJobStatus, w as BillingResource, x as BillingStatus, y as BoostPriorityResponse, z as BulkEnqueueParams, D as BulkEnqueueResponse, E as BulkJobItem, F as CheckEmailResponse, G as CheckSlugResponse, H as CircuitBreaker, I as CircuitBreakerConfig, J as CircuitState, K as ClaimJobsParams, L as ClaimJobsResult, M as ClaimedJob, N as CompleteJobParams, O as CreateApiKeyParams, P as CreateApiKeyResponse, Q as CreateBillingPortalParams, T as CreateBillingPortalResponse, U as CreateJobParams, V as CreateJobResult, W as CreateOrganizationParams, X as CreateOrganizationResponse, Y as CreateOutgoingWebhookParams, Z as CreateScheduleParams, _ as CreateScheduleResponse, $ as CreateWorkflowParams, a0 as CreateWorkflowResponse, a1 as CurrentUserResponse, a2 as DEFAULT_CONFIG, a3 as DashboardData, a4 as DashboardResource, a5 as DashboardWorkerSummary, a6 as DebugFn, a7 as DependencyInfo, a8 as DependencyMode, a9 as FailJobParams, aa as GrpcClientOptions, ab as GrpcCompleteJobParams, ac as GrpcCompleteJobResponse, ad as GrpcCompleteRequest, ae as GrpcCompleteResponse, af as GrpcDequeueJobParams, ag as GrpcDequeueJobResponse, ah as GrpcDequeueRequest, ai as GrpcDequeueResponse, aj as GrpcDeregisterRequest, ak as GrpcDeregisterResponse, al as GrpcEnqueueJobParams, am as GrpcEnqueueJobResponse, an as GrpcEnqueueRequest, ao as GrpcEnqueueResponse, ap as GrpcErrorResponse, aq as GrpcFailJobParams, ar as GrpcFailJobResponse, as as GrpcFailRequest, at as GrpcFailResponse, au as GrpcGetJobRequest, av as GrpcGetJobResponse, aw as GrpcGetQueueStatsRequest, ax as GrpcGetQueueStatsResponse, ay as GrpcGetQueueStatsResponse_Legacy, az as GrpcHeartbeatParams, aA as GrpcHeartbeatRequest, aB as GrpcHeartbeatResponse, aC as GrpcHeartbeatResponse_Legacy, aD as GrpcJob, aE as GrpcJobStatus, aF as GrpcJobStatusNumber, aG as GrpcProcessRequest, aH as GrpcProcessResponse, aI as GrpcQueueOperations, aJ as GrpcRegisterWorkerParams, aK as GrpcRegisterWorkerRequest, aL as GrpcRegisterWorkerResponse, aM as GrpcRegisterWorkerResponse_Legacy, aN as GrpcRenewLeaseParams, aO as GrpcRenewLeaseRequest, aP as GrpcRenewLeaseResponse, aQ as GrpcRenewLeaseResponse_Legacy, aR as GrpcStreamJobsRequest, aS as GrpcTimestamp, aT as GrpcWorkerOperations, aU as HealthResource, aV as HealthResponse, aW as HeartbeatEvent, aX as HeartbeatJobParams, aY as HttpClient, aZ as IngestCustomWebhookParams, a_ as IngestCustomWebhookResponse, a$ as IngestGitHubWebhookOptions, b0 as IngestStripeWebhookOptions, b1 as InitialApiKey, b2 as Job, b3 as JobCompletedEvent, b4 as JobContext, b5 as JobCreatedEvent, b6 as JobFailedEvent, b7 as JobHandler, b8 as JobProgressEvent, b9 as JobResult, ba as JobStartedEvent, bb as JobStats, bc as JobStatus, bd as JobStatusChangedEvent, be as JobStream, bf as JobSummary, bg as JobSummaryStats, bh as JobWithDependencies, bi as JobsResource, bj as JsonArray, bk as JsonObject, bl as JsonPrimitive, bm as JsonValue, bn as ListDlqParams, bo as ListJobsParams, bp as ListParams, bq as ListSchedulesParams, br as ListWorkflowsParams, bs as LoginParams, bt as LoginResponse, bu as MetricsResource, bv as Organization, bw as OrganizationMember, bx as OrganizationSummary, by as OrganizationUsage, bz as OrganizationsResource, bA as OutgoingWebhook, bB as OutgoingWebhookDelivery, bC as PaginatedResponse, bD as PaginationParams, bE as PauseQueueResponse, bF as PlanCount, bG as PlanLimits, bH as PlanTier, bI as ProcessJobsStream, bJ as PurgeDlqParams, bK as PurgeDlqResponse, bL as QueueConfig, bM as QueueConfigSummary, bN as QueuePausedEvent, bO as QueueResumedEvent, bP as QueueStats, bQ as QueueSummary, bR as QueuesResource, bS as RealtimeEventData, bT as RecentActivity, bU as RefreshTokenParams, bV as RefreshTokenResponse, bW as RegisterWorkerParams, bX as RegisterWorkerResponse, bY as ResolvedConfig, bZ as ResourceUsage, b_ as ResumeQueueResponse, b$ as RetryDlqParams, c0 as RetryDlqResponse, c1 as SDK_VERSION, c2 as Schedule, c3 as ScheduleRun, c4 as ScheduleRunStatus, c5 as ScheduleTriggeredEvent, c6 as SchedulesResource, c7 as SpooledClient, c8 as SpooledClientConfig, c9 as SpooledGrpcClient, ca as SpooledRealtime, cb as SpooledRealtimeOptions, cc as SpooledWorker, cd as SpooledWorkerOptions, ce as StartEmailLoginResponse, cf as StreamOptions, cg as SystemInfo, ch as TestWebhookResponse, ci as TokenClaims, cj as TriggerScheduleResponse, ck as UpdateApiKeyParams, cl as UpdateOrganizationParams, cm as UpdateOutgoingWebhookParams, cn as UpdateQueueConfigParams, co as UpdateScheduleParams, cp as UsageItem, cq as UsageWarning, cr as ValidateTokenParams, cs as ValidateTokenResponse, ct as WebhookDeliveryStatus, cu as WebhookEventType, cv as WebhookIngestionResource, cw as WebhookTokenResponse, cx as WebhooksResource, cy as Worker, cz as WorkerDeregisteredEvent, cA as WorkerEvent, cB as WorkerEventData, cC as WorkerHeartbeatParams, cD as WorkerRegisteredEvent, cE as WorkerState, cF as WorkerStatus, cG as WorkerSummary, cH as WorkersResource, cI as Workflow, cJ as WorkflowJob, cK as WorkflowJobDefinition, cL as WorkflowJobStatus, cM as WorkflowResponse, cN as WorkflowStatus, cO as WorkflowsResource, cP as asyncIterableFromStream, cQ as createCircuitBreaker, cR as createClient, cS as createHttpClient, cT as createJobStream, cU as createPaginatedResponse, cV as createProcessJobsStream, cW as dateToTimestamp, cX as resolveConfig, cY as timestampToDate, cZ as validateConfig } from './index-CWVI9LRo.cjs';
+import { R as RealtimeConnectionOptions, C as ConnectionState, S as SubscriptionFilter, a as RealtimeEventType, b as RealtimeEvent, c as RetryConfig } from './index-BVWKEr6p.cjs';
+export { A as API_VERSION, d as AddDependenciesParams, e as AddDependenciesResponse, f as AdminApiKeyResponse, g as AdminCreateApiKeyParams, h as AdminCreateOrganizationParams, i as AdminCreateOrganizationResponse, j as AdminDeleteOrganizationParams, k as AdminListOrganizationsParams, l as AdminOrganizationDetail, m as AdminOrganizationList, n as AdminOrganizationSummary, o as AdminPlanLimits, p as AdminPlatformStats, q as AdminResource, r as AdminUpdateOrganizationParams, s as AdminUsageStats, t as ApiKeySummary, u as ApiKeysResource, v as AuthResource, B as BatchJobStatus, w as BillingResource, x as BillingStatus, y as BoostPriorityResponse, z as BulkEnqueueParams, D as BulkEnqueueResponse, E as BulkJobItem, F as CheckEmailResponse, G as CheckSlugResponse, H as CircuitBreaker, I as CircuitBreakerConfig, J as CircuitState, K as ClaimJobsParams, L as ClaimJobsResult, M as ClaimedJob, N as CompleteJobParams, O as CreateApiKeyParams, P as CreateApiKeyResponse, Q as CreateBillingPortalParams, T as CreateBillingPortalResponse, U as CreateJobParams, V as CreateJobResult, W as CreateOrganizationParams, X as CreateOrganizationResponse, Y as CreateOutgoingWebhookParams, Z as CreateScheduleParams, _ as CreateScheduleResponse, $ as CreateWorkflowParams, a0 as CreateWorkflowResponse, a1 as CurrentUserResponse, a2 as DEFAULT_CONFIG, a3 as DashboardData, a4 as DashboardResource, a5 as DashboardWorkerSummary, a6 as DebugFn, a7 as DeleteQueueOptions, a8 as DependencyInfo, a9 as DependencyMode, aa as FailJobParams, ab as GrpcClientOptions, ac as GrpcCompleteJobParams, ad as GrpcCompleteJobResponse, ae as GrpcCompleteRequest, af as GrpcCompleteResponse, ag as GrpcDequeueJobParams, ah as GrpcDequeueJobResponse, ai as GrpcDequeueRequest, aj as GrpcDequeueResponse, ak as GrpcDeregisterRequest, al as GrpcDeregisterResponse, am as GrpcEnqueueJobParams, an as GrpcEnqueueJobResponse, ao as GrpcEnqueueRequest, ap as GrpcEnqueueResponse, aq as GrpcErrorResponse, ar as GrpcFailJobParams, as as GrpcFailJobResponse, at as GrpcFailRequest, au as GrpcFailResponse, av as GrpcGetJobRequest, aw as GrpcGetJobResponse, ax as GrpcGetQueueStatsRequest, ay as GrpcGetQueueStatsResponse, az as GrpcGetQueueStatsResponse_Legacy, aA as GrpcHeartbeatParams, aB as GrpcHeartbeatRequest, aC as GrpcHeartbeatResponse, aD as GrpcHeartbeatResponse_Legacy, aE as GrpcJob, aF as GrpcJobStatus, aG as GrpcJobStatusNumber, aH as GrpcProcessRequest, aI as GrpcProcessResponse, aJ as GrpcQueueOperations, aK as GrpcRegisterWorkerParams, aL as GrpcRegisterWorkerRequest, aM as GrpcRegisterWorkerResponse, aN as GrpcRegisterWorkerResponse_Legacy, aO as GrpcRenewLeaseParams, aP as GrpcRenewLeaseRequest, aQ as GrpcRenewLeaseResponse, aR as GrpcRenewLeaseResponse_Legacy, aS as GrpcStreamJobsRequest, aT as GrpcTimestamp, aU as GrpcWorkerOperations, aV as HealthResource, aW as HealthResponse, aX as HeartbeatEvent, aY as HeartbeatJobParams, aZ as HttpClient, a_ as IngestCustomWebhookParams, a$ as IngestCustomWebhookResponse, b0 as IngestGitHubWebhookOptions, b1 as IngestStripeWebhookOptions, b2 as InitialApiKey, b3 as Job, b4 as JobCompletedEvent, b5 as JobContext, b6 as JobCreatedEvent, b7 as JobFailedEvent, b8 as JobHandler, b9 as JobProgressEvent, ba as JobResult, bb as JobStartedEvent, bc as JobStats, bd as JobStatus, be as JobStatusChangedEvent, bf as JobStream, bg as JobSummary, bh as JobSummaryStats, bi as JobWithDependencies, bj as JobsResource, bk as JsonArray, bl as JsonObject, bm as JsonPrimitive, bn as JsonValue, bo as ListDlqParams, bp as ListJobsParams, bq as ListParams, br as ListSchedulesParams, bs as ListWorkflowsParams, bt as LoginParams, bu as LoginResponse, bv as MetricsResource, bw as Organization, bx as OrganizationMember, by as OrganizationSummary, bz as OrganizationUsage, bA as OrganizationsResource, bB as OutgoingWebhook, bC as OutgoingWebhookDelivery, bD as PaginatedResponse, bE as PaginationParams, bF as PauseQueueResponse, bG as PlanCount, bH as PlanLimits, bI as PlanTier, bJ as ProcessJobsStream, bK as PurgeDlqParams, bL as PurgeDlqResponse, bM as QueueConfig, bN as QueueConfigSummary, bO as QueuePausedEvent, bP as QueueResumedEvent, bQ as QueueStats, bR as QueueSummary, bS as QueuesResource, bT as RealtimeEventData, bU as RecentActivity, bV as RefreshTokenParams, bW as RefreshTokenResponse, bX as RegisterWorkerParams, bY as RegisterWorkerResponse, bZ as ResolvedConfig, b_ as ResourceUsage, b$ as ResumeQueueResponse, c0 as RetryDlqParams, c1 as RetryDlqResponse, c2 as SDK_VERSION, c3 as Schedule, c4 as ScheduleRun, c5 as ScheduleRunStatus, c6 as ScheduleTriggeredEvent, c7 as SchedulesResource, c8 as SpooledClient, c9 as SpooledClientConfig, ca as SpooledGrpcClient, cb as SpooledRealtime, cc as SpooledRealtimeOptions, cd as SpooledWorker, ce as SpooledWorkerOptions, cf as StartEmailLoginResponse, cg as StreamOptions, ch as SystemInfo, ci as TestWebhookResponse, cj as TokenClaims, ck as TriggerScheduleResponse, cl as UpdateApiKeyParams, cm as UpdateOrganizationParams, cn as UpdateOutgoingWebhookParams, co as UpdateQueueConfigParams, cp as UpdateScheduleParams, cq as UsageItem, cr as UsageWarning, cs as ValidateTokenParams, ct as ValidateTokenResponse, cu as WebhookDeliveryStatus, cv as WebhookEventType, cw as WebhookIngestionResource, cx as WebhookTokenResponse, cy as WebhooksResource, cz as Worker, cA as WorkerDeregisteredEvent, cB as WorkerEvent, cC as WorkerEventData, cD as WorkerHeartbeatParams, cE as WorkerRegisteredEvent, cF as WorkerState, cG as WorkerStatus, cH as WorkerSummary, cI as WorkersResource, cJ as Workflow, cK as WorkflowJob, cL as WorkflowJobDefinition, cM as WorkflowJobStatus, cN as WorkflowResponse, cO as WorkflowStatus, cP as WorkflowsResource, cQ as asyncIterableFromStream, cR as createCircuitBreaker, cS as createClient, cT as createHttpClient, cU as createJobStream, cV as createPaginatedResponse, cW as createProcessJobsStream, cX as dateToTimestamp, cY as resolveConfig, cZ as timestampToDate, c_ as validateConfig } from './index-BVWKEr6p.cjs';
 import * as protoLoader from '@grpc/proto-loader';
 import { ServiceClientConstructor } from '@grpc/grpc-js';
 
@@ -122,6 +122,12 @@ declare class SseRealtimeClient {
     private reconnectAttempts;
     private reconnectTimer;
     private filter;
+    /** When the current connection opened (for the stable-connection check). */
+    private connectedAt;
+    /** The server finished this stream on purpose (terminal job); do not reconnect. */
+    private streamEnded;
+    /** The server rejected our token; mint a fresh one for the next connect. */
+    private forceTokenRefresh;
     private eventHandlers;
     private allEventsHandlers;
     private stateChangeHandlers;
@@ -202,7 +208,13 @@ declare class SpooledError extends Error {
     /** Original cause of the error */
     readonly cause?: Error;
     constructor(message: string, statusCode?: number, code?: string, details?: Record<string, unknown>, requestId?: string, cause?: Error);
-    /** Whether this error is retryable */
+    /**
+     * Whether this error is retryable.
+     *
+     * Only 408 (Request Timeout) is retryable among the plain 4xx statuses: the
+     * server gave up waiting for the request, so it never ran. Subclasses
+     * override this (5xx, network, timeout, rate limit).
+     */
     isRetryable(): boolean;
     /** Convert to plain object for logging */
     toJSON(): Record<string, unknown>;
@@ -236,11 +248,15 @@ declare class ConflictError extends SpooledError {
     constructor(message?: string, code?: string, details?: Record<string, unknown>, requestId?: string);
 }
 /**
- * Validation error (400)
- * Thrown when request validation fails
+ * Validation error (400 or 422)
+ * Thrown when request validation fails.
+ *
+ * The API answers a field-rule failure (length, range) with 400 but a missing
+ * or mistyped JSON field with 422; both are the caller's request being invalid,
+ * so both surface as this class. `statusCode` tells them apart.
  */
 declare class ValidationError extends SpooledError {
-    constructor(message?: string, code?: string, details?: Record<string, unknown>, requestId?: string);
+    constructor(message?: string, code?: string, details?: Record<string, unknown>, requestId?: string, statusCode?: 400 | 422);
 }
 /**
  * Payload too large error (413)
@@ -251,12 +267,26 @@ declare class PayloadTooLargeError extends SpooledError {
 }
 /**
  * Rate limit error (429)
- * Thrown when rate limit is exceeded
+ * Thrown when rate limit is exceeded, or a plan quota is (see `isQuota`)
  */
 declare class RateLimitError extends SpooledError {
     /** Rate limit information */
     readonly rateLimitInfo: RateLimitInfo;
     constructor(message?: string, code?: string, rateLimitInfo?: RateLimitInfo, details?: Record<string, unknown>, requestId?: string);
+    /**
+     * True when this 429 is a plan quota or limit (daily job cap, active jobs,
+     * queue/worker/webhook caps) rather than per-second rate limiting.
+     *
+     * A quota does not clear for minutes or hours, so retrying it only blocks the
+     * caller for the whole backoff and, via the circuit breaker, takes every
+     * other call on the client down with it. It is never retried and never
+     * counted as a circuit breaker failure.
+     *
+     * Detection: the `QUOTA_EXCEEDED` code, or, for older plan-limit paths that
+     * answer with plain text wrapped as `RATE_LIMIT_EXCEEDED`, a "... limit
+     * reached" message that carries no `Retry-After`.
+     */
+    get isQuota(): boolean;
     isRetryable(): boolean;
     /** Get the number of seconds to wait before retrying */
     getRetryAfter(): number;
@@ -296,6 +326,17 @@ declare class CircuitBreakerOpenError extends SpooledError {
     constructor(message?: string);
     isRetryable(): boolean;
 }
+/**
+ * Unsupported operation error
+ * Thrown by SDK methods whose route the Spooled API does not provide (or
+ * always rejects). It is raised before any network call, so code that still
+ * calls such a method fails loudly with an explanation instead of a 404.
+ */
+declare class UnsupportedOperationError extends SpooledError {
+    /** The SDK method that is not supported, e.g. `ingest.github` */
+    readonly operation: string;
+    constructor(operation: string, reason: string);
+}
 /**
  * Parse rate limit headers from a Response
  */
@@ -456,4 +497,4 @@ declare function convertResponse<T>(body: T): T;
  */
 declare function convertQueryParams(params: Record<string, string | number | boolean | undefined>): Record<string, string>;
 
-export { type ApiErrorBody, AuthenticationError, AuthorizationError, CircuitBreakerOpenError, ConflictError, ConnectionState, NetworkError, NotFoundError, PROTO_LOADER_OPTIONS, PayloadTooLargeError, RateLimitError, type RateLimitInfo, RealtimeConnectionOptions, RealtimeEvent, RealtimeEventType, RetryConfig, ServerError, SpooledError, type SpooledProtoDefinition, SseRealtimeClient, SubscriptionFilter, TimeoutError, ValidationError, WebSocketRealtimeClient, calculateDelay, camelToSnake, clearProtoCache, convertQueryParams, convertRequest, convertResponse, createErrorFromResponse, createRetryWrapper, getProtoPath, isRetryableError, isSpooledError, loadProtoDefinition, loadProtoDefinitionAsync, parseRateLimitHeaders, shouldRetry, sleep, snakeToCamel, toCamelCase, toSnakeCase, withRetry };
+export { type ApiErrorBody, AuthenticationError, AuthorizationError, CircuitBreakerOpenError, ConflictError, ConnectionState, NetworkError, NotFoundError, PROTO_LOADER_OPTIONS, PayloadTooLargeError, RateLimitError, type RateLimitInfo, RealtimeConnectionOptions, RealtimeEvent, RealtimeEventType, RetryConfig, ServerError, SpooledError, type SpooledProtoDefinition, SseRealtimeClient, SubscriptionFilter, TimeoutError, UnsupportedOperationError, ValidationError, WebSocketRealtimeClient, calculateDelay, camelToSnake, clearProtoCache, convertQueryParams, convertRequest, convertResponse, createErrorFromResponse, createRetryWrapper, getProtoPath, isRetryableError, isSpooledError, loadProtoDefinition, loadProtoDefinitionAsync, parseRateLimitHeaders, shouldRetry, sleep, snakeToCamel, toCamelCase, toSnakeCase, withRetry };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { R as RealtimeConnectionOptions, C as ConnectionState, S as SubscriptionFilter, a as RealtimeEventType, b as RealtimeEvent, c as RetryConfig } from './index-CWVI9LRo.js';
-export { A as API_VERSION, d as AddDependenciesParams, e as AddDependenciesResponse, f as AdminApiKeyResponse, g as AdminCreateApiKeyParams, h as AdminCreateOrganizationParams, i as AdminCreateOrganizationResponse, j as AdminDeleteOrganizationParams, k as AdminListOrganizationsParams, l as AdminOrganizationDetail, m as AdminOrganizationList, n as AdminOrganizationSummary, o as AdminPlanLimits, p as AdminPlatformStats, q as AdminResource, r as AdminUpdateOrganizationParams, s as AdminUsageStats, t as ApiKeySummary, u as ApiKeysResource, v as AuthResource, B as BatchJobStatus, w as BillingResource, x as BillingStatus, y as BoostPriorityResponse, z as BulkEnqueueParams, D as BulkEnqueueResponse, E as BulkJobItem, F as CheckEmailResponse, G as CheckSlugResponse, H as CircuitBreaker, I as CircuitBreakerConfig, J as CircuitState, K as ClaimJobsParams, L as ClaimJobsResult, M as ClaimedJob, N as CompleteJobParams, O as CreateApiKeyParams, P as CreateApiKeyResponse, Q as CreateBillingPortalParams, T as CreateBillingPortalResponse, U as CreateJobParams, V as CreateJobResult, W as CreateOrganizationParams, X as CreateOrganizationResponse, Y as CreateOutgoingWebhookParams, Z as CreateScheduleParams, _ as CreateScheduleResponse, $ as CreateWorkflowParams, a0 as CreateWorkflowResponse, a1 as CurrentUserResponse, a2 as DEFAULT_CONFIG, a3 as DashboardData, a4 as DashboardResource, a5 as DashboardWorkerSummary, a6 as DebugFn, a7 as DependencyInfo, a8 as DependencyMode, a9 as FailJobParams, aa as GrpcClientOptions, ab as GrpcCompleteJobParams, ac as GrpcCompleteJobResponse, ad as GrpcCompleteRequest, ae as GrpcCompleteResponse, af as GrpcDequeueJobParams, ag as GrpcDequeueJobResponse, ah as GrpcDequeueRequest, ai as GrpcDequeueResponse, aj as GrpcDeregisterRequest, ak as GrpcDeregisterResponse, al as GrpcEnqueueJobParams, am as GrpcEnqueueJobResponse, an as GrpcEnqueueRequest, ao as GrpcEnqueueResponse, ap as GrpcErrorResponse, aq as GrpcFailJobParams, ar as GrpcFailJobResponse, as as GrpcFailRequest, at as GrpcFailResponse, au as GrpcGetJobRequest, av as GrpcGetJobResponse, aw as GrpcGetQueueStatsRequest, ax as GrpcGetQueueStatsResponse, ay as GrpcGetQueueStatsResponse_Legacy, az as GrpcHeartbeatParams, aA as GrpcHeartbeatRequest, aB as GrpcHeartbeatResponse, aC as GrpcHeartbeatResponse_Legacy, aD as GrpcJob, aE as GrpcJobStatus, aF as GrpcJobStatusNumber, aG as GrpcProcessRequest, aH as GrpcProcessResponse, aI as GrpcQueueOperations, aJ as GrpcRegisterWorkerParams, aK as GrpcRegisterWorkerRequest, aL as GrpcRegisterWorkerResponse, aM as GrpcRegisterWorkerResponse_Legacy, aN as GrpcRenewLeaseParams, aO as GrpcRenewLeaseRequest, aP as GrpcRenewLeaseResponse, aQ as GrpcRenewLeaseResponse_Legacy, aR as GrpcStreamJobsRequest, aS as GrpcTimestamp, aT as GrpcWorkerOperations, aU as HealthResource, aV as HealthResponse, aW as HeartbeatEvent, aX as HeartbeatJobParams, aY as HttpClient, aZ as IngestCustomWebhookParams, a_ as IngestCustomWebhookResponse, a$ as IngestGitHubWebhookOptions, b0 as IngestStripeWebhookOptions, b1 as InitialApiKey, b2 as Job, b3 as JobCompletedEvent, b4 as JobContext, b5 as JobCreatedEvent, b6 as JobFailedEvent, b7 as JobHandler, b8 as JobProgressEvent, b9 as JobResult, ba as JobStartedEvent, bb as JobStats, bc as JobStatus, bd as JobStatusChangedEvent, be as JobStream, bf as JobSummary, bg as JobSummaryStats, bh as JobWithDependencies, bi as JobsResource, bj as JsonArray, bk as JsonObject, bl as JsonPrimitive, bm as JsonValue, bn as ListDlqParams, bo as ListJobsParams, bp as ListParams, bq as ListSchedulesParams, br as ListWorkflowsParams, bs as LoginParams, bt as LoginResponse, bu as MetricsResource, bv as Organization, bw as OrganizationMember, bx as OrganizationSummary, by as OrganizationUsage, bz as OrganizationsResource, bA as OutgoingWebhook, bB as OutgoingWebhookDelivery, bC as PaginatedResponse, bD as PaginationParams, bE as PauseQueueResponse, bF as PlanCount, bG as PlanLimits, bH as PlanTier, bI as ProcessJobsStream, bJ as PurgeDlqParams, bK as PurgeDlqResponse, bL as QueueConfig, bM as QueueConfigSummary, bN as QueuePausedEvent, bO as QueueResumedEvent, bP as QueueStats, bQ as QueueSummary, bR as QueuesResource, bS as RealtimeEventData, bT as RecentActivity, bU as RefreshTokenParams, bV as RefreshTokenResponse, bW as RegisterWorkerParams, bX as RegisterWorkerResponse, bY as ResolvedConfig, bZ as ResourceUsage, b_ as ResumeQueueResponse, b$ as RetryDlqParams, c0 as RetryDlqResponse, c1 as SDK_VERSION, c2 as Schedule, c3 as ScheduleRun, c4 as ScheduleRunStatus, c5 as ScheduleTriggeredEvent, c6 as SchedulesResource, c7 as SpooledClient, c8 as SpooledClientConfig, c9 as SpooledGrpcClient, ca as SpooledRealtime, cb as SpooledRealtimeOptions, cc as SpooledWorker, cd as SpooledWorkerOptions, ce as StartEmailLoginResponse, cf as StreamOptions, cg as SystemInfo, ch as TestWebhookResponse, ci as TokenClaims, cj as TriggerScheduleResponse, ck as UpdateApiKeyParams, cl as UpdateOrganizationParams, cm as UpdateOutgoingWebhookParams, cn as UpdateQueueConfigParams, co as UpdateScheduleParams, cp as UsageItem, cq as UsageWarning, cr as ValidateTokenParams, cs as ValidateTokenResponse, ct as WebhookDeliveryStatus, cu as WebhookEventType, cv as WebhookIngestionResource, cw as WebhookTokenResponse, cx as WebhooksResource, cy as Worker, cz as WorkerDeregisteredEvent, cA as WorkerEvent, cB as WorkerEventData, cC as WorkerHeartbeatParams, cD as WorkerRegisteredEvent, cE as WorkerState, cF as WorkerStatus, cG as WorkerSummary, cH as WorkersResource, cI as Workflow, cJ as WorkflowJob, cK as WorkflowJobDefinition, cL as WorkflowJobStatus, cM as WorkflowResponse, cN as WorkflowStatus, cO as WorkflowsResource, cP as asyncIterableFromStream, cQ as createCircuitBreaker, cR as createClient, cS as createHttpClient, cT as createJobStream, cU as createPaginatedResponse, cV as createProcessJobsStream, cW as dateToTimestamp, cX as resolveConfig, cY as timestampToDate, cZ as validateConfig } from './index-CWVI9LRo.js';
+import { R as RealtimeConnectionOptions, C as ConnectionState, S as SubscriptionFilter, a as RealtimeEventType, b as RealtimeEvent, c as RetryConfig } from './index-BVWKEr6p.js';
+export { A as API_VERSION, d as AddDependenciesParams, e as AddDependenciesResponse, f as AdminApiKeyResponse, g as AdminCreateApiKeyParams, h as AdminCreateOrganizationParams, i as AdminCreateOrganizationResponse, j as AdminDeleteOrganizationParams, k as AdminListOrganizationsParams, l as AdminOrganizationDetail, m as AdminOrganizationList, n as AdminOrganizationSummary, o as AdminPlanLimits, p as AdminPlatformStats, q as AdminResource, r as AdminUpdateOrganizationParams, s as AdminUsageStats, t as ApiKeySummary, u as ApiKeysResource, v as AuthResource, B as BatchJobStatus, w as BillingResource, x as BillingStatus, y as BoostPriorityResponse, z as BulkEnqueueParams, D as BulkEnqueueResponse, E as BulkJobItem, F as CheckEmailResponse, G as CheckSlugResponse, H as CircuitBreaker, I as CircuitBreakerConfig, J as CircuitState, K as ClaimJobsParams, L as ClaimJobsResult, M as ClaimedJob, N as CompleteJobParams, O as CreateApiKeyParams, P as CreateApiKeyResponse, Q as CreateBillingPortalParams, T as CreateBillingPortalResponse, U as CreateJobParams, V as CreateJobResult, W as CreateOrganizationParams, X as CreateOrganizationResponse, Y as CreateOutgoingWebhookParams, Z as CreateScheduleParams, _ as CreateScheduleResponse, $ as CreateWorkflowParams, a0 as CreateWorkflowResponse, a1 as CurrentUserResponse, a2 as DEFAULT_CONFIG, a3 as DashboardData, a4 as DashboardResource, a5 as DashboardWorkerSummary, a6 as DebugFn, a7 as DeleteQueueOptions, a8 as DependencyInfo, a9 as DependencyMode, aa as FailJobParams, ab as GrpcClientOptions, ac as GrpcCompleteJobParams, ad as GrpcCompleteJobResponse, ae as GrpcCompleteRequest, af as GrpcCompleteResponse, ag as GrpcDequeueJobParams, ah as GrpcDequeueJobResponse, ai as GrpcDequeueRequest, aj as GrpcDequeueResponse, ak as GrpcDeregisterRequest, al as GrpcDeregisterResponse, am as GrpcEnqueueJobParams, an as GrpcEnqueueJobResponse, ao as GrpcEnqueueRequest, ap as GrpcEnqueueResponse, aq as GrpcErrorResponse, ar as GrpcFailJobParams, as as GrpcFailJobResponse, at as GrpcFailRequest, au as GrpcFailResponse, av as GrpcGetJobRequest, aw as GrpcGetJobResponse, ax as GrpcGetQueueStatsRequest, ay as GrpcGetQueueStatsResponse, az as GrpcGetQueueStatsResponse_Legacy, aA as GrpcHeartbeatParams, aB as GrpcHeartbeatRequest, aC as GrpcHeartbeatResponse, aD as GrpcHeartbeatResponse_Legacy, aE as GrpcJob, aF as GrpcJobStatus, aG as GrpcJobStatusNumber, aH as GrpcProcessRequest, aI as GrpcProcessResponse, aJ as GrpcQueueOperations, aK as GrpcRegisterWorkerParams, aL as GrpcRegisterWorkerRequest, aM as GrpcRegisterWorkerResponse, aN as GrpcRegisterWorkerResponse_Legacy, aO as GrpcRenewLeaseParams, aP as GrpcRenewLeaseRequest, aQ as GrpcRenewLeaseResponse, aR as GrpcRenewLeaseResponse_Legacy, aS as GrpcStreamJobsRequest, aT as GrpcTimestamp, aU as GrpcWorkerOperations, aV as HealthResource, aW as HealthResponse, aX as HeartbeatEvent, aY as HeartbeatJobParams, aZ as HttpClient, a_ as IngestCustomWebhookParams, a$ as IngestCustomWebhookResponse, b0 as IngestGitHubWebhookOptions, b1 as IngestStripeWebhookOptions, b2 as InitialApiKey, b3 as Job, b4 as JobCompletedEvent, b5 as JobContext, b6 as JobCreatedEvent, b7 as JobFailedEvent, b8 as JobHandler, b9 as JobProgressEvent, ba as JobResult, bb as JobStartedEvent, bc as JobStats, bd as JobStatus, be as JobStatusChangedEvent, bf as JobStream, bg as JobSummary, bh as JobSummaryStats, bi as JobWithDependencies, bj as JobsResource, bk as JsonArray, bl as JsonObject, bm as JsonPrimitive, bn as JsonValue, bo as ListDlqParams, bp as ListJobsParams, bq as ListParams, br as ListSchedulesParams, bs as ListWorkflowsParams, bt as LoginParams, bu as LoginResponse, bv as MetricsResource, bw as Organization, bx as OrganizationMember, by as OrganizationSummary, bz as OrganizationUsage, bA as OrganizationsResource, bB as OutgoingWebhook, bC as OutgoingWebhookDelivery, bD as PaginatedResponse, bE as PaginationParams, bF as PauseQueueResponse, bG as PlanCount, bH as PlanLimits, bI as PlanTier, bJ as ProcessJobsStream, bK as PurgeDlqParams, bL as PurgeDlqResponse, bM as QueueConfig, bN as QueueConfigSummary, bO as QueuePausedEvent, bP as QueueResumedEvent, bQ as QueueStats, bR as QueueSummary, bS as QueuesResource, bT as RealtimeEventData, bU as RecentActivity, bV as RefreshTokenParams, bW as RefreshTokenResponse, bX as RegisterWorkerParams, bY as RegisterWorkerResponse, bZ as ResolvedConfig, b_ as ResourceUsage, b$ as ResumeQueueResponse, c0 as RetryDlqParams, c1 as RetryDlqResponse, c2 as SDK_VERSION, c3 as Schedule, c4 as ScheduleRun, c5 as ScheduleRunStatus, c6 as ScheduleTriggeredEvent, c7 as SchedulesResource, c8 as SpooledClient, c9 as SpooledClientConfig, ca as SpooledGrpcClient, cb as SpooledRealtime, cc as SpooledRealtimeOptions, cd as SpooledWorker, ce as SpooledWorkerOptions, cf as StartEmailLoginResponse, cg as StreamOptions, ch as SystemInfo, ci as TestWebhookResponse, cj as TokenClaims, ck as TriggerScheduleResponse, cl as UpdateApiKeyParams, cm as UpdateOrganizationParams, cn as UpdateOutgoingWebhookParams, co as UpdateQueueConfigParams, cp as UpdateScheduleParams, cq as UsageItem, cr as UsageWarning, cs as ValidateTokenParams, ct as ValidateTokenResponse, cu as WebhookDeliveryStatus, cv as WebhookEventType, cw as WebhookIngestionResource, cx as WebhookTokenResponse, cy as WebhooksResource, cz as Worker, cA as WorkerDeregisteredEvent, cB as WorkerEvent, cC as WorkerEventData, cD as WorkerHeartbeatParams, cE as WorkerRegisteredEvent, cF as WorkerState, cG as WorkerStatus, cH as WorkerSummary, cI as WorkersResource, cJ as Workflow, cK as WorkflowJob, cL as WorkflowJobDefinition, cM as WorkflowJobStatus, cN as WorkflowResponse, cO as WorkflowStatus, cP as WorkflowsResource, cQ as asyncIterableFromStream, cR as createCircuitBreaker, cS as createClient, cT as createHttpClient, cU as createJobStream, cV as createPaginatedResponse, cW as createProcessJobsStream, cX as dateToTimestamp, cY as resolveConfig, cZ as timestampToDate, c_ as validateConfig } from './index-BVWKEr6p.js';
 import * as protoLoader from '@grpc/proto-loader';
 import { ServiceClientConstructor } from '@grpc/grpc-js';
 
@@ -122,6 +122,12 @@ declare class SseRealtimeClient {
     private reconnectAttempts;
     private reconnectTimer;
     private filter;
+    /** When the current connection opened (for the stable-connection check). */
+    private connectedAt;
+    /** The server finished this stream on purpose (terminal job); do not reconnect. */
+    private streamEnded;
+    /** The server rejected our token; mint a fresh one for the next connect. */
+    private forceTokenRefresh;
     private eventHandlers;
     private allEventsHandlers;
     private stateChangeHandlers;
@@ -202,7 +208,13 @@ declare class SpooledError extends Error {
     /** Original cause of the error */
     readonly cause?: Error;
     constructor(message: string, statusCode?: number, code?: string, details?: Record<string, unknown>, requestId?: string, cause?: Error);
-    /** Whether this error is retryable */
+    /**
+     * Whether this error is retryable.
+     *
+     * Only 408 (Request Timeout) is retryable among the plain 4xx statuses: the
+     * server gave up waiting for the request, so it never ran. Subclasses
+     * override this (5xx, network, timeout, rate limit).
+     */
     isRetryable(): boolean;
     /** Convert to plain object for logging */
     toJSON(): Record<string, unknown>;
@@ -236,11 +248,15 @@ declare class ConflictError extends SpooledError {
     constructor(message?: string, code?: string, details?: Record<string, unknown>, requestId?: string);
 }
 /**
- * Validation error (400)
- * Thrown when request validation fails
+ * Validation error (400 or 422)
+ * Thrown when request validation fails.
+ *
+ * The API answers a field-rule failure (length, range) with 400 but a missing
+ * or mistyped JSON field with 422; both are the caller's request being invalid,
+ * so both surface as this class. `statusCode` tells them apart.
  */
 declare class ValidationError extends SpooledError {
-    constructor(message?: string, code?: string, details?: Record<string, unknown>, requestId?: string);
+    constructor(message?: string, code?: string, details?: Record<string, unknown>, requestId?: string, statusCode?: 400 | 422);
 }
 /**
  * Payload too large error (413)
@@ -251,12 +267,26 @@ declare class PayloadTooLargeError extends SpooledError {
 }
 /**
  * Rate limit error (429)
- * Thrown when rate limit is exceeded
+ * Thrown when rate limit is exceeded, or a plan quota is (see `isQuota`)
  */
 declare class RateLimitError extends SpooledError {
     /** Rate limit information */
     readonly rateLimitInfo: RateLimitInfo;
     constructor(message?: string, code?: string, rateLimitInfo?: RateLimitInfo, details?: Record<string, unknown>, requestId?: string);
+    /**
+     * True when this 429 is a plan quota or limit (daily job cap, active jobs,
+     * queue/worker/webhook caps) rather than per-second rate limiting.
+     *
+     * A quota does not clear for minutes or hours, so retrying it only blocks the
+     * caller for the whole backoff and, via the circuit breaker, takes every
+     * other call on the client down with it. It is never retried and never
+     * counted as a circuit breaker failure.
+     *
+     * Detection: the `QUOTA_EXCEEDED` code, or, for older plan-limit paths that
+     * answer with plain text wrapped as `RATE_LIMIT_EXCEEDED`, a "... limit
+     * reached" message that carries no `Retry-After`.
+     */
+    get isQuota(): boolean;
     isRetryable(): boolean;
     /** Get the number of seconds to wait before retrying */
     getRetryAfter(): number;
@@ -296,6 +326,17 @@ declare class CircuitBreakerOpenError extends SpooledError {
     constructor(message?: string);
     isRetryable(): boolean;
 }
+/**
+ * Unsupported operation error
+ * Thrown by SDK methods whose route the Spooled API does not provide (or
+ * always rejects). It is raised before any network call, so code that still
+ * calls such a method fails loudly with an explanation instead of a 404.
+ */
+declare class UnsupportedOperationError extends SpooledError {
+    /** The SDK method that is not supported, e.g. `ingest.github` */
+    readonly operation: string;
+    constructor(operation: string, reason: string);
+}
 /**
  * Parse rate limit headers from a Response
  */
@@ -456,4 +497,4 @@ declare function convertResponse<T>(body: T): T;
  */
 declare function convertQueryParams(params: Record<string, string | number | boolean | undefined>): Record<string, string>;
 
-export { type ApiErrorBody, AuthenticationError, AuthorizationError, CircuitBreakerOpenError, ConflictError, ConnectionState, NetworkError, NotFoundError, PROTO_LOADER_OPTIONS, PayloadTooLargeError, RateLimitError, type RateLimitInfo, RealtimeConnectionOptions, RealtimeEvent, RealtimeEventType, RetryConfig, ServerError, SpooledError, type SpooledProtoDefinition, SseRealtimeClient, SubscriptionFilter, TimeoutError, ValidationError, WebSocketRealtimeClient, calculateDelay, camelToSnake, clearProtoCache, convertQueryParams, convertRequest, convertResponse, createErrorFromResponse, createRetryWrapper, getProtoPath, isRetryableError, isSpooledError, loadProtoDefinition, loadProtoDefinitionAsync, parseRateLimitHeaders, shouldRetry, sleep, snakeToCamel, toCamelCase, toSnakeCase, withRetry };
+export { type ApiErrorBody, AuthenticationError, AuthorizationError, CircuitBreakerOpenError, ConflictError, ConnectionState, NetworkError, NotFoundError, PROTO_LOADER_OPTIONS, PayloadTooLargeError, RateLimitError, type RateLimitInfo, RealtimeConnectionOptions, RealtimeEvent, RealtimeEventType, RetryConfig, ServerError, SpooledError, type SpooledProtoDefinition, SseRealtimeClient, SubscriptionFilter, TimeoutError, UnsupportedOperationError, ValidationError, WebSocketRealtimeClient, calculateDelay, camelToSnake, clearProtoCache, convertQueryParams, convertRequest, convertResponse, createErrorFromResponse, createRetryWrapper, getProtoPath, isRetryableError, isSpooledError, loadProtoDefinition, loadProtoDefinitionAsync, parseRateLimitHeaders, shouldRetry, sleep, snakeToCamel, toCamelCase, toSnakeCase, withRetry };