@centrali-io/centrali-sdk 4.4.6 → 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;
@@ -519,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.
  */
@@ -1341,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;
 // =====================================================

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.
  */
@@ -2646,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.
  */
@@ -3554,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);
+    }
 }
 
 // =====================================================

package/package.json

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