@skedulo/pulse-solution-services 0.0.7 → 0.0.9

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,o=n<3?t:null===r?r=Object.getOwnPropertyDescriptor(t,a):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)o=Reflect.decorate(e,t,a,r);else for(var c=e.length-1;c>=0;c--)(i=e[c])&&(o=(n<3?i(o):n>3?i(t,a,o):i(t,a))||o);return n>3&&o&&Object.defineProperty(t,a,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,a,r){return new(a||(a=Promise))((function(i,n){function o(e){try{s(r.next(e))}catch(e){n(e)}}function c(e){try{s(r.throw(e))}catch(e){n(e)}}function s(e){var t;e.done?i(e.value):(t=e.value,t instanceof a?t:new a((function(e){e(t)}))).then(o,c)}s((r=r.apply(e,t||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.CacheService=void 0;const logging_1=require("../../logging"),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 a=yield this.storage.get(e);if(a)try{const t=JSON.parse(a);return t.expiresAt&&Date.now()>t.expiresAt?(yield this.delete(e),null):this.deserialize(t)}catch(e){return console.error("Cache deserialization failed:",e),null}if((null==t?void 0:t.useSecondaryCache)&&this.secondaryCache){const a=yield this.secondaryCache.get(e,t);return null!==a&&(yield this.set(e,a,{ttl:null==t?void 0:t.ttl})),a}return null}))}set(e,t,a){return __awaiter(this,void 0,void 0,(function*(){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);yield this.storage.set(e,n),(null==a?void 0:a.useSecondaryCache)&&this.secondaryCache&&(yield this.secondaryCache.set(e,t,a))}))}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())?(console.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/graph-batch/configs/graph-batch-config.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { PaginationStrategy } from "../pagination-strategy";
+/**
+ * Default configuration values for `GraphBatchConfig`.
+ */
+export declare const DEFAULT_GRAPH_BATCH_CONFIG: GraphBatchConfig;
+/**
+ * Schema validation using `zod`
+ */
+export 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;

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

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.GraphBatchConfigSchema=exports.DEFAULT_GRAPH_BATCH_CONFIG=void 0,exports.initializeConfig=initializeConfig;const zod_1=require("zod"),pagination_strategy_1=require("../pagination-strategy");function initializeConfig(e){return exports.GraphBatchConfigSchema.parse(Object.assign(Object.assign({},exports.DEFAULT_GRAPH_BATCH_CONFIG),e))}exports.DEFAULT_GRAPH_BATCH_CONFIG={strategy:pagination_strategy_1.PaginationStrategy.NONE,batchSize:200,maxBatches:100,delaySeconds:0},exports.GraphBatchConfigSchema=zod_1.z.object({strategy:zod_1.z.nativeEnum(pagination_strategy_1.PaginationStrategy),batchSize:zod_1.z.number().min(1).max(200).default(200),maxBatches:zod_1.z.number().min(1).max(500).default(100),delaySeconds:zod_1.z.number().min(0).max(15).default(0)});

package/dist/services/graph-batch/configs/unique-graph-batch-config.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+/**
+ * Default configuration values for `UniqueGraphBatchConfig`.
+ */
+export declare const DEFAULT_UNIQUE_GRAPH_BATCH_CONFIG: UniqueGraphBatchConfig;
+/**
+ * Schema validation for `UniqueGraphBatchConfig`
+ */
+export declare const UniqueGraphBatchConfigSchema: z.ZodObject<z.objectUtil.extendShape<{
+    strategy: z.ZodNativeEnum<typeof import("..").PaginationStrategy>;
+    batchSize: z.ZodDefault<z.ZodNumber>;
+    maxBatches: z.ZodDefault<z.ZodNumber>;
+    delaySeconds: z.ZodDefault<z.ZodNumber>;
+}, {
+    name: z.ZodOptional<z.ZodString>;
+    lockTtl: z.ZodOptional<z.ZodNumber>;
+}>, "strip", z.ZodTypeAny, {
+    strategy: import("..").PaginationStrategy;
+    batchSize: number;
+    maxBatches: number;
+    delaySeconds: number;
+    name?: string | undefined;
+    lockTtl?: number | undefined;
+}, {
+    strategy: import("..").PaginationStrategy;
+    name?: string | undefined;
+    batchSize?: number | undefined;
+    maxBatches?: number | undefined;
+    delaySeconds?: number | undefined;
+    lockTtl?: number | undefined;
+}>;
+/**
+ * Configuration options for `UniqueGraphBatch`.
+ */
+export type UniqueGraphBatchConfig = z.infer<typeof UniqueGraphBatchConfigSchema>;
+/**
+ * Merges user-provided config with default values for `UniqueGraphBatch`.
+ */
+export declare function initializeUniqueConfig(config: Partial<UniqueGraphBatchConfig> | undefined): UniqueGraphBatchConfig;

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

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.UniqueGraphBatchConfigSchema=exports.DEFAULT_UNIQUE_GRAPH_BATCH_CONFIG=void 0,exports.initializeUniqueConfig=initializeUniqueConfig;const zod_1=require("zod"),graph_batch_config_1=require("./graph-batch-config");function initializeUniqueConfig(e){return exports.UniqueGraphBatchConfigSchema.parse(Object.assign(Object.assign({},exports.DEFAULT_UNIQUE_GRAPH_BATCH_CONFIG),e))}exports.DEFAULT_UNIQUE_GRAPH_BATCH_CONFIG=Object.assign(Object.assign({},graph_batch_config_1.DEFAULT_GRAPH_BATCH_CONFIG),{lockTtl:96e4,name:"UNIQUE-BATCH"}),exports.UniqueGraphBatchConfigSchema=graph_batch_config_1.GraphBatchConfigSchema.extend({name:zod_1.z.string().optional(),lockTtl:zod_1.z.number().min(1e3).optional()});

package/dist/services/graph-batch/graph-batch.d.ts

@@ -0,0 +1,56 @@
+import { ExecutionContext } from "../../core";
+import { QueryResult } from "../../interfaces";
+import { GraphQLQueryBuilder } from "../graphql";
+import { GraphBatchConfig } from "./configs/graph-batch-config";
+/**
+ * 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>;
+}

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

@@ -0,0 +1 @@
+"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++,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/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./configs/graph-batch-config";
+export * from "./configs/unique-graph-batch-config";
+export * from "./graph-batch";
+export * from "./pagination-strategy";
+export * from "./unique-graph-batch";

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

@@ -0,0 +1 @@
+"use strict";var __createBinding=this&&this.__createBinding||(Object.create?function(e,r,t,i){void 0===i&&(i=t);var o=Object.getOwnPropertyDescriptor(r,t);o&&!("get"in o?!r.__esModule:o.writable||o.configurable)||(o={enumerable:!0,get:function(){return r[t]}}),Object.defineProperty(e,i,o)}:function(e,r,t,i){void 0===i&&(i=t),e[i]=r[t]}),__exportStar=this&&this.__exportStar||function(e,r){for(var t in e)"default"===t||Object.prototype.hasOwnProperty.call(r,t)||__createBinding(r,e,t)};Object.defineProperty(exports,"__esModule",{value:!0}),__exportStar(require("./configs/graph-batch-config"),exports),__exportStar(require("./configs/unique-graph-batch-config"),exports),__exportStar(require("./graph-batch"),exports),__exportStar(require("./pagination-strategy"),exports),__exportStar(require("./unique-graph-batch"),exports);

package/dist/services/graph-batch/pagination-strategy.d.ts

@@ -0,0 +1,5 @@
+export declare enum PaginationStrategy {
+    CURSOR = "cursor",
+    OFFSET = "offset",
+    NONE = "none"
+}

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

@@ -0,0 +1 @@
+"use strict";var PaginationStrategy;Object.defineProperty(exports,"__esModule",{value:!0}),exports.PaginationStrategy=void 0,function(t){t.CURSOR="cursor",t.OFFSET="offset",t.NONE="none"}(PaginationStrategy||(exports.PaginationStrategy=PaginationStrategy={}));

package/dist/services/graph-batch/unique-graph-batch.d.ts

@@ -0,0 +1,28 @@
+import { ExecutionContext } from "../../core/execution-context";
+import { GraphQLQueryBuilder } from "../graphql";
+import { UniqueGraphBatchConfig } from "./configs/unique-graph-batch-config";
+import { GraphBatch } from "./graph-batch";
+/**
+ * UniqueGraphBatch ensures that only one instance of a batch with the same name can run at a time.
+ */
+export declare class UniqueGraphBatch extends GraphBatch {
+    private name;
+    private lockTtl;
+    constructor(context: ExecutionContext, config?: Partial<UniqueGraphBatchConfig>);
+    /**
+     * Runs the batch process with lock enforcement.
+     */
+    run(): Promise<void>;
+    /**
+     * Abstract method implementation - Initialize query builder.
+     */
+    protected start(): Promise<GraphQLQueryBuilder>;
+    /**
+     * Abstract method implementation - Process batch records.
+     */
+    protected execute(records: any[]): Promise<void>;
+    /**
+     * Overrides the finish method to ensure lock cleanup.
+     */
+    protected finish(): Promise<void>;
+}

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

@@ -0,0 +1 @@
+"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-query-builder.d.ts

@@ -1,10 +1,11 @@
-import { FetchRecordsQueryParams, QueryResult } from "../../interfaces/graphql";
+import { GraphqlQueryParams, QueryResult } from "../../interfaces/graphql";
 import { GraphQLService } from "./graphql-service";
 /**
  * A utility class for building GraphQL queries dynamically.
  */
 export declare class GraphQLQueryBuilder {
     private objectName;
+    operationName: string;
     private fields;
     private filters;
     private first?;
@@ -15,12 +16,13 @@ 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.
      */
@@ -64,7 +66,7 @@ export declare class GraphQLQueryBuilder {
     /**
      * Builds the GraphQL query parameters in a more structured format.
      */
-    build(): FetchRecordsQueryParams;
+    build(): GraphqlQueryParams;
     /**
      * Executes the query using the GraphQL service, with improved error handling.
      */

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(r,e=!1){this.fields=new Set(["UID"]),this.filters=[],this.parentQueries={},this.childQueries={},this.graphqlService=null,this.objectName=r.charAt(0).toLowerCase()+r.slice(1),this.isParent=e}setGraphqlService(r){this.graphqlService=r}withFields(r){return r.forEach((r=>this.fields.add(r))),this}withFilter(r){if(this.isParent)throw new Error("Cannot apply filters to a parent query.");return this.filters.push(r),this}withLimit(r){if(this.isParent)throw new Error("Cannot apply limit to a parent query.");return this.first=r,this}withOffset(r){if(this.isParent)throw new Error("Cannot apply offset to a parent query.");return this.offset=r,this}withOrderBy(r){if(this.isParent)throw new Error("Cannot apply orderBy to a parent query.");return this.orderBy=r,this}withCursor(r){if(this.isParent)throw new Error("Cannot apply cursor to a parent query.");return this.after=r,this}withParentQuery(r){const e=new GraphQLQueryBuilder(r,!0);return this.parentQueries[r]=e,e}withChildQuery(r){const e=new GraphQLQueryBuilder(r);return this.childQueries[r]=e,e}formatQueryFields(){const r=Object.entries(this.parentQueries).map((([r,e])=>`${r} { ${e.formatQueryFields()} }`)).join(", "),e=Object.entries(this.childQueries).map((([r,e])=>{const t=e.build();return`${r} ${t.filter?`(filter: "${t.filter}")`:""} { ${t.fields} }`})).join(", ");return[...this.fields,r,e].filter(Boolean).join(", ")}build(){return{objectName:this.objectName,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(){return this.graphqlService?this.graphqlService.query(this.build()):Promise.reject(new Error("No GraphQL service set for query execution."))}toString(){return`{ ${this.objectName} { ${this.formatQueryFields()} } }`}}exports.GraphQLQueryBuilder=GraphQLQueryBuilder;
+"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;

package/dist/services/graphql/graphql-service.d.ts

@@ -1,5 +1,5 @@
 import { GraphQLClient } from "../../clients/graphql-client";
-import { FetchRecordsQueryParams, HasId, MutationResult, QueryResult } from "../../interfaces/graphql";
+import { GraphqlMurationParams, GraphqlQueryParams, MutationResult, QueryResult } from "../../interfaces/graphql";
 /**
  * A service class for handling GraphQL operations.
  */
@@ -12,35 +12,42 @@ 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;
 }

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

@@ -1 +1 @@
-"use strict";var __decorate=this&&this.__decorate||function(e,t,o,r){var i,n=arguments.length,a=n<3?t:null===r?r=Object.getOwnPropertyDescriptor(t,o):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)a=Reflect.decorate(e,t,o,r);else for(var d=e.length-1;d>=0;d--)(i=e[d])&&(a=(n<3?i(a):n>3?i(t,o,a):i(t,o))||a);return n>3&&a&&Object.defineProperty(t,o,a),a},__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,o,r){return new(o||(o=Promise))((function(i,n){function a(e){try{s(r.next(e))}catch(e){n(e)}}function d(e){try{s(r.throw(e))}catch(e){n(e)}}function s(e){var t;e.done?i(e.value):(t=e.value,t instanceof o?t:new o((function(e){e(t)}))).then(a,d)}s((r=r.apply(e,t||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.GraphQLService=void 0;const logging_1=require("../../logging"),queries_1=require("./queries");class GraphQLService{constructor(e){this.client=e}query(e){return __awaiter(this,void 0,void 0,(function*(){var t,o,r,i,n,a,d,s,c,l,u,_;e.objectName=getQueryName(e.objectName);const v=(0,queries_1.FETCH_RECORDS_QUERY)(e),g=yield this.client.execute(v),p={records:(null===(o=null===(t=null==g?void 0:g.data)||void 0===t?void 0:t[e.objectName])||void 0===o?void 0:o.edges.map((e=>e.node)))||[],totalCount:(null===(i=null===(r=null==g?void 0:g.data)||void 0===r?void 0:r[e.objectName])||void 0===i?void 0:i.totalCount)||0,pageInfo:(null===(a=null===(n=null==g?void 0:g.data)||void 0===n?void 0:n[e.objectName])||void 0===a?void 0:a.pageInfo)||{}};if(p.records.length>0){const t=(null===(c=null===(s=null===(d=null==g?void 0:g.data)||void 0===d?void 0:d[e.objectName])||void 0===s?void 0:s.edges)||void 0===c?void 0:c.map((e=>e.offset)))||[],o=(null===(_=null===(u=null===(l=null==g?void 0:g.data)||void 0===l?void 0:l[e.objectName])||void 0===u?void 0:u.edges)||void 0===_?void 0:_.map((e=>e.cursor)))||[];p.endOffset=t[t.length-1],p.endCursor=o[o.length-1]}return p}))}delete(e,t){return __awaiter(this,void 0,void 0,(function*(){if(!t||0===t.length)return Promise.resolve({message:"No records to process"});const o=(0,queries_1.DELETE_OBJECTS_MUTATION)(e,t);return yield this.client.execute(o)}))}update(e,t){return __awaiter(this,void 0,void 0,(function*(){if(!t||0===t.length)return Promise.resolve({message:"No records to process"});const o=(0,queries_1.UPSERT_OBJECTS_MUTATION)(e,t,"update");return yield this.client.execute(o)}))}insert(e,t){return __awaiter(this,void 0,void 0,(function*(){if(!t||0===t.length)return Promise.resolve({message:"No records to process"});const o=(0,queries_1.UPSERT_OBJECTS_MUTATION)(e,t,"insert");return yield this.client.execute(o)}))}extractJobUIDs(e){var t;return(null===(t=null==e?void 0:e.data)||void 0===t?void 0:t.schema)?Object.values(e.data.schema):[]}}function getQueryName(e){return e.charAt(0).toLowerCase()+e.slice(1)}exports.GraphQLService=GraphQLService,__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[Object]),__metadata("design:returntype",Promise)],GraphQLService.prototype,"query",null),__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[String,Array]),__metadata("design:returntype",Promise)],GraphQLService.prototype,"delete",null),__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[String,Array]),__metadata("design:returntype",Promise)],GraphQLService.prototype,"update",null),__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[String,Array]),__metadata("design:returntype",Promise)],GraphQLService.prototype,"insert",null);
+"use strict";var __decorate=this&&this.__decorate||function(e,t,a,r){var o,n=arguments.length,i=n<3?t:null===r?r=Object.getOwnPropertyDescriptor(t,a):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)i=Reflect.decorate(e,t,a,r);else for(var s=e.length-1;s>=0;s--)(o=e[s])&&(i=(n<3?o(i):n>3?o(t,a,i):o(t,a))||i);return n>3&&i&&Object.defineProperty(t,a,i),i},__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,a,r){return new(a||(a=Promise))((function(o,n){function i(e){try{d(r.next(e))}catch(e){n(e)}}function s(e){try{d(r.throw(e))}catch(e){n(e)}}function d(e){var t;e.done?o(e.value):(t=e.value,t instanceof a?t:new a((function(e){e(t)}))).then(i,s)}d((r=r.apply(e,t||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.GraphQLService=void 0;const constants_1=require("../../constants"),request_header_constants_1=require("../../core/request-header-constants"),logging_1=require("../../logging"),queries_1=require("./queries");class GraphQLService{constructor(e){this.client=e}query(e){return __awaiter(this,void 0,void 0,(function*(){var t,a,r,o,n,i,s,d,u,c,_,l;e.objectName=this.getQueryName(e.objectName);const p=(0,queries_1.FETCH_RECORDS_QUERY)(e),v=this.getQueryHeaders(e),g=yield this.client.execute(p,v),h={records:(null===(a=null===(t=null==g?void 0:g.data)||void 0===t?void 0:t[e.objectName])||void 0===a?void 0:a.edges.map((e=>e.node)))||[],totalCount:(null===(o=null===(r=null==g?void 0:g.data)||void 0===r?void 0:r[e.objectName])||void 0===o?void 0:o.totalCount)||0,pageInfo:(null===(i=null===(n=null==g?void 0:g.data)||void 0===n?void 0:n[e.objectName])||void 0===i?void 0:i.pageInfo)||{}};if(h.records.length>0){const t=(null===(u=null===(d=null===(s=null==g?void 0:g.data)||void 0===s?void 0:s[e.objectName])||void 0===d?void 0:d.edges)||void 0===u?void 0:u.map((e=>e.offset)))||[],a=(null===(l=null===(_=null===(c=null==g?void 0:g.data)||void 0===c?void 0:c[e.objectName])||void 0===_?void 0:_.edges)||void 0===l?void 0:l.map((e=>e.cursor)))||[];h.endOffset=t[t.length-1],h.endCursor=a[a.length-1]}return h}))}mutate(e){return __awaiter(this,void 0,void 0,(function*(){if(!e.records||0===e.records.length)return Promise.resolve({message:"No records to process"});let t="";switch(e.operation){case constants_1.GraphqlOperations.DELETE:t=(0,queries_1.DELETE_OBJECTS_MUTATION)(e);break;case constants_1.GraphqlOperations.UPDATE:case constants_1.GraphqlOperations.INSERT:t=(0,queries_1.UPSERT_OBJECTS_MUTATION)(e);break;default:throw new Error(`Invalid operation: ${e.operation}`)}const a=this.getMutationHeaders(e);return yield this.client.execute(t,a)}))}delete(e){return __awaiter(this,void 0,void 0,(function*(){return e.operation=constants_1.GraphqlOperations.DELETE,this.mutate(e)}))}update(e){return __awaiter(this,void 0,void 0,(function*(){return e.operation=constants_1.GraphqlOperations.UPDATE,this.mutate(e)}))}insert(e){return __awaiter(this,void 0,void 0,(function*(){return e.operation=constants_1.GraphqlOperations.INSERT,this.mutate(e)}))}extractJobUIDs(e){var t;return(null===(t=null==e?void 0:e.data)||void 0===t?void 0:t.schema)?Object.values(e.data.schema):[]}getQueryName(e){return e.charAt(0).toLowerCase()+e.slice(1)}getQueryHeaders(e){const t=this.getOperationHeader(e.operationName);return e.readOnly&&(t[request_header_constants_1.REQUEST_HEADERS.X_SKEDULO_READ_ONLY]="true"),t}getMutationHeaders(e){const t=this.getOperationHeader(e.operationName);return e.bulkOperation&&(t[request_header_constants_1.REQUEST_HEADERS.X_SKEDULO_BULK_OPERATION]="true"),t}getOperationHeader(e){return{[request_header_constants_1.REQUEST_HEADERS.X_GRAPHQL_OPERATION]:e}}}exports.GraphQLService=GraphQLService,__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[Object]),__metadata("design:returntype",Promise)],GraphQLService.prototype,"query",null),__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[Object]),__metadata("design:returntype",Promise)],GraphQLService.prototype,"mutate",null),__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[Object]),__metadata("design:returntype",Promise)],GraphQLService.prototype,"delete",null),__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[Object]),__metadata("design:returntype",Promise)],GraphQLService.prototype,"update",null),__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[Object]),__metadata("design:returntype",Promise)],GraphQLService.prototype,"insert",null);

package/dist/services/graphql/queries.d.ts

@@ -1,19 +1,20 @@
-import { FetchRecordsQueryParams, HasId } from "../../interfaces/graphql";
+import { GraphqlMurationParams, GraphqlQueryParams } from "../../interfaces/graphql";
 /**
  * Constructs a GraphQL query for fetching records with specified parameters.
  *
  * @param params - The query parameters including object name, filter, pagination, ordering, and fields.
  * @returns The constructed GraphQL query string.
  */
-export declare const FETCH_RECORDS_QUERY: ({ objectName, filter, first, offset, after, orderBy, fields, }: FetchRecordsQueryParams) => string;
+export declare const FETCH_RECORDS_QUERY: ({ objectName, operationName, filter, first, offset, after, orderBy, fields, }: GraphqlQueryParams) => string;
 /**
  * Constructs a GraphQL mutation for deleting multiple objects.
  *
  * @param objectName - The name of the object to delete.
+ * @param operationName - The graphql operation name.
  * @param records - The records to be deleted.
  * @returns The constructed GraphQL mutation string.
  */
-export declare const DELETE_OBJECTS_MUTATION: (objectName: string, records: HasId[]) => string;
+export declare const DELETE_OBJECTS_MUTATION: ({ objectName, operationName, records }: GraphqlMurationParams) => string;
 /**
  * Constructs a GraphQL mutation for upserting (inserting/updating) multiple objects.
  *
@@ -22,4 +23,4 @@ export declare const DELETE_OBJECTS_MUTATION: (objectName: string, records: HasI
  * @param operation - The operation type ("insert" or "update").
  * @returns The constructed GraphQL mutation string.
  */
-export declare const UPSERT_OBJECTS_MUTATION: (objectName: string, records: HasId[], operation: string) => string;
+export declare const UPSERT_OBJECTS_MUTATION: ({ objectName, operationName, records, operation }: GraphqlMurationParams) => string;

package/dist/services/graphql/queries.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.UPSERT_OBJECTS_MUTATION=exports.DELETE_OBJECTS_MUTATION=exports.FETCH_RECORDS_QUERY=void 0;const FETCH_RECORDS_QUERY=({objectName:e,filter:n,first:t=200,offset:E=0,after:T,orderBy:o,fields:s})=>`\n    query fetchRecords {\n      ${e}(${[n?`filter: "${n}"`:"",T?`after: "${T}"`:"",`first: ${t}`,E?`offset: ${E}`:"",o?`orderBy: "${o}"`:""].filter((e=>e)).join(", ")}) {\n        totalCount\n        pageInfo{\n          hasNextPage\n        }\n        edges {\n          cursor\n          offset\n          node {\n            ${s||"UID"}\n          }\n        }\n      }\n    }\n  `;exports.FETCH_RECORDS_QUERY=FETCH_RECORDS_QUERY;const DELETE_OBJECTS_MUTATION=(e,n)=>`\n  mutation deleteObjects {\n    schema {\n      ${n.map(((n,t)=>`alias${t+1}:delete${e}(UID: "${n.UID}")`)).join("\n    ")}\n    }\n  }`;exports.DELETE_OBJECTS_MUTATION=DELETE_OBJECTS_MUTATION;const UPSERT_OBJECTS_MUTATION=(e,n,t)=>`\n  mutation ${t}Objects {\n    schema {\n      ${n.map(((n,E)=>`\n        alias${E+1}:${t}${e}(input: {\n          ${Object.entries(n).map((([e,n])=>`${e}: ${"string"==typeof n?`"${n}"`:n}`)).join(", ")}\n        }) \n      `)).join("\n    ")}\n    }\n  }`;exports.UPSERT_OBJECTS_MUTATION=UPSERT_OBJECTS_MUTATION;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.UPSERT_OBJECTS_MUTATION=exports.DELETE_OBJECTS_MUTATION=exports.FETCH_RECORDS_QUERY=void 0;const FETCH_RECORDS_QUERY=({objectName:e,operationName:n,filter:t,first:o=200,offset:E=0,after:T,orderBy:r,fields:s})=>`\n    query ${n} {\n      ${e}(${[t?`filter: "${t}"`:"",T?`after: "${T}"`:"",`first: ${o}`,E?`offset: ${E}`:"",r?`orderBy: "${r}"`:""].filter((e=>e)).join(", ")}) {\n        totalCount\n        pageInfo{\n          hasNextPage\n        }\n        edges {\n          cursor\n          offset\n          node {\n            ${s||"UID"}\n          }\n        }\n      }\n    }\n  `;exports.FETCH_RECORDS_QUERY=FETCH_RECORDS_QUERY;const DELETE_OBJECTS_MUTATION=({objectName:e,operationName:n,records:t})=>`\n  mutation ${n} {\n    schema {\n      ${t.map(((n,t)=>`alias${t+1}:delete${e}(UID: "${n.UID}")`)).join("\n    ")}\n    }\n  }`;exports.DELETE_OBJECTS_MUTATION=DELETE_OBJECTS_MUTATION;const UPSERT_OBJECTS_MUTATION=({objectName:e,operationName:n,records:t,operation:o})=>`\n  mutation ${n} {\n    schema {\n      ${t.map(((n,t)=>`\n        alias${t+1}:${o}${e}(input: {\n          ${Object.entries(n).map((([e,n])=>`${e}: ${"string"==typeof n?`"${n}"`:n}`)).join(", ")}\n        }) \n      `)).join("\n    ")}\n    }\n  }`;exports.UPSERT_OBJECTS_MUTATION=UPSERT_OBJECTS_MUTATION;

package/dist/services/index.js

@@ -1 +1 @@
-"use strict";var __createBinding=this&&this.__createBinding||(Object.create?function(e,r,t,i){void 0===i&&(i=t);var o=Object.getOwnPropertyDescriptor(r,t);o&&!("get"in o?!r.__esModule:o.writable||o.configurable)||(o={enumerable:!0,get:function(){return r[t]}}),Object.defineProperty(e,i,o)}:function(e,r,t,i){void 0===i&&(i=t),e[i]=r[t]}),__exportStar=this&&this.__exportStar||function(e,r){for(var t in e)"default"===t||Object.prototype.hasOwnProperty.call(r,t)||__createBinding(r,e,t)};Object.defineProperty(exports,"__esModule",{value:!0}),__exportStar(require("./batch-processor"),exports),__exportStar(require("./cache"),exports),__exportStar(require("./graphql"),exports),__exportStar(require("./metadata-service"),exports),__exportStar(require("./resource-availability"),exports);
+"use strict";var __createBinding=this&&this.__createBinding||(Object.create?function(e,r,t,o){void 0===o&&(o=t);var i=Object.getOwnPropertyDescriptor(r,t);i&&!("get"in i?!r.__esModule:i.writable||i.configurable)||(i={enumerable:!0,get:function(){return r[t]}}),Object.defineProperty(e,o,i)}:function(e,r,t,o){void 0===o&&(o=t),e[o]=r[t]}),__exportStar=this&&this.__exportStar||function(e,r){for(var t in e)"default"===t||Object.prototype.hasOwnProperty.call(r,t)||__createBinding(r,e,t)};Object.defineProperty(exports,"__esModule",{value:!0}),__exportStar(require("./batch-processor"),exports),__exportStar(require("./cache"),exports),__exportStar(require("./graph-batch"),exports),__exportStar(require("./graphql"),exports),__exportStar(require("./metadata-service"),exports),__exportStar(require("./resource-availability"),exports);

package/dist/services/lock-service.js

@@ -0,0 +1 @@
+"use strict";var __decorate=this&&this.__decorate||function(e,t,r,i){var o,n=arguments.length,a=n<3?t:null===i?i=Object.getOwnPropertyDescriptor(t,r):i;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)a=Reflect.decorate(e,t,r,i);else for(var c=e.length-1;c>=0;c--)(o=e[c])&&(a=(n<3?o(a):n>3?o(t,r,a):o(t,r))||a);return n>3&&a&&Object.defineProperty(t,r,a),a},__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,i){return new(r||(r=Promise))((function(o,n){function a(e){try{l(i.next(e))}catch(e){n(e)}}function c(e){try{l(i.throw(e))}catch(e){n(e)}}function l(e){var t;e.done?o(e.value):(t=e.value,t instanceof r?t:new r((function(e){e(t)}))).then(a,c)}l((i=i.apply(e,t||[])).next())}))},__importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.LockService=void 0;const logging_1=require("../logging"),logger_1=__importDefault(require("../logging/logger")),KEY_PREFIX="Z_LOCK_";class LockService{constructor(e){this.configVarClient=e}acquireLock(e){return __awaiter(this,void 0,void 0,(function*(){const t="Z_LOCK_"+e.name,r=new Date(Date.now()+e.ttl).toISOString();try{let i=null;try{i=yield this.configVarClient.get(t)}catch(e){}if(i){if(i.expiryDate&&new Date<new Date(i.expiryDate))return!1;yield this.configVarClient.delete(t)}return yield this.configVarClient.create({key:t,value:e.name,configType:"plain-text",description:e.description,expiryDate:r}),!0}catch(t){return logger_1.default.error(`Failed to acquire lock: ${e.name}`),!1}}))}releaseLock(e){return __awaiter(this,void 0,void 0,(function*(){const t="Z_LOCK_"+e;try{let e=null;try{e=yield this.configVarClient.get(t)}catch(e){}e&&(yield this.configVarClient.delete(t))}catch(t){logger_1.default.error(`Failed to release lock: ${e}`)}}))}}exports.LockService=LockService,__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[Object]),__metadata("design:returntype",Promise)],LockService.prototype,"acquireLock",null),__decorate([(0,logging_1.LogMethod)(),__metadata("design:type",Function),__metadata("design:paramtypes",[String]),__metadata("design:returntype",Promise)],LockService.prototype,"releaseLock",null);

package/dist/services/locking-service.js

@@ -0,0 +1 @@
+"use strict";var __awaiter=this&&this.__awaiter||function(e,t,i,n){return new(i||(i=Promise))((function(r,c){function o(e){try{l(n.next(e))}catch(e){c(e)}}function a(e){try{l(n.throw(e))}catch(e){c(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((n=n.apply(e,t||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.LockingService=void 0;const KEY_PREFIX="Z_LOCK_";class LockingService{constructor(e){this.configVarClient=e}acquireLock(e){return __awaiter(this,void 0,void 0,(function*(){const t="Z_LOCK_"+e.name,i=new Date(Date.now()+e.ttl).toISOString();try{let n=null;try{n=yield this.configVarClient.get(t)}catch(e){}if(n){if(n.expiryDate&&new Date<new Date(n.expiryDate))return!1;yield this.configVarClient.delete(t)}return yield this.configVarClient.create({key:t,value:e.name,configType:"plain-text",description:e.description,expiryDate:i}),!0}catch(t){return console.error(`Failed to acquire lock: ${e.name}`),!1}}))}releaseLock(e){return __awaiter(this,void 0,void 0,(function*(){const t="Z_LOCK_"+e;try{let e=null;try{e=yield this.configVarClient.get(t)}catch(e){}e&&(yield this.configVarClient.delete(t))}catch(t){console.error(`Failed to release lock: ${e}`)}}))}}exports.LockingService=LockingService;

package/dist/services/resource-availability/builder/data-service.d.ts

@@ -1,3 +1,4 @@
+import { GraphqlQueryParams } from "../../../interfaces";
 import { GraphQLQueryBuilder, GraphQLService } from "../../graphql";
 import { ResourceQueryParam } from "./resource-query-param";
 export declare class DataService {
@@ -5,5 +6,5 @@ export declare class DataService {
     constructor(graphqlService: GraphQLService);
     getResources(param: ResourceQueryParam): Promise<Record<string, any>[]>;
     getHolidays(regionIds: string[], startTime?: Date, endTime?: Date): Promise<Record<string, any>>;
-    newQueryBuilder(objectName: string): GraphQLQueryBuilder;
+    newQueryBuilder(params: GraphqlQueryParams): GraphQLQueryBuilder;
 }

package/dist/services/resource-availability/builder/data-service.js

@@ -1 +1 @@
-"use strict";var __awaiter=this&&this.__awaiter||function(e,t,i,r){return new(i||(i=Promise))((function(s,n){function o(e){try{c(r.next(e))}catch(e){n(e)}}function a(e){try{c(r.throw(e))}catch(e){n(e)}}function c(e){var t;e.done?s(e.value):(t=e.value,t instanceof i?t:new i((function(e){e(t)}))).then(o,a)}c((r=r.apply(e,t||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.DataService=void 0;const core_1=require("../../../core"),graphql_1=require("../../graphql");class DataService{constructor(e){this.graphqlService=e}getResources(e){return __awaiter(this,void 0,void 0,(function*(){const t=this.newQueryBuilder(core_1.TenantObjects.Resources.Name);t.withFields(core_1.TenantObjects.Resources.Fields).withFilter("IsActive == true"),t.withParentQuery("PrimaryRegion").withFields(core_1.TenantObjects.Regions.Fields),e.resourceIds&&e.resourceIds.size>0?t.withFilter(`UID IN ${JSON.stringify(Array.from(e.resourceIds))}`):e.regionIds&&e.regionIds.size>0&&t.withFilter(`PrimaryRegionId IN [${Array.from(e.regionIds).map((e=>`'${e}'`)).join(",")}]`),e.useTag&&t.withChildQuery(core_1.TenantObjects.ResourceTags.Name).withParentQuery("Tag").withFields(core_1.TenantObjects.Tags.Fields),e.useActivity&&t.withChildQuery(core_1.TenantObjects.Activities.Name).withFields(core_1.TenantObjects.Activities.Fields),e.useAvailability&&t.withChildQuery(core_1.TenantObjects.Availabilities.Name).withFields(core_1.TenantObjects.Availabilities.Fields),e.useJobAllocation&&t.withChildQuery(core_1.TenantObjects.JobAllocations.Name).withFields(core_1.TenantObjects.JobAllocations.Fields).withFilter("Status NOTIN ['Deleted', 'Declined']").withParentQuery("Job").withFields(core_1.TenantObjects.Jobs.Fields);return(yield t.execute()).records}))}getHolidays(e,t,i){return __awaiter(this,void 0,void 0,(function*(){const r={},s=t?t.toISOString().split("T")[0]:null,n=i?i.toISOString().split("T")[0]:null,o=this.newQueryBuilder(core_1.TenantObjects.Holidays.Name);o.withFields(core_1.TenantObjects.Holidays.Fields),o.withFilter("Global == true"),s&&o.withFilter(`EndDate >= ${s}`),n&&o.withFilter(`StartDate <= ${n}`);const a=yield o.execute();if(r.GLOBAL=a.records||[],e&&e.length>0){const t=this.newQueryBuilder(core_1.TenantObjects.Holidays.Name);t.withFields(core_1.TenantObjects.Holidays.Fields),t.withChildQuery(core_1.TenantObjects.HolidayRegions.Name).withFields(core_1.TenantObjects.HolidayRegions.Fields).withFilter(`RegionId IN [${e.map((e=>`'${e}'`)).join(",")}]`),s&&t.withFilter(`EndDate >= ${s}`),n&&t.withFilter(`StartDate <= ${n}`);const i=yield t.execute();for(const e of i.records||[])for(const t of e.HolidayRegions||[]){const i=t.RegionId;r[i]||(r[i]=[]),r[i].push(e)}}return r}))}newQueryBuilder(e){const t=new graphql_1.GraphQLQueryBuilder(e);return t.setGraphqlService(this.graphqlService),t}}exports.DataService=DataService;
+"use strict";var __awaiter=this&&this.__awaiter||function(e,t,i,n){return new(i||(i=Promise))((function(s,a){function r(e){try{c(n.next(e))}catch(e){a(e)}}function o(e){try{c(n.throw(e))}catch(e){a(e)}}function c(e){var t;e.done?s(e.value):(t=e.value,t instanceof i?t:new i((function(e){e(t)}))).then(r,o)}c((n=n.apply(e,t||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.DataService=void 0;const tenant_objects_1=require("../../../core/tenant-objects"),graphql_1=require("../../graphql");class DataService{constructor(e){this.graphqlService=e}getResources(e){return __awaiter(this,void 0,void 0,(function*(){const t=this.newQueryBuilder({objectName:tenant_objects_1.TenantObjects.Resources.Name,operationName:"fetchResourcesWithAvailabilities"});t.withFields(tenant_objects_1.TenantObjects.Resources.Fields).withFilter("IsActive == true"),t.withParentQuery("PrimaryRegion").withFields(tenant_objects_1.TenantObjects.Regions.Fields),e.resourceIds&&e.resourceIds.size>0?t.withFilter(`UID IN ${JSON.stringify(Array.from(e.resourceIds))}`):e.regionIds&&e.regionIds.size>0&&t.withFilter(`PrimaryRegionId IN [${Array.from(e.regionIds).map((e=>`'${e}'`)).join(",")}]`),e.useTag&&t.withChildQuery(tenant_objects_1.TenantObjects.ResourceTags.Name).withParentQuery("Tag").withFields(tenant_objects_1.TenantObjects.Tags.Fields),e.useActivity&&t.withChildQuery(tenant_objects_1.TenantObjects.Activities.Name).withFields(tenant_objects_1.TenantObjects.Activities.Fields),e.useAvailability&&t.withChildQuery(tenant_objects_1.TenantObjects.Availabilities.Name).withFields(tenant_objects_1.TenantObjects.Availabilities.Fields),e.useJobAllocation&&t.withChildQuery(tenant_objects_1.TenantObjects.JobAllocations.Name).withFields(tenant_objects_1.TenantObjects.JobAllocations.Fields).withFilter("Status NOTIN ['Deleted', 'Declined']").withParentQuery("Job").withFields(tenant_objects_1.TenantObjects.Jobs.Fields);return(yield t.execute()).records}))}getHolidays(e,t,i){return __awaiter(this,void 0,void 0,(function*(){const n={},s=t?t.toISOString().split("T")[0]:null,a=i?i.toISOString().split("T")[0]:null,r=this.newQueryBuilder({objectName:tenant_objects_1.TenantObjects.Holidays.Name,operationName:"fetchHolidays"});r.withFields(tenant_objects_1.TenantObjects.Holidays.Fields),r.withFilter("Global == true"),s&&r.withFilter(`EndDate >= ${s}`),a&&r.withFilter(`StartDate <= ${a}`);const o=yield r.execute();if(n.GLOBAL=o.records||[],e&&e.length>0){const t=this.newQueryBuilder({objectName:tenant_objects_1.TenantObjects.Holidays.Name,operationName:"fetchHolidays"});t.withFields(tenant_objects_1.TenantObjects.Holidays.Fields),t.withChildQuery(tenant_objects_1.TenantObjects.HolidayRegions.Name).withFields(tenant_objects_1.TenantObjects.HolidayRegions.Fields).withFilter(`RegionId IN [${e.map((e=>`'${e}'`)).join(",")}]`),s&&t.withFilter(`EndDate >= ${s}`),a&&t.withFilter(`StartDate <= ${a}`);const i=yield t.execute();for(const e of i.records||[])for(const t of e.HolidayRegions||[]){const i=t.RegionId;n[i]||(n[i]=[]),n[i].push(e)}}return n}))}newQueryBuilder(e){const t=new graphql_1.GraphQLQueryBuilder(e);return t.setGraphqlService(this.graphqlService),t}}exports.DataService=DataService;

package/dist/utils/datetime-utils.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.DateTimeUtils=void 0;const luxon_1=require("luxon");class DateTimeUtils{static toTimezone(t,e){return this.switchTimezone(t,"UTC",e)}static switchTimezone(t,e,a){if(e===a)return t;return luxon_1.DateTime.fromJSDate(t,{zone:e}).setZone(a).toJSDate()}static addMinutes(t,e,a){return luxon_1.DateTime.fromJSDate(t,{zone:a}).plus({minutes:e}).toJSDate()}static addDays(t,e,a){return luxon_1.DateTime.fromJSDate(t,{zone:a}).plus({days:e}).toJSDate()}static addMonths(t,e,a){return luxon_1.DateTime.fromJSDate(t,{zone:a}).plus({months:e}).toJSDate()}static addYears(t,e,a){return luxon_1.DateTime.fromJSDate(t,{zone:a}).plus({years:e}).toJSDate()}static getDate(t,e){return luxon_1.DateTime.fromJSDate(t,{zone:e}).startOf("day").toJSDate()}static getDateFromIsoString(t){return luxon_1.DateTime.fromISO(t,{zone:"UTC"}).toJSDate()}static getDateTimeFromIsoString(t){return luxon_1.DateTime.fromISO(t,{zone:"UTC"}).toJSDate()}static getStartOfDate(t,e){const a="string"==typeof t?this.getDateFromIsoString(t):t;return luxon_1.DateTime.fromJSDate(a,{zone:e}).startOf("day").toJSDate()}static getEndOfDate(t,e){const a=this.getStartOfDate(t,e);return this.addDays(a,1,e)}static isIncluding(t,e){return t.start<=e.start&&t.finish>=e.finish}static isOverlapping(t,e){return t.start<e.finish&&t.finish>e.start}static mergeEvents(t){t.sort(((t,e)=>t.start.getTime()-e.start.getTime()));const e=[];let a=null;for(const i of t)a?new Date(a.finish)>=i.start?(a.finish=i.finish,a.eventType="merged",a.description=a.description?`${a.description}, ${a.name} merged with ${i.name}`:`${a.name} merged with ${i.name}`):(e.push(a),a=i):a=i;return a&&e.push(a),e}}exports.DateTimeUtils=DateTimeUtils;
+"use strict";var __importDefault=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.DateTimeUtils=void 0;const dayjs_1=__importDefault(require("dayjs")),timezone_1=__importDefault(require("dayjs/plugin/timezone")),utc_1=__importDefault(require("dayjs/plugin/utc"));dayjs_1.default.extend(utc_1.default),dayjs_1.default.extend(timezone_1.default);class DateTimeUtils{static toTimezone(t,e){return(0,dayjs_1.default)(t).tz(e).toDate()}static switchTimezone(t,e,a){return e===a?t:(0,dayjs_1.default)(t).tz(e).tz(a).toDate()}static addMinutes(t,e,a){return(0,dayjs_1.default)(t).tz(a).add(e,"minute").toDate()}static addDays(t,e,a){return(0,dayjs_1.default)(t).tz(a).add(e,"day").toDate()}static addMonths(t,e,a){return(0,dayjs_1.default)(t).tz(a).add(e,"month").toDate()}static addYears(t,e,a){return(0,dayjs_1.default)(t).tz(a).add(e,"year").toDate()}static getDate(t,e){return(0,dayjs_1.default)(t).tz(e).startOf("day").toDate()}static getDateFromIsoString(t){return(0,dayjs_1.default)(t).utc().toDate()}static getDateTimeFromIsoString(t){return(0,dayjs_1.default)(t).utc().toDate()}static getStartOfDate(t,e){const a="string"==typeof t?this.getDateFromIsoString(t):t;return(0,dayjs_1.default)(a).tz(e).startOf("day").toDate()}static getEndOfDate(t,e){return this.addDays(this.getStartOfDate(t,e),1,e)}static isIncluding(t,e){return t.start<=e.start&&t.finish>=e.finish}static isOverlapping(t,e){return t.start<e.finish&&t.finish>e.start}static mergeEvents(t){t.sort(((t,e)=>t.start.getTime()-e.start.getTime()));const e=[];let a=null;for(const s of t)a?a.finish>=s.start?(a.finish=s.finish,a.eventType="merged",a.description=a.description?`${a.description}, ${a.name} merged with ${s.name}`:`${a.name} merged with ${s.name}`):(e.push(a),a=s):a=s;return a&&e.push(a),e}}exports.DateTimeUtils=DateTimeUtils;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skedulo/pulse-solution-services",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "A collection of services and utilities to support solution development on the Pulse platform.",
   "author": "Skedulo",
   "license": "MIT",
@@ -23,6 +23,7 @@
   ],
   "devDependencies": {
     "@tsconfig/node18": "^18.2.2",
+    "@types/uuid": "^10.0.0",
     "@typescript-eslint/eslint-plugin": "^8.11.0",
     "@typescript-eslint/parser": "^8.11.0",
     "dts-bundle-generator": "^9.5.1",
@@ -37,10 +38,13 @@
   },
   "dependencies": {
     "@skedulo/function-utilities": "^0.0.6",
-    "@types/luxon": "^3.4.2",
-    "luxon": "^3.5.0",
+    "dayjs": "^1.11.13",
+    "p-queue": "^8.1.0",
+    "timezone": "^1.0.23",
     "typescript": "~5.6.3",
-    "uuid": "^11.0.5",
-    "winston": "^3.17.0"
+    "utc": "^0.1.0",
+    "uuid": "8",
+    "winston": "^3.17.0",
+    "zod": "^3.24.2"
   }
 }