@centrali-io/centrali-sdk 3.0.3 → 3.0.5

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.ValidationManager = exports.AnomalyInsightsManager = exports.SmartQueriesManager = exports.TriggersManager = exports.OrchestrationsManager = exports.RealtimeManager = void 0;
+exports.CentraliSDK = 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;
@@ -53,6 +53,7 @@ exports.getValidationScanApiPath = getValidationScanApiPath;
 exports.getOrchestrationsApiPath = getOrchestrationsApiPath;
 exports.getOrchestrationRunsApiPath = getOrchestrationRunsApiPath;
 exports.getOrchestrationRunStepsApiPath = getOrchestrationRunStepsApiPath;
+exports.getAllowedDomainsApiPath = getAllowedDomainsApiPath;
 const axios_1 = __importDefault(require("axios"));
 const qs_1 = __importDefault(require("qs"));
 const eventsource_1 = require("eventsource");
@@ -538,6 +539,13 @@ function getOrchestrationRunsApiPath(workspaceId, orchestrationId, runId) {
 function getOrchestrationRunStepsApiPath(workspaceId, orchestrationId, runId) {
     return `orchestration/ws/${workspaceId}/api/v1/orchestrations/${orchestrationId}/runs/${runId}/steps`;
 }
+/**
+ * Generate Allowed Domains API URL PATH.
+ */
+function getAllowedDomainsApiPath(workspaceId, domainId) {
+    const basePath = `data/workspace/${workspaceId}/api/v1/settings/allowed-domains`;
+    return domainId ? `${basePath}/${domainId}` : basePath;
+}
 // =====================================================
 // Orchestrations Manager
 // =====================================================
@@ -1546,6 +1554,78 @@ class ValidationManager {
     }
 }
 exports.ValidationManager = ValidationManager;
+// =====================================================
+// Allowed Domains Manager
+// =====================================================
+/**
+ * AllowedDomainsManager provides methods for managing allowed domains for compute function external calls.
+ * Access via `client.allowedDomains`.
+ *
+ * Usage:
+ * ```ts
+ * // List all allowed domains
+ * const domains = await client.allowedDomains.list();
+ *
+ * // Add a new domain
+ * const domain = await client.allowedDomains.add({ domain: 'api.example.com' });
+ *
+ * // Remove a domain
+ * await client.allowedDomains.remove('domain-id');
+ * ```
+ */
+class AllowedDomainsManager {
+    constructor(workspaceId, requestFn) {
+        this.workspaceId = workspaceId;
+        this.requestFn = requestFn;
+    }
+    /**
+     * List all allowed domains in the workspace.
+     *
+     * @returns List of allowed domains with total count
+     *
+     * @example
+     * ```ts
+     * const result = await client.allowedDomains.list();
+     * console.log('Total domains:', result.meta.total);
+     * result.data.forEach(d => console.log(d.domain));
+     * ```
+     */
+    list() {
+        const path = getAllowedDomainsApiPath(this.workspaceId);
+        return this.requestFn('GET', path);
+    }
+    /**
+     * Add a new allowed domain.
+     *
+     * @param options - The domain to add
+     * @returns The created allowed domain entry
+     *
+     * @example
+     * ```ts
+     * const result = await client.allowedDomains.add({ domain: 'api.stripe.com' });
+     * console.log('Added:', result.data.domain, result.data.id);
+     * ```
+     */
+    add(options) {
+        const path = getAllowedDomainsApiPath(this.workspaceId);
+        return this.requestFn('POST', path, { domain: options.domain });
+    }
+    /**
+     * Remove an allowed domain by ID.
+     *
+     * @param domainId - The ID of the domain to remove
+     *
+     * @example
+     * ```ts
+     * await client.allowedDomains.remove('domain-id-123');
+     * ```
+     */
+    remove(domainId) {
+        const path = getAllowedDomainsApiPath(this.workspaceId, domainId);
+        return this.requestFn('DELETE', path);
+    }
+}
+exports.AllowedDomainsManager = AllowedDomainsManager;
 /**
  * Main Centrali SDK client.
  */
@@ -1558,6 +1638,7 @@ class CentraliSDK {
         this._anomalyInsights = null;
         this._validation = null;
         this._orchestrations = null;
+        this._allowedDomains = null;
         this.isRefreshingToken = false;
         this.tokenRefreshPromise = null;
         this.options = options;
@@ -1805,6 +1886,27 @@ class CentraliSDK {
         }
         return this._orchestrations;
     }
+    /**
+     * Allowed Domains namespace for managing compute function external call domains.
+     *
+     * Usage:
+     * ```ts
+     * // List all allowed domains
+     * const domains = await client.allowedDomains.list();
+     *
+     * // Add a new domain
+     * const domain = await client.allowedDomains.add({ domain: 'api.stripe.com' });
+     *
+     * // Remove a domain
+     * await client.allowedDomains.remove('domain-id');
+     * ```
+     */
+    get allowedDomains() {
+        if (!this._allowedDomains) {
+            this._allowedDomains = new AllowedDomainsManager(this.options.workspaceId, this.request.bind(this));
+        }
+        return this._allowedDomains;
+    }
     /**
      * Manually set or update the bearer token for subsequent requests.
      */
@@ -1940,6 +2042,26 @@ class CentraliSDK {
         const path = getRecordApiPath(this.options.workspaceId, recordSlug, id);
         return this.request('PUT', path, Object.assign({}, updates));
     }
+    /**
+     * Upsert a record: find by match fields, update if exists, create if not.
+     * Uses advisory locking for atomicity — safe for concurrent calls.
+     *
+     * @param recordSlug - The structure's record slug
+     * @param options - { match: key-value pairs to find existing record, data: full record data }
+     * @returns Response where result.data is the record and result.operation indicates create/update
+     *
+     * @example
+     * const result = await client.upsertRecord('HourlyRollup', {
+     *   match: { metricKey: 'pageviews', bucketHour: '2025-01-01T10:00' },
+     *   data: { metricKey: 'pageviews', bucketHour: '2025-01-01T10:00', count: 42 },
+     * });
+     * // result.data → the record
+     * // result.operation → 'created' or 'updated'
+     */
+    upsertRecord(recordSlug, options) {
+        const path = getRecordApiPath(this.options.workspaceId, recordSlug) + '/upsert';
+        return this.request('POST', path, { match: options.match, data: options.data });
+    }
     /** Delete a record by ID (soft delete by default, can be restored). */
     deleteRecord(recordSlug, id, options) {
         const path = getRecordApiPath(this.options.workspaceId, recordSlug, id);

package/index.ts

@@ -539,6 +539,36 @@ export interface DeleteRecordOptions {
     hard?: boolean;
 }
 
+// =====================================================
+// Allowed Domains Types
+// =====================================================
+
+/**
+ * An allowed domain entry for compute function external calls.
+ */
+export interface AllowedDomain {
+    id: string;
+    domain: string;
+    createdAt: string;
+    createdBy: string;
+}
+
+/**
+ * Response from listing allowed domains.
+ */
+export interface AllowedDomainsListResponse {
+    data: AllowedDomain[];
+    meta: { total: number };
+}
+
+/**
+ * Options for adding an allowed domain.
+ */
+export interface AddAllowedDomainOptions {
+    /** The domain to allow (e.g., 'api.example.com'). No protocol prefix. */
+    domain: string;
+}
+
 /**
  * Options for expanding reference fields when fetching records.
  * Expanded data is placed in the `_expanded` object within the record's data.
@@ -2154,6 +2184,14 @@ export function getOrchestrationRunStepsApiPath(workspaceId: string, orchestrati
     return `orchestration/ws/${workspaceId}/api/v1/orchestrations/${orchestrationId}/runs/${runId}/steps`;
 }
 
+/**
+ * Generate Allowed Domains API URL PATH.
+ */
+export function getAllowedDomainsApiPath(workspaceId: string, domainId?: string): string {
+    const basePath = `data/workspace/${workspaceId}/api/v1/settings/allowed-domains`;
+    return domainId ? `${basePath}/${domainId}` : basePath;
+}
+
 // =====================================================
 // Orchestrations Manager
 // =====================================================
@@ -3262,6 +3300,88 @@ export class ValidationManager {
     }
 }
 
+// =====================================================
+// Allowed Domains Manager
+// =====================================================
+
+/**
+ * AllowedDomainsManager provides methods for managing allowed domains for compute function external calls.
+ * Access via `client.allowedDomains`.
+ *
+ * Usage:
+ * ```ts
+ * // List all allowed domains
+ * const domains = await client.allowedDomains.list();
+ *
+ * // Add a new domain
+ * const domain = await client.allowedDomains.add({ domain: 'api.example.com' });
+ *
+ * // Remove a domain
+ * await client.allowedDomains.remove('domain-id');
+ * ```
+ */
+export class AllowedDomainsManager {
+    private requestFn: <T>(method: Method, path: string, data?: any, queryParams?: Record<string, any>) => Promise<ApiResponse<T>>;
+    private workspaceId: string;
+
+    constructor(
+        workspaceId: string,
+        requestFn: <T>(method: Method, path: string, data?: any, queryParams?: Record<string, any>) => Promise<ApiResponse<T>>
+    ) {
+        this.workspaceId = workspaceId;
+        this.requestFn = requestFn;
+    }
+
+    /**
+     * List all allowed domains in the workspace.
+     *
+     * @returns List of allowed domains with total count
+     *
+     * @example
+     * ```ts
+     * const result = await client.allowedDomains.list();
+     * console.log('Total domains:', result.meta.total);
+     * result.data.forEach(d => console.log(d.domain));
+     * ```
+     */
+    public list(): Promise<ApiResponse<AllowedDomain[]>> {
+        const path = getAllowedDomainsApiPath(this.workspaceId);
+        return this.requestFn<AllowedDomain[]>('GET', path);
+    }
+
+    /**
+     * Add a new allowed domain.
+     *
+     * @param options - The domain to add
+     * @returns The created allowed domain entry
+     *
+     * @example
+     * ```ts
+     * const result = await client.allowedDomains.add({ domain: 'api.stripe.com' });
+     * console.log('Added:', result.data.domain, result.data.id);
+     * ```
+     */
+    public add(options: AddAllowedDomainOptions): Promise<ApiResponse<AllowedDomain>> {
+        const path = getAllowedDomainsApiPath(this.workspaceId);
+        return this.requestFn<AllowedDomain>('POST', path, { domain: options.domain });
+    }
+
+    /**
+     * Remove an allowed domain by ID.
+     *
+     * @param domainId - The ID of the domain to remove
+     *
+     * @example
+     * ```ts
+     * await client.allowedDomains.remove('domain-id-123');
+     * ```
+     */
+    public remove(domainId: string): Promise<ApiResponse<void>> {
+        const path = getAllowedDomainsApiPath(this.workspaceId, domainId);
+        return this.requestFn<void>('DELETE', path);
+    }
+}
+
 /**
  * Main Centrali SDK client.
  */
@@ -3275,6 +3395,7 @@ export class CentraliSDK {
     private _anomalyInsights: AnomalyInsightsManager | null = null;
     private _validation: ValidationManager | null = null;
     private _orchestrations: OrchestrationsManager | null = null;
+    private _allowedDomains: AllowedDomainsManager | null = null;
     private isRefreshingToken: boolean = false;
     private tokenRefreshPromise: Promise<string> | null = null;
 
@@ -3577,6 +3698,31 @@ export class CentraliSDK {
         return this._orchestrations;
     }
 
+    /**
+     * Allowed Domains namespace for managing compute function external call domains.
+     *
+     * Usage:
+     * ```ts
+     * // List all allowed domains
+     * const domains = await client.allowedDomains.list();
+     *
+     * // Add a new domain
+     * const domain = await client.allowedDomains.add({ domain: 'api.stripe.com' });
+     *
+     * // Remove a domain
+     * await client.allowedDomains.remove('domain-id');
+     * ```
+     */
+    public get allowedDomains(): AllowedDomainsManager {
+        if (!this._allowedDomains) {
+            this._allowedDomains = new AllowedDomainsManager(
+                this.options.workspaceId,
+                this.request.bind(this)
+            );
+        }
+        return this._allowedDomains;
+    }
+
     /**
      * Manually set or update the bearer token for subsequent requests.
      */
@@ -3753,6 +3899,30 @@ export class CentraliSDK {
         return this.request('PUT', path, {  ...updates });
     }
 
+    /**
+     * Upsert a record: find by match fields, update if exists, create if not.
+     * Uses advisory locking for atomicity — safe for concurrent calls.
+     *
+     * @param recordSlug - The structure's record slug
+     * @param options - { match: key-value pairs to find existing record, data: full record data }
+     * @returns Response where result.data is the record and result.operation indicates create/update
+     *
+     * @example
+     * const result = await client.upsertRecord('HourlyRollup', {
+     *   match: { metricKey: 'pageviews', bucketHour: '2025-01-01T10:00' },
+     *   data: { metricKey: 'pageviews', bucketHour: '2025-01-01T10:00', count: 42 },
+     * });
+     * // result.data → the record
+     * // result.operation → 'created' or 'updated'
+     */
+    public upsertRecord<T = any>(
+        recordSlug: string,
+        options: { match: Record<string, any>; data: Record<string, any> }
+    ): Promise<ApiResponse<T> & { operation: 'created' | 'updated' }> {
+        const path = getRecordApiPath(this.options.workspaceId, recordSlug) + '/upsert';
+        return this.request('POST', path, { match: options.match, data: options.data }) as Promise<ApiResponse<T> & { operation: 'created' | 'updated' }>;
+    }
+
     /** Delete a record by ID (soft delete by default, can be restored). */
     public deleteRecord(
         recordSlug: string,

package/package.json

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