@gooddata/sdk-backend-spi 11.41.0-alpha.0 → 11.41.0-alpha.2

package/esm/index.d.ts

@@ -21,7 +21,7 @@ export type { ExportDefinitionOrdering, IExportDefinitionsQuery, IExportDefiniti
 export { type IElementsQueryFactory, type IElementsQueryResult, type IElementsQuery, type IElementsQueryOptions, type IElementsQueryAttributeFilter, type IElementsQueryOptionsElementsByUri, type IElementsQueryOptionsElementsByValue, type IElementsQueryOptionsElementsByPrimaryDisplayFormValue, type ElementsQueryOptionsElementsSpecification, type IFilterElementsQuery, type FilterWithResolvableElements, isElementsQueryOptionsElementsByValue, isElementsQueryOptionsElementsByPrimaryDisplayFormValue, isValueBasedElementsQueryOptionsElements, } from "./workspace/attributes/elements/index.js";
 export type { IExportConfig, IExportResult, IExportPdfConfig } from "./workspace/execution/export.js";
 export { type AnalyticsCatalogGenerateTitleObjectType, type IAnalyticsCatalogGenerateTitleRequest, type IAnalyticsCatalogGenerateTitleResponse, type IAnalyticsCatalogTrendingObject, type IAnalyticsCatalogTrendingObjects, type IKnowledgeDocumentsService, type IKnowledgeDocumentMetadata, type ICreateKnowledgeDocumentRequest, type IUpsertKnowledgeDocumentRequest, type IDeleteKnowledgeDocumentResponse, type IPatchKnowledgeDocumentRequest, type IKnowledgeSearchResult, type IKnowledgeSearchStatistics, type ISearchKnowledgeResponse, type ISearchKnowledgeOptions, type IListKnowledgeDocumentsOptions, type IKnowledgeDocumentsPage, type AnalyticsCatalogGenerateDescriptionObjectType, type IAnalyticsCatalogGenerateDescriptionRequest, type IAnalyticsCatalogGenerateDescriptionResponse, type IGenAIService, type IDashboardSummaryRequest, type IDashboardSummary, type IDashboardSummaryIncludedVisualization, type IDashboardSummaryExcludedVisualization, type IAnalyticsCatalogService, type IAnalyticsCatalogTags, type IAnalyticsCatalogCreatedBy, type ISemanticSearchQuery, type ISemanticSearchResult, type IChatThread, type IChatThreadHistory, type IChatThreadQuery, type IGenAIChatEvaluation, type ISemanticQualityService, type IMemoryItemsService, type IMemoryCreatedByUsers, type IMemoryItemsQuery, type IMemoryItemsFilterOptions, type IMemoryItemsQueryResult, type IChatConversationError, type IChatConversationThread, type IChatConversationThreadQuery, type IChatConversation, type IChatConversationItem, type IChatConversationItemsQuery, type IChatConversationItemsQueryResult, type IChatConversationFeedback, type IChatConversations, type IChatConversationContent, type IChatConversationMultipartContent, type IChatConversationKeyDriverAnalysisContent, type IChatConversationWhatIfContent, type IChatConversationReasoningContent, type IChatConversationMultipartPart, type IChatConversationToolCallContent, type IChatConversationTextContent, type IChatConversationToolResultContent, type IChatConversationVisualisationContent, type IChatConversationSearchContent, type IChatKdaDefinition, type IChatWhatIfDefinition, type IChatWhatIfAdjustment, type IChatWhatIfScenario, type IChatSuggestion, type IChatSuggestions, isChatConversationError, isChatConversationItem, isChatConversationTextContent, isChatConversationReasoningContent, isChatConversationMultipartContent, isChatConversationToolCallContent, isChatConversationToolResultContent, isChatConversationVisualisationContent, isChatConversationKeyDriverAnalysisContent, isChatConversationWhatIfContent, isChatConversationSearchContent, } from "./workspace/genAI/index.js";
-export type { IOrganizationGenAIService } from "./organization/genAI/index.js";
+export type { IOrganizationAIObservabilityMetric, IOrganizationAIObservabilityMetricType, IOrganizationAIObservabilityOverview, IOrganizationAIObservabilityService, IOrganizationGenAIService, } from "./organization/genAI/index.js";
 export type { IReferencesResult, IReferencesOption, IReferencesService, } from "./workspace/references/index.js";
 export type { IWorkspaceStylingService } from "./workspace/styling/index.js";
 export { type AuthenticationFlow, type IDataTooLargeResponseBody, type IDataTooLargeResponseBodyLimitBreak, type IDataTooLargeResponseBodyStructuredDetail, type ErrorConverter, type NotAuthenticatedReason, AnalyticalBackendError, NoDataError, DataTooLargeError, TimeoutError, ProtectedDataError, UnexpectedResponseError, UnexpectedError, NotSupported, NotImplemented, NotAuthenticated, LimitReached, ContractExpired, AbortError, isAnalyticalBackendError, isNoDataError, isDataTooLargeError, isProtectedDataError, isUnexpectedResponseError, isUnexpectedError, isNotSupported, isNotImplemented, isNotAuthenticated, isLimitReached, isContractExpired, AnalyticalBackendErrorTypes, isAbortError, } from "./errors/index.js";
@@ -56,6 +56,7 @@ export type { IOrganizationUserService, IOrganizationUsersQuery, IOrganizationUs
 export type { IOrganizationPermissionService, IPermissionsAssignment, } from "./organization/permissions/index.js";
 export type { IOrganizationNotificationChannelService } from "./organization/notificationChannels/index.js";
 export type { IOrganizationGeoCollectionsService } from "./organization/geoCollections/index.js";
+export type { IOrganizationIpAllowlistService } from "./organization/ipAllowlists/index.js";
 export type { INotificationChannelsQuery, INotificationChannelsQueryResult, INotificationChannelIdentifiersQueryResult, } from "./organization/notificationChannels/query.js";
 export type { IDataFiltersService } from "./workspace/dataFilter/index.js";
 export type { IWorkspaceLogicalModelService, IDateDataset } from "./workspace/ldm/model.js";

package/esm/organization/genAI/index.d.ts

@@ -1,4 +1,48 @@
 import { type IKnowledgeDocumentsService } from "../../workspace/genAI/index.js";
+/**
+ * AI observability metric type.
+ *
+ * @alpha
+ */
+export type IOrganizationAIObservabilityMetricType = "AI_WORKSPACES" | "AI_USERS" | "AI_QUERIES";
+/**
+ * AI observability metric for the caller's organization.
+ *
+ * @alpha
+ */
+export interface IOrganizationAIObservabilityMetric {
+    /**
+     * Metric type.
+     */
+    type: IOrganizationAIObservabilityMetricType;
+    /**
+     * Metric value for the current calendar month.
+     */
+    currentValue: number;
+    /**
+     * Metric value for the previous calendar month.
+     */
+    previousValue: number;
+}
+/**
+ * AI observability overview for the caller's organization.
+ *
+ * @alpha
+ */
+export interface IOrganizationAIObservabilityOverview {
+    metrics: IOrganizationAIObservabilityMetric[];
+}
+/**
+ * Service for querying AI observability metrics.
+ *
+ * @alpha
+ */
+export interface IOrganizationAIObservabilityService {
+    /**
+     * Returns AI observability overview for the caller's organization.
+     */
+    getOverview(): Promise<IOrganizationAIObservabilityOverview>;
+}
 /**
  * Service to query and manage organization-level generative-AI resources.
  *
@@ -9,4 +53,8 @@ export interface IOrganizationGenAIService {
      * Returns a service for listing and managing organization-level knowledge documents.
      */
     getKnowledgeDocuments(): IKnowledgeDocumentsService;
+    /**
+     * Returns a service for querying organization-level AI observability metrics.
+     */
+    getObservability(): IOrganizationAIObservabilityService;
 }

package/esm/organization/index.d.ts

@@ -3,6 +3,7 @@ import { type IOrganizationAgentsService } from "./agents/index.js";
 import { type IOrganizationAutomationService } from "./automations/index.js";
 import { type IOrganizationExportTemplatesService } from "./exportTemplates/index.js";
 import { type IOrganizationGenAIService } from "./genAI/index.js";
+import { type IOrganizationIpAllowlistService } from "./ipAllowlists/index.js";
 import { type IOrganizationLlmProvidersService } from "./llmProviders/index.js";
 import { type IOrganizationNotificationChannelService } from "./notificationChannels/index.js";
 import { type IOrganizationNotificationService } from "./notifications/index.js";
@@ -90,6 +91,12 @@ export interface IOrganization {
      * @beta
      */
     exportTemplates(): IOrganizationExportTemplatesService;
+    /**
+     * Returns service that can be used to manage organization-level IP allowlist policies.
+     *
+     * @alpha
+     */
+    ipAllowlists(): IOrganizationIpAllowlistService;
 }
 /**
  * Provides functions to obtain {@link IOrganization} instances

package/esm/organization/ipAllowlists/index.d.ts

@@ -0,0 +1,34 @@
+import { type IIpAllowlist, type IIpAllowlistDefinition } from "@gooddata/sdk-model";
+/**
+ * Service for managing organization-level IP allowlist policies.
+ *
+ * @alpha
+ */
+export interface IOrganizationIpAllowlistService {
+    /**
+     * Get all IP allowlist policies defined for the organization.
+     *
+     * @returns Promise resolved with an array of policies (empty when none exist).
+     */
+    getAll(): Promise<IIpAllowlist[]>;
+    /**
+     * Create a new IP allowlist policy.
+     *
+     * @param definition - definition of the policy to create
+     * @returns Promise resolved with the created policy.
+     */
+    create(definition: IIpAllowlistDefinition): Promise<IIpAllowlist>;
+    /**
+     * Replace an existing IP allowlist policy (PUT semantics).
+     *
+     * @param definition - full definition of the policy; `id` identifies the target
+     * @returns Promise resolved with the updated policy.
+     */
+    update(definition: IIpAllowlistDefinition): Promise<IIpAllowlist>;
+    /**
+     * Delete an IP allowlist policy by its identifier.
+     *
+     * @param id - identifier of the policy to delete
+     */
+    delete(id: string): Promise<void>;
+}

package/esm/organization/ipAllowlists/index.js

@@ -0,0 +1,2 @@
+// (C) 2026 GoodData Corporation
+export {};

package/esm/sdk-backend-spi.d.ts

@@ -98,6 +98,8 @@ import { IGeoJsonFeature } from '@gooddata/sdk-model';
 import { IGranularAccessGrantee } from '@gooddata/sdk-model';
 import { IInsight } from '@gooddata/sdk-model';
 import { IInsightDefinition } from '@gooddata/sdk-model';
+import { IIpAllowlist } from '@gooddata/sdk-model';
+import { IIpAllowlistDefinition } from '@gooddata/sdk-model';
 import type { IListedDashboard } from '@gooddata/sdk-model';
 import { ILlmProvider } from '@gooddata/sdk-model';
 import { IMeasure } from '@gooddata/sdk-model';
@@ -1667,7 +1669,7 @@ export declare type IChatConversationError = {
     code: number;
     message: string;
     traceId?: string;
-    reason?: (string & {}) | "METADATA_SYNC_IN_PROGRESS" | "METADATA_SYNC_REQUEST_ERROR";
+    reason?: (string & {}) | "METADATA_SYNC_IN_PROGRESS" | "METADATA_SYNC_REQUEST_ERROR" | "MODEL_NOT_COMPATIBLE";
 };
 
 /**
@@ -5199,6 +5201,12 @@ export declare interface IOrganization {
      * @beta
      */
     exportTemplates(): IOrganizationExportTemplatesService;
+    /**
+     * Returns service that can be used to manage organization-level IP allowlist policies.
+     *
+     * @alpha
+     */
+    ipAllowlists(): IOrganizationIpAllowlistService;
 }
 
 /**
@@ -5256,6 +5264,54 @@ export declare interface IOrganizationAgentsService {
     deleteAgent(ref: ObjRef): Promise<void>;
 }
 
+/**
+ * AI observability metric for the caller's organization.
+ *
+ * @alpha
+ */
+export declare interface IOrganizationAIObservabilityMetric {
+    /**
+     * Metric type.
+     */
+    type: IOrganizationAIObservabilityMetricType;
+    /**
+     * Metric value for the current calendar month.
+     */
+    currentValue: number;
+    /**
+     * Metric value for the previous calendar month.
+     */
+    previousValue: number;
+}
+
+/**
+ * AI observability metric type.
+ *
+ * @alpha
+ */
+export declare type IOrganizationAIObservabilityMetricType = "AI_WORKSPACES" | "AI_USERS" | "AI_QUERIES";
+
+/**
+ * AI observability overview for the caller's organization.
+ *
+ * @alpha
+ */
+export declare interface IOrganizationAIObservabilityOverview {
+    metrics: IOrganizationAIObservabilityMetric[];
+}
+
+/**
+ * Service for querying AI observability metrics.
+ *
+ * @alpha
+ */
+export declare interface IOrganizationAIObservabilityService {
+    /**
+     * Returns AI observability overview for the caller's organization.
+     */
+    getOverview(): Promise<IOrganizationAIObservabilityOverview>;
+}
+
 /**
  * This service provides access to organization-wide automations for centralized automation management.
  * It allows managing automations across all workspaces within the organization.
@@ -5496,6 +5552,10 @@ export declare interface IOrganizationGenAIService {
      * Returns a service for listing and managing organization-level knowledge documents.
      */
     getKnowledgeDocuments(): IKnowledgeDocumentsService;
+    /**
+     * Returns a service for querying organization-level AI observability metrics.
+     */
+    getObservability(): IOrganizationAIObservabilityService;
 }
 
 /**
@@ -5566,6 +5626,40 @@ export declare interface IOrganizationGeoCollectionsService {
     importGeoCollectionFile(collectionId: string, location: string): Promise<void>;
 }
 
+/**
+ * Service for managing organization-level IP allowlist policies.
+ *
+ * @alpha
+ */
+export declare interface IOrganizationIpAllowlistService {
+    /**
+     * Get all IP allowlist policies defined for the organization.
+     *
+     * @returns Promise resolved with an array of policies (empty when none exist).
+     */
+    getAll(): Promise<IIpAllowlist[]>;
+    /**
+     * Create a new IP allowlist policy.
+     *
+     * @param definition - definition of the policy to create
+     * @returns Promise resolved with the created policy.
+     */
+    create(definition: IIpAllowlistDefinition): Promise<IIpAllowlist>;
+    /**
+     * Replace an existing IP allowlist policy (PUT semantics).
+     *
+     * @param definition - full definition of the policy; `id` identifies the target
+     * @returns Promise resolved with the updated policy.
+     */
+    update(definition: IIpAllowlistDefinition): Promise<IIpAllowlist>;
+    /**
+     * Delete an IP allowlist policy by its identifier.
+     *
+     * @param id - identifier of the policy to delete
+     */
+    delete(id: string): Promise<void>;
+}
+
 /**
  * This service provides access to organization llm providers configuration.
  *

package/esm/workspace/genAI/index.d.ts

@@ -746,7 +746,7 @@ export type IChatConversationError = {
     code: number;
     message: string;
     traceId?: string;
-    reason?: (string & {}) | "METADATA_SYNC_IN_PROGRESS" | "METADATA_SYNC_REQUEST_ERROR";
+    reason?: (string & {}) | "METADATA_SYNC_IN_PROGRESS" | "METADATA_SYNC_REQUEST_ERROR" | "MODEL_NOT_COMPATIBLE";
 };
 /**
  * Is chat conversation error

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-backend-spi",
-  "version": "11.41.0-alpha.0",
+  "version": "11.41.0-alpha.2",
   "description": "GoodData Backend SPI abstraction interfaces",
   "license": "MIT",
   "author": "GoodData",
@@ -24,7 +24,7 @@
     "lodash-es": "^4.17.23",
     "ts-invariant": "0.10.3",
     "tslib": "2.8.1",
-    "@gooddata/sdk-model": "11.41.0-alpha.0"
+    "@gooddata/sdk-model": "11.41.0-alpha.2"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "^7.17.0",
@@ -48,8 +48,8 @@
     "oxlint-tsgolint": "0.15.0",
     "typescript": "5.9.3",
     "vitest": "4.1.8",
-    "@gooddata/eslint-config": "11.41.0-alpha.0",
-    "@gooddata/oxlint-config": "11.41.0-alpha.0"
+    "@gooddata/oxlint-config": "11.41.0-alpha.2",
+    "@gooddata/eslint-config": "11.41.0-alpha.2"
   },
   "scripts": {
     "_phase:build": "npm run build",