@kontent-ai/core-sdk 12.0.0-preview.2 → 12.0.0-preview.21

package/dist/sdk/resolve-query.js

@@ -0,0 +1,108 @@
+/**
+ * Shared query models/types intended to be reused across SDKs (e.g. Sync, Delivery, Management)
+ * to keep common code and behavior consistent.
+ */
+import { getDefaultHttpService } from "../http/http.service.js";
+import { createSdkError } from "../utils/error.utils.js";
+import { createAuthorizationHeader, createContinuationHeader, extractContinuationToken, getSdkIdHeader } from "../utils/header.utils.js";
+import { tryCatch } from "../utils/try-catch.utils.js";
+export async function resolveQuery({ config, request, mapMetadata, zodSchema, sdkInfo, method, abortSignal, mapError, }) {
+    const urlToUse = config.baseUrl ? setBaseUrl(request.url, config.baseUrl) : request.url;
+    const { success, response, error } = await getHttpService(config).request({
+        body: request.body,
+        url: urlToUse,
+        method,
+        abortSignal,
+        requestHeaders: getCombinedRequestHeaders({
+            requestHeaders: request.requestHeaders ?? [],
+            continuationToken: request.continuationToken,
+            authorizationApiKey: request.authorizationApiKey,
+            sdkInfo,
+        }),
+    });
+    if (!success) {
+        return {
+            success: false,
+            error: mapError(error),
+        };
+    }
+    if (config.responseValidation?.enable) {
+        const validationError = await validateResponse({ url: response.adapterResponse.url, response, zodSchema });
+        if (validationError) {
+            return {
+                success: false,
+                error: mapError(validationError.error),
+            };
+        }
+    }
+    const continuationTokenFromResponse = extractContinuationToken(response.adapterResponse.responseHeaders);
+    const result = {
+        success: true,
+        response: {
+            payload: response.payload,
+            meta: {
+                ...mapMetadata(response, { continuationToken: continuationTokenFromResponse }),
+                url: response.adapterResponse.url,
+                responseHeaders: response.adapterResponse.responseHeaders,
+                status: response.adapterResponse.status,
+                continuationToken: continuationTokenFromResponse,
+            },
+        },
+    };
+    return result;
+}
+/**
+ * We are intentionally not throwing errors here as parsing errors are handled by the HttpService.
+ */
+function setBaseUrl(url, baseUrl) {
+    const { success, data: parsedUrl } = tryCatch(() => new URL(url));
+    if (!success) {
+        return url;
+    }
+    if (baseUrl.startsWith("http")) {
+        const { success, data: parsedBaseUrl } = tryCatch(() => new URL(baseUrl));
+        if (!success) {
+            return url;
+        }
+        parsedUrl.host = parsedBaseUrl.host;
+        parsedUrl.protocol = parsedBaseUrl.protocol;
+        return parsedUrl.toString();
+    }
+    parsedUrl.host = baseUrl;
+    return parsedUrl.toString();
+}
+async function validateResponse({ url, response, zodSchema, }) {
+    const { success, error } = await zodSchema.safeParseAsync(response.payload);
+    if (!success) {
+        return {
+            success: false,
+            error: createSdkError({
+                baseErrorData: {
+                    message: `Failed to validate response schema for url '${url}'`,
+                    url,
+                    retryStrategyOptions: undefined,
+                    retryAttempt: undefined,
+                },
+                details: {
+                    reason: "validationFailed",
+                    zodError: error,
+                    response,
+                    url,
+                },
+            }),
+        };
+    }
+    return undefined;
+}
+function getHttpService(config) {
+    return config.httpService ?? getDefaultHttpService();
+}
+function getCombinedRequestHeaders({ requestHeaders, continuationToken, authorizationApiKey, sdkInfo, }) {
+    return [
+        getSdkIdHeader(sdkInfo),
+        ...requestHeaders.filter((header) => header.name !== "X-KC-SDKID"),
+        ...(continuationToken ? [createContinuationHeader(continuationToken)] : []),
+        ...(authorizationApiKey ? [createAuthorizationHeader(authorizationApiKey)] : []),
+    ];
+}
+//# sourceMappingURL=resolve-query.js.map

package/dist/sdk/resolve-query.js.map

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

package/dist/sdk/sdk-config.d.ts

@@ -0,0 +1,3 @@
+import z from "zod";
+export declare const nilUuid = "00000000-0000-0000-0000-000000000000";
+export declare const kontentUuidSchema: z.ZodUnion<readonly [z.ZodUUID, z.ZodLiteral<"00000000-0000-0000-0000-000000000000">]>;

package/dist/sdk/sdk-config.js

@@ -0,0 +1,4 @@
+import z from "zod";
+export const nilUuid = "00000000-0000-0000-0000-000000000000";
+export const kontentUuidSchema = z.union([z.uuid({ version: "v4" }), z.literal(nilUuid)]);
+//# sourceMappingURL=sdk-config.js.map

package/dist/sdk/sdk-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-config.js","sourceRoot":"","sources":["../../lib/sdk/sdk-config.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,MAAM,CAAC,MAAM,OAAO,GAAG,sCAAsC,CAAC;AAE9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/sdk/sdk-models.d.ts

@@ -2,18 +2,22 @@
  * Shared query models/types intended to be reused across SDKs (e.g. Sync, Delivery, Management)
  * to keep common code and behavior consistent.
  */
-import type { AdapterResponse, HttpResponse, HttpService } from "../http/http.models.js";
-import type { CoreSdkError } from "../models/error.models.js";
+import type z from "zod";
+import type { ZodType } from "zod";
+import type { AdapterPayload, AdapterResponse, HttpPayload, HttpRequestBody, HttpResponse, HttpService, PaginationConfig } from "../http/http.models.js";
+import type { Header, HttpMethod, SDKInfo } from "../models/core.models.js";
+import type { KontentSdkError } from "../models/error.models.js";
 import type { JsonValue } from "../models/json.models.js";
-import type { Prettify } from "../models/utility.models.js";
-export type CoreResponseMeta<TExtraMetadata = unknown> = Pick<AdapterResponse, "status" | "responseHeaders"> & {
-    readonly continuationToken?: string;
-} & TExtraMetadata;
-export type CoreResponse<TPayload, TExtraMetadata = unknown> = {
-    readonly payload: TPayload;
-    readonly meta: CoreResponseMeta<TExtraMetadata>;
+import type { PickStringLiteral } from "../models/utility.types.js";
+import type { Failure, Success } from "../utils/try-catch.utils.js";
+export type QueryResponseMeta<TMeta> = Pick<AdapterResponse<AdapterPayload>, "status" | "responseHeaders" | "url"> & {
+    readonly continuationToken: string | undefined;
+} & TMeta;
+export type QueryResponse<TResponsePayload, TMeta> = {
+    readonly payload: TResponsePayload;
+    readonly meta: QueryResponseMeta<TMeta>;
 };
-export type CoreSdkConfig = {
+export type SdkConfig = {
     /**
      * The HTTP service to use for the request. If not provided, the default HTTP service will be used.
      *
@@ -33,7 +37,7 @@ export type CoreSdkConfig = {
      */
     readonly responseValidation?: {
         /**
-         * When enabled, the response payload will be validated against the expected Zod schema from which the types
+         * When enabled, the response data will be validated against the expected Zod schema from which the types
          * this library are based on. This ensures that you are working with the correct data types.
          *
          * @default false
@@ -41,42 +45,103 @@ export type CoreSdkConfig = {
         readonly enable: boolean;
     };
 };
-export type Query<TPayload, TExtraData = unknown> = {
-    toUrl(): string;
-    toPromise(): Promise<QueryResult<CoreResponse<TPayload, TExtraData>>>;
+export type Query<TResponsePayload> = {
+    readonly schema: z.ZodType<TResponsePayload>;
+    readonly url: string;
 };
-export type PagingQuery<TPayload, TExtraData = unknown> = Query<TPayload, TExtraData> & {
-    toAllPromise(): Promise<PagingQueryResult<CoreResponse<TPayload, TExtraData>>>;
+export type FetchQuery<TResponsePayload, TMeta, TError> = Query<TResponsePayload> & {
+    fetchSafe(): Promise<QueryResult<QueryResponse<TResponsePayload, TMeta>, TError>>;
+    fetch(): Promise<QueryResponse<TResponsePayload, TMeta>>;
 };
-export type SuccessfulHttpResponse<TPayload extends JsonValue, TBodyData extends JsonValue> = Prettify<Extract<HttpResponse<TPayload, TBodyData>, {
-    readonly success: true;
-}>["response"]>;
-export type ResultOfSuccessfulQuery<TQuery extends Query<unknown>> = Extract<Awaited<ReturnType<TQuery["toPromise"]>>, {
+export type PagedFetchQuery<TResponsePayload, TMeta, TError> = Query<TResponsePayload> & {
+    fetchPageSafe(): Promise<QueryResult<QueryResponse<TResponsePayload, TMeta>, TError>>;
+    fetchPage(): Promise<QueryResponse<TResponsePayload, TMeta>>;
+    fetchAllPagesSafe(config?: PaginationConfig): Promise<SafePagingQueryResult<QueryResponse<TResponsePayload, TMeta>, TError>>;
+    fetchAllPages(config?: PaginationConfig): Promise<PagingQueryResult<QueryResponse<TResponsePayload, TMeta>>>;
+    pagesSafe(config?: PaginationConfig): AsyncGenerator<QueryResult<QueryResponse<TResponsePayload, TMeta>, TError>>;
+    pages(config?: PaginationConfig): AsyncGenerator<QueryResponse<TResponsePayload, TMeta>>;
+};
+/**
+ * Not yet implemented.
+ *
+ * @todo Implement mutation query.
+ */
+export type MutationQuery<TResponsePayload, TMeta, TError> = Query<TResponsePayload> & {
+    executeSafe(): Promise<QueryResult<QueryResponse<TResponsePayload, TMeta>, TError>>;
+    execute(): Promise<QueryResponse<TResponsePayload, TMeta>>;
+};
+export type NextPageStateWithRequest = {
+    readonly pageSource: "continuationToken";
+    readonly hasNextPage: true;
+    readonly continuationToken: string;
+    readonly nextPageUrl?: never;
+} | {
+    readonly pageSource: "nextPageUrl";
+    readonly hasNextPage: true;
+    readonly continuationToken?: never;
+    readonly nextPageUrl: string;
+} | {
+    readonly pageSource: "firstRequest";
+    readonly hasNextPage: true;
+    readonly continuationToken?: never;
+    readonly nextPageUrl?: never;
+};
+export type SuccessfulHttpResponse<TResponsePayload extends HttpPayload, TRequestBody extends HttpRequestBody> = Extract<HttpResponse<TResponsePayload, TRequestBody>, {
     readonly success: true;
 }>["response"];
 /**
- * A nomadic result type that represents a success or failure of an operation.
+ * Result type that represents a success or failure of an operation.
  *
  * Ensures that consumers of this library handle both success and failure cases.
  */
-export type QueryResult<TResponse> = (Success & {
-    readonly response: TResponse;
-}) | (Failure & {
+export type QueryResult<TResponsePayload, TError> = Success<{
+    readonly response: TResponsePayload;
+}> | Failure<{
     readonly response?: never;
-});
-export type PagingQueryResult<TResponse> = (Success & {
-    readonly responses: TResponse[];
-    readonly lastContinuationToken: string;
-}) | (Failure & {
+}, TError>;
+export type SafePagingQueryResult<TResponsePayload, TError> = Success<{
+    readonly responses: readonly TResponsePayload[];
+    readonly partialResponses?: never;
+    readonly lastContinuationToken: string | undefined;
+}> | Failure<{
     readonly responses?: never;
     readonly lastContinuationToken?: never;
-});
-type Success = {
-    readonly success: true;
-    readonly error?: never;
+    readonly partialResponses: readonly TResponsePayload[];
+}, TError>;
+export type PagingQueryResult<TResponsePayload> = {
+    readonly responses: readonly TResponsePayload[];
+    readonly lastContinuationToken: string | undefined;
+};
+export type QueryPromiseResult<TResponsePayload extends JsonValue, TMeta, TError> = ReturnType<Pick<FetchQuery<TResponsePayload, TMeta, TError>, "fetchSafe">["fetchSafe"]>;
+export type FetchQueryRequest<TResponsePayload extends JsonValue, TMeta, TError> = Pick<ResolveQueryData<TResponsePayload, null, TMeta, TError>, "config" | "zodSchema" | "sdkInfo" | "mapMetadata" | "abortSignal" | "mapError"> & {
+    readonly request: RequestDataWithoutBody;
+};
+export type MutationQueryRequest<TResponsePayload extends JsonValue, TRequestBody extends HttpRequestBody, TMeta, TError> = Pick<ResolveQueryData<TResponsePayload, TRequestBody, TMeta, TError>, "config" | "zodSchema" | "sdkInfo" | "mapMetadata" | "abortSignal" | "request" | "mapError"> & {
+    readonly method: MutationHttpMethod;
+};
+export type ResolveQueryData<TResponsePayload extends JsonValue, TRequestBody extends HttpRequestBody, TMeta, TError> = {
+    readonly method: HttpMethod;
+    readonly request: RequestData<TRequestBody>;
+    readonly config: SdkConfig;
+    readonly zodSchema: ZodType<TResponsePayload>;
+    readonly sdkInfo: SDKInfo;
+    readonly abortSignal?: AbortSignal | undefined;
+    readonly mapError: (error: KontentSdkError) => TError;
+} & MetadataMapperConfig<TResponsePayload, TRequestBody, TMeta>;
+type MetadataMapperConfig<TResponsePayload extends JsonValue, TRequestBody extends HttpRequestBody, TMeta> = {
+    readonly mapMetadata: MetadataMapper<TResponsePayload, TRequestBody, TMeta>;
+};
+type MetadataMapper<TResponsePayload extends JsonValue, TRequestBody extends HttpRequestBody, TMeta> = (response: SuccessfulHttpResponse<TResponsePayload, TRequestBody>, data: MetadataContextData) => TMeta;
+type MetadataContextData = {
+    readonly continuationToken: string | undefined;
 };
-type Failure = {
-    readonly success: false;
-    readonly error: CoreSdkError;
+type RequestData<TRequestBody extends HttpRequestBody> = {
+    readonly url: string;
+    readonly body: TRequestBody;
+    readonly requestHeaders?: readonly Header[];
+    readonly continuationToken?: string | undefined;
+    readonly authorizationApiKey?: string | undefined;
 };
+type MutationHttpMethod = PickStringLiteral<HttpMethod, "POST" | "PUT" | "PATCH" | "DELETE">;
+type RequestDataWithoutBody = Omit<RequestData<never>, "body">;
 export {};

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

@@ -0,0 +1,2 @@
+import type { PagedFetchQuery, Query } from "./sdk-models.js";
+export declare function isPagingQuery<T, TBody = null, TError = unknown>(query: Query<T> | PagedFetchQuery<T, TBody, TError>): query is PagedFetchQuery<T, TBody, TError>;

package/dist/sdk/sdk-utils.js

@@ -0,0 +1,9 @@
+export function isPagingQuery(query) {
+    return ("fetchPage" in query &&
+        "fetchPageSafe" in query &&
+        "fetchAllPages" in query &&
+        "fetchAllPagesSafe" in query &&
+        "pages" in query &&
+        "pagesSafe" in query);
+}
+//# sourceMappingURL=sdk-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-utils.js","sourceRoot":"","sources":["../../lib/sdk/sdk-utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAC5B,KAAmD;IAEnD,OAAO,CACN,WAAW,IAAI,KAAK;QACpB,eAAe,IAAI,KAAK;QACxB,eAAe,IAAI,KAAK;QACxB,mBAAmB,IAAI,KAAK;QAC5B,OAAO,IAAI,KAAK;QAChB,WAAW,IAAI,KAAK,CACpB,CAAC;AACH,CAAC"}

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,24 @@
+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 elapsedMs = 0;
+    let latestAttempt;
+    while (elapsedMs <= timeoutMs) {
+        const result = await func();
+        latestAttempt = result;
+        if (result.success) {
+            return result;
+        }
+        elapsedMs = Date.now() - startTime;
+        await sleep(intervalMs);
+    }
+    if (!latestAttempt) {
+        throw new Error("Invalid latest attempt in poll result");
+    }
+    return latestAttempt;
+}
+//# 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,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,aAAsE,CAAC;IAE3E,OAAO,SAAS,IAAI,SAAS,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QAC5B,aAAa,GAAG,MAAM,CAAC;QAEvB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QACf,CAAC;QAED,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACnC,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,aAAa,CAAC;AACtB,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { HttpService, HttpServiceStatus } 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: HttpServiceStatus;
+    readonly continuationToken?: string;
+}): void;
+export declare function mockGlobalFetchBlobResponse({ blobResponse, statusCode, }: {
+    readonly blobResponse: Blob;
+    readonly statusCode: HttpServiceStatus;
+}): 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: HttpServiceStatus;
+    readonly continuationToken?: string;
+    readonly retryStrategy?: RetryStrategyOptions;
+}): HttpService;

package/dist/testkit/testkit.utils.js

@@ -0,0 +1,100 @@
+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";
+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()),
+                };
+            },
+        },
+    });
+}
+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, getTestHttpServiceWithJsonResponse, getTestSdkInfo, mockGlobalFetchBlobResponse, mockGlobalFetchJsonResponse, } 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, getTestHttpServiceWithJsonResponse, getTestSdkInfo, mockGlobalFetchBlobResponse, mockGlobalFetchJsonResponse, } 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,kCAAkC,EAClC,cAAc,EACd,2BAA2B,EAC3B,2BAA2B,GAC3B,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,29 @@
+export async function runWithAbortSignal({ func, abortSignal, }) {
+    if (abortSignal.aborted) {
+        return {
+            isAborted: true,
+        };
+    }
+    const listenerName = "abort";
+    return await new Promise((resolve) => {
+        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(() => {
+            resolve({ isAborted: true });
+        })
+            .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,EAAE;QACpD,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,GAAG,EAAE;YACX,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACb,OAAO,EAAE,CAAC;QACX,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACJ,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,24 @@
-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.text === "function" &&
+            typeof record.stream === "function" &&
+            typeof record.size === "number" &&
+            typeof record.type === "string"));
 }
 //# 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;YACxC,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU;YACjC,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU;YACnC,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YAC/B,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CACjC,CAAC;AACH,CAAC"}

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

@@ -1,10 +1,21 @@
-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, }: {
+import type { AdapterPayload, AdapterResponse } from "../http/http.models.js";
+import type { ErrorResponseData, HttpMethod } from "../models/core.models.js";
+import { AdapterAbortError, AdapterParseError, type BaseErrorData, type ErrorDetails, 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, kontentErrorResponse, }: {
     readonly url: string;
     readonly method: HttpMethod;
-    readonly adapterResponse: AdapterResponse;
-    readonly kontentErrorResponse?: KontentErrorResponseData;
+    readonly adapterResponse: AdapterResponse<AdapterPayload>;
+    readonly kontentErrorResponse?: ErrorResponseData;
 }): string;
+/**
+ * Checks if the given JSON value is a Kontent API error response data.
+ */
+export declare function isKontentErrorResponseData(json: unknown): json is ErrorResponseData;