@skedulo/pulse-solution-services 0.0.15 → 0.0.17

package/dist/index.d.ts

@@ -316,7 +316,7 @@ export declare class ConfigTemplateClient extends BaseClient {
 	 * @param {string} templateId - The template ID.
 	 * @returns {Promise<any[]>} - A promise resolving to an array of configuration values.
 	 */
-	getTemmplateValues(templateId: string): Promise<any[]>;
+	getTemplateValues(templateId: string): Promise<any[]>;
 	/**
 	 * Updates or Inserts configuration template values.
 	 * @param {string} templateId - The template ID.
@@ -567,11 +567,12 @@ export interface GraphqlParams {
 	objectName: string;
 	operationName: string;
 }
-export interface GraphqlMurationParams extends GraphqlParams {
+export interface GraphqlMutationParams extends GraphqlParams {
 	records: HasId[];
-	operation: GraphqlOperations;
+	operation?: GraphqlOperations;
 	bulkOperation?: boolean;
 	suppressChangeEvents?: boolean;
+	keyField?: string;
 }
 export interface GraphqlQueryParams extends GraphqlParams {
 	first?: number;
@@ -595,6 +596,7 @@ export interface MutationResult {
 			[alias: string]: string;
 		};
 	};
+	errors?: object[];
 }
 export interface GraphQLRequest {
 	query: string;
@@ -606,7 +608,7 @@ export interface GraphQLRequest {
  */
 export declare class GraphQLClient extends BaseClient {
 	/**
-	 * Executes a GraphQL query or mutation.
+	 * Executes a single GraphQL query or mutation.
 	 * @param {string | GraphQLRequest} 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.
@@ -614,13 +616,13 @@ export declare class GraphQLClient extends BaseClient {
 	 */
 	execute(graphqlQuery: string | GraphQLRequest, headers?: Record<string, string>): Promise<GraphQlResponse>;
 	/**
-	 * Executes a GraphQL query or mutation.
-	 * @param {string | GraphQLRequest} graphqlQuery - The GraphQL query or mutation string.
+	 * Executes a batch of GraphQL queries or mutations.
+	 * @param {Array<string | GraphQLRequest>} graphqlQueries - An array of GraphQL queries or mutations.
 	 * @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.
+	 * @returns {Promise<GraphQlResponse[]>} - An array of responses from the GraphQL API.
+	 * @throws {Error} - If the request fails or if there are errors in any of the responses.
 	 */
-	executeBatch(graphqlQuery: string | GraphQLRequest, headers?: Record<string, string>): Promise<GraphQlResponse>;
+	executeBatch(graphqlQueries: Array<string | GraphQLRequest>, headers?: Record<string, string>): Promise<GraphQlResponse[]>;
 	protected handleResponseData(responseData: any): void;
 }
 /**
@@ -1039,54 +1041,106 @@ export declare class GeoService {
 	createKey(origin: LatLng, destination: LatLng): string;
 }
 /**
- * A service class for handling GraphQL operations.
+ * Service for executing GraphQL queries and mutations.
  */
 export declare class GraphQLService {
 	private client;
 	/**
-	 * Creates an instance of GraphQLService.
-	 * @param {GraphQLClient} client - The GraphQL client to use for queries and mutations.
+	 * Constructor to initialize the GraphQL client.
+	 * @param {GraphQLClient} client - The GraphQL client instance.
 	 */
 	constructor(client: GraphQLClient);
 	/**
-	 * Executes a GraphQL query to fetch records.
-	 * @param {GraphqlQueryParams} params - The query parameters.
-	 * @returns {Promise<QueryResult>} - The query result including records, total count, page info, and cursors.
+	 * Executes a GraphQL query.
+	 * @param {GraphqlQueryParams} params - The parameters for the GraphQL query.
+	 * @returns {Promise<QueryResult>} - The query result containing records and pagination info.
+	 * @throws {Error} - If the query execution fails.
 	 */
 	query(params: GraphqlQueryParams): Promise<QueryResult>;
 	/**
-	 * 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.
+	 * Executes a batch of queries.
+	 * @param {GraphQLQueryBuilder[]} builders - Array of query builders.
+	 * @returns {Promise<QueryResult[]>} - Array of query results.
+	 */
+	queryBatch(builders: GraphQLQueryBuilder[]): Promise<QueryResult[]>;
+	/**
+	 * Executes a batch of GraphQL queries.
+	 * @param {GraphqlQueryParams[]} paramsArray - An array of query parameters.
+	 * @returns {Promise<QueryResult[]>} - An array of query results.
+	 * @throws {Error} - If the batch execution fails.
+	 */
+	private executeBatchQueries;
+	/**
+	 * Executes a GraphQL mutation.
+	 * @param {GraphqlMutationParams} params - The parameters for the GraphQL mutation.
+	 * @returns {Promise<MutationResult>} - The mutation result containing affected UIDs.
+	 * @throws {Error} - If the mutation execution fails or the operation is invalid.
+	 */
+	mutate(params: GraphqlMutationParams): Promise<MutationResult>;
+	/**
+	 * Executes a batch of GraphQL mutations.
+	 * @param {GraphqlMutationParams[]} paramsArray - An array of mutation parameters.
+	 * @returns {Promise<MutationResult[]>} - An array of mutation results.
+	 * @throws {Error} - If the batch execution fails or if any mutation has empty records.
 	 */
-	mutate(params: GraphqlMurationParams): Promise<any>;
+	mutateBatch(paramsArray: GraphqlMutationParams[]): Promise<MutationResult[]>;
 	/**
-	 * Deletes records from the GraphQL API.
+	 * Deletes objects using a GraphQL mutation.
+	 * @param {GraphqlMutationParams} params - The parameters for the delete mutation.
+	 * @returns {Promise<MutationResult>} - The mutation result containing deleted UIDs.
+	 * @throws {Error} - If the delete operation fails.
 	 */
-	delete(params: GraphqlMurationParams): Promise<any>;
+	delete(params: GraphqlMutationParams): Promise<MutationResult>;
 	/**
-	 * Updates records in the GraphQL API.
+	 * Updates objects using a GraphQL mutation.
+	 * @param {GraphqlMutationParams} params - The parameters for the update mutation.
+	 * @returns {Promise<MutationResult>} - The mutation result containing updated UIDs.
+	 * @throws {Error} - If the update operation fails.
 	 */
-	update(params: GraphqlMurationParams): Promise<any>;
+	update(params: GraphqlMutationParams): Promise<MutationResult>;
 	/**
-	 * Inserts records into the GraphQL API.
+	 * Inserts objects using a GraphQL mutation.
+	 * @param {GraphqlMutationParams} params - The parameters for the insert mutation.
+	 * @returns {Promise<MutationResult>} - The mutation result containing inserted UIDs.
+	 * @throws {Error} - If the insert operation fails.
 	 */
-	insert(params: GraphqlMurationParams): Promise<any>;
+	insert(params: GraphqlMutationParams): Promise<MutationResult>;
 	/**
-	 * Extracts job UIDs from a GraphQL mutation response.
-	 * @param {MutationResult} response - The response object.
-	 * @returns {string[]} - An array of job UIDs.
+	 * Upserts objects using a GraphQL mutation.
+	 * @param {GraphqlMutationParams} params - The parameters for the upsert mutation, including keyField.
+	 * @returns {Promise<MutationResult>} - The mutation result containing upserted UIDs.
+	 * @throws {Error} - If the upsert operation fails.
 	 */
-	extractJobUIDs(response: MutationResult): string[];
+	upsert(params: GraphqlMutationParams): Promise<MutationResult>;
 	/**
-	 * Formats the object name to follow GraphQL naming conventions.
-	 * @param {string} objectName - The object name to format.
-	 * @returns {string} - The formatted object name.
+	 * Extracts UIDs from a mutation response.
+	 * @param {MutationResult} response - The mutation response containing the schema.
+	 * @returns {string[]} - An array of UIDs extracted from the response.
+	 */
+	extractUIDs(response: MutationResult): string[];
+	/**
+	 * Converts object name to GraphQL query name format.
+	 * @param {string} objectName - The object name to convert.
+	 * @returns {string} - The formatted query name.
 	 */
 	private getQueryName;
+	/**
+	 * Generates headers for GraphQL queries.
+	 * @param {GraphqlQueryParams} params - The query parameters containing operationName and readOnly flag.
+	 * @returns {Record<string, string>} - The headers for the query request.
+	 */
 	private getQueryHeaders;
+	/**
+	 * Generates headers for GraphQL mutations.
+	 * @param {GraphqlMutationParams} params - The mutation parameters containing operationName and optional flags.
+	 * @returns {Record<string, string>} - The headers for the mutation request.
+	 */
 	private getMutationHeaders;
+	/**
+	 * Generates operation header for GraphQL requests.
+	 * @param {string} operationName - The name of the GraphQL operation.
+	 * @returns {Record<string, string>} - The operation header.
+	 */
 	private getOperationHeader;
 }
 /**
@@ -1108,7 +1162,7 @@ export declare class GraphQLQueryBuilder {
 	private queryParams;
 	/**
 	 * Creates an instance of GraphQLQueryBuilder.
-	 * @param {string} graphqlQueryParams - The necessary parameters for the query.
+	 * @param {GraphqlQueryParams} queryParams - The parameters for the query.
 	 * @param {boolean} [isParent=false] - Indicates if this query is a parent query.
 	 */
 	constructor(queryParams: GraphqlQueryParams, isParent?: boolean);
@@ -1153,13 +1207,21 @@ export declare class GraphQLQueryBuilder {
 	 */
 	private formatQueryFields;
 	/**
-	 * Builds the GraphQL query parameters in a more structured format.
+	 * Builds the GraphQL query parameters in a structured format.
 	 */
 	build(): GraphqlQueryParams;
 	/**
-	 * Executes the query using the GraphQL service, with improved error handling.
+	 * Executes the query using the GraphQL service.
 	 */
 	execute(): Promise<QueryResult>;
+	/**
+	 * Executes all queries for the configured object, fetching records from the specified page range, up to a maximum of 20 pages.
+	 * @param {number} [fromPage=1] - The starting page number (1-based, defaults to 1).
+	 * @param {number} [toPage=20] - The ending page number (defaults to 20, capped at 20).
+	 * @returns {Promise<QueryResult>} - A query result containing all records in the page range and pagination info.
+	 * @throws {Error} - If the query execution fails, no GraphQL service is set, or invalid page parameters are provided.
+	 */
+	executeAll(fromPage?: number, toPage?: number): Promise<QueryResult>;
 	/**
 	 * Generates a string representation of the GraphQL query for debugging.
 	 */

package/dist/logging/decorators/log-method.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.LogMethod=LogMethod;const logging_utils_1=require("../logging-utils"),PULSE_SOLUTION_NAMESPACE="PSS",COLORS={RESET:"",GREEN:"",YELLOW:"",RED:"",CYAN:"",MAGENTA:""};function LogMethod(t=PULSE_SOLUTION_NAMESPACE){return function(e,n,o){const r=o.value,E=process.env.LOG_NAMESPACE||"";if(!E)return o;const O=parseInt(process.env.LOG_ENTRY_MAX_LENGTH||"120",10),s=E===t||"ALL"===E.toUpperCase();function S(t,e,n,o,r){const E=(new Date).toISOString(),s="ERROR"===o?COLORS.RED:"INPUT"===o?COLORS.CYAN:COLORS.MAGENTA;console.log(`${COLORS.GREEN}[${t.toUpperCase()}]${COLORS.RESET} | ${COLORS.YELLOW}${E}${COLORS.RESET} | ${COLORS.GREEN}${PULSE_SOLUTION_NAMESPACE}${COLORS.RESET} | ${e.constructor.name} | ${n} - ${s}${o}${COLORS.RESET}: ${function(t){if(!t)return"";const e=(0,logging_utils_1.maskSensitiveData)(t);return e.length>O?`${e.substring(0,O-3)}...`:e}(r)}`)}return o.value=async function(...t){s&&S("info",this,n.toString(),"INPUT",t);try{const e=await Promise.resolve(r.apply(this,t));return s&&S("info",this,n.toString(),"OUTPUT",e),e}catch(t){throw S("error",this,n.toString(),"ERROR",t.message||t),t}},o}}
+"use strict";var __awaiter=this&&this.__awaiter||function(t,n,e,o){return new(e||(e=Promise))((function(r,i){function s(t){try{O(o.next(t))}catch(t){i(t)}}function E(t){try{O(o.throw(t))}catch(t){i(t)}}function O(t){var n;t.done?r(t.value):(n=t.value,n instanceof e?n:new e((function(t){t(n)}))).then(s,E)}O((o=o.apply(t,n||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.LogMethod=LogMethod;const logging_utils_1=require("../logging-utils"),PULSE_SOLUTION_NAMESPACE="PSS",COLORS={RESET:"",GREEN:"",YELLOW:"",RED:"",CYAN:"",MAGENTA:""};function LogMethod(t=PULSE_SOLUTION_NAMESPACE){return function(n,e,o){const r=o.value,i=process.env.LOG_NAMESPACE||"";if(!i)return o;const s=parseInt(process.env.LOG_ENTRY_MAX_LENGTH||"120",10),E=i===t||"ALL"===i.toUpperCase();function O(t,n,e,o,r){const i=(new Date).toISOString(),E="ERROR"===o?COLORS.RED:"INPUT"===o?COLORS.CYAN:COLORS.MAGENTA;console.log(`${COLORS.GREEN}[${t.toUpperCase()}]${COLORS.RESET} | ${COLORS.YELLOW}${i}${COLORS.RESET} | ${COLORS.GREEN}${PULSE_SOLUTION_NAMESPACE}${COLORS.RESET} | ${n.constructor.name} | ${e} - ${E}${o}${COLORS.RESET}: ${function(t){if(!t)return"";const n=(0,logging_utils_1.maskSensitiveData)(t);return n.length>s?`${n.substring(0,s-3)}...`:n}(r)}`)}return o.value=function(...t){return __awaiter(this,void 0,void 0,(function*(){E&&O("info",this,e.toString(),"INPUT",t);try{const n=yield Promise.resolve(r.apply(this,t));return E&&O("info",this,e.toString(),"OUTPUT",n),n}catch(t){throw O("error",this,e.toString(),"ERROR",t.message||t),t}}))},o}}

package/dist/monitoring/decorators/monitor-call.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.MonitorCall=MonitorCall;const monitoring_registry_1=require("../monitoring-registry");function MonitorCall(r){return function(t,n,o){const e=o.value;return o.value=async function(...o){const i=r||`${t.constructor.name}.${n}`;return(0,monitoring_registry_1.getGlobalMonitorManager)().measure(i,(async()=>e.apply(this,o)))},o}}
+"use strict";var __awaiter=this&&this.__awaiter||function(t,n,r,o){return new(r||(r=Promise))((function(e,i){function a(t){try{c(o.next(t))}catch(t){i(t)}}function u(t){try{c(o.throw(t))}catch(t){i(t)}}function c(t){var n;t.done?e(t.value):(n=t.value,n instanceof r?n:new r((function(t){t(n)}))).then(a,u)}c((o=o.apply(t,n||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.MonitorCall=MonitorCall;const monitoring_registry_1=require("../monitoring-registry");function MonitorCall(t){return function(n,r,o){const e=o.value;return o.value=function(...o){return __awaiter(this,void 0,void 0,(function*(){const i=t||`${n.constructor.name}.${r}`;return(0,monitoring_registry_1.getGlobalMonitorManager)().measure(i,(()=>__awaiter(this,void 0,void 0,(function*(){return e.apply(this,o)}))))}))},o}}

package/dist/monitoring/monitoring-manager.js

@@ -1 +1 @@
-"use strict";var __importDefault=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.MonitoringManager=void 0;const logger_1=__importDefault(require("../logging/logger"));class MonitoringManager{constructor(t={}){this.totalCalls=0,this.methodCallCounts={},this.methodExecutionTimes={},this.concurrentRequests=0,this.peakConcurrentRequests=0,this.startTime=Date.now(),this.violations={},this.thresholds=t}async measure(t,e){this.incrementTotalCallsCount(),this.incrementMethodCount(t),this.trackConcurrentRequest(1,t);const s=Date.now();let o;try{o=await e()}finally{this.trackConcurrentRequest(-1,t)}const i=Date.now()-s;return this.trackExecutionTime(t,i),this.checkMethodDuration(t,i),o}trackConcurrentRequest(t,e){this.concurrentRequests+=t,this.peakConcurrentRequests=Math.max(this.peakConcurrentRequests,this.concurrentRequests),this.thresholds.maxConcurrentRequests&&this.peakConcurrentRequests>this.thresholds.maxConcurrentRequests&&this.handleViolation("maxConcurrentRequests",`Method ${e} max concurrent requests exceeded: ${this.peakConcurrentRequests} (Allowed: ${this.thresholds.maxConcurrentRequests})`)}getExecutionMetrics(){return{totalCalls:this.totalCalls,totalExecutionTimeMs:Date.now()-this.startTime,peakConcurrentRequests:this.peakConcurrentRequests,methodCallCounts:Object.assign({},this.methodCallCounts),methodExecutionTimes:Object.assign({},this.methodExecutionTimes),violations:Object.values(this.violations)}}incrementTotalCallsCount(){this.totalCalls++,this.thresholds.totalCalls&&this.totalCalls>this.thresholds.totalCalls&&this.handleViolation("totalCalls",`Total calls limit exceeded: ${this.totalCalls} (Allowed: ${this.thresholds.totalCalls})`)}incrementMethodCount(t){var e;this.methodCallCounts[t]=(null!==(e=this.methodCallCounts[t])&&void 0!==e?e:0)+1;const s=`methodCallLimit:${t}`,o=this.thresholds.maxMethodCalls;o&&this.methodCallCounts[t]>o&&this.handleViolation(s,`Method [${t}] call limit exceeded: ${this.methodCallCounts[t]} (Allowed: ${o})`)}trackExecutionTime(t,e){this.methodExecutionTimes[t]||(this.methodExecutionTimes[t]={totalTime:0,count:0,min:Number.MAX_VALUE,max:0});const s=this.methodExecutionTimes[t];s.totalTime+=e,s.count+=1,s.min=Math.min(s.min,e),s.max=Math.max(s.max,e)}checkMethodDuration(t,e){const s=this.thresholds.maxMethodExecutionTimeMs,o=`methodDurationLimit:${t}`;s&&e>s&&this.handleViolation(o,`Method [${t}] exceeded duration limit: ${e}ms (Allowed: ${s}ms)`)}handleViolation(t,e){if(this.violations[t]=e,this.thresholds.throwOnViolation)throw new Error(e);logger_1.default.warn(`[Violation] ${e}`)}}exports.MonitoringManager=MonitoringManager;
+"use strict";var __awaiter=this&&this.__awaiter||function(t,e,o,s){return new(o||(o=Promise))((function(i,n){function a(t){try{r(s.next(t))}catch(t){n(t)}}function l(t){try{r(s.throw(t))}catch(t){n(t)}}function r(t){var e;t.done?i(t.value):(e=t.value,e instanceof o?e:new o((function(t){t(e)}))).then(a,l)}r((s=s.apply(t,e||[])).next())}))},__importDefault=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.MonitoringManager=void 0;const logger_1=__importDefault(require("../logging/logger"));class MonitoringManager{constructor(t={}){this.totalCalls=0,this.methodCallCounts={},this.methodExecutionTimes={},this.concurrentRequests=0,this.peakConcurrentRequests=0,this.startTime=Date.now(),this.violations={},this.thresholds=t}measure(t,e){return __awaiter(this,void 0,void 0,(function*(){this.incrementTotalCallsCount(),this.incrementMethodCount(t),this.trackConcurrentRequest(1,t);const o=Date.now();let s;try{s=yield e()}finally{this.trackConcurrentRequest(-1,t)}const i=Date.now()-o;return this.trackExecutionTime(t,i),this.checkMethodDuration(t,i),s}))}trackConcurrentRequest(t,e){this.concurrentRequests+=t,this.peakConcurrentRequests=Math.max(this.peakConcurrentRequests,this.concurrentRequests),this.thresholds.maxConcurrentRequests&&this.peakConcurrentRequests>this.thresholds.maxConcurrentRequests&&this.handleViolation("maxConcurrentRequests",`Method ${e} max concurrent requests exceeded: ${this.peakConcurrentRequests} (Allowed: ${this.thresholds.maxConcurrentRequests})`)}getExecutionMetrics(){return{totalCalls:this.totalCalls,totalExecutionTimeMs:Date.now()-this.startTime,peakConcurrentRequests:this.peakConcurrentRequests,methodCallCounts:Object.assign({},this.methodCallCounts),methodExecutionTimes:Object.assign({},this.methodExecutionTimes),violations:Object.values(this.violations)}}incrementTotalCallsCount(){this.totalCalls++,this.thresholds.totalCalls&&this.totalCalls>this.thresholds.totalCalls&&this.handleViolation("totalCalls",`Total calls limit exceeded: ${this.totalCalls} (Allowed: ${this.thresholds.totalCalls})`)}incrementMethodCount(t){var e;this.methodCallCounts[t]=(null!==(e=this.methodCallCounts[t])&&void 0!==e?e:0)+1;const o=`methodCallLimit:${t}`,s=this.thresholds.maxMethodCalls;s&&this.methodCallCounts[t]>s&&this.handleViolation(o,`Method [${t}] call limit exceeded: ${this.methodCallCounts[t]} (Allowed: ${s})`)}trackExecutionTime(t,e){this.methodExecutionTimes[t]||(this.methodExecutionTimes[t]={totalTime:0,count:0,min:Number.MAX_VALUE,max:0});const o=this.methodExecutionTimes[t];o.totalTime+=e,o.count+=1,o.min=Math.min(o.min,e),o.max=Math.max(o.max,e)}checkMethodDuration(t,e){const o=this.thresholds.maxMethodExecutionTimeMs,s=`methodDurationLimit:${t}`;o&&e>o&&this.handleViolation(s,`Method [${t}] exceeded duration limit: ${e}ms (Allowed: ${o}ms)`)}handleViolation(t,e){if(this.violations[t]=e,this.thresholds.throwOnViolation)throw new Error(e);logger_1.default.warn(`[Violation] ${e}`)}}exports.MonitoringManager=MonitoringManager;

package/dist/services/cache/cache-service.js

@@ -1 +1 @@
-"use strict";var __decorate=this&&this.__decorate||function(e,t,a,r){var i,n=arguments.length,s=n<3?t:null===r?r=Object.getOwnPropertyDescriptor(t,a):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,a,r);else for(var o=e.length-1;o>=0;o--)(i=e[o])&&(s=(n<3?i(s):n>3?i(t,a,s):i(t,a))||s);return n>3&&s&&Object.defineProperty(t,a,s),s},__metadata=this&&this.__metadata||function(e,t){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)},__importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.CacheService=void 0;const logging_1=require("../../logging"),logger_1=__importDefault(require("../../logging/logger")),KEY_PREFIX="Z_CACHE_",DEFAULT_TTL=36e5;class CacheService{constructor(e){this.storage=e}setSecondaryCache(e){this.secondaryCache=e}async get(e,t){e=this.addPrefix(e);const a=await this.storage.get(e);if(a)try{const t=JSON.parse(a);return t.expiresAt&&Date.now()>t.expiresAt?(await this.delete(e),null):this.deserialize(t)}catch(e){return logger_1.default.error("Cache deserialization failed:",e),null}if((null==t?void 0:t.useSecondaryCache)&&this.secondaryCache){const a=await this.secondaryCache.get(e,t);return null!==a&&await this.set(e,a,{ttl:null==t?void 0:t.ttl}),a}return null}async set(e,t,a){var r;e=this.addPrefix(e);const i={type:t instanceof Date?"date":typeof t,value:t,expiresAt:Date.now()+(null!==(r=null==a?void 0:a.ttl)&&void 0!==r?r:36e5)},n=JSON.stringify(i);await this.storage.set(e,n),(null==a?void 0:a.useSecondaryCache)&&this.secondaryCache&&await this.secondaryCache.set(e,t,a)}async delete(e){e=this.addPrefix(e),await this.storage.delete(e)}async clear(){await this.storage.clear()}addPrefix(e){return e.startsWith("Z_CACHE_")?e:"Z_CACHE_"+e}deserialize(e){switch(e.type){case"number":return Number(e.value);case"boolean":return Boolean(e.value);case"object":return e.value;case"date":case"datetime":const t=new Date(e.value);return isNaN(t.getTime())?(logger_1.default.error(`Invalid ${e.type} string:`,e.value),null):t;default:return String(e.value)}}}exports.CacheService=CacheService,__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[String,Object]),__metadata("design:returntype",Promise)],CacheService.prototype,"get",null),__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[String,Object,Object]),__metadata("design:returntype",Promise)],CacheService.prototype,"set",null);
+"use strict";var __decorate=this&&this.__decorate||function(e,t,r,a){var i,n=arguments.length,o=n<3?t:null===a?a=Object.getOwnPropertyDescriptor(t,r):a;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)o=Reflect.decorate(e,t,r,a);else for(var s=e.length-1;s>=0;s--)(i=e[s])&&(o=(n<3?i(o):n>3?i(t,r,o):i(t,r))||o);return n>3&&o&&Object.defineProperty(t,r,o),o},__metadata=this&&this.__metadata||function(e,t){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)},__awaiter=this&&this.__awaiter||function(e,t,r,a){return new(r||(r=Promise))((function(i,n){function o(e){try{c(a.next(e))}catch(e){n(e)}}function s(e){try{c(a.throw(e))}catch(e){n(e)}}function c(e){var t;e.done?i(e.value):(t=e.value,t instanceof r?t:new r((function(e){e(t)}))).then(o,s)}c((a=a.apply(e,t||[])).next())}))},__importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.CacheService=void 0;const logging_1=require("../../logging"),logger_1=__importDefault(require("../../logging/logger")),KEY_PREFIX="Z_CACHE_",DEFAULT_TTL=36e5;class CacheService{constructor(e){this.storage=e}setSecondaryCache(e){this.secondaryCache=e}get(e,t){return __awaiter(this,void 0,void 0,(function*(){e=this.addPrefix(e);const r=yield this.storage.get(e);if(r)try{const t=JSON.parse(r);return t.expiresAt&&Date.now()>t.expiresAt?(yield this.delete(e),null):this.deserialize(t)}catch(e){return logger_1.default.error("Cache deserialization failed:",e),null}if((null==t?void 0:t.useSecondaryCache)&&this.secondaryCache){const r=yield this.secondaryCache.get(e,t);return null!==r&&(yield this.set(e,r,{ttl:null==t?void 0:t.ttl})),r}return null}))}set(e,t,r){return __awaiter(this,void 0,void 0,(function*(){var a;e=this.addPrefix(e);const i={type:t instanceof Date?"date":typeof t,value:t,expiresAt:Date.now()+(null!==(a=null==r?void 0:r.ttl)&&void 0!==a?a:36e5)},n=JSON.stringify(i);yield this.storage.set(e,n),(null==r?void 0:r.useSecondaryCache)&&this.secondaryCache&&(yield this.secondaryCache.set(e,t,r))}))}delete(e){return __awaiter(this,void 0,void 0,(function*(){e=this.addPrefix(e),yield this.storage.delete(e)}))}clear(){return __awaiter(this,void 0,void 0,(function*(){yield this.storage.clear()}))}addPrefix(e){return e.startsWith("Z_CACHE_")?e:"Z_CACHE_"+e}deserialize(e){switch(e.type){case"number":return Number(e.value);case"boolean":return Boolean(e.value);case"object":return e.value;case"date":case"datetime":const t=new Date(e.value);return isNaN(t.getTime())?(logger_1.default.error(`Invalid ${e.type} string:`,e.value),null):t;default:return String(e.value)}}}exports.CacheService=CacheService,__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[String,Object]),__metadata("design:returntype",Promise)],CacheService.prototype,"get",null),__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[String,Object,Object]),__metadata("design:returntype",Promise)],CacheService.prototype,"set",null);

package/dist/services/cache/storage/config-var-cache-storage.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.ConfigVarCacheStorage=void 0;const config_var_constants_1=require("../../../constants/config-var-constants");class ConfigVarCacheStorage{constructor(e){this.configVarClient=e}async set(e,t){try{await this.configVarClient.create({key:e,value:t,configType:config_var_constants_1.ConfigVariableType.PLAIN_TEXT})}catch(a){await this.configVarClient.update({key:e,value:t,configType:config_var_constants_1.ConfigVariableType.PLAIN_TEXT})}}async get(e){var t;try{const t=await this.configVarClient.get(e);if(t)return t.value}catch(e){if(null===(t=null==e?void 0:e.message)||void 0===t?void 0:t.includes("not_found"))return null;throw e}return null}async delete(e){await this.configVarClient.delete(e)}async clear(){throw new Error("Clear operation is not supported by ConfigVarCacheStorage")}}exports.ConfigVarCacheStorage=ConfigVarCacheStorage;
+"use strict";var __awaiter=this&&this.__awaiter||function(t,e,n,i){return new(n||(n=Promise))((function(o,r){function a(t){try{s(i.next(t))}catch(t){r(t)}}function c(t){try{s(i.throw(t))}catch(t){r(t)}}function s(t){var e;t.done?o(t.value):(e=t.value,e instanceof n?e:new n((function(t){t(e)}))).then(a,c)}s((i=i.apply(t,e||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.ConfigVarCacheStorage=void 0;const config_var_constants_1=require("../../../constants/config-var-constants");class ConfigVarCacheStorage{constructor(t){this.configVarClient=t}set(t,e){return __awaiter(this,void 0,void 0,(function*(){try{yield this.configVarClient.create({key:t,value:e,configType:config_var_constants_1.ConfigVariableType.PLAIN_TEXT})}catch(n){yield this.configVarClient.update({key:t,value:e,configType:config_var_constants_1.ConfigVariableType.PLAIN_TEXT})}}))}get(t){return __awaiter(this,void 0,void 0,(function*(){var e;try{const e=yield this.configVarClient.get(t);if(e)return e.value}catch(t){if(null===(e=null==t?void 0:t.message)||void 0===e?void 0:e.includes("not_found"))return null;throw t}return null}))}delete(t){return __awaiter(this,void 0,void 0,(function*(){yield this.configVarClient.delete(t)}))}clear(){return __awaiter(this,void 0,void 0,(function*(){throw new Error("Clear operation is not supported by ConfigVarCacheStorage")}))}}exports.ConfigVarCacheStorage=ConfigVarCacheStorage;

package/dist/services/cache/storage/in-memory-cache-storage.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.InMemoryCacheStorage=void 0;class InMemoryCacheStorage{constructor(){this.cache=new Map}async set(e,c){this.cache.set(e,c)}async get(e){const c=this.cache.get(e);return c||null}async delete(e){this.cache.delete(e)}async clear(){this.cache.clear()}}exports.InMemoryCacheStorage=InMemoryCacheStorage;
+"use strict";var __awaiter=this&&this.__awaiter||function(e,t,n,r){return new(n||(n=Promise))((function(i,o){function a(e){try{s(r.next(e))}catch(e){o(e)}}function c(e){try{s(r.throw(e))}catch(e){o(e)}}function s(e){var t;e.done?i(e.value):(t=e.value,t instanceof n?t:new n((function(e){e(t)}))).then(a,c)}s((r=r.apply(e,t||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.InMemoryCacheStorage=void 0;class InMemoryCacheStorage{constructor(){this.cache=new Map}set(e,t){return __awaiter(this,void 0,void 0,(function*(){this.cache.set(e,t)}))}get(e){return __awaiter(this,void 0,void 0,(function*(){const t=this.cache.get(e);return t||null}))}delete(e){return __awaiter(this,void 0,void 0,(function*(){this.cache.delete(e)}))}clear(){return __awaiter(this,void 0,void 0,(function*(){this.cache.clear()}))}}exports.InMemoryCacheStorage=InMemoryCacheStorage;

package/dist/services/geoservice.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.GeoService=void 0;const uuid_1=require("uuid");class GeoService{constructor(e){this.sessionId="",this.geoAPIClient=e,this.sessionId=this.generateNewSessionId()}async getDistanceMatrix(e,t){const s=e.map((e=>({lat:parseFloat(this.stripTrailingZeros(e.lat)),lng:parseFloat(this.stripTrailingZeros(e.lng))}))),i=t.map((e=>({lat:parseFloat(this.stripTrailingZeros(e.lat)),lng:parseFloat(this.stripTrailingZeros(e.lng))}))),r=await this.geoAPIClient.getDistanceMatrix({origins:s,destinations:i});if(!r||!r.matrix||0===r.matrix.length)throw new Error("Failed to retrieve distance matrix data");const n=new Map;for(let o=0;o<e.length;o++)for(let e=0;e<t.length;e++){const t=this.createKey(s[o],i[e]),a=r.matrix[o][e];n.set(t,a)}return n}async getAddressSuggestions(e,t=1){const s=e.sessionId||this.sessionId;e.sessionId||(e.sessionId=this.sessionId);const i=await this.geoAPIClient.autocompleteAddress(e);if(0===i.predictions.length)return null;const r=i.predictions.slice(0,t);return Promise.all(r.map((e=>this.geoAPIClient.getPlaceDetails({placeId:e.placeId,sessionId:s}))))}async getTimezone(e){return(await this.geoAPIClient.getTimezone(e)).timeZoneId}generateNewSessionId(){return(0,uuid_1.v4)()}stripTrailingZeros(e){return parseFloat(e.toFixed(8)).toString()}createKey(e,t){return`${this.stripTrailingZeros(e.lat)},${this.stripTrailingZeros(e.lng)}-${this.stripTrailingZeros(t.lat)},${this.stripTrailingZeros(t.lng)}`}}exports.GeoService=GeoService;
+"use strict";var __awaiter=this&&this.__awaiter||function(e,t,i,s){return new(i||(i=Promise))((function(r,n){function o(e){try{l(s.next(e))}catch(e){n(e)}}function a(e){try{l(s.throw(e))}catch(e){n(e)}}function l(e){var t;e.done?r(e.value):(t=e.value,t instanceof i?t:new i((function(e){e(t)}))).then(o,a)}l((s=s.apply(e,t||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.GeoService=void 0;const uuid_1=require("uuid");class GeoService{constructor(e){this.sessionId="",this.geoAPIClient=e,this.sessionId=this.generateNewSessionId()}getDistanceMatrix(e,t){return __awaiter(this,void 0,void 0,(function*(){const i=e.map((e=>({lat:parseFloat(this.stripTrailingZeros(e.lat)),lng:parseFloat(this.stripTrailingZeros(e.lng))}))),s=t.map((e=>({lat:parseFloat(this.stripTrailingZeros(e.lat)),lng:parseFloat(this.stripTrailingZeros(e.lng))}))),r=yield this.geoAPIClient.getDistanceMatrix({origins:i,destinations:s});if(!r||!r.matrix||0===r.matrix.length)throw new Error("Failed to retrieve distance matrix data");const n=new Map;for(let o=0;o<e.length;o++)for(let e=0;e<t.length;e++){const t=this.createKey(i[o],s[e]),a=r.matrix[o][e];n.set(t,a)}return n}))}getAddressSuggestions(e){return __awaiter(this,arguments,void 0,(function*(e,t=1){const i=e.sessionId||this.sessionId;e.sessionId||(e.sessionId=this.sessionId);const s=yield this.geoAPIClient.autocompleteAddress(e);if(0===s.predictions.length)return null;const r=s.predictions.slice(0,t);return Promise.all(r.map((e=>this.geoAPIClient.getPlaceDetails({placeId:e.placeId,sessionId:i}))))}))}getTimezone(e){return __awaiter(this,void 0,void 0,(function*(){return(yield this.geoAPIClient.getTimezone(e)).timeZoneId}))}generateNewSessionId(){return(0,uuid_1.v4)()}stripTrailingZeros(e){return parseFloat(e.toFixed(8)).toString()}createKey(e,t){return`${this.stripTrailingZeros(e.lat)},${this.stripTrailingZeros(e.lng)}-${this.stripTrailingZeros(t.lat)},${this.stripTrailingZeros(t.lng)}`}}exports.GeoService=GeoService;

package/dist/services/graph-batch/graph-batch.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.GraphBatch=void 0;const graph_batch_config_1=require("./configs/graph-batch-config"),pagination_strategy_1=require("./pagination-strategy");class GraphBatch{constructor(t,e){this.startTime=new Date,this.context=t,this.config=(0,graph_batch_config_1.initializeConfig)(e),this.startTime=new Date}async run(){var t,e;if(this.queryBuilder=await this.start(),!this.queryBuilder)throw new Error("Query builder was not defined in start().");this.queryBuilder.withLimit(this.config.batchSize);let i=0,s=!0;for(;s&&!this.isMaxBatchesReached(i)&&(this.queryResult=await this.fetchNextPage(),this.queryResult.records&&0!==this.queryResult.records.length);)await this.execute(this.queryResult.records),i++,this.config.delaySeconds&&!this.isMaxBatchesReached(i)&&await this.delay(1e3*this.config.delaySeconds),s=null!==(e=null===(t=this.queryResult.pageInfo)||void 0===t?void 0:t.hasNextPage)&&void 0!==e&&e;await this.finish()}async finish(){this.context.logger.info("Batch process completed.")}async fetchNextPage(){var t,e,i;switch(this.config.strategy){case pagination_strategy_1.PaginationStrategy.OFFSET:this.queryResult&&(null===(t=this.queryBuilder)||void 0===t||t.withOffset(this.queryResult.endOffset+1));break;case pagination_strategy_1.PaginationStrategy.CURSOR:this.queryResult&&(null===(e=this.queryBuilder)||void 0===e||e.withCursor(this.queryResult.endCursor));break;case pagination_strategy_1.PaginationStrategy.NONE:default:null===(i=this.queryBuilder)||void 0===i||i.withFilter(`LastModifiedDate < ${this.startTime.toISOString()}`)}return this.queryBuilder.execute()}isMaxBatchesReached(t){return!!this.config.maxBatches&&t>=this.config.maxBatches}async delay(t){return new Promise((e=>setTimeout(e,t)))}}exports.GraphBatch=GraphBatch;
+"use strict";var __awaiter=this&&this.__awaiter||function(t,e,i,r){return new(i||(i=Promise))((function(a,s){function n(t){try{o(r.next(t))}catch(t){s(t)}}function h(t){try{o(r.throw(t))}catch(t){s(t)}}function o(t){var e;t.done?a(t.value):(e=t.value,e instanceof i?e:new i((function(t){t(e)}))).then(n,h)}o((r=r.apply(t,e||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.GraphBatch=void 0;const graph_batch_config_1=require("./configs/graph-batch-config"),pagination_strategy_1=require("./pagination-strategy");class GraphBatch{constructor(t,e){this.startTime=new Date,this.context=t,this.config=(0,graph_batch_config_1.initializeConfig)(e),this.startTime=new Date}run(){return __awaiter(this,void 0,void 0,(function*(){var t,e;if(this.queryBuilder=yield this.start(),!this.queryBuilder)throw new Error("Query builder was not defined in start().");this.queryBuilder.withLimit(this.config.batchSize);let i=0,r=!0;for(;r&&!this.isMaxBatchesReached(i)&&(this.queryResult=yield this.fetchNextPage(),this.queryResult.records&&0!==this.queryResult.records.length);)yield this.execute(this.queryResult.records),i++,this.config.delaySeconds&&!this.isMaxBatchesReached(i)&&(yield this.delay(1e3*this.config.delaySeconds)),r=null!==(e=null===(t=this.queryResult.pageInfo)||void 0===t?void 0:t.hasNextPage)&&void 0!==e&&e;yield this.finish()}))}finish(){return __awaiter(this,void 0,void 0,(function*(){this.context.logger.info("Batch process completed.")}))}fetchNextPage(){return __awaiter(this,void 0,void 0,(function*(){var t,e,i;switch(this.config.strategy){case pagination_strategy_1.PaginationStrategy.OFFSET:this.queryResult&&(null===(t=this.queryBuilder)||void 0===t||t.withOffset(this.queryResult.endOffset+1));break;case pagination_strategy_1.PaginationStrategy.CURSOR:this.queryResult&&(null===(e=this.queryBuilder)||void 0===e||e.withCursor(this.queryResult.endCursor));break;case pagination_strategy_1.PaginationStrategy.NONE:default:null===(i=this.queryBuilder)||void 0===i||i.withFilter(`LastModifiedDate < ${this.startTime.toISOString()}`)}return this.queryBuilder.execute()}))}isMaxBatchesReached(t){return!!this.config.maxBatches&&t>=this.config.maxBatches}delay(t){return __awaiter(this,void 0,void 0,(function*(){return new Promise((e=>setTimeout(e,t)))}))}}exports.GraphBatch=GraphBatch;

package/dist/services/graph-batch/unique-graph-batch.js

@@ -1 +1 @@
-"use strict";var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.UniqueGraphBatch=void 0;const logger_1=__importDefault(require("../../logging/logger")),graph_batch_1=require("./graph-batch");class UniqueGraphBatch extends graph_batch_1.GraphBatch{constructor(e,t){super(e,t),this.name=(null==t?void 0:t.name)||this.constructor.name,this.name=this.name.toUpperCase().replace(/[^A-Z0-9]/g,"_"),this.lockTtl=(null==t?void 0:t.lockTtl)||96e4}async run(){const e={name:this.name,ttl:this.lockTtl,description:`Lock for batch process: ${this.name}`};try{if(!await this.context.lockService.acquireLock(e))return void logger_1.default.error(`A batch with name '${this.name}' is already running.`);await super.run()}catch(e){logger_1.default.error(`Error running batch with name '${this.name}': ${e.message}`)}finally{await this.context.lockService.releaseLock(this.name)}}async start(){throw new Error("Subclasses must implement the 'start' method.")}async execute(e){throw new Error("Subclasses must implement the 'execute' method.")}async finish(){await super.finish()}}exports.UniqueGraphBatch=UniqueGraphBatch;
+"use strict";var __awaiter=this&&this.__awaiter||function(t,e,r,i){return new(r||(r=Promise))((function(n,a){function o(t){try{s(i.next(t))}catch(t){a(t)}}function c(t){try{s(i.throw(t))}catch(t){a(t)}}function s(t){var e;t.done?n(t.value):(e=t.value,e instanceof r?e:new r((function(t){t(e)}))).then(o,c)}s((i=i.apply(t,e||[])).next())}))},__importDefault=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.UniqueGraphBatch=void 0;const logger_1=__importDefault(require("../../logging/logger")),graph_batch_1=require("./graph-batch");class UniqueGraphBatch extends graph_batch_1.GraphBatch{constructor(t,e){super(t,e),this.name=(null==e?void 0:e.name)||this.constructor.name,this.name=this.name.toUpperCase().replace(/[^A-Z0-9]/g,"_"),this.lockTtl=(null==e?void 0:e.lockTtl)||96e4}run(){const t=Object.create(null,{run:{get:()=>super.run}});return __awaiter(this,void 0,void 0,(function*(){const e={name:this.name,ttl:this.lockTtl,description:`Lock for batch process: ${this.name}`};try{if(!(yield this.context.lockService.acquireLock(e)))return void logger_1.default.error(`A batch with name '${this.name}' is already running.`);yield t.run.call(this)}catch(t){logger_1.default.error(`Error running batch with name '${this.name}': ${t.message}`)}finally{yield this.context.lockService.releaseLock(this.name)}}))}start(){return __awaiter(this,void 0,void 0,(function*(){throw new Error("Subclasses must implement the 'start' method.")}))}execute(t){return __awaiter(this,void 0,void 0,(function*(){throw new Error("Subclasses must implement the 'execute' method.")}))}finish(){const t=Object.create(null,{finish:{get:()=>super.finish}});return __awaiter(this,void 0,void 0,(function*(){yield t.finish.call(this)}))}}exports.UniqueGraphBatch=UniqueGraphBatch;

package/dist/services/graphql/graphql-batch-builder.d.ts

@@ -0,0 +1,138 @@
+import { GraphQLService } from "./graphql-service";
+import { GraphqlQueryParams, QueryResult, MutationResult } from "../../interfaces/graphql";
+/**
+ * A utility class for building GraphQL queries or mutations dynamically.
+ */
+export declare class GraphQLQueryBuilder {
+    private objectName;
+    operationName: string;
+    private operationType;
+    private fields;
+    private filters;
+    private input;
+    private first?;
+    private offset?;
+    private orderBy?;
+    private after?;
+    private parentQueries;
+    private childQueries;
+    private isParent;
+    private graphqlService;
+    private queryParams;
+    /**
+     * Creates an instance of GraphQLQueryBuilder.
+     * @param queryParams - The parameters for the query or mutation.
+     * @param isParent - Indicates if this is a parent query.
+     */
+    constructor(queryParams: GraphqlQueryParams, isParent?: boolean);
+    /**
+     * Sets the GraphQL service to use for executing the operation.
+     * @param graphqlService - The GraphQL service instance.
+     * @returns The query builder instance for chaining.
+     */
+    setGraphqlService(graphqlService: GraphQLService): this;
+    /**
+     * Specifies the fields to be retrieved. Prevents duplicates.
+     * @param fields - Array of field names to include.
+     * @returns The query builder instance for chaining.
+     */
+    withFields(fields: string[]): this;
+    /**
+     * Adds a filter condition to the query.
+     * @param condition - The filter condition string.
+     * @returns The query builder instance for chaining.
+     * @throws Error if applied to a mutation or parent query.
+     */
+    withFilter(condition: string): this;
+    /**
+     * Sets the input object for a mutation.
+     * @param input - The mutation input object.
+     * @returns The query builder instance for chaining.
+     * @throws Error if applied to a query.
+     */
+    withInput(input: Record<string, any>): this;
+    /**
+     * Sets a limit on the number of records to retrieve.
+     * @param first - The maximum number of records.
+     * @returns The query builder instance for chaining.
+     * @throws Error if applied to a mutation or parent query.
+     */
+    withLimit(first: number): this;
+    /**
+     * Sets an offset for pagination.
+     * @param offset - The number of records to skip.
+     * @returns The query builder instance for chaining.
+     * @throws Error if applied to a mutation or parent query.
+     */
+    withOffset(offset: number): this;
+    /**
+     * Sets the order in which records should be retrieved.
+     * @param orderBy - The field to order by.
+     * @returns The query builder instance for chaining.
+     * @throws Error if applied to a mutation or parent query.
+     */
+    withOrderBy(orderBy: string): this;
+    /**
+     * Applies cursor-based pagination.
+     * @param after - The cursor to paginate after.
+     * @returns The query builder instance for chaining.
+     * @throws Error if applied to a mutation or parent query.
+     */
+    withCursor(after: string): this;
+    /**
+     * Creates a parent query.
+     * @param objectName - The name of the parent object.
+     * @returns The parent query builder instance.
+     */
+    withParentQuery(objectName: string): GraphQLQueryBuilder;
+    /**
+     * Creates a child query.
+     * @param objectName - The name of the child object.
+     * @returns The child query builder instance.
+     */
+    withChildQuery(objectName: string): GraphQLQueryBuilder;
+    /**
+     * Recursively builds the GraphQL query fields, handling nested queries.
+     * @returns The formatted fields string.
+     */
+    private formatQueryFields;
+    /**
+     * Builds the GraphQL operation parameters.
+     * @returns The structured query or mutation parameters.
+     */
+    build(): GraphqlQueryParams;
+    /**
+     * Executes the query or mutation.
+     * @returns A promise resolving to the operation result.
+     * @throws Error if no GraphQL service is set.
+     */
+    execute(): Promise<QueryResult | MutationResult>;
+    /**
+     * Generates a string representation of the GraphQL operation for debugging.
+     * @returns The formatted operation string.
+     */
+    toString(): string;
+}
+/**
+ * A utility class for building and executing a batch of GraphQL queries and mutations.
+ */
+export declare class GraphQLBatchBuilder {
+    private operations;
+    /**
+     * Adds a query or mutation to the batch.
+     * @param builder - The GraphQLQueryBuilder instance for the query or mutation.
+     * @returns The batch builder instance for chaining.
+     */
+    add(builder: GraphQLQueryBuilder): this;
+    /**
+     * Executes the batch of queries and mutations.
+     * @returns A promise resolving to an array of query or mutation results.
+     * @throws Error if no operations are added or if GraphQL service is missing.
+     */
+    execute(): Promise<(QueryResult | MutationResult)[]>;
+    /**
+     * Generates a string representation of the batch for debugging.
+     * @returns A string containing all operations in the batch.
+     */
+    toString(): string;
+}

package/dist/services/graphql/graphql-batch-builder.js

@@ -0,0 +1 @@
+"use strict";var __awaiter=this&&this.__awaiter||function(t,e,r,i){return new(r||(r=Promise))((function(o,s){function n(t){try{h(i.next(t))}catch(t){s(t)}}function a(t){try{h(i.throw(t))}catch(t){s(t)}}function h(t){var e;t.done?o(t.value):(e=t.value,e instanceof r?e:new r((function(t){t(e)}))).then(n,a)}h((i=i.apply(t,e||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.GraphQLBatchBuilder=exports.GraphQLQueryBuilder=void 0;const graphql_1=require("../../interfaces/graphql");class GraphQLQueryBuilder{constructor(t,e=!1){if(this.fields=new Set(["UID"]),this.filters=[],this.input=null,this.parentQueries={},this.childQueries={},this.graphqlService=null,!t.objectName||!t.operationName)throw new Error("objectName and operationName are required.");this.queryParams=t,this.objectName=t.objectName.charAt(0).toLowerCase()+t.objectName.slice(1),this.operationName=t.operationName,this.operationType=t.operationType||"query",this.isParent=e}setGraphqlService(t){return this.graphqlService=t,this}withFields(t){return t.forEach((t=>this.fields.add(t))),this}withFilter(t){if("mutation"===this.operationType)throw new Error("Cannot apply filters to a mutation.");if(this.isParent)throw new Error(`Cannot apply filters to parent query for object: ${this.objectName}`);return this.filters.push(t),this}withInput(t){if("query"===this.operationType)throw new Error("Cannot apply input to a query.");if(!t||0===Object.keys(t).length)throw new Error("Mutation input cannot be empty.");return this.input=t,this}withLimit(t){if("mutation"===this.operationType)throw new Error("Cannot apply limit to a mutation.");if(this.isParent)throw new Error(`Cannot apply limit to parent query for object: ${this.objectName}`);return this.first=t,this}withOffset(t){if("mutation"===this.operationType)throw new Error("Cannot apply offset to a mutation.");if(this.isParent)throw new Error(`Cannot apply offset to parent query for object: ${this.objectName}`);return this.offset=t,this}withOrderBy(t){if("mutation"===this.operationType)throw new Error("Cannot apply orderBy to a mutation.");if(this.isParent)throw new Error(`Cannot apply orderBy to parent query for object: ${this.objectName}`);return this.orderBy=t,this}withCursor(t){if("mutation"===this.operationType)throw new Error("Cannot apply cursor to a mutation.");if(this.isParent)throw new Error(`Cannot apply cursor to parent query for object: ${this.objectName}`);return this.after=t,this}withParentQuery(t){const e=new GraphQLQueryBuilder({objectName:t,operationName:this.operationName,operationType:this.operationType},!0);return this.parentQueries[t]=e,e}withChildQuery(t){const e=new GraphQLQueryBuilder({objectName:t,operationName:this.operationName,operationType:this.operationType});return this.childQueries[t]=e,e}formatQueryFields(){const t=[...this.fields];for(const[e,r]of Object.entries(this.parentQueries))t.push(`${e} { ${r.formatQueryFields()} }`);for(const[e,r]of Object.entries(this.childQueries)){const i=r.build(),o=i.filter?`(filter: "${i.filter}")`:"";t.push(`${e} ${o} { ${i.fields||"UID"} }`)}return t.filter(Boolean).join(", ")}build(){const t={objectName:this.objectName,operationName:this.operationName,operationType:this.operationType,fields:this.formatQueryFields(),readOnly:this.queryParams.readOnly};return"query"===this.operationType?(t.filter=this.filters.length>0?this.filters.join(" AND "):void 0,t.first=this.first,t.offset=this.offset,t.orderBy=this.orderBy,t.after=this.after):t.input=this.input||void 0,t}execute(){var t;if(!this.graphqlService)throw new Error(`No GraphQL service set for ${this.operationType} execution on ${this.objectName}.`);const e=this.build();if("mutation"===this.operationType){const r={objectName:this.objectName,operationName:this.operationName,operation:(null===(t=this.input)||void 0===t?void 0:t.operation)||graphql_1.GraphqlOperations.UPDATE,records:this.input?[this.input]:[],fields:e.fields?e.fields.split(", "):["UID"]};return this.graphqlService.mutate(r)}return this.graphqlService.query(e)}toString(){const t=[];"query"===this.operationType?(this.first&&t.push(`first: ${this.first}`),this.offset&&t.push(`offset: ${this.offset}`),this.orderBy&&t.push(`orderBy: "${this.orderBy}"`),this.after&&t.push(`after: "${this.after}"`),this.filters.length&&t.push(`filter: "${this.filters.join(" AND ")}"`)):this.input&&t.push(`input: ${JSON.stringify(this.input)}`);const e=t.length?`(${t.join(", ")})`:"";return`${this.operationType} ${this.operationName} { ${this.objectName}${e} { ${this.formatQueryFields()} } }`}}exports.GraphQLQueryBuilder=GraphQLQueryBuilder;class GraphQLBatchBuilder{constructor(){this.operations=[]}add(t){return this.operations.push(t),this}execute(){return __awaiter(this,void 0,void 0,(function*(){if(!this.operations.length)return[];const t=this.operations[0].graphqlService;if(!t)throw new Error("No GraphQL service set for batch execution.");if(this.operations.some((e=>e.graphqlService!==t)))throw new Error("All operations must use the same GraphQL service.");const e=this.operations.map((t=>t.build()));return t.executeBatch(e)}))}toString(){return this.operations.map((t=>t.toString())).join("\n")}}exports.GraphQLBatchBuilder=GraphQLBatchBuilder;

package/dist/services/graphql/graphql-query-batch.d.ts

@@ -0,0 +1,10 @@
+import { QueryResult } from "../../interfaces";
+import { GraphQLQueryBuilder } from "./graphql-query-builder";
+export declare class GraphQLQueryBatch {
+    /**
+     * Executes a batch of queries.
+     * @param {GraphQLQueryBuilder[]} builders - Array of query builders.
+     * @returns {Promise<QueryResult[]>} - Array of query results.
+     */
+    execute(builders: GraphQLQueryBuilder[]): Promise<QueryResult[]>;
+}

package/dist/services/graphql/graphql-query-batch.js

@@ -0,0 +1 @@
+"use strict";var __awaiter=this&&this.__awaiter||function(t,e,r,n){return new(r||(r=Promise))((function(a,c){function i(t){try{u(n.next(t))}catch(t){c(t)}}function o(t){try{u(n.throw(t))}catch(t){c(t)}}function u(t){var e;t.done?a(t.value):(e=t.value,e instanceof r?e:new r((function(t){t(e)}))).then(i,o)}u((n=n.apply(t,e||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.GraphQLQueryBatch=void 0;class GraphQLQueryBatch{execute(t){return __awaiter(this,void 0,void 0,(function*(){if(!t.length)return[];const e=t[0].graphqlService;if(!e)throw new Error("No GraphQL service set for batch execution.");const r=t.map((t=>t.build()));return e.queryBatch(r)}))}}exports.GraphQLQueryBatch=GraphQLQueryBatch;

package/dist/services/graphql/graphql-query-builder.d.ts

@@ -19,7 +19,7 @@ export declare class GraphQLQueryBuilder {
     private queryParams;
     /**
      * Creates an instance of GraphQLQueryBuilder.
-     * @param {string} graphqlQueryParams - The necessary parameters for the query.
+     * @param {GraphqlQueryParams} queryParams - The parameters for the query.
      * @param {boolean} [isParent=false] - Indicates if this query is a parent query.
      */
     constructor(queryParams: GraphqlQueryParams, isParent?: boolean);
@@ -64,13 +64,21 @@ export declare class GraphQLQueryBuilder {
      */
     private formatQueryFields;
     /**
-     * Builds the GraphQL query parameters in a more structured format.
+     * Builds the GraphQL query parameters in a structured format.
      */
     build(): GraphqlQueryParams;
     /**
-     * Executes the query using the GraphQL service, with improved error handling.
+     * Executes the query using the GraphQL service.
      */
     execute(): Promise<QueryResult>;
+    /**
+     * Executes all queries for the configured object, fetching records from the specified page range, up to a maximum of 20 pages.
+     * @param {number} [fromPage=1] - The starting page number (1-based, defaults to 1).
+     * @param {number} [toPage=20] - The ending page number (defaults to 20, capped at 20).
+     * @returns {Promise<QueryResult>} - A query result containing all records in the page range and pagination info.
+     * @throws {Error} - If the query execution fails, no GraphQL service is set, or invalid page parameters are provided.
+     */
+    executeAll(fromPage?: number, toPage?: number): Promise<QueryResult>;
     /**
      * Generates a string representation of the GraphQL query for debugging.
      */

package/dist/services/graphql/graphql-query-builder.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.GraphQLQueryBuilder=void 0;class GraphQLQueryBuilder{constructor(e,r=!1){this.fields=new Set(["UID"]),this.filters=[],this.parentQueries={},this.childQueries={},this.graphqlService=null,this.queryParams=e,this.objectName=e.objectName.charAt(0).toLowerCase()+e.objectName.slice(1),this.operationName=e.operationName,this.isParent=r}setGraphqlService(e){this.graphqlService=e}withFields(e){return e.forEach((e=>this.fields.add(e))),this}withFilter(e){if(this.isParent)throw new Error("Cannot apply filters to a parent query.");return this.filters.push(e),this}withLimit(e){if(this.isParent)throw new Error("Cannot apply limit to a parent query.");return this.first=e,this}withOffset(e){if(this.isParent)throw new Error("Cannot apply offset to a parent query.");return this.offset=e,this}withOrderBy(e){if(this.isParent)throw new Error("Cannot apply orderBy to a parent query.");return this.orderBy=e,this}withCursor(e){if(this.isParent)throw new Error("Cannot apply cursor to a parent query.");return this.after=e,this}withParentQuery(e){const r=new GraphQLQueryBuilder({objectName:e,operationName:this.operationName},!0);return this.parentQueries[e]=r,r}withChildQuery(e){const r=new GraphQLQueryBuilder({objectName:e,operationName:this.operationName});return this.childQueries[e]=r,r}formatQueryFields(){const e=Object.entries(this.parentQueries).map((([e,r])=>`${e} { ${r.formatQueryFields()} }`)).join(", "),r=Object.entries(this.childQueries).map((([e,r])=>{const t=r.build();return`${e} ${t.filter?`(filter: "${t.filter}")`:""} { ${t.fields} }`})).join(", ");return[...this.fields,e,r].filter(Boolean).join(", ")}build(){return{objectName:this.objectName,operationName:this.operationName,fields:this.formatQueryFields(),filter:this.filters.length>0?this.filters.join(" AND "):void 0,first:this.first,offset:this.offset,orderBy:this.orderBy,after:this.after}}execute(){if(!this.graphqlService)return Promise.reject(new Error("No GraphQL service set for query execution."));const e=this.build();return e.readOnly=this.queryParams.readOnly,this.graphqlService.query(e)}toString(){return`{ ${this.objectName} { ${this.formatQueryFields()} } }`}}exports.GraphQLQueryBuilder=GraphQLQueryBuilder;
+"use strict";var __awaiter=this&&this.__awaiter||function(e,t,r,i){return new(r||(r=Promise))((function(s,a){function o(e){try{h(i.next(e))}catch(e){a(e)}}function n(e){try{h(i.throw(e))}catch(e){a(e)}}function h(e){var t;e.done?s(e.value):(t=e.value,t instanceof r?t:new r((function(e){e(t)}))).then(o,n)}h((i=i.apply(e,t||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.GraphQLQueryBuilder=void 0;class GraphQLQueryBuilder{constructor(e,t=!1){this.fields=new Set(["UID"]),this.filters=[],this.parentQueries={},this.childQueries={},this.graphqlService=null,this.queryParams=e,this.objectName=e.objectName.charAt(0).toLowerCase()+e.objectName.slice(1),this.operationName=e.operationName,this.isParent=t}setGraphqlService(e){this.graphqlService=e}withFields(e){return e.forEach((e=>this.fields.add(e))),this}withFilter(e){if(this.isParent)throw new Error("Cannot apply filters to a parent query.");return this.filters.push(e),this}withLimit(e){if(this.isParent)throw new Error("Cannot apply limit to a parent query.");return this.first=e,this}withOffset(e){if(this.isParent)throw new Error("Cannot apply offset to a parent query.");return this.offset=e,this}withOrderBy(e){if(this.isParent)throw new Error("Cannot apply orderBy to a parent query.");return this.orderBy=e,this}withCursor(e){if(this.isParent)throw new Error("Cannot apply cursor to a parent query.");return this.after=e,this}withParentQuery(e){const t=new GraphQLQueryBuilder({objectName:e,operationName:this.operationName},!0);return this.parentQueries[e]=t,t}withChildQuery(e){const t=new GraphQLQueryBuilder({objectName:e,operationName:this.operationName});return this.childQueries[e]=t,t}formatQueryFields(){const e=Object.entries(this.parentQueries).map((([e,t])=>`${e} { ${t.formatQueryFields()} }`)).join(", "),t=Object.entries(this.childQueries).map((([e,t])=>{const r=t.build();return`${e} ${r.filter?`(filter: "${r.filter}")`:""} { ${r.fields||"UID"} }`})).join(", ");return[...this.fields,e,t].filter(Boolean).join(", ")}build(){return{objectName:this.objectName,operationName:this.operationName,fields:this.formatQueryFields(),filter:this.filters.length>0?this.filters.join(" AND "):void 0,first:this.first,offset:this.offset,orderBy:this.orderBy,after:this.after,readOnly:this.queryParams.readOnly}}execute(){if(!this.graphqlService)return Promise.reject(new Error("No GraphQL service set for query execution."));const e=this.build();return e.readOnly=this.queryParams.readOnly,this.graphqlService.query(e)}executeAll(){return __awaiter(this,arguments,void 0,(function*(e=1,t=20){if(!this.graphqlService)throw new Error("No GraphQL service set for query execution.");if(e<1)throw new Error("fromPage must be at least 1.");if(t<e)throw new Error("toPage must be greater than or equal to fromPage.");const r=Math.min(t,20),i=this.build(),s=yield this.graphqlService.query(i),a=s.totalCount;if(0===a)return{records:[],totalCount:0,pageInfo:{hasNextPage:!1},endCursor:"",endOffset:0};const o=this.first||200,n=Math.ceil(a/o),h=Math.min(r,n);if(0===Math.max(0,h-e+1))return{records:[],totalCount:a,pageInfo:{hasNextPage:h<n},endCursor:"",endOffset:(e-1)*o};const u=[];for(let t=e-1;t<h;t++){const e=new GraphQLQueryBuilder({objectName:this.objectName,operationName:this.operationName,readOnly:this.queryParams.readOnly});e.setGraphqlService(this.graphqlService),e.fields=new Set(this.fields),e.filters=[...this.filters],e.first=o,e.offset=t*o,e.orderBy=this.orderBy,e.after=this.after,u.push(e)}const l=yield this.graphqlService.queryBatch(u),f=l.flatMap((e=>e.records)),c=l[l.length-1];return{records:f,totalCount:s.totalCount,pageInfo:c.pageInfo,endCursor:c.endCursor,endOffset:c.endOffset}}))}toString(){return`{ ${this.objectName} { ${this.formatQueryFields()} } }`}}exports.GraphQLQueryBuilder=GraphQLQueryBuilder;