@reactionary/source 0.6.1 → 0.6.3

package/{providers/medusa/src/providers/product-associations.provider.ts → packages/medusa/src/capabilities/product-associations.capability.ts}

@@ -1,11 +1,16 @@
 import {
-  ProductAssociationsProvider,
+  ProductAssociationsCapability,
   Reactionary,
   ImageSchema,
   ProductSearchResultItemVariantSchema,
   ProductVariantIdentifierSchema,
   success,
 } from '@reactionary/core';
+import type {
+  ProductAssociationsFactory,
+  ProductAssociationsFactoryOutput,
+  ProductAssociationsFactoryWithOutput,
+} from '@reactionary/core';
 import type {
   ProductVariantIdentifier,
   ProductIdentifier,
@@ -22,20 +27,26 @@ import type {
 import type { MedusaConfiguration } from '../schema/configuration.schema.js';
 import type { MedusaAPI } from '../core/client.js';
 import type { StoreProduct, StoreProductVariant } from '@medusajs/types';
+import type { MedusaProductAssociationsFactory } from '../factories/product-associations/product-associations.factory.js';
 
-export class MedusaProductAssociationsProvider extends ProductAssociationsProvider {
+export class MedusaProductAssociationsCapability<
+  TFactory extends ProductAssociationsFactory = MedusaProductAssociationsFactory,
+> extends ProductAssociationsCapability<ProductAssociationsFactoryOutput<TFactory>> {
   protected config: MedusaConfiguration;
   protected medusa: MedusaAPI;
+  protected factory: ProductAssociationsFactoryWithOutput<TFactory>;
 
   constructor(
     config: MedusaConfiguration,
     cache: Cache,
     context: RequestContext,
-    medusa: MedusaAPI
+    medusa: MedusaAPI,
+    factory: ProductAssociationsFactoryWithOutput<TFactory>,
   ) {
     super(cache, context);
     this.config = config;
     this.medusa = medusa;
+    this.factory = factory;
   }
 
   protected async fetchAssociatedProductsFor(productKey: ProductIdentifier, maxNumberOfAssociations: number, attributeName: string): Promise<ProductSearchResultItem[]> {
@@ -87,7 +98,7 @@ export class MedusaProductAssociationsProvider extends ProductAssociationsProvid
   })
   public override async getAccessories(
     query: ProductAssociationsGetAccessoriesQuery
-  ): Promise<Result<ProductAssociation[]>> {
+  ): Promise<Result<ProductAssociationsFactoryOutput<TFactory>[]>> {
     const associatedProducts = await this.fetchAssociatedProductsFor(query.forProduct, query.numberOfAccessories || 4, 'reactionaryaccessories');
 
     const result: ProductAssociation[] = associatedProducts.map(product => ({
@@ -98,7 +109,7 @@ export class MedusaProductAssociationsProvider extends ProductAssociationsProvid
       product,
     } satisfies ProductAssociation));
 
-    return success(result);
+    return success(result.map((x) => this.factory.parseAssociation(this.context, x)));
   }
 
   @Reactionary({
@@ -109,7 +120,7 @@ export class MedusaProductAssociationsProvider extends ProductAssociationsProvid
   })
   public override async getSpareparts(
     query: ProductAssociationsGetSparepartsQuery
-  ): Promise<Result<ProductAssociation[]>> {
+  ): Promise<Result<ProductAssociationsFactoryOutput<TFactory>[]>> {
     const associatedProducts = await this.fetchAssociatedProductsFor(query.forProduct, query.numberOfSpareparts || 4, 'reactionaryspareparts');
 
     const result: ProductAssociation[] = associatedProducts.map(product => ({
@@ -120,7 +131,7 @@ export class MedusaProductAssociationsProvider extends ProductAssociationsProvid
       product,
     } satisfies ProductAssociation));
 
-    return success(result);
+    return success(result.map((x) => this.factory.parseAssociation(this.context, x)));
   }
 
   @Reactionary({
@@ -131,7 +142,7 @@ export class MedusaProductAssociationsProvider extends ProductAssociationsProvid
   })
   public override async getReplacements(
     query: ProductAssociationsGetReplacementsQuery
-  ): Promise<Result<ProductAssociation[]>> {
+  ): Promise<Result<ProductAssociationsFactoryOutput<TFactory>[]>> {
     const associatedProducts = await this.fetchAssociatedProductsFor(query.forProduct, query.numberOfReplacements || 4, 'reactionaryreplacements');
 
     const result: ProductAssociation[] = associatedProducts.map(product => ({
@@ -142,7 +153,7 @@ export class MedusaProductAssociationsProvider extends ProductAssociationsProvid
       product,
     } satisfies ProductAssociation));
 
-    return success(result);
+    return success(result.map((x) => this.factory.parseAssociation(this.context, x)));
   }
 
   protected parseSingle(_body: StoreProduct): ProductSearchResultItem {

package/{providers/medusa/src/providers/product-recommendations.provider.ts → packages/medusa/src/capabilities/product-recommendations.capability.ts}

@@ -2,7 +2,7 @@ import type { StoreCollection, StoreProduct, StoreProductVariant } from '@medusa
 import {
   error,
   ImageSchema,
-  ProductRecommendationsProvider,
+  ProductRecommendationsCapability,
   ProductSearchResultItemVariantSchema,
   ProductVariantIdentifierSchema,
   success,
@@ -23,7 +23,7 @@ import type { MedusaConfiguration } from '../schema/configuration.schema.js';
 const debug = createDebug('reactionary:medusa:product-recommendations');
 
 /**
- * MedusaProductRecommendationsProvider
+ * MedusaProductRecommendationsCapability
  *
  * Provides product recommendations using Medusa's collection-based product grouping.
  * Only overrides the getCollection method to fetch products from Medusa collections.
@@ -32,7 +32,7 @@ const debug = createDebug('reactionary:medusa:product-recommendations');
  * curated product recommendations. Collections are typically manually managed or
  * created through Medusa's admin panel or API.
  */
-export class MedusaProductRecommendationsProvider extends ProductRecommendationsProvider {
+export class MedusaProductRecommendationsCapability extends ProductRecommendationsCapability {
   protected config: MedusaConfiguration;
   protected medusaApi: MedusaAPI;
 

package/{providers/medusa/src/providers/product-search.provider.ts → packages/medusa/src/capabilities/product-search.capability.ts}

@@ -1,5 +1,5 @@
 import {
-  ProductSearchProvider,
+  ProductSearchCapability,
   ProductSearchQueryByTermSchema,
   type Cache,
   type RequestContext,
@@ -17,6 +17,9 @@ import {
   type ProductSearchResultItemVariant,
   type FacetIdentifier,
   type FacetValueIdentifier,
+  type ProductSearchFactory,
+  type ProductSearchFactoryOutput,
+  type ProductSearchFactoryWithOutput,
   type ProductSearchResultFacet,
   type ProductSearchResultFacetValue,
   Reactionary,
@@ -37,20 +40,26 @@ import type {
   StoreProductListResponse,
   StoreProductVariant,
 } from '@medusajs/types';
+import type { MedusaProductSearchFactory } from '../factories/product-search/product-search.factory.js';
 
 const debug = createDebug('reactionary:medusa:search');
 
-export class MedusaSearchProvider extends ProductSearchProvider {
+export class MedusaProductSearchCapability<
+  TFactory extends ProductSearchFactory = MedusaProductSearchFactory,
+> extends ProductSearchCapability<ProductSearchFactoryOutput<TFactory>> {
   protected config: MedusaConfiguration;
+  protected factory: ProductSearchFactoryWithOutput<TFactory>;
 
   constructor(
     config: MedusaConfiguration,
     cache: Cache,
     context: RequestContext,
-    public medusaApi: MedusaAPI
+    public medusaApi: MedusaAPI,
+    factory: ProductSearchFactoryWithOutput<TFactory>,
   ) {
     super(cache, context);
     this.config = config;
+    this.factory = factory;
   }
 
   protected async resolveCategoryIdByExternalId(
@@ -114,7 +123,7 @@ export class MedusaSearchProvider extends ProductSearchProvider {
   })
   public override async queryByTerm(
     payload: ProductSearchQueryByTerm
-  ): Promise<Result<ProductSearchResult>> {
+  ): Promise<Result<ProductSearchFactoryOutput<TFactory>>> {
     const client = await this.medusaApi.getClient();
 
     let categoryIdToFind: string | null = null;
@@ -141,22 +150,20 @@ export class MedusaSearchProvider extends ProductSearchProvider {
 
     const response = await client.store.product.list(this.queryByTermPayload(payload, categoryIdToFind));
 
-    const result = this.parsePaginatedResult(response) as ProductSearchResult;
+    const result = this.parsePaginatedResult(response, payload);
     if (debug.enabled) {
       debug(
         `Search for term "${payload.search.term}" returned ${response.products.length} products (page ${payload.search.paginationOptions.pageNumber} of ${result.totalPages})`
       );
     }
 
-    // Set result metadata
-    result.identifier = {
-      ...payload.search,
-    };
-
-    return success(result);
+    return success(this.factory.parseSearchResult(this.context, result, payload));
   }
 
-  protected parsePaginatedResult(remote: StoreProductListResponse) {
+  protected parsePaginatedResult(
+    remote: StoreProductListResponse,
+    query: ProductSearchQueryByTerm,
+  ) {
     // Parse facets
     // no facets available from Medusa at the moment
 
@@ -166,13 +173,7 @@ export class MedusaSearchProvider extends ProductSearchProvider {
 
     const result = {
       identifier: {
-        facets: [],
-        filters: [],
-        paginationOptions: {
-          pageNumber: 1,
-          pageSize: 0,
-        },
-        term: '',
+        ...query.search,
       },
       pageNumber: (Math.ceil(remote.offset / remote.limit) || 0) + 1,
       pageSize: remote.limit,
@@ -237,17 +238,4 @@ export class MedusaSearchProvider extends ProductSearchProvider {
     return success(facetValueIdentifier);
   }
 
-  protected override parseFacetValue(
-    facetValueIdentifier: FacetValueIdentifier,
-    label: string,
-    count: number
-  ): ProductSearchResultFacetValue {
-    throw new Error('Method not implemented.');
-  }
-  protected override parseFacet(
-    facetIdentifier: FacetIdentifier,
-    facetValue: unknown
-  ): ProductSearchResultFacet {
-    throw new Error('Method not implemented.');
-  }
 }

package/{providers/medusa/src/providers/product.provider.ts → packages/medusa/src/capabilities/product.capability.ts}

@@ -1,8 +1,28 @@
-import type { Cache, Image, NotFoundError, Product, ProductAttribute, ProductAttributeIdentifier, ProductAttributeValueIdentifier, ProductOptionIdentifier, ProductOptionValueIdentifier, ProductQueryById, ProductQueryBySKU, ProductQueryBySlug, ProductVariant, ProductVariantOption, RequestContext, Result } from '@reactionary/core';
+import type {
+  Cache,
+  Image,
+  NotFoundError,
+  Product,
+  ProductAttribute,
+  ProductAttributeIdentifier,
+  ProductAttributeValueIdentifier,
+  ProductFactory,
+  ProductFactoryOutput,
+  ProductFactoryWithOutput,
+  ProductOptionIdentifier,
+  ProductOptionValueIdentifier,
+  ProductQueryById,
+  ProductQueryBySKU,
+  ProductQueryBySlug,
+  ProductVariant,
+  ProductVariantOption,
+  RequestContext,
+  Result,
+} from '@reactionary/core';
 import {
   CategoryIdentifierSchema,
   ProductIdentifierSchema,
-  ProductProvider,
+  ProductCapability,
   ProductQueryByIdSchema,
   ProductQueryBySKUSchema,
   ProductQueryBySlugSchema,
@@ -16,16 +36,27 @@ import type { MedusaAPI } from '../core/client.js';
 import type { MedusaConfiguration } from '../schema/configuration.schema.js';
 
 import type { StoreProduct, StoreProductImage, StoreProductVariant } from '@medusajs/types';
+import type { MedusaProductFactory } from '../factories/product/product.factory.js';
 
 const debug = createDebug('reactionary:medusa:product');
 
-export class MedusaProductProvider extends ProductProvider {
+export class MedusaProductCapability<
+  TFactory extends ProductFactory = MedusaProductFactory,
+> extends ProductCapability<ProductFactoryOutput<TFactory>> {
   protected config: MedusaConfiguration;
-  protected alwaysIncludedFields = ["+metadata.*","+categories.metadata.*","+external_id"]
-
-  constructor(config: MedusaConfiguration, cache: Cache, context: RequestContext, public medusaApi: MedusaAPI) {
+  protected alwaysIncludedFields = ["+metadata.*","+categories.metadata.*","+external_id"];
+  protected factory: ProductFactoryWithOutput<TFactory>;
+
+  constructor(
+    config: MedusaConfiguration,
+    cache: Cache,
+    context: RequestContext,
+    public medusaApi: MedusaAPI,
+    factory: ProductFactoryWithOutput<TFactory>,
+  ) {
   super(cache, context);
    this.config = config;
+   this.factory = factory;
   }
 
   protected getByIdPayload(payload: ProductQueryById) {
@@ -45,7 +76,9 @@ export class MedusaProductProvider extends ProductProvider {
     currencyDependentCaching: false,
     localeDependentCaching: true
   })
-  public override async getById(payload: ProductQueryById): Promise<Result<Product>> {
+  public override async getById(
+    payload: ProductQueryById,
+  ): Promise<Result<ProductFactoryOutput<TFactory>>> {
     const client = await this.medusaApi.getClient();
     if (debug.enabled) {
       debug(`Fetching product by ID: ${payload.identifier.key}`);
@@ -81,7 +114,9 @@ export class MedusaProductProvider extends ProductProvider {
     currencyDependentCaching: false,
     localeDependentCaching: true
   })
-  public override async getBySlug(payload: ProductQueryBySlug): Promise<Result<Product, NotFoundError>> {
+  public override async getBySlug(
+    payload: ProductQueryBySlug,
+  ): Promise<Result<ProductFactoryOutput<TFactory>, NotFoundError>> {
     const client = await this.medusaApi.getClient();
     if (debug.enabled) {
       debug(`Fetching product by slug: ${payload.slug}`);
@@ -111,7 +146,9 @@ export class MedusaProductProvider extends ProductProvider {
     currencyDependentCaching: false,
     localeDependentCaching: true
   })
-  public override async getBySKU(payload: ProductQueryBySKU): Promise<Result<Product>> {
+  public override async getBySKU(
+    payload: ProductQueryBySKU,
+  ): Promise<Result<ProductFactoryOutput<TFactory>>> {
     if (debug.enabled) {
       debug(`Fetching product by SKU: ${Array.isArray(payload) ? payload.join(', ') : payload}`);
     }
@@ -129,7 +166,7 @@ export class MedusaProductProvider extends ProductProvider {
     return success(this.parseSingle(product));
   }
 
-  protected parseSingle(_body: StoreProduct): Product {
+  protected parseSingle(_body: StoreProduct): ProductFactoryOutput<TFactory> {
     const identifier = ProductIdentifierSchema.parse({ key: _body.external_id || _body.id });
     const name = _body.title;
     const slug = _body.handle;
@@ -171,7 +208,7 @@ export class MedusaProductProvider extends ProductProvider {
       variants: otherVariants,
     } satisfies Product;
 
-    return result;
+    return this.factory.parseProduct(this.context, result);
   }
 
   protected parseVariant(variant: StoreProductVariant, product: StoreProduct) {
@@ -275,4 +312,3 @@ export class MedusaProductProvider extends ProductProvider {
     return sharedAttributes;
   }
 }
-

package/{providers/medusa/src/providers/profile.provider.ts → packages/medusa/src/capabilities/profile.capability.ts}

@@ -13,7 +13,7 @@ import {
   type Cache,
   type Result,
   type NotFoundError,
-  ProfileProvider,
+  ProfileCapability,
   Reactionary,
   ProfileSchema,
   ProfileMutationUpdateSchema,
@@ -24,6 +24,9 @@ import {
   ProfileMutationSetBillingAddressSchema,
   success,
   type Address,
+  type ProfileFactory,
+  type ProfileFactoryOutput,
+  type ProfileFactoryWithOutput,
   ProfileQueryByIdSchema,
   error
 } from '@reactionary/core';
@@ -31,10 +34,11 @@ import type { MedusaConfiguration } from '../schema/configuration.schema.js';
 import type { MedusaAPI } from '../core/client.js';
 import createDebug from 'debug';
 import type { StoreCreateCustomerAddress, StoreCustomer, StoreCustomerAddress } from '@medusajs/types';
+import type { MedusaProfileFactory } from '../factories/profile/profile.factory.js';
 
 const debug = createDebug('reactionary:medusa:profile');
 /**
- * Medusa Profile Provider
+ * Medusa Profile Capability
  *
  * Implements profile management using Medusa's customer APIs.
  *
@@ -43,26 +47,33 @@ const debug = createDebug('reactionary:medusa:profile');
  * - handle guest user scenarios (if applicable).
  * - improve error handling and edge cases.
  */
-export class MedusaProfileProvider extends ProfileProvider {
+export class MedusaProfileCapability<
+  TFactory extends ProfileFactory = MedusaProfileFactory,
+> extends ProfileCapability<ProfileFactoryOutput<TFactory>> {
   protected config: MedusaConfiguration;
   protected includedFields = ['+metadata.*'];
+  protected factory: ProfileFactoryWithOutput<TFactory>;
 
   constructor(
     config: MedusaConfiguration,
     cache: Cache,
     context: RequestContext,
-    public medusaApi: MedusaAPI
+    public medusaApi: MedusaAPI,
+    factory: ProfileFactoryWithOutput<TFactory>,
   ) {
     super(cache, context);
 
     this.config = config;
+    this.factory = factory;
   }
 
   @Reactionary({
     inputSchema: ProfileQueryByIdSchema,
     outputSchema: ProfileSchema,
   })
-  public async getById(payload: ProfileQueryById): Promise<Result<Profile, NotFoundError>> {
+  public async getById(
+    payload: ProfileQueryById,
+  ): Promise<Result<ProfileFactoryOutput<TFactory>, NotFoundError>> {
     debug('getById', payload);
 
     const client = await this.medusaApi.getClient();
@@ -91,7 +102,9 @@ export class MedusaProfileProvider extends ProfileProvider {
     inputSchema: ProfileMutationUpdateSchema,
     outputSchema: ProfileSchema,
   })
-  public async update(payload: ProfileMutationUpdate): Promise<Result<Profile, NotFoundError>> {
+  public async update(
+    payload: ProfileMutationUpdate,
+  ): Promise<Result<ProfileFactoryOutput<TFactory>, NotFoundError>> {
     debug('update', payload);
 
     const client = await this.medusaApi.getClient();
@@ -120,7 +133,9 @@ export class MedusaProfileProvider extends ProfileProvider {
     inputSchema: ProfileMutationAddShippingAddressSchema,
     outputSchema: ProfileSchema,
   })
-  public async addShippingAddress(payload: ProfileMutationAddShippingAddress): Promise<Result<Profile, NotFoundError>> {
+  public async addShippingAddress(
+    payload: ProfileMutationAddShippingAddress,
+  ): Promise<Result<ProfileFactoryOutput<TFactory>, NotFoundError>> {
     debug('addShippingAddress', payload);
 
     const client = await this.medusaApi.getClient();
@@ -162,7 +177,9 @@ export class MedusaProfileProvider extends ProfileProvider {
     inputSchema: ProfileMutationUpdateShippingAddressSchema,
     outputSchema: ProfileSchema,
   })
-  public async updateShippingAddress(payload: ProfileMutationUpdateShippingAddress): Promise<Result<Profile, NotFoundError>> {
+  public async updateShippingAddress(
+    payload: ProfileMutationUpdateShippingAddress,
+  ): Promise<Result<ProfileFactoryOutput<TFactory>, NotFoundError>> {
     debug('updateShippingAddress', payload);
 
     const client = await this.medusaApi.getClient();
@@ -203,7 +220,9 @@ export class MedusaProfileProvider extends ProfileProvider {
     inputSchema: ProfileMutationRemoveShippingAddressSchema,
     outputSchema: ProfileSchema,
   })
-  public async removeShippingAddress(payload: ProfileMutationRemoveShippingAddress): Promise<Result<Profile, NotFoundError>> {
+  public async removeShippingAddress(
+    payload: ProfileMutationRemoveShippingAddress,
+  ): Promise<Result<ProfileFactoryOutput<TFactory>, NotFoundError>> {
     debug('removeShippingAddress', payload);
     const client = await this.medusaApi.getClient();
 
@@ -247,7 +266,9 @@ export class MedusaProfileProvider extends ProfileProvider {
     inputSchema: ProfileMutationMakeShippingAddressDefaultSchema,
     outputSchema: ProfileSchema,
   })
-  public async makeShippingAddressDefault(payload: ProfileMutationMakeShippingAddressDefault): Promise<Result<Profile, NotFoundError>> {
+  public async makeShippingAddressDefault(
+    payload: ProfileMutationMakeShippingAddressDefault,
+  ): Promise<Result<ProfileFactoryOutput<TFactory>, NotFoundError>> {
     debug('makeShippingAddressDefault', payload);
 
     const client = await this.medusaApi.getClient();
@@ -289,7 +310,9 @@ export class MedusaProfileProvider extends ProfileProvider {
     inputSchema: ProfileMutationSetBillingAddressSchema,
     outputSchema: ProfileSchema,
   })
-  public async setBillingAddress(payload: ProfileMutationSetBillingAddress): Promise<Result<Profile, NotFoundError>> {
+  public async setBillingAddress(
+    payload: ProfileMutationSetBillingAddress,
+  ): Promise<Result<ProfileFactoryOutput<TFactory>, NotFoundError>> {
     debug('setBillingAddress', payload);
 
 
@@ -361,7 +384,7 @@ export class MedusaProfileProvider extends ProfileProvider {
     }
   }
 
-  protected parseSingle(customer: StoreCustomer): Profile {
+  protected parseSingle(customer: StoreCustomer): ProfileFactoryOutput<TFactory> {
     const email = customer.email;
     const emailVerified = customer.metadata?.['email_verified'] === 'true';
 
@@ -386,7 +409,7 @@ export class MedusaProfileProvider extends ProfileProvider {
 
     alternateShippingAddresses.push(...addresses.filter(x => ! (x.is_default_billing || x.is_default_shipping)).map( addr => this.parseAddress(addr)));
 
-    return {
+    const result = {
       identifier: {
         userId: customer.id,
       },
@@ -400,6 +423,7 @@ export class MedusaProfileProvider extends ProfileProvider {
       createdAt: new Date(customer.created_at || '').toISOString(),
       updatedAt: new Date(customer.updated_at || '').toISOString()
     } satisfies Profile;
+    return this.factory.parseProfile(this.context, result);
   }