@unchainedshop/api 4.0.0-rc.3 → 4.0.0-rc.4

package/src/mcp/tools/{removeProductHandler.ts → product/removeProductHandler.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { Context } from '../../context.js';
-import { getNormalizedProductDetails } from '../utils/getNormalizedProductDetails.js';
+import { Context } from '../../../context.js';
+import { getNormalizedProductDetails } from '../../utils/getNormalizedProductDetails.js';
 
 export const RemoveProductSchema = {
   productId: z.string().min(1).describe('ID of the product to remove'),

package/src/mcp/tools/{removeProductMediaHandler.ts → product/removeProductMediaHandler.ts}

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import { Context } from '../../context.js';
+import { Context } from '../../../context.js';
 import { log } from '@unchainedshop/logger';
-import { ProductMediaNotFoundError } from '../../errors.js';
+import { ProductMediaNotFoundError } from '../../../errors.js';
 
 export const RemoveProductMediaSchema = {
   productMediaId: z.string().min(1).describe('ID of the product media to be removed'),

package/src/mcp/tools/{removeProductVariationHandler.ts → product/removeProductVariationHandler.ts}

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import { Context } from '../../context.js';
-import { ProductVariationNotFoundError } from '../../errors.js';
-import { getNormalizedProductDetails } from '../utils/getNormalizedProductDetails.js';
+import { Context } from '../../../context.js';
+import { ProductVariationNotFoundError } from '../../../errors.js';
+import { getNormalizedProductDetails } from '../../utils/getNormalizedProductDetails.js';
 
 export const RemoveProductVariationSchema = {
   productVariationId: z

package/src/mcp/tools/{removeProductVariationOptionHandler.ts → product/removeProductVariationOptionHandler.ts}

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import { Context } from '../../context.js';
-import { getNormalizedProductDetails } from '../utils/getNormalizedProductDetails.js';
-import { ProductVariationNotFoundError } from '../../errors.js';
+import { Context } from '../../../context.js';
+import { getNormalizedProductDetails } from '../../utils/getNormalizedProductDetails.js';
+import { ProductVariationNotFoundError } from '../../../errors.js';
 
 export const RemoveProductVariationOptionSchema = {
   productVariationId: z

package/src/mcp/tools/{reorderProductMediaHandler.ts → product/reorderProductMediaHandler.ts}

@@ -1,5 +1,5 @@
 import { log } from '@unchainedshop/logger';
-import { Context } from '../../context.js';
+import { Context } from '../../../context.js';
 import { z } from 'zod';
 
 export const ReorderProductMediaSchema = {
@@ -23,7 +23,7 @@ export async function reorderProductMediaHandler(context: Context, params: Reord
   const { modules, userId } = context;
 
   try {
-    log('mutation reorderProductMedia', { userId });
+    log('handler reorderProductMedia', { userId });
 
     const reorderedMedia = await modules.products.media.updateManualOrder({ sortKeys: sortKeys as any });
 

package/src/mcp/tools/product/translatedProductMediaTextsHandler.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { Context } from '../../../context.js';
+import { log } from '@unchainedshop/logger';
+
+export const TranslatedProductMediaTextsSchema = {
+  productMediaId: z.string().min(1).describe('ID of the product media to fetch translated texts for'),
+};
+
+export const TranslatedProductMediaTextsZodSchema = z.object(TranslatedProductMediaTextsSchema);
+
+export type TranslatedProductMediaTextsParams = z.infer<typeof TranslatedProductMediaTextsZodSchema>;
+
+export async function translatedProductMediaTextsHandler(
+  context: Context,
+  params: TranslatedProductMediaTextsParams,
+) {
+  const { productMediaId } = params;
+  const { modules, userId } = context;
+
+  try {
+    log(`handler translatedProductMediaTexts: ${productMediaId}`, { userId });
+
+    const texts = await modules.products.media.texts.findMediaTexts({ productMediaId });
+
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ texts }),
+        },
+      ],
+    };
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: `Error getting translated product media texts: ${(error as Error).message}`,
+        },
+      ],
+    };
+  }
+}

package/src/mcp/tools/product/translatedProductTextsHandler.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { Context } from '../../../context.js';
+import { log } from '@unchainedshop/logger';
+
+export const TranslatedProductTextsSchema = {
+  productId: z.string().min(1).describe('ID of the product to fetch translated texts for'),
+};
+
+export const TranslatedProductTextsZodSchema = z.object(TranslatedProductTextsSchema);
+
+export type TranslatedProductTextsParams = z.infer<typeof TranslatedProductTextsZodSchema>;
+
+export async function translatedProductTextsHandler(
+  context: Context,
+  params: TranslatedProductTextsParams,
+) {
+  const { productId } = params;
+  const { modules, userId } = context;
+
+  try {
+    log(`handler translatedProductTexts: ${productId}`, { userId });
+
+    const texts = await modules.products.texts.findTexts({ productId });
+
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ texts }),
+        },
+      ],
+    };
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: `Error getting translated product texts: ${(error as Error).message}`,
+        },
+      ],
+    };
+  }
+}

package/src/mcp/tools/product/translatedProductVariationTextsHandler.ts

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { Context } from '../../../context.js';
+import { log } from '@unchainedshop/logger';
+
+export const TranslatedProductVariationTextsSchema = {
+  productVariationId: z.string().min(1).describe('ID of the product variation'),
+  productVariationOptionValue: z
+    .string()
+    .optional()
+    .describe('Optional specific variation option value'),
+};
+
+export const TranslatedProductVariationTextsZodSchema = z.object(TranslatedProductVariationTextsSchema);
+
+export type TranslatedProductVariationTextsParams = z.infer<
+  typeof TranslatedProductVariationTextsZodSchema
+>;
+
+export async function translatedProductVariationTextsHandler(
+  context: Context,
+  params: TranslatedProductVariationTextsParams,
+) {
+  const { productVariationId, productVariationOptionValue } = params;
+  const { modules, userId } = context;
+
+  try {
+    log(
+      `handler translatedProductVariationTexts: ${productVariationId} ${productVariationOptionValue || ''}`,
+      {
+        userId,
+      },
+    );
+
+    const texts = await modules.products.variations.texts.findVariationTexts({
+      productVariationId,
+      productVariationOptionValue,
+    });
+
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ texts }),
+        },
+      ],
+    };
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: `Error getting translated product variation texts: ${(error as Error).message}`,
+        },
+      ],
+    };
+  }
+}

package/src/mcp/tools/{unPublishProduct.ts → product/unPublishProduct.ts}

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import { Context } from '../../context.js';
-import { ProductNotFoundError, ProductWrongStatusError } from '../../errors.js';
-import { getNormalizedProductDetails } from '../utils/getNormalizedProductDetails.js';
+import { Context } from '../../../context.js';
+import { ProductNotFoundError, ProductWrongStatusError } from '../../../errors.js';
+import { getNormalizedProductDetails } from '../../utils/getNormalizedProductDetails.js';
 
 export const UnpublishProductSchema = {
   productId: z.string().min(1).describe('ID of the product to unpublish'),

package/src/mcp/tools/{updateProduct.ts → product/updateProduct.ts}

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import { Context } from '../../context.js';
-import { ProductNotFoundError } from '../../errors.js';
-import { getNormalizedProductDetails } from '../utils/getNormalizedProductDetails.js';
+import { Context } from '../../../context.js';
+import { ProductNotFoundError } from '../../../errors.js';
+import { getNormalizedProductDetails } from '../../utils/getNormalizedProductDetails.js';
 
 export const UpdateProductSchema = {
   productId: z.string().min(1).describe('ID of the product to update'),

package/src/mcp/tools/{updateProductCommerceHandler.ts → product/updateProductCommerceHandler.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { Context } from '../../context.js';
-import { getNormalizedProductDetails } from '../utils/getNormalizedProductDetails.js';
+import { Context } from '../../../context.js';
+import { getNormalizedProductDetails } from '../../utils/getNormalizedProductDetails.js';
 
 export const UpdateProductCommerceSchema = {
   productId: z

package/src/mcp/tools/{updateProductMediaTextsHandler.ts → product/updateProductMediaTextsHandler.ts}

@@ -1,13 +1,18 @@
 import { z } from 'zod';
-import { Context } from '../../context.js';
-import { ProductMediaNotFoundError } from '../../errors.js';
+import { Context } from '../../../context.js';
+import { ProductMediaNotFoundError } from '../../../errors.js';
 
 export const UpdateProductMediaTextsSchema = {
   productMediaId: z.string().min(1).describe('ID of the media asset to update'),
   texts: z
     .array(
       z.object({
-        locale: z.string().min(2).describe('Locale of the text, e.g. "en", "fr", etc.'),
+        locale: z
+          .string()
+          .min(2)
+          .describe(
+            'locale iso code like "en-US", "de-CH" use default defaultLanguageIsoCode in shop info if not explicitly provided. if language is explicitly provided check if it exists',
+          ),
         title: z.string().optional().describe('Title in the given locale'),
         subtitle: z.string().optional().describe('Subtitle in the given locale'),
       }),

package/src/mcp/tools/{updateProductPlanHandler.ts → product/updateProductPlanHandler.ts}

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { Context } from '../../context.js';
-import { ProductNotFoundError, ProductWrongStatusError } from '../../errors.js';
+import { Context } from '../../../context.js';
+import { ProductNotFoundError, ProductWrongStatusError } from '../../../errors.js';
 import { ProductTypes } from '@unchainedshop/core-products';
-import { getNormalizedProductDetails } from '../utils/getNormalizedProductDetails.js';
+import { getNormalizedProductDetails } from '../../utils/getNormalizedProductDetails.js';
 
 export const UpdateProductPlanSchema = {
   productId: z.string().min(1).describe('ID of the product of type PLAN_PRODUCT to update only'),

package/src/mcp/tools/{updateProductSupplyHandler.ts → product/updateProductSupplyHandler.ts}

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { Context } from '../../context.js';
-import { ProductWrongTypeError } from '../../errors.js';
+import { Context } from '../../../context.js';
+import { ProductWrongTypeError } from '../../../errors.js';
 import { ProductTypes } from '@unchainedshop/core-products';
-import { getNormalizedProductDetails } from '../utils/getNormalizedProductDetails.js';
+import { getNormalizedProductDetails } from '../../utils/getNormalizedProductDetails.js';
 
 export const UpdateProductSupplySchema = {
   productId: z

package/src/mcp/tools/{updateProductTextsHandler.ts → product/updateProductTextsHandler.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { Context } from '../../context.js';
-import { getNormalizedProductDetails } from '../utils/getNormalizedProductDetails.js';
+import { Context } from '../../../context.js';
+import { getNormalizedProductDetails } from '../../utils/getNormalizedProductDetails.js';
 
 export const UpdateProductTextsSchema = {
   productId: z.string().min(1).describe('ID of the product to update texts for'),
@@ -11,7 +11,7 @@ export const UpdateProductTextsSchema = {
           .string()
           .min(2)
           .describe(
-            'Locale code like "en", "de" always use locales registered in the system languages, if explicitly provided check if it exists',
+            'locale iso code like "en-US", "de-CH" use default defaultLanguageIsoCode in shop info if not explicitly provided. if language is explicitly provided check if it exists',
           ),
         slug: z.string().optional().describe('URL slug'),
         title: z.string().optional().describe('Product title'),

package/src/mcp/tools/{updateProductTokenizationHandler.ts → product/updateProductTokenizationHandler.ts}

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { Context } from '../../context.js';
+import { Context } from '../../../context.js';
 import { ProductTypes } from '@unchainedshop/core-products';
-import { ProductNotFoundError, ProductWrongStatusError } from '../../errors.js';
-import { getNormalizedProductDetails } from '../utils/getNormalizedProductDetails.js';
+import { ProductNotFoundError, ProductWrongStatusError } from '../../../errors.js';
+import { getNormalizedProductDetails } from '../../utils/getNormalizedProductDetails.js';
 
 export const UpdateProductTokenizationSchema = {
   productId: z.string().min(1).describe('ID of the product of type TOKENIZED_PRODUCT to tokenize only'),

package/src/mcp/tools/{updateProductWarehousingHandler.ts → product/updateProductWarehousingHandler.ts}

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { Context } from '../../context.js';
-import { ProductWrongTypeError } from '../../errors.js';
+import { Context } from '../../../context.js';
+import { ProductWrongTypeError } from '../../../errors.js';
 import { ProductTypes } from '@unchainedshop/core-products';
-import { getNormalizedProductDetails } from '../utils/getNormalizedProductDetails.js';
+import { getNormalizedProductDetails } from '../../utils/getNormalizedProductDetails.js';
 
 export const UpdateProductWarehousingSchema = {
   productId: z.string().min(1).describe('ID of the SIMPLE_PRODUCT product type to update to be updated'),

package/src/mcp/tools/shopInfoHandler.ts

@@ -0,0 +1,33 @@
+import { Context } from '../../context.js';
+import { log } from '@unchainedshop/logger';
+
+export async function shopInfoHandler(context: Context) {
+  const { version, userId, loaders, locale, countryCode } = context;
+
+  try {
+    log('query shopInfo', { userId });
+
+    const language = await loaders.languageLoader.load({ isoCode: locale.language });
+
+    const country = await loaders.countryLoader.load({ isoCode: countryCode });
+    const defaultLanguageIsoCode = language.isoCode + '-' + country.isoCode;
+
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ version, defaultLanguageIsoCode, country, language }),
+        },
+      ],
+    };
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: `Error getting shop info: ${(error as Error).message}`,
+        },
+      ],
+    };
+  }
+}

package/src/mcp/utils/getNormalizedAssortmentDetails.ts

@@ -0,0 +1,40 @@
+import { Context } from '../../context.js';
+import normalizeMediaUrl from './normalizeMediaUrl.js';
+
+export async function getNormalizedAssortmentDetails(
+  { assortmentId, slug }: { assortmentId?: string; slug?: string },
+  context: Context,
+) {
+  const { modules, locale, loaders } = context;
+  const assortment = await modules.assortments.findAssortment({ assortmentId, slug });
+  const normalizedAssortmentId = assortmentId || assortment._id;
+  if (!assortment) return null;
+
+  const texts = await loaders.assortmentTextLoader.load({
+    assortmentId: normalizedAssortmentId,
+    locale,
+  });
+
+  const assortmentMedias = await modules.assortments.media.findAssortmentMedias({
+    assortmentId: normalizedAssortmentId,
+  });
+  const assortmentChildLinks = await loaders.assortmentLinksLoader.load({
+    parentAssortmentId: assortment._id,
+  });
+
+  const assortmentIds = assortmentChildLinks.map(({ childAssortmentId }) => childAssortmentId);
+
+  const childrenCount = await modules.assortments.count({
+    assortmentIds,
+    includeInactive: true,
+    includeLeaves: true,
+  });
+  const media = await normalizeMediaUrl(assortmentMedias, context);
+
+  return {
+    ...assortment,
+    texts,
+    media,
+    childrenCount,
+  };
+}

package/src/mcp/utils/getNormalizedFilterDetails.ts

@@ -0,0 +1,23 @@
+import { Context } from '../../context.js';
+
+export async function getNormalizedFilterDetails(filterId: string, context: Context) {
+  const { modules, locale, loaders } = context;
+  const filter = await modules.filters.findFilter({ filterId });
+
+  const texts = await loaders.filterTextLoader.load({
+    filterId,
+    filterOptionValue: null,
+    locale,
+  });
+
+  const options = await (filter.options || []).map((filterOption) => ({
+    ...filter,
+    filterOption,
+  }));
+
+  return {
+    ...filter,
+    options,
+    texts,
+  };
+}

package/src/resolvers/mutations/accounts/createUser.ts

@@ -24,10 +24,16 @@ export default async function createUser(root: never, params: UserRegistrationDa
   }
 
   try {
+    const usersCountBeforeCreation = await context.modules.users.count({
+      includeDeleted: true,
+      includeGuests: true,
+    });
+
     const newUserId = await modules.users.createUser(
       {
         ...params,
         initialPassword: false,
+        roles: usersCountBeforeCreation === 0 ? ['admin'] : [],
       },
       {},
     );

package/src/resolvers/queries/index.ts

@@ -79,7 +79,7 @@ export default {
   impersonator,
   user: acl(actions.viewUser)(user),
   users: acl(actions.viewUsers)(users),
-  usersCount: acl(actions.viewUsers)(usersCount),
+  usersCount: acl(actions.viewUserCount)(usersCount),
   product: acl(actions.viewProduct)(product),
   products: acl(actions.viewProducts)(products),
   productsCount: acl(actions.viewProducts)(productsCount),

package/src/roles/all.ts

@@ -31,6 +31,15 @@ export const all = (role, actions) => {
     return false;
   };
 
+  const isUsersCollectionEmpty = async (_: never, params: never, context: Context) => {
+    const count = await context.modules.users.count({
+      includeDeleted: true,
+      includeGuests: true,
+    });
+    if (count === 0) return true;
+    return false;
+  };
+
   const isFilePublic = async (file) => {
     // Non private files or no files always resolve to true
     if (!file?.meta?.isPrivate) return true;
@@ -41,6 +50,7 @@ export const all = (role, actions) => {
   role.allow(actions.viewEvents, () => false);
   role.allow(actions.viewUser, () => false);
   role.allow(actions.viewUsers, () => false);
+  role.allow(actions.viewUserCount, isUsersCollectionEmpty);
   role.allow(actions.viewPaymentProviders, () => false);
   role.allow(actions.viewPaymentProvider, () => false);
   role.allow(actions.viewPaymentInterfaces, () => false);

package/src/roles/index.ts

@@ -26,6 +26,7 @@ const actions: Record<string, string> = [
   'viewLogs',
   'viewUser',
   'viewUsers',
+  'viewUserCount',
   'viewProduct',
   'viewProducts',
   'viewLanguages',