@centrali-io/centrali-sdk 4.4.5 → 4.4.7

package/dist/index.js

@@ -63,6 +63,7 @@ exports.getFunctionTriggersApiPath = getFunctionTriggersApiPath;
 exports.getFunctionTriggerExecuteApiPath = getFunctionTriggerExecuteApiPath;
 exports.getFunctionTriggerPauseApiPath = getFunctionTriggerPauseApiPath;
 exports.getFunctionTriggerResumeApiPath = getFunctionTriggerResumeApiPath;
+exports.getEndpointApiPath = getEndpointApiPath;
 exports.getSmartQueriesApiPath = getSmartQueriesApiPath;
 exports.getSmartQueriesStructureApiPath = getSmartQueriesStructureApiPath;
 exports.getSmartQueryByNameApiPath = getSmartQueryByNameApiPath;
@@ -87,6 +88,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;
@@ -518,6 +520,12 @@ function getFunctionTriggerPauseApiPath(workspaceId, triggerId) {
 function getFunctionTriggerResumeApiPath(workspaceId, triggerId) {
     return `data/workspace/${workspaceId}/api/v1/function-triggers/${triggerId}/resume`;
 }
+/**
+ * Generate Endpoint trigger invocation API URL PATH.
+ */
+function getEndpointApiPath(workspaceId, path) {
+    return `data/workspace/${workspaceId}/api/v1/endpoints/${path}`;
+}
 /**
  * Generate Smart Queries base API URL PATH for workspace-level operations.
  */
@@ -681,6 +689,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)
 // =====================================================
 /**
@@ -1331,6 +1348,45 @@ class TriggersManager {
         const path = getFunctionTriggersApiPath(this.workspaceId, triggerId);
         return this.requestFn('GET', path, null, options);
     }
+    /**
+     * Invoke a synchronous compute endpoint by its path.
+     *
+     * Unlike `invoke()` (which is async and returns a job ID), endpoint triggers
+     * execute the function and return the result inline. Max 30 second timeout.
+     *
+     * @param endpointPath - The endpoint path (e.g., 'create-order')
+     * @param options - Optional method, payload, headers, query params
+     * @returns The function's response (status, data, headers)
+     *
+     * @example
+     * ```ts
+     * // POST to an endpoint
+     * const result = await client.triggers.invokeEndpoint('create-order', {
+     *   payload: { product: 'Widget', quantity: 5 }
+     * });
+     * console.log('Status:', result.data.status);
+     * console.log('Response:', result.data.data);
+     *
+     * // GET with query params
+     * const users = await client.triggers.invokeEndpoint('list-users', {
+     *   method: 'GET',
+     *   query: { role: 'admin' }
+     * });
+     *
+     * // With API key auth
+     * const result = await client.triggers.invokeEndpoint('webhook/stripe', {
+     *   payload: stripeEvent,
+     *   headers: { 'X-API-Key': 'your-api-key' }
+     * });
+     * ```
+     */
+    invokeEndpoint(endpointPath, options) {
+        const path = getEndpointApiPath(this.workspaceId, endpointPath);
+        const method = ((options === null || options === void 0 ? void 0 : options.method) || 'POST');
+        const data = ['GET', 'DELETE'].includes(method) ? undefined : ((options === null || options === void 0 ? void 0 : options.payload) || {});
+        const queryParams = options === null || options === void 0 ? void 0 : options.query;
+        return this.requestFn(method, path, data, queryParams);
+    }
 }
 exports.TriggersManager = TriggersManager;
 // =====================================================
@@ -2619,6 +2675,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

@@ -694,6 +694,32 @@ export interface InvokeTriggerOptions {
     payload?: Record<string, any>;
 }
 
+/**
+ * Options for invoking a synchronous compute endpoint.
+ */
+export interface InvokeEndpointOptions {
+    /** HTTP method (default: 'POST'). Must be in the trigger's allowedMethods. */
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    /** Request body payload (sent as JSON). Ignored for GET/DELETE. */
+    payload?: Record<string, any>;
+    /** Additional request headers (e.g., X-API-Key for apiKey auth). */
+    headers?: Record<string, string>;
+    /** Query string parameters. */
+    query?: Record<string, string>;
+}
+
+/**
+ * Response from a synchronous compute endpoint invocation.
+ */
+export interface EndpointResponse<T = any> {
+    /** HTTP status code from the compute function */
+    status: number;
+    /** Response body from the compute function */
+    data: T;
+    /** Response headers */
+    headers: Record<string, string>;
+}
+
 /**
  * Options for deleting a record.
  */
@@ -1840,6 +1866,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)
 // =====================================================
@@ -2630,6 +2672,13 @@ export function getFunctionTriggerResumeApiPath(workspaceId: string, triggerId:
     return `data/workspace/${workspaceId}/api/v1/function-triggers/${triggerId}/resume`;
 }
 
+/**
+ * Generate Endpoint trigger invocation API URL PATH.
+ */
+export function getEndpointApiPath(workspaceId: string, path: string): string {
+    return `data/workspace/${workspaceId}/api/v1/endpoints/${path}`;
+}
+
 /**
  * Generate Smart Queries base API URL PATH for workspace-level operations.
  */
@@ -2820,6 +2869,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)
 // =====================================================
@@ -3527,6 +3587,49 @@ export class TriggersManager {
         const path = getFunctionTriggersApiPath(this.workspaceId, triggerId);
         return this.requestFn<FunctionTrigger | TriggerWithHealth>('GET', path, null, options);
     }
+
+    /**
+     * Invoke a synchronous compute endpoint by its path.
+     *
+     * Unlike `invoke()` (which is async and returns a job ID), endpoint triggers
+     * execute the function and return the result inline. Max 30 second timeout.
+     *
+     * @param endpointPath - The endpoint path (e.g., 'create-order')
+     * @param options - Optional method, payload, headers, query params
+     * @returns The function's response (status, data, headers)
+     *
+     * @example
+     * ```ts
+     * // POST to an endpoint
+     * const result = await client.triggers.invokeEndpoint('create-order', {
+     *   payload: { product: 'Widget', quantity: 5 }
+     * });
+     * console.log('Status:', result.data.status);
+     * console.log('Response:', result.data.data);
+     *
+     * // GET with query params
+     * const users = await client.triggers.invokeEndpoint('list-users', {
+     *   method: 'GET',
+     *   query: { role: 'admin' }
+     * });
+     *
+     * // With API key auth
+     * const result = await client.triggers.invokeEndpoint('webhook/stripe', {
+     *   payload: stripeEvent,
+     *   headers: { 'X-API-Key': 'your-api-key' }
+     * });
+     * ```
+     */
+    public invokeEndpoint<T = any>(
+        endpointPath: string,
+        options?: InvokeEndpointOptions
+    ): Promise<ApiResponse<T>> {
+        const path = getEndpointApiPath(this.workspaceId, endpointPath);
+        const method = (options?.method || 'POST') as Method;
+        const data = ['GET', 'DELETE'].includes(method) ? undefined : (options?.payload || {});
+        const queryParams = options?.query;
+        return this.requestFn<T>(method, path, data, queryParams);
+    }
 }
 
 // =====================================================
@@ -4939,6 +5042,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.7",
   "description": "Centrali Node SDK",
   "main": "dist/index.js",
   "type": "commonjs",