@centrali-io/centrali-sdk 4.4.5 → 4.4.6

package/dist/index.js

@@ -87,6 +87,7 @@ exports.getComputeFunctionTestApiPath = getComputeFunctionTestApiPath;
 exports.getFunctionRunsApiPath = getFunctionRunsApiPath;
 exports.getFunctionRunsByTriggerApiPath = getFunctionRunsByTriggerApiPath;
 exports.getFunctionRunsByFunctionApiPath = getFunctionRunsByFunctionApiPath;
+exports.getComputeJobStatusApiPath = getComputeJobStatusApiPath;
 exports.getSmartQueryTestApiPath = getSmartQueryTestApiPath;
 exports.getValidationSuggestionsApiPath = getValidationSuggestionsApiPath;
 exports.getValidationSuggestionAcceptApiPath = getValidationSuggestionAcceptApiPath;
@@ -681,6 +682,15 @@ function getFunctionRunsByFunctionApiPath(workspaceId, functionId) {
     return `data/workspace/${workspaceId}/api/v1/function-runs/function/${functionId}`;
 }
 // =====================================================
+// Compute Job Status API Path Helper
+// =====================================================
+/**
+ * Generate Compute Job Status API URL PATH.
+ */
+function getComputeJobStatusApiPath(workspaceId, jobId) {
+    return `data/workspace/${workspaceId}/api/v1/jobs/compute/${jobId}`;
+}
+// =====================================================
 // Smart Query Test API Path Helper (Configuration-as-Code)
 // =====================================================
 /**
@@ -2619,6 +2629,38 @@ class FunctionRunsManager {
             queryParams.status = options.status;
         return this.requestFn('GET', path, null, queryParams);
     }
+    /**
+     * Get the status of a compute job by job ID.
+     *
+     * This is the primary way to poll for the result of an async trigger
+     * invocation. The job ID is returned by `client.triggers.invoke()`.
+     *
+     * @param jobId - The job ID returned by invoke
+     * @returns Job status including returnValue (on success) or failedReason (on failure)
+     *
+     * @example
+     * ```ts
+     * // Invoke a trigger and poll for the result
+     * const { data: jobId } = await client.triggers.invoke('trigger-uuid');
+     *
+     * // Poll until complete
+     * let job;
+     * do {
+     *   await new Promise(r => setTimeout(r, 1000));
+     *   job = await client.runs.getJobStatus(jobId);
+     * } while (job.data.status === 'queued' || job.data.status === 'running');
+     *
+     * if (job.data.status === 'completed') {
+     *   console.log('Result:', job.data.returnValue);
+     * } else {
+     *   console.error('Failed:', job.data.failedReason);
+     * }
+     * ```
+     */
+    getJobStatus(jobId) {
+        const path = getComputeJobStatusApiPath(this.workspaceId, jobId);
+        return this.requestFn('GET', path);
+    }
 }
 exports.FunctionRunsManager = FunctionRunsManager;
 /**

package/index.ts

@@ -1840,6 +1840,22 @@ export interface ListFunctionRunsOptions {
     status?: FunctionRunStatus;
 }
 
+/**
+ * Status of a compute job in the execution pipeline.
+ */
+export type ComputeJobStatus = 'queued' | 'running' | 'completed' | 'failed';
+
+/**
+ * A compute job status response from the job status endpoint.
+ * Represents the state of an async compute execution.
+ */
+export interface ComputeJobStatusResponse {
+    jobId: string;
+    status: ComputeJobStatus;
+    returnValue?: any;
+    failedReason?: string | null;
+}
+
 // =====================================================
 // Trigger CRUD Types (Configuration-as-Code)
 // =====================================================
@@ -2820,6 +2836,17 @@ export function getFunctionRunsByFunctionApiPath(workspaceId: string, functionId
     return `data/workspace/${workspaceId}/api/v1/function-runs/function/${functionId}`;
 }
 
+// =====================================================
+// Compute Job Status API Path Helper
+// =====================================================
+
+/**
+ * Generate Compute Job Status API URL PATH.
+ */
+export function getComputeJobStatusApiPath(workspaceId: string, jobId: string): string {
+    return `data/workspace/${workspaceId}/api/v1/jobs/compute/${jobId}`;
+}
+
 // =====================================================
 // Smart Query Test API Path Helper (Configuration-as-Code)
 // =====================================================
@@ -4939,6 +4966,39 @@ export class FunctionRunsManager {
         if (options?.status) queryParams.status = options.status;
         return this.requestFn<PaginatedResponse<FunctionRun>>('GET', path, null, queryParams);
     }
+
+    /**
+     * Get the status of a compute job by job ID.
+     *
+     * This is the primary way to poll for the result of an async trigger
+     * invocation. The job ID is returned by `client.triggers.invoke()`.
+     *
+     * @param jobId - The job ID returned by invoke
+     * @returns Job status including returnValue (on success) or failedReason (on failure)
+     *
+     * @example
+     * ```ts
+     * // Invoke a trigger and poll for the result
+     * const { data: jobId } = await client.triggers.invoke('trigger-uuid');
+     *
+     * // Poll until complete
+     * let job;
+     * do {
+     *   await new Promise(r => setTimeout(r, 1000));
+     *   job = await client.runs.getJobStatus(jobId);
+     * } while (job.data.status === 'queued' || job.data.status === 'running');
+     *
+     * if (job.data.status === 'completed') {
+     *   console.log('Result:', job.data.returnValue);
+     * } else {
+     *   console.error('Failed:', job.data.failedReason);
+     * }
+     * ```
+     */
+    public getJobStatus(jobId: string): Promise<ApiResponse<ComputeJobStatusResponse>> {
+        const path = getComputeJobStatusApiPath(this.workspaceId, jobId);
+        return this.requestFn<ComputeJobStatusResponse>('GET', path);
+    }
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@centrali-io/centrali-sdk",
-  "version": "4.4.5",
+  "version": "4.4.6",
   "description": "Centrali Node SDK",
   "main": "dist/index.js",
   "type": "commonjs",