@keboola/api-client 2.0.0 → 3.0.1

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 import { G as GetAllFeaturesQuery, F as Feature, c as components$5, C as CreateMaintainerBody, U as UpdateMaintainerBody, M as MaintainerUser, A as AddMaintainerUserBody, a as CreateMaintainerInvitationBody, b as CreateMaintainerOrganizationBody, d as MetadataItem, S as SetMaintainerMetadataBody, O as OrganizationDetail, e as UpdateOrganizationBody, f as AddOrganizationUserBody, g as CreateOrganizationInvitationBody, P as Project, h as CreateOrganizationProjectBody, i as SetOrganizationMetadataBody, j as GetProjectPath, k as CreateProjectFeaturePath, l as CreateProjectFeatureBody, R as RemoveProjectFeaturePath, m as User, L as ListProjectUsersPath, n as GetProjectMetadataPath, o as ProjectMetadataItem, p as SetProjectMetadataPath, q as SetProjectMetadataBody, r as GetProjectReviewersPath, s as Reviewer, t as SetProjectReviewersPath, u as SetProjectReviewersBody, v as AddUserFeatureBody, w as AddUserFeaturePath, x as RemoveUserFeaturePath } from './types-BTcT8Q0T.js';
-import { M as MiddlewareFn, B as BaseClientOptions, A as ApiResponse, H as HttpMethod } from './types-DgaMV8FF.js';
-export { c as ApiError, d as CreateCallbackMiddlewareOptions, e as FetchClientError, i as isAbortError, f as isApiError, g as isFetchClientError } from './types-DgaMV8FF.js';
+import { b as ApiError, M as MiddlewareFn, c as BaseClientOptions, A as ApiResponse, H as HttpMethod } from './types-Bom8wyth.js';
 import { StatusSummary } from './status/types.js';
 import { Post } from './assets/types.js';
 import { GetCredentialsQuery, Credential, CreateCredentialBody } from './oauth/types.js';
@@ -14,25 +13,28 @@ import { G as GetQueueJobPath, c as components$2, S as SearchJobsQuery } from '.
 import { P as PostQueryPath, a as PostQueryBody, b as PostCancelQueryJobPath, G as GetQueryJobPath, c as components$1, d as GetQueryResultsPath, e as GetQueryResutsQuery, f as GetQueriesPath, g as GetQueriesHistoryQuery, h as GetExportResultsQuery, E as ExportResultsResponse } from './types-CGMJT3JL.js';
 import { CreateCredentialsBody, WorkspaceData } from './telemetry/types.js';
 import { EnrollMFAInput, GetDataAppPublicGitRepositoryInput, GetDataAppPasswordPrivateGitRepositoryInput, GetDataAppSSHKeyPrivateGitRepositoryInput, GetPublicGitRepositoryInput, GetGitPrivateRepositoryInput } from './syncActions/types.js';
-import { C as CreateSqlSessionBody, G as GetSqlSessionPath, a as GetSqlSessionsQuery, b as GetSqlSessionSchemaPath, c as GetSqlSessionSchemaQuery, d as components, P as PostSqlRunQueryPath, e as PostSqlRunQueryBody, f as PostSqlTablePreviewPath, g as PostSqlTablePreviewBody, h as GetSqlSessionTableDdlPath, i as GetSqlSessionTableDdlQuery, j as PostSqlSessionLoadPath, k as PostSqlSessionLoadBody, l as PostSqlSessionUnloadPath, m as PostSqlSessionUnloadBody } from './types-B--u7l2H.js';
+import { C as CreateSqlSessionBody, G as GetSqlSessionPath, a as GetSqlSessionsQuery, b as GetSqlSessionSchemaPath, c as GetSqlSessionSchemaQuery, d as components, P as PostSqlRunQueryPath, e as PostSqlRunQueryBody, f as PostSqlTablePreviewPath, g as PostSqlTablePreviewBody, h as GetSqlSessionTableDdlPath, i as GetSqlSessionTableDdlQuery, j as PostSqlSessionLoadPath, k as PostSqlSessionLoadBody, l as PostSqlSessionUnloadPath, m as PostSqlSessionUnloadBody } from './types-CqWXdTMg.js';
 import { EncryptQuery } from './encryption/types.js';
 import { G as GetDataAppRunsPath, a as GetDataAppRunsQuery, b as GetDataAppRunPath, c as GetDataAppLogsDownloadPath, d as GetDataAppLogsTailPath, e as GetDataAppLogsTailQuery, L as LogEntry, f as GetAppsQuery, g as GetDataAppPath, C as CreateDataAppBody, P as PatchDataAppPath, h as PatchDataAppBody, D as DeleteDataAppPath, i as GetDataAppPasswordPath, R as ResetDataAppPasswordPath, j as GetSandboxPath } from './utils-BNQZiNOu.js';
 export { p as parseLogLines } from './utils-BNQZiNOu.js';
-import { CreateVariableBody, DeleteVariablePath, VariableWithHash, GetVariablesQuery, GetVariablesByBranchId } from './vault/types.js';
-import { ServiceId, CreateTableAsyncBody, TableCreateJob, TableImportAsyncBody, TableImportJob, TableExportAsyncBody, TableExportJob, BucketListing, CreateBucketListingInput, UpdateBucketListingInput, Service, StackComponent, GetBucketsQuery, Bucket, BucketDetail, CreateBucketBody, UpdateBucketBody, CreateScheduledRefreshPath, CreateScheduledRefreshBody, ScheduledTask, Job, GetEventsQuery, StorageEvent, CreateEventBody, File as File$1, GetFilesQuery, DeleteFileTagPath, PrepareFileBody, PreparedFile, GetTablesQuery, Table, TableDetail, GetDataPreview, PrevieData, DeleteTableRows, JobUnion, DevBranch, CreateDevBranchJobBody, DevBranchPath, BranchMetadata, BranchMetadataEntry, WorkspacePath, Workspace, WorkspacesPath, ResetWorkspacePassword, SetWorkspacePublicInput, GetWorkspaceSaml2LoginPath, WorkspaceSaml2Login, WorkspaceObject, DeleteWorkspaceObjectInput, UnloadWorkspaceInput, MergeRequestDetail, MergeRequestDetailWithActivityLog, CreateMergeRequestParams, UpdateMergeRequestParams, JobOperation, GetJobPath, GetJobsQuery, GetComponentPath, Component, GetComponentsPath, GetComponentsQuery, GetSearchComponentConfigurationsPath, SearchComponentConfigurationsQuery, SearchComponentConfiguration, PartialKey, CreateConfigurationInput, BaseComponentConfig, ConfigType, ConfigurationPath, ComponentConfig, GetConfigurationsPath, CreateConfigurationRowInput, Row, CreateConfigurationRowsInput, CreateConfigurationRowBody, DeleteConfigurationRowInput, DeleteConfigurationRowsInput, CreateConfigurationWorkspaceBody, ConfigurationUseCaseType, ConfigurationVersionPath, ConfigurationVersion, ConfigurationVersionDetailPath, ConfigurationVersionDetail, GetStackInfoQuery, StackInfo } from './storage/types.js';
+import { CreateVariableBody, VariableWithHash, DeleteVariablePath, GetVariablesQuery, GetVariablesByBranchId } from './vault/types.js';
+import { a as EncryptionCtx } from './types-D4CDCW-Y.js';
+import { ServiceId, CreateTableAsyncBody, TableCreateJob, TableImportAsyncBody, TableImportJob, TableExportAsyncBody, TableExportJob, BucketListing, CreateBucketListingInput, UpdateBucketListingInput, Service, StackComponent, GetBucketsQuery, Bucket, BucketDetail, CreateBucketBody, UpdateBucketBody, CreateScheduledRefreshPath, CreateScheduledRefreshBody, ScheduledTask, Job, GetEventsQuery, StorageEvent, GetTableEventsQuery, TableEvent, CreateEventBody, File as File$1, GetFilesQuery, DeleteFileTagPath, PrepareFileBody, PreparedFile, GetTablesQuery, Table, TableDetail, GetDataPreview, PrevieData, DeleteTableRows, JobUnion, DevBranch, CreateDevBranchJobBody, DevBranchPath, BranchMetadata, BranchMetadataEntry, WorkspacePath, Workspace, WorkspacesPath, ResetWorkspacePassword, SetWorkspacePublicInput, GetWorkspaceSaml2LoginPath, WorkspaceSaml2Login, WorkspaceObject, DeleteWorkspaceObjectInput, UnloadWorkspaceInput, MergeRequestDetail, MergeRequestDetailWithActivityLog, CreateMergeRequestParams, UpdateMergeRequestParams, JobOperation, GetJobPath, GetJobsQuery, GetComponentPath, Component, GetComponentsPath, GetComponentsQuery, GetSearchComponentConfigurationsPath, SearchComponentConfigurationsQuery, SearchComponentConfiguration, PartialKey, CreateConfigurationInput, BaseComponentConfig, ConfigType, ConfigurationPath, ComponentConfig, ConfigurationDiffPath, ConfigurationDiff, ConfigurationRowDiffPath, ConfigurationRowDiff, GetConfigurationsPath, CreateConfigurationRowInput, Row, CreateConfigurationRowsInput, CreateConfigurationRowBody, DeleteConfigurationRowInput, DeleteConfigurationRowsInput, CreateConfigurationWorkspaceBody, ConfigurationUseCaseType, ConfigurationVersionPath, ConfigurationVersion, ConfigurationVersionDetailPath, ConfigurationVersionDetail, GetStackInfoQuery, StackInfo } from './storage/types.js';
 import { M as MetaObject } from './types-BY0tjg2Q.js';
-import { C as ConcurrentOptions, M as MiddlewareFn$1 } from './storageClient-BicsbzZy.js';
-export { a as concurrent } from './storageClient-BicsbzZy.js';
+import { C as ConcurrentOptions, M as MiddlewareFn$1 } from './storageClient-DBiS4voo.js';
+export { a as concurrent } from './storageClient-DBiS4voo.js';
 import { K as KeboolaObjectId } from './keboolaUID-D1DGSbge.js';
 export { k as keboolaUID } from './keboolaUID-D1DGSbge.js';
 import { TagWithBindings, TagData, CreateMetaObjectMetaDataInput, UpdateMetaObjectMetaDataInput } from './sdk/tag/types.js';
 import { B as Backend, S as StorageToken } from './types-DYMMsuU0.js';
-export { c as createGenericFetchClient } from './createGenericFetchClient-DEakI3F1.js';
-export { M as ManagementClientAuthError, i as isManagementClientAuthError } from './authMiddleware-BTFSCMTE.js';
+export { c as createGenericFetchClient } from './createGenericFetchClient-Cp2By_KQ.js';
+export { M as ManagementClientAuthError, i as isManagementClientAuthError } from './authMiddleware-Dcy9gRT9.js';
 import { ManagementToken } from './verify/types.js';
-export { c as createStorageSdk } from './storageSdk-DCcD68FQ.js';
+export { c as createStorageSdk } from './storageSdk-BnIemr2s.js';
 import 'qs';
-import './createOpenapiFetchClient-_sm4bchL.js';
+import './encryption/index.js';
+import './vault/index.js';
+import './createOpenapiFetchClient-DhL2gQvd.js';
 import './metastore/index.js';
 
 declare class UserError extends Error {
@@ -43,6 +45,11 @@ declare class ServiceUnavailableError extends Error {
     constructor(serviceId: string, path: string[], clientName: string);
 }
 
+type FetchClientError = TypeError | ApiError | SyntaxError | DOMException;
+declare const isApiError: (error: unknown) => error is ApiError;
+declare const isAbortError: (error: unknown) => error is DOMException;
+declare const isFetchClientError: (error: unknown) => error is FetchClientError;
+
 declare const HttpHeader: {
     CONTENT_TYPE: string;
     CONTENT_DISPOSITION: string;
@@ -3552,6 +3559,21 @@ type UsageResponse = OpenapiReturnType<paths['/api/usage']['get']>;
 
 declare function assert<T>(value: T | undefined | null, message: string): asserts value is T;
 
+/**
+ * Request coalescing for a single fire-and-forget task. The first call runs the
+ * task immediately. Calls made *while* it runs don't start a second run — they
+ * mark a single pending rerun, so once the in-flight run settles the task runs
+ * exactly once more (looping until no call arrived mid-run). The returned
+ * trigger returns `void`: callers fire it and never await.
+ *
+ * Unlike a single-flight/dedup helper (where concurrent callers share and await
+ * the in-flight promise), `coalesce` guarantees a post-change pass — the final
+ * run always reflects the latest trigger. Task rejections and synchronous
+ * throws are forwarded to `onError` and never destabilize the coalescer. (An
+ * `onError` that itself throws is the caller's responsibility.)
+ */
+declare const coalesce: (task: () => unknown, onError?: (error: unknown) => void) => (() => void);
+
 declare const delay: (timeout: number, signal?: AbortSignal) => Promise<unknown>;
 
 type PollResult<T> = {
@@ -3582,18 +3604,33 @@ declare const generateUUID: () => `${string}-${string}-${string}-${string}-${str
  */
 declare const series: <T, R>(options: Omit<ConcurrentOptions<T, R>, "concurrency">) => Promise<R[]>;
 
+type Listener<T> = (value: T) => void;
 /**
- * Strips trailing slashes from a base URL so concatenating a leading-slash
- * path (e.g. `/v2/storage`) never produces a double slash.
- *
- * Without this, callers that pass `https://connection.keboola.com/` end up
- * issuing requests to `https://connection.keboola.com//v2/storage/...`, which
- * the Storage API rejects with a 404.
+ * A minimal subscribable value holder: read the current value, replace it, and
+ * be notified when it changes. `set` notifies listeners only when the value
+ * actually changes (`Object.is`), and `subscribe` returns an unsubscribe fn.
  */
-declare const normalizeBaseUrl: (baseUrl: string) => string;
+type Store<T> = {
+    get: () => T;
+    set: (value: T) => void;
+    subscribe: (listener: Listener<T>) => () => void;
+};
+declare const createStore: <T>(initial: T) => Store<T>;
 
 type ServiceUrls = Partial<Record<ServiceId, (url: string) => string | undefined | null>>;
 
+/**
+ * Service clients reached through the registry — the key is the `clientName`
+ * the user accesses them by (e.g. `api.dataScience`), not the `serviceId`.
+ */
+type ServiceClientName = 'vault' | 'dataScience' | 'encryption' | 'editor' | 'syncActions' | 'telemetry' | 'queryService' | 'queue' | 'chat' | 'ai' | 'import' | 'kaiAgent' | 'oauth';
+/** Clients instantiated directly (not stack-discovered), keyed by their property name. */
+type NonServiceClientName = 'storage' | 'management' | 'assets' | 'status' | 'metastore';
+type MiddlewareTarget = ServiceClientName | NonServiceClientName;
+type Middlewares = MiddlewareFn[] | ({
+    all?: MiddlewareFn[];
+} & Partial<Record<MiddlewareTarget, MiddlewareFn[]>>);
+
 type ApiClientOptions = {
     token: {
         storageApi: string;
@@ -3602,10 +3639,10 @@ type ApiClientOptions = {
     assetsBaseUrl: string;
     statusBaseUrl: string;
     metastoreBaseUrl: string;
-    storageMiddlewares?: MiddlewareFn[];
+    middlewares?: Middlewares;
     clientServiceUrls?: ServiceUrls;
 } & BaseClientOptions;
-declare const createClients: ({ baseUrl, token, callbacks, assetsBaseUrl, statusBaseUrl, metastoreBaseUrl, clientServiceUrls, storageMiddlewares, }: ApiClientOptions) => Promise<{
+declare const createClients: ({ baseUrl, token, assetsBaseUrl, statusBaseUrl, metastoreBaseUrl, clientServiceUrls, middlewares, }: ApiClientOptions) => Promise<{
     sdk: {
         tag: {
             getTags: (signal?: AbortSignal) => Promise<TagWithBindings[]>;
@@ -3772,6 +3809,48 @@ declare const createClients: ({ baseUrl, token, callbacks, assetsBaseUrl, status
                 results: null;
             })>;
         };
+        vault: {
+            createVariable: (variable: CreateVariableBody, encryption: EncryptionCtx) => Promise<{
+                key: string;
+                value: string;
+                flags: ("encrypted" | "oauthCredentialsId")[];
+                group?: string;
+                attributes: {
+                    branchId?: string;
+                } & {
+                    [key: string]: string;
+                };
+            } & {
+                hash?: string;
+            }>;
+            deleteVariable: (variable: VariableWithHash, signal?: AbortSignal) => Promise<void>;
+            updateVariable: (variable: VariableWithHash, encryption: EncryptionCtx, signal?: AbortSignal) => Promise<{
+                key: string;
+                value: string;
+                flags: ("encrypted" | "oauthCredentialsId")[];
+                group?: string;
+                attributes: {
+                    branchId?: string;
+                } & {
+                    [key: string]: string;
+                };
+            } & {
+                hash?: string;
+            }>;
+            setVariablesGroup: (group: string, variables: VariableWithHash[], encryption: EncryptionCtx, signal?: AbortSignal) => Promise<({
+                key: string;
+                value: string;
+                flags: ("encrypted" | "oauthCredentialsId")[];
+                group?: string;
+                attributes: {
+                    branchId?: string;
+                } & {
+                    [key: string]: string;
+                };
+            } & {
+                hash?: string;
+            })[]>;
+        };
     };
     vault: {
         createVariable: (body: CreateVariableBody, signal?: AbortSignal) => Promise<{
@@ -4713,6 +4792,7 @@ declare const createClients: ({ baseUrl, token, callbacks, assetsBaseUrl, status
         events: {
             getEvents: (query?: GetEventsQuery, signal?: AbortSignal) => Promise<StorageEvent[]>;
             getEvent: (eventId: string | number, signal?: AbortSignal) => Promise<StorageEvent>;
+            getTableEvents: (tableId: string, query?: GetTableEventsQuery, signal?: AbortSignal) => Promise<TableEvent[]>;
             createEvent: (body: CreateEventBody, signal?: AbortSignal) => Promise<StorageEvent>;
         };
         files: {
@@ -5174,6 +5254,8 @@ declare const createClients: ({ baseUrl, token, callbacks, assetsBaseUrl, status
             searchComponentConfigurations: ({ branchId }?: GetSearchComponentConfigurationsPath, query?: SearchComponentConfigurationsQuery, signal?: AbortSignal) => Promise<SearchComponentConfiguration[]>;
             createConfiguration: ({ branchId, componentId, ...body }: PartialKey<CreateConfigurationInput, "branchId">) => Promise<BaseComponentConfig>;
             getConfiguration: <T extends ConfigType = "unknown">({ componentId, configId, branchId }: ConfigurationPath, signal?: AbortSignal) => Promise<ComponentConfig<T>>;
+            getConfigurationDiff: ({ componentId, configId, branchId }: ConfigurationDiffPath, signal?: AbortSignal) => Promise<ConfigurationDiff>;
+            getConfigurationRowDiff: ({ componentId, configId, rowId, branchId }: ConfigurationRowDiffPath, signal?: AbortSignal) => Promise<ConfigurationRowDiff>;
             deleteConfiguration: (path: Required<ConfigurationPath>) => Promise<void>;
             deleteConfigurations: ({ configIds, ...rest }: Required<Omit<ConfigurationPath, "configId">> & {
                 configIds: string[];
@@ -5735,17 +5817,22 @@ type ResponseLog = {
     statusText: string;
     headers: Record<string, string>;
 };
-type Log = {
+type BaseLog = {
     correlationId: string;
     method: HttpMethod;
     durationMs: number;
     request: RequestLog;
-    response?: ResponseLog;
-    error?: Error;
 };
+type SuccessLog = BaseLog & {
+    response: ResponseLog;
+};
+type ErrorLog = BaseLog & {
+    error: Error;
+};
+type Log = SuccessLog | ErrorLog;
 type Logger = {
-    info: (log: Log) => void;
-    error: (log: Log) => void;
+    info?: (log: SuccessLog) => void;
+    error?: (log: ErrorLog) => void;
 };
 type LogLevel = 'error-only' | 'all';
 type LoggingOptions = {
@@ -5753,7 +5840,6 @@ type LoggingOptions = {
     level?: LogLevel;
     redactHeaders?: string[];
 };
-declare const consoleLogger: Logger;
 declare const createLoggingMiddleware: (options?: LoggingOptions) => MiddlewareFn;
 
 type RetryOptions = {
@@ -5776,4 +5862,4 @@ declare const createDevApiClient: () => {
     };
 };
 
-export { type ApiClient, type ApiClientOptions, ConcurrentOptions, HttpContentType, HttpHeader, KeboolaHttpHeader, KeboolaObjectId, type Log, type LogLevel, type Logger, type LoggingOptions, MiddlewareFn, PollException, type RequestLog, type ResponseLog, type RetryOptions, ServiceUnavailableError, UserError, assert, consoleLogger, createApiClient, createDevApiClient, createLoggingMiddleware, createRetryMiddleware, delay, generateUUID, normalizeBaseUrl, poll, series };
+export { type ApiClient, type ApiClientOptions, ApiError, ConcurrentOptions, type FetchClientError, HttpContentType, HttpHeader, KeboolaHttpHeader, KeboolaObjectId, type Log, type LogLevel, type Logger, type LoggingOptions, MiddlewareFn, PollException, type RequestLog, type ResponseLog, type RetryOptions, ServiceUnavailableError, type Store, UserError, assert, coalesce, createApiClient, createDevApiClient, createLoggingMiddleware, createRetryMiddleware, createStore, delay, generateUUID, isAbortError, isApiError, isFetchClientError, poll, series };