@centrali-io/centrali-sdk 3.0.9 → 3.1.0

package/dist/index.js

@@ -18,7 +18,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CentraliSDK = exports.AllowedDomainsManager = exports.ValidationManager = exports.AnomalyInsightsManager = exports.SmartQueriesManager = exports.TriggersManager = exports.OrchestrationsManager = exports.RealtimeManager = void 0;
+exports.CentraliSDK = exports.ComputeFunctionsManager = exports.StructuresManager = exports.AllowedDomainsManager = exports.ValidationManager = exports.AnomalyInsightsManager = exports.SmartQueriesManager = exports.TriggersManager = exports.OrchestrationsManager = exports.RealtimeManager = void 0;
 exports.getApiUrl = getApiUrl;
 exports.getAuthUrl = getAuthUrl;
 exports.getRealtimeUrl = getRealtimeUrl;
@@ -41,6 +41,12 @@ exports.getAnomalyInsightDismissApiPath = getAnomalyInsightDismissApiPath;
 exports.getAnomalyInsightsBulkAcknowledgeApiPath = getAnomalyInsightsBulkAcknowledgeApiPath;
 exports.getAnomalyAnalysisTriggerApiPath = getAnomalyAnalysisTriggerApiPath;
 exports.getStructureInsightsApiPath = getStructureInsightsApiPath;
+exports.getStructuresApiPath = getStructuresApiPath;
+exports.getStructureBySlugApiPath = getStructureBySlugApiPath;
+exports.getStructureValidateApiPath = getStructureValidateApiPath;
+exports.getComputeFunctionsApiPath = getComputeFunctionsApiPath;
+exports.getComputeFunctionTestApiPath = getComputeFunctionTestApiPath;
+exports.getSmartQueryTestApiPath = getSmartQueryTestApiPath;
 exports.getValidationSuggestionsApiPath = getValidationSuggestionsApiPath;
 exports.getValidationSuggestionAcceptApiPath = getValidationSuggestionAcceptApiPath;
 exports.getValidationSuggestionRejectApiPath = getValidationSuggestionRejectApiPath;
@@ -456,6 +462,53 @@ function getStructureInsightsApiPath(workspaceId, structureSlug) {
     return `data/workspace/${workspaceId}/api/v1/structures/${structureSlug}/insights`;
 }
 // =====================================================
+// Structure API Path Helpers (Configuration-as-Code)
+// =====================================================
+/**
+ * Generate Structures base API URL PATH.
+ */
+function getStructuresApiPath(workspaceId, structureId) {
+    const basePath = `data/workspace/${workspaceId}/api/v1/structures`;
+    return structureId ? `${basePath}/${structureId}` : basePath;
+}
+/**
+ * Generate Structure by slug API URL PATH.
+ */
+function getStructureBySlugApiPath(workspaceId, recordSlug) {
+    return `data/workspace/${workspaceId}/api/v1/structures/slug/${recordSlug}`;
+}
+/**
+ * Generate Structure validate API URL PATH.
+ */
+function getStructureValidateApiPath(workspaceId) {
+    return `data/workspace/${workspaceId}/api/v1/structures/validate`;
+}
+// =====================================================
+// Compute Function API Path Helpers (Configuration-as-Code)
+// =====================================================
+/**
+ * Generate Compute Functions base API URL PATH.
+ */
+function getComputeFunctionsApiPath(workspaceId, functionId) {
+    const basePath = `data/workspace/${workspaceId}/api/v1/compute-functions`;
+    return functionId ? `${basePath}/${functionId}` : basePath;
+}
+/**
+ * Generate Compute Function test execution API URL PATH.
+ */
+function getComputeFunctionTestApiPath(workspaceId) {
+    return `data/workspace/${workspaceId}/api/v1/compute-functions/test`;
+}
+// =====================================================
+// Smart Query Test API Path Helper (Configuration-as-Code)
+// =====================================================
+/**
+ * Generate Smart Query test execution API URL PATH.
+ */
+function getSmartQueryTestApiPath(workspaceId, structureSlug) {
+    return `data/workspace/${workspaceId}/api/v1/smart-queries/slug/${structureSlug}/test`;
+}
+// =====================================================
 // Validation API Path Helpers
 // =====================================================
 /**
@@ -990,6 +1043,113 @@ class TriggersManager {
         const path = getFunctionTriggerResumeApiPath(this.workspaceId, triggerId);
         return this.requestFn('PATCH', path, {});
     }
+    /**
+     * Create a new function trigger.
+     *
+     * @param input - The trigger definition
+     * @returns The created trigger
+     *
+     * @example
+     * ```ts
+     * // Create an event-driven trigger
+     * const trigger = await client.triggers.create({
+     *   name: 'On Order Created',
+     *   functionId: 'function-uuid',
+     *   executionType: 'event-driven',
+     *   triggerMetadata: { event: 'record.created', recordSlug: 'orders' }
+     * });
+     *
+     * // Create a scheduled trigger
+     * const scheduled = await client.triggers.create({
+     *   name: 'Daily Report',
+     *   functionId: 'function-uuid',
+     *   executionType: 'scheduled',
+     *   triggerMetadata: { scheduleType: 'cron', cronExpression: '0 9 * * *', timezone: 'America/New_York' }
+     * });
+     * ```
+     */
+    create(input) {
+        const path = getFunctionTriggersApiPath(this.workspaceId);
+        return this.requestFn('POST', path, input);
+    }
+    /**
+     * Update an existing function trigger.
+     *
+     * @param triggerId - The trigger UUID
+     * @param input - The fields to update
+     * @returns The updated trigger
+     *
+     * @example
+     * ```ts
+     * const updated = await client.triggers.update('trigger-uuid', {
+     *   name: 'Updated Trigger Name',
+     *   enabled: false
+     * });
+     * ```
+     */
+    update(triggerId, input) {
+        const path = getFunctionTriggersApiPath(this.workspaceId, triggerId);
+        return this.requestFn('PUT', path, input);
+    }
+    /**
+     * Delete a function trigger.
+     *
+     * @param triggerId - The trigger UUID
+     *
+     * @example
+     * ```ts
+     * await client.triggers.delete('trigger-uuid');
+     * ```
+     */
+    delete(triggerId) {
+        const path = getFunctionTriggersApiPath(this.workspaceId, triggerId);
+        return this.requestFn('DELETE', path);
+    }
+    /**
+     * List all triggers in the workspace (not filtered by execution type).
+     * Unlike `list()` which only returns on-demand triggers, `listAll()` returns
+     * triggers of all types with optional filtering.
+     *
+     * @param options - Optional list parameters (pagination, filtering, health)
+     * @returns List of triggers
+     *
+     * @example
+     * ```ts
+     * // List all triggers
+     * const all = await client.triggers.listAll();
+     *
+     * // Filter by execution type
+     * const scheduled = await client.triggers.listAll({ executionType: 'scheduled' });
+     *
+     * // Include health metrics
+     * const withHealth = await client.triggers.listAll({ includeHealth: true });
+     * ```
+     */
+    listAll(options) {
+        const path = getFunctionTriggersApiPath(this.workspaceId);
+        return this.requestFn('GET', path, null, options);
+    }
+    /**
+     * Get a trigger by ID with full details (no on-demand type restriction).
+     * Unlike `get()` which validates on-demand type, `getDetails()` returns
+     * any trigger type.
+     *
+     * @param triggerId - The trigger UUID
+     * @param options - Optional parameters (includeHealth)
+     * @returns The trigger details
+     *
+     * @example
+     * ```ts
+     * const trigger = await client.triggers.getDetails('trigger-uuid');
+     *
+     * // With health metrics
+     * const withHealth = await client.triggers.getDetails('trigger-uuid', { includeHealth: true });
+     * ```
+     */
+    getDetails(triggerId, options) {
+        const path = getFunctionTriggersApiPath(this.workspaceId, triggerId);
+        return this.requestFn('GET', path, null, options);
+    }
 }
 exports.TriggersManager = TriggersManager;
 // =====================================================
@@ -1133,6 +1293,92 @@ class SmartQueriesManager {
         const body = (options === null || options === void 0 ? void 0 : options.variables) ? { variables: options.variables } : undefined;
         return this.requestFn('POST', path, body);
     }
+    /**
+     * Create a new smart query for a structure.
+     *
+     * @param structureSlug - The structure's record slug
+     * @param input - The smart query definition
+     * @returns The created smart query
+     *
+     * @example
+     * ```ts
+     * const query = await client.smartQueries.create('orders', {
+     *   name: 'Active Orders',
+     *   description: 'All orders with active status',
+     *   queryDefinition: {
+     *     where: { status: { $eq: 'active' } },
+     *     sort: [{ field: 'createdAt', direction: 'desc' }],
+     *     limit: 100
+     *   }
+     * });
+     * ```
+     */
+    create(structureSlug, input) {
+        const path = getSmartQueriesStructureApiPath(this.workspaceId, structureSlug);
+        return this.requestFn('POST', path, input);
+    }
+    /**
+     * Update an existing smart query.
+     *
+     * @param structureSlug - The structure's record slug
+     * @param queryId - The smart query UUID
+     * @param input - The fields to update
+     * @returns The updated smart query
+     *
+     * @example
+     * ```ts
+     * const updated = await client.smartQueries.update('orders', 'query-uuid', {
+     *   name: 'Active Orders v2',
+     *   queryDefinition: {
+     *     where: { status: { $in: ['active', 'processing'] } },
+     *     limit: 200
+     *   }
+     * });
+     * ```
+     */
+    update(structureSlug, queryId, input) {
+        const path = getSmartQueriesStructureApiPath(this.workspaceId, structureSlug, queryId);
+        return this.requestFn('PUT', path, input);
+    }
+    /**
+     * Delete a smart query.
+     *
+     * @param structureSlug - The structure's record slug
+     * @param queryId - The smart query UUID
+     *
+     * @example
+     * ```ts
+     * await client.smartQueries.delete('orders', 'query-uuid');
+     * ```
+     */
+    delete(structureSlug, queryId) {
+        const path = getSmartQueriesStructureApiPath(this.workspaceId, structureSlug, queryId);
+        return this.requestFn('DELETE', path);
+    }
+    /**
+     * Test execute a query definition without saving it.
+     * Useful for validating query syntax and previewing results before creating.
+     *
+     * @param structureSlug - The structure's record slug
+     * @param input - The query definition to test and optional variables
+     * @returns Test execution results
+     *
+     * @example
+     * ```ts
+     * const result = await client.smartQueries.test('orders', {
+     *   queryDefinition: {
+     *     where: { amount: { $gte: 100 } },
+     *     select: ['id', 'amount', 'status'],
+     *     limit: 5
+     *   }
+     * });
+     * console.log('Preview results:', result.data);
+     * ```
+     */
+    test(structureSlug, input) {
+        const path = getSmartQueryTestApiPath(this.workspaceId, structureSlug);
+        return this.requestFn('POST', path, input);
+    }
 }
 exports.SmartQueriesManager = SmartQueriesManager;
 // =====================================================
@@ -1626,6 +1872,313 @@ class AllowedDomainsManager {
     }
 }
 exports.AllowedDomainsManager = AllowedDomainsManager;
+// =====================================================
+// Structures Manager (Configuration-as-Code)
+// =====================================================
+/**
+ * StructuresManager provides methods for managing data structures (schemas).
+ * Structures define the shape of records including properties, validation rules,
+ * and schema discovery modes.
+ * Access via `client.structures`.
+ *
+ * Usage:
+ * ```ts
+ * // List all structures
+ * const structures = await client.structures.list();
+ *
+ * // Create a new structure
+ * const structure = await client.structures.create({
+ *   name: 'Orders',
+ *   slug: 'orders',
+ *   properties: [
+ *     { name: 'title', type: 'string', required: true },
+ *     { name: 'amount', type: 'number', minimum: 0 }
+ *   ]
+ * });
+ *
+ * // Validate before creating
+ * const validation = await client.structures.validate({ slug: 'orders' });
+ * ```
+ */
+class StructuresManager {
+    constructor(workspaceId, requestFn) {
+        this.workspaceId = workspaceId;
+        this.requestFn = requestFn;
+    }
+    /**
+     * List all structures in the workspace.
+     *
+     * @param options - Optional list parameters (pagination)
+     * @returns List of structures
+     *
+     * @example
+     * ```ts
+     * const structures = await client.structures.list();
+     * const page2 = await client.structures.list({ page: 2, limit: 10 });
+     * ```
+     */
+    list(options) {
+        const path = getStructuresApiPath(this.workspaceId);
+        return this.requestFn('GET', path, null, options);
+    }
+    /**
+     * Get a structure by ID.
+     *
+     * @param structureId - The structure UUID
+     * @returns The structure details
+     *
+     * @example
+     * ```ts
+     * const structure = await client.structures.get('structure-uuid');
+     * console.log('Properties:', structure.data.properties.length);
+     * ```
+     */
+    get(structureId) {
+        const path = getStructuresApiPath(this.workspaceId, structureId);
+        return this.requestFn('GET', path);
+    }
+    /**
+     * Get a structure by its record slug.
+     *
+     * @param recordSlug - The structure's record slug (e.g., "orders")
+     * @returns The structure details
+     *
+     * @example
+     * ```ts
+     * const structure = await client.structures.getBySlug('orders');
+     * console.log('Structure name:', structure.data.name);
+     * ```
+     */
+    getBySlug(recordSlug) {
+        const path = getStructureBySlugApiPath(this.workspaceId, recordSlug);
+        return this.requestFn('GET', path);
+    }
+    /**
+     * Create a new structure.
+     *
+     * @param input - The structure definition
+     * @returns The created structure
+     *
+     * @example
+     * ```ts
+     * const structure = await client.structures.create({
+     *   name: 'Orders',
+     *   slug: 'orders',
+     *   description: 'Customer orders',
+     *   properties: [
+     *     { name: 'title', type: 'string', required: true },
+     *     { name: 'amount', type: 'number', minimum: 0 },
+     *     { name: 'status', type: 'string', enum: ['pending', 'completed'] }
+     *   ],
+     *   enableVersioning: true,
+     *   schemaDiscoveryMode: 'strict'
+     * });
+     * ```
+     */
+    create(input) {
+        const path = getStructuresApiPath(this.workspaceId);
+        return this.requestFn('POST', path, input);
+    }
+    /**
+     * Update an existing structure.
+     *
+     * @param structureId - The structure UUID
+     * @param input - The fields to update
+     * @returns The updated structure
+     *
+     * @example
+     * ```ts
+     * const updated = await client.structures.update('structure-uuid', {
+     *   name: 'Updated Orders',
+     *   properties: [
+     *     { name: 'title', type: 'string', required: true },
+     *     { name: 'amount', type: 'number', minimum: 0 },
+     *     { name: 'priority', type: 'number' }
+     *   ]
+     * });
+     * ```
+     */
+    update(structureId, input) {
+        const path = getStructuresApiPath(this.workspaceId, structureId);
+        return this.requestFn('PUT', path, input);
+    }
+    /**
+     * Delete a structure.
+     *
+     * @param structureId - The structure UUID
+     *
+     * @example
+     * ```ts
+     * await client.structures.delete('structure-uuid');
+     * ```
+     */
+    delete(structureId) {
+        const path = getStructuresApiPath(this.workspaceId, structureId);
+        return this.requestFn('DELETE', path);
+    }
+    /**
+     * Validate a structure definition without creating it.
+     * Useful for checking slug uniqueness and property validity before creation.
+     *
+     * @param input - The structure definition to validate
+     * @returns Validation result
+     *
+     * @example
+     * ```ts
+     * const result = await client.structures.validate({
+     *   slug: 'orders',
+     *   properties: [{ name: 'title', type: 'string' }]
+     * });
+     * ```
+     */
+    validate(input) {
+        const path = getStructureValidateApiPath(this.workspaceId);
+        return this.requestFn('POST', path, input);
+    }
+}
+exports.StructuresManager = StructuresManager;
+// =====================================================
+// Compute Functions Manager (Configuration-as-Code)
+// =====================================================
+/**
+ * ComputeFunctionsManager provides methods for managing compute functions.
+ * Compute functions are JavaScript code blocks that can be executed on triggers,
+ * schedules, or on-demand.
+ * Access via `client.functions`.
+ *
+ * Usage:
+ * ```ts
+ * // List all compute functions
+ * const fns = await client.functions.list();
+ *
+ * // Create a new function
+ * const fn = await client.functions.create({
+ *   name: 'Process Order',
+ *   slug: 'process-order',
+ *   code: 'module.exports = async (ctx) => { return { processed: true }; }'
+ * });
+ *
+ * // Test execute code without saving
+ * const result = await client.functions.testExecute({
+ *   code: 'module.exports = async (ctx) => { return ctx.input; }',
+ *   input: { orderId: '123' }
+ * });
+ * ```
+ */
+class ComputeFunctionsManager {
+    constructor(workspaceId, requestFn) {
+        this.workspaceId = workspaceId;
+        this.requestFn = requestFn;
+    }
+    /**
+     * List all compute functions in the workspace.
+     *
+     * @param options - Optional list parameters (pagination, search)
+     * @returns List of compute functions
+     *
+     * @example
+     * ```ts
+     * const fns = await client.functions.list();
+     * const searched = await client.functions.list({ search: 'order', limit: 10 });
+     * ```
+     */
+    list(options) {
+        const path = getComputeFunctionsApiPath(this.workspaceId);
+        return this.requestFn('GET', path, null, options);
+    }
+    /**
+     * Get a compute function by ID.
+     *
+     * @param functionId - The compute function UUID
+     * @returns The compute function details
+     *
+     * @example
+     * ```ts
+     * const fn = await client.functions.get('function-uuid');
+     * console.log('Function name:', fn.data.name);
+     * ```
+     */
+    get(functionId) {
+        const path = getComputeFunctionsApiPath(this.workspaceId, functionId);
+        return this.requestFn('GET', path);
+    }
+    /**
+     * Create a new compute function.
+     *
+     * @param input - The function definition
+     * @returns The created compute function
+     *
+     * @example
+     * ```ts
+     * const fn = await client.functions.create({
+     *   name: 'Process Order',
+     *   slug: 'process-order',
+     *   code: 'module.exports = async (ctx) => { return { processed: true }; }',
+     *   description: 'Processes incoming orders',
+     *   timeout: 60000
+     * });
+     * ```
+     */
+    create(input) {
+        const path = getComputeFunctionsApiPath(this.workspaceId);
+        return this.requestFn('POST', path, input);
+    }
+    /**
+     * Update an existing compute function.
+     *
+     * @param functionId - The compute function UUID
+     * @param input - The fields to update
+     * @returns The updated compute function
+     *
+     * @example
+     * ```ts
+     * const updated = await client.functions.update('function-uuid', {
+     *   code: 'module.exports = async (ctx) => { return { v2: true }; }',
+     *   timeout: 120000
+     * });
+     * ```
+     */
+    update(functionId, input) {
+        const path = getComputeFunctionsApiPath(this.workspaceId, functionId);
+        return this.requestFn('PUT', path, input);
+    }
+    /**
+     * Delete a compute function.
+     *
+     * @param functionId - The compute function UUID
+     *
+     * @example
+     * ```ts
+     * await client.functions.delete('function-uuid');
+     * ```
+     */
+    delete(functionId) {
+        const path = getComputeFunctionsApiPath(this.workspaceId, functionId);
+        return this.requestFn('DELETE', path);
+    }
+    /**
+     * Test execute code without saving it as a function.
+     * Useful for validating function code before creating/updating.
+     *
+     * @param input - The code to test and optional input data
+     * @returns Test execution result including output, duration, and logs
+     *
+     * @example
+     * ```ts
+     * const result = await client.functions.testExecute({
+     *   code: 'module.exports = async (ctx) => { return { sum: ctx.input.a + ctx.input.b }; }',
+     *   input: { a: 1, b: 2 }
+     * });
+     * console.log('Output:', result.data.output); // { sum: 3 }
+     * console.log('Duration:', result.data.duration_ms, 'ms');
+     * ```
+     */
+    testExecute(input) {
+        const path = getComputeFunctionTestApiPath(this.workspaceId);
+        return this.requestFn('POST', path, input);
+    }
+}
+exports.ComputeFunctionsManager = ComputeFunctionsManager;
 /**
  * Main Centrali SDK client.
  */
@@ -1639,6 +2192,8 @@ class CentraliSDK {
         this._validation = null;
         this._orchestrations = null;
         this._allowedDomains = null;
+        this._structures = null;
+        this._functions = null;
         this.isRefreshingToken = false;
         this.tokenRefreshPromise = null;
         this.options = options;
@@ -1907,6 +2462,61 @@ class CentraliSDK {
         }
         return this._allowedDomains;
     }
+    /**
+     * Structures namespace for managing data structures (schemas).
+     * Provides CRUD operations and validation for structure definitions.
+     *
+     * Usage:
+     * ```ts
+     * // List all structures
+     * const structures = await client.structures.list();
+     *
+     * // Create a structure
+     * const structure = await client.structures.create({
+     *   name: 'Orders',
+     *   slug: 'orders',
+     *   properties: [{ name: 'title', type: 'string', required: true }]
+     * });
+     *
+     * // Validate before creating
+     * const result = await client.structures.validate({ slug: 'orders' });
+     * ```
+     */
+    get structures() {
+        if (!this._structures) {
+            this._structures = new StructuresManager(this.options.workspaceId, this.request.bind(this));
+        }
+        return this._structures;
+    }
+    /**
+     * Functions namespace for managing compute functions.
+     * Provides CRUD operations and test execution for compute function code.
+     *
+     * Usage:
+     * ```ts
+     * // List all functions
+     * const fns = await client.functions.list();
+     *
+     * // Create a function
+     * const fn = await client.functions.create({
+     *   name: 'Process Order',
+     *   slug: 'process-order',
+     *   code: 'module.exports = async (ctx) => { return { ok: true }; }'
+     * });
+     *
+     * // Test execute without saving
+     * const result = await client.functions.testExecute({
+     *   code: 'module.exports = async (ctx) => { return ctx.input; }',
+     *   input: { test: true }
+     * });
+     * ```
+     */
+    get functions() {
+        if (!this._functions) {
+            this._functions = new ComputeFunctionsManager(this.options.workspaceId, this.request.bind(this));
+        }
+        return this._functions;
+    }
     /**
      * Manually set or update the bearer token for subsequent requests.
      */