@kontent-ai/core-sdk 12.0.0-preview.4 → 12.0.0-preview.40

package/dist/sdk/transform/transform-paged-fetch-query.js

@@ -0,0 +1,75 @@
+import { isNonEmptyArray } from "../../utils/array.utils.js";
+import { createBatchTransformResponses, createTransformError } from "./transform-utils.js";
+export function transformPagedFetchQuery({ query, transform, transformSchema, mapError, config, }) {
+    const batchTransformResponses = createBatchTransformResponses({
+        config,
+        transform,
+        transformSchema,
+        mapError,
+    });
+    const transformSingleOrThrow = async (response) => {
+        const { success, data, error } = await batchTransformResponses([response]);
+        if (!success) {
+            throw error;
+        }
+        if (isNonEmptyArray(data)) {
+            return data[0];
+        }
+        throw mapError(createTransformError(new Error("Transform returned no response for input"), response.meta.url));
+    };
+    const transformSingleSafely = async (safeResult) => {
+        if (!safeResult.success) {
+            return { success: false, error: safeResult.error };
+        }
+        const { success, data, error } = await batchTransformResponses([safeResult.response]);
+        if (!success) {
+            return { success: false, error };
+        }
+        if (isNonEmptyArray(data)) {
+            return { success: true, response: data[0] };
+        }
+        return {
+            success: false,
+            error: mapError(createTransformError(new Error("Transform returned no response for input"), safeResult.response.meta.url)),
+        };
+    };
+    return {
+        fetchPage: async () => transformSingleOrThrow(await query.fetchPage()),
+        fetchPageSafe: async () => transformSingleSafely(await query.fetchPageSafe()),
+        fetchAllPages: async (config) => {
+            const result = await query.fetchAllPages(config);
+            const { success, data, error } = await batchTransformResponses(result.responses);
+            if (!success) {
+                throw error;
+            }
+            return { ...result, responses: data };
+        },
+        fetchAllPagesSafe: async (config) => {
+            const result = await query.fetchAllPagesSafe(config);
+            if (!result.success) {
+                return { success: false, error: result.error };
+            }
+            const { success, data, error } = await batchTransformResponses(result.responses);
+            if (!success) {
+                return { success: false, error };
+            }
+            return { ...result, success: true, responses: data };
+        },
+        pages: async function* (config) {
+            for await (const response of query.pages(config)) {
+                yield await transformSingleOrThrow(response);
+            }
+        },
+        pagesSafe: async function* (config) {
+            for await (const safeResult of query.pagesSafe(config)) {
+                const result = await transformSingleSafely(safeResult);
+                yield result;
+                if (!result.success) {
+                    return;
+                }
+            }
+        },
+        inspect: query.inspect,
+    };
+}
+//# sourceMappingURL=transform-paged-fetch-query.js.map

package/dist/sdk/transform/transform-paged-fetch-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-paged-fetch-query.js","sourceRoot":"","sources":["../../../lib/sdk/transform/transform-paged-fetch-query.ts"],"names":[],"mappings":"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"}

package/dist/sdk/transform/transform-utils.d.ts

@@ -0,0 +1,23 @@
+import type { KontentSdkError } from "../../models/error.models.js";
+import type { JsonValue } from "../../models/json.models.js";
+import { type SchemaInput } from "../../utils/schema.utils.js";
+import { type TryCatchResult } from "../../utils/try-catch.utils.js";
+import type { QueryResponse, SafeQueryResult, SdkConfig } from "../sdk-models.js";
+type TransformResponseFn<TPayload extends JsonValue, TTransformedPayload extends TPayload, TError, TMeta, TExtra> = (response: QueryResponse<TPayload, TMeta, TExtra>) => Promise<TryCatchResult<QueryResponse<TTransformedPayload, TMeta, TExtra>, TError>>;
+type BatchTransformResponsesFn<TPayload extends JsonValue, TTransformedPayload extends TPayload, TError, TMeta, TExtra> = (responses: readonly QueryResponse<TPayload, TMeta, TExtra>[]) => Promise<TryCatchResult<readonly QueryResponse<TTransformedPayload, TMeta, TExtra>[], TError>>;
+export declare function createTransformError(error: unknown, url: URL): KontentSdkError;
+export declare function createTransformResponse<TPayload extends JsonValue, TTransformedPayload extends TPayload, TError, TMeta, TExtra>({ config, transform, transformSchema, mapError }: {
+    readonly config: Pick<SdkConfig, "runtimeValidation">;
+    readonly transform: (response: QueryResponse<TPayload, TMeta, TExtra>) => QueryResponse<TTransformedPayload, TMeta, TExtra>;
+    readonly transformSchema: SchemaInput<TTransformedPayload>;
+    readonly mapError: (error: KontentSdkError) => TError;
+}): TransformResponseFn<TPayload, TTransformedPayload, TError, TMeta, TExtra>;
+export declare function createBatchTransformResponses<TPayload extends JsonValue, TTransformedPayload extends TPayload, TError, TMeta, TExtra>({ config, transform, transformSchema, mapError }: {
+    readonly config: Pick<SdkConfig, "runtimeValidation">;
+    readonly transform: (responses: readonly QueryResponse<TPayload, TMeta, TExtra>[]) => readonly QueryResponse<TTransformedPayload, TMeta, TExtra>[];
+    readonly transformSchema: SchemaInput<TTransformedPayload>;
+    readonly mapError: (error: KontentSdkError) => TError;
+}): BatchTransformResponsesFn<TPayload, TTransformedPayload, TError, TMeta, TExtra>;
+export declare function applyTransformOrThrow<TPayload extends JsonValue, TTransformedPayload extends TPayload, TError, TMeta, TExtra>(response: QueryResponse<TPayload, TMeta, TExtra>, transformResponse: TransformResponseFn<TPayload, TTransformedPayload, TError, TMeta, TExtra>): Promise<QueryResponse<TTransformedPayload, TMeta, TExtra>>;
+export declare function applyTransformSafely<TPayload extends JsonValue, TTransformedPayload extends TPayload, TError, TMeta, TExtra>(safeResult: SafeQueryResult<QueryResponse<TPayload, TMeta, TExtra>, TError>, transformResponse: TransformResponseFn<TPayload, TTransformedPayload, TError, TMeta, TExtra>): Promise<SafeQueryResult<QueryResponse<TTransformedPayload, TMeta, TExtra>, TError>>;
+export {};

package/dist/sdk/transform/transform-utils.js

@@ -0,0 +1,86 @@
+import { createSdkError } from "../../utils/error.utils.js";
+import { resolveSchema } from "../../utils/schema.utils.js";
+import { tryCatch } from "../../utils/try-catch.utils.js";
+import { parseResponse } from "../sdk-utils.js";
+export function createTransformError(error, url) {
+    return createSdkError({
+        baseErrorData: {
+            message: `Failed to transform payload for url ${url.toString()}`,
+            url: url.toString(),
+            retryAttempt: undefined,
+            retryStrategyOptions: undefined,
+        },
+        details: {
+            originalError: error,
+            reason: "transformError",
+        },
+    });
+}
+export function createTransformResponse({ config, transform, transformSchema, mapError, }) {
+    return async (response) => {
+        const { success, data: transformedResponse, error } = tryCatch(() => transform(response));
+        if (!success) {
+            return { success: false, error: mapError(createTransformError(error, response.meta.url)) };
+        }
+        if (config.runtimeValidation?.validateResponses) {
+            const schema = await resolveSchema(transformSchema);
+            if (schema) {
+                const validationError = await parseResponse({
+                    url: transformedResponse.meta.url,
+                    payload: transformedResponse.payload,
+                    schema,
+                });
+                if (validationError) {
+                    return { success: false, error: mapError(validationError.error) };
+                }
+            }
+        }
+        return { success: true, data: transformedResponse };
+    };
+}
+export function createBatchTransformResponses({ config, transform, transformSchema, mapError, }) {
+    return async (responses) => {
+        const firstResponse = responses?.[0];
+        if (!firstResponse) {
+            return { success: true, data: [] };
+        }
+        const { success, data: transformedResponses, error } = tryCatch(() => transform(responses));
+        if (!success) {
+            return { success: false, error: mapError(createTransformError(error, firstResponse.meta.url)) };
+        }
+        if (config.runtimeValidation?.validateResponses) {
+            const schema = await resolveSchema(transformSchema);
+            if (schema) {
+                for (const transformedResponse of transformedResponses) {
+                    const validationError = await parseResponse({
+                        url: transformedResponse.meta.url,
+                        payload: transformedResponse.payload,
+                        schema,
+                    });
+                    if (validationError) {
+                        return { success: false, error: mapError(validationError.error) };
+                    }
+                }
+            }
+        }
+        return { success: true, data: transformedResponses };
+    };
+}
+export async function applyTransformOrThrow(response, transformResponse) {
+    const { success, data, error } = await transformResponse(response);
+    if (!success) {
+        throw error;
+    }
+    return data;
+}
+export async function applyTransformSafely(safeResult, transformResponse) {
+    if (!safeResult.success) {
+        return { success: false, error: safeResult.error };
+    }
+    const { success, data, error } = await transformResponse(safeResult.response);
+    if (!success) {
+        return { success: false, error };
+    }
+    return { success: true, response: data };
+}
+//# sourceMappingURL=transform-utils.js.map

package/dist/sdk/transform/transform-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-utils.js","sourceRoot":"","sources":["../../../lib/sdk/transform/transform-utils.ts"],"names":[],"mappings":"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"}

package/dist/testkit/poll.utils.d.ts

@@ -0,0 +1,5 @@
+import type { Failure, Success } from "../utils/try-catch.utils.js";
+export declare function poll<TResult, TError = unknown>(func: () => Promise<Success<TResult> | Failure<TResult, TError>>, config?: {
+    readonly intervalMs?: number;
+    readonly timeoutMs?: number;
+}): Promise<Success<TResult> | Failure<TResult, TError>>;

package/dist/testkit/poll.utils.js

@@ -0,0 +1,15 @@
+import { sleep } from "../utils/core.utils.js";
+const defaultIntervalMs = 1000;
+const defaultTimeoutMs = 30000;
+export async function poll(func, config) {
+    const intervalMs = config?.intervalMs ?? defaultIntervalMs;
+    const timeoutMs = config?.timeoutMs ?? defaultTimeoutMs;
+    const startTime = Date.now();
+    let result = await func();
+    while (!result.success && Date.now() - startTime <= timeoutMs) {
+        await sleep(intervalMs);
+        result = await func();
+    }
+    return result;
+}
+//# sourceMappingURL=poll.utils.js.map

package/dist/testkit/poll.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.utils.js","sourceRoot":"","sources":["../../lib/testkit/poll.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAG/C,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,IAAI,CACzB,IAAgE,EAChE,MAGC;IAED,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,iBAAiB,CAAC;IAC3D,MAAM,SAAS,GAAG,MAAM,EAAE,SAAS,IAAI,gBAAgB,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;IAE1B,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,IAAI,SAAS,EAAE,CAAC;QAC/D,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;QACxB,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/testkit/testkit.models.d.ts

@@ -1,6 +1,6 @@
-import type { HttpServiceStatus } from "../http/http.models.js";
+import type { HttpStatusCode } from "../http/http.models.js";
 import type { JsonValue } from "../models/json.models.js";
 export type FetchResponse = {
-    readonly statusCode: HttpServiceStatus;
+    readonly statusCode: HttpStatusCode;
     readonly json: JsonValue;
 };

package/dist/testkit/testkit.utils.d.ts

@@ -0,0 +1,27 @@
+import type { GetNextPageData, HttpService, HttpStatusCode } from "../http/http.models.js";
+import type { RetryStrategyOptions, SdkInfo } from "../models/core.models.js";
+import type { JsonValue } from "../models/json.models.js";
+export declare function mockGlobalFetchJsonResponse({ jsonResponse, statusCode, continuationToken }: {
+    readonly jsonResponse: JsonValue;
+    readonly statusCode: HttpStatusCode;
+    readonly continuationToken?: string;
+}): void;
+export declare function mockGlobalFetchBlobResponse({ blobResponse, statusCode }: {
+    readonly blobResponse: Blob;
+    readonly statusCode: HttpStatusCode;
+}): void;
+export declare function getFakeBlob(): Blob;
+export declare function getTestSdkInfo(): SdkInfo;
+export declare function getTestHttpServiceWithJsonResponse({ jsonResponse, statusCode, continuationToken, retryStrategy }: {
+    readonly jsonResponse: JsonValue | (() => Promise<JsonValue>);
+    readonly statusCode: HttpStatusCode;
+    readonly continuationToken?: string;
+    readonly retryStrategy?: RetryStrategyOptions;
+}): HttpService;
+export declare function preventInfinitePaging({ responseIndex, maxPagesCount, continuationToken, nextPageUrl }: {
+    readonly responseIndex: number;
+    readonly maxPagesCount: number;
+    readonly continuationToken?: string;
+    readonly nextPageUrl?: string | undefined;
+}): ReturnType<GetNextPageData<null, null, unknown>>;
+export declare function getNextPageUrl(index: number): string;

package/dist/testkit/testkit.utils.js

@@ -0,0 +1,113 @@
+import { vi } from "vitest";
+import { getDefaultHttpService } from "../http/http.service.js";
+import { isDefined } from "../utils/core.utils.js";
+import { createContinuationHeader, findHeaderByName, toFetchHeaders } from "../utils/header.utils.js";
+const upperBoundLimitForInfinitePaging = 50;
+export function mockGlobalFetchJsonResponse({ jsonResponse, statusCode, continuationToken, }) {
+    global.fetch = getFetchJsonMock({
+        json: jsonResponse,
+        status: statusCode,
+        responseHeaders: continuationToken ? [createContinuationHeader(continuationToken)] : [],
+    });
+}
+export function mockGlobalFetchBlobResponse({ blobResponse, statusCode, }) {
+    global.fetch = getFetchBlobMock({
+        blob: blobResponse,
+        status: statusCode,
+    });
+}
+export function getFakeBlob() {
+    return new Blob(["x"], { type: "text/plain" });
+}
+export function getTestSdkInfo() {
+    return {
+        name: "test",
+        version: "0.0.0",
+        host: "sdk",
+    };
+}
+export function getTestHttpServiceWithJsonResponse({ jsonResponse, statusCode, continuationToken, retryStrategy, }) {
+    return getDefaultHttpService({
+        retryStrategy: retryStrategy ?? {},
+        adapter: {
+            executeRequest: async ({ url }) => {
+                return {
+                    responseHeaders: [...(continuationToken ? [createContinuationHeader(continuationToken)] : [])],
+                    status: statusCode,
+                    statusText: "",
+                    url,
+                    payload: typeof jsonResponse === "function" ? await jsonResponse() : jsonResponse,
+                };
+            },
+            downloadFile: async ({ url }) => {
+                return {
+                    responseHeaders: [],
+                    status: 200,
+                    statusText: "",
+                    url,
+                    payload: await Promise.resolve(getFakeBlob()),
+                };
+            },
+        },
+    });
+}
+export function preventInfinitePaging({ responseIndex, maxPagesCount, continuationToken, nextPageUrl, }) {
+    if (responseIndex >= maxPagesCount + upperBoundLimitForInfinitePaging) {
+        throw new Error("Infinite paging detected");
+    }
+    return {
+        continuationToken,
+        nextPageUrl,
+    };
+}
+export function getNextPageUrl(index) {
+    return `https://page-url.com/${index}`;
+}
+function getFetchBlobMock({ blob, status, responseHeaders, }) {
+    return getFetchMock({
+        blob,
+        status,
+        responseHeaders: responseHeaders ?? [],
+        json: undefined,
+    });
+}
+function getFetchJsonMock({ json, status, responseHeaders, }) {
+    return getFetchMock({
+        status,
+        responseHeaders: responseHeaders ?? [],
+        blob: undefined,
+        json,
+    });
+}
+function getFetchMock({ json, blob, status, responseHeaders, }) {
+    return vi.fn(async () => {
+        const baseResponse = {
+            ok: status >= 200 && status < 300,
+            headers: buildHeadersWithDefaultContentType(responseHeaders),
+            status,
+            json: async () => await Promise.resolve(json),
+            ...(blob ? { blob: async () => await Promise.resolve(blob) } : {}),
+        };
+        return await Promise.resolve({
+            // only implement the methods we need, ignore the rest
+            ...{},
+            ...baseResponse,
+        });
+    });
+}
+function buildHeadersWithDefaultContentType(headers) {
+    const defaultContentTypeHeader = getDefaultContentTypeHeaderIfMissing(headers);
+    const headersWithDefaults = [...headers, defaultContentTypeHeader].filter(isDefined);
+    return toFetchHeaders(headersWithDefaults);
+}
+function getDefaultContentTypeHeaderIfMissing(headers) {
+    const hasContentTypeHeader = findHeaderByName(headers, "Content-Type");
+    if (hasContentTypeHeader) {
+        return undefined;
+    }
+    return {
+        name: "Content-Type",
+        value: "application/json",
+    };
+}
+//# sourceMappingURL=testkit.utils.js.map

package/dist/testkit/testkit.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testkit.utils.js","sourceRoot":"","sources":["../../lib/testkit/testkit.utils.ts"],"names":[],"mappings":"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"}

package/dist/testkit_api.d.ts

@@ -1,2 +1,4 @@
-export { getFakeBlob, getFetchBlobMock, getFetchJsonMock } from "./testkit/test.utils.js";
+/** biome-ignore-all lint/performance/noBarrelFile: One barrel for exported API is fine */
+export { poll } from "./testkit/poll.utils.js";
 export type { FetchResponse } from "./testkit/testkit.models.js";
+export { getFakeBlob, getNextPageUrl, getTestHttpServiceWithJsonResponse, getTestSdkInfo, mockGlobalFetchBlobResponse, mockGlobalFetchJsonResponse, preventInfinitePaging, } from "./testkit/testkit.utils.js";

package/dist/testkit_api.js

@@ -1,3 +1,4 @@
-// biome-ignore lint/performance/noBarrelFile: One barrel for the Devkit API is fine
-export { getFakeBlob, getFetchBlobMock, getFetchJsonMock } from "./testkit/test.utils.js";
+/** biome-ignore-all lint/performance/noBarrelFile: One barrel for exported API is fine */
+export { poll } from "./testkit/poll.utils.js";
+export { getFakeBlob, getNextPageUrl, getTestHttpServiceWithJsonResponse, getTestSdkInfo, mockGlobalFetchBlobResponse, mockGlobalFetchJsonResponse, preventInfinitePaging, } from "./testkit/testkit.utils.js";
 //# sourceMappingURL=testkit_api.js.map

package/dist/testkit_api.js.map

@@ -1 +1 @@
-{"version":3,"file":"testkit_api.js","sourceRoot":"","sources":["../lib/testkit_api.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"testkit_api.js","sourceRoot":"","sources":["../lib/testkit_api.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAE/C,OAAO,EACN,WAAW,EACX,cAAc,EACd,kCAAkC,EAClC,cAAc,EACd,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,GACrB,MAAM,4BAA4B,CAAC"}

package/dist/utils/abort.utils.d.ts

@@ -0,0 +1,12 @@
+type AbortResult<TData> = {
+    readonly isAborted: false;
+    readonly data: TData;
+} | {
+    readonly isAborted: true;
+    readonly data?: never;
+};
+export declare function runWithAbortSignal<T>({ func, abortSignal }: {
+    readonly func: () => Promise<T>;
+    readonly abortSignal: AbortSignal;
+}): Promise<AbortResult<T>>;
+export {};

package/dist/utils/abort.utils.js

@@ -0,0 +1,30 @@
+export async function runWithAbortSignal({ func, abortSignal, }) {
+    if (abortSignal.aborted) {
+        return {
+            isAborted: true,
+        };
+    }
+    const listenerName = "abort";
+    return await new Promise((resolve, reject) => {
+        const onAbort = () => {
+            cleanup();
+            resolve({ isAborted: true });
+        };
+        const cleanup = () => {
+            abortSignal.removeEventListener(listenerName, onAbort);
+        };
+        abortSignal.addEventListener(listenerName, onAbort);
+        func()
+            .then((result) => {
+            resolve({ isAborted: false, data: result });
+        })
+            .catch((error) => {
+            // forward any error that occurs during the execution of the function
+            reject(error);
+        })
+            .finally(() => {
+            cleanup();
+        });
+    });
+}
+//# sourceMappingURL=abort.utils.js.map

package/dist/utils/abort.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.utils.js","sourceRoot":"","sources":["../../lib/utils/abort.utils.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAI,EAC3C,IAAI,EACJ,WAAW,GAIX;IACA,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO;YACN,SAAS,EAAE,IAAI;SACf,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC;IAE7B,OAAO,MAAM,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC5D,MAAM,OAAO,GAAG,GAAG,EAAE;YACpB,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,EAAE;YACpB,WAAW,CAAC,mBAAmB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC,CAAC;QACF,WAAW,CAAC,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAEpD,IAAI,EAAE;aACJ,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YAChB,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7C,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAChB,qEAAqE;YACrE,MAAM,CAAC,KAAK,CAAC,CAAC;QACf,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACb,OAAO,EAAE,CAAC;QACX,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/array.utils.d.ts

@@ -0,0 +1 @@
+export declare function isNonEmptyArray<T>(array: readonly T[]): array is [T, ...T[]];

package/dist/utils/array.utils.js

@@ -0,0 +1,4 @@
+export function isNonEmptyArray(array) {
+    return array.length > 0;
+}
+//# sourceMappingURL=array.utils.js.map

package/dist/utils/array.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.utils.js","sourceRoot":"","sources":["../../lib/utils/array.utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAI,KAAmB;IACrD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/utils/core.utils.d.ts

@@ -1 +1,3 @@
-export declare function isNotUndefined<T>(value: T): value is NonNullable<T>;
+export declare function isDefined<T>(value: T): value is NonNullable<T>;
+export declare function sleep(ms: number): Promise<void>;
+export declare function isBlob(value: unknown): value is Blob;

package/dist/utils/core.utils.js

@@ -1,4 +1,20 @@
-export function isNotUndefined(value) {
-    return value !== undefined;
+export function isDefined(value) {
+    return value !== undefined && value !== null;
+}
+export async function sleep(ms) {
+    return await new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+export function isBlob(value) {
+    if (!value) {
+        return false;
+    }
+    if (value instanceof Blob) {
+        return true;
+    }
+    const record = value;
+    return (Object.prototype.toString.call(value) === "[object Blob]" ||
+        (typeof record.arrayBuffer === "function" && typeof record.size === "number"));
 }
 //# sourceMappingURL=core.utils.js.map

package/dist/utils/core.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.utils.js","sourceRoot":"","sources":["../../lib/utils/core.utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAI,KAAQ;IACzC,OAAO,KAAK,KAAK,SAAS,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"core.utils.js","sourceRoot":"","sources":["../../lib/utils/core.utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAI,KAAQ;IACpC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,EAAU;IACrC,OAAO,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC1C,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAc;IACpC,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACd,CAAC;IAED,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,MAAM,GAAG,KAAgC,CAAC;IAEhD,OAAO,CACN,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,eAAe;QACzD,CAAC,OAAO,MAAM,CAAC,WAAW,KAAK,UAAU,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAC7E,CAAC;AACH,CAAC"}

package/dist/utils/error.utils.d.ts

@@ -1,10 +1,26 @@
-import type { AdapterResponse } from "../http/http.models.js";
-import type { HttpMethod, KontentErrorResponseData } from "../models/core.models.js";
-import type { CoreSdkError } from "../models/error.models.js";
-export declare function isKontent404Error(error: CoreSdkError): error is CoreSdkError<"invalidResponse">;
-export declare function getErrorMessage({ method, url, adapterResponse, kontentErrorResponse, }: {
-    readonly url: string;
+import type { AdapterPayload, AdapterResponse } from "../http/http.models.js";
+import type { HttpMethod } from "../models/core.models.js";
+import { AdapterAbortError, AdapterParseError, type BaseErrorData, type ErrorDetails, type ErrorResponseData, KontentSdkError } from "../models/error.models.js";
+export declare function createSdkError<TDetails extends ErrorDetails>({ baseErrorData, details }: {
+    readonly baseErrorData: BaseErrorData;
+    readonly details: TDetails;
+}): KontentSdkError<TDetails>;
+export declare function isKontent404Error(error: unknown): boolean;
+export declare function isKontentSdkError(error: unknown): error is KontentSdkError;
+export declare function isAdapterParseError(error: unknown): error is AdapterParseError;
+export declare function isAdapterAbortError(error: unknown): error is AdapterAbortError;
+export declare function toInvalidResponseMessage({ method, url, adapterResponse, kontentErrorData: kontentErrorResponse }: {
+    readonly url: URL;
     readonly method: HttpMethod;
-    readonly adapterResponse: AdapterResponse;
-    readonly kontentErrorResponse?: KontentErrorResponseData;
+    readonly adapterResponse: AdapterResponse<AdapterPayload>;
+    readonly kontentErrorData: ErrorResponseData | undefined;
 }): string;
+/**
+ * Checks if the given JSON value is a Kontent API error response data.
+ */
+export declare function isKontentErrorResponseData(json: unknown): json is ErrorResponseData;
+/**
+ * Checks if the given error is a fetch abort error.
+ */
+export declare function isFetchAbortError(error: unknown): boolean;
+export declare function toFriendlyKontentSdkErrorMessage(message: string, error: ErrorDetails): string;

package/dist/utils/error.utils.js

@@ -1,13 +1,51 @@
-import { isNotUndefined } from "./core.utils.js";
+import { match, P } from "ts-pattern";
+import { AdapterAbortError, AdapterParseError, errorResponseDataSchema, KontentSdkError, } from "../models/error.models.js";
+import { isDefined } from "./core.utils.js";
+export function createSdkError({ baseErrorData, details, }) {
+    return new KontentSdkError({
+        baseErrorData,
+        details,
+    });
+}
 export function isKontent404Error(error) {
-    return isErrorOfType("invalidResponse", error) && error.status === 404;
+    return isKontentSdkError(error) && error.details.reason === "notFound";
+}
+export function isKontentSdkError(error) {
+    return error instanceof KontentSdkError;
+}
+export function isAdapterParseError(error) {
+    return error instanceof AdapterParseError;
+}
+export function isAdapterAbortError(error) {
+    return error instanceof AdapterAbortError;
 }
-export function getErrorMessage({ method, url, adapterResponse, kontentErrorResponse, }) {
-    const details = kontentErrorResponse ? getKontentErrorResponseMessage(adapterResponse, kontentErrorResponse) : undefined;
-    return `Failed to execute '${method}' request '${url}'.${details ? ` ${details}` : ""}`;
+export function toInvalidResponseMessage({ method, url, adapterResponse, kontentErrorData: kontentErrorResponse, }) {
+    const details = kontentErrorResponse ? ` ${getKontentErrorResponseMessage(adapterResponse, kontentErrorResponse)}` : "";
+    return `Failed to execute '${method}' request '${url.toString()}'.${details}`;
+}
+/**
+ * Checks if the given JSON value is a Kontent API error response data.
+ */
+export function isKontentErrorResponseData(json) {
+    if (!json || typeof json !== "object" || Array.isArray(json)) {
+        return false;
+    }
+    return errorResponseDataSchema.safeParse(json).success;
+}
+/**
+ * Checks if the given error is a fetch abort error.
+ */
+export function isFetchAbortError(error) {
+    if (!error || typeof error !== "object") {
+        return false;
+    }
+    return "name" in error && error.name === "AbortError";
 }
-function isErrorOfType(reason, error) {
-    return error.reason === reason;
+export function toFriendlyKontentSdkErrorMessage(message, error) {
+    return match(error)
+        .returnType()
+        .with({ reason: P.union("invalidResponse", "notFound"), kontentErrorResponse: P.nonNullable }, (m) => `${message} ${m.kontentErrorResponse.message}`)
+        .otherwise(() => message);
 }
 function getValidationErrorMessage(validationErrors) {
     if (!validationErrors?.length) {
@@ -19,13 +57,13 @@ function getValidationErrorMessage(validationErrors) {
             m.path ? `path: ${m.path}` : undefined,
             m.line ? `line: ${m.line}` : undefined,
             m.position ? `position: ${m.position}` : undefined,
-        ].filter(isNotUndefined);
+        ].filter(isDefined);
         return `${m.message}${details.length ? ` (${details.join(", ")})` : ""}`;
     })
         .join(", ");
 }
 function getKontentErrorResponseMessage(adapterResponse, kontentErrorResponse) {
     const validationErrorMessage = getValidationErrorMessage(kontentErrorResponse.validation_errors);
-    return `Response failed with status '${adapterResponse.status}' and status text '${adapterResponse.statusText}'.${kontentErrorResponse.message}${validationErrorMessage ? ` ${validationErrorMessage}` : ""}`;
+    return `Request failed with status '${adapterResponse.status}' and status text '${adapterResponse.statusText}'. ${kontentErrorResponse.message}${validationErrorMessage ? ` ${validationErrorMessage}` : ""}`;
 }
 //# sourceMappingURL=error.utils.js.map