@simpleapps-com/augur-api 0.2.13 → 0.3.1

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

@@ -12,10 +12,10 @@ import { PriceEngineParamsSchema, PriceEngineResponseSchema, TaxEngineRequestSch
  * const pricing = new PricingClient(http);
  *
  * // Get item price
- * const price = await pricing.getPrice({ customerId: 12345, itemId: 'ABC123', quantity: 10 });
+ * const price = await pricing.priceEngine.calculate({ customerId: 12345, itemId: 'ABC123', quantity: 10 });
  *
  * // Calculate tax
- * const tax = await pricing.calculateTax({
+ * const tax = await pricing.taxEngine.calculate({
  *   customer_id: 12345,
  *   postal_code: '12345',
  *   items: [{ item_id: 'ABC123', quantity: 2, unit_price: 25.99, extended_amount: 51.98 }],
@@ -23,7 +23,7 @@ import { PriceEngineParamsSchema, PriceEngineResponseSchema, TaxEngineRequestSch
  * });
  *
  * // List job price headers
- * const jobHeaders = await pricing.jobPriceHeaders.list({ limit: 25, q: 'contract' });
+ * const jobHeaders = await pricing.jobPriceHdr.list({ limit: 25, q: 'contract' });
  * ```
  */
 export class PricingClient extends BaseServiceClient {
@@ -34,11 +34,94 @@ export class PricingClient extends BaseServiceClient {
      */
     constructor(http, baseUrl = 'https://pricing.augur-api.com') {
         super('pricing', http, baseUrl);
+        /**
+         * Price engine operations
+         * @description Pricing calculations and price determination
+         */
+        this.priceEngine = {
+            /**
+             * Calculate item price using the price engine
+             * @description Primary pricing endpoint for calculating item prices with sophisticated caching and compression
+             * @param params Pricing parameters including customer ID, item ID, quantity, and other options
+             * @returns Detailed pricing information including base price, unit price, discounts, and calculation details
+             * @throws ValidationError When parameters are invalid or response is malformed
+             * @example
+             * ```typescript
+             * const price = await client.priceEngine.calculate({
+             *   customerId: 12345,
+             *   itemId: 'ABC123',
+             *   quantity: 10,
+             *   unitOfMeasure: 'EA',
+             *   shipToId: 456
+             * });
+             *
+             * console.log('Unit Price:', price.unit_price);
+             * console.log('Discount:', price.discount_percent);
+             * console.log('Price Source:', price.price_source);
+             * ```
+             */
+            calculate: async (params) => {
+                return this.executeRequest({
+                    method: 'GET',
+                    path: '/price-engine',
+                    paramsSchema: PriceEngineParamsSchema,
+                    responseSchema: PriceEngineResponseSchema,
+                }, params);
+            },
+        };
+        /**
+         * Tax engine operations
+         * @description Tax calculations and jurisdiction-based tax determination
+         */
+        this.taxEngine = {
+            /**
+             * Calculate tax using the tax engine
+             * @description Tax calculation endpoint with postal code-based rate lookups and jurisdiction breakdowns
+             * @param request Tax calculation request with customer, items, and shipping address information
+             * @returns Detailed tax calculation with total tax, rates, and jurisdiction-specific breakdowns
+             * @throws ValidationError When request is invalid or response is malformed
+             * @example
+             * ```typescript
+             * const tax = await client.taxEngine.calculate({
+             *   customer_id: 12345,
+             *   postal_code: '12345',
+             *   items: [
+             *     {
+             *       item_id: 'ABC123',
+             *       quantity: 2,
+             *       unit_price: 25.99,
+             *       extended_amount: 51.98
+             *     }
+             *   ],
+             *   ship_to_address: {
+             *     street: '123 Main St',
+             *     city: 'Anytown',
+             *     state: 'NY',
+             *     postal_code: '12345'
+             *   }
+             * });
+             *
+             * console.log('Total Tax:', tax.total_tax);
+             * console.log('Tax Rate:', tax.tax_rate);
+             * tax.jurisdictions.forEach(j => {
+             *   console.log(`${j.jurisdiction_name}: ${j.tax_rate}% = $${j.tax_amount}`);
+             * });
+             * ```
+             */
+            calculate: async (request) => {
+                return this.executeRequest({
+                    method: 'POST',
+                    path: '/tax-engine',
+                    paramsSchema: TaxEngineRequestSchema,
+                    responseSchema: TaxEngineResponseSchema,
+                }, request);
+            },
+        };
         /**
          * Job Price Header endpoints
          * @description Methods for managing job-based pricing contracts and agreements
          */
-        this.jobPriceHeaders = {
+        this.jobPriceHdr = {
             /**
              * List job price headers with filtering and pagination
              * @description Retrieves job price headers with optional search, filtering, and pagination
@@ -179,76 +262,5 @@ export class PricingClient extends BaseServiceClient {
             },
         };
     }
-    /**
-     * Calculate item price using the price engine
-     * @description Primary pricing endpoint for calculating item prices with sophisticated caching and compression
-     * @param params Pricing parameters including customer ID, item ID, quantity, and other options
-     * @returns Detailed pricing information including base price, unit price, discounts, and calculation details
-     * @throws ValidationError When parameters are invalid or response is malformed
-     * @example
-     * ```typescript
-     * const price = await client.getPrice({
-     *   customerId: 12345,
-     *   itemId: 'ABC123',
-     *   quantity: 10,
-     *   unitOfMeasure: 'EA',
-     *   shipToId: 456
-     * });
-     *
-     * console.log('Unit Price:', price.unit_price);
-     * console.log('Discount:', price.discount_percent);
-     * console.log('Price Source:', price.price_source);
-     * ```
-     */
-    async getPrice(params) {
-        return this.executeRequest({
-            method: 'GET',
-            path: '/price-engine',
-            paramsSchema: PriceEngineParamsSchema,
-            responseSchema: PriceEngineResponseSchema,
-        }, params);
-    }
-    /**
-     * Calculate tax using the tax engine
-     * @description Tax calculation endpoint with postal code-based rate lookups and jurisdiction breakdowns
-     * @param request Tax calculation request with customer, items, and shipping address information
-     * @returns Detailed tax calculation with total tax, rates, and jurisdiction-specific breakdowns
-     * @throws ValidationError When request is invalid or response is malformed
-     * @example
-     * ```typescript
-     * const tax = await client.calculateTax({
-     *   customer_id: 12345,
-     *   postal_code: '12345',
-     *   items: [
-     *     {
-     *       item_id: 'ABC123',
-     *       quantity: 2,
-     *       unit_price: 25.99,
-     *       extended_amount: 51.98
-     *     }
-     *   ],
-     *   ship_to_address: {
-     *     street: '123 Main St',
-     *     city: 'Anytown',
-     *     state: 'NY',
-     *     postal_code: '12345'
-     *   }
-     * });
-     *
-     * console.log('Total Tax:', tax.total_tax);
-     * console.log('Tax Rate:', tax.tax_rate);
-     * tax.jurisdictions.forEach(j => {
-     *   console.log(`${j.jurisdiction_name}: ${j.tax_rate}% = $${j.tax_amount}`);
-     * });
-     * ```
-     */
-    async calculateTax(request) {
-        return this.executeRequest({
-            method: 'POST',
-            path: '/tax-engine',
-            paramsSchema: TaxEngineRequestSchema,
-            responseSchema: TaxEngineResponseSchema,
-        }, request);
-    }
 }
 //# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,201 @@
+import { BaseServiceClient } from '../../core/base-client';
+import type { HTTPClient } from '../../core/client';
+import { HealthCheckParams, HealthCheckResponse, RatesRequestParams, RatesResponse, RatesData } from './schemas';
+/**
+ * Shipping Service Client
+ *
+ * Provides access to comprehensive shipping rate calculation, carrier comparison,
+ * and shipping cost optimization across multiple carriers and service types.
+ * Supports domestic and international shipping with detailed rate analysis.
+ *
+ * @service shipping
+ * @domain shipping-and-logistics
+ */
+export declare class ShippingClient extends BaseServiceClient {
+    constructor(http: HTTPClient, baseUrl?: string);
+    protected getServiceDescription(): string;
+    /**
+     * Check shipping service health and availability
+     *
+     * @fullPath api.shipping.healthCheck.get
+     * @service shipping
+     * @domain system-health
+     * @dataMethod healthCheckData
+     * @discoverable true
+     * @searchTerms ["health", "status", "availability", "ping", "check", "shipping service", "carriers", "rates"]
+     * @relatedEndpoints ["api.shipping.rates.calculate", "api.logistics.healthCheck.get", "api.commerce.healthCheck.get", "api.orders.healthCheck.get"]
+     * @commonPatterns ["Health check", "Service status", "Shipping service availability", "System monitoring", "Carrier connectivity"]
+     * @workflow ["system-monitoring", "health-checks", "service-discovery", "shipping-service-verification", "carrier-status-check"]
+     * @prerequisites ["Service is running", "Valid authentication token", "x-site-id header", "Carrier API connections"]
+     * @nextSteps ["Use shipping rate endpoints if healthy", "Verify carrier API connectivity", "Monitor shipping service metrics"]
+     * @businessRules ["Returns service and carrier status", "Requires standard authentication", "Standard health check format"]
+     * @functionalArea "system-monitoring"
+     * @caching "No caching - real-time status required"
+     * @performance "Fast response, minimal processing, use for shipping service monitoring"
+     *
+     * @param params Health check parameters with site ID
+     * @returns Promise<HealthCheckResponse> Service health status with carrier availability
+     *
+     * @example
+     * ```typescript
+     * // Check if shipping service is healthy
+     * const response = await client.healthCheck({ 'x-site-id': 'SITE123' });
+     * console.log(response.data.status); // 'healthy'
+     * console.log(response.data.service); // 'shipping'
+     * 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>;
+    /**
+     * Get comprehensive shipping rates from multiple carriers
+     *
+     * @fullPath api.shipping.rates.calculate
+     * @service shipping
+     * @domain shipping-and-logistics
+     * @dataMethod ratesData
+     * @discoverable true
+     * @searchTerms ["shipping rates", "calculate cost", "carrier comparison", "freight quotes", "delivery cost", "ups", "fedex", "usps", "dhl", "shipping options"]
+     * @relatedEndpoints ["api.logistics.speedship.freight.get", "api.commerce.cart.shipping.calculate", "api.orders.shipping.estimate", "api.customers.addresses.validate"]
+     * @commonPatterns ["Calculate shipping cost", "Compare carrier rates", "Get delivery options", "Estimate shipping", "Find cheapest option", "Get fastest delivery"]
+     * @workflow ["e-commerce-checkout", "order-fulfillment", "shipping-estimation", "cost-analysis", "carrier-selection", "delivery-planning"]
+     * @prerequisites ["Valid shipping addresses", "Package dimensions and weight", "Valid authentication token", "x-site-id header", "Carrier API access"]
+     * @nextSteps ["Select shipping option", "Create shipping label", "Track shipment", "Update order with shipping cost", "Process payment with shipping"]
+     * @businessRules ["Requires complete address information", "Package weight/dimensions mandatory", "Supports multiple packages", "Returns carrier-specific rates", "Includes all fees and surcharges"]
+     * @functionalArea "shipping-and-logistics"
+     * @crossSite "Supports multi-site shipping configurations and carrier accounts"
+     * @caching "Cache rates for 15 minutes, invalidate on address or package changes"
+     * @performance "Parallel carrier API calls, use response format to optimize data size, supports pagination for large results"
+     *
+     * @param params Comprehensive shipping rate request with origin, destination, and package details
+     * @returns Promise<RatesResponse> Complete shipping rates from multiple carriers with detailed analysis
+     *
+     * @example
+     * ```typescript
+     * // Calculate shipping rates for e-commerce order
+     * const rateRequest = {
+     *   // Origin address (warehouse/fulfillment center)
+     *   fromAddressLine: '123 Warehouse Blvd',
+     *   fromCity: 'Los Angeles',
+     *   fromState: 'CA',
+     *   fromPostalCode: '90210',
+     *   fromCountryCode: 'US',
+     *   fromCompanyName: 'E-Commerce Fulfillment',
+     *
+     *   // Customer delivery address
+     *   toAddressLine: '456 Customer St',
+     *   toCity: 'New York',
+     *   toState: 'NY',
+     *   toPostalCode: '10001',
+     *   toCountryCode: 'US',
+     *   toCompanyName: 'Customer Corp',
+     *
+     *   // Package information
+     *   packages: [{
+     *     length: 12,
+     *     width: 8,
+     *     height: 6,
+     *     weight: 2.5,
+     *     dimensionUnit: 'in',
+     *     weightUnit: 'lb',
+     *     value: 150.00,
+     *     description: 'Electronics order'
+     *   }],
+     *
+     *   // Shipping preferences
+     *   serviceType: 'ground',
+     *   carriers: ['ups', 'fedex', 'usps'],
+     *   responseFormat: 'detailed',
+     *   'x-site-id': 'SITE123'
+     * };
+     *
+     * const response = await client.rates(rateRequest);
+     * console.log(response.data.rates); // Array of shipping rates
+     * console.log(response.data.comparison.cheapest); // Cheapest option
+     * console.log(response.data.comparison.fastest); // Fastest option
+     *
+     * // Get just the rates data
+     * const rates = await client.ratesData(rateRequest);
+     * console.log(rates); // Direct rates data access
+     *
+     * // Find cheapest ground shipping
+     * const cheapestGround = await client.rates({
+     *   ...rateRequest,
+     *   serviceType: 'ground',
+     *   responseFormat: 'cheapest'
+     * });
+     *
+     * // Compare overnight options
+     * const overnightOptions = await client.rates({
+     *   ...rateRequest,
+     *   serviceType: 'overnight',
+     *   responseFormat: 'all'
+     * });
+     *
+     * // International shipping with insurance
+     * const internationalRates = await client.rates({
+     *   ...rateRequest,
+     *   toCountryCode: 'CA', // Canada
+     *   serviceType: 'international',
+     *   insuranceValue: 500.00,
+     *   signatureRequired: true
+     * });
+     * ```
+     */
+    rates(params: RatesRequestParams): Promise<RatesResponse>;
+    /**
+     * Get shipping service health data without full response metadata
+     *
+     * @fullPath api.shipping.healthCheckData.get
+     * @service shipping
+     * @domain system-health
+     * @dataMethod healthCheckData
+     * @discoverable true
+     * @searchTerms ["health data", "service status", "shipping availability", "carrier status"]
+     * @relatedEndpoints ["api.shipping.healthCheck.get", "api.shipping.rates.calculate"]
+     * @commonPatterns ["Get health status", "Check carrier availability", "Service monitoring"]
+     * @workflow ["system-monitoring", "health-checks", "service-verification"]
+     * @prerequisites ["Valid authentication token", "x-site-id header"]
+     * @nextSteps ["Use shipping endpoints if healthy", "Monitor 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<{
+        status: string;
+        service: string;
+        timestamp?: string | undefined;
+        version?: string | undefined;
+    }>;
+    /**
+     * Get shipping rates data without full response metadata
+     *
+     * @fullPath api.shipping.ratesData.calculate
+     * @service shipping
+     * @domain shipping-and-logistics
+     * @dataMethod ratesData
+     * @discoverable true
+     * @searchTerms ["rates data", "shipping cost", "carrier quotes", "delivery prices", "freight data"]
+     * @relatedEndpoints ["api.shipping.rates.calculate", "api.logistics.speedship.freight.get"]
+     * @commonPatterns ["Get rates data", "Calculate shipping cost", "Compare carrier options"]
+     * @workflow ["e-commerce-checkout", "order-fulfillment", "shipping-estimation"]
+     * @prerequisites ["Valid shipping addresses", "Package details", "Valid authentication token"]
+     * @nextSteps ["Select shipping option", "Create shipping label", "Process payment"]
+     * @businessRules ["Returns only rates data", "No response metadata included", "Direct access to rate comparison"]
+     * @functionalArea "shipping-and-logistics"
+     * @caching "Cache rates for 15 minutes"
+     * @performance "Direct data access, optimal for rate comparisons and integrations"
+     *
+     * @param params Comprehensive shipping rate request parameters
+     * @returns Promise<RatesData> Direct shipping rates data without response wrapper
+     */
+    ratesData(params: RatesRequestParams): Promise<RatesData>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/services/shipping/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,kBAAkB,EAElB,aAAa,EACb,SAAS,EACV,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,iBAAiB;gBACvC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM;IAI9C,SAAS,CAAC,qBAAqB,IAAI,MAAM;IAIzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAY1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8FG;IACG,KAAK,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAc/D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,eAAe,CAAC,MAAM,EAAE,iBAAiB;;;;;;IAK/C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;CAIhE"}

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

@@ -0,0 +1,220 @@
+import { BaseServiceClient } from '../../core/base-client';
+import { HealthCheckParamsSchema, HealthCheckResponseSchema, RatesRequestParamsSchema, RatesResponseSchema, } from './schemas';
+/**
+ * Shipping Service Client
+ *
+ * Provides access to comprehensive shipping rate calculation, carrier comparison,
+ * and shipping cost optimization across multiple carriers and service types.
+ * Supports domestic and international shipping with detailed rate analysis.
+ *
+ * @service shipping
+ * @domain shipping-and-logistics
+ */
+export class ShippingClient extends BaseServiceClient {
+    constructor(http, baseUrl) {
+        super('shipping', http, baseUrl || 'https://shipping.augur-api.com');
+    }
+    getServiceDescription() {
+        return 'Comprehensive shipping rate calculation and carrier comparison service';
+    }
+    /**
+     * Check shipping service health and availability
+     *
+     * @fullPath api.shipping.healthCheck.get
+     * @service shipping
+     * @domain system-health
+     * @dataMethod healthCheckData
+     * @discoverable true
+     * @searchTerms ["health", "status", "availability", "ping", "check", "shipping service", "carriers", "rates"]
+     * @relatedEndpoints ["api.shipping.rates.calculate", "api.logistics.healthCheck.get", "api.commerce.healthCheck.get", "api.orders.healthCheck.get"]
+     * @commonPatterns ["Health check", "Service status", "Shipping service availability", "System monitoring", "Carrier connectivity"]
+     * @workflow ["system-monitoring", "health-checks", "service-discovery", "shipping-service-verification", "carrier-status-check"]
+     * @prerequisites ["Service is running", "Valid authentication token", "x-site-id header", "Carrier API connections"]
+     * @nextSteps ["Use shipping rate endpoints if healthy", "Verify carrier API connectivity", "Monitor shipping service metrics"]
+     * @businessRules ["Returns service and carrier status", "Requires standard authentication", "Standard health check format"]
+     * @functionalArea "system-monitoring"
+     * @caching "No caching - real-time status required"
+     * @performance "Fast response, minimal processing, use for shipping service monitoring"
+     *
+     * @param params Health check parameters with site ID
+     * @returns Promise<HealthCheckResponse> Service health status with carrier availability
+     *
+     * @example
+     * ```typescript
+     * // Check if shipping service is healthy
+     * const response = await client.healthCheck({ 'x-site-id': 'SITE123' });
+     * console.log(response.data.status); // 'healthy'
+     * console.log(response.data.service); // 'shipping'
+     * 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);
+    }
+    /**
+     * Get comprehensive shipping rates from multiple carriers
+     *
+     * @fullPath api.shipping.rates.calculate
+     * @service shipping
+     * @domain shipping-and-logistics
+     * @dataMethod ratesData
+     * @discoverable true
+     * @searchTerms ["shipping rates", "calculate cost", "carrier comparison", "freight quotes", "delivery cost", "ups", "fedex", "usps", "dhl", "shipping options"]
+     * @relatedEndpoints ["api.logistics.speedship.freight.get", "api.commerce.cart.shipping.calculate", "api.orders.shipping.estimate", "api.customers.addresses.validate"]
+     * @commonPatterns ["Calculate shipping cost", "Compare carrier rates", "Get delivery options", "Estimate shipping", "Find cheapest option", "Get fastest delivery"]
+     * @workflow ["e-commerce-checkout", "order-fulfillment", "shipping-estimation", "cost-analysis", "carrier-selection", "delivery-planning"]
+     * @prerequisites ["Valid shipping addresses", "Package dimensions and weight", "Valid authentication token", "x-site-id header", "Carrier API access"]
+     * @nextSteps ["Select shipping option", "Create shipping label", "Track shipment", "Update order with shipping cost", "Process payment with shipping"]
+     * @businessRules ["Requires complete address information", "Package weight/dimensions mandatory", "Supports multiple packages", "Returns carrier-specific rates", "Includes all fees and surcharges"]
+     * @functionalArea "shipping-and-logistics"
+     * @crossSite "Supports multi-site shipping configurations and carrier accounts"
+     * @caching "Cache rates for 15 minutes, invalidate on address or package changes"
+     * @performance "Parallel carrier API calls, use response format to optimize data size, supports pagination for large results"
+     *
+     * @param params Comprehensive shipping rate request with origin, destination, and package details
+     * @returns Promise<RatesResponse> Complete shipping rates from multiple carriers with detailed analysis
+     *
+     * @example
+     * ```typescript
+     * // Calculate shipping rates for e-commerce order
+     * const rateRequest = {
+     *   // Origin address (warehouse/fulfillment center)
+     *   fromAddressLine: '123 Warehouse Blvd',
+     *   fromCity: 'Los Angeles',
+     *   fromState: 'CA',
+     *   fromPostalCode: '90210',
+     *   fromCountryCode: 'US',
+     *   fromCompanyName: 'E-Commerce Fulfillment',
+     *
+     *   // Customer delivery address
+     *   toAddressLine: '456 Customer St',
+     *   toCity: 'New York',
+     *   toState: 'NY',
+     *   toPostalCode: '10001',
+     *   toCountryCode: 'US',
+     *   toCompanyName: 'Customer Corp',
+     *
+     *   // Package information
+     *   packages: [{
+     *     length: 12,
+     *     width: 8,
+     *     height: 6,
+     *     weight: 2.5,
+     *     dimensionUnit: 'in',
+     *     weightUnit: 'lb',
+     *     value: 150.00,
+     *     description: 'Electronics order'
+     *   }],
+     *
+     *   // Shipping preferences
+     *   serviceType: 'ground',
+     *   carriers: ['ups', 'fedex', 'usps'],
+     *   responseFormat: 'detailed',
+     *   'x-site-id': 'SITE123'
+     * };
+     *
+     * const response = await client.rates(rateRequest);
+     * console.log(response.data.rates); // Array of shipping rates
+     * console.log(response.data.comparison.cheapest); // Cheapest option
+     * console.log(response.data.comparison.fastest); // Fastest option
+     *
+     * // Get just the rates data
+     * const rates = await client.ratesData(rateRequest);
+     * console.log(rates); // Direct rates data access
+     *
+     * // Find cheapest ground shipping
+     * const cheapestGround = await client.rates({
+     *   ...rateRequest,
+     *   serviceType: 'ground',
+     *   responseFormat: 'cheapest'
+     * });
+     *
+     * // Compare overnight options
+     * const overnightOptions = await client.rates({
+     *   ...rateRequest,
+     *   serviceType: 'overnight',
+     *   responseFormat: 'all'
+     * });
+     *
+     * // International shipping with insurance
+     * const internationalRates = await client.rates({
+     *   ...rateRequest,
+     *   toCountryCode: 'CA', // Canada
+     *   serviceType: 'international',
+     *   insuranceValue: 500.00,
+     *   signatureRequired: true
+     * });
+     * ```
+     */
+    async rates(params) {
+        return this.executeRequest({
+            method: 'POST',
+            path: '/rates',
+            paramsSchema: RatesRequestParamsSchema,
+            responseSchema: RatesResponseSchema,
+        }, params);
+    }
+    // Data methods - return data portion only for convenience
+    /**
+     * Get shipping service health data without full response metadata
+     *
+     * @fullPath api.shipping.healthCheckData.get
+     * @service shipping
+     * @domain system-health
+     * @dataMethod healthCheckData
+     * @discoverable true
+     * @searchTerms ["health data", "service status", "shipping availability", "carrier status"]
+     * @relatedEndpoints ["api.shipping.healthCheck.get", "api.shipping.rates.calculate"]
+     * @commonPatterns ["Get health status", "Check carrier availability", "Service monitoring"]
+     * @workflow ["system-monitoring", "health-checks", "service-verification"]
+     * @prerequisites ["Valid authentication token", "x-site-id header"]
+     * @nextSteps ["Use shipping endpoints if healthy", "Monitor 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 shipping rates data without full response metadata
+     *
+     * @fullPath api.shipping.ratesData.calculate
+     * @service shipping
+     * @domain shipping-and-logistics
+     * @dataMethod ratesData
+     * @discoverable true
+     * @searchTerms ["rates data", "shipping cost", "carrier quotes", "delivery prices", "freight data"]
+     * @relatedEndpoints ["api.shipping.rates.calculate", "api.logistics.speedship.freight.get"]
+     * @commonPatterns ["Get rates data", "Calculate shipping cost", "Compare carrier options"]
+     * @workflow ["e-commerce-checkout", "order-fulfillment", "shipping-estimation"]
+     * @prerequisites ["Valid shipping addresses", "Package details", "Valid authentication token"]
+     * @nextSteps ["Select shipping option", "Create shipping label", "Process payment"]
+     * @businessRules ["Returns only rates data", "No response metadata included", "Direct access to rate comparison"]
+     * @functionalArea "shipping-and-logistics"
+     * @caching "Cache rates for 15 minutes"
+     * @performance "Direct data access, optimal for rate comparisons and integrations"
+     *
+     * @param params Comprehensive shipping rate request parameters
+     * @returns Promise<RatesData> Direct shipping rates data without response wrapper
+     */
+    async ratesData(params) {
+        const response = await this.rates(params);
+        return response.data;
+    }
+}
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/services/shipping/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EACL,uBAAuB,EAEvB,yBAAyB,EAEzB,wBAAwB,EAExB,mBAAmB,GAGpB,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAe,SAAQ,iBAAiB;IACnD,YAAY,IAAgB,EAAE,OAAgB;QAC5C,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,IAAI,gCAAgC,CAAC,CAAC;IACvE,CAAC;IAES,qBAAqB;QAC7B,OAAO,wEAAwE,CAAC;IAClF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,KAAK,CAAC,WAAW,CAAC,MAAyB;QACzC,OAAO,IAAI,CAAC,cAAc,CACxB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe;YACrB,YAAY,EAAE,uBAAuB;YACrC,cAAc,EAAE,yBAAyB;SAC1C,EACD,MAAM,CACP,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8FG;IACH,KAAK,CAAC,KAAK,CAAC,MAA0B;QACpC,OAAO,IAAI,CAAC,cAAc,CACxB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,wBAAwB;YACtC,cAAc,EAAE,mBAAmB;SACpC,EACD,MAAM,CACP,CAAC;IACJ,CAAC;IAED,0DAA0D;IAE1D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,eAAe,CAAC,MAAyB;QAC7C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,SAAS,CAAC,MAA0B;QACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1C,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF"}

package/dist/esm/services/shipping/index.d.ts

@@ -0,0 +1,4 @@
+export { ShippingClient } from './client';
+export type { HealthCheckParams, RatesRequestParams, HealthCheckData, ShippingRate, ShippingRatesSummary, ShippingRatesDetailed, ShippingRatesResult, RatesData, HealthCheckResponse, RatesResponse, } from './schemas';
+export { HealthCheckParamsSchema, RatesRequestParamsSchema, HealthCheckDataSchema, ShippingRateSchema, ShippingRatesSummarySchema, ShippingRatesDetailedSchema, ShippingRatesResultSchema, RatesDataSchema, HealthCheckResponseSchema, RatesResponseSchema, } from './schemas';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/services/shipping/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/shipping/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,EACT,mBAAmB,EACnB,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,eAAe,EACf,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,WAAW,CAAC"}

package/dist/esm/services/shipping/index.js

@@ -0,0 +1,4 @@
+// Shipping Service Exports
+export { ShippingClient } from './client';
+export { HealthCheckParamsSchema, RatesRequestParamsSchema, HealthCheckDataSchema, ShippingRateSchema, ShippingRatesSummarySchema, ShippingRatesDetailedSchema, ShippingRatesResultSchema, RatesDataSchema, HealthCheckResponseSchema, RatesResponseSchema, } from './schemas';
+//# sourceMappingURL=index.js.map

package/dist/esm/services/shipping/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/shipping/index.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAa1C,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,eAAe,EACf,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,WAAW,CAAC"}