@simpleapps-com/augur-api 0.2.13 → 0.3.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/services/shipping/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsDnC,CAAC;AAIH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAOuB,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0CyC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc4B,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BuC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAOmC,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAE3B,CAAC;AAIF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA4C,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAsC,CAAC;AAIvE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

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

@@ -0,0 +1,186 @@
+import { z } from 'zod';
+import { BaseResponseSchema } from '../../core/schemas';
+// Shipping Service Parameter Schemas
+/**
+ * Health check parameters - shipping service health verification
+ */
+export const HealthCheckParamsSchema = z.object({
+    'x-site-id': z.string().describe('Site ID provided by SimpleApps'),
+});
+/**
+ * Shipping rates request parameters - comprehensive shipping rate calculation
+ * Supports multiple carriers, service types, and package configurations
+ */
+export const RatesRequestParamsSchema = z.object({
+    // Required shipping origin information
+    fromAddressLine: z.string().min(1, 'From address line is required'),
+    fromCity: z.string().min(1, 'From city is required'),
+    fromState: z.string().min(1, 'From state is required'),
+    fromPostalCode: z.string().min(1, 'From postal code is required'),
+    fromCountryCode: z.string().min(2, 'From country code is required (ISO 2-letter)'),
+    fromCompanyName: z.string().optional(),
+    fromContactName: z.string().optional(),
+    fromPhone: z.string().optional(),
+    fromEmail: z.string().email().optional(),
+    // Required shipping destination information
+    toAddressLine: z.string().min(1, 'To address line is required'),
+    toCity: z.string().min(1, 'To city is required'),
+    toState: z.string().min(1, 'To state is required'),
+    toPostalCode: z.string().min(1, 'To postal code is required'),
+    toCountryCode: z.string().min(2, 'To country code is required (ISO 2-letter)'),
+    toCompanyName: z.string().optional(),
+    toContactName: z.string().optional(),
+    toPhone: z.string().optional(),
+    toEmail: z.string().email().optional(),
+    // Package information
+    packages: z
+        .array(z.object({
+        length: z.number().positive('Package length must be positive'),
+        width: z.number().positive('Package width must be positive'),
+        height: z.number().positive('Package height must be positive'),
+        weight: z.number().positive('Package weight must be positive'),
+        dimensionUnit: z.enum(['in', 'cm', 'IN', 'CM']).default('in'),
+        weightUnit: z.enum(['lb', 'kg', 'LB', 'KG']).default('lb'),
+        packageType: z.enum(['box', 'envelope', 'tube', 'pak', 'pallet']).optional(),
+        value: z.number().positive().optional(),
+        description: z.string().optional(),
+    }))
+        .min(1, 'At least one package is required'),
+    // Shipping preferences
+    serviceType: z.enum(['ground', 'express', 'overnight', 'international', 'freight']).optional(),
+    carriers: z.array(z.enum(['ups', 'fedex', 'usps', 'dhl', 'all'])).optional(),
+    signatureRequired: z.boolean().optional(),
+    insuranceValue: z.number().positive().optional(),
+    residentialDelivery: z.boolean().optional(),
+    saturdayDelivery: z.boolean().optional(),
+    // Request configuration
+    responseFormat: z.enum(['summary', 'detailed', 'cheapest', 'fastest', 'all']).optional(),
+    currency: z.enum(['USD', 'CAD', 'EUR', 'GBP']).optional(),
+    // 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(),
+})
+    .describe('Shipping service health status information');
+/**
+ * Individual shipping rate result
+ */
+export const ShippingRateSchema = z
+    .object({
+    carrier: z.string(),
+    service: z.string(),
+    serviceCode: z.string(),
+    serviceName: z.string(),
+    // Cost information
+    baseRate: z.number(),
+    totalRate: z.number(),
+    finalRate: z.number(),
+    currency: z.string(),
+    // Additional fees
+    fuelSurcharge: z.number().optional(),
+    residentialFee: z.number().optional(),
+    signatureFee: z.number().optional(),
+    insuranceFee: z.number().optional(),
+    handlingFee: z.number().optional(),
+    saturdayFee: z.number().optional(),
+    // Delivery information
+    transitTime: z.string(),
+    transitDays: z.number(),
+    deliveryDate: z.string().optional(),
+    guaranteedDelivery: z.boolean().optional(),
+    // Service features
+    trackingAvailable: z.boolean().optional(),
+    signatureRequired: z.boolean().optional(),
+    insuranceAvailable: z.boolean().optional(),
+    // Metadata
+    quoteId: z.string().optional(),
+    validity: z.string().optional(),
+    restrictions: z.array(z.string()).optional(),
+    // Performance metrics
+    reliability: z.number().optional(),
+    onTimePerformance: z.number().optional(),
+    customerRating: z.number().optional(),
+})
+    .describe('Individual shipping rate with carrier and service details');
+/**
+ * Summary shipping rates result
+ */
+export const ShippingRatesSummarySchema = z
+    .object({
+    totalOptions: z.number(),
+    cheapestRate: z.number(),
+    fastestService: z.string(),
+    averageRate: z.number(),
+    priceRange: z.object({
+        min: z.number(),
+        max: z.number(),
+    }),
+    carriersAvailable: z.array(z.string()),
+    servicesAvailable: z.array(z.string()),
+    recommendedOption: ShippingRateSchema.optional(),
+})
+    .describe('Summary of shipping rate options and recommendations');
+/**
+ * Detailed shipping rates result
+ */
+export const ShippingRatesDetailedSchema = z
+    .object({
+    rates: z.array(ShippingRateSchema),
+    comparison: z.object({
+        cheapest: ShippingRateSchema,
+        fastest: ShippingRateSchema,
+        recommended: ShippingRateSchema.optional(),
+        premium: ShippingRateSchema.optional(),
+    }),
+    marketAnalysis: z
+        .object({
+        averageMarketRate: z.number(),
+        competitiveRating: z.enum(['excellent', 'good', 'average', 'poor']),
+        priceIndex: z.number(),
+        marketTrends: z.string().optional(),
+    })
+        .optional(),
+    routeDetails: z
+        .object({
+        distance: z.number(),
+        estimatedTransitTime: z.string(),
+        routeOptimization: z.enum(['standard', 'optimized', 'express']),
+        hubsInvolved: z.array(z.string()).optional(),
+    })
+        .optional(),
+})
+    .describe('Detailed shipping rates analysis with comparison and market data');
+/**
+ * Shipping rates result - union type supporting different response formats
+ */
+export const ShippingRatesResultSchema = z
+    .union([
+    ShippingRateSchema,
+    ShippingRatesSummarySchema,
+    ShippingRatesDetailedSchema,
+    z.array(ShippingRateSchema),
+])
+    .describe('Shipping rates result supporting multiple response formats');
+/**
+ * Shipping rates response data
+ */
+export const RatesDataSchema = ShippingRatesResultSchema.describe('Shipping rates calculation results');
+// Response Schemas using BaseResponseSchema
+/**
+ * Health check response
+ */
+export const HealthCheckResponseSchema = BaseResponseSchema(HealthCheckDataSchema);
+/**
+ * Shipping rates response
+ */
+export const RatesResponseSchema = BaseResponseSchema(RatesDataSchema);
+//# sourceMappingURL=schemas.js.map

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

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

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

@@ -0,0 +1,285 @@
+import { BaseServiceClient } from '../../core/base-client';
+import type { HTTPClient } from '../../core/client';
+import { HealthCheckParams, HealthCheckResponse, WebHookRequestParams, WebHookResponse, WebHookRefreshParams, WebHookRefreshResponse, WebHookData, WebHookRefreshData } from './schemas';
+/**
+ * Slack Integration Service Client
+ *
+ * Provides comprehensive Slack integration capabilities including webhook management,
+ * message delivery, channel notifications, and real-time communication features.
+ * Supports modern Slack Block Kit formatting and legacy attachment formats.
+ *
+ * @service slack
+ * @domain communication-and-notifications
+ */
+export declare class SlackClient extends BaseServiceClient {
+    constructor(http: HTTPClient, baseUrl?: string);
+    protected getServiceDescription(): string;
+    /**
+     * Check Slack service health and connectivity
+     *
+     * @fullPath api.slack.healthCheck.get
+     * @service slack
+     * @domain system-health
+     * @dataMethod healthCheckData
+     * @discoverable true
+     * @searchTerms ["health", "status", "availability", "ping", "check", "slack service", "webhook connectivity", "integration status"]
+     * @relatedEndpoints ["api.slack.webHook.send", "api.slack.webHook.refresh", "api.joomla.healthCheck.get", "api.commerce.healthCheck.get", "api.customers.healthCheck.get"]
+     * @commonPatterns ["Health check", "Service status", "Slack connectivity test", "System monitoring", "Integration verification"]
+     * @workflow ["system-monitoring", "health-checks", "service-discovery", "slack-integration-verification", "webhook-status-check"]
+     * @prerequisites ["Service is running", "Valid authentication token", "x-site-id header", "Slack API connectivity"]
+     * @nextSteps ["Use webhook endpoints if healthy", "Verify Slack API connectivity", "Monitor integration metrics", "Test message delivery"]
+     * @businessRules ["Returns service and Slack connectivity status", "Requires standard authentication", "Standard health check format", "Includes webhook status"]
+     * @functionalArea "system-monitoring"
+     * @caching "No caching - real-time status required"
+     * @performance "Fast response, minimal processing, use for Slack integration monitoring"
+     *
+     * @param params Health check parameters with site ID
+     * @returns Promise<HealthCheckResponse> Service health status with Slack connectivity information
+     *
+     * @example
+     * ```typescript
+     * // Check if Slack service is healthy
+     * const response = await client.healthCheck({ 'x-site-id': 'SITE123' });
+     * console.log(response.data.status); // 'healthy'
+     * console.log(response.data.slack_connectivity); // true/false
+     * 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>;
+    /**
+     * Send messages and manage Slack webhooks
+     *
+     * @fullPath api.slack.webHook.send
+     * @service slack
+     * @domain communication-and-notifications
+     * @dataMethod webHookData
+     * @discoverable true
+     * @searchTerms ["slack", "webhook", "message", "notification", "send", "channel", "team communication", "alerts", "blocks", "attachments"]
+     * @relatedEndpoints ["api.slack.webHook.refresh", "api.joomla.users.notifications", "api.commerce.orders.notifications", "api.customers.alerts.create"]
+     * @commonPatterns ["Send Slack message", "Team notification", "Alert delivery", "Webhook integration", "Channel broadcast", "User notification"]
+     * @workflow ["notification-delivery", "team-communication", "alert-management", "webhook-integration", "message-broadcasting", "incident-response"]
+     * @prerequisites ["Valid Slack webhook URL", "Channel permissions", "Valid authentication token", "x-site-id header", "Message content"]
+     * @nextSteps ["Monitor delivery status", "Handle webhook responses", "Update notification preferences", "Track message engagement"]
+     * @businessRules ["Supports Slack Block Kit and legacy attachments", "Requires webhook URL or channel", "Message formatting follows Slack standards", "Delivery status tracking", "Retry logic for failed deliveries"]
+     * @functionalArea "communication-and-notifications"
+     * @crossSite "Multi-site webhook configuration and message routing"
+     * @caching "No caching - real-time message delivery required"
+     * @performance "Async delivery with status tracking, batch messages for high volume, use blocks for rich formatting"
+     *
+     * @param params Webhook request parameters including message content, formatting, and delivery options
+     * @returns Promise<WebHookResponse> Webhook delivery status and message metadata
+     *
+     * @example
+     * ```typescript
+     * // Send simple text message
+     * const simpleMessage = {
+     *   text: "Hello from the API!",
+     *   channel: "#general",
+     *   'x-site-id': 'SITE123'
+     * };
+     * const response = await client.webHook(simpleMessage);
+     * console.log(response.data.delivery_status); // 'sent', 'delivered', 'failed'
+     *
+     * // Send rich message with blocks (modern Slack formatting)
+     * const richMessage = {
+     *   channel: "#alerts",
+     *   blocks: [{
+     *     type: "section",
+     *     text: {
+     *       type: "mrkdwn",
+     *       text: "*Order Alert* :warning:\nNew high-value order received"
+     *     }
+     *   }, {
+     *     type: "section",
+     *     fields: [{
+     *       type: "mrkdwn",
+     *       text: "*Order ID:*\n#12345"
+     *     }, {
+     *       type: "mrkdwn",
+     *       text: "*Amount:*\n$1,250.00"
+     *     }]
+     *   }],
+     *   'x-site-id': 'SITE123'
+     * };
+     * const alertResponse = await client.webHook(richMessage);
+     *
+     * // Send message with legacy attachments
+     * const attachmentMessage = {
+     *   text: "Order Processing Update",
+     *   channel: "#orders",
+     *   attachments: [{
+     *     color: "good",
+     *     title: "Order #12345 Processed",
+     *     text: "Customer order has been successfully processed and shipped.",
+     *     fields: [{
+     *       title: "Customer",
+     *       value: "John Doe",
+     *       short: true
+     *     }, {
+     *       title: "Total",
+     *       value: "$299.99",
+     *       short: true
+     *     }],
+     *     footer: "Order System",
+     *     ts: Date.now() / 1000
+     *   }],
+     *   'x-site-id': 'SITE123'
+     * };
+     * const orderUpdate = await client.webHook(attachmentMessage);
+     *
+     * // Get just the webhook data
+     * const deliveryStatus = await client.webHookData(simpleMessage);
+     * console.log(deliveryStatus); // Direct webhook data access
+     *
+     * // Configure webhook for automated notifications
+     * const webhookConfig = {
+     *   url: "https://hooks.slack.com/services/YOUR/WEBHOOK/URL",
+     *   channel: "#automation",
+     *   username: "API Bot",
+     *   icon_emoji: ":robot_face:",
+     *   webhook_type: "incoming",
+     *   'x-site-id': 'SITE123'
+     * };
+     * const configResponse = await client.webHook(webhookConfig);
+     * ```
+     */
+    webHook(params: WebHookRequestParams): Promise<WebHookResponse>;
+    /**
+     * Refresh Slack webhook configurations and connectivity
+     *
+     * @fullPath api.slack.webHook.refresh
+     * @service slack
+     * @domain communication-and-notifications
+     * @dataMethod webHookRefreshData
+     * @discoverable true
+     * @searchTerms ["webhook", "refresh", "configuration", "update", "sync", "connectivity", "channels", "integration refresh"]
+     * @relatedEndpoints ["api.slack.webHook.send", "api.slack.healthCheck.get", "api.joomla.configuration.refresh", "api.commerce.settings.sync"]
+     * @commonPatterns ["Refresh webhook config", "Update integration", "Sync channels", "Reconnect webhooks", "Configuration update"]
+     * @workflow ["webhook-management", "integration-maintenance", "configuration-sync", "connectivity-restoration", "channel-discovery"]
+     * @prerequisites ["Valid authentication token", "x-site-id header", "Webhook configurations exist", "Slack API connectivity"]
+     * @nextSteps ["Verify refreshed configurations", "Test webhook delivery", "Update channel mappings", "Monitor integration health"]
+     * @businessRules ["Refreshes all webhook configurations", "Discovers new channels", "Validates existing webhooks", "Updates connectivity status", "Handles configuration errors"]
+     * @functionalArea "communication-and-notifications"
+     * @crossSite "Multi-site webhook configuration refresh"
+     * @caching "Cache refreshed configuration for 1 hour"
+     * @performance "May take several seconds for full refresh, run periodically to maintain connectivity"
+     *
+     * @param params Webhook refresh parameters including force refresh option
+     * @returns Promise<WebHookRefreshResponse> Refresh results with configuration status and channel information
+     *
+     * @example
+     * ```typescript
+     * // Standard webhook refresh
+     * const refreshResponse = await client.webHookRefresh({ 'x-site-id': 'SITE123' });
+     * console.log(refreshResponse.data.refreshed); // true/false
+     * console.log(refreshResponse.data.active_webhooks); // Count of active webhooks
+     * console.log(refreshResponse.data.channels); // Available channels
+     *
+     * // Force refresh (bypasses cache)
+     * const forceRefresh = await client.webHookRefresh({
+     *   'x-site-id': 'SITE123',
+     *   force: true
+     * });
+     * console.log(forceRefresh.data.configuration_status); // 'valid', 'invalid', 'partial'
+     *
+     * // Get just the refresh data
+     * const refreshData = await client.webHookRefreshData({ 'x-site-id': 'SITE123' });
+     * console.log(refreshData); // Direct refresh data access
+     *
+     * // Handle refresh errors
+     * const refreshResult = await client.webHookRefresh({ 'x-site-id': 'SITE123' });
+     * if (refreshResult.data.errors && refreshResult.data.errors.length > 0) {
+     *   console.log('Refresh errors:', refreshResult.data.errors);
+     *   // Handle configuration issues
+     * }
+     *
+     * // Monitor webhook health after refresh
+     * if (refreshResult.data.inactive_webhooks > 0) {
+     *   console.log(`${refreshResult.data.inactive_webhooks} webhooks need attention`);
+     *   // Investigate inactive webhooks
+     * }
+     * ```
+     */
+    webHookRefresh(params: WebHookRefreshParams): Promise<WebHookRefreshResponse>;
+    /**
+     * Get Slack service health data without full response metadata
+     *
+     * @fullPath api.slack.healthCheckData.get
+     * @service slack
+     * @domain system-health
+     * @dataMethod healthCheckData
+     * @discoverable true
+     * @searchTerms ["health data", "service status", "slack connectivity", "integration status"]
+     * @relatedEndpoints ["api.slack.healthCheck.get", "api.slack.webHook.send"]
+     * @commonPatterns ["Get health status", "Check connectivity", "Service monitoring"]
+     * @workflow ["system-monitoring", "health-checks", "integration-verification"]
+     * @prerequisites ["Valid authentication token", "x-site-id header"]
+     * @nextSteps ["Use Slack 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;
+        slack_connectivity?: boolean | undefined;
+        webhook_status?: string | undefined;
+    }>;
+    /**
+     * Send Slack webhook and get data without full response metadata
+     *
+     * @fullPath api.slack.webHookData.send
+     * @service slack
+     * @domain communication-and-notifications
+     * @dataMethod webHookData
+     * @discoverable true
+     * @searchTerms ["webhook data", "message data", "delivery status", "notification result"]
+     * @relatedEndpoints ["api.slack.webHook.send", "api.slack.webHook.refresh"]
+     * @commonPatterns ["Send message data", "Get delivery status", "Direct webhook access"]
+     * @workflow ["notification-delivery", "team-communication", "alert-management"]
+     * @prerequisites ["Valid webhook configuration", "Message content", "Valid authentication token"]
+     * @nextSteps ["Monitor delivery status", "Handle webhook responses", "Track message engagement"]
+     * @businessRules ["Returns only webhook data", "No response metadata included", "Direct access to delivery status"]
+     * @functionalArea "communication-and-notifications"
+     * @caching "No caching - real-time delivery tracking"
+     * @performance "Direct data access, optimal for webhook status monitoring"
+     *
+     * @param params Webhook request parameters
+     * @returns Promise<WebHookData> Direct webhook delivery data without response wrapper
+     */
+    webHookData(params: WebHookRequestParams): Promise<WebHookData>;
+    /**
+     * Refresh webhooks and get data without full response metadata
+     *
+     * @fullPath api.slack.webHookRefreshData.get
+     * @service slack
+     * @domain communication-and-notifications
+     * @dataMethod webHookRefreshData
+     * @discoverable true
+     * @searchTerms ["refresh data", "webhook config", "integration status", "channel data"]
+     * @relatedEndpoints ["api.slack.webHookRefresh.get", "api.slack.webHook.send"]
+     * @commonPatterns ["Get refresh data", "Configuration status", "Channel information"]
+     * @workflow ["webhook-management", "integration-maintenance", "configuration-sync"]
+     * @prerequisites ["Valid authentication token", "x-site-id header", "Webhook configurations"]
+     * @nextSteps ["Verify configurations", "Test webhook delivery", "Update channel mappings"]
+     * @businessRules ["Returns only refresh data", "No response metadata included", "Direct access to configuration status"]
+     * @functionalArea "communication-and-notifications"
+     * @caching "Cache for 1 hour after refresh"
+     * @performance "Direct data access, optimal for configuration monitoring"
+     *
+     * @param params Webhook refresh parameters
+     * @returns Promise<WebHookRefreshData> Direct refresh data without response wrapper
+     */
+    webHookRefreshData(params: WebHookRefreshParams): Promise<WebHookRefreshData>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/services/slack/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,oBAAoB,EAEpB,eAAe,EAEf,oBAAoB,EAEpB,sBAAsB,EACtB,WAAW,EACX,kBAAkB,EACnB,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;GASG;AACH,qBAAa,WAAY,SAAQ,iBAAiB;gBACpC,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgGG;IACG,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAYrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuDG;IACG,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAcnF;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,eAAe,CAAC,MAAM,EAAE,iBAAiB;;;;;;;;IAK/C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,WAAW,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAKrE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAIpF"}