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

package/dist/models/core.models.d.ts

@@ -1,9 +1,9 @@
-import type { CoreSdkError } from "./error.models.js";
-import type { PickStringLiteral } from "./utility.models.js";
+import type { ErrorDetailsFor, KontentSdkError } from "./error.models.js";
+import type { LiteralUnion, PickStringLiteral } from "./utility.types.js";
 /**
  * SDK info for identification of the SDK
  */
-export type SDKInfo = {
+export type SdkInfo = {
     /**
      * The name of the SDK.
      */
@@ -17,58 +17,51 @@ export type SDKInfo = {
      */
     readonly host: LiteralUnion<"npmjs.com">;
 };
-export type CommonHeaderNames = "Retry-After" | "X-KC-SDKID" | "Authorization" | "Content-Type" | "Content-Length" | "X-Continuation";
-export type ContinuationHeaderName = PickStringLiteral<CommonHeaderNames, "X-Continuation">;
+export type KnownHeaderName = "Retry-After" | "X-KC-SDKID" | "Authorization" | "Content-Type" | "Content-Length" | "X-Continuation";
+export type ContinuationTokenHeaderName = PickStringLiteral<KnownHeaderName, "X-Continuation">;
 export type Header = {
-    readonly name: string;
+    readonly name: LiteralUnion<KnownHeaderName>;
     readonly value: string;
 };
 export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
-export type KontentValidationError = {
-    readonly message: string;
-    readonly path?: string;
-    readonly line?: number;
-    readonly position?: number;
-};
-export type KontentErrorResponseData = {
-    readonly message: string;
-    readonly requestId?: string;
-    readonly error_code?: number;
-    readonly validation_errors?: readonly KontentValidationError[];
-};
 export type RetryStrategyOptions = {
     /**
      * Maximum number of retry attempts.
      *
-     * If not provided, the default implementation will be used.
+     * If not provided, the default number of retries defined within the SDK will be used.
      */
     readonly maxRetries?: number;
     /**
-     * Function to determine if the error should be retried.
+     * Determines whether an adapter error should be retried.
      *
-     * If not provided, the default implementation will be used.
-     */
-    readonly canRetryError?: (error: CoreSdkError) => boolean;
-    /**
-     * Function to determine the delay between requests in milliseconds.
+     * Adapter errors occur when the HTTP adapter fails to execute the request
+     * (e.g. network failures, connection timeouts, or other transport-level issues).
+     *
+     * This callback is evaluated only after SDK-defined retry rules are checked.
+     * The SDK handles the following cases directly:
+     *
+     * - Retried automatically:
+     *   - HTTP 429 (rate limit exceeded)
+     *
+     * - Not retried automatically:
+     *   - Invalid request body (`invalidBody`)
+     *   - Invalid URL (`invalidUrl`)
+     *   - 404 Not Found (`notFound`)
+     *   - 401 Unauthorized (`unauthorized`)
+     *   - API business/validation error response (`kontentErrorResponse`)
      *
-     * If not provided, the default implementation will be used.
      */
-    readonly getDelayBetweenRetriesMs?: (error: CoreSdkError) => number;
+    readonly canRetryAdapterError?: (error: KontentSdkError<ErrorDetailsFor<"adapterError">>) => boolean;
     /**
-     * Whether to log the retry attempt.
+     * Controls logging for retry attempts.
      *
-     * If false, the retry attempt will not be logged.
-     * If undefined, the default implementation will be used.
-     * Otherwise, the function will be called with the retry attempt and url.
+     * If undefined, no retry logging occurs (default behavior).
+     * If set to `'logToConsole'`, retries are logged to the console.
+     * If a function is provided, it is called with the retry attempt and url.
      */
-    readonly logRetryAttempt?: false | ((retryAttempt: number, url: string) => void);
+    readonly logRetryAttempt?: "logToConsole" | ((retryAttempt: number, url: string) => void);
+};
+export type ResolvedRetryStrategyOptions = Pick<Required<RetryStrategyOptions>, "maxRetries" | "canRetryAdapterError"> & {
+    readonly logRetryAttempt: undefined | ((retryAttempt: number, url: string) => void);
+    readonly getDelayBetweenRetriesMs: (error: KontentSdkError) => number;
 };
-/**
- * Adds intellisense for string union type, but also allows any string
- */
-export type LiteralUnion<T extends string | undefined> = T | (string & NonNullable<unknown>);
-/**
- * Adds intellisense for number union type, but also allows any number
- */
-export type LiteralUnionNumber<T extends number | undefined> = T | (number & NonNullable<unknown>);

package/dist/models/error.models.d.ts

@@ -1,30 +1,33 @@
-import type { ZodError } from "zod";
-import type { AdapterResponse, HttpServiceStatus } from "../http/http.models.js";
-import type { SuccessfulHttpResponse } from "../sdk/sdk-models.js";
-import type { KontentErrorResponseData, RetryStrategyOptions } from "./core.models.js";
+import * as z from "zod/mini";
+import type { AdapterPayload, AdapterResponse } from "../http/http.models.js";
+import type { ResolvedRetryStrategyOptions } from "./core.models.js";
 import type { JsonValue } from "./json.models.js";
-export type ErrorReason = "invalidResponse" | "invalidUrl" | "unknown" | "invalidBody" | "notFound" | "validationFailed" | "noResponses";
-export type CoreSdkErrorDetails<TReason extends ErrorReason = ErrorReason> = (Details<"invalidResponse", {
-    readonly kontentErrorResponse: KontentErrorResponseData | undefined;
-} & Pick<AdapterResponse<HttpServiceStatus>, "isValidResponse" | "responseHeaders" | "status" | "statusText">> | Details<"notFound", {
-    readonly kontentErrorResponse: KontentErrorResponseData | undefined;
-} & Pick<AdapterResponse<404>, "isValidResponse" | "responseHeaders" | "status" | "statusText">> | Details<"invalidBody", {
-    readonly originalError: unknown;
-}> | Details<"invalidUrl", {
-    readonly originalError: unknown;
-}> | Details<"unknown", {
-    readonly originalError: unknown;
-}> | Details<"validationFailed", {
-    readonly reason: "validationFailed";
-    readonly zodError: ZodError;
-    readonly response: SuccessfulHttpResponse<JsonValue, JsonValue>;
-    readonly url: string;
-}> | Details<"noResponses", {
-    readonly url: string;
-}>) & {
-    readonly reason: TReason;
-};
-export type CoreSdkError<TReason extends ErrorReason = ErrorReason> = {
+export declare const validationErrorSchema: z.ZodMiniObject<{
+    message: z.ZodMiniString<string>;
+    path: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    line: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+    position: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+}, z.core.$strip>;
+export type ValidationError = z.infer<typeof validationErrorSchema>;
+export declare const errorResponseDataSchema: z.ZodMiniObject<{
+    message: z.ZodMiniString<string>;
+    request_id: z.ZodMiniString<string>;
+    error_code: z.ZodMiniNumber<number>;
+    validation_errors: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
+        message: z.ZodMiniString<string>;
+        path: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        line: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+        position: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ErrorResponseData = z.infer<typeof errorResponseDataSchema>;
+export type ErrorReason = ErrorDetails["reason"];
+export type ErrorDetails = ReasonData<"adapterError", ErrorWithOriginalError> | ReasonData<"transformError", ErrorWithOriginalError> | ReasonData<"unauthorized", ErrorWithKontentResponse> | ReasonData<"invalidResponse", ErrorWithKontentResponse> | ReasonData<"parseError", ErrorWithOriginalError> | ReasonData<"notFound", ErrorWithKontentResponse> | ReasonData<"invalidBody", ErrorWithOriginalError> | ReasonData<"invalidUrl", ErrorWithOriginalError> | ReasonData<"aborted", ErrorWithOriginalError> | ReasonData<"parsingFailed", {
+    readonly zodError: z.core.$ZodError;
+    readonly payload: JsonValue;
+    readonly url: URL;
+}>;
+export type BaseErrorData = {
     /**
      * The message of the error
      */
@@ -32,17 +35,60 @@ export type CoreSdkError<TReason extends ErrorReason = ErrorReason> = {
     /**
      * The URL of the request.
      */
-    readonly url: string;
+    readonly url: string | URL;
     /**
      * Used retry strategy.
      */
-    readonly retryStrategyOptions?: Required<RetryStrategyOptions>;
+    readonly retryStrategyOptions: ResolvedRetryStrategyOptions | undefined;
     /**
      * The number of times the request has been retried.
      */
-    readonly retryAttempt?: number;
-} & CoreSdkErrorDetails<TReason>;
-type Details<TReason extends ErrorReason, TDetails> = {
+    readonly retryAttempt: number | undefined;
+};
+export declare class KontentSdkError<TDetails extends ErrorDetails = ErrorDetails> extends Error implements BaseErrorData {
+    readonly details: TDetails;
+    readonly url: string | URL;
+    readonly retryStrategyOptions: ResolvedRetryStrategyOptions | undefined;
+    readonly retryAttempt: number | undefined;
+    constructor({ baseErrorData: { message, url, retryStrategyOptions, retryAttempt }, details }: {
+        readonly baseErrorData: BaseErrorData;
+        readonly details: TDetails;
+    });
+}
+/**
+ * Http adapter should throw this error when the request is aborted.
+ *
+ * The error is then handled by the HttpService and converted to a KontentSdkError with the reason "aborted".
+ */
+export declare class AdapterAbortError extends Error {
+    readonly details: unknown;
+    constructor({ message, error }: {
+        readonly message: string;
+        readonly error?: unknown;
+    });
+}
+/**
+ * Http adapter should throw this error when the response is not valid JSON or BLOB.
+ *
+ * The error is then handled by the HttpService and converted to a KontentSdkError with the reason "parseError".
+ */
+export declare class AdapterParseError extends Error {
+    readonly details: unknown;
+    constructor({ message, error }: {
+        readonly message: string;
+        readonly error?: unknown;
+    });
+}
+export type ErrorDetailsFor<TReason extends ErrorReason> = Extract<ErrorDetails, {
+    readonly reason: TReason;
+}>;
+type ErrorWithKontentResponse = {
+    readonly kontentErrorResponse: ErrorResponseData | undefined;
+} & Pick<AdapterResponse<AdapterPayload>, "responseHeaders" | "status" | "statusText">;
+type ErrorWithOriginalError = {
+    readonly originalError: unknown;
+};
+type ReasonData<TReason extends ErrorReason, TData> = {
     readonly reason: TReason;
-} & TDetails;
+} & TData;
 export {};

package/dist/models/error.models.js

@@ -1,2 +1,52 @@
-export {};
+import * as z from "zod/mini";
+import { toFriendlyKontentSdkErrorMessage } from "../utils/error.utils.js";
+export const validationErrorSchema = z.object({
+    message: z.string(),
+    path: z.optional(z.string()),
+    line: z.optional(z.number()),
+    position: z.optional(z.number()),
+});
+export const errorResponseDataSchema = z.object({
+    message: z.string(),
+    request_id: z.string(),
+    error_code: z.number(),
+    validation_errors: z.optional(z.array(validationErrorSchema)),
+});
+export class KontentSdkError extends Error {
+    details;
+    url;
+    retryStrategyOptions;
+    retryAttempt;
+    constructor({ baseErrorData: { message, url, retryStrategyOptions, retryAttempt }, details, }) {
+        super(toFriendlyKontentSdkErrorMessage(message, details));
+        this.url = url;
+        this.retryStrategyOptions = retryStrategyOptions;
+        this.retryAttempt = retryAttempt;
+        this.details = details;
+    }
+}
+/**
+ * Http adapter should throw this error when the request is aborted.
+ *
+ * The error is then handled by the HttpService and converted to a KontentSdkError with the reason "aborted".
+ */
+export class AdapterAbortError extends Error {
+    details;
+    constructor({ message, error }) {
+        super(message, { cause: error });
+        this.details = error;
+    }
+}
+/**
+ * Http adapter should throw this error when the response is not valid JSON or BLOB.
+ *
+ * The error is then handled by the HttpService and converted to a KontentSdkError with the reason "parseError".
+ */
+export class AdapterParseError extends Error {
+    details;
+    constructor({ message, error }) {
+        super(message, { cause: error });
+        this.details = error;
+    }
+}
 //# sourceMappingURL=error.models.js.map

package/dist/models/error.models.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.models.js","sourceRoot":"","sources":["../../lib/models/error.models.ts"],"names":[],"mappings":""}
+{"version":3,"file":"error.models.js","sourceRoot":"","sources":["../../lib/models/error.models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAE9B,OAAO,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAI3E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAChC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;CAC7D,CAAC,CAAC;AA+CH,MAAM,OAAO,eAA8D,SAAQ,KAAK;IAC9E,OAAO,CAAW;IAClB,GAAG,CAAe;IAClB,oBAAoB,CAA2C;IAC/D,YAAY,CAAqB;IAE1C,YAAY,EACX,aAAa,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,oBAAoB,EAAE,YAAY,EAAE,EACnE,OAAO,GAIP;QACA,KAAK,CAAC,gCAAgC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAE1D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACjD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;CACD;AAED;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAClC,OAAO,CAAU;IAC1B,YAAY,EAAE,OAAO,EAAE,KAAK,EAA0D;QACrF,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACtB,CAAC;CACD;AAED;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAClC,OAAO,CAAU;IAE1B,YAAY,EAAE,OAAO,EAAE,KAAK,EAA0D;QACrF,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACtB,CAAC;CACD"}

package/dist/models/json.models.d.ts

@@ -1,6 +1,15 @@
-import type { EmptyObject } from "./utility.models.js";
-export type JsonValue = string | number | null | boolean | JsonObject | JsonArray | EmptyObject;
-export interface JsonObject {
+import * as z from "zod/mini";
+export type JsonValue = undefined | string | number | null | boolean | JsonObject | JsonArray;
+export type JsonObject = {
     readonly [property: string]: JsonValue;
-}
+};
 export type JsonArray = readonly JsonValue[];
+/**
+ * Runtime validator for the core SDK `JsonValue` type.
+ *
+ * Matches:
+ * - string | number | boolean | null
+ * - readonly JsonValue[]
+ * - { readonly [property: string]: JsonValue }
+ */
+export declare const jsonValueSchema: z.ZodMiniType<JsonValue>;

package/dist/models/json.models.js

@@ -1,2 +1,11 @@
-export {};
+import * as z from "zod/mini";
+/**
+ * Runtime validator for the core SDK `JsonValue` type.
+ *
+ * Matches:
+ * - string | number | boolean | null
+ * - readonly JsonValue[]
+ * - { readonly [property: string]: JsonValue }
+ */
+export const jsonValueSchema = z.lazy(() => z.union([z.string(), z.number(), z.boolean(), z.null(), z.readonly(z.array(jsonValueSchema)), z.record(z.string(), jsonValueSchema)]));
 //# sourceMappingURL=json.models.js.map

package/dist/models/json.models.js.map

@@ -1 +1 @@
-{"version":3,"file":"json.models.js","sourceRoot":"","sources":["../../lib/models/json.models.ts"],"names":[],"mappings":""}
+{"version":3,"file":"json.models.js","sourceRoot":"","sources":["../../lib/models/json.models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAU9B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAA6B,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CACpE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC,CACrI,CAAC"}

package/dist/models/utility.types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Represents an empty object type.
+ */
+export type EmptyObject = Record<string, never>;
+/**
+ * Picks a string literal type from a union type.
+ */
+export type PickStringLiteral<T extends string, U extends T> = U;
+/**
+ * Adds intellisense for string union type, but also allows any string
+ */
+export type LiteralUnion<T extends string | undefined> = T | (string & NonNullable<unknown>);
+/**
+ * Adds intellisense for number union type, but also allows any number
+ */
+export type LiteralUnionNumber<T extends number | undefined> = T | (number & NonNullable<unknown>);

package/dist/models/utility.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=utility.types.js.map

package/dist/models/utility.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.types.js","sourceRoot":"","sources":["../../lib/models/utility.types.ts"],"names":[],"mappings":""}

package/dist/public_api.d.ts

@@ -1,13 +1,24 @@
+/** biome-ignore-all lint/performance/noBarrelFile: One barrel for exported API is fine */
 export { getDefaultHttpAdapter } from "./http/http.adapter.js";
-export type { AdapterRequestOptions, AdapterResponse, DefaultHttpServiceConfig, DownloadFileRequestOptions, ExecuteRequestOptions, HttpAdapter, HttpResponse, HttpService, HttpServiceStatus, UploadFileRequestOptions, } from "./http/http.models.js";
+export type { AdapterDownloadOptions, AdapterPayload, AdapterRequestBody, AdapterRequestOptions, AdapterResponse, DefaultHttpServiceOptions, DownloadFileRequestOptions, GetNextPageData, HttpAdapter, HttpRequestBody, HttpResponse, HttpResult, HttpService, HttpServiceRequestOptions, HttpStatusCode, PagingConfig, UploadFileRequestOptions, } from "./http/http.models.js";
 export { getDefaultHttpService } from "./http/http.service.js";
-export type { CommonHeaderNames, ContinuationHeaderName, Header, HttpMethod, RetryStrategyOptions, SDKInfo, } from "./models/core.models.js";
-export type { CoreSdkError, CoreSdkErrorDetails, ErrorReason, } from "./models/error.models.js";
-export type { JsonArray, JsonObject, JsonValue } from "./models/json.models.js";
-export type { EmptyObject, Override, Prettify } from "./models/utility.models.js";
-export type { PagingQuery, PagingQueryResult, Query, QueryResult, ResultOfSuccessfulQuery, SdkConfig, SdkResponse, SdkResponseMeta, SuccessfulHttpResponse, } from "./sdk/sdk-models.js";
-export { extractContinuationToken, getPagingQuery, getQuery } from "./sdk/sdk-queries.js";
-export { isKontent404Error } from "./utils/error.utils.js";
-export { getSdkIdHeader } from "./utils/header.utils.js";
-export { toRequiredRetryStrategyOptions } from "./utils/retry.utils.js";
-export { tryCatch, tryCatchAsync } from "./utils/try.utils.js";
+export type { ContinuationTokenHeaderName, Header, HttpMethod, KnownHeaderName, ResolvedRetryStrategyOptions, RetryStrategyOptions, SdkInfo, } from "./models/core.models.js";
+export { AdapterAbortError, AdapterParseError, type ErrorDetails, type ErrorDetailsFor, type ErrorReason, type ErrorResponseData, KontentSdkError, type ValidationError, } from "./models/error.models.js";
+export { type JsonArray, type JsonObject, type JsonValue, jsonValueSchema } from "./models/json.models.js";
+export type { EmptyObject, PickStringLiteral } from "./models/utility.types.js";
+export { createFetchQuery } from "./sdk/queries/fetch-sdk-query.js";
+export { createMutationQuery } from "./sdk/queries/mutation-sdk-query.js";
+export { createPagedFetchQuery } from "./sdk/queries/paged-fetch-sdk-query.js";
+export { codenameOf, kontentUuidSchema, nilUuid, strictCodenameSchema, } from "./sdk/sdk-config.js";
+export type { BaseUrl, FetchQuery, FetchQueryRequest, MutationQuery, MutationQueryRequest, PagedFetchQuery, PagingQueryResponse, Query, QueryResponse, QueryResponseMeta, SafePagingQueryResult, SafeQueryResult, SdkConfig, SuccessfulHttpResponse, } from "./sdk/sdk-models.js";
+export { isPagingQuery } from "./sdk/sdk-utils.js";
+export { transformFetchQuery } from "./sdk/transform/transform-fetch-query.js";
+export { transformMutationQuery } from "./sdk/transform/transform-mutation-query.js";
+export { transformPagedFetchQuery } from "./sdk/transform/transform-paged-fetch-query.js";
+export { isDefined } from "./utils/core.utils.js";
+export { isKontent404Error, isKontentSdkError } from "./utils/error.utils.js";
+export { createSdkIdHeader, extractContinuationToken } from "./utils/header.utils.js";
+export { resolveDefaultRetryStrategyOptions } from "./utils/retry.utils.js";
+export { resolveSchema, type SchemaInput } from "./utils/schema.utils.js";
+export { tryCatch, tryCatchAsync } from "./utils/try-catch.utils.js";
+export { getEndpointUrl } from "./utils/url.utils.js";

package/dist/public_api.js

@@ -1,9 +1,21 @@
-// biome-ignore lint/performance/noBarrelFile: One barrel for the public API is fine
+/** biome-ignore-all lint/performance/noBarrelFile: One barrel for exported API is fine */
 export { getDefaultHttpAdapter } from "./http/http.adapter.js";
 export { getDefaultHttpService } from "./http/http.service.js";
-export { extractContinuationToken, getPagingQuery, getQuery } from "./sdk/sdk-queries.js";
-export { isKontent404Error } from "./utils/error.utils.js";
-export { getSdkIdHeader } from "./utils/header.utils.js";
-export { toRequiredRetryStrategyOptions } from "./utils/retry.utils.js";
-export { tryCatch, tryCatchAsync } from "./utils/try.utils.js";
+export { AdapterAbortError, AdapterParseError, KontentSdkError, } from "./models/error.models.js";
+export { jsonValueSchema } from "./models/json.models.js";
+export { createFetchQuery } from "./sdk/queries/fetch-sdk-query.js";
+export { createMutationQuery } from "./sdk/queries/mutation-sdk-query.js";
+export { createPagedFetchQuery } from "./sdk/queries/paged-fetch-sdk-query.js";
+export { codenameOf, kontentUuidSchema, nilUuid, strictCodenameSchema, } from "./sdk/sdk-config.js";
+export { isPagingQuery } from "./sdk/sdk-utils.js";
+export { transformFetchQuery } from "./sdk/transform/transform-fetch-query.js";
+export { transformMutationQuery } from "./sdk/transform/transform-mutation-query.js";
+export { transformPagedFetchQuery } from "./sdk/transform/transform-paged-fetch-query.js";
+export { isDefined } from "./utils/core.utils.js";
+export { isKontent404Error, isKontentSdkError } from "./utils/error.utils.js";
+export { createSdkIdHeader, extractContinuationToken } from "./utils/header.utils.js";
+export { resolveDefaultRetryStrategyOptions } from "./utils/retry.utils.js";
+export { resolveSchema } from "./utils/schema.utils.js";
+export { tryCatch, tryCatchAsync } from "./utils/try-catch.utils.js";
+export { getEndpointUrl } from "./utils/url.utils.js";
 //# sourceMappingURL=public_api.js.map

package/dist/public_api.js.map

@@ -1 +1 @@
-{"version":3,"file":"public_api.js","sourceRoot":"","sources":["../lib/public_api.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAa/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AA2B/D,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"public_api.js","sourceRoot":"","sources":["../lib/public_api.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAoB/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAU/D,OAAO,EACN,iBAAiB,EACjB,iBAAiB,EAKjB,eAAe,GAEf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAmD,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE3G,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EACN,UAAU,EACV,iBAAiB,EACjB,OAAO,EACP,oBAAoB,GACpB,MAAM,qBAAqB,CAAC;AAiB7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,kCAAkC,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAoB,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/sdk/queries/fetch-sdk-query.d.ts

@@ -0,0 +1,4 @@
+import type { KontentSdkError } from "../../models/error.models.js";
+import type { JsonValue } from "../../models/json.models.js";
+import type { FetchQuery, FetchQueryRequest } from "../sdk-models.js";
+export declare function createFetchQuery<TPayload extends JsonValue, TError extends KontentSdkError, TMeta, TExtra>(data: FetchQueryRequest<TPayload, TError, TMeta, TExtra>): FetchQuery<TPayload, TError, TMeta, TExtra>;

package/dist/sdk/queries/fetch-sdk-query.js

@@ -0,0 +1,17 @@
+import { inspectQuery, resolveQuery } from "../resolve-query.js";
+export function createFetchQuery(data) {
+    const inputData = { ...data, method: "GET", body: null };
+    const fetchSafe = async () => await resolveQuery(inputData);
+    return {
+        inspect: () => inspectQuery(inputData),
+        fetchSafe,
+        fetch: async () => {
+            const { success, response, error } = await fetchSafe();
+            if (!success) {
+                throw error;
+            }
+            return response;
+        },
+    };
+}
+//# sourceMappingURL=fetch-sdk-query.js.map

package/dist/sdk/queries/fetch-sdk-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-sdk-query.js","sourceRoot":"","sources":["../../../lib/sdk/queries/fetch-sdk-query.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGjE,MAAM,UAAU,gBAAgB,CAC/B,IAAwD;IAExD,MAAM,SAAS,GAA0D,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAChH,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE,CAAC,MAAM,YAAY,CAAC,SAAS,CAAC,CAAC;IAE5D,OAAO;QACN,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC;QACtC,SAAS;QACT,KAAK,EAAE,KAAK,IAAI,EAAE;YACjB,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,SAAS,EAAE,CAAC;YACvD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACd,MAAM,KAAK,CAAC;YACb,CAAC;YACD,OAAO,QAAQ,CAAC;QACjB,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/sdk/queries/mutation-sdk-query.d.ts

@@ -0,0 +1,5 @@
+import type { HttpRequestBody } from "../../http/http.models.js";
+import type { KontentSdkError } from "../../models/error.models.js";
+import type { JsonValue } from "../../models/json.models.js";
+import type { MutationQuery, MutationQueryRequest } from "../sdk-models.js";
+export declare function createMutationQuery<TPayload extends JsonValue, TBody extends HttpRequestBody, TError extends KontentSdkError, TMeta, TExtra>(data: MutationQueryRequest<TPayload, TBody, TError, TMeta, TExtra>): MutationQuery<TPayload, TError, TMeta, TExtra>;

package/dist/sdk/queries/mutation-sdk-query.js

@@ -0,0 +1,16 @@
+import { inspectQuery, resolveQuery } from "../resolve-query.js";
+export function createMutationQuery(data) {
+    const executeSafe = async () => await resolveQuery(data);
+    return {
+        inspect: () => inspectQuery(data),
+        executeSafe,
+        execute: async () => {
+            const { success, response, error } = await executeSafe();
+            if (!success) {
+                throw error;
+            }
+            return response;
+        },
+    };
+}
+//# sourceMappingURL=mutation-sdk-query.js.map

package/dist/sdk/queries/mutation-sdk-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-sdk-query.js","sourceRoot":"","sources":["../../../lib/sdk/queries/mutation-sdk-query.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGjE,MAAM,UAAU,mBAAmB,CAMjC,IAAkE;IACnE,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAEzD,OAAO;QACN,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;QACjC,WAAW;QACX,OAAO,EAAE,KAAK,IAAI,EAAE;YACnB,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;YACzD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACd,MAAM,KAAK,CAAC;YACb,CAAC;YACD,OAAO,QAAQ,CAAC;QACjB,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/sdk/queries/paged-fetch-sdk-query.d.ts

@@ -0,0 +1,8 @@
+import type { GetNextPageData } from "../../http/http.models.js";
+import type { KontentSdkError } from "../../models/error.models.js";
+import type { JsonValue } from "../../models/json.models.js";
+import type { FetchQueryRequest, PagedFetchQuery, QueryResponse } from "../sdk-models.js";
+export declare function createPagedFetchQuery<TPayload extends JsonValue, TError extends KontentSdkError, TMeta, TExtra, TPagingExtra>(data: FetchQueryRequest<TPayload, TError, TMeta, TExtra> & {
+    readonly getNextPageData: GetNextPageData<TPayload, TMeta, TExtra>;
+    readonly mapPagingExtraResponseProps: (response: readonly QueryResponse<TPayload, TMeta, TExtra>[]) => TPagingExtra;
+}): PagedFetchQuery<TPayload, TError, TMeta, TExtra, TPagingExtra>;

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

@@ -0,0 +1,101 @@
+import { match, P } from "ts-pattern";
+import { createFetchQuery } from "./fetch-sdk-query.js";
+export function createPagedFetchQuery(data) {
+    const getPagingData = (config) => {
+        return {
+            ...data,
+            method: "GET",
+            pageIndex: 0,
+            pagingConfig: config ?? {},
+            body: null,
+        };
+    };
+    const fetchQuery = createFetchQuery(data);
+    return {
+        inspect: () => fetchQuery.inspect(),
+        fetchPage: async () => await fetchQuery.fetch(),
+        fetchPageSafe: async () => await fetchQuery.fetchSafe(),
+        fetchAllPages: async (config) => {
+            const { success, error, responses } = await fetchAllPages(getPagingData(config));
+            if (!success) {
+                throw error;
+            }
+            return {
+                ...data.mapPagingExtraResponseProps(responses),
+                responses,
+            };
+        },
+        fetchAllPagesSafe: async (config) => await fetchAllPages(getPagingData(config)),
+        pagesSafe: (config) => createPagingQueryIterator(getPagingData(config)),
+        pages: async function* (config) {
+            const iterator = createPagingQueryIterator(getPagingData(config));
+            for await (const result of iterator) {
+                if (!result.success) {
+                    throw result.error;
+                }
+                yield result.response;
+            }
+        },
+    };
+}
+async function* createPagingQueryIterator(data) {
+    let nextPageState = { hasNextPage: true, pageSource: "firstRequest" };
+    let pageIndex = 0;
+    while (isNextPageAvailable(nextPageState)) {
+        const urlToUse = nextPageState?.nextPageUrl ?? data.url;
+        const fetchResult = await createFetchQuery({
+            ...data,
+            url: urlToUse,
+            continuationToken: nextPageState.continuationToken,
+        }).fetchSafe();
+        if (!fetchResult.success) {
+            yield { success: false, error: fetchResult.error };
+            return;
+        }
+        yield fetchResult;
+        pageIndex++;
+        nextPageState = resolveNextPageState({
+            getNextPageData: data.getNextPageData,
+            pagingConfig: data.pagingConfig,
+            pageIndex: pageIndex,
+            response: fetchResult.response,
+        });
+    }
+}
+function resolveNextPageState({ pagingConfig, getNextPageData, pageIndex, response, }) {
+    const { maxPagesCount } = pagingConfig;
+    if (maxPagesCount && maxPagesCount > 0 && maxPagesCount === pageIndex) {
+        return { hasNextPage: false };
+    }
+    return match(getNextPageData(response))
+        .returnType()
+        .with({ continuationToken: P.string.minLength(1) }, (m) => ({
+        hasNextPage: true,
+        pageSource: "continuationToken",
+        continuationToken: m.continuationToken,
+    }))
+        .with({ nextPageUrl: P.string.minLength(1) }, (m) => ({
+        hasNextPage: true,
+        pageSource: "nextPageUrl",
+        nextPageUrl: m.nextPageUrl,
+    }))
+        .otherwise(() => ({ hasNextPage: false }));
+}
+async function fetchAllPages(data) {
+    const responses = [];
+    for await (const result of createPagingQueryIterator(data)) {
+        if (!result.success) {
+            return { success: false, error: result.error };
+        }
+        responses.push(result.response);
+    }
+    return {
+        success: true,
+        responses,
+        ...data.mapPagingExtraResponseProps(responses),
+    };
+}
+function isNextPageAvailable(nextPageState) {
+    return nextPageState.hasNextPage;
+}
+//# sourceMappingURL=paged-fetch-sdk-query.js.map

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

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

package/dist/sdk/resolve-query.d.ts

@@ -0,0 +1,12 @@
+import type { HttpRequestBody } from "../http/http.models.js";
+import type { ErrorDetailsFor, KontentSdkError } from "../models/error.models.js";
+import type { JsonValue } from "../models/json.models.js";
+import { type TryCatchResult } from "../utils/try-catch.utils.js";
+import type { BaseUrl, QueryInputData, QueryInspection, QueryResponse, SafeQueryResult } from "./sdk-models.js";
+export declare function inspectQuery<TError>(data: Pick<QueryInputData<JsonValue, HttpRequestBody, unknown, unknown, TError>, "url" | "config" | "requestHeaders" | "continuationToken" | "authorizationApiKey" | "sdkInfo" | "body" | "method" | "mapError">): TryCatchResult<QueryInspection, TError>;
+export declare function resolveQuery<TPayload extends JsonValue, TBody extends HttpRequestBody, TMeta, TExtra, TError>(data: QueryInputData<TPayload, TBody, TMeta, TExtra, TError>): Promise<SafeQueryResult<QueryResponse<TPayload, TMeta, TExtra>, TError>>;
+export declare function resolveUrl<TError>({ url, baseUrl, mapError }: {
+    readonly url: string | URL;
+    readonly baseUrl: BaseUrl | undefined;
+    readonly mapError: (error: KontentSdkError<ErrorDetailsFor<"invalidUrl">>) => TError;
+}): TryCatchResult<URL, TError>;