@unchainedshop/api 4.0.0-rc.11 → 4.0.0-rc.13

package/lib/resolvers/queries/warehousing/warehousingInterfaces.js

@@ -2,9 +2,11 @@ import { WarehousingDirector } from '@unchainedshop/core';
 import { log } from '@unchainedshop/logger';
 export default async function warehousingInterfaces(root, { type }, { userId }) {
     log(`query warehousingInterfaces ${type}`, { userId });
-    return WarehousingDirector.getAdapters({
-        adapterFilter: (Adapter) => Adapter.typeSupported(type),
-    }).map((Adapter) => ({
+    const allAdapters = await WarehousingDirector.getAdapters();
+    const filteredAdapters = type
+        ? allAdapters.filter((Adapter) => Adapter.typeSupported(type))
+        : allAdapters;
+    return filteredAdapters.map((Adapter) => ({
         _id: Adapter.key,
         label: Adapter.label,
         version: Adapter.version,

package/lib/resolvers/queries/warehousing/warehousingInterfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"warehousingInterfaces.js","sourceRoot":"","sources":["../../../../src/resolvers/queries/warehousing/warehousingInterfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAE5C,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,qBAAqB,CACjD,IAAW,EACX,EAAE,IAAI,EAAqC,EAC3C,EAAE,MAAM,EAAW;IAEnB,GAAG,CAAC,+BAA+B,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAEvD,OAAO,mBAAmB,CAAC,WAAW,CAAC;QACrC,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;KACxD,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"warehousingInterfaces.js","sourceRoot":"","sources":["../../../../src/resolvers/queries/warehousing/warehousingInterfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAE5C,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,qBAAqB,CACjD,IAAW,EACX,EAAE,IAAI,EAAqC,EAC3C,EAAE,MAAM,EAAW;IAEnB,GAAG,CAAC,+BAA+B,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,CAAC;IAC5D,MAAM,gBAAgB,GAAG,IAAI;QAC3B,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,IAA+B,CAAC,CAAC;QACzF,CAAC,CAAC,WAAW,CAAC;IAEhB,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACxC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/lib/schema/query.js

@@ -181,7 +181,7 @@ export default [
       """
       Get all delivery interfaces filtered by type
       """
-      deliveryInterfaces(type: DeliveryProviderType!): [DeliveryInterface!]!
+      deliveryInterfaces(type: DeliveryProviderType): [DeliveryInterface!]!
         @cacheControl(scope: PRIVATE, maxAge: 0)
 
       """
@@ -205,7 +205,7 @@ export default [
       """
       Get all warehousing interfaces filtered by type
       """
-      warehousingInterfaces(type: WarehousingProviderType!): [WarehousingInterface!]!
+      warehousingInterfaces(type: WarehousingProviderType): [WarehousingInterface!]!
         @cacheControl(scope: PRIVATE, maxAge: 0)
 
       """
@@ -242,7 +242,7 @@ export default [
       """
       Get all payment interfaces filtered by type
       """
-      paymentInterfaces(type: PaymentProviderType!): [PaymentInterface!]!
+      paymentInterfaces(type: PaymentProviderType): [PaymentInterface!]!
         @cacheControl(scope: PRIVATE, maxAge: 0)
 
       """
@@ -251,8 +251,8 @@ export default [
       ordersCount(
         includeCarts: Boolean = false
         queryString: String
-        paymentProviderTypes: [PaymentProviderType!]
-        deliveryProviderTypes: [DeliveryProviderType!]
+        paymentProviderIds: [String!]
+        deliveryProviderIds: [String!]
         dateRange: DateFilterInput
         status: [OrderStatus!]
       ): Int!
@@ -267,8 +267,8 @@ export default [
         queryString: String
         status: [OrderStatus!]
         sort: [SortOptionInput!]
-        paymentProviderTypes: [PaymentProviderType!]
-        deliveryProviderTypes: [DeliveryProviderType!]
+        paymentProviderIds: [String!]
+        deliveryProviderIds: [String!]
         dateRange: DateFilterInput
       ): [Order!]!
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unchainedshop/api",
-  "version": "4.0.0-rc.11",
+  "version": "4.0.0-rc.13",
   "main": "lib/api-index.js",
   "types": "lib/api-index.d.ts",
   "type": "module",
@@ -83,17 +83,17 @@
     }
   },
   "dependencies": {
-    "@unchainedshop/core": "^4.0.0-rc.4",
-    "@unchainedshop/events": "^4.0.0-rc.4",
-    "@unchainedshop/logger": "^4.0.0-rc.4",
-    "@unchainedshop/roles": "^4.0.0-rc.4",
-    "@unchainedshop/utils": "^4.0.0-rc.4",
+    "@unchainedshop/core": "^4.0.0-rc.13",
+    "@unchainedshop/events": "^4.0.0-rc.13",
+    "@unchainedshop/logger": "^4.0.0-rc.13",
+    "@unchainedshop/roles": "^4.0.0-rc.13",
+    "@unchainedshop/utils": "^4.0.0-rc.13",
     "accounting": "0.4.1",
     "dataloader": "^2.2.3",
     "expiry-map": "^2.0.0",
     "graphql-scalars": "^1.24.2",
     "moniker": "0.1.2",
-    "p-memoize": "^7.1.1",
+    "p-memoize": "^8.0.0",
     "zod": "^3.25.76"
   },
   "devDependencies": {

package/src/fastify/index.ts

@@ -210,7 +210,7 @@ export const connect = (
   });
 
   fastify.register((s, opts, registered) => {
-    s.register(fastifyMultipart);
+    s.register(fastifyMultipart, { throwFileSizeLimit: true, limits: { fileSize: 1024 * 1024 * 35 } }); // 35MB
     s.route({
       url: TEMP_UPLOAD_API_PATH,
       method: ['POST'],

package/src/fastify/mcpHandler.ts

@@ -58,8 +58,7 @@ const mcpHandler: RouteHandlerMethod = async (
         await server.connect(transport);
       } else {
         // Invalid request
-        res.status(400);
-        return res.send(
+        return res.status(400).send(
           JSON.stringify({
             jsonrpc: '2.0',
             error: {
@@ -76,8 +75,7 @@ const mcpHandler: RouteHandlerMethod = async (
     } else if (req.method === 'GET' || req.method === 'DELETE') {
       const sessionId = req.headers['mcp-session-id'] as string | undefined;
       if (!sessionId || !transports[sessionId]) {
-        res.status(400).send('Invalid or missing session ID');
-        return;
+        return res.status(400).send('Invalid or missing session ID');
       }
 
       const transport = transports[sessionId];
@@ -85,12 +83,10 @@ const mcpHandler: RouteHandlerMethod = async (
       return res;
     }
 
-    res.status(405);
-    return res.send('Method Not Allowed');
+    return res.status(405).send('Method Not Allowed');
   } catch (e) {
     logger.error(e.message);
-    res.status(503);
-    return res.send(JSON.stringify({ name: e.name, code: e.code, message: e.message }));
+    return res.status(503).send(JSON.stringify({ name: e.name, code: e.code, message: e.message }));
   }
 };
 

package/src/locale-context.ts

@@ -15,43 +15,48 @@ export type GetHeaderFn = (key: string) => string | string[];
 
 const memoizeCache = new ExpiryMap(process.env.NODE_ENV === 'production' ? 1000 * 60 : 1); // Cached values expire after 10 seconds
 
-export const resolveDefaultContext = pMemoize(
-  async ({ acceptLang, acceptCountry }, unchainedAPI) => {
-    const languages = await unchainedAPI.modules.languages.findLanguages(
-      { includeInactive: false },
-      { projection: { isoCode: 1, isActive: 1 } },
-    );
+const uncachedResolveDefaultContext = async (
+  { acceptLang, acceptCountry },
+  unchainedAPI: UnchainedCore,
+) => {
+  const languages = await unchainedAPI.modules.languages.findLanguages(
+    { includeInactive: false },
+    { projection: { isoCode: 1, isActive: 1 } },
+  );
 
-    const countries = await unchainedAPI.modules.countries.findCountries(
-      { includeInactive: false },
-      { projection: { isoCode: 1, isActive: 1 } },
-    );
+  const countries = await unchainedAPI.modules.countries.findCountries(
+    { includeInactive: false },
+    { projection: { isoCode: 1, isActive: 1 } },
+  );
 
-    const currencies = await unchainedAPI.modules.currencies.findCurrencies({ includeInactive: false });
+  const currencies = await unchainedAPI.modules.currencies.findCurrencies({ includeInactive: false });
 
-    const locale = resolveBestSupported(acceptLang, acceptCountry, { countries, languages });
+  const locale = resolveBestSupported(acceptLang, acceptCountry, { countries, languages });
 
-    const defaultCurrencyCode = countries.find(
-      (country) => country.isoCode.toUpperCase() === locale?.region?.toUpperCase(),
-    )?.defaultCurrencyCode;
+  const defaultCurrencyCode = countries.find(
+    (country) => country.isoCode.toUpperCase() === locale?.region?.toUpperCase(),
+  )?.defaultCurrencyCode;
 
-    const currencyCode = resolveBestCurrency(defaultCurrencyCode, currencies);
+  const currencyCode = resolveBestCurrency(defaultCurrencyCode, currencies);
 
-    logger.debug(`Locale Context: Resolved ${locale?.baseName} ${currencyCode}`);
+  logger.debug(`Locale Context: Resolved ${locale?.baseName} ${currencyCode}`);
 
-    const newContext: UnchainedLocaleContext = {
-      locale,
-      countryCode: locale?.region,
-      currencyCode,
-    };
+  const newContext: UnchainedLocaleContext = {
+    locale,
+    countryCode: locale?.region,
+    currencyCode,
+  };
 
-    return newContext;
-  },
-  {
-    cache: memoizeCache,
-    cacheKey: ([{ acceptLang, acceptCountry }]) => `${acceptLang}-${acceptCountry}`,
+  return newContext;
+};
+
+export const resolveDefaultContext = pMemoize(uncachedResolveDefaultContext, {
+  cache: memoizeCache,
+  cacheKey: (args) => {
+    const [{ acceptLang, acceptCountry }] = args;
+    return `${acceptLang}-${acceptCountry}`;
   },
-);
+});
 
 export const getLocaleContext = async (
   {

package/src/mcp/index.ts

@@ -1,16 +1,14 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { Context } from '../context.js';
-import { registerOtherTools } from './tools/index.js';
 import { registerFilterTools } from './tools/filter/index.js';
 import { registerProductTools } from './tools/product/index.js';
-import { registerAssortmentTools } from './tools/assortment/index.js';
-import { registerCurrencyTools } from './tools/currency/index.js';
-import { registerCountryTools } from './tools/country/index.js';
-import { registerLanguageTools } from './tools/language/index.js';
-import { registerPaymentProviderTools } from './tools/payment/index.js';
-import { registerDeliveryProviderTools } from './tools/delivery/index.js';
-import { registerWarehousingProviderTools } from './tools/warehousing/index.js';
+
+import { registerLocalizationTools } from './tools/localization/index.js';
+import { registerProviderTools } from './tools/provider/index.js';
 import { registerOrderTools } from './tools/order/index.js';
+import { registerAssortmentTools } from './tools/assortment/index.js';
+import { registerUsersTools } from './tools/users/index.js';
+import { registerSystemTools } from './tools/system/index.js';
 
 export default function createMcpServer(context: Context, roles) {
   const server = new McpServer({
@@ -24,13 +22,10 @@ export default function createMcpServer(context: Context, roles) {
   registerFilterTools(server, context);
   registerProductTools(server, context);
   registerAssortmentTools(server, context);
-  registerCurrencyTools(server, context);
-  registerCountryTools(server, context);
-  registerLanguageTools(server, context);
-  registerOtherTools(server, context);
-  registerPaymentProviderTools(server, context);
-  registerDeliveryProviderTools(server, context);
-  registerWarehousingProviderTools(server, context);
+  registerLocalizationTools(server, context);
+  registerSystemTools(server, context);
+  registerProviderTools(server, context);
   registerOrderTools(server, context);
+  registerUsersTools(server, context);
   return server;
 }

package/src/mcp/tools/assortment/assortmentManagement.ts

@@ -0,0 +1,34 @@
+import { Context } from '../../../context.js';
+import { log } from '@unchainedshop/logger';
+import {
+  actionValidators,
+  AssortmentManagementSchema,
+  AssortmentManagementZodSchema,
+  AssortmentManagementParams,
+  ActionName,
+} from './schemas.js';
+import actionHandlers from './handlers/index.js';
+import { createMcpResponse, createMcpErrorResponse } from '../../utils/sharedSchemas.js';
+
+export { AssortmentManagementSchema, AssortmentManagementZodSchema, AssortmentManagementParams };
+
+export async function assortmentManagement(context: Context, params: AssortmentManagementParams) {
+  const { action, ...actionParams } = params;
+  log('MCP assortmentManagement', { userId: context.userId, params });
+
+  try {
+    if (!(action in actionHandlers)) {
+      throw new Error(`Unknown action: ${action}`);
+    }
+
+    const parsedParams = actionValidators[action as ActionName].parse(actionParams);
+    const data = await actionHandlers[action as ActionName](context, parsedParams as never);
+
+    return createMcpResponse({
+      action,
+      data,
+    });
+  } catch (error) {
+    return createMcpErrorResponse(action, error);
+  }
+}

package/src/mcp/tools/assortment/handlers/addAssortmentFilter.ts

@@ -0,0 +1,23 @@
+import { Context } from '../../../../context.js';
+import { AssortmentNotFoundError } from '../../../../errors.js';
+import { getNormalizedAssortmentDetails } from '../../../utils/getNormalizedAssortmentDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function addAssortmentFilter(context: Context, params: Params<'ADD_FILTER'>) {
+  const { modules } = context;
+  const { assortmentId, filterId, tags } = params;
+
+  const assortment = await modules.assortments.findAssortment({ assortmentId });
+  if (!assortment) throw new AssortmentNotFoundError({ assortmentId });
+
+  const filter = await modules.filters.findFilter({ filterId });
+  if (!filter) throw new Error(`Filter not found: ${filterId}`);
+
+  await modules.assortments.filters.create({
+    assortmentId,
+    filterId,
+    tags,
+  } as any);
+
+  return { assortment: await getNormalizedAssortmentDetails({ assortmentId }, context) };
+}

package/src/mcp/tools/assortment/handlers/addAssortmentLink.ts

@@ -0,0 +1,34 @@
+import { Context } from '../../../../context.js';
+import { AssortmentNotFoundError, CyclicAssortmentLinkNotSupportedError } from '../../../../errors.js';
+import { getNormalizedAssortmentDetails } from '../../../utils/getNormalizedAssortmentDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function addAssortmentLink(context: Context, params: Params<'ADD_LINK'>) {
+  const { modules } = context;
+  const { parentAssortmentId, childAssortmentId, tags } = params;
+
+  const parentAssortment = await modules.assortments.findAssortment({
+    assortmentId: parentAssortmentId,
+  });
+  if (!parentAssortment) throw new AssortmentNotFoundError({ assortmentId: parentAssortmentId });
+
+  const childAssortment = await modules.assortments.findAssortment({
+    assortmentId: childAssortmentId,
+  });
+  if (!childAssortment) throw new Error(`Child assortment not found: ${childAssortmentId}`);
+
+  try {
+    await modules.assortments.links.create({
+      parentAssortmentId,
+      childAssortmentId,
+      tags,
+    } as any);
+    return {
+      assortment: await getNormalizedAssortmentDetails({ assortmentId: parentAssortmentId }, context),
+    };
+  } catch (e) {
+    if (e?.message === 'CyclicGraphNotSupported')
+      throw new CyclicAssortmentLinkNotSupportedError({ parentAssortmentId, childAssortmentId });
+    throw e;
+  }
+}

package/src/mcp/tools/assortment/handlers/addAssortmentMedia.ts

@@ -0,0 +1,20 @@
+import { Context } from '../../../../context.js';
+import { AssortmentNotFoundError } from '../../../../errors.js';
+import { getNormalizedAssortmentDetails } from '../../../utils/getNormalizedAssortmentDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function addAssortmentMedia(context: Context, params: Params<'ADD_MEDIA'>) {
+  const { modules } = context;
+  const { assortmentId, mediaId, tags } = params;
+
+  const assortment = await modules.assortments.findAssortment({ assortmentId });
+  if (!assortment) throw new AssortmentNotFoundError({ assortmentId });
+
+  await modules.assortments.media.create({
+    assortmentId,
+    mediaId,
+    tags,
+  } as any);
+
+  return { assortment: await getNormalizedAssortmentDetails({ assortmentId }, context) };
+}

package/src/mcp/tools/assortment/handlers/addAssortmentProduct.ts

@@ -0,0 +1,23 @@
+import { Context } from '../../../../context.js';
+import { AssortmentNotFoundError, ProductNotFoundError } from '../../../../errors.js';
+import { getNormalizedAssortmentDetails } from '../../../utils/getNormalizedAssortmentDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function addAssortmentProduct(context: Context, params: Params<'ADD_PRODUCT'>) {
+  const { modules } = context;
+  const { assortmentId, productId, tags } = params;
+
+  const assortment = await modules.assortments.findAssortment({ assortmentId });
+  if (!assortment) throw new AssortmentNotFoundError({ assortmentId });
+
+  const product = await modules.products.findProduct({ productId });
+  if (!product) throw new ProductNotFoundError({ productId });
+
+  await modules.assortments.products.create({
+    assortmentId,
+    productId,
+    tags,
+  } as any);
+
+  return { assortment: await getNormalizedAssortmentDetails({ assortmentId }, context) };
+}

package/src/mcp/tools/assortment/handlers/countAssortments.ts

@@ -0,0 +1,16 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+
+export default async function countAssortments(context: Context, params: Params<'COUNT'>) {
+  const { modules } = context;
+  const { tags, slugs, queryString, includeInactive = false, includeLeaves = false } = params;
+
+  const count = await modules.assortments.count({
+    tags,
+    slugs,
+    queryString,
+    includeInactive,
+    includeLeaves,
+  });
+  return { count };
+}

package/src/mcp/tools/assortment/handlers/createAssortment.ts

@@ -0,0 +1,18 @@
+import { Context } from '../../../../context.js';
+import { Assortment, AssortmentText } from '@unchainedshop/core-assortments';
+import { getNormalizedAssortmentDetails } from '../../../utils/getNormalizedAssortmentDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function createAssortment(context: Context, params: Params<'CREATE'>) {
+  const { modules } = context;
+  const { assortment, texts } = params;
+
+  const newAssortment = await modules.assortments.create(assortment as Assortment);
+
+  if (texts && texts.length > 0)
+    await modules.assortments.texts.updateTexts(newAssortment._id, texts as unknown as AssortmentText[]);
+
+  return {
+    assortment: await getNormalizedAssortmentDetails({ assortmentId: newAssortment._id }, context),
+  };
+}

package/src/mcp/tools/assortment/handlers/getAssortment.ts

@@ -0,0 +1,23 @@
+import { Context } from '../../../../context.js';
+import { AssortmentNotFoundError } from '../../../../errors.js';
+import { getNormalizedAssortmentDetails } from '../../../utils/getNormalizedAssortmentDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function getAssortment(context: Context, params: Params<'GET'>) {
+  const { modules } = context;
+  const { assortmentId, slug } = params;
+
+  let query: any = {};
+  if (assortmentId) query = { assortmentId };
+  else if (slug) query = { slug };
+  else throw new Error('Either assortmentId or slug must be provided');
+
+  const assortment = await modules.assortments.findAssortment(query);
+  if (!assortment) throw new AssortmentNotFoundError(query);
+
+  const assortment_details = await getNormalizedAssortmentDetails(
+    { assortmentId: assortment._id },
+    context,
+  );
+  return { assortment: assortment_details };
+}

package/src/mcp/tools/assortment/handlers/getAssortmentChildren.ts

@@ -0,0 +1,22 @@
+import { Context } from '../../../../context.js';
+import { AssortmentNotFoundError } from '../../../../errors.js';
+import { getNormalizedAssortmentDetails } from '../../../utils/getNormalizedAssortmentDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function getAssortmentChildren(context: Context, params: Params<'GET_CHILDREN'>) {
+  const { modules } = context;
+  const { assortmentId, includeInactive = false } = params;
+
+  const assortment = await getNormalizedAssortmentDetails({ assortmentId }, context);
+  if (!assortment) throw new AssortmentNotFoundError({ assortmentId });
+
+  const children = await modules.assortments.children({ assortmentId, includeInactive });
+
+  const children_normalized = await Promise.all(
+    children?.map(async (link) => ({
+      ...(await getNormalizedAssortmentDetails({ assortmentId: link?._id }, context)),
+      ...link,
+    })) || [],
+  );
+  return { assortment, children: children_normalized };
+}

package/src/mcp/tools/assortment/handlers/getAssortmentFilters.ts

@@ -0,0 +1,25 @@
+import { Context } from '../../../../context.js';
+import { AssortmentNotFoundError } from '../../../../errors.js';
+import { getNormalizedAssortmentDetails } from '../../../utils/getNormalizedAssortmentDetails.js';
+import { getNormalizedFilterDetails } from '../../../utils/getNormalizedFilterDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function getAssortmentFilters(context: Context, params: Params<'GET_FILTERS'>) {
+  const { modules } = context;
+  const { assortmentId } = params;
+
+  const assortment = await getNormalizedAssortmentDetails({ assortmentId }, context);
+  if (!assortment) throw new AssortmentNotFoundError({ assortmentId });
+
+  const filters = await modules.assortments.filters.findFilters(
+    { assortmentId },
+    { sort: { sortKey: 1 } },
+  );
+  const filters_normalized = await Promise.all(
+    filters?.map(async ({ filterId, ...rest }) => ({
+      ...(await getNormalizedFilterDetails(filterId, context)),
+      ...rest,
+    })) || [],
+  );
+  return { assortment, filters: filters_normalized };
+}

package/src/mcp/tools/assortment/handlers/getAssortmentLinks.ts

@@ -0,0 +1,25 @@
+import { Context } from '../../../../context.js';
+import { AssortmentNotFoundError } from '../../../../errors.js';
+import { getNormalizedAssortmentDetails } from '../../../utils/getNormalizedAssortmentDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function getAssortmentLinks(context: Context, params: Params<'GET_LINKS'>) {
+  const { loaders } = context;
+  const { assortmentId } = params;
+
+  const assortment = await getNormalizedAssortmentDetails({ assortmentId }, context);
+  if (!assortment) throw new AssortmentNotFoundError({ assortmentId });
+
+  const assortmentLinks = await loaders.assortmentLinksLoader.load({
+    assortmentId,
+  });
+  const links = await Promise.all(
+    assortmentLinks
+      ?.filter((a) => a?.childAssortmentId !== assortment._id)
+      ?.map(async (link) => ({
+        ...(await getNormalizedAssortmentDetails({ assortmentId: link?.childAssortmentId }, context)),
+        ...link,
+      })) || [],
+  );
+  return { assortment, links };
+}

package/src/mcp/tools/assortment/handlers/getAssortmentMedia.ts

@@ -0,0 +1,27 @@
+import { Context } from '../../../../context.js';
+import { AssortmentNotFoundError } from '../../../../errors.js';
+import { getNormalizedAssortmentDetails } from '../../../utils/getNormalizedAssortmentDetails.js';
+import normalizeMediaUrl from '../../../utils/normalizeMediaUrl.js';
+import { Params } from '../schemas.js';
+
+export default async function getAssortmentMedia(context: Context, params: Params<'GET_MEDIA'>) {
+  const { modules, loaders } = context;
+  const { assortmentId, tags, limit = 50, offset = 0 } = params;
+
+  const assortment = await getNormalizedAssortmentDetails({ assortmentId }, context);
+  if (!assortment) throw new AssortmentNotFoundError({ assortmentId });
+
+  let media;
+  if (offset || tags) {
+    media = await modules.assortments.media.findAssortmentMedias({
+      assortmentId,
+      limit,
+      offset,
+      tags,
+    });
+  } else {
+    media = (await loaders.assortmentMediasLoader.load({ assortmentId })).slice(offset, offset + limit);
+  }
+  const media_normalized = await normalizeMediaUrl(media, context);
+  return { assortment, media: media_normalized };
+}

package/src/mcp/tools/assortment/handlers/getAssortmentMediaTexts.ts

@@ -0,0 +1,17 @@
+import { Context } from '../../../../context.js';
+import { AssortmentMediaNotFoundError } from '../../../../errors.js';
+import { Params } from '../schemas.js';
+
+export default async function getAssortmentMediaTexts(
+  context: Context,
+  params: Params<'GET_MEDIA_TEXTS'>,
+) {
+  const { modules } = context;
+  const { assortmentMediaId } = params;
+
+  const media = await modules.assortments.media.findAssortmentMedia({ assortmentMediaId });
+  if (!media) throw new AssortmentMediaNotFoundError({ assortmentMediaId });
+
+  const texts = await modules.assortments.media.texts.findMediaTexts({ assortmentMediaId });
+  return { texts };
+}

package/src/mcp/tools/assortment/handlers/getAssortmentProducts.ts

@@ -0,0 +1,26 @@
+import { Context } from '../../../../context.js';
+import { AssortmentNotFoundError } from '../../../../errors.js';
+import { getNormalizedAssortmentDetails } from '../../../utils/getNormalizedAssortmentDetails.js';
+import { getNormalizedProductDetails } from '../../../utils/getNormalizedProductDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function getAssortmentProducts(context: Context, params: Params<'GET_PRODUCTS'>) {
+  const { modules } = context;
+  const { assortmentId } = params;
+
+  const assortment = await getNormalizedAssortmentDetails({ assortmentId }, context);
+  if (!assortment) throw new AssortmentNotFoundError({ assortmentId });
+
+  const assortmentProducts = await modules.assortments.products.findAssortmentProducts(
+    { assortmentId },
+    { sort: { sortKey: 1 } },
+  );
+
+  const products = await Promise.all(
+    assortmentProducts?.map(async ({ productId, ...rest }) => ({
+      ...(await getNormalizedProductDetails(productId, context)),
+      ...rest,
+    })) || [],
+  );
+  return { assortment, products };
+}

package/src/mcp/tools/assortment/handlers/getAssortmentTexts.ts

@@ -0,0 +1,14 @@
+import { Context } from '../../../../context.js';
+import { AssortmentNotFoundError } from '../../../../errors.js';
+import { Params } from '../schemas.js';
+
+export default async function getAssortmentTexts(context: Context, params: Params<'GET_TEXTS'>) {
+  const { modules } = context;
+  const { assortmentId } = params;
+
+  const assortment = await modules.assortments.findAssortment({ assortmentId });
+  if (!assortment) throw new AssortmentNotFoundError({ assortmentId });
+
+  const texts = await modules.assortments.texts.findTexts({ assortmentId });
+  return { texts };
+}