@kontent-ai/core-sdk 12.0.0-preview.13 → 12.0.0-preview.15

package/dist/devkit/environment.utils.d.ts

@@ -0,0 +1,2 @@
+export declare function getEnvironmentRequiredValue(variableName: string): string;
+export declare function getEnvironmentOptionalValue(variableName: string): string | undefined;

package/dist/devkit/environment.utils.js

@@ -0,0 +1,12 @@
+import chalk from "chalk";
+export function getEnvironmentRequiredValue(variableName) {
+    const value = getEnvironmentOptionalValue(variableName);
+    if (!value) {
+        throw new Error(`Missing environment variable '${chalk.red(variableName)}'`);
+    }
+    return value;
+}
+export function getEnvironmentOptionalValue(variableName) {
+    return process.env[variableName];
+}
+//# sourceMappingURL=environment.utils.js.map

package/dist/devkit/environment.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.utils.js","sourceRoot":"","sources":["../../lib/devkit/environment.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,2BAA2B,CAAC,YAAoB;IAC/D,MAAM,KAAK,GAAG,2BAA2B,CAAC,YAAY,CAAC,CAAC;IAExD,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,YAAoB;IAC/D,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAClC,CAAC"}

package/dist/devkit_api.d.ts

@@ -1,3 +1,4 @@
 /** biome-ignore-all lint/performance/noBarrelFile: One barrel for exported API is fine */
+export { getEnvironmentOptionalValue, getEnvironmentRequiredValue } from "./devkit/environment.utils.js";
 export { deleteFolderRecursive } from "./devkit/script.utils.js";
 export { replaceSdkVersionPlaceholder } from "./utils/sdk-version.utils.js";

package/dist/devkit_api.js

@@ -1,4 +1,5 @@
 /** biome-ignore-all lint/performance/noBarrelFile: One barrel for exported API is fine */
+export { getEnvironmentOptionalValue, getEnvironmentRequiredValue } from "./devkit/environment.utils.js";
 export { deleteFolderRecursive } from "./devkit/script.utils.js";
 export { replaceSdkVersionPlaceholder } from "./utils/sdk-version.utils.js";
 //# sourceMappingURL=devkit_api.js.map

package/dist/devkit_api.js.map

@@ -1 +1 @@
-{"version":3,"file":"devkit_api.js","sourceRoot":"","sources":["../lib/devkit_api.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"devkit_api.js","sourceRoot":"","sources":["../lib/devkit_api.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACzG,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC"}

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

@@ -1,15 +1,3 @@
-/**
- * Improves the type readability by flattening the type.
- */
-export type Prettify<T> = {
-    [K in keyof T]: T[K];
-} & {};
-/**
- * Override selected properties of a type. Uses Omit to remove the properties and then adds the new properties.
- */
-export type Override<Type, NewType extends {
-    [key in keyof Type]?: NewType[key];
-}> = Omit<Type, keyof NewType> & NewType;
 /**
  * Represents an empty object type.
  */

package/dist/public_api.d.ts

@@ -5,11 +5,14 @@ export { getDefaultHttpService } from "./http/http.service.js";
 export type { CommonHeaderNames, ContinuationHeaderName, ErrorResponseData, Header, HttpMethod, RetryStrategyOptions, SDKInfo, ValidationError, } from "./models/core.models.js";
 export { type ErrorReason, type ErrorReasonData, KontentSdkError } 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 { EmptyObject } from "./models/utility.models.js";
 export { createPagingQuery } from "./sdk/paging-sdk-query.js";
-export type { PagingQuery, PagingQueryResult, Query, QueryResponse, QueryResponseMeta, QueryResult, SdkConfig, SuccessfulHttpResponse, } from "./sdk/sdk-models.js";
+export { kontentUuidSchema, nilUuid, type PagingQuery, type PagingQueryResult, type Query, type QueryResponse, type QueryResponseMeta, type QueryResult, type SdkConfig, type SuccessfulHttpResponse, } from "./sdk/sdk-models.js";
 export { createQuery, extractContinuationToken } from "./sdk/sdk-query.js";
+export { isPagingQuery } from "./sdk/sdk-utils.js";
 export { isKontent404Error, isKontentSdkError } 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 { getCodenameSchema } from "./utils/type.utils.js";
+export { getEndpointUrl } from "./utils/url.utils.js";

package/dist/public_api.js

@@ -3,9 +3,13 @@ export { getDefaultHttpAdapter } from "./http/http.adapter.js";
 export { getDefaultHttpService } from "./http/http.service.js";
 export { KontentSdkError } from "./models/error.models.js";
 export { createPagingQuery } from "./sdk/paging-sdk-query.js";
+export { kontentUuidSchema, nilUuid, } from "./sdk/sdk-models.js";
 export { createQuery, extractContinuationToken } from "./sdk/sdk-query.js";
+export { isPagingQuery } from "./sdk/sdk-utils.js";
 export { isKontent404Error, isKontentSdkError } 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 { getCodenameSchema } from "./utils/type.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,0FAA0F;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAe/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAW/D,OAAO,EAA0C,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAW9D,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,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;AAe/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAW/D,OAAO,EAA0C,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EACN,iBAAiB,EACjB,OAAO,GASP,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,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;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -2,6 +2,7 @@
  * Shared query models/types intended to be reused across SDKs (e.g. Sync, Delivery, Management)
  * to keep common code and behavior consistent.
  */
+import z from "zod";
 import type { AdapterResponse, HttpResponse, HttpService, PaginationConfig, RequestBody, ResponseData } from "../http/http.models.js";
 import type { KontentSdkError } from "../models/error.models.js";
 export type QueryResponseMeta<TMeta = unknown> = Pick<AdapterResponse, "status" | "responseHeaders" | "url"> & {
@@ -40,6 +41,7 @@ export type SdkConfig = {
     };
 };
 export type Query<TResponsePayload, TMeta> = {
+    schema: z.ZodType<TResponsePayload>;
     toUrl(): string;
     toPromise(): Promise<QueryResult<QueryResponse<TResponsePayload, TMeta>>>;
 };
@@ -83,6 +85,8 @@ export type PagingQueryResult<TResponsePayload> = (Success & {
     readonly responses?: never;
     readonly lastContinuationToken?: never;
 });
+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">]>;
 type Success = {
     readonly success: true;
     readonly error?: never;

package/dist/sdk/sdk-models.js

@@ -2,5 +2,7 @@
  * Shared query models/types intended to be reused across SDKs (e.g. Sync, Delivery, Management)
  * to keep common code and behavior consistent.
  */
-export {};
+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-models.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"sdk-models.js","sourceRoot":"","sources":["../../lib/sdk/sdk-models.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
+{"version":3,"file":"sdk-models.js","sourceRoot":"","sources":["../../lib/sdk/sdk-models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,CAAC,MAAM,KAAK,CAAC;AA2FpB,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-query.d.ts

@@ -25,7 +25,7 @@ export type ResolveQueryData<TResponsePayload extends JsonValue, TRequestBody ex
     readonly sdkInfo: SDKInfo;
     readonly authorizationApiKey: string | undefined;
 } & MetadataMapperConfig<TResponsePayload, TRequestBody, TMeta>;
-export declare function createQuery<TResponsePayload extends JsonValue, TRequestBody extends RequestBody, TMeta>(data: Omit<ResolveQueryData<TResponsePayload, TRequestBody, TMeta>, "continuationToken" | "nextPageState" | "pageIndex">): Pick<Query<TResponsePayload, TMeta>, "toPromise">;
+export declare function createQuery<TResponsePayload extends JsonValue, TRequestBody extends RequestBody, TMeta>(data: Omit<ResolveQueryData<TResponsePayload, TRequestBody, TMeta>, "continuationToken" | "nextPageState" | "pageIndex">): Pick<Query<TResponsePayload, TMeta>, "toPromise" | "schema">;
 export declare function extractContinuationToken(responseHeaders: readonly Header[]): string | undefined;
 export declare function resolveQueryAsync<TResponsePayload extends JsonValue, TRequestBody extends RequestBody, TMeta>({ config, request, mapMetadata, zodSchema, sdkInfo, authorizationApiKey, nextPageState, }: ResolveQueryData<TResponsePayload, TRequestBody, TMeta>): QueryPromiseResult<TResponsePayload, TMeta>;
 export {};

package/dist/sdk/sdk-query.js

@@ -7,6 +7,7 @@ import { createSdkError } from "../utils/error.utils.js";
 import { getSdkIdHeader } from "../utils/header.utils.js";
 export function createQuery(data) {
     return {
+        schema: data.zodSchema,
         toPromise: async () => {
             return await resolveQueryAsync({
                 ...data,

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

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

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

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

package/dist/sdk/sdk-utils.js

@@ -0,0 +1,4 @@
+export function isPagingQuery(query) {
+    return "toPromise" in query && "toAllPromise" in query && "pages" 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,CAAkB,KAA8C;IAC5F,OAAO,WAAW,IAAI,KAAK,IAAI,cAAc,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,CAAC;AAC5E,CAAC"}

package/dist/sdk-info.js

@@ -1,6 +1,6 @@
 export const sdkInfo = {
     host: "npmjs.com",
-    version: "12.0.0-preview.13",
+    version: "12.0.0-preview.15",
     name: "@kontent-ai/core-sdk",
 };
 //# sourceMappingURL=sdk-info.js.map

package/dist/utils/type.utils.d.ts

@@ -0,0 +1,2 @@
+import { z } from "zod";
+export declare function getCodenameSchema<const TCodenames extends readonly string[]>(codenames?: TCodenames): z.ZodType<TCodenames[number]>;

package/dist/utils/type.utils.js

@@ -0,0 +1,5 @@
+import { z } from "zod";
+export function getCodenameSchema(codenames) {
+    return codenames && codenames.length > 0 ? z.enum(codenames) : z.string();
+}
+//# sourceMappingURL=type.utils.js.map

package/dist/utils/type.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.utils.js","sourceRoot":"","sources":["../../lib/utils/type.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,iBAAiB,CAA6C,SAAsB;IACnG,OAAO,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AAC3E,CAAC"}

package/dist/utils/url.utils.d.ts

@@ -0,0 +1,5 @@
+export declare function getEndpointUrl({ environmentId, path, baseUrl, }: {
+    readonly environmentId: string;
+    readonly path: string;
+    readonly baseUrl: string;
+}): string;

package/dist/utils/url.utils.js

@@ -0,0 +1,10 @@
+export function getEndpointUrl({ environmentId, path, baseUrl, }) {
+    return `${removeTrailingSlashes(baseUrl)}${removeDuplicateSlashes(`/${environmentId}/${path}`)}`;
+}
+function removeDuplicateSlashes(path) {
+    return path.replace(/\/+/g, "/");
+}
+function removeTrailingSlashes(path) {
+    return path.replace(/\/+$/, "");
+}
+//# sourceMappingURL=url.utils.js.map

package/dist/utils/url.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.utils.js","sourceRoot":"","sources":["../../lib/utils/url.utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,EAC9B,aAAa,EACb,IAAI,EACJ,OAAO,GAKP;IACA,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,GAAG,sBAAsB,CAAC,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;AAClG,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC"}

package/lib/devkit/environment.utils.ts

@@ -0,0 +1,15 @@
+import chalk from "chalk";
+
+export function getEnvironmentRequiredValue(variableName: string): string {
+	const value = getEnvironmentOptionalValue(variableName);
+
+	if (!value) {
+		throw new Error(`Missing environment variable '${chalk.red(variableName)}'`);
+	}
+
+	return value;
+}
+
+export function getEnvironmentOptionalValue(variableName: string): string | undefined {
+	return process.env[variableName];
+}

package/lib/devkit_api.ts

@@ -1,3 +1,5 @@
 /** biome-ignore-all lint/performance/noBarrelFile: One barrel for exported API is fine */
+
+export { getEnvironmentOptionalValue, getEnvironmentRequiredValue } from "./devkit/environment.utils.js";
 export { deleteFolderRecursive } from "./devkit/script.utils.js";
 export { replaceSdkVersionPlaceholder } from "./utils/sdk-version.utils.js";

package/lib/models/utility.models.ts

@@ -1,15 +1,3 @@
-/**
- * Improves the type readability by flattening the type.
- */
-export type Prettify<T> = {
-	[K in keyof T]: T[K];
-} & {};
-
-/**
- * Override selected properties of a type. Uses Omit to remove the properties and then adds the new properties.
- */
-export type Override<Type, NewType extends { [key in keyof Type]?: NewType[key] }> = Omit<Type, keyof NewType> & NewType;
-
 /**
  * Represents an empty object type.
  */

package/lib/public_api.ts

@@ -27,20 +27,25 @@ export type {
 } from "./models/core.models.js";
 export { type ErrorReason, type ErrorReasonData, KontentSdkError } 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 { EmptyObject } from "./models/utility.models.js";
 export { createPagingQuery } from "./sdk/paging-sdk-query.js";
-export type {
-	PagingQuery,
-	PagingQueryResult,
-	Query,
-	QueryResponse,
-	QueryResponseMeta,
-	QueryResult,
-	SdkConfig,
-	SuccessfulHttpResponse,
+export {
+	kontentUuidSchema,
+	nilUuid,
+	type PagingQuery,
+	type PagingQueryResult,
+	type Query,
+	type QueryResponse,
+	type QueryResponseMeta,
+	type QueryResult,
+	type SdkConfig,
+	type SuccessfulHttpResponse,
 } from "./sdk/sdk-models.js";
 export { createQuery, extractContinuationToken } from "./sdk/sdk-query.js";
+export { isPagingQuery } from "./sdk/sdk-utils.js";
 export { isKontent404Error, isKontentSdkError } 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 { getCodenameSchema } from "./utils/type.utils.js";
+export { getEndpointUrl } from "./utils/url.utils.js";

package/lib/sdk/sdk-models.ts

@@ -3,6 +3,7 @@
  * to keep common code and behavior consistent.
  */
 
+import z from "zod";
 import type { AdapterResponse, HttpResponse, HttpService, PaginationConfig, RequestBody, ResponseData } from "../http/http.models.js";
 import type { KontentSdkError } from "../models/error.models.js";
 
@@ -47,6 +48,7 @@ export type SdkConfig = {
 };
 
 export type Query<TResponsePayload, TMeta> = {
+	schema: z.ZodType<TResponsePayload>;
 	toUrl(): string;
 	toPromise(): Promise<QueryResult<QueryResponse<TResponsePayload, TMeta>>>;
 };
@@ -92,6 +94,10 @@ export type PagingQueryResult<TResponsePayload> =
 	| (Success & { readonly responses: TResponsePayload[]; readonly lastContinuationToken: string | undefined })
 	| (Failure & { readonly responses?: never; readonly lastContinuationToken?: never });
 
+export const nilUuid = "00000000-0000-0000-0000-000000000000";
+
+export const kontentUuidSchema = z.union([z.uuid({ version: "v4" }), z.literal(nilUuid)]);
+
 type Success = {
 	readonly success: true;
 	readonly error?: never;

package/lib/sdk/sdk-query.ts

@@ -39,8 +39,9 @@ export type ResolveQueryData<TResponsePayload extends JsonValue, TRequestBody ex
 
 export function createQuery<TResponsePayload extends JsonValue, TRequestBody extends RequestBody, TMeta>(
 	data: Omit<ResolveQueryData<TResponsePayload, TRequestBody, TMeta>, "continuationToken" | "nextPageState" | "pageIndex">,
-): Pick<Query<TResponsePayload, TMeta>, "toPromise"> {
+): Pick<Query<TResponsePayload, TMeta>, "toPromise" | "schema"> {
 	return {
+		schema: data.zodSchema,
 		toPromise: async () => {
 			return await resolveQueryAsync<TResponsePayload, TRequestBody, TMeta>({
 				...data,

package/lib/sdk/sdk-utils.ts

@@ -0,0 +1,5 @@
+import type { PagingQuery, Query } from "./sdk-models.js";
+
+export function isPagingQuery<T, TBody = null>(query: Query<T, TBody> | PagingQuery<T, TBody>): query is PagingQuery<T, TBody> {
+	return "toPromise" in query && "toAllPromise" in query && "pages" in query;
+}

package/lib/utils/type.utils.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+
+export function getCodenameSchema<const TCodenames extends readonly string[]>(codenames?: TCodenames): z.ZodType<TCodenames[number]> {
+	return codenames && codenames.length > 0 ? z.enum(codenames) : z.string();
+}

package/lib/utils/url.utils.ts

@@ -0,0 +1,19 @@
+export function getEndpointUrl({
+	environmentId,
+	path,
+	baseUrl,
+}: {
+	readonly environmentId: string;
+	readonly path: string;
+	readonly baseUrl: string;
+}): string {
+	return `${removeTrailingSlashes(baseUrl)}${removeDuplicateSlashes(`/${environmentId}/${path}`)}`;
+}
+
+function removeDuplicateSlashes(path: string): string {
+	return path.replace(/\/+/g, "/");
+}
+
+function removeTrailingSlashes(path: string): string {
+	return path.replace(/\/+$/, "");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kontent-ai/core-sdk",
-	"version": "12.0.0-preview.13",
+	"version": "12.0.0-preview.15",
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/kontent-ai/core-sdk-js"