@spooled/sdk 1.1.0 → 1.2.1

package/dist/index.cjs

@@ -50,10 +50,10 @@ var DEFAULT_CONFIG = {
     successThreshold: 3,
     timeout: 3e4
   },
-  userAgent: "@spooled/sdk-nodejs/1.1.0",
+  userAgent: "@spooled/sdk-nodejs/1.2.1",
   autoRefreshToken: true
 };
-var SDK_VERSION = "1.1.0";
+var SDK_VERSION = "1.2.1";
 var API_VERSION = "v1";
 var API_BASE_PATH = `/api/${API_VERSION}`;
 function normalizeCredential(value) {
@@ -1079,21 +1079,28 @@ var AuthResource = class {
   }
   /**
    * Validate a token
+   *
+   * POST /auth/validate is `{ valid, error?, claims? }`. Claims use `org_id`
+   * (camelCased `orgId`), not `organizationId`. Invalid tokens send `error`,
+   * not `message`.
    */
   async validate(params) {
-    return this.http.post("/auth/validate", params);
+    const raw = await this.http.post(
+      "/auth/validate",
+      params
+    );
+    return mapValidate(raw);
   }
   /**
-   * Start email-based login flow (sends magic link)
+   * Start email-based login flow (sends a 6-digit code)
    */
   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
+   * Check whether an email is registered (GET /auth/check-email)
    */
   async checkEmail(email) {
     return this.http.get("/auth/check-email", {
@@ -1101,6 +1108,23 @@ var AuthResource = class {
     });
   }
 };
+function mapValidate(raw) {
+  const claims = raw.claims;
+  const organizationId = claims?.organizationId ?? claims?.orgId;
+  return {
+    valid: raw.valid,
+    message: raw.message ?? raw.error,
+    error: raw.error ?? raw.message,
+    claims: claims ? {
+      organizationId: organizationId ?? "",
+      orgId: claims.orgId ?? organizationId,
+      apiKeyId: claims.apiKeyId ?? "",
+      queues: claims.queues ?? [],
+      exp: claims.exp ?? 0,
+      iat: claims.iat ?? 0
+    } : void 0
+  };
+}
 
 // src/resources/jobs.ts
 var JobsResource = class {
@@ -1131,15 +1155,20 @@ var JobsResource = class {
    * List jobs with optional filtering
    */
   async list(params) {
-    return this.http.get("/jobs", {
+    const rows = await this.http.get("/jobs", {
       params
     });
+    return rows.map((row) => ({
+      ...row,
+      jobType: row.jobType ?? jobTypeFromPayload(row)
+    }));
   }
   /**
    * Get a job by ID
    */
   async get(id) {
-    return this.http.get(`/jobs/${id}`);
+    const job = await this.http.get(`/jobs/${id}`);
+    return withJobType(job);
   }
   /**
    * Cancel a pending or scheduled job
@@ -1151,7 +1180,8 @@ var JobsResource = class {
    * Retry a failed or dead-lettered job
    */
   async retry(id) {
-    return this.http.post(`/jobs/${id}/retry`);
+    const job = await this.http.post(`/jobs/${id}/retry`);
+    return withJobType(job);
   }
   /**
    * Boost job priority
@@ -1220,9 +1250,13 @@ var JobsResource = class {
   }
   // DLQ operations (private implementations)
   async listDlq(params) {
-    return this.http.get("/jobs/dlq", {
+    const rows = await this.http.get("/jobs/dlq", {
       params
     });
+    return rows.map((row) => ({
+      ...row,
+      jobType: row.jobType ?? jobTypeFromPayload(row)
+    }));
   }
   async retryDlq(params) {
     return this.http.post("/jobs/dlq/retry", params);
@@ -1231,6 +1265,28 @@ var JobsResource = class {
     return this.http.post("/jobs/dlq/purge", params);
   }
 };
+function withJobType(job) {
+  return {
+    ...job,
+    jobType: job.jobType ?? jobTypeFromPayload(job) ?? void 0
+  };
+}
+function jobTypeFromPayload(row) {
+  if (typeof row.jobType === "string" && row.jobType !== "") {
+    return row.jobType;
+  }
+  const payload = row.payload;
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+    return void 0;
+  }
+  const rec = payload;
+  for (const value of [rec.jobType, rec.job_type]) {
+    if (typeof value === "string" && value !== "") {
+      return value;
+    }
+  }
+  return void 0;
+}
 
 // src/resources/queues.ts
 var QueuesResource = class {
@@ -1425,7 +1481,8 @@ var WorkflowsResource = class {
    * Get a workflow by ID
    */
   async get(id) {
-    return this.http.get(`/workflows/${id}`);
+    const raw = await this.http.get(`/workflows/${id}`);
+    return mapWorkflowGetResponse(raw);
   }
   /**
    * Cancel a workflow
@@ -1443,27 +1500,104 @@ var WorkflowsResource = class {
     return this.http.post(`/workflows/${id}/retry`);
   }
   // Workflow job operations (private implementations)
+  //
+  // The backend has no /workflows/{id}/jobs routes. Job rows and dependency
+  // edges are on GET /workflows/{id} (WorkflowDetailResponse).
   async listWorkflowJobs(workflowId) {
-    return this.http.get(`/workflows/${workflowId}/jobs`);
+    const detail = await this.http.get(
+      `/workflows/${workflowId}`
+    );
+    return mapWorkflowDetailJobs(detail);
   }
   async getWorkflowJob(workflowId, jobId) {
-    return this.http.get(`/workflows/${workflowId}/jobs/${jobId}`);
+    const jobs = await this.listWorkflowJobs(workflowId);
+    const job = jobs.find((item) => item.id === jobId);
+    if (!job) {
+      throw new NotFoundError(
+        `Job ${jobId} not found in workflow ${workflowId}`
+      );
+    }
+    return job;
   }
   async getWorkflowJobsStatus(workflowId) {
-    return this.http.get(
-      `/workflows/${workflowId}/jobs/status`
-    );
+    const jobs = await this.listWorkflowJobs(workflowId);
+    return jobs.map((job) => ({
+      jobId: job.id,
+      key: job.key,
+      status: job.status
+    }));
   }
   async getJobDependencies(jobId) {
     return this.http.get(`/jobs/${jobId}/dependencies`);
   }
   async addJobDependencies(jobId, params) {
-    return this.http.post(
+    const dependsOn = params.dependsOn ?? params.dependsOnJobIds ?? [];
+    const mode = params.dependencyMode ?? (params.dependencyType === "any" || params.dependencyType === "all" ? params.dependencyType : void 0);
+    const raw = await this.http.post(
       `/jobs/${jobId}/dependencies`,
-      params
+      {
+        depends_on: dependsOn,
+        ...mode ? { dependency_mode: mode } : {}
+      },
+      { skipRequestConversion: true }
     );
+    return {
+      added: raw.dependenciesAdded ?? 0,
+      dependenciesMet: raw.dependenciesMet ?? false,
+      dependencies: []
+    };
   }
 };
+function mapWorkflowGetResponse(raw) {
+  const totalJobs = raw.totalJobs ?? raw.progress?.total ?? 0;
+  const completedJobs = raw.completedJobs ?? raw.progress?.completed ?? 0;
+  const failedJobs = raw.failedJobs ?? raw.progress?.failed ?? 0;
+  const progressPercent = raw.progressPercent ?? (totalJobs > 0 ? completedJobs / totalJobs * 100 : 0);
+  return {
+    id: String(raw.id ?? ""),
+    name: String(raw.name ?? ""),
+    status: raw.status ?? "pending",
+    totalJobs,
+    completedJobs,
+    failedJobs,
+    progressPercent,
+    createdAt: String(raw.createdAt ?? ""),
+    completedAt: raw.completedAt
+  };
+}
+function mapWorkflowDetailJobs(detail) {
+  const workflowId = String(detail.id ?? "");
+  const deps = detail.dependencies ?? [];
+  return (detail.jobs ?? []).map((job) => {
+    const id = String(job.id ?? "");
+    const timeoutMs = typeof job.timeoutMs === "number" ? job.timeoutMs : void 0;
+    const errorObj = job.error;
+    let error;
+    if (typeof errorObj === "string") {
+      error = errorObj;
+    } else if (errorObj && typeof errorObj === "object" && "message" in errorObj) {
+      error = String(errorObj.message);
+    }
+    return {
+      id,
+      workflowId: String(job.workflowId ?? workflowId),
+      key: String(job.key ?? ""),
+      queueName: String(job.queueName ?? job.queue ?? ""),
+      status: job.status,
+      payload: job.payload ?? {},
+      result: job.result ?? void 0,
+      error,
+      dependsOn: deps.filter((dep) => dep.childJobId === id).map((dep) => String(dep.parentJobId ?? "")),
+      priority: Number(job.priority ?? 0),
+      maxRetries: Number(job.maxRetries ?? 0),
+      attempt: Number(job.attempt ?? 0),
+      timeoutSeconds: timeoutMs != null ? Math.max(1, Math.floor(timeoutMs / 1e3)) : void 0,
+      createdAt: String(job.createdAt ?? ""),
+      startedAt: job.startedAt ?? void 0,
+      completedAt: job.completedAt ?? void 0
+    };
+  });
+}
 
 // src/resources/webhooks.ts
 var WebhooksResource = class {
@@ -1632,8 +1766,8 @@ var OrganizationsResource = class {
    *
    * @example
    * ```typescript
-   * const { token } = await client.organizations.getWebhookToken();
-   * console.log('Webhook token:', token);
+   * const { webhookToken, webhookUrl } = await client.organizations.getWebhookToken();
+   * console.log('Webhook token:', webhookToken);
    * ```
    */
   async getWebhookToken() {
@@ -1647,7 +1781,7 @@ var OrganizationsResource = class {
    *
    * @example
    * ```typescript
-   * const { token: newToken } = await client.organizations.regenerateWebhookToken();
+   * const { webhookToken: newToken } = await client.organizations.regenerateWebhookToken();
    * console.log('New webhook token:', newToken);
    * ```
    */
@@ -1659,8 +1793,9 @@ var OrganizationsResource = class {
   /**
    * Clear/delete the webhook token for the current organization.
    *
-   * After this, webhook signature verification will fail until a new
-   * token is generated via regenerateWebhookToken().
+   * POST /organizations/webhook-token/clear requires `{ confirm: true }`.
+   * An empty body 422s. The API currently rejects the operation and tells
+   * callers to use regenerateWebhookToken() instead.
    *
    * @example
    * ```typescript
@@ -1668,7 +1803,9 @@ var OrganizationsResource = class {
    * ```
    */
   async clearWebhookToken() {
-    await this.http.post("/organizations/webhook-token/clear");
+    await this.http.post("/organizations/webhook-token/clear", {
+      confirm: true
+    });
   }
 };
 
@@ -1965,16 +2102,27 @@ var WebhookIngestionResource = class {
   /**
    * Ingest a custom webhook.
    *
-   * POST /api/v1/webhooks/{org_id}/custom
+   * POST /api/v1/webhooks/{org_id}/custom returns `{ jobId, queueName, status }`.
+   * An older empty 200 maps to an empty object rather than throwing.
    */
   async custom(orgId, params, opts) {
     const headers = {
       ...opts?.webhookToken ? { "X-Webhook-Token": opts.webhookToken } : {},
       ...opts?.forwardedProto ? { "X-Forwarded-Proto": opts.forwardedProto } : {}
     };
-    await this.http.post(`/webhooks/${orgId}/custom`, params, {
-      headers
-    });
+    const raw = await this.http.post(
+      `/webhooks/${orgId}/custom`,
+      params,
+      { headers }
+    );
+    if (!raw || typeof raw === "string") {
+      return {};
+    }
+    return {
+      jobId: raw.jobId,
+      queueName: raw.queueName,
+      status: raw.status
+    };
   }
 };
 
@@ -2313,6 +2461,19 @@ function isAuthFailureEvent(event) {
 }
 
 // src/realtime/sse.ts
+var SSE_EVENT_NAMES = [
+  "job.created",
+  "job.status",
+  "job.completed",
+  "job.failed",
+  "queue.stats",
+  "worker.heartbeat",
+  "worker.registered",
+  "worker.deregistered",
+  "system.health",
+  "ping",
+  "error"
+];
 var SseRealtimeClient = class {
   options;
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -2404,6 +2565,11 @@ var SseRealtimeClient = class {
         this.eventSource.onmessage = (event) => {
           this.handleMessage(event.data);
         };
+        for (const name of SSE_EVENT_NAMES) {
+          this.eventSource.addEventListener(name, (event) => {
+            if (typeof event?.data === "string") this.handleMessage(event.data);
+          });
+        }
         this.eventSource.onerror = () => {
           this.options.debug("SSE error");
           if (this.state === "connecting") {
@@ -2484,7 +2650,7 @@ var SseRealtimeClient = class {
       return `${this.options.baseUrl}/api/v1/events/jobs/${encodeURIComponent(filter.jobId)}`;
     }
     if (filter?.queueName) {
-      return `${this.options.baseUrl}/api/v1/events/queues/${encodeURIComponent(filter.queueName)}`;
+      return `${this.options.baseUrl}/api/v1/events?queue=${encodeURIComponent(filter.queueName)}`;
     }
     return `${this.options.baseUrl}/api/v1/events`;
   }