@simpleapps-com/augur-api 0.3.0 → 0.3.1

package/dist/esm/services/smarty-streets/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/services/smarty-streets/schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/services/smarty-streets/schemas.js

@@ -0,0 +1,180 @@
+import { z } from 'zod';
+import { BaseResponseSchema } from '../../core/schemas';
+// SmartyStreets Service Parameter Schemas
+/**
+ * Health check parameters - SmartyStreets service health verification
+ */
+export const HealthCheckParamsSchema = z.object({
+    'x-site-id': z.string().describe('Site ID provided by SimpleApps'),
+});
+/**
+ * Ping parameters - SmartyStreets service connectivity test
+ */
+export const PingParamsSchema = z.object({
+    'x-site-id': z.string().describe('Site ID provided by SimpleApps'),
+});
+/**
+ * US Address lookup parameters - comprehensive address validation and standardization
+ * Validates and standardizes US addresses using SmartyStreets API
+ */
+export const USLookupParamsSchema = z.object({
+    // Required address components
+    address1: z.string().min(1, 'Primary address line is required'),
+    address2: z.string().optional().describe('Secondary address line (apartment, suite, unit)'),
+    city: z.string().min(1, 'City is required'),
+    state: z.string().min(2, 'State code is required (2-letter abbreviation)').max(2),
+    postalCode: z.string().min(5, 'Postal code is required (5 or 9 digits)'),
+    // Headers (will be passed automatically)
+    'x-site-id': z.string().describe('Site ID provided by SimpleApps'),
+});
+// Data Schemas (flexible for API responses without detailed schemas)
+/**
+ * Health check response data
+ */
+export const HealthCheckDataSchema = z
+    .object({
+    status: z.string(),
+    service: z.string(),
+    timestamp: z.string().optional(),
+    version: z.string().optional(),
+    smartystreets_connectivity: z.boolean().optional(),
+    api_credits_remaining: z.number().optional(),
+})
+    .describe('SmartyStreets service health status information');
+/**
+ * Ping response data
+ */
+export const PingDataSchema = z
+    .object({
+    message: z.string(),
+    timestamp: z.string().optional(),
+    service: z.string().optional(),
+    response_time_ms: z.number().optional(),
+})
+    .describe('SmartyStreets service ping response');
+/**
+ * Address component details
+ */
+export const AddressComponentSchema = z
+    .object({
+    primary_number: z.string().optional(),
+    street_name: z.string().optional(),
+    street_suffix: z.string().optional(),
+    secondary_number: z.string().optional(),
+    secondary_designator: z.string().optional(),
+    extra_secondary_number: z.string().optional(),
+    extra_secondary_designator: z.string().optional(),
+    pmb_designator: z.string().optional(),
+    pmb_number: z.string().optional(),
+})
+    .describe('Detailed address component breakdown');
+/**
+ * Address metadata information
+ */
+export const AddressMetadataSchema = z
+    .object({
+    record_type: z.string().optional(),
+    zip_type: z.string().optional(),
+    county_fips: z.string().optional(),
+    county_name: z.string().optional(),
+    carrier_route: z.string().optional(),
+    delivery_point: z.string().optional(),
+    delivery_point_check_digit: z.string().optional(),
+    precision: z.string().optional(),
+    time_zone: z.string().optional(),
+    utc_offset: z.number().optional(),
+    dst: z.boolean().optional(),
+    ews_match: z.boolean().optional(),
+})
+    .describe('Address metadata and delivery information');
+/**
+ * Address analysis results
+ */
+export const AddressAnalysisSchema = z
+    .object({
+    dpv_match_y: z.boolean().optional(),
+    dpv_match_n: z.boolean().optional(),
+    dpv_match_s: z.boolean().optional(),
+    dpv_match_d: z.boolean().optional(),
+    dpv_vacant: z.boolean().optional(),
+    dpv_cmra: z.boolean().optional(),
+    dpv_footnotes: z.string().optional(),
+    cmra: z.boolean().optional(),
+    vacant: z.boolean().optional(),
+    active: z.boolean().optional(),
+})
+    .describe('Delivery Point Validation and address analysis');
+/**
+ * Standardized address result
+ */
+export const StandardizedAddressSchema = z
+    .object({
+    input_index: z.number().optional(),
+    candidate_index: z.number().optional(),
+    addressee: z.string().optional(),
+    delivery_line_1: z.string().optional(),
+    delivery_line_2: z.string().optional(),
+    last_line: z.string().optional(),
+    delivery_point_barcode: z.string().optional(),
+    // Standardized components
+    primary_number: z.string().optional(),
+    street_name: z.string().optional(),
+    street_predirection: z.string().optional(),
+    street_postdirection: z.string().optional(),
+    street_suffix: z.string().optional(),
+    secondary_number: z.string().optional(),
+    secondary_designator: z.string().optional(),
+    extra_secondary_number: z.string().optional(),
+    extra_secondary_designator: z.string().optional(),
+    // Geographic data
+    city_name: z.string().optional(),
+    default_city_name: z.string().optional(),
+    state_abbreviation: z.string().optional(),
+    zipcode: z.string().optional(),
+    plus4_code: z.string().optional(),
+    // Components and metadata
+    components: AddressComponentSchema.optional(),
+    metadata: AddressMetadataSchema.optional(),
+    analysis: AddressAnalysisSchema.optional(),
+    // Validation flags
+    is_valid: z.boolean().optional(),
+    is_ambiguous: z.boolean().optional(),
+    footnotes: z.string().optional(),
+})
+    .describe('Standardized and validated US address');
+/**
+ * US address lookup result with multiple candidates
+ */
+export const USLookupResultSchema = z
+    .object({
+    input_id: z.string().optional(),
+    input_index: z.number().optional(),
+    candidates: z.array(StandardizedAddressSchema),
+    // Validation summary
+    total_candidates: z.number(),
+    valid_candidates: z.number().optional(),
+    ambiguous_candidates: z.number().optional(),
+    // Processing metadata
+    processed_at: z.string().optional(),
+    processing_time_ms: z.number().optional(),
+    credits_used: z.number().optional(),
+})
+    .describe('US address lookup results with candidate addresses');
+/**
+ * US address lookup response data
+ */
+export const USLookupDataSchema = USLookupResultSchema.describe('US address validation and standardization results');
+// Response Schemas using BaseResponseSchema
+/**
+ * Health check response
+ */
+export const HealthCheckResponseSchema = BaseResponseSchema(HealthCheckDataSchema);
+/**
+ * Ping response
+ */
+export const PingResponseSchema = BaseResponseSchema(PingDataSchema);
+/**
+ * US address lookup response
+ */
+export const USLookupResponseSchema = BaseResponseSchema(USLookupDataSchema);
+//# sourceMappingURL=schemas.js.map

package/dist/esm/services/smarty-streets/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../src/services/smarty-streets/schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/services/ups/client.d.ts

@@ -0,0 +1,215 @@
+import { BaseServiceClient } from '../../core/base-client';
+import type { HTTPClient } from '../../core/client';
+import { HealthCheckParams, HealthCheckResponse, RatesShopParams, RatesShopResponse, HealthCheckData, RatesShopData } from './schemas';
+/**
+ * UPS Shipping Service Client
+ *
+ * Provides comprehensive UPS shipping rate calculation, service comparison,
+ * and shipping cost optimization. Offers detailed UPS service options with
+ * accurate pricing for domestic and international shipments.
+ *
+ * @service ups
+ * @domain shipping-and-logistics
+ */
+export declare class UPSClient extends BaseServiceClient {
+    constructor(http: HTTPClient, baseUrl?: string);
+    protected getServiceDescription(): string;
+    /**
+     * 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({ '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.healthCheckData({ 'x-site-id': 'SITE123' });
+     * console.log(status); // Health data object
+     * ```
+     */
+    healthCheck(params: HealthCheckParams): Promise<HealthCheckResponse>;
+    /**
+     * 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(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.ratesShopData(upsRateRequest);
+     * console.log(ratesData); // Direct UPS rates data access
+     *
+     * // Find ground shipping options
+     * const groundRates = await client.ratesShop({
+     *   ...upsRateRequest,
+     *   // UPS will return available ground services
+     * });
+     *
+     * // International UPS shipping
+     * const internationalRates = await client.ratesShop({
+     *   fromAddress1: '123 US Warehouse',
+     *   fromCity: 'Los Angeles',
+     *   fromStateProvinceCode: 'CA',
+     *   fromPostalCode: '90210',
+     *   fromCountryCode: 'US',
+     *
+     *   toAddress1: '456 International St',
+     *   toCity: 'Toronto',
+     *   toStateProvinceCode: 'ON',
+     *   toPostalCode: 'M5V 3A8',
+     *   toCountryCode: 'CA',
+     *
+     *   weight: 10,
+     *   'x-site-id': 'SITE123'
+     * });
+     *
+     * // Heavy package UPS rates
+     * const heavyPackageRates = await client.ratesShop({
+     *   ...upsRateRequest,
+     *   weight: 50, // 50 pounds
+     * });
+     *
+     * // Use cached rates for performance
+     * const cachedRates = await client.ratesShop({
+     *   ...upsRateRequest,
+     *   cacheSiteId: 'HIGH-VOLUME-SITE', // Enable edge caching
+     * });
+     *
+     * // Handle UPS rate selection
+     * if (ratesData.rates && ratesData.rates.length > 0) {
+     *   const selectedRate = ratesData.cheapest_rate;
+     *   console.log('Selected UPS Service:', selectedRate?.service_name);
+     *   console.log('Cost:', selectedRate?.total_charges);
+     *   console.log('Delivery Date:', selectedRate?.delivery_date);
+     *   console.log('Business Days:', selectedRate?.business_days_in_transit);
+     * }
+     *
+     * // Extract service-specific information
+     * if (ratesData.services_available) {
+     *   console.log('Available UPS Services:');
+     *   ratesData.services_available.forEach(service => {
+     *     console.log(`- ${service.name}: ${service.description}`);
+     *   });
+     * }
+     * ```
+     */
+    ratesShop(params: RatesShopParams): Promise<RatesShopResponse>;
+    /**
+     * Get UPS service health data without full response metadata
+     *
+     * @fullPath api.ups.healthCheckData.get
+     * @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
+     */
+    healthCheckData(params: HealthCheckParams): Promise<HealthCheckData>;
+    /**
+     * Get UPS shipping rates data without full response metadata
+     *
+     * @fullPath api.ups.ratesShopData.get
+     * @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
+     */
+    ratesShopData(params: RatesShopParams): Promise<RatesShopData>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/esm/services/ups/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/services/ups/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAEL,iBAAiB,EAEjB,mBAAmB,EAEnB,eAAe,EAEf,iBAAiB,EACjB,eAAe,EACf,aAAa,EACd,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;GASG;AACH,qBAAa,SAAU,SAAQ,iBAAiB;gBAClC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM;IAI9C,SAAS,CAAC,qBAAqB,IAAI,MAAM;IAIzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAY1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgHG;IACG,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAcpE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAK1E;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;CAIrE"}

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

@@ -0,0 +1,239 @@
+import { BaseServiceClient } from '../../core/base-client';
+import { HealthCheckParamsSchema, HealthCheckResponseSchema, RatesShopParamsSchema, RatesShopResponseSchema, } from './schemas';
+/**
+ * UPS Shipping Service Client
+ *
+ * Provides comprehensive UPS shipping rate calculation, service comparison,
+ * and shipping cost optimization. Offers detailed UPS service options with
+ * accurate pricing for domestic and international shipments.
+ *
+ * @service ups
+ * @domain shipping-and-logistics
+ */
+export class UPSClient extends BaseServiceClient {
+    constructor(http, baseUrl) {
+        super('ups', http, baseUrl || 'https://ups.augur-api.com');
+    }
+    getServiceDescription() {
+        return 'UPS shipping rate calculation and service comparison service';
+    }
+    /**
+     * 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({ '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.healthCheckData({ 'x-site-id': 'SITE123' });
+     * console.log(status); // Health data object
+     * ```
+     */
+    async healthCheck(params) {
+        return this.executeRequest({
+            method: 'GET',
+            path: '/health-check',
+            paramsSchema: HealthCheckParamsSchema,
+            responseSchema: HealthCheckResponseSchema,
+        }, params);
+    }
+    /**
+     * 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(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.ratesShopData(upsRateRequest);
+     * console.log(ratesData); // Direct UPS rates data access
+     *
+     * // Find ground shipping options
+     * const groundRates = await client.ratesShop({
+     *   ...upsRateRequest,
+     *   // UPS will return available ground services
+     * });
+     *
+     * // International UPS shipping
+     * const internationalRates = await client.ratesShop({
+     *   fromAddress1: '123 US Warehouse',
+     *   fromCity: 'Los Angeles',
+     *   fromStateProvinceCode: 'CA',
+     *   fromPostalCode: '90210',
+     *   fromCountryCode: 'US',
+     *
+     *   toAddress1: '456 International St',
+     *   toCity: 'Toronto',
+     *   toStateProvinceCode: 'ON',
+     *   toPostalCode: 'M5V 3A8',
+     *   toCountryCode: 'CA',
+     *
+     *   weight: 10,
+     *   'x-site-id': 'SITE123'
+     * });
+     *
+     * // Heavy package UPS rates
+     * const heavyPackageRates = await client.ratesShop({
+     *   ...upsRateRequest,
+     *   weight: 50, // 50 pounds
+     * });
+     *
+     * // Use cached rates for performance
+     * const cachedRates = await client.ratesShop({
+     *   ...upsRateRequest,
+     *   cacheSiteId: 'HIGH-VOLUME-SITE', // Enable edge caching
+     * });
+     *
+     * // Handle UPS rate selection
+     * if (ratesData.rates && ratesData.rates.length > 0) {
+     *   const selectedRate = ratesData.cheapest_rate;
+     *   console.log('Selected UPS Service:', selectedRate?.service_name);
+     *   console.log('Cost:', selectedRate?.total_charges);
+     *   console.log('Delivery Date:', selectedRate?.delivery_date);
+     *   console.log('Business Days:', selectedRate?.business_days_in_transit);
+     * }
+     *
+     * // Extract service-specific information
+     * if (ratesData.services_available) {
+     *   console.log('Available UPS Services:');
+     *   ratesData.services_available.forEach(service => {
+     *     console.log(`- ${service.name}: ${service.description}`);
+     *   });
+     * }
+     * ```
+     */
+    async ratesShop(params) {
+        return this.executeRequest({
+            method: 'GET',
+            path: '/rates-shop',
+            paramsSchema: RatesShopParamsSchema,
+            responseSchema: RatesShopResponseSchema,
+        }, params);
+    }
+    // Data methods - return data portion only for convenience
+    /**
+     * Get UPS service health data without full response metadata
+     *
+     * @fullPath api.ups.healthCheckData.get
+     * @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 healthCheckData(params) {
+        const response = await this.healthCheck(params);
+        return response.data;
+    }
+    /**
+     * Get UPS shipping rates data without full response metadata
+     *
+     * @fullPath api.ups.ratesShopData.get
+     * @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 ratesShopData(params) {
+        const response = await this.ratesShop(params);
+        return response.data;
+    }
+}
+//# sourceMappingURL=client.js.map