@keboola/api-client 48.0.0 → 50.0.0

package/dist/{storage-BR-Kgi-6.js → storage-BpOLWT6h.js}

@@ -1,23 +1,23 @@
-import { t as concurrent } from "./concurrent-BacWxPwi.js";
-import { a as poller, n as jobStatus, t as transientRetries } from "./transientRetries-B4iusp69.js";
-import { _ as KeboolaHttpHeader, p as ApiError, r as isApiError, s as HttpHeader } from "./createFetchClient-CkHdS_IG.js";
-import { t as validateConnectionStatus } from "./validateConnectionStatus-DyrYpn0G.js";
-import { t as createGenericFetchClient } from "./createGenericFetchClient-CQdNcPC3.js";
-import { t as createOpenapiFetchClient } from "./createOpenapiFetchClient-DXiMv9WL.js";
-import { t as createAuthHeaders } from "./auth-4coY1uwo.js";
-//#region src/utils/async/series.ts
-/**
-* Executes a callback function on an array of items in series (one at a time).
-* It behaves similarly to Promise.all(), failing on the first rejected promise.
-* The order of the results matches the order of the promises.
-* Resolves with the mapped results, not with the original items.
-*/
-const series = async (options) => concurrent({
-	...options,
-	concurrency: 1
-});
-//#endregion
-//#region src/errors/readableReason.ts
+import { _ as KeboolaHttpHeader, p as ApiError, r as isApiError, s as HttpHeader } from "./createFetchClient-DlGCbltR.js";
+import { t as validateConnectionStatus } from "./validateConnectionStatus-DYwWeWVo.js";
+import { t as createGenericFetchClient } from "./createGenericFetchClient-wGxemBwR.js";
+import { t as createOpenapiFetchClient } from "./createOpenapiFetchClient-Bhz62MUE.js";
+import { t as concurrent } from "./concurrent-BtsT10Xe.js";
+import { a as poller, n as jobStatus, t as transientRetries } from "./transientRetries-BKqmb85B.js";
+import { t as createAuthHeaders } from "./auth-DYfQMQCs.js";
+// src/errors/ManageError.ts
+const isRecord$1 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/** The Manage API's string code: `code`, `stringCode` or `exception.code`, by which layer threw. */
+const manageErrorCode = (error) => {
+	if (!(error instanceof ApiError) || !isRecord$1(error.data)) return null;
+	const { code, stringCode, exception } = error.data;
+	if (typeof code === "string") return code;
+	if (typeof stringCode === "string") return stringCode;
+	if (isRecord$1(exception) && typeof exception.code === "string") return exception.code;
+	return null;
+};
+const isManageError = (error, code) => manageErrorCode(error) === code;
+// src/errors/readableReason.ts
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const nonEmptyString = (value) => typeof value === "string" && value !== "" ? value : void 0;
 /**
@@ -40,8 +40,16 @@ const readableReason = (error) => {
 	if (!isRecord(error.data)) return void 0;
 	return nonEmptyString(error.data.message) ?? nonEmptyString(error.data.exception);
 };
-//#endregion
-//#region src/errors/ServiceUnavailableError.ts
+// src/errors/retryAfterSeconds.ts
+/** `Retry-After` in whole seconds, or `null` when the header is absent or not a delay. */
+const retryAfterSeconds = (error) => {
+	if (!(error instanceof ApiError)) return null;
+	const header = error.response.headers.get("Retry-After");
+	if (!header) return null;
+	const seconds = Number(header);
+	return Number.isFinite(seconds) ? seconds : null;
+};
+// src/errors/ServiceUnavailableError.ts
 var ServiceUnavailableError = class ServiceUnavailableError extends Error {
 	constructor(serviceId, path, clientName) {
 		super(`Service "${serviceId}" is not available in this stack. Caused by: ${clientName}.${path.join(".")}()`);
@@ -49,8 +57,7 @@ var ServiceUnavailableError = class ServiceUnavailableError extends Error {
 		Object.setPrototypeOf(this, ServiceUnavailableError.prototype);
 	}
 };
-//#endregion
-//#region src/errors/StorageJobError.ts
+// src/errors/StorageJobError.ts
 /** A storage job that ended `error`: the wait finished, the job did not succeed. */
 var StorageJobError = class StorageJobError extends Error {
 	code;
@@ -66,8 +73,18 @@ var StorageJobError = class StorageJobError extends Error {
 	}
 };
 const isStorageJobError = (error) => error instanceof StorageJobError;
-//#endregion
-//#region src/clients/storage/mergeRequests/mergeRequests.ts
+// src/utils/async/series.ts
+/**
+* Executes a callback function on an array of items in series (one at a time).
+* It behaves similarly to Promise.all(), failing on the first rejected promise.
+* The order of the results matches the order of the promises.
+* Resolves with the mapped results, not with the original items.
+*/
+const series = async (options) => concurrent({
+	...options,
+	concurrency: 1
+});
+// src/clients/storage/mergeRequests/mergeRequests.ts
 /**
 * Both write bodies are asserted in: the generator marks every defaulted field required, while
 * Connection defaults the ones a caller omits — and an explicit `null` is not the same request as
@@ -144,8 +161,7 @@ const createMergeRequests = (client, poller) => {
 		getMergeRequestConflicts
 	};
 };
-//#endregion
-//#region src/clients/storage/branches/branches.ts
+// src/clients/storage/branches/branches.ts
 /**
 * Dev-branches client.
 *
@@ -243,8 +259,7 @@ const createBranches = (client, poller) => {
 		deleteDevBranchMetadata
 	};
 };
-//#endregion
-//#region src/clients/storage/bucketExternal/bucketExternal.ts
+// src/clients/storage/bucketExternal/bucketExternal.ts
 /**
 * External buckets wrap a schema that already exists in the backend (Snowflake or BigQuery).
 *
@@ -323,8 +338,7 @@ const createBucketExternal = (client, poller) => {
 		deleteScheduledTask
 	};
 };
-//#endregion
-//#region src/clients/storage/bucketListings/utils.ts
+// src/clients/storage/bucketListings/utils.ts
 /**
 * Encodes subscribers as GCP IAM principals (`user:`/`group:`); `fromBackendSubscribers` decodes.
 */
@@ -360,8 +374,7 @@ const toUpdateListingBody = (input) => {
 	if (Object.keys(body).length === 0) throw new Error("updateListingAsync requires at least one field");
 	return body;
 };
-//#endregion
-//#region src/clients/storage/bucketListings/bucketListings.ts
+// src/clients/storage/bucketListings/bucketListings.ts
 /**
 * Bucket listings (exposures) publish a bucket to a marketplace.
 *
@@ -471,8 +484,7 @@ const createBucketListings = (openApiClient, client, poller) => {
 		getListings
 	};
 };
-//#endregion
-//#region src/clients/storage/buckets/buckets.ts
+// src/clients/storage/buckets/buckets.ts
 /**
 * Spec mismatches behind the assertions below:
 * - Job returns: the spec's flat `JobResponse` vs the `Job<T>` union; on delete, 204 shadows the 202.
@@ -628,8 +640,7 @@ const createBuckets = (openApiClient, poller) => {
 		deleteBucketMetadata
 	};
 };
-//#endregion
-//#region src/clients/storage/bucketSharing/bucketSharing.ts
+// src/clients/storage/bucketSharing/bucketSharing.ts
 /**
 * Job returns are asserted: the spec's flat `JobResponse` (or no body) vs the `Job<T>` union.
 */
@@ -790,8 +801,7 @@ const createBucketSharing = (openApiClient, poller) => {
 		sharingTargets
 	};
 };
-//#endregion
-//#region src/clients/storage/columns/columns.ts
+// src/clients/storage/columns/columns.ts
 /**
 * Spec mismatches behind the assertions below:
 * - Job returns: the spec's flat `JobResponse` (or no body) vs the `Job<T>` union.
@@ -912,8 +922,7 @@ const createColumns = (client, poller) => {
 		deleteColumnMetadata
 	};
 };
-//#endregion
-//#region src/clients/storage/components/components.ts
+// src/clients/storage/components/components.ts
 const createComponents = (client) => {
 	const getComponent = async ({ componentId, branchId }, signal) => {
 		const { data } = await client.get("/v2/storage/branch/{branchId}/components/{componentId}", { path: {
@@ -937,8 +946,7 @@ const createComponents = (client) => {
 		getComponents
 	};
 };
-//#endregion
-//#region src/clients/storage/configurationMetadata/configurationMetadata.ts
+// src/clients/storage/configurationMetadata/configurationMetadata.ts
 const createConfigurationMetadata = (client) => {
 	const getConfigurationMetadata = async (path, signal) => {
 		const { data } = await client.get("/v2/storage/branch/{branchId}/components/{componentId}/configs/{configurationId}/metadata", { path }, { signal });
@@ -966,8 +974,7 @@ const createConfigurationMetadata = (client) => {
 		deleteConfigurationMetadata
 	};
 };
-//#endregion
-//#region src/clients/storage/configurationRows/configurationRows.ts
+// src/clients/storage/configurationRows/configurationRows.ts
 const createConfigurationRows = (client) => {
 	/**
 	* @link https://api.keboola.com/?service=storage#storage/tag/component-configuration-rows/POST/v2/storage/branch/{branchId}/components/{componentId}/configs/{configurationId}/rows
@@ -1078,8 +1085,7 @@ const createConfigurationRows = (client) => {
 		deleteConfigurationRows
 	};
 };
-//#endregion
-//#region src/clients/storage/configurations/batch.ts
+// src/clients/storage/configurations/batch.ts
 const BATCH_LIMIT = 1e3;
 const inChunks = (items) => Array.from({ length: Math.ceil(items.length / BATCH_LIMIT) }, (_, index) => items.slice(index * BATCH_LIMIT, (index + 1) * BATCH_LIMIT));
 const asError = (reason, fallback) => reason instanceof Error ? reason : new Error(fallback, { cause: reason });
@@ -1121,8 +1127,7 @@ const runInChunks = async (items, runJob, merge, empty) => {
 		error: null
 	};
 };
-//#endregion
-//#region src/clients/storage/configurations/utils.ts
+// src/clients/storage/configurations/utils.ts
 /**
 * Sends `expectedVersion` as `If-Match`. Storage answers:
 *
@@ -1143,8 +1148,7 @@ const parseSyncJobId = (headers) => {
 	const jobId = Number(headers.get(KeboolaHttpHeader.STORAGE_API_JOB_ID));
 	return Number.isInteger(jobId) && jobId > 0 ? jobId : null;
 };
-//#endregion
-//#region src/clients/storage/configurations/configurations.ts
+// src/clients/storage/configurations/configurations.ts
 /**
 * Every configuration read is bridged to `ComponentConfig<T>` with `as unknown as`.
 *
@@ -1420,8 +1424,7 @@ const createConfigurations = (client, poller) => {
 		searchComponentConfigurations
 	};
 };
-//#endregion
-//#region src/clients/storage/configurationVersions/configurationVersions.ts
+// src/clients/storage/configurationVersions/configurationVersions.ts
 const createConfigurationVersions = (client) => {
 	const getConfigurationVersions = async ({ branchId, componentId, configurationId, ...query }, signal) => {
 		const { data } = await client.get("/v2/storage/branch/{branchId}/components/{componentId}/configs/{configurationId}/versions", {
@@ -1551,8 +1554,7 @@ const createConfigurationVersions = (client) => {
 		copyConfigurationRowFromVersion
 	};
 };
-//#endregion
-//#region src/clients/storage/configurationWorkspaces/configurationWorkspaces.ts
+// src/clients/storage/configurationWorkspaces/configurationWorkspaces.ts
 const createConfigurationWorkspaces = (client, poller) => {
 	/**
 	* @link https://api.keboola.com/?service=storage#storage/tag/component-configurations/GET/v2/storage/branch/{branchId}/components/{componentId}/configs/{configurationId}/workspaces
@@ -1599,8 +1601,7 @@ const createConfigurationWorkspaces = (client, poller) => {
 		getConfigurationWorkspaces
 	};
 };
-//#endregion
-//#region src/clients/storage/events/events.ts
+// src/clients/storage/events/events.ts
 /**
 * Every endpoint here is the branched variant, and `branchId` is the caller's to supply.
 *
@@ -1684,8 +1685,7 @@ const createEvents = (client) => {
 		createEvent
 	};
 };
-//#endregion
-//#region src/clients/storage/files/files.ts
+// src/clients/storage/files/files.ts
 const createFiles = (client) => {
 	const getFile = async (path, signal) => {
 		const { data } = await client.get("/v2/storage/branch/{branchId}/files/{fileId}", { path }, { signal });
@@ -1748,8 +1748,7 @@ const createFiles = (client) => {
 		prepareFile
 	};
 };
-//#endregion
-//#region src/clients/storage/jobs/jobs.ts
+// src/clients/storage/jobs/jobs.ts
 /**
 * Both returns are asserted in, and `Job<T>` is the contract to trust.
 *
@@ -1774,8 +1773,7 @@ const createJobs = (openApiClient) => {
 		getJobs
 	};
 };
-//#endregion
-//#region src/clients/storage/poller.ts
+// src/clients/storage/poller.ts
 const DEFAULT_POLL_INTERVAL = 2e3;
 /** `init` is the job, or the enqueue that yields it: the poll then starts with the request. */
 const createJobPoller = ({ getJob }) => ({ init, interval, maxAttempts, timeout, signal }) => {
@@ -1808,8 +1806,7 @@ const createJobPoller = ({ getJob }) => ({ init, interval, maxAttempts, timeout,
 		signal
 	});
 };
-//#endregion
-//#region src/clients/storage/refreshTokenMiddleware.ts
+// src/clients/storage/refreshTokenMiddleware.ts
 const isTokenRefreshEndpoint = (request) => {
 	const url = new URL(request.url);
 	return request.method === "POST" && /\/tokens\/[^/]+\/refresh$/.test(url.pathname);
@@ -1832,8 +1829,7 @@ const createRefreshTokenMiddlware = ({ accessToken, onRefresh }) => {
 		return response;
 	};
 };
-//#endregion
-//#region src/clients/storage/search/search.ts
+// src/clients/storage/search/search.ts
 /**
 * Search endpoints.
 *
@@ -1868,8 +1864,7 @@ const createSearch = (client) => {
 		searchTables
 	};
 };
-//#endregion
-//#region src/clients/storage/snapshots/snapshots.ts
+// src/clients/storage/snapshots/snapshots.ts
 const createSnapshots = (client, poller) => {
 	/**
 	* Creates a snapshot of a table in the given branch. Async — returns a job.
@@ -1938,8 +1933,7 @@ const createSnapshots = (client, poller) => {
 		getTableSnapshots
 	};
 };
-//#endregion
-//#region src/clients/storage/stats/stats.ts
+// src/clients/storage/stats/stats.ts
 const createStats = (client) => {
 	/**
 	* Returns import/export table stats for a job run, identified by its runId.
@@ -1952,8 +1946,7 @@ const createStats = (client) => {
 	};
 	return { getRunIdStats };
 };
-//#endregion
-//#region src/clients/storage/tables/tables.ts
+// src/clients/storage/tables/tables.ts
 const createTables = (client, poller) => {
 	/**
 	* Returns every table in the given branch. Filter by bucket client-side: `table.bucket?.id`
@@ -2262,8 +2255,7 @@ const createTables = (client, poller) => {
 		deleteTableMetadata
 	};
 };
-//#endregion
-//#region src/clients/storage/tokens/tokens.ts
+// src/clients/storage/tokens/tokens.ts
 /**
 * `StorageToken` tightens the spec's token shape (`owner.assignedBackends`, `admin.role`,
 * `adminOwner`), so every method that answers a token asserts into it.
@@ -2349,8 +2341,7 @@ const createTokens = (client) => {
 		getTokenEvents
 	};
 };
-//#endregion
-//#region src/clients/storage/triggers/triggers.ts
+// src/clients/storage/triggers/triggers.ts
 const createTriggers = (client) => {
 	/**
 	* Lists triggers in the project, optionally filtered by component / configuration.
@@ -2397,8 +2388,7 @@ const createTriggers = (client) => {
 		deleteTrigger
 	};
 };
-//#endregion
-//#region src/clients/storage/workspaces/workspaces.ts
+// src/clients/storage/workspaces/workspaces.ts
 const isSqlWorkspaceConnection = (connection) => "loginType" in connection;
 /**
 * Paths, queries and bodies come from the spec; only the job returns are asserted.
@@ -2527,8 +2517,7 @@ const createWorkspaces = (client, poller) => {
 		inputMappingLoadPreview
 	};
 };
-//#endregion
-//#region src/clients/storage/storageClient.ts
+// src/clients/storage/storageClient.ts
 const createStorageClient = ({ baseUrl, auth, middlewares = [], onRefreshToken }) => {
 	const headers = createAuthHeaders(auth);
 	const allMiddlewares = onRefreshToken && auth.type === "sapi-token" ? [...middlewares, createRefreshTokenMiddlware({
@@ -2586,7 +2575,6 @@ const createStorageClient = ({ baseUrl, auth, middlewares = [], onRefreshToken }
 		configurationVersions: createConfigurationVersions(client)
 	};
 };
-//#endregion
-export { StorageJobError as a, readableReason as c, toBackendSubscribers as i, series as l, isSqlWorkspaceConnection as n, isStorageJobError as o, fromBackendSubscribers as r, ServiceUnavailableError as s, createStorageClient as t };
+export { series as a, ServiceUnavailableError as c, isManageError as d, manageErrorCode as f, toBackendSubscribers as i, retryAfterSeconds as l, isSqlWorkspaceConnection as n, StorageJobError as o, fromBackendSubscribers as r, isStorageJobError as s, createStorageClient as t, readableReason as u };
 
-//# sourceMappingURL=storage-BR-Kgi-6.js.map
+//# sourceMappingURL=storage-BpOLWT6h.js.map