@reactionary/source 0.3.18 → 0.6.2

package/providers/medusa/src/core/initialize.ts

@@ -1,87 +1,330 @@
 import type {
   Cache,
-  ClientFromCapabilities,
-  RequestContext
-} from "@reactionary/core";
-import { MedusaCartProvider } from "../providers/cart.provider.js";
-import { MedusaCategoryProvider } from "../providers/category.provider.js";
-import { MedusaCheckoutProvider } from "../providers/checkout.provider.js";
-import { MedusaIdentityProvider } from "../providers/identity.provider.js";
-import { MedusaInventoryProvider } from "../providers/inventory.provider.js";
-import { MedusaOrderSearchProvider } from "../providers/order-search.provider.js";
-import { MedusaOrderProvider } from "../providers/order.provider.js";
-import { MedusaPriceProvider } from "../providers/price.provider.js";
-import { MedusaSearchProvider } from "../providers/product-search.provider.js";
-import { MedusaProductRecommendationsProvider } from "../providers/product-recommendations.provider.js";
-import { MedusaProductProvider } from "../providers/product.provider.js";
-import { MedusaProductAssociationsProvider } from "../providers/product-associations.provider.js";
-import { MedusaProfileProvider } from "../providers/profile.provider.js";
-import { MedusaCapabilitiesSchema, type MedusaCapabilities } from "../schema/capabilities.schema.js";
-import { MedusaConfigurationSchema, type MedusaConfiguration } from "../schema/configuration.schema.js";
-import { MedusaAPI } from "./client.js";
+  RequestContext,
+} from '@reactionary/core';
+import {
+  CartIdentifierSchema,
+  CartSchema,
+  CategoryPaginatedResultSchema,
+  CategorySchema,
+  CheckoutSchema,
+  InventorySchema,
+  OrderSchema,
+  OrderSearchResultSchema,
+  PaymentMethodSchema,
+  PriceSchema,
+  ProductAssociationSchema,
+  ProductSchema,
+  ProductSearchResultSchema,
+  ProfileSchema,
+  ShippingMethodSchema,
+} from '@reactionary/core';
+import { MedusaCartProvider } from '../providers/cart.provider.js';
+import { MedusaCategoryProvider } from '../providers/category.provider.js';
+import { MedusaCheckoutProvider } from '../providers/checkout.provider.js';
+import { MedusaIdentityProvider } from '../providers/identity.provider.js';
+import { MedusaInventoryProvider } from '../providers/inventory.provider.js';
+import { MedusaOrderSearchProvider } from '../providers/order-search.provider.js';
+import { MedusaOrderProvider } from '../providers/order.provider.js';
+import { MedusaPriceProvider } from '../providers/price.provider.js';
+import { MedusaSearchProvider } from '../providers/product-search.provider.js';
+import { MedusaProductRecommendationsProvider } from '../providers/product-recommendations.provider.js';
+import { MedusaProductProvider } from '../providers/product.provider.js';
+import { MedusaProductAssociationsProvider } from '../providers/product-associations.provider.js';
+import { MedusaProfileProvider } from '../providers/profile.provider.js';
+import {
+  MedusaCapabilitiesSchema,
+  type MedusaCapabilities,
+} from '../schema/capabilities.schema.js';
+import {
+  MedusaConfigurationSchema,
+  type MedusaConfiguration,
+} from '../schema/configuration.schema.js';
+import { MedusaAPI } from './client.js';
+import {
+  MedusaCartFactory,
+  MedusaCategoryFactory,
+  MedusaCheckoutFactory,
+  MedusaInventoryFactory,
+  MedusaOrderFactory,
+  MedusaOrderSearchFactory,
+  MedusaPriceFactory,
+  MedusaProductAssociationsFactory,
+  MedusaProductFactory,
+  MedusaProductSearchFactory,
+  MedusaProfileFactory,
+} from '../factories/index.js';
+import {
+  type MedusaClientFromCapabilities,
+  resolveCapabilityProvider,
+  resolveProviderOnlyCapability,
+} from './initialize.types.js';
 
 export function withMedusaCapabilities<T extends MedusaCapabilities>(
-    configuration: MedusaConfiguration,
-    capabilities: T
+  configuration: MedusaConfiguration,
+  capabilities: T,
 ) {
-    return (cache: Cache, context: RequestContext): ClientFromCapabilities<T> => {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const client: any = {};
-        const config = MedusaConfigurationSchema.parse(configuration);
-        const caps = MedusaCapabilitiesSchema.parse(capabilities);
-
-        const medusaApi = new MedusaAPI(config, context);
-
-
-        if (caps.productSearch) {
-            client.productSearch = new MedusaSearchProvider(configuration, cache, context, medusaApi);
-        }
-
-        if (caps.productRecommendations) {
-            client.productRecommendations = new MedusaProductRecommendationsProvider(configuration, cache, context, medusaApi);
-        }
-
-        if (caps.category) {
-            client.category = new MedusaCategoryProvider(configuration, cache, context, medusaApi);
-        }
-
-        if (caps.checkout) {
-            client.checkout = new MedusaCheckoutProvider(configuration, cache, context, medusaApi);
-        }
-
-        if (caps.product) {
-            client.product = new MedusaProductProvider(configuration, cache, context, medusaApi);
-        }
-
-        if (caps.cart) {
-            client.cart = new MedusaCartProvider(configuration, cache, context, medusaApi);
-        }
-
-        if (caps.price) {
-            client.price = new MedusaPriceProvider(configuration, cache, context, medusaApi);
-        }
-
-        if (caps.inventory) {
-            client.inventory = new MedusaInventoryProvider(configuration, cache, context, medusaApi);
-        }
-
-        if (caps.identity) {
-            client.identity = new MedusaIdentityProvider(configuration, cache, context, medusaApi);
-        }
-        if (caps.profile) {
-            client.profile = new MedusaProfileProvider(configuration, cache, context, medusaApi);
-        }
-
-        if (caps.order) {
-            client.order = new MedusaOrderProvider(configuration, cache, context, medusaApi);
-        }
-
-        if(caps.orderSearch) {
-            client.orderSearch = new MedusaOrderSearchProvider(configuration, cache, context, medusaApi);
-        }
-        if (caps.productAssociations) {
-            client.productAssociations = new MedusaProductAssociationsProvider(configuration, cache, context, medusaApi);
-        }
-        return client;
-    };
+  return (
+    cache: Cache,
+    context: RequestContext,
+  ): MedusaClientFromCapabilities<T> => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const client: any = {};
+    const config = MedusaConfigurationSchema.parse(configuration);
+    const caps = MedusaCapabilitiesSchema.parse(capabilities);
+    const medusaApi = new MedusaAPI(config, context);
+
+    const buildProviderArgs = <TFactory,>(factory: TFactory) => ({
+      cache,
+      context,
+      config,
+      medusaApi,
+      factory,
+    });
+
+    if (caps.product?.enabled) {
+      client.product = resolveCapabilityProvider(
+        capabilities.product,
+        {
+          factory: new MedusaProductFactory(ProductSchema),
+          provider: (args) =>
+            new MedusaProductProvider(
+              args.config,
+              args.cache,
+              args.context,
+              args.medusaApi,
+              args.factory,
+            ),
+        },
+        buildProviderArgs,
+      );
+    }
+
+    if (caps.productSearch?.enabled) {
+      client.productSearch = resolveCapabilityProvider(
+        capabilities.productSearch,
+        {
+          factory: new MedusaProductSearchFactory(ProductSearchResultSchema),
+          provider: (args) =>
+            new MedusaSearchProvider(
+              args.config,
+              args.cache,
+              args.context,
+              args.medusaApi,
+              args.factory,
+            ),
+        },
+        buildProviderArgs,
+      );
+    }
+
+    if (caps.category?.enabled) {
+      client.category = resolveCapabilityProvider(
+        capabilities.category,
+        {
+          factory: new MedusaCategoryFactory(
+            CategorySchema,
+            CategoryPaginatedResultSchema,
+          ),
+          provider: (args) =>
+            new MedusaCategoryProvider(
+              args.config,
+              args.cache,
+              args.context,
+              args.medusaApi,
+              args.factory,
+            ),
+        },
+        buildProviderArgs,
+      );
+    }
+
+    if (caps.checkout?.enabled) {
+      client.checkout = resolveCapabilityProvider(
+        capabilities.checkout,
+        {
+          factory: new MedusaCheckoutFactory(
+            CheckoutSchema,
+            ShippingMethodSchema,
+            PaymentMethodSchema,
+          ),
+          provider: (args) =>
+            new MedusaCheckoutProvider(
+              args.config,
+              args.cache,
+              args.context,
+              args.medusaApi,
+              args.factory,
+            ),
+        },
+        buildProviderArgs,
+      );
+    }
+
+    if (caps.productRecommendations?.enabled) {
+      client.productRecommendations = resolveProviderOnlyCapability(
+        capabilities.productRecommendations,
+        (args) =>
+          new MedusaProductRecommendationsProvider(
+            args.config,
+            args.cache,
+            args.context,
+            args.medusaApi,
+          ),
+        {
+          cache,
+          context,
+          config,
+          medusaApi,
+        },
+      );
+    }
+
+    if (caps.cart?.enabled) {
+      client.cart = resolveCapabilityProvider(
+        capabilities.cart,
+        {
+          factory: new MedusaCartFactory(CartSchema, CartIdentifierSchema),
+          provider: (args) =>
+            new MedusaCartProvider(
+              args.config,
+              args.cache,
+              args.context,
+              args.medusaApi,
+              args.factory,
+            ),
+        },
+        buildProviderArgs,
+      );
+    }
+
+    if (caps.price?.enabled) {
+      client.price = resolveCapabilityProvider(
+        capabilities.price,
+        {
+          factory: new MedusaPriceFactory(PriceSchema),
+          provider: (args) =>
+            new MedusaPriceProvider(
+              args.config,
+              args.cache,
+              args.context,
+              args.medusaApi,
+              args.factory,
+            ),
+        },
+        buildProviderArgs,
+      );
+    }
+
+    if (caps.inventory?.enabled) {
+      client.inventory = resolveCapabilityProvider(
+        capabilities.inventory,
+        {
+          factory: new MedusaInventoryFactory(InventorySchema),
+          provider: (args) =>
+            new MedusaInventoryProvider(
+              args.config,
+              args.cache,
+              args.context,
+              args.medusaApi,
+              args.factory,
+            ),
+        },
+        buildProviderArgs,
+      );
+    }
+
+    if (caps.identity?.enabled) {
+      client.identity = resolveProviderOnlyCapability(
+        capabilities.identity,
+        (args) =>
+          new MedusaIdentityProvider(
+            args.config,
+            args.cache,
+            args.context,
+            args.medusaApi,
+          ),
+        {
+          cache,
+          context,
+          config,
+          medusaApi,
+        },
+      );
+    }
+
+    if (caps.profile?.enabled) {
+      client.profile = resolveCapabilityProvider(
+        capabilities.profile,
+        {
+          factory: new MedusaProfileFactory(ProfileSchema),
+          provider: (args) =>
+            new MedusaProfileProvider(
+              args.config,
+              args.cache,
+              args.context,
+              args.medusaApi,
+              args.factory,
+            ),
+        },
+        buildProviderArgs,
+      );
+    }
+
+    if (caps.order?.enabled) {
+      client.order = resolveCapabilityProvider(
+        capabilities.order,
+        {
+          factory: new MedusaOrderFactory(OrderSchema),
+          provider: (args) =>
+            new MedusaOrderProvider(
+              args.config,
+              args.cache,
+              args.context,
+              args.medusaApi,
+              args.factory,
+            ),
+        },
+        buildProviderArgs,
+      );
+    }
+
+    if (caps.orderSearch?.enabled) {
+      client.orderSearch = resolveCapabilityProvider(
+        capabilities.orderSearch,
+        {
+          factory: new MedusaOrderSearchFactory(OrderSearchResultSchema),
+          provider: (args) =>
+            new MedusaOrderSearchProvider(
+              args.config,
+              args.cache,
+              args.context,
+              args.medusaApi,
+              args.factory,
+            ),
+        },
+        buildProviderArgs,
+      );
+    }
+
+    if (caps.productAssociations?.enabled) {
+      client.productAssociations = resolveCapabilityProvider(
+        capabilities.productAssociations,
+        {
+          factory: new MedusaProductAssociationsFactory(ProductAssociationSchema),
+          provider: (args) =>
+            new MedusaProductAssociationsProvider(
+              args.config,
+              args.cache,
+              args.context,
+              args.medusaApi,
+              args.factory,
+            ),
+        },
+        buildProviderArgs,
+      );
+    }
+
+    return client;
+  };
 }

package/providers/medusa/src/core/initialize.types.ts

@@ -0,0 +1,184 @@
+import type {
+  CartFactory,
+  CategoryFactory,
+  CheckoutFactory,
+  ClientFromCapabilities,
+  InventoryFactory,
+  OrderFactory,
+  OrderSearchFactory,
+  PriceFactory,
+  ProductAssociationsFactory,
+  ProductFactory,
+  ProductRecommendationsProvider,
+  ProductSearchFactory,
+  ProfileFactory,
+} from '@reactionary/core';
+import type { MedusaCapabilities } from '../schema/capabilities.schema.js';
+import type { MedusaCartFactory } from '../factories/cart/cart.factory.js';
+import type { MedusaCategoryFactory } from '../factories/category/category.factory.js';
+import type { MedusaCheckoutFactory } from '../factories/checkout/checkout.factory.js';
+import type { MedusaInventoryFactory } from '../factories/inventory/inventory.factory.js';
+import type { MedusaOrderFactory } from '../factories/order/order.factory.js';
+import type { MedusaOrderSearchFactory } from '../factories/order-search/order-search.factory.js';
+import type { MedusaPriceFactory } from '../factories/price/price.factory.js';
+import type { MedusaProductAssociationsFactory } from '../factories/product-associations/product-associations.factory.js';
+import type { MedusaProductFactory } from '../factories/product/product.factory.js';
+import type { MedusaProductSearchFactory } from '../factories/product-search/product-search.factory.js';
+import type { MedusaProfileFactory } from '../factories/profile/profile.factory.js';
+import type { MedusaCartProvider } from '../providers/cart.provider.js';
+import type { MedusaCategoryProvider } from '../providers/category.provider.js';
+import type { MedusaCheckoutProvider } from '../providers/checkout.provider.js';
+import type { MedusaInventoryProvider } from '../providers/inventory.provider.js';
+import type { MedusaOrderProvider } from '../providers/order.provider.js';
+import type { MedusaOrderSearchProvider } from '../providers/order-search.provider.js';
+import type { MedusaPriceProvider } from '../providers/price.provider.js';
+import type { MedusaProductAssociationsProvider } from '../providers/product-associations.provider.js';
+import type { MedusaProductProvider } from '../providers/product.provider.js';
+import type { MedusaSearchProvider } from '../providers/product-search.provider.js';
+import type { MedusaProfileProvider } from '../providers/profile.provider.js';
+import type { MedusaProductRecommendationsProvider } from '../providers/product-recommendations.provider.js';
+import type { MedusaIdentityProvider } from '../providers/identity.provider.js';
+
+type OverridableCapabilityKey =
+  | 'product'
+  | 'productSearch'
+  | 'cart'
+  | 'checkout'
+  | 'category'
+  | 'price'
+  | 'order'
+  | 'orderSearch'
+  | 'inventory'
+  | 'profile'
+  | 'productAssociations';
+
+type EnabledCapability<TCapability> =
+  TCapability extends { enabled: true } ? true : false;
+
+type NormalizeConfiguredCapabilities<T extends MedusaCapabilities> =
+  Omit<T, OverridableCapabilityKey | 'productRecommendations'> & {
+    [K in OverridableCapabilityKey]?: EnabledCapability<T[K]>;
+  } & {
+    productRecommendations?: EnabledCapability<T['productRecommendations']>;
+    identity?: EnabledCapability<T['identity']>;
+  };
+
+type ExtractCapabilityFactory<TCapability, TContract, TDefaultFactory> =
+  TCapability extends { enabled: true; factory?: infer TFactory }
+    ? TFactory extends TContract
+      ? TFactory
+      : TDefaultFactory
+    : TDefaultFactory;
+
+type ExtractCapabilityProvider<TCapability, TDefaultProvider> =
+  TCapability extends { enabled: true; provider?: infer TProviderFactory }
+    ? TProviderFactory extends (...args: unknown[]) => infer TProvider
+      ? TProvider
+      : TDefaultProvider
+    : TDefaultProvider;
+
+type FactoryContractMap = {
+  product: ProductFactory;
+  productSearch: ProductSearchFactory;
+  cart: CartFactory;
+  checkout: CheckoutFactory;
+  category: CategoryFactory;
+  price: PriceFactory;
+  order: OrderFactory;
+  orderSearch: OrderSearchFactory;
+  inventory: InventoryFactory;
+  profile: ProfileFactory;
+  productAssociations: ProductAssociationsFactory;
+};
+
+type DefaultFactoryMap = {
+  product: MedusaProductFactory;
+  productSearch: MedusaProductSearchFactory;
+  cart: MedusaCartFactory;
+  checkout: MedusaCheckoutFactory;
+  category: MedusaCategoryFactory;
+  price: MedusaPriceFactory;
+  order: MedusaOrderFactory;
+  orderSearch: MedusaOrderSearchFactory;
+  inventory: MedusaInventoryFactory;
+  profile: MedusaProfileFactory;
+  productAssociations: MedusaProductAssociationsFactory;
+};
+
+type ResolvedFactoryMap<T extends MedusaCapabilities> = {
+  [K in OverridableCapabilityKey]: ExtractCapabilityFactory<
+    T[K],
+    FactoryContractMap[K],
+    DefaultFactoryMap[K]
+  >;
+};
+
+type DefaultProviderMap<T extends MedusaCapabilities> = {
+  product: MedusaProductProvider<ResolvedFactoryMap<T>['product']>;
+  productSearch: MedusaSearchProvider<ResolvedFactoryMap<T>['productSearch']>;
+  cart: MedusaCartProvider<ResolvedFactoryMap<T>['cart']>;
+  checkout: MedusaCheckoutProvider<ResolvedFactoryMap<T>['checkout']>;
+  category: MedusaCategoryProvider<ResolvedFactoryMap<T>['category']>;
+  price: MedusaPriceProvider<ResolvedFactoryMap<T>['price']>;
+  order: MedusaOrderProvider<ResolvedFactoryMap<T>['order']>;
+  orderSearch: MedusaOrderSearchProvider<ResolvedFactoryMap<T>['orderSearch']>;
+  inventory: MedusaInventoryProvider<ResolvedFactoryMap<T>['inventory']>;
+  profile: MedusaProfileProvider<ResolvedFactoryMap<T>['profile']>;
+  productAssociations: MedusaProductAssociationsProvider<
+    ResolvedFactoryMap<T>['productAssociations']
+  >;
+  identity: MedusaIdentityProvider;
+  productRecommendations: MedusaProductRecommendationsProvider;
+};
+
+type CapabilityProviderTypeMap<T extends MedusaCapabilities> = {
+  [K in OverridableCapabilityKey | 'productRecommendations' | 'identity']: ExtractCapabilityProvider<
+    T[K],
+    DefaultProviderMap<T>[K]
+  >;
+};
+
+type EnabledCapabilityOverrideMap<T extends MedusaCapabilities> = {
+  [K in OverridableCapabilityKey | 'productRecommendations' | 'identity' as T[K] extends {
+    enabled: true;
+  }
+    ? K
+    : never]: CapabilityProviderTypeMap<T>[K];
+};
+
+export type MedusaClientFromCapabilities<T extends MedusaCapabilities> = Omit<
+  ClientFromCapabilities<NormalizeConfiguredCapabilities<T>>,
+  OverridableCapabilityKey | 'productRecommendations' | 'identity'
+> &
+  EnabledCapabilityOverrideMap<T>;
+
+export function resolveCapabilityProvider<TFactory, TProvider, TProviderArgs>(
+  capability:
+    | {
+        factory?: TFactory;
+        provider?: (args: TProviderArgs) => TProvider;
+      }
+    | undefined,
+  defaults: {
+    factory: TFactory;
+    provider: (args: TProviderArgs) => TProvider;
+  },
+  buildProviderArgs: (factory: TFactory) => TProviderArgs,
+): TProvider {
+  const factory = capability?.factory ?? defaults.factory;
+  const provider = capability?.provider ?? defaults.provider;
+  return provider(buildProviderArgs(factory));
+}
+
+export function resolveProviderOnlyCapability<TProvider, TProviderArgs>(
+  capability:
+    | {
+        provider?: (args: TProviderArgs) => TProvider;
+      }
+    | undefined,
+  defaultProvider: (args: TProviderArgs) => TProvider,
+  args: TProviderArgs,
+): TProvider {
+  const provider = capability?.provider ?? defaultProvider;
+  return provider(args);
+}

package/providers/medusa/src/factories/cart/cart.factory.ts

@@ -0,0 +1,34 @@
+import type {
+  AnyCartIdentifierSchema,
+  AnyCartSchema,
+  CartFactory,
+  CartIdentifierSchema,
+  CartSchema,
+  RequestContext,
+} from '@reactionary/core';
+import type * as z from 'zod';
+
+export class MedusaCartFactory<
+  TCartSchema extends AnyCartSchema = typeof CartSchema,
+  TCartIdentifierSchema extends AnyCartIdentifierSchema = typeof CartIdentifierSchema,
+> implements CartFactory<TCartSchema, TCartIdentifierSchema>
+{
+  public readonly cartSchema: TCartSchema;
+  public readonly cartIdentifierSchema: TCartIdentifierSchema;
+
+  constructor(cartSchema: TCartSchema, cartIdentifierSchema: TCartIdentifierSchema) {
+    this.cartSchema = cartSchema;
+    this.cartIdentifierSchema = cartIdentifierSchema;
+  }
+
+  public parseCart(_context: RequestContext, data: unknown): z.output<TCartSchema> {
+    return this.cartSchema.parse(data);
+  }
+
+  public parseCartIdentifier(
+    _context: RequestContext,
+    data: unknown,
+  ): z.output<TCartIdentifierSchema> {
+    return this.cartIdentifierSchema.parse(data);
+  }
+}

package/providers/medusa/src/factories/category/category.factory.ts

@@ -0,0 +1,37 @@
+import type {
+  AnyCategoryPaginatedResultSchema,
+  AnyCategorySchema,
+  CategoryFactory,
+  CategoryPaginatedResultSchema,
+  CategorySchema,
+  RequestContext,
+} from '@reactionary/core';
+import type * as z from 'zod';
+
+export class MedusaCategoryFactory<
+  TCategorySchema extends AnyCategorySchema = typeof CategorySchema,
+  TCategoryPaginatedSchema extends AnyCategoryPaginatedResultSchema = typeof CategoryPaginatedResultSchema,
+> implements CategoryFactory<TCategorySchema, TCategoryPaginatedSchema>
+{
+  public readonly categorySchema: TCategorySchema;
+  public readonly categoryPaginatedResultSchema: TCategoryPaginatedSchema;
+
+  constructor(
+    categorySchema: TCategorySchema,
+    categoryPaginatedResultSchema: TCategoryPaginatedSchema,
+  ) {
+    this.categorySchema = categorySchema;
+    this.categoryPaginatedResultSchema = categoryPaginatedResultSchema;
+  }
+
+  public parseCategory(_context: RequestContext, data: unknown): z.output<TCategorySchema> {
+    return this.categorySchema.parse(data);
+  }
+
+  public parseCategoryPaginatedResult(
+    _context: RequestContext,
+    data: unknown,
+  ): z.output<TCategoryPaginatedSchema> {
+    return this.categoryPaginatedResultSchema.parse(data);
+  }
+}