@skedulo/pulse-solution-services 0.0.22 → 0.0.25

package/README.md

@@ -18,6 +18,8 @@
     - [Availability API Client](#availability-api-client)
     - [Files API Client](#files-api-client)
     - [Artifact Client](#artifact-client)
+    - [RAP Client](#rap-client)
+  - [RAP Service](#rap-service)
   - [GraphQL Service](#graphql-service)
     - [Query Data](#query-data)
     - [Query by Pages](#query-by-pages)
@@ -534,6 +536,151 @@ await client.delete(
 );
 ```
 
+#### RAP Client
+Manages Record Access Policies (RAP) for row-level security via the `/authorization/policies` endpoints.
+
+**Policies**
+```javascript
+// Get all policies
+const policies: RapPolicy[] = await context.rapClient.getPolicies();
+
+// Get a single policy by ID
+const policy: RapPolicy = await context.rapClient.getPolicy('<policy_id>');
+
+// Create a new policy
+const newPolicy: RapPolicy = await context.rapClient.createPolicy({
+  name: "Data isolation by region",
+  description: "Any data related to a region is isolated based on the user's regions",
+  enabled: true
+});
+
+// Create a policy with inline rules
+const policyWithRules: RapPolicy = await context.rapClient.createPolicy({
+  name: "Resource data isolation",
+  description: "Resources can only see their own data",
+  enabled: true,
+  rules: [
+    {
+      policyId: "", // Auto-assigned by the API when rules are created inline
+      description: "Resource: Only Jobs I'm allocated to",
+      objectType: "Jobs",
+      filter: "UID IN (SELECT JobId FROM JobAllocations WHERE ResourceId == '{{resourceId}}' AND Status != 'Declined' AND Status != 'Deleted')",
+      accessType: "deny",
+      permissionsExcluded: ["skedulo.tenant.schedule.allocation.dispatch"]
+    }
+  ]
+});
+
+// Update (replace) a policy
+const updatedPolicy: RapPolicy = await context.rapClient.updatePolicy('<policy_id>', {
+  name: "Data isolation by region",
+  description: "Updated description",
+  enabled: false
+});
+
+// Delete a policy
+await context.rapClient.deletePolicy('<policy_id>');
+```
+
+**Rules**
+```javascript
+// Create a rule linked to a policy
+const rule: RapRule = await context.rapClient.createRule({
+  policyId: "<policy_id>",
+  description: "Resource: Only Jobs I'm allocated to",
+  objectType: "Jobs",
+  filter: "UID IN (SELECT JobId FROM JobAllocations WHERE ResourceId == '{{resourceId}}' AND Status != 'Declined' AND Status != 'Deleted')",
+  accessType: "deny",
+  permissionsExcluded: ["skedulo.tenant.schedule.allocation.dispatch"]
+});
+
+// Create a pattern-based rule (applies to all objects with a Region lookup)
+const patternRule: RapRule = await context.rapClient.createRule({
+  policyId: "<policy_id>",
+  description: "Pattern: Only objects for regions the user has access to",
+  objectType: "hasLookup:Region",
+  filter: "RegionId IN (SELECT RegionId FROM UserRegions WHERE UserId == '{{userId}}')",
+  accessType: "deny",
+  permissionsExcluded: []
+});
+
+// Update a rule
+const updatedRule: RapRule = await context.rapClient.updateRule('<rule_id>', {
+  policyId: "<policy_id>",
+  description: "Resource: Activities I'm allocated to",
+  objectType: "Activities",
+  filter: "ResourceId == '{{resourceId}}'",
+  accessType: "deny",
+  permissionsExcluded: ["skedulo.tenant.schedule.allocation.dispatch"]
+});
+
+// Delete a rule
+await context.rapClient.deleteRule('<rule_id>');
+```
+
+**Templates**
+```javascript
+// List all available policy templates
+const templates: RapTemplate[] = await context.rapClient.getTemplates();
+
+// Apply a template to create a new policy
+const policyFromTemplate: RapPolicy = await context.rapClient.applyTemplate('<template_id>');
+```
+
+### RAP Service
+The RAP Service provides higher-level operations for exporting and importing Record Access Policies between tenants.
+
+**Export policies**
+```javascript
+// Export all policies from the current tenant
+const allPolicies: RapPolicy[] = await context.rapService.exportPolicies();
+
+// Export a single policy by ID
+const singlePolicy: RapPolicy = await context.rapService.exportPolicy('<policy_id>');
+```
+
+**Import policies**
+```javascript
+// Import policies into the current tenant (e.g. from an export)
+const importedPolicies: RapPolicy[] = await context.rapService.importPolicies(allPolicies);
+
+// Import a single policy
+const importedPolicy: RapPolicy = await context.rapService.importPolicy(singlePolicy);
+```
+
+**Deploy policies (replace all)**
+```javascript
+// Replace all policies in the target tenant with the exported set
+// This deletes existing policies first, then imports the new ones
+const deployedPolicies: RapPolicy[] = await context.rapService.deployPolicies(allPolicies);
+```
+
+**Delete all policies**
+```javascript
+// Remove all policies from the current tenant
+const deletedCount: number = await context.rapService.deleteAllPolicies();
+```
+
+**Copy policies between tenants**
+```javascript
+// 1. Export from source tenant
+const sourceContext = ExecutionContext.fromCredentials({
+  apiServer: "https://api.skedulo.com",
+  apiToken: sourceToken,
+});
+const policies = await sourceContext.rapService.exportPolicies();
+
+// 2. Import into target tenant
+const targetContext = ExecutionContext.fromCredentials({
+  apiServer: "https://api.skedulo.com",
+  apiToken: targetToken,
+});
+const imported = await targetContext.rapService.importPolicies(policies);
+
+// Or replace all policies in the target tenant
+const deployed = await targetContext.rapService.deployPolicies(policies);
+```
+
 ### GraphQL Service
 
 #### Query data

package/dist/clients/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("./artifact-client"),exports),__exportStar(require("./availability-api-client"),exports),__exportStar(require("./base-client"),exports),__exportStar(require("./config-features-client"),exports),__exportStar(require("./config-template-client"),exports),__exportStar(require("./config-var-client"),exports),__exportStar(require("./files-api-client"),exports),__exportStar(require("./geo-api-client"),exports),__exportStar(require("./graphql-client"),exports),__exportStar(require("./metadata-client"),exports),__exportStar(require("./mobile-notification-client"),exports),__exportStar(require("./org-preference-client"),exports),__exportStar(require("./vocabulary-client"),exports);
+"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("./artifact-client"),exports),__exportStar(require("./availability-api-client"),exports),__exportStar(require("./base-client"),exports),__exportStar(require("./config-features-client"),exports),__exportStar(require("./config-template-client"),exports),__exportStar(require("./config-var-client"),exports),__exportStar(require("./files-api-client"),exports),__exportStar(require("./geo-api-client"),exports),__exportStar(require("./graphql-client"),exports),__exportStar(require("./metadata-client"),exports),__exportStar(require("./mobile-notification-client"),exports),__exportStar(require("./org-preference-client"),exports),__exportStar(require("./rap-client"),exports),__exportStar(require("./vocabulary-client"),exports);

package/dist/clients/rap-client.js

@@ -0,0 +1 @@
+"use strict";var __decorate=this&&this.__decorate||function(t,e,n,a){var o,i=arguments.length,r=i<3?e:null===a?a=Object.getOwnPropertyDescriptor(e,n):a;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)r=Reflect.decorate(t,e,n,a);else for(var _=t.length-1;_>=0;_--)(o=t[_])&&(r=(i<3?o(r):i>3?o(e,n,r):o(e,n))||r);return i>3&&r&&Object.defineProperty(e,n,r),r},__metadata=this&&this.__metadata||function(t,e){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(t,e)},__awaiter=this&&this.__awaiter||function(t,e,n,a){return new(n||(n=Promise))(function(o,i){function r(t){try{d(a.next(t))}catch(t){i(t)}}function _(t){try{d(a.throw(t))}catch(t){i(t)}}function d(t){var e;t.done?o(t.value):(e=t.value,e instanceof n?e:new n(function(t){t(e)})).then(r,_)}d((a=a.apply(t,e||[])).next())})};Object.defineProperty(exports,"__esModule",{value:!0}),exports.RapClient=void 0;const constants_1=require("../constants"),monitor_call_1=require("../monitoring/decorators/monitor-call"),base_client_1=require("./base-client");class RapClient extends base_client_1.BaseClient{getPolicies(){return __awaiter(this,void 0,void 0,function*(){return yield this._performRequest({endpoint:constants_1.TENANT_ENDPOINTS.RAP.POLICIES})})}getPolicy(t){return __awaiter(this,void 0,void 0,function*(){return yield this._performRequest({endpoint:constants_1.TENANT_ENDPOINTS.RAP.POLICY(t)})})}createPolicy(t){return __awaiter(this,void 0,void 0,function*(){return yield this._performRequest({method:constants_1.HttpMethod.POST,endpoint:constants_1.TENANT_ENDPOINTS.RAP.POLICIES,body:t})})}updatePolicy(t,e){return __awaiter(this,void 0,void 0,function*(){return yield this._performRequest({method:constants_1.HttpMethod.PUT,endpoint:constants_1.TENANT_ENDPOINTS.RAP.POLICY(t),body:e})})}deletePolicy(t){return __awaiter(this,void 0,void 0,function*(){return yield this._performRequest({method:constants_1.HttpMethod.DELETE,endpoint:constants_1.TENANT_ENDPOINTS.RAP.POLICY(t)})})}createRule(t){return __awaiter(this,void 0,void 0,function*(){return yield this._performRequest({method:constants_1.HttpMethod.POST,endpoint:constants_1.TENANT_ENDPOINTS.RAP.RULES,body:t})})}updateRule(t,e){return __awaiter(this,void 0,void 0,function*(){return yield this._performRequest({method:constants_1.HttpMethod.PUT,endpoint:constants_1.TENANT_ENDPOINTS.RAP.RULE(t),body:e})})}deleteRule(t){return __awaiter(this,void 0,void 0,function*(){return yield this._performRequest({method:constants_1.HttpMethod.DELETE,endpoint:constants_1.TENANT_ENDPOINTS.RAP.RULE(t)})})}getTemplates(){return __awaiter(this,void 0,void 0,function*(){return yield this._performRequest({endpoint:constants_1.TENANT_ENDPOINTS.RAP.TEMPLATES})})}applyTemplate(t){return __awaiter(this,void 0,void 0,function*(){return yield this._performRequest({method:constants_1.HttpMethod.POST,endpoint:constants_1.TENANT_ENDPOINTS.RAP.APPLY_TEMPLATE(t)})})}}exports.RapClient=RapClient,__decorate([(0,monitor_call_1.MonitorCall)(),__metadata("design:type",Function),__metadata("design:paramtypes",[]),__metadata("design:returntype",Promise)],RapClient.prototype,"getPolicies",null),__decorate([(0,monitor_call_1.MonitorCall)(),__metadata("design:type",Function),__metadata("design:paramtypes",[String]),__metadata("design:returntype",Promise)],RapClient.prototype,"getPolicy",null),__decorate([(0,monitor_call_1.MonitorCall)(),__metadata("design:type",Function),__metadata("design:paramtypes",[Object]),__metadata("design:returntype",Promise)],RapClient.prototype,"createPolicy",null),__decorate([(0,monitor_call_1.MonitorCall)(),__metadata("design:type",Function),__metadata("design:paramtypes",[String,Object]),__metadata("design:returntype",Promise)],RapClient.prototype,"updatePolicy",null),__decorate([(0,monitor_call_1.MonitorCall)(),__metadata("design:type",Function),__metadata("design:paramtypes",[String]),__metadata("design:returntype",Promise)],RapClient.prototype,"deletePolicy",null),__decorate([(0,monitor_call_1.MonitorCall)(),__metadata("design:type",Function),__metadata("design:paramtypes",[Object]),__metadata("design:returntype",Promise)],RapClient.prototype,"createRule",null),__decorate([(0,monitor_call_1.MonitorCall)(),__metadata("design:type",Function),__metadata("design:paramtypes",[String,Object]),__metadata("design:returntype",Promise)],RapClient.prototype,"updateRule",null),__decorate([(0,monitor_call_1.MonitorCall)(),__metadata("design:type",Function),__metadata("design:paramtypes",[String]),__metadata("design:returntype",Promise)],RapClient.prototype,"deleteRule",null),__decorate([(0,monitor_call_1.MonitorCall)(),__metadata("design:type",Function),__metadata("design:paramtypes",[]),__metadata("design:returntype",Promise)],RapClient.prototype,"getTemplates",null),__decorate([(0,monitor_call_1.MonitorCall)(),__metadata("design:type",Function),__metadata("design:paramtypes",[String]),__metadata("design:returntype",Promise)],RapClient.prototype,"applyTemplate",null);

package/dist/constants/tenant-endpoints.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.TENANT_ENDPOINTS=void 0,exports.TENANT_ENDPOINTS={CONFIG_VAR:{CREATE:"configuration/extension",GET:e=>`configuration/extension/${e}`,UPDATE:e=>`configuration/extension/${e}`,DELETE:e=>`configuration/extension/${e}`,SEARCH:"configuration/extension/search"},GRAPHQL:{SINGLE:"graphql/graphql",BATCH:"graphql/graphql/batch"},METADATA:{ALL:"custom/metadata",OBJECT:e=>`custom/metadata/${e}`},ORG_PREFERENCE:{GET:"config/org_preference",UPDATE:"config/org_preference"},CONFIG_TEMPLATE:{GET_TEMPLATES:e=>`config/templates/${e}`,GET_VALUES:e=>`config/template/${e}/values`,UPDATE_VALUES:e=>`config/template/${e}/values`,CREATE:"config/template",DELETE:e=>`config/template/${e}`},CONFIG_FEATURES:{GET:"config/features",UPDATE:e=>`config/features/${e}`},VOCABULARY:{GET_ITEMS:(e,t)=>`custom/vocabulary/${e}/${t}`,ADD_ITEM:(e,t)=>`custom/vocabulary/${e}/${t}`,UPDATE_ITEM:(e,t,i)=>`custom/vocabulary/${e}/${t}/${i}`},NOTIFICATIONS:{GET_TEMPLATES:"notifications/v2/templates",DELETE_TEMPLATE:(e,t)=>`notifications/v2/template/${e}/${t}`,SET_TEMPLATE:(e,t)=>`notifications/v2/template/${e}/${t}`,DISPATCH:"notifications/dispatch",NOTIFY:"notifications/notify",NOTIFY_CANCEL:"notifications/notify_cancel",ONE_OFF:"notifications/oneoff",SEND_SMS:"notifications/sms",SMS_CONFIRMATION_REQUEST:"notifications/sms/confirmation_request"},GEOSERVICES:{DISTANCE_MATRIX:"geoservices/distanceMatrix",DIRECTIONS:"geoservices/directions",GEOCODE:"geoservices/geocode",AUTOCOMPLETE:"geoservices/autocomplete",PLACE:"geoservices/place",TIMEZONE:"geoservices/timezone"},AVAILABILITY:{SIMPLE:"availability/simple",PATTERNS:"availability/patterns"},FILES:{AVATAR:"files/avatar",ATTACHMENTS:e=>`files/attachments/${e}`}};
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.TENANT_ENDPOINTS=void 0,exports.TENANT_ENDPOINTS={CONFIG_VAR:{CREATE:"configuration/extension",GET:i=>`configuration/extension/${i}`,UPDATE:i=>`configuration/extension/${i}`,DELETE:i=>`configuration/extension/${i}`,SEARCH:"configuration/extension/search"},GRAPHQL:{SINGLE:"graphql/graphql",BATCH:"graphql/graphql/batch"},METADATA:{ALL:"custom/metadata",OBJECT:i=>`custom/metadata/${i}`},ORG_PREFERENCE:{GET:"config/org_preference",UPDATE:"config/org_preference"},CONFIG_TEMPLATE:{GET_TEMPLATES:i=>`config/templates/${i}`,GET_VALUES:i=>`config/template/${i}/values`,UPDATE_VALUES:i=>`config/template/${i}/values`,CREATE:"config/template",DELETE:i=>`config/template/${i}`},CONFIG_FEATURES:{GET:"config/features",UPDATE:i=>`config/features/${i}`},VOCABULARY:{GET_ITEMS:(i,e)=>`custom/vocabulary/${i}/${e}`,ADD_ITEM:(i,e)=>`custom/vocabulary/${i}/${e}`,UPDATE_ITEM:(i,e,t)=>`custom/vocabulary/${i}/${e}/${t}`},NOTIFICATIONS:{GET_TEMPLATES:"notifications/v2/templates",DELETE_TEMPLATE:(i,e)=>`notifications/v2/template/${i}/${e}`,SET_TEMPLATE:(i,e)=>`notifications/v2/template/${i}/${e}`,DISPATCH:"notifications/dispatch",NOTIFY:"notifications/notify",NOTIFY_CANCEL:"notifications/notify_cancel",ONE_OFF:"notifications/oneoff",SEND_SMS:"notifications/sms",SMS_CONFIRMATION_REQUEST:"notifications/sms/confirmation_request"},GEOSERVICES:{DISTANCE_MATRIX:"geoservices/distanceMatrix",DIRECTIONS:"geoservices/directions",GEOCODE:"geoservices/geocode",AUTOCOMPLETE:"geoservices/autocomplete",PLACE:"geoservices/place",TIMEZONE:"geoservices/timezone"},AVAILABILITY:{SIMPLE:"availability/simple",PATTERNS:"availability/patterns"},FILES:{AVATAR:"files/avatar",ATTACHMENTS:i=>`files/attachments/${i}`},RAP:{POLICIES:"authorization/policies",POLICY:i=>`authorization/policies/${i}`,TEMPLATES:"authorization/policies/templates",APPLY_TEMPLATE:i=>`authorization/policies/templates/${i}/apply`,RULES:"authorization/policies/rules",RULE:i=>`authorization/policies/rules/${i}`}};

package/dist/core/execution-context.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.ExecutionContext=void 0;const function_utilities_1=require("@skedulo/function-utilities"),clients_1=require("../clients"),artifact_client_1=require("../clients/artifact-client"),availability_api_client_1=require("../clients/availability-api-client"),config_features_client_1=require("../clients/config-features-client"),config_template_client_1=require("../clients/config-template-client"),config_var_client_1=require("../clients/config-var-client"),files_api_client_1=require("../clients/files-api-client"),geo_api_client_1=require("../clients/geo-api-client"),graphql_client_1=require("../clients/graphql-client"),metadata_client_1=require("../clients/metadata-client"),mobile_notification_client_1=require("../clients/mobile-notification-client"),org_preference_client_1=require("../clients/org-preference-client"),vocabulary_client_1=require("../clients/vocabulary-client"),logger_1=__importDefault(require("../logging/logger")),monitoring_constants_1=require("../monitoring/monitoring-constants"),monitoring_registry_1=require("../monitoring/monitoring-registry"),cache_service_1=require("../services/cache/cache-service"),storage_1=require("../services/cache/storage"),geoservice_1=require("../services/geoservice"),graphql_1=require("../services/graphql"),lock_service_1=require("../services/lock-service"),metadata_service_1=require("../services/metadata-service"),data_service_1=require("../services/resource-availability/builder/data-service"),resource_availability_service_1=require("../services/resource-availability/builder/resource-availability-service"),resource_builder_1=require("../services/resource-availability/builder/resource-builder"),utils_1=require("../utils"),request_header_constants_1=require("./request-header-constants");class ExecutionContext{constructor(e,i={},t){this.logger=logger_1.default,this.services=new Map,this.skedContext=e,this.contextData={},this._executionOptions=i,this.baseConfig={apiToken:e.auth.token,apiServer:e.auth.baseUrl},(0,monitoring_registry_1.initGlobalMonitorManager)(t)}static fromContext(e,i={},t=monitoring_constants_1.DEFAULT_THRESHOLD_CONFIG){return new ExecutionContext(e,i,Object.assign(Object.assign({},monitoring_constants_1.DEFAULT_THRESHOLD_CONFIG),t))}static fromCredentials(e,i={},t=monitoring_constants_1.DEFAULT_THRESHOLD_CONFIG){const r={Authorization:`Bearer ${e.apiToken}`,[request_header_constants_1.REQUEST_HEADERS.SKED_API_SERVER]:e.apiServer},n=(0,function_utilities_1.createSkedContext)(r);return new ExecutionContext(n,i,Object.assign(Object.assign({},monitoring_constants_1.DEFAULT_THRESHOLD_CONFIG),t))}set executionOptions(e){this._executionOptions=Object.assign(Object.assign({},this._executionOptions),e)}get executionOptions(){return this._executionOptions}getOrCreateService(e,i){return this.services.has(e)||this.services.set(e,i()),this.services.get(e)}get configHelper(){return this.getOrCreateService("configHelper",()=>new utils_1.ConfigHelper(this.skedContext.configVars))}get baseClient(){return this.getOrCreateService("baseClient",()=>new clients_1.BaseClient(this.baseConfig,this.executionOptions))}get graphqlClient(){return this.getOrCreateService("graphqlClient",()=>new graphql_client_1.GraphQLClient(this.baseConfig,this.executionOptions))}get graphqlService(){return this.getOrCreateService("graphqlService",()=>new graphql_1.GraphQLService(this.graphqlClient))}get metadataClient(){return this.getOrCreateService("metadataClient",()=>new metadata_client_1.MetadataClient(this.baseConfig,this.executionOptions))}get metadataService(){return this.getOrCreateService("metadataService",()=>new metadata_service_1.MetadataService(this.metadataClient))}get vocabularyClient(){return this.getOrCreateService("vocabularyClient",()=>new vocabulary_client_1.VocabularyClient(this.baseConfig,this.executionOptions))}get orgPreferencesClient(){return this.getOrCreateService("orgPreferencesClient",()=>new org_preference_client_1.OrgPreferenceClient(this.baseConfig,this.executionOptions))}get configTemplateClient(){return this.getOrCreateService("configTemplateClient",()=>new config_template_client_1.ConfigTemplateClient(this.baseConfig,this.executionOptions))}get configFeaturesClient(){return this.getOrCreateService("configFeaturesClient",()=>new config_features_client_1.ConfigFeaturesClient(this.baseConfig,this.executionOptions))}get configVarClient(){return this.getOrCreateService("configVarClient",()=>new config_var_client_1.ConfigVarClient(this.baseConfig,this.executionOptions))}get mobileNotificationClient(){return this.getOrCreateService("mobileNotificationClient",()=>new mobile_notification_client_1.MobileNotificationClient(this.baseConfig,this.executionOptions))}get geoAPIClient(){return this.getOrCreateService("geoAPIClient",()=>new geo_api_client_1.GeoAPIClient(this.baseConfig,this.executionOptions))}get availabilityAPIClient(){return this.getOrCreateService("availabilityAPIClient",()=>new availability_api_client_1.AvailabilityAPIClient(this.baseConfig,this.executionOptions))}get filesAPIClient(){return this.getOrCreateService("filesAPIClient",()=>new files_api_client_1.FilesAPIClient(this.baseConfig,this.executionOptions))}get geoService(){return this.getOrCreateService("geoService",()=>new geoservice_1.GeoService(this.geoAPIClient))}get lockService(){return this.getOrCreateService("lockService",()=>new lock_service_1.LockService(this.configVarClient))}get configVarCache(){return this.getOrCreateService("configVarCache",()=>new cache_service_1.CacheService(new storage_1.ConfigVarCacheStorage(this.configVarClient)))}get inMemoryCache(){return this.getOrCreateService("inMemoryCache",()=>{const e=new cache_service_1.CacheService(new storage_1.InMemoryCacheStorage);return e.setSecondaryCache(this.configVarCache),e})}get resourceAvailabilityService(){return this.getOrCreateService("resourceAvailabilityService",()=>new resource_availability_service_1.ResourceAvailabilityService(this.availabilityAPIClient))}get dataService(){return this.getOrCreateService("dataService",()=>new data_service_1.DataService(this.graphqlService))}get resourceBuilder(){return this.getOrCreateService("resourceBuilder",()=>new resource_builder_1.ResourceBuilder(this.dataService,this.resourceAvailabilityService))}newQueryBuilder(e){const i=new graphql_1.GraphQLQueryBuilder(e);return i.setGraphqlService(this.graphqlService),i}newArtifactClient(e){return this.getOrCreateService(`${e}Client`,()=>new artifact_client_1.ArtifactClient(this.baseConfig,e,this.executionOptions))}dispose(){this.services.clear()}getExecutionMetrics(){return(0,monitoring_registry_1.getGlobalMonitorManager)().getExecutionMetrics()}}exports.ExecutionContext=ExecutionContext,ExecutionContext.instance=null;
+"use strict";var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.ExecutionContext=void 0;const function_utilities_1=require("@skedulo/function-utilities"),clients_1=require("../clients"),artifact_client_1=require("../clients/artifact-client"),availability_api_client_1=require("../clients/availability-api-client"),config_features_client_1=require("../clients/config-features-client"),config_template_client_1=require("../clients/config-template-client"),config_var_client_1=require("../clients/config-var-client"),files_api_client_1=require("../clients/files-api-client"),geo_api_client_1=require("../clients/geo-api-client"),graphql_client_1=require("../clients/graphql-client"),metadata_client_1=require("../clients/metadata-client"),mobile_notification_client_1=require("../clients/mobile-notification-client"),org_preference_client_1=require("../clients/org-preference-client"),rap_client_1=require("../clients/rap-client"),vocabulary_client_1=require("../clients/vocabulary-client"),logger_1=__importDefault(require("../logging/logger")),monitoring_constants_1=require("../monitoring/monitoring-constants"),monitoring_registry_1=require("../monitoring/monitoring-registry"),cache_service_1=require("../services/cache/cache-service"),storage_1=require("../services/cache/storage"),geoservice_1=require("../services/geoservice"),graphql_1=require("../services/graphql"),lock_service_1=require("../services/lock-service"),metadata_service_1=require("../services/metadata-service"),rap_service_1=require("../services/rap-service"),data_service_1=require("../services/resource-availability/builder/data-service"),resource_availability_service_1=require("../services/resource-availability/builder/resource-availability-service"),resource_builder_1=require("../services/resource-availability/builder/resource-builder"),utils_1=require("../utils"),request_header_constants_1=require("./request-header-constants");class ExecutionContext{constructor(e,i={},t){this.logger=logger_1.default,this.services=new Map,this.skedContext=e,this.contextData={},this._executionOptions=i,this.baseConfig={apiToken:e.auth.token,apiServer:e.auth.baseUrl},(0,monitoring_registry_1.initGlobalMonitorManager)(t)}static fromContext(e,i={},t=monitoring_constants_1.DEFAULT_THRESHOLD_CONFIG){return new ExecutionContext(e,i,Object.assign(Object.assign({},monitoring_constants_1.DEFAULT_THRESHOLD_CONFIG),t))}static fromCredentials(e,i={},t=monitoring_constants_1.DEFAULT_THRESHOLD_CONFIG){const r={Authorization:`Bearer ${e.apiToken}`,[request_header_constants_1.REQUEST_HEADERS.SKED_API_SERVER]:e.apiServer},n=(0,function_utilities_1.createSkedContext)(r);return new ExecutionContext(n,i,Object.assign(Object.assign({},monitoring_constants_1.DEFAULT_THRESHOLD_CONFIG),t))}set executionOptions(e){this._executionOptions=Object.assign(Object.assign({},this._executionOptions),e)}get executionOptions(){return this._executionOptions}getOrCreateService(e,i){return this.services.has(e)||this.services.set(e,i()),this.services.get(e)}get configHelper(){return this.getOrCreateService("configHelper",()=>new utils_1.ConfigHelper(this.skedContext.configVars))}get baseClient(){return this.getOrCreateService("baseClient",()=>new clients_1.BaseClient(this.baseConfig,this.executionOptions))}get graphqlClient(){return this.getOrCreateService("graphqlClient",()=>new graphql_client_1.GraphQLClient(this.baseConfig,this.executionOptions))}get graphqlService(){return this.getOrCreateService("graphqlService",()=>new graphql_1.GraphQLService(this.graphqlClient))}get metadataClient(){return this.getOrCreateService("metadataClient",()=>new metadata_client_1.MetadataClient(this.baseConfig,this.executionOptions))}get metadataService(){return this.getOrCreateService("metadataService",()=>new metadata_service_1.MetadataService(this.metadataClient))}get vocabularyClient(){return this.getOrCreateService("vocabularyClient",()=>new vocabulary_client_1.VocabularyClient(this.baseConfig,this.executionOptions))}get orgPreferencesClient(){return this.getOrCreateService("orgPreferencesClient",()=>new org_preference_client_1.OrgPreferenceClient(this.baseConfig,this.executionOptions))}get configTemplateClient(){return this.getOrCreateService("configTemplateClient",()=>new config_template_client_1.ConfigTemplateClient(this.baseConfig,this.executionOptions))}get configFeaturesClient(){return this.getOrCreateService("configFeaturesClient",()=>new config_features_client_1.ConfigFeaturesClient(this.baseConfig,this.executionOptions))}get configVarClient(){return this.getOrCreateService("configVarClient",()=>new config_var_client_1.ConfigVarClient(this.baseConfig,this.executionOptions))}get mobileNotificationClient(){return this.getOrCreateService("mobileNotificationClient",()=>new mobile_notification_client_1.MobileNotificationClient(this.baseConfig,this.executionOptions))}get geoAPIClient(){return this.getOrCreateService("geoAPIClient",()=>new geo_api_client_1.GeoAPIClient(this.baseConfig,this.executionOptions))}get availabilityAPIClient(){return this.getOrCreateService("availabilityAPIClient",()=>new availability_api_client_1.AvailabilityAPIClient(this.baseConfig,this.executionOptions))}get filesAPIClient(){return this.getOrCreateService("filesAPIClient",()=>new files_api_client_1.FilesAPIClient(this.baseConfig,this.executionOptions))}get geoService(){return this.getOrCreateService("geoService",()=>new geoservice_1.GeoService(this.geoAPIClient))}get lockService(){return this.getOrCreateService("lockService",()=>new lock_service_1.LockService(this.configVarClient))}get configVarCache(){return this.getOrCreateService("configVarCache",()=>new cache_service_1.CacheService(new storage_1.ConfigVarCacheStorage(this.configVarClient)))}get inMemoryCache(){return this.getOrCreateService("inMemoryCache",()=>{const e=new cache_service_1.CacheService(new storage_1.InMemoryCacheStorage);return e.setSecondaryCache(this.configVarCache),e})}get rapClient(){return this.getOrCreateService("rapClient",()=>new rap_client_1.RapClient(this.baseConfig,this.executionOptions))}get rapService(){return this.getOrCreateService("rapService",()=>new rap_service_1.RapService(this.rapClient))}get resourceAvailabilityService(){return this.getOrCreateService("resourceAvailabilityService",()=>new resource_availability_service_1.ResourceAvailabilityService(this.availabilityAPIClient))}get dataService(){return this.getOrCreateService("dataService",()=>new data_service_1.DataService(this.graphqlService))}get resourceBuilder(){return this.getOrCreateService("resourceBuilder",()=>new resource_builder_1.ResourceBuilder(this.dataService,this.resourceAvailabilityService))}newQueryBuilder(e){const i=new graphql_1.GraphQLQueryBuilder(e);return i.setGraphqlService(this.graphqlService),i}newArtifactClient(e){return this.getOrCreateService(`${e}Client`,()=>new artifact_client_1.ArtifactClient(this.baseConfig,e,this.executionOptions))}dispose(){this.services.clear()}getExecutionMetrics(){return(0,monitoring_registry_1.getGlobalMonitorManager)().getExecutionMetrics()}}exports.ExecutionContext=ExecutionContext,ExecutionContext.instance=null;

package/dist/index.d.ts

@@ -117,6 +117,14 @@ export declare const TENANT_ENDPOINTS: {
 		readonly AVATAR: "files/avatar";
 		readonly ATTACHMENTS: (parentId: string) => string;
 	};
+	readonly RAP: {
+		readonly POLICIES: "authorization/policies";
+		readonly POLICY: (policyId: string) => string;
+		readonly TEMPLATES: "authorization/policies/templates";
+		readonly APPLY_TEMPLATE: (templateId: string) => string;
+		readonly RULES: "authorization/policies/rules";
+		readonly RULE: (ruleId: string) => string;
+	};
 };
 /**
  * Represents execution options for GraphQL requests.
@@ -952,6 +960,74 @@ export declare class OrgPreferenceClient extends BaseClient {
 	 */
 	deploy(newConfig: Record<string, any>): Promise<Record<string, any>>;
 }
+export interface RapRule {
+	id?: string;
+	policyId: string;
+	description: string;
+	objectType: string;
+	filter: string;
+	accessType: "deny";
+	permissionsExcluded: string[];
+}
+export interface RapPolicy {
+	id?: string;
+	name: string;
+	description: string;
+	enabled: boolean;
+	rules?: RapRule[];
+}
+export interface RapTemplate {
+	id: string;
+	name: string;
+	description: string;
+}
+/**
+ * Client for managing Record Access Policies (RAP) through the Authorization API.
+ * Provides methods to create, retrieve, update, and delete policies and rules,
+ * as well as manage policy templates.
+ */
+export declare class RapClient extends BaseClient {
+	/**
+	 * Retrieves all policies.
+	 */
+	getPolicies(): Promise<RapPolicy[]>;
+	/**
+	 * Retrieves a single policy by ID.
+	 */
+	getPolicy(policyId: string): Promise<RapPolicy>;
+	/**
+	 * Creates a new policy. Optionally include rules in the payload.
+	 */
+	createPolicy(policy: RapPolicy): Promise<RapPolicy>;
+	/**
+	 * Updates an existing policy by ID.
+	 */
+	updatePolicy(policyId: string, policy: Partial<RapPolicy>): Promise<RapPolicy>;
+	/**
+	 * Deletes a policy by ID.
+	 */
+	deletePolicy(policyId: string): Promise<void>;
+	/**
+	 * Creates a new rule linked to a policy.
+	 */
+	createRule(rule: RapRule): Promise<RapRule>;
+	/**
+	 * Updates an existing rule by ID.
+	 */
+	updateRule(ruleId: string, rule: RapRule): Promise<RapRule>;
+	/**
+	 * Deletes a rule by ID.
+	 */
+	deleteRule(ruleId: string): Promise<void>;
+	/**
+	 * Retrieves all available policy templates.
+	 */
+	getTemplates(): Promise<RapTemplate[]>;
+	/**
+	 * Applies a template to create a new policy.
+	 */
+	applyTemplate(templateId: string): Promise<RapPolicy>;
+}
 export interface VocabularyItem {
 	value: string;
 	label: string;
@@ -1400,6 +1476,59 @@ export declare class MetadataService {
 	 */
 	getPicklistValues(metadata: ObjectMetadata): Record<string, string[]>;
 }
+/**
+ * Service for exporting and importing Record Access Policies (RAP) between tenants.
+ * Wraps the RapClient to provide higher-level export/import operations.
+ */
+export declare class RapService {
+	private client;
+	constructor(client: RapClient);
+	/**
+	 * Exports all policies (with their rules) from the current tenant.
+	 *
+	 * @returns An array of policies including their nested rules.
+	 */
+	exportPolicies(): Promise<RapPolicy[]>;
+	/**
+	 * Imports an array of policies into the current tenant.
+	 * Each policy (and its rules) is created via the API. The API accepts
+	 * the full policy object including ID fields, so payloads exported from
+	 * a source tenant can be passed directly.
+	 *
+	 * @param policies - The policies to import, typically from {@link exportPolicies}.
+	 * @returns The created policies as returned by the API.
+	 */
+	importPolicies(policies: RapPolicy[]): Promise<RapPolicy[]>;
+	/**
+	 * Exports a single policy by ID.
+	 *
+	 * @param policyId - The ID of the policy to export.
+	 * @returns The policy including its rules.
+	 */
+	exportPolicy(policyId: string): Promise<RapPolicy>;
+	/**
+	 * Imports a single policy into the current tenant.
+	 *
+	 * @param policy - The policy to import.
+	 * @returns The created policy as returned by the API.
+	 */
+	importPolicy(policy: RapPolicy): Promise<RapPolicy>;
+	/**
+	 * Removes all policies from the current tenant.
+	 * Retrieves all policies first, then deletes each one.
+	 *
+	 * @returns The number of policies deleted.
+	 */
+	deleteAllPolicies(): Promise<number>;
+	/**
+	 * Replaces all policies in the current tenant with the provided set.
+	 * This deletes existing policies first, then imports the new ones.
+	 *
+	 * @param policies - The policies to deploy.
+	 * @returns The created policies as returned by the API.
+	 */
+	deployPolicies(policies: RapPolicy[]): Promise<RapPolicy[]>;
+}
 export declare class ResourceQueryParam {
 	resourceIds?: Set<string>;
 	regionIds?: Set<string>;
@@ -1535,6 +1664,8 @@ export declare class ExecutionContext {
 	get lockService(): LockService;
 	get configVarCache(): CacheService<any>;
 	get inMemoryCache(): CacheService<any>;
+	get rapClient(): RapClient;
+	get rapService(): RapService;
 	get resourceAvailabilityService(): ResourceAvailabilityService;
 	get dataService(): DataService;
 	get resourceBuilder(): ResourceBuilder;

package/dist/interfaces/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("./api-client"),exports),__exportStar(require("./availability"),exports),__exportStar(require("./config-template"),exports),__exportStar(require("./config-var"),exports),__exportStar(require("./files"),exports),__exportStar(require("./geoservice-interfaces"),exports),__exportStar(require("./graphql"),exports),__exportStar(require("./lock-service-interfaces"),exports),__exportStar(require("./metadata"),exports),__exportStar(require("./mobile-notification"),exports),__exportStar(require("./vocabulary"),exports);
+"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("./api-client"),exports),__exportStar(require("./availability"),exports),__exportStar(require("./config-template"),exports),__exportStar(require("./config-var"),exports),__exportStar(require("./files"),exports),__exportStar(require("./geoservice-interfaces"),exports),__exportStar(require("./graphql"),exports),__exportStar(require("./lock-service-interfaces"),exports),__exportStar(require("./metadata"),exports),__exportStar(require("./mobile-notification"),exports),__exportStar(require("./rap"),exports),__exportStar(require("./vocabulary"),exports);

package/dist/interfaces/rap.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});

package/dist/logging/decorators/index.d.ts

@@ -0,0 +1 @@
+export * from "./log-method";

package/dist/logging/decorators/log-method.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This decorator logs the input arguments and output results of a method,
+ * including error handling with ANSI color-coded logs for better console readability.
+ * It allows selective logging based on the `LOG_NAMESPACE` environment variable.
+ * Uses Winston logger but retains ANSI colors for console logs.
+ */
+export declare function LogMethod(namespace?: string): (target: any, propertyKey: any, descriptor: any) => any;

package/dist/monitoring/decorators/monitor-call.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Decorator factory that takes a MonitoringManager instance and an optional
+ * explicit methodIdentifier override. If not provided, the decorator will
+ * default to ClassName.MethodName.
+ */
+export declare function MonitorCall(methodIdentifier?: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

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

@@ -0,0 +1,70 @@
+export declare class CacheService<T> {
+    private storage;
+    private secondaryCache?;
+    /**
+     * Creates an instance of CacheService.
+     * @param {CacheStorage<string>} storage - The cache storage implementation.
+     */
+    constructor(storage: CacheStorage<string>);
+    /**
+     * Sets a secondary cache service to use as a fallback.
+     * @param {CacheService<T>} secondaryCache - The secondary cache service.
+     * @returns {void}
+     */
+    setSecondaryCache(secondaryCache: CacheService<T>): void;
+    /**
+     * Retrieves a cached value by key.
+     * If the value is not found, it attempts to retrieve it from a secondary service or loader.
+     * @param {string} key - The cache key.
+     * @param {object} options - Optional parameters.
+     * @param {CacheLoader<T>} [options.loader] - A function to load the value if not cached.
+     * @param {boolean} [options.useSecondaryCache] - Whether to use the secondary cache service.
+     * @returns {Promise<T | null>} - The cached value or null if not found or expired.
+     */
+    get(key: string, options?: CacheOptions<T>): Promise<T | null>;
+    /**
+     * Stores a value in the cache with an optional TTL.
+     * @param {string} key - The cache key.
+     * @param {T} value - The value to store.
+     * @param {object} options - Optional parameters.
+     * @returns {Promise<void>}
+     */
+    set(key: string, value: T, options?: CacheOptions<T>): Promise<void>;
+    /**
+     * Deletes a specific key from the cache.
+     * @param {string} key - The cache key to delete.
+     * @returns {Promise<void>}
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clears all cache entries.
+     * @returns {Promise<void>}
+     */
+    clear(): Promise<void>;
+    /**
+     * Adds the cache key prefix to a key if it is not already present.
+     * @param {string} key - The cache key.
+     * @returns {string} - The key with the prefix
+     */
+    addPrefix(key: string): string;
+    /**
+     * Deserializes the cached metadata and returns the original value in the correct type.
+     * @param {any} metadata - The cached metadata object.
+     * @returns {T} - The deserialized value.
+     */
+    private deserialize;
+}
+/**
+ * Interface for cache storage.
+ * This defines the basic storage operations without loader logic.
+ */
+export interface CacheStorage<T = any> {
+    set(key: string, value: T): Promise<void>;
+    get(key: string): Promise<T | null>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+export interface CacheOptions<T> {
+    ttl?: number;
+    useSecondaryCache?: boolean;
+}

package/dist/services/cache/index.d.ts

@@ -0,0 +1 @@
+export * from "./cache-service";

package/dist/services/cache/storage/config-var-cache-storage.d.ts

@@ -0,0 +1,40 @@
+import { ConfigVarClient } from "../../../clients";
+import { CacheStorage } from "../cache-service";
+/**
+ * Implementation of CacheStorage using ConfigVarClient.
+ * This class interacts with a configuration variable service to store and retrieve values.
+ */
+export declare class ConfigVarCacheStorage<T = any> implements CacheStorage<T> {
+    private configVarClient;
+    /**
+     * Creates an instance of ConfigVarCacheStorage.
+     * @param {ConfigVarClient} configVarService - The client used to interact with the configuration variable service.
+     */
+    constructor(configVarService: ConfigVarClient);
+    /**
+     * Stores a value in the configuration variable service.
+     * If the key already exists, it updates the value.
+     * @param {string} key - The cache key.
+     * @param {T} value - The value to store.
+     * @returns {Promise<void>}
+     */
+    set(key: string, value: T): Promise<void>;
+    /**
+     * Retrieves a cached value by key from the configuration variable service.
+     * @param {string} key - The cache key.
+     * @returns {Promise<T | null>} - The cached value or null if not found.
+     */
+    get(key: string): Promise<T | null>;
+    /**
+     * Deletes a specific key from the cache.
+     * @param {string} key - The cache key to delete.
+     * @returns {Promise<void>}
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clears all cache entries.
+     * Note: This operation is not supported by ConfigVarCacheStorage.
+     * @returns {Promise<void>}
+     */
+    clear(): Promise<void>;
+}

package/dist/services/cache/storage/in-memory-cache-storage.d.ts

@@ -0,0 +1,32 @@
+import { CacheStorage } from "../cache-service";
+/**
+ * Implementation of CacheStorage using an in-memory Map.
+ * This class provides a simple key-value store that resides in memory.
+ */
+export declare class InMemoryCacheStorage<T = any> implements CacheStorage<T> {
+    private cache;
+    /**
+     * Stores a value in the cache.
+     * @param {string} key - The cache key.
+     * @param {T} value - The value to store.
+     * @returns {Promise<void>}
+     */
+    set(key: string, value: T): Promise<void>;
+    /**
+     * Retrieves a cached value by key.
+     * @param {string} key - The cache key.
+     * @returns {Promise<T | null>} - The cached value or null if not found.
+     */
+    get(key: string): Promise<T | null>;
+    /**
+     * Deletes a specific key from the cache.
+     * @param {string} key - The cache key to delete.
+     * @returns {Promise<void>}
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clears all cache entries.
+     * @returns {Promise<void>}
+     */
+    clear(): Promise<void>;
+}

package/dist/services/cache/storage/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./config-var-cache-storage";
+export * from "./in-memory-cache-storage";

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

@@ -0,0 +1,18 @@
+import { PaginationStrategy } from "../pagination-strategy";
+/**
+ * Default configuration values for `GraphBatchConfig`.
+ */
+export declare const DEFAULT_GRAPH_BATCH_CONFIG: GraphBatchConfig;
+/**
+ * Configuration options for `GraphBatch`.
+ */
+export interface GraphBatchConfig {
+    strategy: PaginationStrategy;
+    batchSize: number;
+    maxBatches: number;
+    delaySeconds: number;
+}
+/**
+ * Merges user-provided config with default values.
+ */
+export declare function initializeConfig(config: Partial<GraphBatchConfig> | undefined): GraphBatchConfig;

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

@@ -0,0 +1,16 @@
+import { GraphBatchConfig } from "./graph-batch-config";
+/**
+ * Default configuration values for `UniqueGraphBatchConfig`.
+ */
+export declare const DEFAULT_UNIQUE_GRAPH_BATCH_CONFIG: UniqueGraphBatchConfig;
+/**
+ * Configuration options for `UniqueGraphBatch`.
+ */
+export interface UniqueGraphBatchConfig extends GraphBatchConfig {
+    name?: string;
+    lockTtl?: number;
+}
+/**
+ * Merges user-provided config with default values for `UniqueGraphBatch`.
+ */
+export declare function initializeUniqueConfig(config: Partial<UniqueGraphBatchConfig> | undefined): UniqueGraphBatchConfig;

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/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/pagination-strategy.d.ts

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

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/graphql/graphql-query-builder.d.ts

@@ -0,0 +1,93 @@
+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?;
+    private limit?;
+    private offset?;
+    private orderBy?;
+    private after?;
+    private parentQueries;
+    private childQueries;
+    private isParent;
+    private graphqlService;
+    private queryParams;
+    /**
+     * Creates an instance of GraphQLQueryBuilder.
+     * @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);
+    /**
+     * Sets the GraphQL service to use for executing the query.
+     */
+    setGraphqlService(graphqlService: GraphQLService): void;
+    /**
+     * Specifies the fields to be retrieved. Prevents duplicates.
+     */
+    withFields(fields: string[]): this;
+    /**
+     * Adds a filter condition to the query.
+     */
+    withFilter(condition: string): this;
+    /**
+     * Sets a limit on the number of records to retrieve using 'limit' parameter.
+     * This is the recommended approach.
+     */
+    withLimit(limit: number): this;
+    /**
+     * Sets a limit on the number of records to retrieve using 'first' parameter.
+     * Use this when you specifically need the 'first' parameter.
+     */
+    withFirst(first: number): this;
+    /**
+     * Sets an offset for pagination.
+     */
+    withOffset(offset: number): this;
+    /**
+     * Sets the order in which records should be retrieved.
+     */
+    withOrderBy(orderBy: string): this;
+    /**
+     * Applies cursor-based pagination.
+     */
+    withCursor(after: string): this;
+    /**
+     * Creates a parent query.
+     */
+    withParentQuery(objectName: string): GraphQLQueryBuilder;
+    /**
+     * Creates a child query.
+     */
+    withChildQuery(objectName: string): GraphQLQueryBuilder;
+    /**
+     * Recursively builds the GraphQL query fields, handling nested queries.
+     */
+    private formatQueryFields;
+    /**
+     * Builds the GraphQL query parameters in a structured format.
+     */
+    build(): GraphqlQueryParams;
+    /**
+     * 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.
+     */
+    toString(): string;
+}

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

@@ -1 +1 @@
-"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.limit=e,this}withFirst(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,limit:this.limit,offset:this.offset,orderBy:this.orderBy,after:this.after,readOnly:this.queryParams.readOnly}}execute(){return __awaiter(this,void 0,void 0,function*(){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,yield 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.limit||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],void 0!==this.limit?e.limit=o: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;
+"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.limit=e,this}withFirst(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(),i=[];r.filter&&i.push(`filter: "${r.filter}"`),r.orderBy&&i.push(`orderBy: "${r.orderBy}"`),void 0!==r.limit&&void 0!==this.limit&&i.push(`limit: ${r.limit}`);return`${e} ${i.length>0?`(${i.join(", ")})`:""} { ${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,limit:this.limit,offset:this.offset,orderBy:this.orderBy,after:this.after,readOnly:this.queryParams.readOnly}}execute(){return __awaiter(this,void 0,void 0,function*(){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,yield 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.limit||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.childQueries=Object.assign({},this.childQueries),e.parentQueries=Object.assign({},this.parentQueries),void 0!==this.limit?e.limit=o: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;

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

@@ -0,0 +1,106 @@
+import { GraphQLClient } from "../../clients/graphql-client";
+import { GraphqlMutationParams, GraphqlQueryParams, MutationResult, QueryResult } from "../../interfaces/graphql";
+import { GraphQLQueryBuilder } from "./graphql-query-builder";
+/**
+ * Service for executing GraphQL queries and mutations.
+ */
+export declare class GraphQLService {
+    private client;
+    /**
+     * Constructor to initialize the GraphQL client.
+     * @param {GraphQLClient} client - The GraphQL client instance.
+     */
+    constructor(client: GraphQLClient);
+    /**
+     * 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>;
+    /**
+     * 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.
+     */
+    mutateBatch(paramsArray: GraphqlMutationParams[]): Promise<MutationResult[]>;
+    /**
+     * 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: GraphqlMutationParams): Promise<MutationResult>;
+    /**
+     * 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: GraphqlMutationParams): Promise<MutationResult>;
+    /**
+     * 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: GraphqlMutationParams): Promise<MutationResult>;
+    /**
+     * 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.
+     */
+    upsert(params: GraphqlMutationParams): Promise<MutationResult>;
+    /**
+     * 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;
+}

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

@@ -0,0 +1,2 @@
+export * from "./graphql-query-builder";
+export * from "./graphql-service";

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

@@ -0,0 +1,20 @@
+import { GraphqlMutationParams, GraphqlQueryParams } from "../../interfaces/graphql";
+/**
+ * Constructs a GraphQL query to fetch records for a given object.
+ * @param {GraphqlQueryParams} params - The parameters for the GraphQL query.
+ * @returns {string} - The constructed GraphQL query string.
+ */
+export declare const FETCH_RECORDS_QUERY: ({ objectName, operationName, filter, first, limit, offset, after, orderBy, fields, }: GraphqlQueryParams) => string;
+/**
+ * Constructs a GraphQL mutation to delete objects.
+ * @param {GraphqlMutationParams} params - The parameters for the GraphQL mutation.
+ * @returns {string} - The constructed GraphQL mutation string.
+ */
+export declare const DELETE_OBJECTS_MUTATION: ({ objectName, operationName, records }: GraphqlMutationParams) => string;
+/**
+ * Constructs a GraphQL mutation to insert, update, or upsert objects.
+ * @param {GraphqlMutationParams} params - The parameters for the GraphQL mutation.
+ * @returns {string} - The constructed GraphQL mutation string.
+ * @throws {Error} - If the operation type is invalid.
+ */
+export declare const MUTATE_OBJECTS_MUTATION: ({ objectName, operationName, records, operation, keyField, }: GraphqlMutationParams) => string;

package/dist/services/graphql/queries.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.MUTATE_OBJECTS_MUTATION=exports.DELETE_OBJECTS_MUTATION=exports.FETCH_RECORDS_QUERY=void 0;const serializeGraphQLValue=e=>{if(Array.isArray(e)){return`[${e.map(e=>serializeGraphQLValue(e)).join(", ")}]`}return"string"==typeof e?`"${e}"`:String(e)},FETCH_RECORDS_QUERY=({objectName:e,operationName:n,filter:t,first:r=200,limit:i,offset:o=0,after:a,orderBy:s,fields:T})=>{const E=void 0!==i,$=E?i:r;return`\n    query ${n} {\n      ${e}(${[t?`filter: "${t}"`:"",a?`after: "${a}"`:"",E?`limit: ${$}`:`first: ${$}`,o?`offset: ${o}`:"",s?`orderBy: "${s}"`:""].filter(e=>e).join(", ")}) {\n        totalCount\n        pageInfo{\n          hasNextPage\n        }\n        edges {\n          cursor\n          offset\n          node {\n            ${T||"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 MUTATE_OBJECTS_MUTATION=({objectName:e,operationName:n,records:t,operation:r,keyField:i})=>{let o;return o="upsert"===r?t.map((n,t)=>`\n          alias${t+1}:upsert${e}(\n            keyField: "${i||"UID"}",\n            input: {\n              ${Object.entries(n).map(([e,n])=>`${e}: ${serializeGraphQLValue(n)}`).join(", ")}\n            }\n          )\n        `).join("\n    "):t.map((n,t)=>`\n          alias${t+1}:${r}${e}(\n            input: {\n              ${Object.entries(n).map(([e,n])=>`${e}: ${serializeGraphQLValue(n)}`).join(", ")}\n            }\n          )\n        `).join("\n    "),`\n    mutation ${n} {\n      schema {\n        ${o}\n      }\n    }\n  `};exports.MUTATE_OBJECTS_MUTATION=MUTATE_OBJECTS_MUTATION;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.MUTATE_OBJECTS_MUTATION=exports.DELETE_OBJECTS_MUTATION=exports.FETCH_RECORDS_QUERY=void 0;const serializeGraphQLValue=e=>{if(Array.isArray(e)){return`[${e.map(e=>serializeGraphQLValue(e)).join(", ")}]`}return"string"==typeof e?JSON.stringify(e):String(e)},FETCH_RECORDS_QUERY=({objectName:e,operationName:n,filter:t,first:r=200,limit:i,offset:o=0,after:a,orderBy:s,fields:T})=>{const E=void 0!==i,$=E?i:r;return`\n    query ${n} {\n      ${e}(${[t?`filter: "${t}"`:"",a?`after: "${a}"`:"",E?`limit: ${$}`:`first: ${$}`,o?`offset: ${o}`:"",s?`orderBy: "${s}"`:""].filter(e=>e).join(", ")}) {\n        totalCount\n        pageInfo{\n          hasNextPage\n        }\n        edges {\n          cursor\n          offset\n          node {\n            ${T||"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 MUTATE_OBJECTS_MUTATION=({objectName:e,operationName:n,records:t,operation:r,keyField:i})=>{let o;return o="upsert"===r?t.map((n,t)=>`\n          alias${t+1}:upsert${e}(\n            keyField: "${i||"UID"}",\n            input: {\n              ${Object.entries(n).map(([e,n])=>`${e}: ${serializeGraphQLValue(n)}`).join(", ")}\n            }\n          )\n        `).join("\n    "):t.map((n,t)=>`\n          alias${t+1}:${r}${e}(\n            input: {\n              ${Object.entries(n).map(([e,n])=>`${e}: ${serializeGraphQLValue(n)}`).join(", ")}\n            }\n          )\n        `).join("\n    "),`\n    mutation ${n} {\n      schema {\n        ${o}\n      }\n    }\n  `};exports.MUTATE_OBJECTS_MUTATION=MUTATE_OBJECTS_MUTATION;

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

@@ -0,0 +1 @@
+export {};

package/dist/services/graphql/queries.test.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const queries_1=require("./queries"),constants_1=require("../../constants");describe("GraphQL Queries - Mutation Builder",()=>{describe("MUTATE_OBJECTS_MUTATION",()=>{it("should properly serialize arrays in multipicklist fields for insert operations",()=>{const t={objectName:"Jobs",operationName:"CreateJobWithMultipicklist",records:[{UID:"test-job-1",Name:"Test Job",CustomDifficulty:["Easy","Hard"],RegionId:"region-123"}],operation:constants_1.GraphqlOperations.INSERT},e=(0,queries_1.MUTATE_OBJECTS_MUTATION)(t);expect(e).toContain('CustomDifficulty: ["Easy", "Hard"]'),expect(e).not.toContain("CustomDifficulty: Easy,Hard"),expect(e).toContain('Name: "Test Job"'),expect(e).toContain('RegionId: "region-123"')}),it("should properly serialize arrays in multipicklist fields for update operations",()=>{const t={objectName:"Jobs",operationName:"UpdateJobWithMultipicklist",records:[{UID:"test-job-1",CustomDifficulty:["Medium","Expert"],Status:"Dispatched"}],operation:constants_1.GraphqlOperations.UPDATE},e=(0,queries_1.MUTATE_OBJECTS_MUTATION)(t);expect(e).toContain('CustomDifficulty: ["Medium", "Expert"]'),expect(e).toContain('Status: "Dispatched"'),expect(e).toContain("updateJobs")}),it("should properly serialize arrays in multipicklist fields for upsert operations",()=>{const t={objectName:"Jobs",operationName:"UpsertJobWithMultipicklist",records:[{UID:"test-job-1",Name:"Upserted Job",CustomDifficulty:["Easy","Medium","Hard"],Priority:5}],operation:constants_1.GraphqlOperations.UPSERT,keyField:"UID"},e=(0,queries_1.MUTATE_OBJECTS_MUTATION)(t);expect(e).toContain('CustomDifficulty: ["Easy", "Medium", "Hard"]'),expect(e).toContain("Priority: 5"),expect(e).toContain('keyField: "UID"'),expect(e).toContain("upsertJobs")}),it("should handle empty arrays correctly",()=>{const t={objectName:"Jobs",operationName:"CreateJobWithEmptyArray",records:[{UID:"test-job-1",Name:"Test Job",CustomDifficulty:[],Tags:["urgent"]}],operation:constants_1.GraphqlOperations.INSERT},e=(0,queries_1.MUTATE_OBJECTS_MUTATION)(t);expect(e).toContain("CustomDifficulty: []"),expect(e).toContain('Tags: ["urgent"]')}),it("should handle mixed data types correctly",()=>{const t={objectName:"Jobs",operationName:"CreateJobWithMixedTypes",records:[{UID:"test-job-1",Name:"Test Job",CustomDifficulty:["Easy","Hard"],Priority:5,IsActive:!0,Duration:2.5,Notes:null,Metadata:{type:"maintenance",urgent:!0}}],operation:constants_1.GraphqlOperations.INSERT},e=(0,queries_1.MUTATE_OBJECTS_MUTATION)(t);expect(e).toContain('CustomDifficulty: ["Easy", "Hard"]'),expect(e).toContain("Priority: 5"),expect(e).toContain("IsActive: true"),expect(e).toContain("Duration: 2.5"),expect(e).toContain("Notes: null"),expect(e).toContain('Metadata: { type: "maintenance", urgent: true }')}),it("should handle nested arrays in objects",()=>{const t={objectName:"Jobs",operationName:"CreateJobWithNestedArrays",records:[{UID:"test-job-1",Name:"Test Job",Configuration:{skills:["plumbing","electrical"],levels:[1,2,3],active:!0}}],operation:constants_1.GraphqlOperations.INSERT},e=(0,queries_1.MUTATE_OBJECTS_MUTATION)(t);expect(e).toContain('Configuration: { skills: ["plumbing", "electrical"], levels: [1, 2, 3], active: true }')})})});
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const constants_1=require("../../constants"),queries_1=require("./queries");describe("MUTATE_OBJECTS_MUTATION value escaping",()=>{const e=(e,t=constants_1.GraphqlOperations.INSERT)=>(0,queries_1.MUTATE_OBJECTS_MUTATION)({objectName:"Product2",operationName:"pull",operation:t,records:[e]});it("escapes double quotes in string values so the GraphQL string literal is not closed early",()=>{const t=e({Name:"Smart Hub",Description:'7" touchscreen panel'});expect(t).toContain('Description: "7\\" touchscreen panel"'),expect(t).not.toContain('Description: "7" touchscreen panel"')}),it("escapes backslashes and newlines",()=>{const t=e({Note:"back\\slash and\nnewline"});expect(t).toContain('Note: "back\\\\slash and\\nnewline"')}),it("escapes quotes inside string-array elements",()=>{const t=e({Tags:['a"b',"c"]});expect(t).toContain('Tags: ["a\\"b", "c"]')}),it("leaves non-string scalars unquoted",()=>{const t=e({IsActive:!0,Qty:15});expect(t).toContain("IsActive: true"),expect(t).toContain("Qty: 15")}),it("escapes the keyField path on upsert too",()=>{const t=e({UID:"x",Description:'say "hi"'},constants_1.GraphqlOperations.UPSERT);expect(t).toContain('Description: "say \\"hi\\""')})});

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("./cache"),exports),__exportStar(require("./geoservice"),exports),__exportStar(require("./graph-batch"),exports),__exportStar(require("./graphql"),exports),__exportStar(require("./lock-service"),exports),__exportStar(require("./metadata-service"),exports),__exportStar(require("./resource-availability"),exports);
+"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("./cache"),exports),__exportStar(require("./geoservice"),exports),__exportStar(require("./graph-batch"),exports),__exportStar(require("./graphql"),exports),__exportStar(require("./lock-service"),exports),__exportStar(require("./metadata-service"),exports),__exportStar(require("./rap-service"),exports),__exportStar(require("./resource-availability"),exports);

package/dist/services/rap-service.js

@@ -0,0 +1 @@
+"use strict";var __awaiter=this&&this.__awaiter||function(i,t,e,o){return new(e||(e=Promise))(function(r,n){function c(i){try{s(o.next(i))}catch(i){n(i)}}function l(i){try{s(o.throw(i))}catch(i){n(i)}}function s(i){var t;i.done?r(i.value):(t=i.value,t instanceof e?t:new e(function(i){i(t)})).then(c,l)}s((o=o.apply(i,t||[])).next())})};Object.defineProperty(exports,"__esModule",{value:!0}),exports.RapService=void 0;class RapService{constructor(i){this.client=i}exportPolicies(){return __awaiter(this,void 0,void 0,function*(){return yield this.client.getPolicies()})}importPolicies(i){return __awaiter(this,void 0,void 0,function*(){const t=[];for(const e of i){const i=yield this.client.createPolicy(e);t.push(i)}return t})}exportPolicy(i){return __awaiter(this,void 0,void 0,function*(){return yield this.client.getPolicy(i)})}importPolicy(i){return __awaiter(this,void 0,void 0,function*(){return yield this.client.createPolicy(i)})}deleteAllPolicies(){return __awaiter(this,void 0,void 0,function*(){const i=yield this.client.getPolicies();for(const t of i)t.id&&(yield this.client.deletePolicy(t.id));return i.length})}deployPolicies(i){return __awaiter(this,void 0,void 0,function*(){return yield this.deleteAllPolicies(),yield this.importPolicies(i)})}}exports.RapService=RapService;

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

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

package/dist/services/resource-availability/builder/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./resource-availability-service";
+export * from "./resource-builder";
+export * from "./resource-query-param";

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

@@ -0,0 +1,8 @@
+import { AvailabilityAPIClient } from "../../../clients/availability-api-client";
+import { BaseEvent } from "../../../core/tenant-entities";
+import { ResourceQueryParam } from "./resource-query-param";
+export declare class ResourceAvailabilityService {
+    private availabilityAPIClient;
+    constructor(availabilityAPIClient: AvailabilityAPIClient);
+    getAvailabilityPatterns(param: ResourceQueryParam): Promise<Map<string, BaseEvent[]>>;
+}

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

@@ -0,0 +1,17 @@
+import { Resource } from "../../../core/tenant-entities";
+import { DataService } from "./data-service";
+import { ResourceAvailabilityService } from "./resource-availability-service";
+import { ResourceQueryParam } from "./resource-query-param";
+export declare class ResourceBuilder {
+    private dataService;
+    private availabilityService;
+    constructor(dataService: DataService, availabilityService: ResourceAvailabilityService);
+    build(queryParam: ResourceQueryParam): Promise<Resource[]>;
+    private loadAvailabilityPatterns;
+    private loadActivityEvents;
+    private loadAvailabilityEvents;
+    private loadJobAllocationEvents;
+    private loadResourceShiftEvents;
+    private loadHolidayEvents;
+    protected buildMore(resources: Resource[]): Resource[];
+}

package/dist/services/resource-availability/builder/resource-query-param.d.ts

@@ -0,0 +1,23 @@
+export declare class ResourceQueryParam {
+    resourceIds?: Set<string>;
+    regionIds?: Set<string>;
+    startTime: Date;
+    endTime: Date;
+    timezone: string;
+    respectResourceTimezone: boolean;
+    mergeAvailability: boolean;
+    mergeEvents: boolean;
+    useTag: boolean;
+    useJobAllocation: boolean;
+    useResourceShift: boolean;
+    useActivity: boolean;
+    useAvailability: boolean;
+    useAvailabilityTemplate: boolean;
+    useAvailabilityPattern: boolean;
+    useHoliday: boolean;
+    excludedJAStatus: Set<string>;
+    excludedJobStatus: Set<string>;
+    availabilityStatus: Set<string>;
+    resourceTypes: Set<string>;
+    constructor();
+}

package/dist/services/resource-availability/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./builder";
+export * from "./validator";

package/dist/services/resource-availability/validator/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./resource-job-validation";
+export * from "./resource-validation-option";
+export * from "./resource-validator";
+export * from "./validation-result";

package/dist/services/resource-availability/validator/resource-job-validation.d.ts

@@ -0,0 +1,11 @@
+import { BaseEvent, Job, Resource, Tag } from "../../../core/tenant-entities";
+import { ResourceValidationOption } from "./resource-validation-option";
+export declare class ResourceJobValidation {
+    resource: Partial<Resource>;
+    job: Partial<Job>;
+    availableEvent: BaseEvent | null;
+    conflictEvents: BaseEvent[];
+    missingTags: Tag[];
+    constructor(resource: Partial<Resource>, job: Partial<Job>, availableEvent?: BaseEvent | null, conflictEvents?: BaseEvent[], missingTags?: Tag[]);
+    isQualified(option: ResourceValidationOption): boolean;
+}

package/dist/services/resource-availability/validator/resource-validation-option.d.ts

@@ -0,0 +1,5 @@
+export interface ResourceValidationOption {
+    checkAvailability: boolean;
+    checkConflict: boolean;
+    checkTag: boolean;
+}

package/dist/services/resource-availability/validator/resource-validator.d.ts

@@ -0,0 +1,13 @@
+import { Job, Resource } from "../../../core/tenant-entities";
+import { ResourceValidationOption } from "./resource-validation-option";
+import { ValidationResult } from "./validation-result";
+export declare class ResourceValidator {
+    private readonly option;
+    constructor(option: ResourceValidationOption);
+    validate(resources: Resource[], jobs: Job[]): ValidationResult;
+    private validateResource;
+    private findAvailableEvent;
+    private findConflictingEvents;
+    private findMissingTags;
+    private prepareData;
+}

package/dist/services/resource-availability/validator/validation-result.d.ts

@@ -0,0 +1,12 @@
+import { Job, Resource } from "../../../core/tenant-entities";
+import { ResourceJobValidation } from "./resource-job-validation";
+import { ResourceValidationOption } from "./resource-validation-option";
+export declare class ValidationResult {
+    private readonly validations;
+    private readonly option;
+    constructor(validations: ResourceJobValidation[], option: ResourceValidationOption);
+    getQualifiedResources(): Partial<Resource>[];
+    getJobsWithXQualifiedResources(minQualifiedResources: number): Partial<Job>[];
+    getUnqualifiedJobsWithReasons(): ResourceJobValidation[];
+    format(): any[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skedulo/pulse-solution-services",
-  "version": "0.0.22",
+  "version": "0.0.25",
   "description": "A collection of services and utilities to support solution development on the Pulse platform.",
   "author": "Skedulo",
   "license": "MIT",
@@ -42,7 +42,7 @@
     "typedoc": "^0.28.1"
   },
   "dependencies": {
-    "@skedulo/function-utilities": "^0.0.6",
+    "@skedulo/function-utilities": "^0.0.8",
     "dayjs": "^1.11.13",
     "p-queue": "^8.1.0",
     "timezone": "^1.0.23",
@@ -50,5 +50,6 @@
     "utc": "^0.1.0",
     "uuid": "8",
     "winston": "^3.17.0"
-  }
+  },
+  "packageManager": "yarn@1.22.22+sha1.ac34549e6aa8e7ead463a7407e1c7390f61a6610"
 }