@keboola/api-client 5.0.0 → 7.0.0

package/dist/encryption/types.d.cts

@@ -1,8 +1,67 @@
+import { P as ProjectId } from '../types-DJbXfC2q.cjs';
+import '../types-jKnx7Tm_.cjs';
+
+type BranchType = 'default' | 'dev';
+type EncryptParamsByScope = {
+    /** `KBC::ComponentSecure::` — any config of the component, in any project. */
+    ComponentSecure: {
+        componentId: string;
+    };
+    /** `KBC::ProjectSecure::` — the component within one project. */
+    ProjectSecure: {
+        componentId: string;
+        projectId: ProjectId;
+    };
+    /** `KBC::ConfigSecure::` — one specific configuration. */
+    ConfigSecure: {
+        componentId: string;
+        projectId: ProjectId;
+        configId: string;
+    };
+    /** `KBC::ProjectWideSecure::` — anywhere in one project (component-agnostic). */
+    ProjectWideSecure: {
+        projectId: ProjectId;
+    };
+    /** `KBC::BranchTypeSecure::` — the component within a project, scoped to a branch type. */
+    BranchTypeSecure: {
+        componentId: string;
+        projectId: ProjectId;
+        branchType: BranchType;
+    };
+    /** `KBC::BranchTypeConfigSecure::` — one config, scoped to a branch type. */
+    BranchTypeConfigSecure: {
+        componentId: string;
+        projectId: ProjectId;
+        configId: string;
+        branchType: BranchType;
+    };
+    /** `KBC::ProjectWideBranchTypeSecure::` — project-wide, scoped to a branch type. */
+    ProjectWideBranchTypeSecure: {
+        projectId: ProjectId;
+        branchType: BranchType;
+    };
+};
+type EncryptionScope = keyof EncryptParamsByScope;
+/** The required query params for a given encryption scope. */
+type EncryptParams<Scope extends EncryptionScope> = EncryptParamsByScope[Scope];
+/**
+ * Discriminated-union input for `encryptScopedSecrets`: a `scope` plus exactly the
+ * params that scope requires, plus the `data` to encrypt. The discriminant makes
+ * mismatched params (e.g. a `componentId` on a `ProjectWideSecure` call) a compile error.
+ */
+type ScopedSecrets<T extends Record<string, unknown>> = {
+    [Scope in EncryptionScope]: {
+        scope: Scope;
+    } & EncryptParams<Scope> & {
+        data: T;
+    };
+}[EncryptionScope];
 type EncryptQuery = {
-    projectId?: string | null;
-    branchType?: 'default' | 'dev' | null;
+    projectId?: ProjectId | null;
+    branchType?: BranchType | null;
     componentId?: string | null;
+    configId?: string | null;
 };
 type EncryptBody = string | Record<string, unknown>;
 
-export type { EncryptBody, EncryptQuery };
+export type { BranchType, EncryptBody, EncryptParams, EncryptParamsByScope, EncryptQuery, EncryptionScope, ScopedSecrets };

package/dist/encryption/types.d.ts

@@ -1,8 +1,67 @@
+import { P as ProjectId } from '../types-BG8yQyYt.js';
+import '../types-jKnx7Tm_.js';
+
+type BranchType = 'default' | 'dev';
+type EncryptParamsByScope = {
+    /** `KBC::ComponentSecure::` — any config of the component, in any project. */
+    ComponentSecure: {
+        componentId: string;
+    };
+    /** `KBC::ProjectSecure::` — the component within one project. */
+    ProjectSecure: {
+        componentId: string;
+        projectId: ProjectId;
+    };
+    /** `KBC::ConfigSecure::` — one specific configuration. */
+    ConfigSecure: {
+        componentId: string;
+        projectId: ProjectId;
+        configId: string;
+    };
+    /** `KBC::ProjectWideSecure::` — anywhere in one project (component-agnostic). */
+    ProjectWideSecure: {
+        projectId: ProjectId;
+    };
+    /** `KBC::BranchTypeSecure::` — the component within a project, scoped to a branch type. */
+    BranchTypeSecure: {
+        componentId: string;
+        projectId: ProjectId;
+        branchType: BranchType;
+    };
+    /** `KBC::BranchTypeConfigSecure::` — one config, scoped to a branch type. */
+    BranchTypeConfigSecure: {
+        componentId: string;
+        projectId: ProjectId;
+        configId: string;
+        branchType: BranchType;
+    };
+    /** `KBC::ProjectWideBranchTypeSecure::` — project-wide, scoped to a branch type. */
+    ProjectWideBranchTypeSecure: {
+        projectId: ProjectId;
+        branchType: BranchType;
+    };
+};
+type EncryptionScope = keyof EncryptParamsByScope;
+/** The required query params for a given encryption scope. */
+type EncryptParams<Scope extends EncryptionScope> = EncryptParamsByScope[Scope];
+/**
+ * Discriminated-union input for `encryptScopedSecrets`: a `scope` plus exactly the
+ * params that scope requires, plus the `data` to encrypt. The discriminant makes
+ * mismatched params (e.g. a `componentId` on a `ProjectWideSecure` call) a compile error.
+ */
+type ScopedSecrets<T extends Record<string, unknown>> = {
+    [Scope in EncryptionScope]: {
+        scope: Scope;
+    } & EncryptParams<Scope> & {
+        data: T;
+    };
+}[EncryptionScope];
 type EncryptQuery = {
-    projectId?: string | null;
-    branchType?: 'default' | 'dev' | null;
+    projectId?: ProjectId | null;
+    branchType?: BranchType | null;
     componentId?: string | null;
+    configId?: string | null;
 };
 type EncryptBody = string | Record<string, unknown>;
 
-export type { EncryptBody, EncryptQuery };
+export type { BranchType, EncryptBody, EncryptParams, EncryptParamsByScope, EncryptQuery, EncryptionScope, ScopedSecrets };

package/dist/import/index.cjs

@@ -1,14 +1,14 @@
 'use strict';
 
-var chunkVZROPAWL_cjs = require('../chunk-VZROPAWL.cjs');
-require('../chunk-3CIPWA33.cjs');
-require('../chunk-4I6TJWBG.cjs');
+var chunkPWA6XFXA_cjs = require('../chunk-PWA6XFXA.cjs');
+require('../chunk-IDYRJ4K3.cjs');
+require('../chunk-R7MQGDLC.cjs');
 
 
 
 Object.defineProperty(exports, "createImportClient", {
   enumerable: true,
-  get: function () { return chunkVZROPAWL_cjs.createImportClient; }
+  get: function () { return chunkPWA6XFXA_cjs.createImportClient; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/import/index.js

@@ -1,5 +1,5 @@
-export { createImportClient } from '../chunk-5XADEX3R.js';
-import '../chunk-XI6R76X3.js';
-import '../chunk-FL54VJ35.js';
+export { createImportClient } from '../chunk-EEG7YZUY.js';
+import '../chunk-D2SWTZFS.js';
+import '../chunk-SI5TFV5M.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{index-KHRrA2IR.d.cts → index-DzhQuag5.d.cts}

@@ -1,5 +1,5 @@
-import { c as components, S as StorageToken, C as CreateTokenBody, U as UpdateTokenBody, b as ShareTokenBody } from './types-DcL25GqY.cjs';
-import { GetBucketsQuery, Bucket, BucketDetail, CreateBucketBody, UpdateBucketBody, CreateScheduledRefreshPath, CreateScheduledRefreshBody, ScheduledTask, BucketListing, CreateBucketListingInput, Job, UpdateBucketListingInput, ShareBucketToProjectsBody, ShareBucketToUsersBody, UpdateBucketOwnerBody, RefreshExternalBucketQuery, RegisterBucketBody, BucketRegistrationGuideQuery, SaveBucketMetadataBody, GetEventsQuery, StorageEvent, GetTableEventsQuery, TableEvent, CreateEventBody, File, GetFilesQuery, DeleteFileTagPath, PrepareFileBody, PreparedFile, GetTablesQuery, Table, TableDetail, GetDataPreview, PrevieData, DeleteTableRows, JobUnion, TableExportAsyncBody, TableExportJob, CreateTableAsyncBody, TableCreateJob, CreateTableDefinitionBody, TableImportAsyncBody, TableImportJob, UpdateTableDefinitionInput, UpdateTableBody, CreateAliasTableBody, SetAliasTableFilterBody, CreateSnapshotBody, Snapshot, SaveMetadataBody, Metadata, AddTableColumnBody, DeleteTableColumnQuery, CreateTablePrimaryKeyBody, DevBranch, CreateDevBranchJobBody, DevBranchPath, BranchMetadata, BranchMetadataEntry, WorkspacePath, Workspace, WorkspacesPath, ResetWorkspacePassword, SetWorkspacePublicInput, GetWorkspaceSaml2LoginPath, WorkspaceSaml2Login, WorkspaceObject, DeleteWorkspaceObjectInput, UnloadWorkspaceInput, WorkspaceInputMappingLoadPreviewInput, MergeRequestDetail, MergeRequestDetailWithActivityLog, CreateMergeRequestParams, UpdateMergeRequestParams, JobOperation, GetJobPath, GetJobsQuery, GetComponentPath, Component, GetComponentsPath, GetComponentsQuery, GetSearchComponentConfigurationsPath, SearchComponentConfigurationsQuery, SearchComponentConfiguration, PartialKey, CreateConfigurationInput, BaseComponentConfig, ConfigType, UpdateConfigurationInput, ComponentConfig, ConfigurationPath, ConfigurationDiffPath, ConfigurationDiff, ConfigurationRowDiffPath, ConfigurationRowDiff, RebaseConfigurationInput, GetConfigurationsPath, CreateConfigurationRowInput, Row, CreateConfigurationRowsInput, CreateConfigurationRowBody, DeleteConfigurationRowInput, DeleteConfigurationRowsInput, CreateConfigurationWorkspaceBody, ConfigurationUseCaseType, ConfigurationVersionPath, ConfigurationVersion, ConfigurationVersionDetailPath, ConfigurationVersionDetail, ListTriggersQuery, CreateTriggerBody, UpdateTriggerBody, GlobalSearchQuery, GlobalSearchResponse, RunIdStats, GetStackInfoQuery, StackInfo } from './storage/types.cjs';
+import { c as components, S as StorageToken, C as CreateTokenBody, U as UpdateTokenBody, b as ShareTokenBody } from './types-DJbXfC2q.cjs';
+import { GetBucketsQuery, Bucket, BucketDetail, CreateBucketBody, UpdateBucketBody, CreateScheduledRefreshPath, CreateScheduledRefreshBody, ScheduledTask, BucketListing, CreateBucketListingInput, Job, UpdateBucketListingInput, ShareBucketToProjectsBody, ShareBucketToUsersBody, UpdateBucketOwnerBody, RefreshExternalBucketQuery, RegisterBucketBody, BucketRegistrationGuideQuery, SaveBucketMetadataBody, GetEventsQuery, StorageEvent, GetTableEventsQuery, TableEvent, CreateEventBody, File, GetFilesQuery, DeleteFileTagPath, PrepareFileBody, PreparedFile, GetTablesQuery, Table, TableDetail, GetDataPreview, PrevieData, DeleteTableRows, JobUnion, TableExportAsyncBody, TableExportJob, CreateTableAsyncBody, TableCreateJob, CreateTableDefinitionBody, TableImportAsyncBody, TableImportJob, UpdateTableDefinitionInput, UpdateTableBody, CreateAliasTableBody, SetAliasTableFilterBody, CreateSnapshotBody, Snapshot, SaveMetadataBody, Metadata, AddTableColumnBody, DeleteTableColumnQuery, CreateTablePrimaryKeyBody, DevBranch, CreateDevBranchJobBody, DevBranchPath, BranchMetadata, BranchMetadataEntry, WorkspacePath, Workspace, WorkspacesPath, ResetWorkspacePassword, SetWorkspacePublicInput, GetWorkspaceSaml2LoginPath, WorkspaceSaml2Login, WorkspaceObject, DeleteWorkspaceObjectInput, UnloadWorkspaceInput, WorkspaceInputMappingLoadPreviewInput, MergeRequestDetail, MergeRequestDetailWithActivityLog, CreateMergeRequestParams, UpdateMergeRequestParams, JobOperation, GetJobPath, GetJobsQuery, GetComponentPath, Component, GetComponentsPath, GetComponentsQuery, GetSearchComponentConfigurationsPath, SearchComponentConfigurationsQuery, SearchComponentConfiguration, CreateConfigurationInput, BaseComponentConfig, ConfigType, PartialKey, UpdateConfigurationInput, ComponentConfig, ConfigurationPath, ConfigurationDiffPath, ConfigurationDiff, ConfigurationRowDiffPath, ConfigurationRowDiff, RebaseConfigurationInput, GetConfigurationsPath, CreateConfigurationRowInput, Row, CreateConfigurationRowsInput, CreateConfigurationRowBody, DeleteConfigurationRowInput, DeleteConfigurationRowsInput, CreateConfigurationWorkspaceBody, ConfigurationUseCaseType, ConfigurationVersionPath, ConfigurationVersion, ConfigurationVersionDetailPath, ConfigurationVersionDetail, ListTriggersQuery, CreateTriggerBody, UpdateTriggerBody, GlobalSearchQuery, GlobalSearchResponse, RunIdStats, GetStackInfoQuery, StackInfo } from './storage/types.cjs';
 import { C as ClientInitOptions, M as MiddlewareFn$1 } from './types-DxJD6LIN.cjs';
 import { c as createGenericFetchClient } from './createGenericFetchClient-yfcpR7qD.cjs';
 import { c as createOpenapiFetchClient } from './createOpenapiFetchClient-Ci0-Qe53.cjs';
@@ -1305,12 +1305,12 @@ declare const createStorageClient: ({ baseUrl, token, middlewares, onRefreshToke
         getComponent: ({ componentId, branchId }: GetComponentPath, signal?: AbortSignal) => Promise<Component>;
         getComponents: ({ branchId, ...query }?: GetComponentsPath & GetComponentsQuery, signal?: AbortSignal) => Promise<Component[]>;
         searchComponentConfigurations: ({ branchId }?: GetSearchComponentConfigurationsPath, query?: SearchComponentConfigurationsQuery, signal?: AbortSignal) => Promise<SearchComponentConfiguration[]>;
-        createConfiguration: ({ branchId, componentId, ...body }: PartialKey<CreateConfigurationInput, "branchId">) => Promise<BaseComponentConfig>;
+        createConfiguration: ({ branchId, componentId, ...body }: CreateConfigurationInput) => Promise<BaseComponentConfig<Record<string, unknown>>>;
         updateConfiguration: <T extends ConfigType = "unknown">({ branchId, componentId, configId, configuration, ...rest }: PartialKey<UpdateConfigurationInput, "branchId">, signal?: AbortSignal) => Promise<ComponentConfig<T>>;
         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>;
-        rebaseConfiguration: ({ branchId, componentId, configId, ...body }: RebaseConfigurationInput) => Promise<BaseComponentConfig>;
+        rebaseConfiguration: ({ branchId, componentId, configId, ...body }: RebaseConfigurationInput) => Promise<BaseComponentConfig<Record<string, unknown>>>;
         deleteConfiguration: (path: Required<ConfigurationPath>) => Promise<void>;
         deleteConfigurations: ({ configIds, ...rest }: Required<Omit<ConfigurationPath, "configId">> & {
             configIds: string[];

package/dist/{index-BEE_qeId.d.ts → index-G9ZyDi7K.d.ts}

@@ -1,5 +1,5 @@
-import { c as components, S as StorageToken, C as CreateTokenBody, U as UpdateTokenBody, b as ShareTokenBody } from './types-Dfw6a58i.js';
-import { GetBucketsQuery, Bucket, BucketDetail, CreateBucketBody, UpdateBucketBody, CreateScheduledRefreshPath, CreateScheduledRefreshBody, ScheduledTask, BucketListing, CreateBucketListingInput, Job, UpdateBucketListingInput, ShareBucketToProjectsBody, ShareBucketToUsersBody, UpdateBucketOwnerBody, RefreshExternalBucketQuery, RegisterBucketBody, BucketRegistrationGuideQuery, SaveBucketMetadataBody, GetEventsQuery, StorageEvent, GetTableEventsQuery, TableEvent, CreateEventBody, File, GetFilesQuery, DeleteFileTagPath, PrepareFileBody, PreparedFile, GetTablesQuery, Table, TableDetail, GetDataPreview, PrevieData, DeleteTableRows, JobUnion, TableExportAsyncBody, TableExportJob, CreateTableAsyncBody, TableCreateJob, CreateTableDefinitionBody, TableImportAsyncBody, TableImportJob, UpdateTableDefinitionInput, UpdateTableBody, CreateAliasTableBody, SetAliasTableFilterBody, CreateSnapshotBody, Snapshot, SaveMetadataBody, Metadata, AddTableColumnBody, DeleteTableColumnQuery, CreateTablePrimaryKeyBody, DevBranch, CreateDevBranchJobBody, DevBranchPath, BranchMetadata, BranchMetadataEntry, WorkspacePath, Workspace, WorkspacesPath, ResetWorkspacePassword, SetWorkspacePublicInput, GetWorkspaceSaml2LoginPath, WorkspaceSaml2Login, WorkspaceObject, DeleteWorkspaceObjectInput, UnloadWorkspaceInput, WorkspaceInputMappingLoadPreviewInput, MergeRequestDetail, MergeRequestDetailWithActivityLog, CreateMergeRequestParams, UpdateMergeRequestParams, JobOperation, GetJobPath, GetJobsQuery, GetComponentPath, Component, GetComponentsPath, GetComponentsQuery, GetSearchComponentConfigurationsPath, SearchComponentConfigurationsQuery, SearchComponentConfiguration, PartialKey, CreateConfigurationInput, BaseComponentConfig, ConfigType, UpdateConfigurationInput, ComponentConfig, ConfigurationPath, ConfigurationDiffPath, ConfigurationDiff, ConfigurationRowDiffPath, ConfigurationRowDiff, RebaseConfigurationInput, GetConfigurationsPath, CreateConfigurationRowInput, Row, CreateConfigurationRowsInput, CreateConfigurationRowBody, DeleteConfigurationRowInput, DeleteConfigurationRowsInput, CreateConfigurationWorkspaceBody, ConfigurationUseCaseType, ConfigurationVersionPath, ConfigurationVersion, ConfigurationVersionDetailPath, ConfigurationVersionDetail, ListTriggersQuery, CreateTriggerBody, UpdateTriggerBody, GlobalSearchQuery, GlobalSearchResponse, RunIdStats, GetStackInfoQuery, StackInfo } from './storage/types.js';
+import { c as components, S as StorageToken, C as CreateTokenBody, U as UpdateTokenBody, b as ShareTokenBody } from './types-BG8yQyYt.js';
+import { GetBucketsQuery, Bucket, BucketDetail, CreateBucketBody, UpdateBucketBody, CreateScheduledRefreshPath, CreateScheduledRefreshBody, ScheduledTask, BucketListing, CreateBucketListingInput, Job, UpdateBucketListingInput, ShareBucketToProjectsBody, ShareBucketToUsersBody, UpdateBucketOwnerBody, RefreshExternalBucketQuery, RegisterBucketBody, BucketRegistrationGuideQuery, SaveBucketMetadataBody, GetEventsQuery, StorageEvent, GetTableEventsQuery, TableEvent, CreateEventBody, File, GetFilesQuery, DeleteFileTagPath, PrepareFileBody, PreparedFile, GetTablesQuery, Table, TableDetail, GetDataPreview, PrevieData, DeleteTableRows, JobUnion, TableExportAsyncBody, TableExportJob, CreateTableAsyncBody, TableCreateJob, CreateTableDefinitionBody, TableImportAsyncBody, TableImportJob, UpdateTableDefinitionInput, UpdateTableBody, CreateAliasTableBody, SetAliasTableFilterBody, CreateSnapshotBody, Snapshot, SaveMetadataBody, Metadata, AddTableColumnBody, DeleteTableColumnQuery, CreateTablePrimaryKeyBody, DevBranch, CreateDevBranchJobBody, DevBranchPath, BranchMetadata, BranchMetadataEntry, WorkspacePath, Workspace, WorkspacesPath, ResetWorkspacePassword, SetWorkspacePublicInput, GetWorkspaceSaml2LoginPath, WorkspaceSaml2Login, WorkspaceObject, DeleteWorkspaceObjectInput, UnloadWorkspaceInput, WorkspaceInputMappingLoadPreviewInput, MergeRequestDetail, MergeRequestDetailWithActivityLog, CreateMergeRequestParams, UpdateMergeRequestParams, JobOperation, GetJobPath, GetJobsQuery, GetComponentPath, Component, GetComponentsPath, GetComponentsQuery, GetSearchComponentConfigurationsPath, SearchComponentConfigurationsQuery, SearchComponentConfiguration, CreateConfigurationInput, BaseComponentConfig, ConfigType, PartialKey, UpdateConfigurationInput, ComponentConfig, ConfigurationPath, ConfigurationDiffPath, ConfigurationDiff, ConfigurationRowDiffPath, ConfigurationRowDiff, RebaseConfigurationInput, GetConfigurationsPath, CreateConfigurationRowInput, Row, CreateConfigurationRowsInput, CreateConfigurationRowBody, DeleteConfigurationRowInput, DeleteConfigurationRowsInput, CreateConfigurationWorkspaceBody, ConfigurationUseCaseType, ConfigurationVersionPath, ConfigurationVersion, ConfigurationVersionDetailPath, ConfigurationVersionDetail, ListTriggersQuery, CreateTriggerBody, UpdateTriggerBody, GlobalSearchQuery, GlobalSearchResponse, RunIdStats, GetStackInfoQuery, StackInfo } from './storage/types.js';
 import { C as ClientInitOptions, M as MiddlewareFn$1 } from './types-DxJD6LIN.js';
 import { c as createGenericFetchClient } from './createGenericFetchClient-Gpom91V-.js';
 import { c as createOpenapiFetchClient } from './createOpenapiFetchClient-B44nXiti.js';
@@ -1305,12 +1305,12 @@ declare const createStorageClient: ({ baseUrl, token, middlewares, onRefreshToke
         getComponent: ({ componentId, branchId }: GetComponentPath, signal?: AbortSignal) => Promise<Component>;
         getComponents: ({ branchId, ...query }?: GetComponentsPath & GetComponentsQuery, signal?: AbortSignal) => Promise<Component[]>;
         searchComponentConfigurations: ({ branchId }?: GetSearchComponentConfigurationsPath, query?: SearchComponentConfigurationsQuery, signal?: AbortSignal) => Promise<SearchComponentConfiguration[]>;
-        createConfiguration: ({ branchId, componentId, ...body }: PartialKey<CreateConfigurationInput, "branchId">) => Promise<BaseComponentConfig>;
+        createConfiguration: ({ branchId, componentId, ...body }: CreateConfigurationInput) => Promise<BaseComponentConfig<Record<string, unknown>>>;
         updateConfiguration: <T extends ConfigType = "unknown">({ branchId, componentId, configId, configuration, ...rest }: PartialKey<UpdateConfigurationInput, "branchId">, signal?: AbortSignal) => Promise<ComponentConfig<T>>;
         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>;
-        rebaseConfiguration: ({ branchId, componentId, configId, ...body }: RebaseConfigurationInput) => Promise<BaseComponentConfig>;
+        rebaseConfiguration: ({ branchId, componentId, configId, ...body }: RebaseConfigurationInput) => Promise<BaseComponentConfig<Record<string, unknown>>>;
         deleteConfiguration: (path: Required<ConfigurationPath>) => Promise<void>;
         deleteConfigurations: ({ configIds, ...rest }: Required<Omit<ConfigurationPath, "configId">> & {
             configIds: string[];