@simpleapps-com/augur-api 0.5.1 → 0.6.0

package/dist/esm/services/ups/client.js

@@ -1,187 +1,5 @@
 import { BaseServiceClient } from '../../core/base-client';
-import { HealthCheckParamsSchema, HealthCheckResponseSchema, RatesShopParamsSchema, RatesShopResponseSchema, } from './schemas';
-/**
- * Health Check endpoint implementation for UPS service
- * Follows OpenAPI Path Mirroring Pattern: /health-check → healthCheck.get()
- */
-class HealthCheckEndpoint {
-    constructor(client) {
-        this.client = client;
-    }
-    /**
-     * Check UPS service health and API connectivity
-     *
-     * @fullPath api.ups.healthCheck.get
-     * @service ups
-     * @domain system-health
-     * @dataMethod healthCheckData
-     * @discoverable true
-     * @searchTerms ["health", "status", "availability", "ping", "check", "ups service", "shipping", "carriers"]
-     * @relatedEndpoints ["api.ups.ratesShop.get", "api.shipping.healthCheck.get", "api.logistics.healthCheck.get", "api.commerce.healthCheck.get"]
-     * @commonPatterns ["Health check", "Service status", "UPS service availability", "System monitoring", "Carrier connectivity"]
-     * @workflow ["system-monitoring", "health-checks", "service-discovery", "ups-service-verification", "carrier-status-check"]
-     * @prerequisites ["Service is running", "Valid authentication token", "x-site-id header", "UPS API connectivity"]
-     * @nextSteps ["Use UPS rate endpoints if healthy", "Verify UPS API connectivity", "Monitor UPS service metrics"]
-     * @businessRules ["Returns service and UPS API status", "Requires standard authentication", "Standard health check format", "Reports API credit status"]
-     * @functionalArea "system-monitoring"
-     * @caching "No caching - real-time status required"
-     * @performance "Fast response, minimal processing, use for UPS service monitoring"
-     *
-     * @param params Health check parameters with site ID
-     * @returns Promise<HealthCheckResponse> Service health status with UPS API connectivity
-     *
-     * @example
-     * ```typescript
-     * // Check if UPS service is healthy
-     * const response = await client.healthCheck.get({ 'x-site-id': 'SITE123' });
-     * console.log(response.data.status); // 'healthy'
-     * console.log(response.data.service); // 'ups'
-     * console.log(response.data.ups_connectivity); // true
-     * console.log(response.status); // HTTP status code
-     *
-     * // Get just the health status
-     * const status = await client.healthCheck.getData({ 'x-site-id': 'SITE123' });
-     * console.log(status); // Health data object
-     * ```
-     */
-    async get(params) {
-        return this.client['executeRequest']({
-            method: 'GET',
-            path: '/health-check',
-            paramsSchema: HealthCheckParamsSchema,
-            responseSchema: HealthCheckResponseSchema,
-        }, params);
-    }
-    /**
-     * Get UPS service health data without full response metadata
-     *
-     * @fullPath api.ups.healthCheck.getData
-     * @service ups
-     * @domain system-health
-     * @dataMethod healthCheckData
-     * @discoverable true
-     * @searchTerms ["health data", "service status", "ups availability", "api connectivity"]
-     * @relatedEndpoints ["api.ups.healthCheck.get", "api.ups.ratesShop.get"]
-     * @commonPatterns ["Get health status", "Check UPS API connectivity", "Service monitoring"]
-     * @workflow ["system-monitoring", "health-checks", "service-verification"]
-     * @prerequisites ["Valid authentication token", "x-site-id header"]
-     * @nextSteps ["Use UPS endpoints if healthy", "Monitor UPS service metrics"]
-     * @businessRules ["Returns only health data object", "No response metadata included"]
-     * @functionalArea "system-monitoring"
-     * @caching "No caching - real-time status required"
-     * @performance "Direct data access, faster for simple health checks"
-     *
-     * @param params Health check parameters with site ID
-     * @returns Promise<HealthCheckData> Direct health status data object
-     */
-    async getData(params) {
-        const response = await this.get(params);
-        return response.data;
-    }
-}
-/**
- * Rates Shop endpoint implementation for UPS service
- * Follows OpenAPI Path Mirroring Pattern: /rates-shop → ratesShop.get()
- */
-class RatesShopEndpoint {
-    constructor(client) {
-        this.client = client;
-    }
-    /**
-     * Shop UPS shipping rates for packages with comprehensive service options
-     *
-     * @fullPath api.ups.ratesShop.get
-     * @service ups
-     * @domain shipping-and-logistics
-     * @dataMethod ratesShopData
-     * @discoverable true
-     * @searchTerms ["ups rates", "shipping cost", "ups pricing", "package shipping", "ups quotes", "delivery cost", "ground", "air", "next day", "2-day", "3-day", "international"]
-     * @relatedEndpoints ["api.shipping.rates.calculate", "api.logistics.speedship.freight.get", "api.commerce.cart.shipping.calculate", "api.orders.shipping.estimate", "api.customers.addresses.validate"]
-     * @commonPatterns ["Calculate UPS shipping cost", "Compare UPS services", "Get UPS delivery options", "Estimate UPS shipping", "Find cheapest UPS option", "Get fastest UPS delivery"]
-     * @workflow ["e-commerce-checkout", "order-fulfillment", "shipping-estimation", "ups-rate-comparison", "carrier-selection", "delivery-planning", "shipping-cost-analysis"]
-     * @prerequisites ["Valid shipping addresses", "Package weight specified", "Valid authentication token", "x-site-id header", "UPS API access", "Complete address information"]
-     * @nextSteps ["Select UPS service option", "Create UPS shipping label", "Track UPS shipment", "Update order with UPS shipping cost", "Process payment with UPS shipping"]
-     * @businessRules ["Requires origin and destination addresses", "Package weight is mandatory", "Supports single package shipments", "Returns UPS-specific rates and services", "Includes all UPS fees and surcharges", "Respects UPS service area limitations"]
-     * @functionalArea "shipping-and-logistics"
-     * @crossSite "Supports multi-site UPS configurations and different UPS accounts per site"
-     * @caching "Cache UPS rates for 15 minutes, invalidate on address or package changes"
-     * @performance "Single UPS API call, optimized for UPS rate shopping, supports edge caching with cacheSiteId parameter"
-     *
-     * @param params Complete UPS rate shopping request with addresses and package information
-     * @returns Promise<RatesShopResponse> UPS shipping rates with service options and delivery information
-     *
-     * @example
-     * ```typescript
-     * // Calculate UPS rates for e-commerce order
-     * const upsRateRequest = {
-     *   // Origin address (warehouse/fulfillment center)
-     *   fromAddress1: '123 Warehouse Blvd',
-     *   fromCity: 'Los Angeles',
-     *   fromStateProvinceCode: 'CA',
-     *   fromPostalCode: '90210',
-     *   fromCountryCode: 'US',
-     *
-     *   // Customer delivery address
-     *   toAddress1: '456 Customer St',
-     *   toCity: 'New York',
-     *   toStateProvinceCode: 'NY',
-     *   toPostalCode: '10001',
-     *   toCountryCode: 'US',
-     *
-     *   // Package information (required)
-     *   weight: 5, // pounds
-     *
-     *   // Optional caching for performance
-     *   cacheSiteId: 'ECOMMERCE-SITE',
-     *   'x-site-id': 'SITE123'
-     * };
-     *
-     * const response = await client.ratesShop.get(upsRateRequest);
-     * console.log(response.data.rates); // Array of UPS shipping rates
-     * console.log(response.data.cheapest_rate); // Most economical option
-     * console.log(response.data.fastest_rate); // Quickest delivery option
-     * console.log(response.status); // HTTP status code
-     *
-     * // Get just the rates data
-     * const ratesData = await client.ratesShop.getData(upsRateRequest);
-     * console.log(ratesData); // Direct UPS rates data access
-     * ```
-     */
-    async get(params) {
-        return this.client['executeRequest']({
-            method: 'GET',
-            path: '/rates-shop',
-            paramsSchema: RatesShopParamsSchema,
-            responseSchema: RatesShopResponseSchema,
-        }, params);
-    }
-    /**
-     * Get UPS shipping rates data without full response metadata
-     *
-     * @fullPath api.ups.ratesShop.getData
-     * @service ups
-     * @domain shipping-and-logistics
-     * @dataMethod ratesShopData
-     * @discoverable true
-     * @searchTerms ["ups rates data", "shipping cost data", "ups pricing data", "delivery quotes", "carrier rates"]
-     * @relatedEndpoints ["api.ups.ratesShop.get", "api.shipping.rates.calculate", "api.commerce.cart.shipping.calculate"]
-     * @commonPatterns ["Get UPS rates data", "Calculate UPS shipping cost", "Compare UPS service options", "Extract UPS pricing"]
-     * @workflow ["e-commerce-checkout", "order-fulfillment", "shipping-estimation", "ups-rate-analysis"]
-     * @prerequisites ["Valid shipping addresses", "Package weight", "Valid authentication token", "UPS API access"]
-     * @nextSteps ["Select UPS service option", "Create UPS shipping label", "Process payment with UPS cost"]
-     * @businessRules ["Returns only UPS rates data", "No response metadata included", "Direct access to rate comparison"]
-     * @functionalArea "shipping-and-logistics"
-     * @caching "Cache UPS rates for 15 minutes"
-     * @performance "Direct data access, optimal for UPS rate comparisons and e-commerce integrations"
-     *
-     * @param params Complete UPS rate shopping request parameters
-     * @returns Promise<RatesShopData> Direct UPS shipping rates data without response wrapper
-     */
-    async getData(params) {
-        const response = await this.get(params);
-        return response.data;
-    }
-}
+import { createHealthCheckResource, createHealthCheckDataResource, createRatesShopResource, createRatesShopDataResource, } from './resources';
 /**
  * UPS Shipping Service Client
  *
@@ -195,13 +13,60 @@ class RatesShopEndpoint {
  *
  * @service ups
  * @domain shipping-and-logistics
+ * @fullPath api.ups
+ * @discoverable true
+ * @searchTerms ["ups", "shipping", "rates", "logistics", "carrier", "package delivery"]
+ * @relatedEndpoints ["api.shipping.rates.calculate", "api.logistics.speedship.freight.get", "api.commerce.cart.shipping.calculate"]
+ * @commonPatterns ["UPS rate shopping", "Shipping cost calculation", "Carrier service comparison", "Delivery estimation"]
+ * @workflow ["e-commerce-checkout", "order-fulfillment", "shipping-estimation", "carrier-selection"]
+ * @functionalArea "shipping-and-logistics"
+ * @businessRules ["Requires UPS API access", "Supports domestic and international shipping", "Provides real-time rate quotes"]
+ * @performance "Optimized for UPS rate shopping with caching support"
+ *
+ * @example
+ * ```typescript
+ * import { HTTPClient } from '@augur/api-client/core';
+ * import { UPSClient } from '@augur/api-client/services/ups';
+ *
+ * const http = new HTTPClient('ups', { siteId: 'your-site-id', bearerToken: 'your-token' });
+ * const ups = new UPSClient(http);
+ *
+ * // Check service health
+ * const health = await ups.healthCheck.get({ 'x-site-id': 'SITE123' });
+ * const healthData = await ups.healthCheckData.get({ 'x-site-id': 'SITE123' });
+ *
+ * // Shop UPS rates
+ * const rates = await ups.ratesShop.get({
+ *   fromAddress1: '123 Warehouse Blvd',
+ *   fromCity: 'Los Angeles',
+ *   fromStateProvinceCode: 'CA',
+ *   fromPostalCode: '90210',
+ *   fromCountryCode: 'US',
+ *   toAddress1: '456 Customer St',
+ *   toCity: 'New York',
+ *   toStateProvinceCode: 'NY',
+ *   toPostalCode: '10001',
+ *   toCountryCode: 'US',
+ *   weight: 5,
+ *   'x-site-id': 'SITE123'
+ * });
+ *
+ * // Get just the rates data
+ * const ratesData = await ups.ratesShopData.get({...});
+ * ```
  */
 export class UPSClient extends BaseServiceClient {
     constructor(http, baseUrl) {
         super('ups', http, baseUrl || 'https://ups.augur-api.com');
-        // Initialize endpoint handlers following OpenAPI Path Mirroring Pattern
-        this.healthCheck = new HealthCheckEndpoint(this);
-        this.ratesShop = new RatesShopEndpoint(this);
+        // Bind executeRequest for resource factories
+        const boundExecuteRequest = (config, params, pathParams) => {
+            return this.executeRequest(config, params, pathParams);
+        };
+        // Initialize resources
+        this.healthCheck = createHealthCheckResource(boundExecuteRequest);
+        this.healthCheckData = createHealthCheckDataResource(this.healthCheck);
+        this.ratesShop = createRatesShopResource(boundExecuteRequest);
+        this.ratesShopData = createRatesShopDataResource(this.ratesShop);
     }
     getServiceDescription() {
         return 'UPS shipping rate calculation and service comparison service';

package/dist/esm/services/ups/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/services/ups/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EACL,uBAAuB,EAEvB,yBAAyB,EAEzB,qBAAqB,EAErB,uBAAuB,GAIxB,MAAM,WAAW,CAAC;AAEnB;;;GAGG;AACH,MAAM,mBAAmB;IACvB,YAAoB,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,KAAK,CAAC,GAAG,CAAC,MAAyB;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAClC;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe;YACrB,YAAY,EAAE,uBAAuB;YACrC,cAAc,EAAE,yBAAyB;SAC1C,EACD,MAAM,CACP,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,OAAO,CAAC,MAAyB;QACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,iBAAiB;IACrB,YAAoB,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2DG;IACH,KAAK,CAAC,GAAG,CAAC,MAAuB;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAClC;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,aAAa;YACnB,YAAY,EAAE,qBAAqB;YACnC,cAAc,EAAE,uBAAuB;SACxC,EACD,MAAM,CACP,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,OAAO,CAAC,MAAuB;QACnC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,SAAU,SAAQ,iBAAiB;IAI9C,YAAY,IAAgB,EAAE,OAAgB;QAC5C,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,IAAI,2BAA2B,CAAC,CAAC;QAE3D,wEAAwE;QACxE,IAAI,CAAC,WAAW,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAES,qBAAqB;QAC7B,OAAO,8DAA8D,CAAC;IACxE,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/services/ups/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAkB,MAAM,wBAAwB,CAAC;AAE3E,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,uBAAuB,EACvB,2BAA2B,GAK5B,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,OAAO,SAAU,SAAQ,iBAAiB;IAU9C,YAAY,IAAgB,EAAE,OAAgB;QAC5C,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,IAAI,2BAA2B,CAAC,CAAC;QAE3D,6CAA6C;QAC7C,MAAM,mBAAmB,GAAG,CAC1B,MAA0C,EAC1C,MAAgB,EAChB,UAAmC,EACf,EAAE;YACtB,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QACzD,CAAC,CAAC;QAEF,uBAAuB;QACvB,IAAI,CAAC,WAAW,GAAG,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;QAClE,IAAI,CAAC,eAAe,GAAG,6BAA6B,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvE,IAAI,CAAC,SAAS,GAAG,uBAAuB,CAAC,mBAAmB,CAAC,CAAC;QAC9D,IAAI,CAAC,aAAa,GAAG,2BAA2B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC;IAES,qBAAqB;QAC7B,OAAO,8DAA8D,CAAC;IACxE,CAAC;CACF"}

package/dist/esm/services/ups/resources/health-check.d.ts

@@ -0,0 +1,79 @@
+import { type HealthCheckParams, type HealthCheckResponse, type HealthCheckData } from '../schemas';
+import type { UPSClient } from '../client';
+type ExecuteRequest = UPSClient['executeRequest'];
+/**
+ * Creates the healthCheck resource methods
+ * OpenAPI Path: /health-check → healthCheck.*
+ * @description Health check endpoint for UPS service
+ */
+export declare function createHealthCheckResource(executeRequest: ExecuteRequest): {
+    /**
+     * Check UPS service health and API connectivity
+     *
+     * @fullPath api.ups.healthCheck.get
+     * @service ups
+     * @domain system-health
+     * @dataMethod healthCheckData.get
+     * @discoverable true
+     * @searchTerms ["health", "status", "availability", "ping", "check", "ups service", "shipping", "carriers"]
+     * @relatedEndpoints ["api.ups.ratesShop.get", "api.shipping.healthCheck.get", "api.logistics.healthCheck.get", "api.commerce.healthCheck.get"]
+     * @commonPatterns ["Health check", "Service status", "UPS service availability", "System monitoring", "Carrier connectivity"]
+     * @workflow ["system-monitoring", "health-checks", "service-discovery", "ups-service-verification", "carrier-status-check"]
+     * @prerequisites ["Service is running", "Valid authentication token", "x-site-id header", "UPS API connectivity"]
+     * @nextSteps ["Use UPS rate endpoints if healthy", "Verify UPS API connectivity", "Monitor UPS service metrics"]
+     * @businessRules ["Returns service and UPS API status", "Requires standard authentication", "Standard health check format", "Reports API credit status"]
+     * @functionalArea "system-monitoring"
+     * @caching "No caching - real-time status required"
+     * @performance "Fast response, minimal processing, use for UPS service monitoring"
+     *
+     * @param params Health check parameters with site ID
+     * @returns Promise<HealthCheckResponse> Service health status with UPS API connectivity
+     *
+     * @example
+     * ```typescript
+     * // Check if UPS service is healthy
+     * const response = await client.healthCheck.get({ 'x-site-id': 'SITE123' });
+     * console.log(response.data.status); // 'healthy'
+     * console.log(response.data.service); // 'ups'
+     * console.log(response.data.ups_connectivity); // true
+     * console.log(response.status); // HTTP status code
+     *
+     * // Get just the health status
+     * const status = await client.healthCheck.getData({ 'x-site-id': 'SITE123' });
+     * console.log(status); // Health data object
+     * ```
+     */
+    get: (params: HealthCheckParams) => Promise<HealthCheckResponse>;
+};
+/**
+ * Creates the healthCheckData resource methods (data-only versions)
+ */
+export declare function createHealthCheckDataResource(healthCheck: ReturnType<typeof createHealthCheckResource>): {
+    /**
+     * Get UPS service health data without full response metadata
+     *
+     * @fullPath api.ups.healthCheck.getData
+     * @service ups
+     * @domain system-health
+     * @dataMethod healthCheckData
+     * @discoverable true
+     * @searchTerms ["health data", "service status", "ups availability", "api connectivity"]
+     * @relatedEndpoints ["api.ups.healthCheck.get", "api.ups.ratesShop.get"]
+     * @commonPatterns ["Get health status", "Check UPS API connectivity", "Service monitoring"]
+     * @workflow ["system-monitoring", "health-checks", "service-verification"]
+     * @prerequisites ["Valid authentication token", "x-site-id header"]
+     * @nextSteps ["Use UPS endpoints if healthy", "Monitor UPS service metrics"]
+     * @businessRules ["Returns only health data object", "No response metadata included"]
+     * @functionalArea "system-monitoring"
+     * @caching "No caching - real-time status required"
+     * @performance "Direct data access, faster for simple health checks"
+     *
+     * @param params Health check parameters with site ID
+     * @returns Promise<HealthCheckData> Direct health status data object
+     */
+    get: (params: HealthCheckParams) => Promise<HealthCheckData>;
+};
+export type HealthCheckResource = ReturnType<typeof createHealthCheckResource>;
+export type HealthCheckDataResource = ReturnType<typeof createHealthCheckDataResource>;
+export {};
+//# sourceMappingURL=health-check.d.ts.map

package/dist/esm/services/ups/resources/health-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../../../../../src/services/ups/resources/health-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,KAAK,cAAc,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,cAAc;IAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;kBACiB,iBAAiB,KAAG,OAAO,CAAC,mBAAmB,CAAC;EAYvE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC;IAGvD;;;;;;;;;;;;;;;;;;;;;OAqBG;kBACiB,iBAAiB,KAAG,OAAO,CAAC,eAAe,CAAC;EAKnE;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC/E,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/esm/services/ups/resources/health-check.js

@@ -0,0 +1,88 @@
+import { HealthCheckParamsSchema, HealthCheckResponseSchema, } from '../schemas';
+/**
+ * Creates the healthCheck resource methods
+ * OpenAPI Path: /health-check → healthCheck.*
+ * @description Health check endpoint for UPS service
+ */
+export function createHealthCheckResource(executeRequest) {
+    return {
+        /**
+         * Check UPS service health and API connectivity
+         *
+         * @fullPath api.ups.healthCheck.get
+         * @service ups
+         * @domain system-health
+         * @dataMethod healthCheckData.get
+         * @discoverable true
+         * @searchTerms ["health", "status", "availability", "ping", "check", "ups service", "shipping", "carriers"]
+         * @relatedEndpoints ["api.ups.ratesShop.get", "api.shipping.healthCheck.get", "api.logistics.healthCheck.get", "api.commerce.healthCheck.get"]
+         * @commonPatterns ["Health check", "Service status", "UPS service availability", "System monitoring", "Carrier connectivity"]
+         * @workflow ["system-monitoring", "health-checks", "service-discovery", "ups-service-verification", "carrier-status-check"]
+         * @prerequisites ["Service is running", "Valid authentication token", "x-site-id header", "UPS API connectivity"]
+         * @nextSteps ["Use UPS rate endpoints if healthy", "Verify UPS API connectivity", "Monitor UPS service metrics"]
+         * @businessRules ["Returns service and UPS API status", "Requires standard authentication", "Standard health check format", "Reports API credit status"]
+         * @functionalArea "system-monitoring"
+         * @caching "No caching - real-time status required"
+         * @performance "Fast response, minimal processing, use for UPS service monitoring"
+         *
+         * @param params Health check parameters with site ID
+         * @returns Promise<HealthCheckResponse> Service health status with UPS API connectivity
+         *
+         * @example
+         * ```typescript
+         * // Check if UPS service is healthy
+         * const response = await client.healthCheck.get({ 'x-site-id': 'SITE123' });
+         * console.log(response.data.status); // 'healthy'
+         * console.log(response.data.service); // 'ups'
+         * console.log(response.data.ups_connectivity); // true
+         * console.log(response.status); // HTTP status code
+         *
+         * // Get just the health status
+         * const status = await client.healthCheck.getData({ 'x-site-id': 'SITE123' });
+         * console.log(status); // Health data object
+         * ```
+         */
+        get: async (params) => {
+            return executeRequest({
+                method: 'GET',
+                path: '/health-check',
+                paramsSchema: HealthCheckParamsSchema,
+                responseSchema: HealthCheckResponseSchema,
+            }, params);
+        },
+    };
+}
+/**
+ * Creates the healthCheckData resource methods (data-only versions)
+ */
+export function createHealthCheckDataResource(healthCheck) {
+    return {
+        /**
+         * Get UPS service health data without full response metadata
+         *
+         * @fullPath api.ups.healthCheck.getData
+         * @service ups
+         * @domain system-health
+         * @dataMethod healthCheckData
+         * @discoverable true
+         * @searchTerms ["health data", "service status", "ups availability", "api connectivity"]
+         * @relatedEndpoints ["api.ups.healthCheck.get", "api.ups.ratesShop.get"]
+         * @commonPatterns ["Get health status", "Check UPS API connectivity", "Service monitoring"]
+         * @workflow ["system-monitoring", "health-checks", "service-verification"]
+         * @prerequisites ["Valid authentication token", "x-site-id header"]
+         * @nextSteps ["Use UPS endpoints if healthy", "Monitor UPS service metrics"]
+         * @businessRules ["Returns only health data object", "No response metadata included"]
+         * @functionalArea "system-monitoring"
+         * @caching "No caching - real-time status required"
+         * @performance "Direct data access, faster for simple health checks"
+         *
+         * @param params Health check parameters with site ID
+         * @returns Promise<HealthCheckData> Direct health status data object
+         */
+        get: async (params) => {
+            const response = await healthCheck.get(params);
+            return response.data;
+        },
+    };
+}
+//# sourceMappingURL=health-check.js.map

package/dist/esm/services/ups/resources/health-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.js","sourceRoot":"","sources":["../../../../../src/services/ups/resources/health-check.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAI1B,MAAM,YAAY,CAAC;AAKpB;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,cAA8B;IACtE,OAAO;QACL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAmCG;QACH,GAAG,EAAE,KAAK,EAAE,MAAyB,EAAgC,EAAE;YACrE,OAAO,cAAc,CACnB;gBACE,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,eAAe;gBACrB,YAAY,EAAE,uBAAuB;gBACrC,cAAc,EAAE,yBAAyB;aAC1C,EACD,MAAM,CACP,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,WAAyD;IAEzD,OAAO;QACL;;;;;;;;;;;;;;;;;;;;;WAqBG;QACH,GAAG,EAAE,KAAK,EAAE,MAAyB,EAA4B,EAAE;YACjE,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC/C,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/services/ups/resources/index.d.ts

@@ -0,0 +1,3 @@
+export { createHealthCheckResource, createHealthCheckDataResource, type HealthCheckResource, type HealthCheckDataResource, } from './health-check';
+export { createRatesShopResource, createRatesShopDataResource, type RatesShopResource, type RatesShopDataResource, } from './rates-shop';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/services/ups/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/services/ups/resources/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC"}

package/dist/esm/services/ups/resources/index.js

@@ -0,0 +1,4 @@
+// Resource exports
+export { createHealthCheckResource, createHealthCheckDataResource, } from './health-check';
+export { createRatesShopResource, createRatesShopDataResource, } from './rates-shop';
+//# sourceMappingURL=index.js.map

package/dist/esm/services/ups/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/services/ups/resources/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EACL,yBAAyB,EACzB,6BAA6B,GAG9B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,uBAAuB,EACvB,2BAA2B,GAG5B,MAAM,cAAc,CAAC"}

package/dist/esm/services/ups/resources/rates-shop.d.ts

@@ -0,0 +1,103 @@
+import { type RatesShopParams, type RatesShopResponse, type RatesShopData } from '../schemas';
+import type { UPSClient } from '../client';
+type ExecuteRequest = UPSClient['executeRequest'];
+/**
+ * Creates the ratesShop resource methods
+ * OpenAPI Path: /rates-shop → ratesShop.*
+ * @description Rates shop endpoint for UPS service
+ */
+export declare function createRatesShopResource(executeRequest: ExecuteRequest): {
+    /**
+     * Shop UPS shipping rates for packages with comprehensive service options
+     *
+     * @fullPath api.ups.ratesShop.get
+     * @service ups
+     * @domain shipping-and-logistics
+     * @dataMethod ratesShopData.get
+     * @discoverable true
+     * @searchTerms ["ups rates", "shipping cost", "ups pricing", "package shipping", "ups quotes", "delivery cost", "ground", "air", "next day", "2-day", "3-day", "international"]
+     * @relatedEndpoints ["api.shipping.rates.calculate", "api.logistics.speedship.freight.get", "api.commerce.cart.shipping.calculate", "api.orders.shipping.estimate", "api.customers.addresses.validate"]
+     * @commonPatterns ["Calculate UPS shipping cost", "Compare UPS services", "Get UPS delivery options", "Estimate UPS shipping", "Find cheapest UPS option", "Get fastest UPS delivery"]
+     * @workflow ["e-commerce-checkout", "order-fulfillment", "shipping-estimation", "ups-rate-comparison", "carrier-selection", "delivery-planning", "shipping-cost-analysis"]
+     * @prerequisites ["Valid shipping addresses", "Package weight specified", "Valid authentication token", "x-site-id header", "UPS API access", "Complete address information"]
+     * @nextSteps ["Select UPS service option", "Create UPS shipping label", "Track UPS shipment", "Update order with UPS shipping cost", "Process payment with UPS shipping"]
+     * @businessRules ["Requires origin and destination addresses", "Package weight is mandatory", "Supports single package shipments", "Returns UPS-specific rates and services", "Includes all UPS fees and surcharges", "Respects UPS service area limitations"]
+     * @functionalArea "shipping-and-logistics"
+     * @crossSite "Supports multi-site UPS configurations and different UPS accounts per site"
+     * @caching "Cache UPS rates for 15 minutes, invalidate on address or package changes"
+     * @performance "Single UPS API call, optimized for UPS rate shopping, supports edge caching with cacheSiteId parameter"
+     *
+     * @param params Complete UPS rate shopping request with addresses and package information
+     * @returns Promise<RatesShopResponse> UPS shipping rates with service options and delivery information
+     *
+     * @example
+     * ```typescript
+     * // Calculate UPS rates for e-commerce order
+     * const upsRateRequest = {
+     *   // Origin address (warehouse/fulfillment center)
+     *   fromAddress1: '123 Warehouse Blvd',
+     *   fromCity: 'Los Angeles',
+     *   fromStateProvinceCode: 'CA',
+     *   fromPostalCode: '90210',
+     *   fromCountryCode: 'US',
+     *
+     *   // Customer delivery address
+     *   toAddress1: '456 Customer St',
+     *   toCity: 'New York',
+     *   toStateProvinceCode: 'NY',
+     *   toPostalCode: '10001',
+     *   toCountryCode: 'US',
+     *
+     *   // Package information (required)
+     *   weight: 5, // pounds
+     *
+     *   // Optional caching for performance
+     *   cacheSiteId: 'ECOMMERCE-SITE',
+     *   'x-site-id': 'SITE123'
+     * };
+     *
+     * const response = await client.ratesShop.get(upsRateRequest);
+     * console.log(response.data.rates); // Array of UPS shipping rates
+     * console.log(response.data.cheapest_rate); // Most economical option
+     * console.log(response.data.fastest_rate); // Quickest delivery option
+     * console.log(response.status); // HTTP status code
+     *
+     * // Get just the rates data
+     * const ratesData = await client.ratesShop.getData(upsRateRequest);
+     * console.log(ratesData); // Direct UPS rates data access
+     * ```
+     */
+    get: (params: RatesShopParams) => Promise<RatesShopResponse>;
+};
+/**
+ * Creates the ratesShopData resource methods (data-only versions)
+ */
+export declare function createRatesShopDataResource(ratesShop: ReturnType<typeof createRatesShopResource>): {
+    /**
+     * Get UPS shipping rates data without full response metadata
+     *
+     * @fullPath api.ups.ratesShop.getData
+     * @service ups
+     * @domain shipping-and-logistics
+     * @dataMethod ratesShopData
+     * @discoverable true
+     * @searchTerms ["ups rates data", "shipping cost data", "ups pricing data", "delivery quotes", "carrier rates"]
+     * @relatedEndpoints ["api.ups.ratesShop.get", "api.shipping.rates.calculate", "api.commerce.cart.shipping.calculate"]
+     * @commonPatterns ["Get UPS rates data", "Calculate UPS shipping cost", "Compare UPS service options", "Extract UPS pricing"]
+     * @workflow ["e-commerce-checkout", "order-fulfillment", "shipping-estimation", "ups-rate-analysis"]
+     * @prerequisites ["Valid shipping addresses", "Package weight", "Valid authentication token", "UPS API access"]
+     * @nextSteps ["Select UPS service option", "Create UPS shipping label", "Process payment with UPS cost"]
+     * @businessRules ["Returns only UPS rates data", "No response metadata included", "Direct access to rate comparison"]
+     * @functionalArea "shipping-and-logistics"
+     * @caching "Cache UPS rates for 15 minutes"
+     * @performance "Direct data access, optimal for UPS rate comparisons and e-commerce integrations"
+     *
+     * @param params Complete UPS rate shopping request parameters
+     * @returns Promise<RatesShopData> Direct UPS shipping rates data without response wrapper
+     */
+    get: (params: RatesShopParams) => Promise<RatesShopData>;
+};
+export type RatesShopResource = ReturnType<typeof createRatesShopResource>;
+export type RatesShopDataResource = ReturnType<typeof createRatesShopDataResource>;
+export {};
+//# sourceMappingURL=rates-shop.d.ts.map

package/dist/esm/services/ups/resources/rates-shop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rates-shop.d.ts","sourceRoot":"","sources":["../../../../../src/services/ups/resources/rates-shop.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,KAAK,cAAc,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,cAAc;IAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2DG;kBACiB,eAAe,KAAG,OAAO,CAAC,iBAAiB,CAAC;EAYnE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC;IAE7F;;;;;;;;;;;;;;;;;;;;;OAqBG;kBACiB,eAAe,KAAG,OAAO,CAAC,aAAa,CAAC;EAK/D;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC3E,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC"}