@thorprovider/adapters 3.0.2

package/.turbo/turbo-build.log

@@ -0,0 +1,18 @@
+CLI Building entry: {"index":"src/index.ts"}
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /home/nelson/dev/thorprovider/repos/thorcommerce/packages/adapters/tsup.config.ts
+CLI Target: esnext
+CLI Cleaning output folder
+CJS Build start
+ESM Build start
+ESM dist/index.mjs     270.54 KB
+ESM dist/index.mjs.map 550.94 KB
+ESM ⚡️ Build success in 118ms
+CJS dist/index.js     275.05 KB
+CJS dist/index.js.map 551.29 KB
+CJS ⚡️ Build success in 118ms
+DTS Build start
+DTS ⚡️ Build success in 3591ms
+DTS dist/index.d.ts  88.39 KB
+DTS dist/index.d.mts 88.39 KB

package/.turbo/turbo-test.log

@@ -0,0 +1 @@
+command not found: jest

package/AGENTS.md

@@ -0,0 +1 @@
+<!-- ADAPTERS-AGENTS-MD-START -->[@thorprovider/adapters Docs]|root: ./adapters|CRITICAL: Framework-agnostic business logic only. Never import Next.js or React. Check IMPORT_GUIDE.md for proper usage patterns.|To regenerate: yarn workspace @thorprovider/adapters generate:agent-index|.:{README.md,quick-reference.md}|docs:{RETRY_SOLUTION_SUMMARY.md,authentication.md,capabilities-system.md,category-customization.md,fetch-reliability-solution.md,getting-started.md,multi-tenant-channel-scoping.md,profile-management.md,providers-overview.md,services-overview.md,update-documentation.md}|src/resilience:{README.md}<!-- ADAPTERS-AGENTS-MD-END -->

package/CHANGELOG.md

@@ -0,0 +1,271 @@
+# Changelog
+
+## 3.0.2
+
+### Patch Changes
+
+- Automate package publishing with Changesets PR pattern and changeset-bot
+- Updated dependencies
+  - @thorprovider/types@2.0.2
+
+## 3.0.1
+
+### Patch Changes
+
+- 377a7b4: Fix package publishing to GitHub Packages registry
+- Updated dependencies [377a7b4]
+  - @thorprovider/types@2.0.1
+
+## 3.0.0
+
+### Major Changes
+
+- c6ea482: Primera publicación de packages
+
+### Patch Changes
+
+- d16d400: Initial publish of Thor Commerce packages to GitHub Packages registry.
+- Updated dependencies [d16d400]
+- Updated dependencies [c6ea482]
+  - @thorprovider/types@2.0.0
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Fixed - Completed Cart Detection
+
+- **Cart type**: Added `completedAt?: string` field to Cart interface to track when a cart is converted to an order.
+- **Medusa transform**: Updated `transformCart()` to include `completed_at` timestamp from Medusa backend.
+- **Prevents errors**: Fixes "Cart already completed" errors when users attempt additional purchases after checkout.
+
+### Fixed - Medusa v2 Cart Line Item Pricing
+
+- **Cart line totals**: Fixed cart line item totals defaulting to `0` when Medusa doesn't return expanded totals fields.
+- **Currency consistency**: Cart line items now inherit `currency_code` from the cart, preventing mixed-currency UI rendering.
+- **Fallback behavior**: When line totals are missing, adapters compute line totals as `unit_price × quantity`.
+
+### Fixed - Shipping Options Endpoint (Checkout)
+
+- **Medusa v2 shipping methods**: Switched from the non-existent `/store/fulfillment/cart-options` call to the official `/store/shipping-options?cart_id=...` endpoint.
+- **Compatibility**: Uses `sdk.store.shippingOption.list` when available, with an HTTP fallback for SDK versions that don't expose it.
+
+### Added - Checkout Payment Session & Billing Address Support
+
+**🎯 CRITICAL FIX:** Payment session creation now works correctly with Medusa v2
+
+#### Payment Session Fix
+
+- **Payment Collection Fields**: Added `payment_collection` fields to cart query to prevent HTTP 500 errors
+- **Idempotent Session Creation**: Payment session creation now idempotent (no duplicate sessions)
+- **Proper Error Handling**: Better error messages when payment session fails
+- **Fields Added**: `payment_session.id`, `payment_session.status`, `payment_session.provider_id`, `payment_session.amount`
+
+#### Billing Address Support
+
+- **`updateBillingAddress(cartId, address)`**: New method in `CommerceProvider` interface
+- **Medusa Implementation**: Updates cart billing address via Medusa SDK before payment session creation
+- **Step 0.5**: Called automatically before payment session creation in checkout flow
+- **Required by Medusa**: Billing address MUST be set before creating payment collection
+
+#### CommerceProvider Interface Updates
+
+```typescript
+interface CommerceProvider {
+  // ... existing methods
+
+  // NEW: Update billing address before payment session
+  updateBillingAddress(cartId: string, address: BillingAddress): Promise<void>;
+}
+```
+
+#### Implementation Details
+
+- `MedusaCartProvider.updateCart()`: Now includes payment_collection in query expansion
+- `MedusaCommerceProvider.updateBillingAddress()`: Medusa SDK implementation
+- **Architecture**: L2 (Adapters) - Framework-agnostic business logic
+
+#### Impact
+
+- Fixes HTTP 500 error when creating payment session without billing address
+- Enables proper checkout flow with Medusa v2 backend
+- Required for CheckoutModule payment step to work correctly
+
+---
+
+## [2.0.0] - 2026-02-05
+
+### Added - Backend Capability Detection System
+
+**🎯 NEW:** Backend capability detection system for adaptive UI
+
+#### Capabilities System
+
+- **`BackendCapabilities` Interface**: 21 capability flags for profile, orders, cart, payments, etc.
+- **Provider Capabilities**: Each provider declares its capabilities in `readonly capabilities` property
+- **Type-Safe Checks**: Full TypeScript inference for capability checking
+- **Constant Exports**: `MEDUSA_CAPABILITIES`, `SHOPIFY_CAPABILITIES` for direct import
+
+#### Profile Management Capabilities
+
+- `updateProfile`: Update name/phone (Medusa: ✅, Shopify: ✅)
+- `updateEmail`: Change email address (Medusa: ❌, Shopify: ✅)
+- `changePasswordDirect`: Direct password change (Medusa: ❌, Shopify: ✅)
+- `changePasswordViaEmail`: Password reset via email (Medusa: ✅, Shopify: ✅)
+- `deleteAccount`: Self-service account deletion (Medusa: ❌, Shopify: ❌)
+- `uploadAvatar`: Native avatar upload API (Medusa: ❌, Shopify: ❌)
+- `avatarViaMetadata`: Store avatar URL in metadata (Medusa: ✅, Shopify: ✅)
+- `customAttributes`: Custom customer attributes (Medusa: ✅, Shopify: ✅)
+
+#### Additional Capabilities (21 total)
+
+- **Orders**: `fetchOrders`, `cancelOrder`
+- **Addresses**: `manageAddresses`, `defaultAddress`
+- **Cart**: `applyDiscounts`, `shippingCalculation`
+- **Payment**: `guestCheckout`, `savedPaymentMethods`
+- **Features**: `wishlist`, `advancedSearch`, `facetedFilters`, `productReviews`, `loyaltyProgram`
+
+#### CommerceProvider Extension
+
+```typescript
+interface CommerceProvider {
+  readonly name: string;
+  readonly version: string;
+  readonly capabilities: BackendCapabilities; // NEW!
+  // ... existing methods
+}
+```
+
+#### Utility Functions
+
+- `isBackendCapabilities(obj)`: Type guard
+- `getCapabilityDescription(capability)`: Human-readable descriptions
+
+#### Documentation
+
+- `types/capabilities.types.ts` - Complete capability definitions with JSDoc
+- Backend comparison matrix (Medusa, Shopify)
+- Usage examples for adaptive UI
+
+### Changed
+
+- **`CommerceProvider` interface**: Added `capabilities` property
+- **`MedusaProvider`**: Now includes `MEDUSA_CAPABILITIES`
+- **Exports**: Added capability types and constants to main index
+
+### Use Cases
+
+```typescript
+// Check capabilities at runtime
+if (commerce.capabilities.updateEmail) {
+  return <EmailField />;
+} else {
+  return <EmailField disabled />;
+}
+
+// React hook integration
+const capabilities = useCapabilities();
+```
+
+---
+
+## [2.0.0-beta] - 2026-02-03
+
+### Added - Complete Rewrite
+
+**@thorprovider/adapters v2.0** is a complete rewrite from scratch based on Vercel Commerce patterns.
+
+#### Core Architecture
+
+- **Provider Pattern**: Multi-platform commerce abstraction
+- **Interface-First Design**: `CommerceProvider` interface defines contract
+- **TypeScript Strict**: Full type safety across all operations
+- **Framework Agnostic**: Zero dependencies on React/Next.js
+
+#### Type System
+
+- Unified types for Product, Cart, Collection, Customer, Order
+- Shared types: Money, Image, SEO, Connection, Edge
+- Provider-specific transforms to normalize responses
+
+#### Medusa Provider (v2.11.3)
+
+- Complete `CommerceProvider` implementation with 11 methods:
+  - **Products**: `getProduct()`, `getProducts()`, `getProductRecommendations()`
+  - **Collections**: `getCollection()`, `getCollections()`, `getCollectionProducts()`
+  - **Cart**: `createCart()`, `getCart()`, `addToCart()`, `removeFromCart()`, `updateCart()`
+- Transform functions to convert Medusa types to unified types
+- Support for @medusajs/js-sdk v2.11.3
+
+#### Developer Experience
+
+- Factory pattern: `createProvider({ provider: 'medusa', config: {...} })`
+- Discriminated union types for type-safe configuration
+- Custom error hierarchy: `ProviderAPIError`, `ResourceNotFoundError`, etc.
+- Debug logging with `createLogger()`
+
+#### Documentation
+
+- Complete README with examples and API reference
+- `examples/basic-usage.ts` - Full usage example
+- `RESEARCH_V2.md` - Architecture decisions and research
+
+### Build Output
+
+- ✅ CommonJS (`dist/index.js`)
+- ✅ ESM (`dist/index.mjs`)
+- ✅ TypeScript declarations (`dist/index.d.ts`, `dist/index.d.mts`)
+- ✅ Source maps for debugging
+
+### Breaking Changes from v0.x
+
+This is a **complete rewrite** and is not backwards compatible with v0.x:
+
+- ❌ **Removed**: Context-aware exports (client/server splits)
+- ❌ **Removed**: Direct SDK re-exports
+- ✅ **New**: Unified provider interface
+- ✅ **New**: Multi-platform support architecture
+- ✅ **New**: Transform layer for type normalization
+
+### Migration Guide
+
+**v0.x → v2.0**
+
+```typescript
+// Before (v0.x)
+import { sdk } from '@thorprovider/adapters/client';
+const products = await sdk.store.product.list();
+
+// After (v2.0)
+import { createProvider } from '@thorprovider/adapters';
+const commerce = createProvider({
+  provider: 'medusa',
+  config: { baseUrl, publishableKey },
+});
+const products = await commerce.getProducts();
+```
+
+### Dependencies
+
+- `@medusajs/js-sdk`: ^2.11.3
+- `@medusajs/types`: ^2.11.3
+
+### Known Limitations
+
+- Only Medusa provider implemented (Shopify, WooCommerce coming in future releases)
+- No cache layer yet (planned for v2.1)
+- No customer operations (login, register) - focus on storefront operations
+
+---
+
+## [0.2.0] - Previous Version (Deprecated)
+
+Legacy version with context-aware exports. See git history for details.
+
+---
+
+[2.0.0]: https://github.com/thorprovider/thor-commerce/compare/v0.2.0...v2.0.0
+[0.2.0]: https://github.com/thorprovider/thor-commerce/releases/tag/v0.2.0