ce-storefront 0.7.3 → 0.8.2

package/src/mcp-server/tools/customersListUserReviews.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { customersListUserReviews } from "../../funcs/customersListUserReviews.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ListUserReviewsRequest$inboundSchema,
+};
+
+export const tool$customersListUserReviews: ToolDefinition<typeof args> = {
+  name: "customers-list-user-reviews",
+  description: `Retrieve all reviews
+
+Retrieve all reviews`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await customersListUserReviews(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/customersUpdateAddressDetail.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { customersUpdateAddressDetail } from "../../funcs/customersUpdateAddressDetail.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.UpdateAddressDetailRequest$inboundSchema,
+};
+
+export const tool$customersUpdateAddressDetail: ToolDefinition<typeof args> = {
+  name: "customers-update-address-detail",
+  description: `Update particular address
+
+Update address`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await customersUpdateAddressDetail(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/ordersCancelOrder.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ordersCancelOrder } from "../../funcs/ordersCancelOrder.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.CancelOrderRequest$inboundSchema,
+};
+
+export const tool$ordersCancelOrder: ToolDefinition<typeof args> = {
+  name: "orders-cancel-order",
+  description: `Cancel order
+
+Order cancellation`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await ordersCancelOrder(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/ordersCreateOrder.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ordersCreateOrder } from "../../funcs/ordersCreateOrder.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.CreateOrderRequestBody$inboundSchema,
+};
+
+export const tool$ordersCreateOrder: ToolDefinition<typeof args> = {
+  name: "orders-create-order",
+  description: `Create order
+
+Create new order`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await ordersCreateOrder(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/ordersGetOrderDetail.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ordersGetOrderDetail } from "../../funcs/ordersGetOrderDetail.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetOrderDetailRequest$inboundSchema,
+};
+
+export const tool$ordersGetOrderDetail: ToolDefinition<typeof args> = {
+  name: "orders-get-order-detail",
+  description: `Retrieve order detail
+
+view particular order details`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await ordersGetOrderDetail(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/ordersGetPaymentStatus.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ordersGetPaymentStatus } from "../../funcs/ordersGetPaymentStatus.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetPaymentStatusRequest$inboundSchema,
+};
+
+export const tool$ordersGetPaymentStatus: ToolDefinition<typeof args> = {
+  name: "orders-get-payment-status",
+  description: `Retrieve payment status
+
+Retrieve payment status of a paricular order.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await ordersGetPaymentStatus(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/ordersListOrderShipments.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ordersListOrderShipments } from "../../funcs/ordersListOrderShipments.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ListOrderShipmentsRequest$inboundSchema,
+};
+
+export const tool$ordersListOrderShipments: ToolDefinition<typeof args> = {
+  name: "orders-list-order-shipments",
+  description: `Retrieve order shipments
+
+Retrieve order shipments`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await ordersListOrderShipments(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/ordersListOrders.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ordersListOrders } from "../../funcs/ordersListOrders.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ListOrdersRequest$inboundSchema,
+};
+
+export const tool$ordersListOrders: ToolDefinition<typeof args> = {
+  name: "orders-list-orders",
+  description: `Retrieve all orders
+
+list customers all orders`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await ordersListOrders(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/ordersRetryOrderPayment.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ordersRetryOrderPayment } from "../../funcs/ordersRetryOrderPayment.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.RetryOrderPaymentRequest$inboundSchema,
+};
+
+export const tool$ordersRetryOrderPayment: ToolDefinition<typeof args> = {
+  name: "orders-retry-order-payment",
+  description: `Retry payment
+
+To generate new payment request if first payment request is failed or expired. Retry payment request can be made after 15 mins of last request or immediately after last payment request is marked as failed.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await ordersRetryOrderPayment(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/shippingCheckDeliveryAvailability.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { shippingCheckDeliveryAvailability } from "../../funcs/shippingCheckDeliveryAvailability.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.CheckDeliveryAvailabilityRequest$inboundSchema,
+};
+
+export const tool$shippingCheckDeliveryAvailability: ToolDefinition<
+  typeof args
+> = {
+  name: "shipping-check-delivery-availability",
+  description: `Check pincode deliverability
+
+Check shipment delivery availability in an area by pincode`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await shippingCheckDeliveryAvailability(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools.ts

@@ -0,0 +1,126 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { objectOutputType, ZodRawShape, ZodTypeAny } from "zod";
+import { CeStorefrontCore } from "../core.js";
+import { ConsoleLogger } from "./console-logger.js";
+import { MCPScope } from "./scopes.js";
+import { isAsyncIterable, isBinaryData, valueToBase64 } from "./shared.js";
+
+export type ToolDefinition<Args extends undefined | ZodRawShape = undefined> =
+  Args extends ZodRawShape ? {
+      name: string;
+      description: string;
+      scopes?: MCPScope[];
+      args: Args;
+      tool: (
+        client: CeStorefrontCore,
+        args: objectOutputType<Args, ZodTypeAny>,
+        extra: RequestHandlerExtra,
+      ) => CallToolResult | Promise<CallToolResult>;
+    }
+    : {
+      name: string;
+      description: string;
+      scopes?: MCPScope[];
+      args?: undefined;
+      tool: (
+        client: CeStorefrontCore,
+        extra: RequestHandlerExtra,
+      ) => CallToolResult | Promise<CallToolResult>;
+    };
+
+// Optional function to assist with formatting tool results
+export async function formatResult(
+  value: unknown,
+  init: { response?: Response | undefined },
+): Promise<CallToolResult> {
+  if (typeof value === "undefined") {
+    return { content: [] };
+  }
+
+  const { response } = init;
+  const contentType = response?.headers.get("content-type") ?? "";
+  let content: CallToolResult["content"] = [];
+
+  if (contentType.search(/\bjson\b/g)) {
+    content = [{ type: "text", text: JSON.stringify(value) }];
+  } else if (
+    contentType.startsWith("text/event-stream")
+    && isAsyncIterable(value)
+  ) {
+    content = await consumeSSE(value);
+  } else if (contentType.startsWith("text/") && typeof value === "string") {
+    content = [{ type: "text", text: value }];
+  } else if (isBinaryData(value) && contentType.startsWith("image/")) {
+    const data = await valueToBase64(value);
+    content = data == null
+      ? []
+      : [{ type: "image", data, mimeType: contentType }];
+  } else {
+    return {
+      content: [{
+        type: "text",
+        text: `Unsupported content type: "${contentType}"`,
+      }],
+      isError: true,
+    };
+  }
+
+  return { content };
+}
+
+async function consumeSSE(
+  value: AsyncIterable<unknown>,
+): Promise<CallToolResult["content"]> {
+  const content: CallToolResult["content"] = [];
+
+  for await (const chunk of value) {
+    if (typeof chunk === "string") {
+      content.push({ type: "text", text: chunk });
+    } else {
+      content.push({ type: "text", text: JSON.stringify(chunk) });
+    }
+  }
+
+  return content;
+}
+
+export function createRegisterTool(
+  logger: ConsoleLogger,
+  server: McpServer,
+  sdk: CeStorefrontCore,
+  allowedScopes: Set<MCPScope>,
+  allowedTools?: Set<string>,
+): <A extends ZodRawShape | undefined>(tool: ToolDefinition<A>) => void {
+  return <A extends ZodRawShape | undefined>(tool: ToolDefinition<A>): void => {
+    if (allowedTools && !allowedTools.has(tool.name)) {
+      return;
+    }
+
+    const toolScopes = tool.scopes ?? [];
+    if (allowedScopes.size > 0 && toolScopes.length === 0) {
+      return;
+    }
+
+    if (!toolScopes.every((s) => allowedScopes.has(s))) {
+      return;
+    }
+
+    if (tool.args) {
+      server.tool(tool.name, tool.description, tool.args, async (args, ctx) => {
+        return tool.tool(sdk, args, ctx);
+      });
+    } else {
+      server.tool(tool.name, tool.description, async (ctx) => {
+        return tool.tool(sdk, ctx);
+      });
+    }
+
+    logger.debug("Registered tool", { name: tool.name });
+  };
+}

package/src/models/components/index.ts

@@ -12,7 +12,6 @@ export * from "./cartitem.js";
 export * from "./category.js";
 export * from "./colorattribute.js";
 export * from "./coloroption.js";
-export * from "./createreview.js";
 export * from "./currency.js";
 export * from "./customeraddress.js";
 export * from "./customeraddressinput.js";
@@ -22,6 +21,7 @@ export * from "./dateattribute.js";
 export * from "./discountbasedpromotion.js";
 export * from "./fixedpricepromotion.js";
 export * from "./freegoodspromotion.js";
+export * from "./item.js";
 export * from "./juspaypaymentgatewayparams.js";
 export * from "./juspaypaymentinfo.js";
 export * from "./multiselectattribute.js";
@@ -56,7 +56,6 @@ export * from "./seo.js";
 export * from "./shipmentitem.js";
 export * from "./singleselectattribute.js";
 export * from "./singleselectoption.js";
-export * from "./sku.js";
 export * from "./textattribute.js";
 export * from "./updatecartitem.js";
 export * from "./upipayment.js";

package/src/models/components/{sku.ts → item.ts}

@@ -45,21 +45,21 @@ import {
   ProductSubscription$outboundSchema,
 } from "./productsubscription.js";
 
-export const SKUProductType = {
+export const ItemProductType = {
   Physical: "physical",
   Digital: "digital",
   Bundle: "bundle",
 } as const;
-export type SKUProductType = ClosedEnum<typeof SKUProductType>;
+export type ItemProductType = ClosedEnum<typeof ItemProductType>;
 
-export type Sku = {
+export type Item = {
   productId: string;
   variantId: string | null;
   sku: string;
   slug: string;
   productName: string;
   variantName: string | null;
-  productType: SKUProductType;
+  productType: ItemProductType;
   shortDescription: string | null;
   active: boolean;
   stockAvailable: boolean;
@@ -82,28 +82,28 @@ export type Sku = {
 };
 
 /** @internal */
-export const SKUProductType$inboundSchema: z.ZodNativeEnum<
-  typeof SKUProductType
-> = z.nativeEnum(SKUProductType);
+export const ItemProductType$inboundSchema: z.ZodNativeEnum<
+  typeof ItemProductType
+> = z.nativeEnum(ItemProductType);
 
 /** @internal */
-export const SKUProductType$outboundSchema: z.ZodNativeEnum<
-  typeof SKUProductType
-> = SKUProductType$inboundSchema;
+export const ItemProductType$outboundSchema: z.ZodNativeEnum<
+  typeof ItemProductType
+> = ItemProductType$inboundSchema;
 
 /**
  * @internal
  * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
  */
-export namespace SKUProductType$ {
-  /** @deprecated use `SKUProductType$inboundSchema` instead. */
-  export const inboundSchema = SKUProductType$inboundSchema;
-  /** @deprecated use `SKUProductType$outboundSchema` instead. */
-  export const outboundSchema = SKUProductType$outboundSchema;
+export namespace ItemProductType$ {
+  /** @deprecated use `ItemProductType$inboundSchema` instead. */
+  export const inboundSchema = ItemProductType$inboundSchema;
+  /** @deprecated use `ItemProductType$outboundSchema` instead. */
+  export const outboundSchema = ItemProductType$outboundSchema;
 }
 
 /** @internal */
-export const Sku$inboundSchema: z.ZodType<Sku, z.ZodTypeDef, unknown> = z
+export const Item$inboundSchema: z.ZodType<Item, z.ZodTypeDef, unknown> = z
   .object({
     product_id: z.string(),
     variant_id: z.nullable(z.string()),
@@ -111,7 +111,7 @@ export const Sku$inboundSchema: z.ZodType<Sku, z.ZodTypeDef, unknown> = z
     slug: z.string(),
     product_name: z.string(),
     variant_name: z.nullable(z.string()),
-    product_type: SKUProductType$inboundSchema,
+    product_type: ItemProductType$inboundSchema,
     short_description: z.nullable(z.string()),
     active: z.boolean(),
     stock_available: z.boolean(),
@@ -148,7 +148,7 @@ export const Sku$inboundSchema: z.ZodType<Sku, z.ZodTypeDef, unknown> = z
   });
 
 /** @internal */
-export type Sku$Outbound = {
+export type Item$Outbound = {
   product_id: string;
   variant_id: string | null;
   sku: string;
@@ -175,15 +175,15 @@ export type Sku$Outbound = {
 };
 
 /** @internal */
-export const Sku$outboundSchema: z.ZodType<Sku$Outbound, z.ZodTypeDef, Sku> = z
-  .object({
+export const Item$outboundSchema: z.ZodType<Item$Outbound, z.ZodTypeDef, Item> =
+  z.object({
     productId: z.string(),
     variantId: z.nullable(z.string()),
     sku: z.string(),
     slug: z.string(),
     productName: z.string(),
     variantName: z.nullable(z.string()),
-    productType: SKUProductType$outboundSchema,
+    productType: ItemProductType$outboundSchema,
     shortDescription: z.nullable(z.string()),
     active: z.boolean(),
     stockAvailable: z.boolean(),
@@ -223,25 +223,25 @@ export const Sku$outboundSchema: z.ZodType<Sku$Outbound, z.ZodTypeDef, Sku> = z
  * @internal
  * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
  */
-export namespace Sku$ {
-  /** @deprecated use `Sku$inboundSchema` instead. */
-  export const inboundSchema = Sku$inboundSchema;
-  /** @deprecated use `Sku$outboundSchema` instead. */
-  export const outboundSchema = Sku$outboundSchema;
-  /** @deprecated use `Sku$Outbound` instead. */
-  export type Outbound = Sku$Outbound;
+export namespace Item$ {
+  /** @deprecated use `Item$inboundSchema` instead. */
+  export const inboundSchema = Item$inboundSchema;
+  /** @deprecated use `Item$outboundSchema` instead. */
+  export const outboundSchema = Item$outboundSchema;
+  /** @deprecated use `Item$Outbound` instead. */
+  export type Outbound = Item$Outbound;
 }
 
-export function skuToJSON(sku: Sku): string {
-  return JSON.stringify(Sku$outboundSchema.parse(sku));
+export function itemToJSON(item: Item): string {
+  return JSON.stringify(Item$outboundSchema.parse(item));
 }
 
-export function skuFromJSON(
+export function itemFromJSON(
   jsonString: string,
-): SafeParseResult<Sku, SDKValidationError> {
+): SafeParseResult<Item, SDKValidationError> {
   return safeParse(
     jsonString,
-    (x) => Sku$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Sku' from JSON`,
+    (x) => Item$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Item' from JSON`,
   );
 }

package/src/models/components/juspaypaymentinfo.ts

@@ -25,9 +25,9 @@ export type PaymentLinks = {
  * 1-31 when frequency is MONTHLY, BIMONTHLY, QUARTERLY, HALFYEARLY, or YEARLY.
  */
 export const MandateRuleValue = {
-  One7: "1-7",
-  One16: "1-16",
-  One31: "1-31",
+  OneMinus7: "1-7",
+  OneMinus16: "1-16",
+  OneMinus31: "1-31",
 } as const;
 /**
  * When frequency is passed as WEEKLY, FORTNIGHTLY, MONTHLY, BIMONTHLY, QUARTERLY, HALFYEARLY, or YEARLY then is it required that the exact day of the period should be passed.