@rovela-ai/sdk 0.4.1 → 0.4.2

package/dist/products/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @rovela/sdk/products
+ *
+ * Product catalog module: display, search, sort, variant selection.
+ *
+ * Components:
+ * - ProductCard, ProductGrid, ProductDetails
+ * - VariantSelector, ProductGallery
+ * - ProductSearch, ProductSort
+ *
+ * Hooks:
+ * - useProducts, useProduct
+ *
+ * API Route Handlers:
+ * - getProducts (GET /api/products)
+ * - getProduct (GET /api/products/[slug])
+ * - getCategories (GET /api/categories)
+ *
+ * @example
+ * ```tsx
+ * // In a product listing page
+ * import {
+ *   ProductGrid,
+ *   ProductSearch,
+ *   ProductSort,
+ *   useProducts,
+ * } from '@rovela/sdk/products'
+ *
+ * function ProductsPage() {
+ *   const [search, setSearch] = useState('')
+ *   const [sort, setSort] = useState('newest')
+ *
+ *   const { products, isLoading, hasMore, loadMore } = useProducts({
+ *     search,
+ *     sort,
+ *   })
+ *
+ *   return (
+ *     <main>
+ *       <div className="flex gap-4 mb-6">
+ *         <ProductSearch value={search} onSearch={setSearch} placeholder="Search products..." />
+ *         <ProductSort value={sort} onChange={setSort} />
+ *       </div>
+ *       <ProductGrid products={products} isLoading={isLoading} cardProps={{ showQuickAdd: true }} />
+ *       {hasMore && <button onClick={loadMore}>Load More</button>}
+ *     </main>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // In app/api/products/route.ts
+ * export { getProducts as GET } from '@rovela/sdk/products/api'
+ *
+ * // In app/api/products/[slug]/route.ts
+ * export { getProduct as GET } from '@rovela/sdk/products/api'
+ *
+ * // In app/api/categories/route.ts
+ * export { getCategories as GET } from '@rovela/sdk/products/api'
+ * ```
+ */
+export { ProductCard, ProductGrid, ProductDetails, VariantSelector, ProductGallery, ProductSearch, ProductSort, } from './components';
+export type { ProductCardProps, ProductGridProps, ProductDetailsProps, VariantSelectorProps, ProductGalleryProps, ProductSearchProps, ProductSortProps, SortOption, SortOptionConfig, } from './components';
+export { useProducts, useProduct, } from './hooks';
+export type { UseProductsOptions, UseProductsReturn, UseProductOptions, UseProductReturn, } from './hooks';
+export { getProducts, getProduct, getCategories, } from './api';
+export type { ProductsApiResponse, ProductsApiError, ProductApiResponse, ProductApiError, CategoriesApiResponse, CategoriesApiError, } from './api';
+//# sourceMappingURL=index.d.ts.map

package/dist/products/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/products/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAMH,OAAO,EAEL,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,EACf,cAAc,EAEd,aAAa,EACb,WAAW,GACZ,MAAM,cAAc,CAAA;AAErB,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,GACjB,MAAM,cAAc,CAAA;AAMrB,OAAO,EACL,WAAW,EACX,UAAU,GACX,MAAM,SAAS,CAAA;AAEhB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,SAAS,CAAA;AAMhB,OAAO,EACL,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,OAAO,CAAA;AAEd,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,OAAO,CAAA"}

package/dist/products/index.js

@@ -0,0 +1,79 @@
+/**
+ * @rovela/sdk/products
+ *
+ * Product catalog module: display, search, sort, variant selection.
+ *
+ * Components:
+ * - ProductCard, ProductGrid, ProductDetails
+ * - VariantSelector, ProductGallery
+ * - ProductSearch, ProductSort
+ *
+ * Hooks:
+ * - useProducts, useProduct
+ *
+ * API Route Handlers:
+ * - getProducts (GET /api/products)
+ * - getProduct (GET /api/products/[slug])
+ * - getCategories (GET /api/categories)
+ *
+ * @example
+ * ```tsx
+ * // In a product listing page
+ * import {
+ *   ProductGrid,
+ *   ProductSearch,
+ *   ProductSort,
+ *   useProducts,
+ * } from '@rovela/sdk/products'
+ *
+ * function ProductsPage() {
+ *   const [search, setSearch] = useState('')
+ *   const [sort, setSort] = useState('newest')
+ *
+ *   const { products, isLoading, hasMore, loadMore } = useProducts({
+ *     search,
+ *     sort,
+ *   })
+ *
+ *   return (
+ *     <main>
+ *       <div className="flex gap-4 mb-6">
+ *         <ProductSearch value={search} onSearch={setSearch} placeholder="Search products..." />
+ *         <ProductSort value={sort} onChange={setSort} />
+ *       </div>
+ *       <ProductGrid products={products} isLoading={isLoading} cardProps={{ showQuickAdd: true }} />
+ *       {hasMore && <button onClick={loadMore}>Load More</button>}
+ *     </main>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // In app/api/products/route.ts
+ * export { getProducts as GET } from '@rovela/sdk/products/api'
+ *
+ * // In app/api/products/[slug]/route.ts
+ * export { getProduct as GET } from '@rovela/sdk/products/api'
+ *
+ * // In app/api/categories/route.ts
+ * export { getCategories as GET } from '@rovela/sdk/products/api'
+ * ```
+ */
+// =============================================================================
+// Components
+// =============================================================================
+export { 
+// Core display
+ProductCard, ProductGrid, ProductDetails, VariantSelector, ProductGallery, 
+// Search + sort
+ProductSearch, ProductSort, } from './components';
+// =============================================================================
+// Hooks
+// =============================================================================
+export { useProducts, useProduct, } from './hooks';
+// =============================================================================
+// API Route Handlers
+// =============================================================================
+export { getProducts, getProduct, getCategories, } from './api';
+//# sourceMappingURL=index.js.map

package/dist/products/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/products/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAEH,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,OAAO;AACL,eAAe;AACf,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,EACf,cAAc;AACd,gBAAgB;AAChB,aAAa,EACb,WAAW,GACZ,MAAM,cAAc,CAAA;AAcrB,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,OAAO,EACL,WAAW,EACX,UAAU,GACX,MAAM,SAAS,CAAA;AAShB,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,OAAO,EACL,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,OAAO,CAAA"}

package/dist/shipping/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @rovela/sdk/shipping
+ *
+ * Shipping module for carrier integrations.
+ * Currently supports Shippo for real-time carrier rates and label purchases.
+ */
+export { validateShippoKey, getShippoRates, purchaseShippoLabel, shippoRatesToStripeOptions, } from './shippo';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shipping/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,UAAU,CAAA"}

package/dist/shipping/index.js

@@ -0,0 +1,8 @@
+/**
+ * @rovela/sdk/shipping
+ *
+ * Shipping module for carrier integrations.
+ * Currently supports Shippo for real-time carrier rates and label purchases.
+ */
+export { validateShippoKey, getShippoRates, purchaseShippoLabel, shippoRatesToStripeOptions, } from './shippo';
+//# sourceMappingURL=index.js.map

package/dist/shipping/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shipping/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,UAAU,CAAA"}

package/dist/shipping/shippo.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @rovela/sdk/shipping/shippo
+ *
+ * Shippo API client for carrier shipping rates and label purchases.
+ * Uses direct fetch calls - no SDK dependency.
+ *
+ * API Documentation: https://docs.goshippo.com/docs/shipments/shipments/
+ */
+import type { ShippoAddress, ShippoParcel, ShippoRate, ShippoLabelResult, ShippoValidationResult } from '../admin/types';
+/**
+ * Validate a Shippo API key by making a test API call.
+ * Returns validation result without throwing.
+ */
+export declare function validateShippoKey(apiKey: string): Promise<ShippoValidationResult>;
+/**
+ * Get shipping rates from Shippo for a given shipment.
+ * Creates a shipment object and returns available rates from all carriers.
+ */
+export declare function getShippoRates(params: {
+    fromAddress: ShippoAddress;
+    toAddress: ShippoAddress;
+    parcel: ShippoParcel;
+}): Promise<ShippoRate[]>;
+/**
+ * Purchase a shipping label from Shippo using a selected rate.
+ * Returns tracking info and label URL.
+ */
+export declare function purchaseShippoLabel(params: {
+    rateId: string;
+    labelFormat?: 'PDF' | 'PDF_4x6' | 'PNG' | 'ZPLII';
+}): Promise<ShippoLabelResult>;
+/**
+ * Convert Shippo rates to Stripe shipping options format.
+ * Used in checkout flow when Shippo mode is enabled.
+ */
+export declare function shippoRatesToStripeOptions(rates: ShippoRate[], currency: string): Array<{
+    shipping_rate_data: {
+        type: 'fixed_amount';
+        fixed_amount: {
+            amount: number;
+            currency: string;
+        };
+        display_name: string;
+        delivery_estimate?: {
+            minimum: {
+                unit: 'business_day';
+                value: number;
+            };
+            maximum: {
+                unit: 'business_day';
+                value: number;
+            };
+        };
+        metadata: {
+            shippoRateId: string;
+            carrier: string;
+        };
+    };
+}>;
+import type { ShippingAddress } from '../checkout/types';
+import type { ShippingOption, ShippingOptionsGroupedByCarrier } from '../checkout/types';
+/**
+ * Convert ShippingAddress (from checkout types) to ShippoAddress format.
+ * Maps field names between our Address format and Shippo's expected format.
+ */
+export declare function shippingAddressToShippo(address: ShippingAddress): ShippoAddress;
+/**
+ * Convert Shippo rates to unified ShippingOption format.
+ * Used by the pre-checkout shipping API to return consistent options.
+ */
+export declare function shippoRatesToShippingOptions(rates: ShippoRate[]): ShippingOption[];
+/**
+ * Group Shippo rates by carrier for consistent display.
+ * Returns the same structure as manual shipping options.
+ */
+export declare function groupShippoRatesByCarrier(rates: ShippoRate[]): ShippingOptionsGroupedByCarrier[];
+//# sourceMappingURL=shippo.d.ts.map

package/dist/shipping/shippo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shippo.d.ts","sourceRoot":"","sources":["../../src/shipping/shippo.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,gBAAgB,CAAA;AAiEvB;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAyBvF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,WAAW,EAAE,aAAa,CAAA;IAC1B,SAAS,EAAE,aAAa,CAAA;IACxB,MAAM,EAAE,YAAY,CAAA;CACrB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAgExB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAA;CAClD,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0C7B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,UAAU,EAAE,EACnB,QAAQ,EAAE,MAAM,GACf,KAAK,CAAC;IACP,kBAAkB,EAAE;QAClB,IAAI,EAAE,cAAc,CAAA;QACpB,YAAY,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAA;QAClD,YAAY,EAAE,MAAM,CAAA;QACpB,iBAAiB,CAAC,EAAE;YAClB,OAAO,EAAE;gBAAE,IAAI,EAAE,cAAc,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAA;aAAE,CAAA;YAChD,OAAO,EAAE;gBAAE,IAAI,EAAE,cAAc,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAA;aAAE,CAAA;SACjD,CAAA;QACD,QAAQ,EAAE;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KACpD,CAAA;CACF,CAAC,CAqBD;AAMD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAA;AAExF;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAY/E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CAalF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,UAAU,EAAE,GAClB,+BAA+B,EAAE,CAuCnC"}

package/dist/shipping/shippo.js

@@ -0,0 +1,280 @@
+/**
+ * @rovela/sdk/shipping/shippo
+ *
+ * Shippo API client for carrier shipping rates and label purchases.
+ * Uses direct fetch calls - no SDK dependency.
+ *
+ * API Documentation: https://docs.goshippo.com/docs/shipments/shipments/
+ */
+import { findSettings } from '../core/db/queries';
+const SHIPPO_API_URL = 'https://api.goshippo.com';
+/**
+ * Get Shippo API key - checks database first, then falls back to environment variable.
+ * This allows store admins to configure their own Shippo account via the UI.
+ */
+async function getShippoApiKey() {
+    // 1. Check database for store-specific API key
+    try {
+        const settings = await findSettings();
+        if (settings?.shippoApiKey) {
+            return settings.shippoApiKey;
+        }
+    }
+    catch {
+        // Database not available, fall through to env var
+    }
+    // 2. Fallback to environment variable (platform default)
+    const envKey = process.env.SHIPPO_API_KEY;
+    if (envKey) {
+        return envKey;
+    }
+    throw new Error('Shippo API key not configured. Add it in Settings > Shipping.');
+}
+/**
+ * Make authenticated request to Shippo API.
+ */
+async function shippoFetch(endpoint, options = {}) {
+    const apiKey = await getShippoApiKey();
+    const response = await fetch(`${SHIPPO_API_URL}${endpoint}`, {
+        ...options,
+        headers: {
+            'Authorization': `ShippoToken ${apiKey}`,
+            'Content-Type': 'application/json',
+            ...options.headers,
+        },
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`Shippo API error (${response.status}): ${error}`);
+    }
+    // Safely parse JSON response
+    const text = await response.text();
+    if (!text) {
+        throw new Error('Shippo API returned empty response');
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new Error(`Shippo API returned invalid JSON: ${text.slice(0, 200)}`);
+    }
+}
+/**
+ * Validate a Shippo API key by making a test API call.
+ * Returns validation result without throwing.
+ */
+export async function validateShippoKey(apiKey) {
+    try {
+        const response = await fetch(`${SHIPPO_API_URL}/addresses`, {
+            method: 'GET',
+            headers: {
+                'Authorization': `ShippoToken ${apiKey}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (response.ok) {
+            return { valid: true };
+        }
+        if (response.status === 401) {
+            return { valid: false, error: 'Invalid API key' };
+        }
+        return { valid: false, error: `API error: ${response.status}` };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            error: error instanceof Error ? error.message : 'Network error',
+        };
+    }
+}
+/**
+ * Get shipping rates from Shippo for a given shipment.
+ * Creates a shipment object and returns available rates from all carriers.
+ */
+export async function getShippoRates(params) {
+    const { fromAddress, toAddress, parcel } = params;
+    // Create shipment - Shippo auto-returns rates
+    const shipment = await shippoFetch('/shipments', {
+        method: 'POST',
+        body: JSON.stringify({
+            address_from: {
+                name: fromAddress.name,
+                company: fromAddress.company || '',
+                street1: fromAddress.street1,
+                street2: fromAddress.street2 || '',
+                city: fromAddress.city,
+                state: fromAddress.state,
+                zip: fromAddress.zip,
+                country: fromAddress.country,
+                phone: fromAddress.phone || '',
+                email: fromAddress.email || '',
+            },
+            address_to: {
+                name: toAddress.name,
+                company: toAddress.company || '',
+                street1: toAddress.street1,
+                street2: toAddress.street2 || '',
+                city: toAddress.city,
+                state: toAddress.state,
+                zip: toAddress.zip,
+                country: toAddress.country,
+                phone: toAddress.phone || '',
+                email: toAddress.email || '',
+            },
+            parcels: [
+                {
+                    length: String(parcel.length),
+                    width: String(parcel.width),
+                    height: String(parcel.height),
+                    weight: String(parcel.weight),
+                    distance_unit: 'in',
+                    mass_unit: 'oz',
+                },
+            ],
+            async: false, // Get rates immediately
+        }),
+    });
+    // Transform rates to our format
+    return shipment.rates.map((rate) => ({
+        objectId: rate.object_id,
+        provider: rate.provider,
+        servicelevel: rate.servicelevel,
+        amount: rate.amount,
+        currency: rate.currency,
+        estimatedDays: rate.estimated_days,
+    }));
+}
+/**
+ * Purchase a shipping label from Shippo using a selected rate.
+ * Returns tracking info and label URL.
+ */
+export async function purchaseShippoLabel(params) {
+    const { rateId, labelFormat = 'PDF_4x6' } = params;
+    // Create transaction (purchase label)
+    const transaction = await shippoFetch('/transactions', {
+        method: 'POST',
+        body: JSON.stringify({
+            rate: rateId,
+            label_file_type: labelFormat,
+            async: false, // Get label immediately
+        }),
+    });
+    if (transaction.status !== 'SUCCESS') {
+        // Log full response for debugging in production logs
+        console.error('[Shippo] Transaction failed:', JSON.stringify(transaction, null, 2));
+        // Extract actual error message from Shippo's messages array
+        const errorDetails = transaction.messages?.length
+            ? transaction.messages.map(m => m.text).join('; ')
+            : `Status: ${transaction.status}`;
+        throw new Error(`Label purchase failed: ${errorDetails}`);
+    }
+    return {
+        trackingNumber: transaction.tracking_number || '',
+        trackingUrl: transaction.tracking_url_provider || '',
+        labelUrl: transaction.label_url || '',
+        carrier: transaction.rate?.provider || 'unknown',
+    };
+}
+/**
+ * Convert Shippo rates to Stripe shipping options format.
+ * Used in checkout flow when Shippo mode is enabled.
+ */
+export function shippoRatesToStripeOptions(rates, currency) {
+    return rates.map((rate) => ({
+        shipping_rate_data: {
+            type: 'fixed_amount',
+            fixed_amount: {
+                amount: Math.round(parseFloat(rate.amount) * 100), // Convert to cents
+                currency: currency.toLowerCase(),
+            },
+            display_name: `${rate.provider.toUpperCase()} - ${rate.servicelevel.name}`,
+            delivery_estimate: rate.estimatedDays
+                ? {
+                    minimum: { unit: 'business_day', value: rate.estimatedDays },
+                    maximum: { unit: 'business_day', value: rate.estimatedDays + 2 },
+                }
+                : undefined,
+            metadata: {
+                shippoRateId: rate.objectId,
+                carrier: rate.provider,
+            },
+        },
+    }));
+}
+/**
+ * Convert ShippingAddress (from checkout types) to ShippoAddress format.
+ * Maps field names between our Address format and Shippo's expected format.
+ */
+export function shippingAddressToShippo(address) {
+    return {
+        name: `${address.firstName} ${address.lastName}`.trim(),
+        street1: address.line1,
+        street2: address.line2 || '',
+        city: address.city,
+        state: address.state,
+        zip: address.postalCode,
+        country: address.country,
+        phone: address.phone || '',
+        email: address.email || '',
+    };
+}
+/**
+ * Convert Shippo rates to unified ShippingOption format.
+ * Used by the pre-checkout shipping API to return consistent options.
+ */
+export function shippoRatesToShippingOptions(rates) {
+    return rates.map((rate) => ({
+        id: rate.objectId,
+        carrierName: rate.provider,
+        carrierCode: rate.provider.toLowerCase(),
+        name: rate.servicelevel.name,
+        description: rate.estimatedDays
+            ? `${rate.estimatedDays} business days`
+            : undefined,
+        price: Math.round(parseFloat(rate.amount) * 100), // Convert to cents
+        estimatedDays: rate.estimatedDays?.toString(),
+        source: 'shippo',
+    }));
+}
+/**
+ * Group Shippo rates by carrier for consistent display.
+ * Returns the same structure as manual shipping options.
+ */
+export function groupShippoRatesByCarrier(rates) {
+    const carrierMap = new Map();
+    for (const rate of rates) {
+        const carrierCode = rate.provider.toLowerCase();
+        if (!carrierMap.has(carrierCode)) {
+            carrierMap.set(carrierCode, []);
+        }
+        carrierMap.get(carrierCode).push({
+            id: rate.objectId,
+            carrierName: rate.provider,
+            carrierCode: carrierCode,
+            name: rate.servicelevel.name,
+            description: rate.estimatedDays
+                ? `${rate.estimatedDays} business days`
+                : undefined,
+            price: Math.round(parseFloat(rate.amount) * 100),
+            estimatedDays: rate.estimatedDays?.toString(),
+            source: 'shippo',
+        });
+    }
+    const grouped = [];
+    for (const [carrierCode, options] of carrierMap) {
+        // Sort options by price within each carrier
+        options.sort((a, b) => a.price - b.price);
+        grouped.push({
+            carrier: {
+                id: carrierCode,
+                name: options[0]?.carrierName || carrierCode.toUpperCase(),
+                code: carrierCode,
+            },
+            options,
+        });
+    }
+    // Sort carriers alphabetically
+    grouped.sort((a, b) => a.carrier.name.localeCompare(b.carrier.name));
+    return grouped;
+}
+//# sourceMappingURL=shippo.js.map

package/dist/shipping/shippo.js.map

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