@unchainedshop/api 3.1.12 → 3.1.15

package/lib/mcp/tools/product/createProductVariationHandler.d.ts

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+import { Context } from '../../../context.js';
+export declare const CreateProductVariationSchema: {
+    productId: z.ZodString;
+    variation: z.ZodObject<{
+        key: z.ZodString;
+        type: z.ZodEnum<["COLOR" | "TEXT", ...("COLOR" | "TEXT")[]]>;
+    }, "strip", z.ZodTypeAny, {
+        key?: string;
+        type?: "COLOR" | "TEXT";
+    }, {
+        key?: string;
+        type?: "COLOR" | "TEXT";
+    }>;
+    texts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        locale: z.ZodString;
+        title: z.ZodString;
+        subtitle: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        locale?: string;
+        title?: string;
+        subtitle?: string;
+    }, {
+        locale?: string;
+        title?: string;
+        subtitle?: string;
+    }>, "many">>;
+};
+export declare const CreateProductVariationZodSchema: z.ZodObject<{
+    productId: z.ZodString;
+    variation: z.ZodObject<{
+        key: z.ZodString;
+        type: z.ZodEnum<["COLOR" | "TEXT", ...("COLOR" | "TEXT")[]]>;
+    }, "strip", z.ZodTypeAny, {
+        key?: string;
+        type?: "COLOR" | "TEXT";
+    }, {
+        key?: string;
+        type?: "COLOR" | "TEXT";
+    }>;
+    texts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        locale: z.ZodString;
+        title: z.ZodString;
+        subtitle: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        locale?: string;
+        title?: string;
+        subtitle?: string;
+    }, {
+        locale?: string;
+        title?: string;
+        subtitle?: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    productId?: string;
+    texts?: {
+        locale?: string;
+        title?: string;
+        subtitle?: string;
+    }[];
+    variation?: {
+        key?: string;
+        type?: "COLOR" | "TEXT";
+    };
+}, {
+    productId?: string;
+    texts?: {
+        locale?: string;
+        title?: string;
+        subtitle?: string;
+    }[];
+    variation?: {
+        key?: string;
+        type?: "COLOR" | "TEXT";
+    };
+}>;
+export type CreateProductVariationParams = z.infer<typeof CreateProductVariationZodSchema>;
+export declare function createProductVariationHandler(context: Context, params: CreateProductVariationParams): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=createProductVariationHandler.d.ts.map

package/lib/mcp/tools/product/createProductVariationHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProductVariationHandler.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/product/createProductVariationHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAU9C,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;CA4BxC,CAAC;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAyC,CAAC;AACtF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAE3F,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,4BAA4B;;;;;GA8CrC"}

package/lib/mcp/tools/product/createProductVariationHandler.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { ProductTypes, ProductVariationType } from '@unchainedshop/core-products';
+import { ProductNotFoundError, ProductWrongTypeError } from '../../../errors.js';
+import { getNormalizedProductDetails } from '../../utils/getNormalizedProductDetails.js';
+const productVariationTypeKeys = Object.keys(ProductVariationType);
+export const CreateProductVariationSchema = {
+    productId: z
+        .string()
+        .min(1)
+        .describe('Product ID for which to create the variation. it should only be CONFIGURABLE_PRODUCT type product id'),
+    variation: z.object({
+        key: z
+            .string()
+            .min(1)
+            .describe('unique value that is not already used as key for the products variations vector'),
+        type: z.enum(productVariationTypeKeys).describe('Product variation types'),
+    }),
+    texts: z
+        .array(z.object({
+        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().describe('variation title'),
+        subtitle: z.string().optional().describe('variation additional description'),
+    }))
+        .optional(),
+};
+export const CreateProductVariationZodSchema = z.object(CreateProductVariationSchema);
+export async function createProductVariationHandler(context, params) {
+    const { productId, variation, texts } = params;
+    const { modules } = context;
+    try {
+        const product = await modules.products.findProduct({ productId });
+        if (!product)
+            throw new ProductNotFoundError({ productId });
+        if (product.type !== ProductTypes.ConfigurableProduct)
+            throw new ProductWrongTypeError({
+                productId,
+                received: product.type,
+                required: ProductTypes.ConfigurableProduct,
+            });
+        const newVariation = await modules.products.variations.create({
+            options: [],
+            productId,
+            ...variation,
+        });
+        if (texts) {
+            await modules.products.variations.texts.updateVariationTexts(newVariation._id, texts);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        product: await getNormalizedProductDetails(productId, context),
+                    }),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error creating product variation: ${error.message}`,
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=createProductVariationHandler.js.map

package/lib/mcp/tools/product/createProductVariationHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProductVariationHandler.js","sourceRoot":"","sources":["../../../../src/mcp/tools/product/createProductVariationHandler.ts"],"names":[],"mappings":"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"}

package/lib/mcp/tools/product/createProductVariationOptionHandler.d.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { Context } from '../../../context.js';
+export declare const CreateProductVariationOptionSchema: {
+    productVariationId: z.ZodString;
+    option: z.ZodString;
+    texts: z.ZodArray<z.ZodObject<{
+        locale: z.ZodString;
+        title: z.ZodString;
+        subtitle: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        locale?: string;
+        title?: string;
+        subtitle?: string;
+    }, {
+        locale?: string;
+        title?: string;
+        subtitle?: string;
+    }>, "many">;
+};
+export declare const CreateProductVariationOptionZodSchema: z.ZodObject<{
+    productVariationId: z.ZodString;
+    option: z.ZodString;
+    texts: z.ZodArray<z.ZodObject<{
+        locale: z.ZodString;
+        title: z.ZodString;
+        subtitle: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        locale?: string;
+        title?: string;
+        subtitle?: string;
+    }, {
+        locale?: string;
+        title?: string;
+        subtitle?: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    productVariationId?: string;
+    texts?: {
+        locale?: string;
+        title?: string;
+        subtitle?: string;
+    }[];
+    option?: string;
+}, {
+    productVariationId?: string;
+    texts?: {
+        locale?: string;
+        title?: string;
+        subtitle?: string;
+    }[];
+    option?: string;
+}>;
+export type CreateProductVariationOptionParams = z.infer<typeof CreateProductVariationOptionZodSchema>;
+export declare function createProductVariationOptionHandler(context: Context, params: CreateProductVariationOptionParams): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=createProductVariationOptionHandler.d.ts.map

package/lib/mcp/tools/product/createProductVariationOptionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProductVariationOptionHandler.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/product/createProductVariationOptionHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAe9C,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;CAO9C,CAAC;AACF,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA+C,CAAC;AAClG,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEvG,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,kCAAkC;;;;;GA2C3C"}

package/lib/mcp/tools/product/createProductVariationOptionHandler.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { getNormalizedProductDetails } from '../../utils/getNormalizedProductDetails.js';
+import { ProductVariationNotFoundError } from '../../../errors.js';
+const ProductVariationTextInputSchema = z.object({
+    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().describe('variation option title in the specified locale'),
+    subtitle: z.string().optional().describe('variation option subtitle in the specified locale'),
+});
+export const CreateProductVariationOptionSchema = {
+    productVariationId: z
+        .string()
+        .min(1)
+        .describe('ID of the product variation, it should only be a CONFIGURABLE_PRODUCT type ID'),
+    option: z.string().min(1).describe('Name of the new option (e.g., "Red")'),
+    texts: z.array(ProductVariationTextInputSchema),
+};
+export const CreateProductVariationOptionZodSchema = z.object(CreateProductVariationOptionSchema);
+export async function createProductVariationOptionHandler(context, params) {
+    const { productVariationId, option, texts } = params;
+    const { modules } = context;
+    try {
+        const variation = await modules.products.variations.findProductVariation({
+            productVariationId,
+        });
+        if (!variation)
+            throw new ProductVariationNotFoundError({ productVariationId });
+        const newOption = await modules.products.variations.addVariationOption(productVariationId, {
+            value: option,
+        });
+        if (texts) {
+            await modules.products.variations.texts.updateVariationTexts(productVariationId, texts, option);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        variation: newOption,
+                        product: await getNormalizedProductDetails(newOption?.productId, context),
+                    }),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error creating variation option: ${error.message}`,
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=createProductVariationOptionHandler.js.map

package/lib/mcp/tools/product/createProductVariationOptionHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProductVariationOptionHandler.js","sourceRoot":"","sources":["../../../../src/mcp/tools/product/createProductVariationOptionHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,yKAAyK,CAC1K;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAC5E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;CAC9F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kCAAkC,GAAG;IAChD,kBAAkB,EAAE,CAAC;SAClB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,+EAA+E,CAAC;IAC5F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAC1E,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC;CAChD,CAAC;AACF,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CAAC,kCAAkC,CAAC,CAAC;AAGlG,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,OAAgB,EAChB,MAA0C;IAE1C,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACrD,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC;YACvE,kBAAkB;SACnB,CAAC,CAAC;QACH,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,6BAA6B,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAEhF,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,kBAAkB,CAAC,kBAAkB,EAAE;YACzF,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,oBAAoB,CAC1D,kBAAkB,EAClB,KAAY,EACZ,MAAM,CACP,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,SAAS,EAAE,SAAS;wBACpB,OAAO,EAAE,MAAM,2BAA2B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC;qBAC1E,CAAC;iBACH;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,oCAAqC,KAAe,CAAC,OAAO,EAAE;iBACrE;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/lib/mcp/tools/product/getProduct.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { Context } from '../../../context.js';
+/**
+ * Zod schema for the get_product tool (as raw object for MCP)
+ */
+export declare const GetProductSchema: {
+    productId: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    sku: z.ZodOptional<z.ZodString>;
+};
+/**
+ * Zod object schema for type inference and validation
+ */
+export declare const GetProductZodSchema: z.ZodEffects<z.ZodObject<{
+    productId: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    sku: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    productId?: string;
+    slug?: string;
+    sku?: string;
+}, {
+    productId?: string;
+    slug?: string;
+    sku?: string;
+}>, {
+    productId?: string;
+    slug?: string;
+    sku?: string;
+}, {
+    productId?: string;
+    slug?: string;
+    sku?: string;
+}>;
+/**
+ * Interface for the get_product tool parameters
+ */
+export type GetProductParams = z.infer<typeof GetProductZodSchema>;
+/**
+ * Implementation of the get_product tool
+ */
+export declare function getProductHandler(context: Context, params: GetProductParams): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=getProduct.d.ts.map

package/lib/mcp/tools/product/getProduct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getProduct.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/product/getProduct.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG9C;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;CAI5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;EAK7B,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEnE;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB;;;;;GA0CjF"}

package/lib/mcp/tools/product/getProduct.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { getNormalizedProductDetails } from '../../utils/getNormalizedProductDetails.js';
+/**
+ * Zod schema for the get_product tool (as raw object for MCP)
+ */
+export const GetProductSchema = {
+    productId: z.string().optional().describe('Product ID for lookup'),
+    slug: z.string().optional().describe('Product slug for lookup'),
+    sku: z.string().optional().describe('Product SKU for lookup'),
+};
+/**
+ * Zod object schema for type inference and validation
+ */
+export const GetProductZodSchema = z
+    .object(GetProductSchema)
+    .refine((data) => data.productId || data.slug || data.sku, 'At least one of productId, slug, or sku must be provided');
+/**
+ * Implementation of the get_product tool
+ */
+export async function getProductHandler(context, params) {
+    const { productId, slug, sku } = params;
+    try {
+        // Find the product
+        const product = await context.modules.products.findProduct({
+            productId,
+            slug,
+            sku,
+        });
+        if (!product) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Product not found with ${productId ? `ID: ${productId}` : slug ? `slug: ${slug}` : `SKU: ${sku}`}`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        product: await getNormalizedProductDetails(productId, context),
+                    }),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error getting product: ${error.message}`,
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=getProduct.js.map

package/lib/mcp/tools/product/getProduct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getProduct.js","sourceRoot":"","sources":["../../../../src/mcp/tools/product/getProduct.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AAEzF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAClE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC/D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;CAC9D,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,CAAC,gBAAgB,CAAC;KACxB,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EACjD,0DAA0D,CAC3D,CAAC;AAOJ;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAgB,EAAE,MAAwB;IAChF,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IAExC,IAAI,CAAC;QACH,mBAAmB;QACnB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;YACzD,SAAS;YACT,IAAI;YACJ,GAAG;SACJ,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,0BAA0B,SAAS,CAAC,CAAC,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,EAAE,EAAE;qBAC1G;iBACF;aACF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,MAAM,2BAA2B,CAAC,SAAS,EAAE,OAAO,CAAC;qBAC/D,CAAC;iBACH;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,0BAA2B,KAAe,CAAC,OAAO,EAAE;iBAC3D;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/lib/mcp/tools/product/listProducts.d.ts

@@ -0,0 +1,112 @@
+import { z } from 'zod';
+import { Context } from '../../../context.js';
+/**
+ * Zod schema for the list_products tool (as raw object for MCP)
+ */
+export declare const ListProductsSchema: {
+    queryString: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    productIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    filterQuery: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        key?: string;
+        value?: string;
+    }, {
+        key?: string;
+        value?: string;
+    }>, "many">>;
+    assortmentId: z.ZodOptional<z.ZodString>;
+    includeInactive: z.ZodDefault<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    sort: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodEnum<["ASC", "DESC"]>;
+    }, "strip", z.ZodTypeAny, {
+        key?: string;
+        value?: "ASC" | "DESC";
+    }, {
+        key?: string;
+        value?: "ASC" | "DESC";
+    }>, "many">>;
+};
+/**
+ * Zod object schema for type inference
+ */
+export declare const ListProductsZodSchema: z.ZodObject<{
+    queryString: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    productIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    filterQuery: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        key?: string;
+        value?: string;
+    }, {
+        key?: string;
+        value?: string;
+    }>, "many">>;
+    assortmentId: z.ZodOptional<z.ZodString>;
+    includeInactive: z.ZodDefault<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    sort: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodEnum<["ASC", "DESC"]>;
+    }, "strip", z.ZodTypeAny, {
+        key?: string;
+        value?: "ASC" | "DESC";
+    }, {
+        key?: string;
+        value?: "ASC" | "DESC";
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    tags?: string[];
+    sort?: {
+        key?: string;
+        value?: "ASC" | "DESC";
+    }[];
+    assortmentId?: string;
+    includeInactive?: boolean;
+    queryString?: string;
+    limit?: number;
+    offset?: number;
+    productIds?: string[];
+    filterQuery?: {
+        key?: string;
+        value?: string;
+    }[];
+}, {
+    tags?: string[];
+    sort?: {
+        key?: string;
+        value?: "ASC" | "DESC";
+    }[];
+    assortmentId?: string;
+    includeInactive?: boolean;
+    queryString?: string;
+    limit?: number;
+    offset?: number;
+    productIds?: string[];
+    filterQuery?: {
+        key?: string;
+        value?: string;
+    }[];
+}>;
+/**
+ * Interface for the list_products tool parameters
+ */
+export type ListProductsParams = z.infer<typeof ListProductsZodSchema>;
+/**
+ * Implementation of the list_products tool
+ */
+export declare function listProductsHandler(context: Context, params: ListProductsParams): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=listProducts.d.ts.map

package/lib/mcp/tools/product/listProducts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listProducts.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/product/listProducts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAI9C;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA+B,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEvE;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB;;;;;GA4FrF"}

package/lib/mcp/tools/product/listProducts.js

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import normalizeMediaUrl from '../../utils/normalizeMediaUrl.js';
+/**
+ * Zod schema for the list_products tool (as raw object for MCP)
+ */
+export const ListProductsSchema = {
+    // Search & Filter
+    queryString: z.string().optional().describe('Text search across product fields'),
+    tags: z.array(z.string()).optional().describe('Filter by product tags'),
+    productIds: z.array(z.string()).optional().describe('Filter by specific product IDs'),
+    filterQuery: z
+        .array(z.object({
+        key: z.string().describe('Filter key'),
+        value: z.string().optional().describe('Filter value'),
+    }))
+        .optional()
+        .describe('Key-value filter pairs'),
+    assortmentId: z.string().optional().describe('Filter by assortment'),
+    includeInactive: z.boolean().default(false).describe('Include inactive products'),
+    // Pagination
+    limit: z.number().min(1).max(100).default(20).describe('Results per page'),
+    offset: z.number().min(0).default(0).describe('Skip results for pagination'),
+    // Sorting
+    sort: z
+        .array(z.object({
+        key: z.string().describe('Sort field'),
+        value: z.enum(['ASC', 'DESC']).describe('Sort direction'),
+    }))
+        .optional()
+        .describe('Sort options'),
+};
+/**
+ * Zod object schema for type inference
+ */
+export const ListProductsZodSchema = z.object(ListProductsSchema);
+/**
+ * Implementation of the list_products tool
+ */
+export async function listProductsHandler(context, params) {
+    const { queryString, tags, productIds, filterQuery, assortmentId, includeInactive = false, limit = 20, offset = 0, sort, } = params;
+    try {
+        let filteredProductIds = productIds;
+        // If assortmentId is provided, get product IDs from assortment
+        if (assortmentId) {
+            const assortmentProductIds = await context.modules.assortments.products.findProductIds({
+                assortmentId,
+            });
+            if (filteredProductIds) {
+                // Intersection of both sets
+                filteredProductIds = filteredProductIds.filter((id) => assortmentProductIds.includes(id));
+            }
+            else {
+                filteredProductIds = assortmentProductIds;
+            }
+        }
+        let searchResult = {};
+        if (queryString)
+            searchResult = await context.services.filters.searchProducts({
+                queryString,
+                productIds: filteredProductIds,
+                includeInactive,
+                filterQuery: filterQuery?.filter((f) => f.key),
+            }, {
+                locale: context.locale,
+            });
+        const products = await context.modules.products.findProducts({
+            productIds: searchResult?.aggregatedFilteredProductIds,
+            tags,
+            limit,
+            offset,
+            includeDrafts: includeInactive,
+            sort: sort?.filter((s) => s.key),
+        });
+        const productTexts = await context.loaders.productTextLoader.loadMany(products.map(({ _id }) => ({
+            productId: _id,
+            locale: context.locale,
+        })));
+        // iterate all products and add texts
+        const normalizedProducts = await Promise.all(products.map(async (product) => {
+            const texts = productTexts.filter((text) => text?.productId === product._id);
+            const productMedias = await context.modules.products.media.findProductMedias({
+                productId: product._id,
+            });
+            const media = await normalizeMediaUrl(productMedias, context);
+            return {
+                ...product,
+                texts,
+                media,
+            };
+        }));
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        products: normalizedProducts,
+                        total: searchResult?.aggregatedTotalProductIds?.length,
+                        filtered: searchResult?.aggregatedFilteredProductIds?.length || products?.length,
+                    }),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: `Error listing products: ${error.message}` }],
+        };
+    }
+}
+//# sourceMappingURL=listProducts.js.map

package/lib/mcp/tools/product/listProducts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listProducts.js","sourceRoot":"","sources":["../../../../src/mcp/tools/product/listProducts.ts"],"names":[],"mappings":"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"}