@gooddata/sdk-backend-spi 11.35.0-alpha.5 → 11.35.0-alpha.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,46 +1 @@
1
- import { type ISeparators, type ISettings } from "@gooddata/sdk-model";
2
- /**
3
- * Settings for particular user.
4
- *
5
- * @public
6
- */
7
- export interface IUserSettings extends ISettings {
8
- /**
9
- * User to which the settings belong.
10
- */
11
- userId: string;
12
- /**
13
- * User locale
14
- */
15
- locale: string;
16
- /**
17
- * Regional number formatting
18
- */
19
- separators: ISeparators;
20
- }
21
- /**
22
- * Settings for particular workspace.
23
- *
24
- * @public
25
- */
26
- export interface IWorkspaceSettings extends ISettings {
27
- /**
28
- * Workspace to which the settings belong.
29
- */
30
- workspace: string;
31
- /**
32
- * Stores Mapbox token used for WS
33
- */
34
- mapboxToken?: string;
35
- /**
36
- * Stores AgGrid token used for WS
37
- */
38
- agGridToken?: string;
39
- }
40
- /**
41
- * Settings for particular combination of user and workspace.
42
- *
43
- * @public
44
- */
45
- export interface IUserWorkspaceSettings extends IUserSettings, IWorkspaceSettings {
46
- }
1
+ export type { IUserSettings, IWorkspaceSettings, IUserWorkspaceSettings } from "@gooddata/sdk-model";
@@ -1 +1,2 @@
1
+ // (C) 2020-2026 GoodData Corporation
1
2
  export {};
package/esm/index.d.ts CHANGED
@@ -20,7 +20,7 @@ export type { IGetInsightOptions, IGetVisualizationClassesOptions, IWorkspaceIns
20
20
  export type { ExportDefinitionOrdering, IExportDefinitionsQuery, IExportDefinitionsQueryOptions, IExportDefinitionsQueryResult, IGetExportDefinitionOptions, IWorkspaceExportDefinitionsService, ExportDefinitionQuerySortDirection, ExportDefinitionQuerySortProperty, ExportDefinitionQuerySort, } from "./workspace/exportDefinitions/index.js";
21
21
  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";
22
22
  export type { IExportConfig, IExportResult, IExportPdfConfig } from "./workspace/execution/export.js";
23
- 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 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 IChatSuggestionsItem, type IChatSuggestionsAction, isChatConversationError, isChatConversationItem, isChatConversationTextContent, isChatConversationReasoningContent, isChatConversationMultipartContent, isChatConversationToolCallContent, isChatConversationToolResultContent, isChatConversationVisualisationContent, isChatConversationKeyDriverAnalysisContent, isChatConversationWhatIfContent, isChatConversationSearchContent, isChatSuggestionsItem, } from "./workspace/genAI/index.js";
23
+ 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 IChatSuggestionsItem, type IChatSuggestionsAction, isChatConversationError, isChatConversationItem, isChatConversationTextContent, isChatConversationReasoningContent, isChatConversationMultipartContent, isChatConversationToolCallContent, isChatConversationToolResultContent, isChatConversationVisualisationContent, isChatConversationKeyDriverAnalysisContent, isChatConversationWhatIfContent, isChatConversationSearchContent, isChatSuggestionsItem, } from "./workspace/genAI/index.js";
24
24
  export type { IOrganizationGenAIService } from "./organization/genAI/index.js";
25
25
  export type { IReferencesResult, IReferencesOption, IReferencesService, } from "./workspace/references/index.js";
26
26
  export type { IWorkspaceStylingService } from "./workspace/styling/index.js";
@@ -145,6 +145,8 @@ import { IThemeDefinition } from '@gooddata/sdk-model';
145
145
  import { IThemeMetadataObject } from '@gooddata/sdk-model';
146
146
  import { IUser } from '@gooddata/sdk-model';
147
147
  import { IUserGroup } from '@gooddata/sdk-model';
148
+ import { IUserSettings } from '@gooddata/sdk-model';
149
+ import { IUserWorkspaceSettings } from '@gooddata/sdk-model';
148
150
  import type { IVisualizationClass } from '@gooddata/sdk-model';
149
151
  import { IWhiteLabeling } from '@gooddata/sdk-model';
150
152
  import { IWidget } from '@gooddata/sdk-model';
@@ -155,6 +157,7 @@ import { IWorkspaceDataFilter } from '@gooddata/sdk-model';
155
157
  import { IWorkspaceDataFilterDefinition } from '@gooddata/sdk-model';
156
158
  import { IWorkspacePermissionAssignment } from '@gooddata/sdk-model';
157
159
  import { IWorkspacePermissions } from '@gooddata/sdk-model';
160
+ import { IWorkspaceSettings } from '@gooddata/sdk-model';
158
161
  import { IWorkspaceUser } from '@gooddata/sdk-model';
159
162
  import { IWorkspaceUserGroup } from '@gooddata/sdk-model';
160
163
  import { LlmEndpointOpenAIPatch } from '@gooddata/sdk-model';
@@ -1638,6 +1641,10 @@ export declare type IChatConversation = {
1638
1641
  * Conversation title
1639
1642
  */
1640
1643
  title?: string;
1644
+ /**
1645
+ * Conversation pinned status
1646
+ */
1647
+ pinned?: boolean;
1641
1648
  };
1642
1649
 
1643
1650
  /**
@@ -1772,7 +1779,7 @@ export declare interface IChatConversations {
1772
1779
  /**
1773
1780
  * Updates the specified chat conversation with the provided updates.
1774
1781
  */
1775
- update(conversationId: string, update: Partial<Pick<IChatConversation, "title">>): Promise<IChatConversation>;
1782
+ update(conversationId: string, update: Partial<Pick<IChatConversation, "title" | "pinned">>): Promise<IChatConversation>;
1776
1783
  /**
1777
1784
  * Delete a conversation.
1778
1785
  */
@@ -2437,6 +2444,53 @@ export declare interface IDashboardsQuery {
2437
2444
  */
2438
2445
  export declare type IDashboardsQueryResult = IPagedResource<IListedDashboard>;
2439
2446
 
2447
+ /**
2448
+ * Response payload for AI dashboard summarization.
2449
+ * @beta
2450
+ */
2451
+ export declare interface IDashboardSummary {
2452
+ summary: string;
2453
+ filterContext: FilterContextItem[];
2454
+ visualizationsIncluded: IDashboardSummaryIncludedVisualization[];
2455
+ visualizationsExcluded: IDashboardSummaryExcludedVisualization[];
2456
+ generatedAt: string;
2457
+ }
2458
+
2459
+ /**
2460
+ * A visualization excluded from the AI dashboard summary, along with the reason.
2461
+ * @beta
2462
+ */
2463
+ export declare interface IDashboardSummaryExcludedVisualization {
2464
+ visualizationId: string;
2465
+ reason: string;
2466
+ title?: string | null;
2467
+ }
2468
+
2469
+ /**
2470
+ * A visualization included in the AI dashboard summary.
2471
+ * @beta
2472
+ */
2473
+ export declare interface IDashboardSummaryIncludedVisualization {
2474
+ visualizationId: string;
2475
+ title?: string | null;
2476
+ }
2477
+
2478
+ /**
2479
+ * Request payload for AI dashboard summarization.
2480
+ * @beta
2481
+ */
2482
+ export declare interface IDashboardSummaryRequest {
2483
+ dashboardId: string;
2484
+ /**
2485
+ * Visualizations to include in the summary. `null` means include all visualizations on the dashboard.
2486
+ */
2487
+ visualizations: string[] | null;
2488
+ /**
2489
+ * Filter context to apply when generating the summary. `null` means use all dashboard filters.
2490
+ */
2491
+ filterContext: FilterContextItem[] | null;
2492
+ }
2493
+
2440
2494
  /**
2441
2495
  * Result returned when the dashboard summary workflow is started.
2442
2496
  *
@@ -3962,6 +4016,13 @@ export declare interface IGenAIService {
3962
4016
  * Get check if LLM is configured.
3963
4017
  */
3964
4018
  getLlmConfigured(): Promise<boolean>;
4019
+ /**
4020
+ * Generate an AI summary of a dashboard for the given visualizations and filter context.
4021
+ * @beta
4022
+ */
4023
+ summarizeDashboard(request: IDashboardSummaryRequest, options?: {
4024
+ signal?: AbortSignal;
4025
+ }): Promise<IDashboardSummary>;
3965
4026
  }
3966
4027
 
3967
4028
  /**
@@ -7164,25 +7225,7 @@ export declare interface IUserService {
7164
7225
  getUserWithDetails(): Promise<IUser>;
7165
7226
  }
7166
7227
 
7167
- /**
7168
- * Settings for particular user.
7169
- *
7170
- * @public
7171
- */
7172
- export declare interface IUserSettings extends ISettings {
7173
- /**
7174
- * User to which the settings belong.
7175
- */
7176
- userId: string;
7177
- /**
7178
- * User locale
7179
- */
7180
- locale: string;
7181
- /**
7182
- * Regional number formatting
7183
- */
7184
- separators: ISeparators;
7185
- }
7228
+ export { IUserSettings }
7186
7229
 
7187
7230
  /**
7188
7231
  * This query service provides access to feature flags that are in effect for particular user.
@@ -7230,13 +7273,7 @@ export declare interface IUserSettingsService {
7230
7273
  setSeparators(separators: ISeparators): Promise<void>;
7231
7274
  }
7232
7275
 
7233
- /**
7234
- * Settings for particular combination of user and workspace.
7235
- *
7236
- * @public
7237
- */
7238
- export declare interface IUserWorkspaceSettings extends IUserSettings, IWorkspaceSettings {
7239
- }
7276
+ export { IUserWorkspaceSettings }
7240
7277
 
7241
7278
  /**
7242
7279
  * Pair of the widget and it's alert count
@@ -8688,25 +8725,7 @@ export declare interface IWorkspacePermissionsService {
8688
8725
  getPermissionsForCurrentUser(): Promise<IWorkspacePermissions>;
8689
8726
  }
8690
8727
 
8691
- /**
8692
- * Settings for particular workspace.
8693
- *
8694
- * @public
8695
- */
8696
- export declare interface IWorkspaceSettings extends ISettings {
8697
- /**
8698
- * Workspace to which the settings belong.
8699
- */
8700
- workspace: string;
8701
- /**
8702
- * Stores Mapbox token used for WS
8703
- */
8704
- mapboxToken?: string;
8705
- /**
8706
- * Stores AgGrid token used for WS
8707
- */
8708
- agGridToken?: string;
8709
- }
8728
+ export { IWorkspaceSettings }
8710
8729
 
8711
8730
  /**
8712
8731
  * This service provides access to settings for a particular workspace.
@@ -1,4 +1,4 @@
1
- import type { DateAttributeGranularity, GenAIChatInteractionUserFeedback, GenAIChatInteractionUserVisualisation, GenAIObjectType, IAllowedRelationshipType, IAttribute, IFilter, IGenAIChangeAnalysisParams, IGenAIChatInteraction, IGenAIChatReasoning, IGenAIChatRouting, IGenAICreatedVisualizations, IGenAIFoundObjects, IGenAIUserContext, IInsight, IMeasure, IMemoryItemDefinition, IMemoryItemMetadataObject, ISemanticQualityIssuesCalculation, ISemanticQualityReport, ISemanticSearchRelationship, ISemanticSearchResult, ISemanticSearchResultItem, IUser, MemoryItemStrategy, ObjRef, ObjectOrigin, ObjectType } from "@gooddata/sdk-model";
1
+ import type { DateAttributeGranularity, FilterContextItem, GenAIChatInteractionUserFeedback, GenAIChatInteractionUserVisualisation, GenAIObjectType, IAllowedRelationshipType, IAttribute, IFilter, IGenAIChangeAnalysisParams, IGenAIChatInteraction, IGenAIChatReasoning, IGenAIChatRouting, IGenAICreatedVisualizations, IGenAIFoundObjects, IGenAIUserContext, IInsight, IMeasure, IMemoryItemDefinition, IMemoryItemMetadataObject, ISemanticQualityIssuesCalculation, ISemanticQualityReport, ISemanticSearchRelationship, ISemanticSearchResult, ISemanticSearchResultItem, IUser, MemoryItemStrategy, ObjRef, ObjectOrigin, ObjectType } from "@gooddata/sdk-model";
2
2
  import type { IFilterBaseOptions } from "../../common/filtering.js";
3
3
  import type { IPagedResource } from "../../common/paging.js";
4
4
  /**
@@ -55,6 +55,56 @@ export interface IGenAIService {
55
55
  * Get check if LLM is configured.
56
56
  */
57
57
  getLlmConfigured(): Promise<boolean>;
58
+ /**
59
+ * Generate an AI summary of a dashboard for the given visualizations and filter context.
60
+ * @beta
61
+ */
62
+ summarizeDashboard(request: IDashboardSummaryRequest, options?: {
63
+ signal?: AbortSignal;
64
+ }): Promise<IDashboardSummary>;
65
+ }
66
+ /**
67
+ * Request payload for AI dashboard summarization.
68
+ * @beta
69
+ */
70
+ export interface IDashboardSummaryRequest {
71
+ dashboardId: string;
72
+ /**
73
+ * Visualizations to include in the summary. `null` means include all visualizations on the dashboard.
74
+ */
75
+ visualizations: string[] | null;
76
+ /**
77
+ * Filter context to apply when generating the summary. `null` means use all dashboard filters.
78
+ */
79
+ filterContext: FilterContextItem[] | null;
80
+ }
81
+ /**
82
+ * A visualization included in the AI dashboard summary.
83
+ * @beta
84
+ */
85
+ export interface IDashboardSummaryIncludedVisualization {
86
+ visualizationId: string;
87
+ title?: string | null;
88
+ }
89
+ /**
90
+ * A visualization excluded from the AI dashboard summary, along with the reason.
91
+ * @beta
92
+ */
93
+ export interface IDashboardSummaryExcludedVisualization {
94
+ visualizationId: string;
95
+ reason: string;
96
+ title?: string | null;
97
+ }
98
+ /**
99
+ * Response payload for AI dashboard summarization.
100
+ * @beta
101
+ */
102
+ export interface IDashboardSummary {
103
+ summary: string;
104
+ filterContext: FilterContextItem[];
105
+ visualizationsIncluded: IDashboardSummaryIncludedVisualization[];
106
+ visualizationsExcluded: IDashboardSummaryExcludedVisualization[];
107
+ generatedAt: string;
58
108
  }
59
109
  /**
60
110
  * Semantic search query.
@@ -608,7 +658,7 @@ export interface IChatConversations {
608
658
  /**
609
659
  * Updates the specified chat conversation with the provided updates.
610
660
  */
611
- update(conversationId: string, update: Partial<Pick<IChatConversation, "title">>): Promise<IChatConversation>;
661
+ update(conversationId: string, update: Partial<Pick<IChatConversation, "title" | "pinned">>): Promise<IChatConversation>;
612
662
  /**
613
663
  * Delete a conversation.
614
664
  */
@@ -682,6 +732,10 @@ export type IChatConversation = {
682
732
  * Conversation title
683
733
  */
684
734
  title?: string;
735
+ /**
736
+ * Conversation pinned status
737
+ */
738
+ pinned?: boolean;
685
739
  };
686
740
  /**
687
741
  * GenAI Chat Conversation error.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gooddata/sdk-backend-spi",
3
- "version": "11.35.0-alpha.5",
3
+ "version": "11.35.0-alpha.7",
4
4
  "description": "GoodData Backend SPI abstraction interfaces",
5
5
  "license": "MIT",
6
6
  "author": "GoodData",
@@ -24,7 +24,7 @@
24
24
  "lodash-es": "^4.17.23",
25
25
  "ts-invariant": "0.10.3",
26
26
  "tslib": "2.8.1",
27
- "@gooddata/sdk-model": "11.35.0-alpha.5"
27
+ "@gooddata/sdk-model": "11.35.0-alpha.7"
28
28
  },
29
29
  "devDependencies": {
30
30
  "@microsoft/api-documenter": "^7.17.0",
@@ -48,8 +48,8 @@
48
48
  "oxlint-tsgolint": "0.11.4",
49
49
  "typescript": "5.9.3",
50
50
  "vitest": "4.1.0",
51
- "@gooddata/eslint-config": "11.35.0-alpha.5",
52
- "@gooddata/oxlint-config": "11.35.0-alpha.5"
51
+ "@gooddata/eslint-config": "11.35.0-alpha.7",
52
+ "@gooddata/oxlint-config": "11.35.0-alpha.7"
53
53
  },
54
54
  "scripts": {
55
55
  "_phase:build": "npm run build",
@@ -59,7 +59,7 @@
59
59
  "build": "npm-run-all -p build-check build-ts && npm run api-extractor",
60
60
  "build-check": "tsgo",
61
61
  "build-ts": "tsgo -p tsconfig.build.json",
62
- "clean": "../../common/scripts/clean-command-state.sh && rm -rf ci dist esm coverage *.log tsconfig.tsbuildinfo",
62
+ "clean": "../../common/scripts/clean-command-state.sh && rm -rf ci dist esm coverage temp *.log tsconfig.tsbuildinfo",
63
63
  "dep-cruiser": "depcruise --validate .dependency-cruiser.js --output-type err-long src/",
64
64
  "format-check": "oxfmt --check .",
65
65
  "format-write": "oxfmt .",