@skedulo/pulse-solution-services 0.0.6 → 0.0.8

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 // Generated by dts-bundle-generator v9.5.1
 
+import { z } from 'zod';
+
 /**
  * Interface representing the structure of metadata for an object.
  */
@@ -50,40 +52,49 @@ export interface PicklistValue {
 	active: boolean;
 	defaultValue: boolean;
 }
-/**
- * Interface defining the base configuration for API clients.
- */
 export interface BaseConfig {
 	apiServer: string;
 	apiToken: string;
 	internalApiToken?: string;
 }
+declare class ExecutionOptions {
+	/**
+	 * Identifies the origin of the request (e.g., the system, application, or project that initiated the call).
+	 * Helps in tracking and debugging requests across different systems.
+	 */
+	requestSource?: string;
+	/**
+	 * Identifies the client service or Lambda function making the request.
+	 * Useful for debugging and log filtering to trace which service handled the request.
+	 */
+	userAgent?: string;
+	/**
+	 * Creates an instance of ExecutionOptions.
+	 * Allows initializing with partial values for flexibility.
+	 *
+	 * @param initialValues - Partial execution options for initialization.
+	 */
+	constructor(initialValues?: Partial<ExecutionOptions>);
+}
+export interface RequestParams {
+	method?: string;
+	endpoint: string;
+	body?: object;
+	headers?: Record<string, string>;
+	queryParams?: Record<string, string>;
+}
 /**
  * Base client for making API requests with standardized error handling.
  * Provides methods for setting up headers and performing API requests using fetch.
  */
 export declare class BaseClient {
 	protected config: BaseConfig;
+	protected executionOptions: Partial<ExecutionOptions>;
 	/**
 	 * Creates an instance of BaseClient.
 	 * @param {BaseConfig} config - The configuration object containing API server and token.
 	 */
-	constructor(config: BaseConfig);
-	/**
-	 * Constructs the headers for API requests.
-	 * @returns {Record<string, string>} - The headers including authorization and content type.
-	 */
-	protected getHeaders(): {
-		Authorization: string;
-		"Content-Type": string;
-	};
-	/**
-	 * Builds a URL with query parameters.
-	 * @param {string} endpoint - The API endpoint.
-	 * @param {Record<string, string>} [queryParams] - Optional query parameters.
-	 * @returns {string} - The full URL with query parameters.
-	 */
-	private buildUrl;
+	constructor(config: BaseConfig, executionOptions?: Partial<ExecutionOptions>);
 	/**
 	 * Performs an API request with standardized error handling using fetch.
 	 * @template T
@@ -96,13 +107,19 @@ export declare class BaseClient {
 	 * @returns {Promise<T>} - The parsed response data.
 	 * @throws {Error} - If the request fails or the response is not OK.
 	 */
-	protected performRequest<T = any>({ method, endpoint, headers, body, queryParams, }: {
-		method?: string;
-		endpoint: string;
-		body?: object;
-		headers?: Record<string, string>;
-		queryParams?: Record<string, string>;
-	}): Promise<T>;
+	protected performRequest<T = any>({ method, endpoint, headers, body, queryParams }: RequestParams, executionOptions?: Partial<ExecutionOptions>): Promise<T>;
+	/**
+	 * Constructs the headers for API requests.
+	 * @returns {Record<string, string>} - The headers including authorization and content type.
+	 */
+	protected getHeaders(executionOptions: Partial<ExecutionOptions>): Record<string, string>;
+	/**
+	 * Builds a URL with query parameters.
+	 * @param {string} endpoint - The API endpoint.
+	 * @param {Record<string, string>} [queryParams] - Optional query parameters.
+	 * @returns {string} - The full URL with query parameters.
+	 */
+	private buildUrl;
 	/**
 	 * Handles exceptions encountered during API requests.
 	 * @param {any} error - The error to handle.
@@ -243,67 +260,6 @@ export declare class ConfigVarClient extends BaseClient {
 	 */
 	delete(key: string): Promise<string>;
 }
-export interface HasId {
-	UID?: string;
-	[key: string]: any;
-}
-export interface GraphQlResponse<T = any> {
-	data: T;
-	errors?: object[];
-}
-export interface FetchRecordsQueryParams {
-	objectName: string;
-	first?: number;
-	offset?: number;
-	orderBy?: string;
-	filter?: string;
-	after?: string;
-	fields?: string;
-}
-export interface QueryResult {
-	records: HasId[];
-	totalCount: number;
-	pageInfo: any;
-	endCursor: string;
-	endOffset: number;
-}
-export interface MutationResult {
-	data: {
-		schema: {
-			[alias: string]: string;
-		};
-	};
-}
-/**
- * A client for executing GraphQL queries and mutations.
- * Extends the BaseClient to interact with the GraphQL API.
- */
-export declare class GraphQLClient extends BaseClient {
-	/**
-	 * Executes a GraphQL query or mutation.
-	 * @param {string} graphqlQuery - The GraphQL query or mutation string.
-	 * @returns {Promise<GraphQlResponse>} - The response from the GraphQL API.
-	 * @throws {Error} - If the request fails or if there are errors in the response.
-	 */
-	execute(graphqlQuery: string): Promise<GraphQlResponse>;
-}
-/**
- * OrgPreferencesClient class to handle API requests related to organization preferences.
- * Extends BaseClient to perform API operations.
- */
-export declare class OrgPreferenceClient extends BaseClient {
-	/**
-	 * Fetches the organization preferences configuration.
-	 * @returns {Promise<Record<string, any>>} - A promise resolving to the sorted organization preferences.
-	 */
-	get(): Promise<Record<string, any>>;
-	/**
-	 * Deploys the organization preferences configuration.
-	 * @param {Record<string, any>} newConfig - The new configuration to be deployed.
-	 * @returns {Promise<Record<string, any>>} - A promise resolving when the configuration is successfully deployed.
-	 */
-	deploy(newConfig: Record<string, any>): Promise<Record<string, any>>;
-}
 export declare enum ArtifactType {
 	CUSTOM_OBJECT = "custom-object",
 	CUSTOM_FIELD = "custom-field",
@@ -335,6 +291,12 @@ export declare enum ConfigVariableStatus {
 	INACTIVE = "inactive",
 	EXPIRED = "expired"
 }
+export declare enum GraphqlOperations {
+	INSERT = "insert",
+	UPDATE = "update",
+	DELETE = "delete",
+	UPSERT = "upsert"
+}
 export declare enum HttpMethod {
 	GET = "GET",
 	POST = "POST",
@@ -396,27 +358,260 @@ export declare const TENANT_ENDPOINTS: {
 		readonly SEND_SMS: "notifications/sms";
 		readonly SMS_CONFIRMATION_REQUEST: "notifications/sms/confirmation_request";
 	};
+	readonly GEOSERVICES: {
+		readonly DISTANCE_MATRIX: "geoservices/distanceMatrix";
+		readonly DIRECTIONS: "geoservices/directions";
+		readonly GEOCODE: "geoservices/geocode";
+		readonly AUTOCOMPLETE: "geoservices/autocomplete";
+		readonly PLACE: "geoservices/place";
+		readonly TIMEZONE: "geoservices/timezone";
+	};
+	readonly AVAILABILITY: {
+		readonly SIMPLE: "availability/simple";
+	};
 };
-export declare enum TenantObject {
-	Accounts = "Accounts",
-	Jobs = "Jobs",
-	JobAllocations = "JobAllocations",
-	Regions = "Regions",
-	Contacts = "Contacts",
-	Locations = "Locations",
-	Resources = "Resources",
-	Tags = "Tags",
-	JobTags = "JobTags",
-	ResourceTags = "ResourceTags",
-	Activities = "Activities",
-	Availabilities = "Availabilities",
-	Holidays = "Holidays",
-	AvailabilityPatterns = "AvailabilityPatterns",
-	AvailabilityPatternResources = "AvailabilityPatternResources",
-	AccountResourceScores = "AccountResourceScores",
-	LocationResourceScores = "LocationResourceScores",
-	Products = "Products",
-	JobProducts = "JobProducts"
+export interface HasId {
+	UID?: string;
+	[key: string]: any;
+}
+export interface GraphQlResponse<T = any> {
+	data: T;
+	errors?: object[];
+}
+export interface GraphqlParams {
+	objectName: string;
+	operationName: string;
+}
+export interface GraphqlMurationParams extends GraphqlParams {
+	records: HasId[];
+	operation: GraphqlOperations;
+	bulkOperation?: boolean;
+}
+export interface GraphqlQueryParams extends GraphqlParams {
+	first?: number;
+	offset?: number;
+	orderBy?: string;
+	filter?: string;
+	after?: string;
+	fields?: string;
+	readOnly?: boolean;
+}
+export interface QueryResult {
+	records: HasId[];
+	totalCount: number;
+	pageInfo: any;
+	endCursor: string;
+	endOffset: number;
+}
+export interface MutationResult {
+	data: {
+		schema: {
+			[alias: string]: string;
+		};
+	};
+}
+/**
+ * A client for executing GraphQL queries and mutations.
+ * Extends the BaseClient to interact with the GraphQL API.
+ */
+export declare class GraphQLClient extends BaseClient {
+	/**
+	 * Executes a GraphQL query or mutation.
+	 * @param {string} graphqlQuery - The GraphQL query or mutation string.
+	 * @param {Record<string, string>} headers - Additional headers to include in the request.
+	 * @returns {Promise<GraphQlResponse>} - The response from the GraphQL API.
+	 * @throws {Error} - If the request fails or if there are errors in the response.
+	 */
+	execute(graphqlQuery: string, headers?: Record<string, string>): Promise<GraphQlResponse>;
+}
+/**
+ * OrgPreferencesClient class to handle API requests related to organization preferences.
+ * Extends BaseClient to perform API operations.
+ */
+export declare class OrgPreferenceClient extends BaseClient {
+	/**
+	 * Fetches the organization preferences configuration.
+	 * @returns {Promise<Record<string, any>>} - A promise resolving to the sorted organization preferences.
+	 */
+	get(): Promise<Record<string, any>>;
+	/**
+	 * Deploys the organization preferences configuration.
+	 * @param {Record<string, any>} newConfig - The new configuration to be deployed.
+	 * @returns {Promise<Record<string, any>>} - A promise resolving when the configuration is successfully deployed.
+	 */
+	deploy(newConfig: Record<string, any>): Promise<Record<string, any>>;
+}
+export interface LatLng {
+	lat: number;
+	lng: number;
+}
+export interface DistanceMatrixRequest {
+	origins: LatLng[];
+	destinations: LatLng[];
+	avoid?: ("ferry" | "highway" | "toll")[];
+	departureTime?: string;
+}
+export interface DistanceMatrixResponse {
+	matrix: DistanceMatrixEntry[][];
+	vendor: string;
+}
+export interface DistanceMatrixEntry {
+	status: "OK" | "NO_ROUTE";
+	duration?: {
+		durationInSeconds: number;
+	};
+	distance?: {
+		distanceInMeters: number;
+	};
+}
+export interface DirectionsRequest {
+	requests: {
+		origin: LatLng;
+		destination: LatLng;
+		waypoints?: LatLng[];
+		avoid?: ("ferry" | "highway" | "toll")[];
+	}[];
+}
+export interface DirectionsResponse {
+	routes: {
+		leg: {
+			origin: LatLng;
+			destination: LatLng;
+		};
+		travelInfo: {
+			status: "OK" | "NO_ROUTE";
+			duration: {
+				durationInSeconds: number;
+			};
+			distance: {
+				distanceInMeters: number;
+			};
+		};
+	}[];
+}
+export interface GeocodeRequest {
+	addresses: string[];
+	language?: string;
+	responseType?: "allMatches";
+}
+export interface GeocodeResponse {
+	result: {
+		address: string;
+		latLng: LatLng;
+		granularity?: string;
+	}[];
+}
+export interface AutocompleteRequest {
+	input: string;
+	sessionId?: string;
+	location?: LatLng;
+	radius?: number;
+	country?: string;
+}
+export interface AutocompleteResponse {
+	predictions: {
+		description: string;
+		placeId: string;
+	}[];
+	status: "OK" | "ZERO_RESULTS";
+	errorMessage?: string;
+}
+export interface PlaceRequest {
+	placeId: string;
+	sessionId: string;
+}
+export interface PlaceResponse {
+	addressComponents: {
+		streetNumber: string;
+		route: string;
+		localCity: string;
+		area2: string;
+		area1: string;
+		country: string;
+		postalCode: string;
+	};
+	formattedAddress: string;
+	geometry: LatLng;
+}
+export interface TimezoneRequest {
+	location: [
+		number,
+		number
+	];
+	timestamp: number;
+}
+export interface TimezoneResponse {
+	dstOffset: number;
+	rawOffset: number;
+	timeZoneId: string;
+}
+export interface BaseObject {
+	id: string;
+	name: string;
+	propertyMap?: Record<string, any>;
+}
+export interface BaseEvent extends BaseObject {
+	start: Date;
+	finish: Date;
+	eventType?: string;
+	description?: string;
+	geoLocation?: LatLng;
+}
+export interface Resource extends BaseObject {
+	category?: string;
+	employmentType?: string;
+	resourceType?: string;
+	userId?: string;
+	regionId?: string;
+	timezone: string;
+	tags: Tag[];
+	availabilities: BaseEvent[];
+	events: BaseEvent[];
+}
+export interface Tag extends BaseObject {
+}
+export interface Availability extends BaseEvent {
+	resourceId: string;
+	isAvailable: boolean;
+	status: string;
+	availabilityType: string;
+}
+export interface Activity extends BaseEvent {
+	resourceId: string;
+	activityType: string;
+}
+export interface JobAllocation extends BaseEvent {
+	jobId: string;
+	resourceId: string;
+	status: string;
+}
+export interface Job extends BaseEvent {
+	address: string;
+	contactId: string;
+	jobStatus: string;
+	regionId: string;
+	tags: Tag[];
+}
+export interface ResourceShift extends BaseEvent {
+	resourceId: string;
+	shift: Shift;
+}
+export interface Shift extends BaseEvent {
+	regionId: string;
+	displayName: string;
+	isDraft: boolean;
+}
+export declare class EntityFactory {
+	static createBaseObject(data: Record<string, string>): BaseObject;
+	static createBaseEvent(data: Record<string, string>): BaseEvent;
+	static createTag(data: Record<string, any>): Tag;
+	static createResource(data: Record<string, any>): Resource;
+	static createJob(data: Record<string, any>): Job;
+	static createAvailability(data: Record<string, any>): Availability;
+	static createActivity(data: Record<string, any>): Activity;
+	static createJobAllocation(data: Record<string, any>): JobAllocation;
+	static createResourceShift(data: Record<string, any>): ResourceShift;
+	static createShift(data: Record<string, any>): Shift;
 }
 export type ArtifactParams = {
 	objectName?: string;
@@ -427,7 +622,7 @@ export type ArtifactParams = {
 declare class ArtifactClient extends BaseClient {
 	private artifactType;
 	private baseEndpoint;
-	constructor(config: any, artifactType: ArtifactType);
+	constructor(config: any, artifactType: ArtifactType, executionOptions?: Partial<ExecutionOptions>);
 	list<T>(): Promise<T[]>;
 	get<T>(params?: ArtifactParams): Promise<T>;
 	create<T>(params: ArtifactParams, artifactData: Partial<T>): Promise<T>;
@@ -435,6 +630,58 @@ declare class ArtifactClient extends BaseClient {
 	delete(params: ArtifactParams): Promise<void>;
 	private buildEndpoint;
 }
+export interface AvailabilityRequestParams {
+	/**
+	 * Array of resource IDs for which availability is requested.
+	 * Must contain at least one and at most 200 resource IDs.
+	 */
+	resourceIds: string[];
+	/**
+	 * The UTC datetime from which to start fetching availability (ISO 8601 format).
+	 */
+	start: string;
+	/**
+	 * The UTC datetime until which to fetch availability (ISO 8601 format).
+	 * Must be after start and within 375 days.
+	 */
+	end: string;
+	/**
+	 * If true, merged availability time intervals are returned in the response.
+	 * Defaults to false.
+	 */
+	mergedAvailabilities?: boolean;
+	/**
+	 * If true (or omitted), a list of availability entries is returned.
+	 * Defaults to true.
+	 */
+	entries?: boolean;
+}
+export interface AvailabilityResult {
+	resourceId: string;
+	mergedAvailabilities?: {
+		start: string;
+		end: string;
+	}[];
+	entries?: AvailabilityEntry[];
+}
+export interface AvailabilityEntry {
+	type: "template" | "pattern" | "override" | "holiday";
+	start: string;
+	end: string;
+	available: boolean;
+	templateEntryId?: string;
+	name?: string;
+	patternId?: string;
+	patternRecordId?: string;
+}
+declare class AvailabilityAPIClient extends BaseClient {
+	/**
+	 * Fetches resource availability based on the given request parameters.
+	 * @param {AvailabilityRequestParams} params - The request parameters for availability.
+	 * @returns {Promise<AvailabilityResult[]>} - The availability data for the requested resources.
+	 */
+	fetchAvailability(params: AvailabilityRequestParams): Promise<AvailabilityResult[]>;
+}
 declare class ConfigFeaturesClient extends BaseClient {
 	/**
 	 * Fetches feature flags configuration.
@@ -448,6 +695,32 @@ declare class ConfigFeaturesClient extends BaseClient {
 	 */
 	update(tenantId: string, newConfig: Record<string, any>): Promise<Record<string, any>>;
 }
+declare class GeoAPIClient extends BaseClient {
+	/**
+	 * Computes travel distance and time for all combinations of origin and destination locations.
+	 */
+	getDistanceMatrix(data: DistanceMatrixRequest): Promise<DistanceMatrixResponse>;
+	/**
+	 * Calculates directions between source and destination addresses, possibly including waypoints en route.
+	 */
+	getDirections(data: DirectionsRequest): Promise<DirectionsResponse>;
+	/**
+	 * Geocodes a given list of addresses and returns their latitude and longitude coordinates.
+	 */
+	geocodeAddress(data: GeocodeRequest): Promise<GeocodeResponse>;
+	/**
+	 * Provides address autocomplete suggestions based on an input string.
+	 */
+	autocompleteAddress(data: AutocompleteRequest): Promise<AutocompleteResponse>;
+	/**
+	 * Fetches detailed information for a given place ID.
+	 */
+	getPlaceDetails(data: PlaceRequest): Promise<PlaceResponse>;
+	/**
+	 * Retrieves timezone information for a given location and timestamp.
+	 */
+	getTimezone(data: TimezoneRequest): Promise<TimezoneResponse>;
+}
 export interface JobRequest {
 	jobId: string;
 }
@@ -654,6 +927,43 @@ export interface CacheOptions<T> {
 	ttl?: number;
 	useSecondaryCache?: boolean;
 }
+declare class GeoService {
+	private geoAPIClient;
+	private sessionId;
+	constructor(geoAPIClient: GeoAPIClient);
+	/**
+	 * Gets distance matrix and returns a structured result map.
+	 */
+	getDistanceMatrix(origins: LatLng[], destinations: LatLng[]): Promise<Map<string, any>>;
+	/**
+	 * Fetches address suggestions and automatically retrieves place details for the first result.
+	 */
+	getAddressSuggestions(request: AutocompleteRequest, maxResults?: number): Promise<PlaceResponse[] | null>;
+	/**
+	 * Gets timezone information for a given location.
+	 */
+	getTimezone(data: TimezoneRequest): Promise<string>;
+	/**
+	 * Generates a new session ID.
+	 */
+	generateNewSessionId(): string;
+	/**
+	 * Strips trailing zeros from latitude and longitude values.
+	 *
+	 * This is necessary because some systems, like Salesforce, may automatically remove trailing zeros
+	 * when storing or processing geolocation values. If we use raw geocodes (e.g., -78.729880, 35.897187),
+	 * they might be altered to -78.72988, 35.897187 when retrieved later.
+	 *
+	 * Since the Distance Matrix API uses the exact string representation of coordinates as keys for caching
+	 * and lookup, a mismatch due to trailing zeros can cause unexpected errors or failed lookups.
+	 * Removing trailing zeros ensures consistency in coordinate representation and prevents key mismatches.
+	 */
+	stripTrailingZeros(value: number): string;
+	/**
+	 * Creates a unique key for origin and destination pair, ensuring stripped trailing zeros.
+	 */
+	createKey(origin: LatLng, destination: LatLng): string;
+}
 /**
  * A service class for handling GraphQL operations.
  */
@@ -666,43 +976,51 @@ export declare class GraphQLService {
 	constructor(client: GraphQLClient);
 	/**
 	 * Executes a GraphQL query to fetch records.
-	 * @param {FetchRecordsQueryParams} params - The query parameters.
+	 * @param {GraphqlQueryParams} params - The query parameters.
 	 * @returns {Promise<QueryResult>} - The query result including records, total count, page info, and cursors.
 	 */
-	query(params: FetchRecordsQueryParams): Promise<QueryResult>;
+	query(params: GraphqlQueryParams): Promise<QueryResult>;
 	/**
-	 * Deletes records from the GraphQL API.
+	 * Performs a mutation operation on the GraphQL API.
 	 * @param {string} objectName - The name of the object.
 	 * @param {HasId[]} records - The records to delete.
 	 * @returns {Promise<any>} - The response from the delete operation.
 	 */
-	delete(objectName: string, records: HasId[]): Promise<any>;
+	mutate(params: GraphqlMurationParams): Promise<any>;
+	/**
+	 * Deletes records from the GraphQL API.
+	 */
+	delete(params: GraphqlMurationParams): Promise<any>;
 	/**
 	 * Updates records in the GraphQL API.
-	 * @param {string} objectName - The name of the object.
-	 * @param {HasId[]} records - The records to update.
-	 * @returns {Promise<any>} - The response from the update operation.
 	 */
-	update(objectName: string, records: HasId[]): Promise<any>;
+	update(params: GraphqlMurationParams): Promise<any>;
 	/**
 	 * Inserts records into the GraphQL API.
-	 * @param {string} objectName - The name of the object.
-	 * @param {HasId[]} records - The records to insert.
-	 * @returns {Promise<any>} - The response from the insert operation.
 	 */
-	insert(objectName: string, records: HasId[]): Promise<any>;
+	insert(params: GraphqlMurationParams): Promise<any>;
 	/**
 	 * Extracts job UIDs from a GraphQL mutation response.
 	 * @param {MutationResult} response - The response object.
 	 * @returns {string[]} - An array of job UIDs.
 	 */
 	extractJobUIDs(response: MutationResult): string[];
+	/**
+	 * Formats the object name to follow GraphQL naming conventions.
+	 * @param {string} objectName - The object name to format.
+	 * @returns {string} - The formatted object name.
+	 */
+	private getQueryName;
+	private getQueryHeaders;
+	private getMutationHeaders;
+	private getOperationHeader;
 }
 /**
  * A utility class for building GraphQL queries dynamically.
  */
 export declare class GraphQLQueryBuilder {
 	private objectName;
+	operationName: string;
 	private fields;
 	private filters;
 	private first?;
@@ -713,77 +1031,113 @@ export declare class GraphQLQueryBuilder {
 	private childQueries;
 	private isParent;
 	private graphqlService;
+	private queryParams;
 	/**
 	 * Creates an instance of GraphQLQueryBuilder.
-	 * @param {string} objectName - The name of the object being queried.
+	 * @param {string} graphqlQueryParams - The necessary parameters for the query.
 	 * @param {boolean} [isParent=false] - Indicates if this query is a parent query.
 	 */
-	constructor(objectName: string, isParent?: boolean);
+	constructor(queryParams: GraphqlQueryParams, isParent?: boolean);
 	/**
 	 * Sets the GraphQL service to use for executing the query.
-	 * @param {GraphQLService} graphqlService - The GraphQL service instance.
-	 * @returns {void}
 	 */
 	setGraphqlService(graphqlService: GraphQLService): void;
 	/**
-	 * Specifies the fields to be retrieved.
-	 * @param {string[]} fields - The list of fields to select.
-	 * @returns {this} - The query builder instance.
+	 * Specifies the fields to be retrieved. Prevents duplicates.
 	 */
 	withFields(fields: string[]): this;
 	/**
 	 * Adds a filter condition to the query.
-	 * @param {string} condition - The filter condition.
-	 * @returns {this} - The query builder instance.
 	 */
 	withFilter(condition: string): this;
 	/**
 	 * Sets a limit on the number of records to retrieve.
-	 * @param {number} first - The number of records to fetch.
-	 * @returns {this} - The query builder instance.
 	 */
 	withLimit(first: number): this;
 	/**
 	 * Sets an offset for pagination.
-	 * @param {number} offset - The offset value.
-	 * @returns {this} - The query builder instance.
 	 */
 	withOffset(offset: number): this;
 	/**
 	 * Sets the order in which records should be retrieved.
-	 * @param {string} orderBy - The field to order by.
-	 * @returns {this} - The query builder instance.
 	 */
 	withOrderBy(orderBy: string): this;
 	/**
 	 * Applies cursor-based pagination.
-	 * @param {string} after - The cursor position.
-	 * @returns {this} - The query builder instance.
 	 */
 	withCursor(after: string): this;
 	/**
 	 * Creates a parent query.
-	 * @param {string} objectName - The name of the parent object.
-	 * @returns {GraphQLQueryBuilder} - A new query builder instance for the parent.
 	 */
 	withParentQuery(objectName: string): GraphQLQueryBuilder;
 	/**
 	 * Creates a child query.
-	 * @param {string} objectName - The name of the child object.
-	 * @returns {GraphQLQueryBuilder} - A new query builder instance for the child.
 	 */
 	withChildQuery(objectName: string): GraphQLQueryBuilder;
 	/**
-	 * Builds the GraphQL query parameters.
-	 * @returns {FetchRecordsQueryParams} - The formatted query parameters.
+	 * Recursively builds the GraphQL query fields, handling nested queries.
+	 */
+	private formatQueryFields;
+	/**
+	 * Builds the GraphQL query parameters in a more structured format.
 	 */
-	build(): FetchRecordsQueryParams;
+	build(): GraphqlQueryParams;
 	/**
-	 * Executes the query using the GraphQL service.
-	 * @returns {Promise<QueryResult>} - The query result.
-	 * @throws {Error} - If no GraphQL service is set.
+	 * Executes the query using the GraphQL service, with improved error handling.
 	 */
 	execute(): Promise<QueryResult>;
+	/**
+	 * Generates a string representation of the GraphQL query for debugging.
+	 */
+	toString(): string;
+}
+export declare class ResourceQueryParam {
+	resourceIds?: Set<string>;
+	regionIds?: Set<string>;
+	startTime: Date;
+	endTime: Date;
+	timezone: string;
+	respectResourceTimezone: boolean;
+	mergeAvailability: boolean;
+	mergeEvents: boolean;
+	useTag: boolean;
+	useJobAllocation: boolean;
+	useResourceShift: boolean;
+	useActivity: boolean;
+	useAvailability: boolean;
+	useAvailabilityTemplate: boolean;
+	useAvailabilityPattern: boolean;
+	useHoliday: boolean;
+	excludedJAStatus: Set<string>;
+	excludedJobStatus: Set<string>;
+	availabilityStatus: Set<string>;
+	resourceTypes: Set<string>;
+	constructor();
+}
+declare class DataService {
+	private graphqlService;
+	constructor(graphqlService: GraphQLService);
+	getResources(param: ResourceQueryParam): Promise<Record<string, any>[]>;
+	getHolidays(regionIds: string[], startTime?: Date, endTime?: Date): Promise<Record<string, any>>;
+	newQueryBuilder(params: GraphqlQueryParams): GraphQLQueryBuilder;
+}
+export declare class ResourceAvailabilityService {
+	private availabilityAPIClient;
+	constructor(availabilityAPIClient: AvailabilityAPIClient);
+	getAvailabilityPatterns(param: ResourceQueryParam): Promise<Map<string, BaseEvent[]>>;
+}
+export declare class ResourceBuilder {
+	private dataService;
+	private availabilityService;
+	constructor(dataService: DataService, availabilityService: ResourceAvailabilityService);
+	build(queryParam: ResourceQueryParam): Promise<Resource[]>;
+	private loadAvailabilityPatterns;
+	private loadActivityEvents;
+	private loadAvailabilityEvents;
+	private loadJobAllocationEvents;
+	private loadResourceShiftEvents;
+	private loadHolidayEvents;
+	protected buildMore(resources: Resource[]): Resource[];
 }
 /**
  * ConfigHelper class provides methods to access and parse configuration variables.
@@ -820,20 +1174,40 @@ export declare class ConfigHelper {
 	 */
 	getString(varName: string): string;
 }
+export declare class DateTimeUtils {
+	static toTimezone(input: Date, toTimezone: string): Date;
+	static switchTimezone(input: Date, fromTimezone: string, toTimezone: string): Date;
+	static addMinutes(input: Date, minutes: number, timezone: string): Date;
+	static addDays(input: Date, days: number, timezone: string): Date;
+	static addMonths(input: Date, months: number, timezone: string): Date;
+	static addYears(input: Date, years: number, timezone: string): Date;
+	static getDate(input: Date, timezone: string): Date;
+	static getDateFromIsoString(isoString: string): Date;
+	static getDateTimeFromIsoString(isoString: string): Date;
+	static getStartOfDate(input: Date | string, timezone: string): Date;
+	static getEndOfDate(input: Date | string, timezone: string): Date;
+	static isIncluding(event: BaseEvent, job: BaseEvent): boolean;
+	static isOverlapping(event: BaseEvent, job: BaseEvent): boolean;
+	static mergeEvents(events: BaseEvent[]): BaseEvent[];
+}
 export declare class ExecutionContext {
 	skedContext: any;
 	contextData: any;
 	private baseConfig;
 	logger: typeof logger;
 	private services;
-	protected constructor(skedContext: any);
-	static fromContext(skedContext: any): ExecutionContext;
-	static fromCredentials(config: BaseConfig): ExecutionContext;
+	private _executionOptions;
+	protected constructor(skedContext: any, executionOptions?: Partial<ExecutionOptions>);
+	static fromContext(skedContext: any, executionOptions?: Partial<ExecutionOptions>): ExecutionContext;
+	static fromCredentials(config: BaseConfig, executionOptions?: Partial<ExecutionOptions>): ExecutionContext;
+	set executionOptions(executionOptions: Partial<ExecutionOptions>);
+	get executionOptions(): Partial<ExecutionOptions>;
 	/**
 	 * Generic method to retrieve or initialize a service.
 	 */
 	private getOrCreateService;
 	get configHelper(): ConfigHelper;
+	get baseClient(): BaseClient;
 	get graphqlClient(): GraphQLClient;
 	get graphqlService(): GraphQLService;
 	get metadataClient(): MetadataClient;
@@ -844,12 +1218,77 @@ export declare class ExecutionContext {
 	get configFeaturesClient(): ConfigFeaturesClient;
 	get configVarClient(): ConfigVarClient;
 	get mobileNotificationClient(): MobileNotificationClient;
+	get geoAPIClient(): GeoAPIClient;
+	get availabilityAPIClient(): AvailabilityAPIClient;
+	get geoService(): GeoService;
 	get configVarCache(): CacheService<any>;
 	get inMemoryCache(): CacheService<any>;
-	newQueryBuilder(objectName: string): GraphQLQueryBuilder;
+	get resourceAvailabilityService(): ResourceAvailabilityService;
+	get dataService(): DataService;
+	get resourceBuilder(): ResourceBuilder;
+	newQueryBuilder(params: GraphqlQueryParams): GraphQLQueryBuilder;
 	newArtifactClient(artifactType: ArtifactType): ArtifactClient;
 	dispose(): void;
 }
+export declare const REQUEST_HEADERS: Record<string, string>;
+export declare const TenantObjects: {
+	Accounts: {
+		Name: string;
+		Fields: string[];
+	};
+	Jobs: {
+		Name: string;
+		Fields: string[];
+	};
+	JobTags: {
+		Name: string;
+		Fields: string[];
+	};
+	JobAllocations: {
+		Name: string;
+		Fields: string[];
+	};
+	Regions: {
+		Name: string;
+		Fields: string[];
+	};
+	Contacts: {
+		Name: string;
+		Fields: string[];
+	};
+	Locations: {
+		Name: string;
+		Fields: string[];
+	};
+	Resources: {
+		Name: string;
+		Fields: string[];
+	};
+	Tags: {
+		Name: string;
+		Fields: string[];
+	};
+	Activities: {
+		Name: string;
+		Fields: string[];
+	};
+	Availabilities: {
+		Name: string;
+		Fields: string[];
+	};
+	Holidays: {
+		Name: string;
+		Fields: string[];
+	};
+	ResourceTags: {
+		Name: string;
+		Fields: string[];
+	};
+	HolidayRegions: {
+		Name: string;
+		Fields: string[];
+	};
+};
 /**
  * This decorator logs the input arguments and output results of a method,
  * including error handling with ANSI color-coded logs for better console readability.
@@ -905,5 +1344,123 @@ export declare class BatchOrchestrator {
 	protected updateJobStatus(): Promise<void>;
 	private isCompleted;
 }
+export declare enum PaginationStrategy {
+	CURSOR = "cursor",
+	OFFSET = "offset",
+	NONE = "none"
+}
+/**
+ * Default configuration values for `GraphBatchConfig`.
+ */
+export declare const DEFAULT_GRAPH_BATCH_CONFIG: GraphBatchConfig;
+declare const GraphBatchConfigSchema: z.ZodObject<{
+	strategy: z.ZodNativeEnum<typeof PaginationStrategy>;
+	batchSize: z.ZodDefault<z.ZodNumber>;
+	maxBatches: z.ZodDefault<z.ZodNumber>;
+	delaySeconds: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+	strategy: PaginationStrategy;
+	batchSize: number;
+	maxBatches: number;
+	delaySeconds: number;
+}, {
+	strategy: PaginationStrategy;
+	batchSize?: number | undefined;
+	maxBatches?: number | undefined;
+	delaySeconds?: number | undefined;
+}>;
+/**
+ * Configuration options for `GraphBatch`.
+ */
+export type GraphBatchConfig = z.infer<typeof GraphBatchConfigSchema>;
+/**
+ * Merges user-provided config with default values.
+ */
+export declare function initializeConfig(config: Partial<GraphBatchConfig> | undefined): GraphBatchConfig;
+/**
+ * Base class for batch processing with pagination support.
+ */
+export declare abstract class GraphBatch {
+	protected context: ExecutionContext;
+	protected config: GraphBatchConfig;
+	protected queryBuilder?: GraphQLQueryBuilder;
+	protected queryResult?: QueryResult;
+	private startTime;
+	constructor(context: ExecutionContext, config?: Partial<GraphBatchConfig>);
+	/**
+	 * Runs the batch process, handling pagination, execution, and accumulation of results.
+	 *
+	 * @returns The accumulated result of the batch process.
+	 */
+	run(): Promise<void>;
+	/**
+	 * Initializes the query builder. This method must be overridden in subclasses.
+	 *
+	 * @returns A configured GraphQL query builder.
+	 */
+	protected abstract start(): Promise<GraphQLQueryBuilder>;
+	/**
+	 * Processes a batch of records and accumulates the result.
+	 *
+	 * @param records The batch of records retrieved from the query.
+	 */
+	protected abstract execute(records: any[]): Promise<void>;
+	/**
+	 * Final cleanup or logging after the batch process completes.
+	 */
+	protected finish(): Promise<void>;
+	/**
+	 * Fetches the next page of data based on the pagination strategy.
+	 *
+	 * @returns The result of the query execution.
+	 */
+	protected fetchNextPage(): Promise<QueryResult>;
+	/**
+	 * Checks if the maximum number of batches has been reached.
+	 *
+	 * @param currentBatchCount The number of batches processed so far.
+	 * @returns `true` if the maximum limit is reached, otherwise `false`.
+	 */
+	protected isMaxBatchesReached(currentBatchCount: number): boolean;
+	/**
+	 * Delays execution for a specified time.
+	 *
+	 * @param ms The time in milliseconds to delay.
+	 */
+	protected delay(ms: number): Promise<void>;
+}
+export interface ResourceValidationOption {
+	checkAvailability: boolean;
+	checkConflict: boolean;
+	checkTag: boolean;
+}
+export declare class ResourceJobValidation {
+	resource: Partial<Resource>;
+	job: Partial<Job>;
+	availableEvent: BaseEvent | null;
+	conflictEvents: BaseEvent[];
+	missingTags: Tag[];
+	constructor(resource: Partial<Resource>, job: Partial<Job>, availableEvent?: BaseEvent | null, conflictEvents?: BaseEvent[], missingTags?: Tag[]);
+	isQualified(option: ResourceValidationOption): boolean;
+}
+export declare class ValidationResult {
+	private readonly validations;
+	private readonly option;
+	constructor(validations: ResourceJobValidation[], option: ResourceValidationOption);
+	getQualifiedResources(): Partial<Resource>[];
+	getJobsWithXQualifiedResources(minQualifiedResources: number): Partial<Job>[];
+	getUnqualifiedJobsWithReasons(): ResourceJobValidation[];
+	format(): any[];
+}
+export declare class ResourceValidator {
+	private readonly option;
+	constructor(option: ResourceValidationOption);
+	validate(resources: Resource[], jobs: Job[]): ValidationResult;
+	private validateResource;
+	private findAvailableEvent;
+	private findConflictingEvents;
+	private findMissingTags;
+	private prepareData;
+}
 
 export {};