@yawlabs/lemonsqueezy-mcp 0.1.1 → 0.2.0

package/dist/index.js

@@ -21027,7 +21027,7 @@ function buildQuery(params) {
   if (!params) return "";
   const parts = [];
   if (params.include?.length) {
-    parts.push(`include=${encodeURIComponent(params.include.join(","))}`);
+    parts.push(`include=${encodeURIComponent(params.include.map((s) => s.trim()).join(","))}`);
   }
   if (params.filter) {
     for (const [key, value] of Object.entries(params.filter)) {
@@ -21055,15 +21055,28 @@ async function apiRequest(method, path, body) {
     fetchBody = JSON.stringify(body);
   }
   const url = path.startsWith("http") ? path : `${BASE_URL}${path}`;
-  const res = await fetch(url, {
-    method,
-    headers,
-    body: fetchBody,
-    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
-  });
+  let res;
+  try {
+    res = await fetch(url, {
+      method,
+      headers,
+      body: fetchBody,
+      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+    });
+  } catch (err) {
+    if (err instanceof Error && err.name === "TimeoutError") {
+      return { ok: false, status: 0, error: `Request timed out after ${REQUEST_TIMEOUT_MS / 1e3}s` };
+    }
+    throw err;
+  }
   if (!res.ok) {
     const errorBody = await res.text();
-    return { ok: false, status: res.status, error: errorBody };
+    try {
+      const parsed = JSON.parse(errorBody);
+      return { ok: false, status: res.status, data: parsed, error: parsed.errors?.[0]?.detail ?? errorBody };
+    } catch {
+      return { ok: false, status: res.status, error: errorBody };
+    }
   }
   if (res.status === 204 || res.headers.get("content-length") === "0") {
     return { ok: true, status: res.status };
@@ -21073,18 +21086,31 @@ async function apiRequest(method, path, body) {
 }
 async function licenseRequest(path, body) {
   const url = `${BASE_URL}${path}`;
-  const res = await fetch(url, {
-    method: "POST",
-    headers: {
-      Accept: "application/json",
-      "Content-Type": "application/x-www-form-urlencoded"
-    },
-    body: new URLSearchParams(body),
-    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
-  });
+  let res;
+  try {
+    res = await fetch(url, {
+      method: "POST",
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/x-www-form-urlencoded"
+      },
+      body: new URLSearchParams(body),
+      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+    });
+  } catch (err) {
+    if (err instanceof Error && err.name === "TimeoutError") {
+      return { ok: false, status: 0, error: `Request timed out after ${REQUEST_TIMEOUT_MS / 1e3}s` };
+    }
+    throw err;
+  }
   if (!res.ok) {
     const errorBody = await res.text();
-    return { ok: false, status: res.status, error: errorBody };
+    try {
+      const parsed = JSON.parse(errorBody);
+      return { ok: false, status: res.status, data: parsed, error: parsed.error ?? errorBody };
+    } catch {
+      return { ok: false, status: res.status, error: errorBody };
+    }
   }
   const data = await res.json();
   return { ok: true, status: res.status, data };
@@ -21125,7 +21151,7 @@ var checkoutTools = [
   },
   {
     name: "ls_list_checkouts",
-    description: "List all checkouts, optionally filtered by store or variant.",
+    description: "List all checkouts, optionally filtered by store or variant. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List checkouts",
       readOnlyHint: true,
@@ -21137,8 +21163,8 @@ var checkoutTools = [
       storeId: external_exports.string().optional().describe("Filter by store ID"),
       variantId: external_exports.string().optional().describe("Filter by variant ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'store,variant')"),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -21165,21 +21191,21 @@ var checkoutTools = [
     inputSchema: external_exports.object({
       storeId: external_exports.string().describe("The store ID"),
       variantId: external_exports.string().describe("The variant ID for the product being purchased"),
-      customPrice: external_exports.number().optional().describe("Custom price in cents (overrides the variant price)"),
-      enabledVariants: external_exports.array(external_exports.number()).optional().describe("Array of variant IDs to show on the checkout (for products with multiple variants)"),
+      customPrice: external_exports.number().int().min(0).optional().describe("Custom price in cents (overrides the variant price)"),
+      enabledVariants: external_exports.array(external_exports.string()).optional().describe("Array of variant IDs to show on the checkout (for products with multiple variants)"),
       email: external_exports.string().optional().describe("Prefill customer email"),
       name: external_exports.string().optional().describe("Prefill customer name"),
       billingAddressCountry: external_exports.string().optional().describe("Prefill billing country (ISO 3166-1 alpha-2)"),
       billingAddressZip: external_exports.string().optional().describe("Prefill billing ZIP/postal code"),
       taxNumber: external_exports.string().optional().describe("Prefill tax/VAT number"),
       discountCode: external_exports.string().optional().describe("Pre-apply a discount code"),
-      customData: external_exports.string().optional().describe("Custom JSON data to attach to the order (as a JSON string)"),
+      customData: external_exports.record(external_exports.unknown()).optional().describe("Custom data object to attach to the order"),
       expiresAt: external_exports.string().optional().describe("Checkout expiry date (ISO 8601 format)")
     }),
     handler: async (input) => {
       const attributes = {};
       if (input.customPrice !== void 0) attributes.custom_price = input.customPrice;
-      if (input.enabledVariants) attributes.product_options = { enabled_variants: input.enabledVariants };
+      if (input.enabledVariants !== void 0) attributes.product_options = { enabled_variants: input.enabledVariants };
       if (input.expiresAt !== void 0) attributes.expires_at = input.expiresAt;
       const checkoutData = {};
       if (input.email !== void 0) checkoutData.email = input.email;
@@ -21195,11 +21221,7 @@ var checkoutTools = [
       if (input.taxNumber !== void 0) checkoutData.tax_number = input.taxNumber;
       if (input.discountCode !== void 0) checkoutData.discount_code = input.discountCode;
       if (input.customData !== void 0) {
-        try {
-          checkoutData.custom = JSON.parse(input.customData);
-        } catch {
-          checkoutData.custom = input.customData;
-        }
+        checkoutData.custom = input.customData;
       }
       if (Object.keys(checkoutData).length > 0) attributes.checkout_data = checkoutData;
       return apiPost("/checkouts", {
@@ -21239,7 +21261,7 @@ var customerTools = [
   },
   {
     name: "ls_list_customers",
-    description: "List all customers, optionally filtered by store or email.",
+    description: "List all customers, optionally filtered by store or email. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List customers",
       readOnlyHint: true,
@@ -21251,8 +21273,8 @@ var customerTools = [
       storeId: external_exports.string().optional().describe("Filter by store ID"),
       email: external_exports.string().optional().describe("Filter by customer email"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'store,orders,subscriptions,license-keys')"),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -21289,9 +21311,9 @@ var customerTools = [
         name: input.name,
         email: input.email
       };
-      if (input.city) attributes.city = input.city;
-      if (input.region) attributes.region = input.region;
-      if (input.country) attributes.country = input.country;
+      if (input.city !== void 0) attributes.city = input.city;
+      if (input.region !== void 0) attributes.region = input.region;
+      if (input.country !== void 0) attributes.country = input.country;
       return apiPost("/customers", {
         data: {
           type: "customers",
@@ -21387,7 +21409,7 @@ var discountRedemptionTools = [
   },
   {
     name: "ls_list_discount_redemptions",
-    description: "List all discount redemptions, optionally filtered by discount or order.",
+    description: "List all discount redemptions, optionally filtered by discount or order. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List discount redemptions",
       readOnlyHint: true,
@@ -21399,8 +21421,8 @@ var discountRedemptionTools = [
       discountId: external_exports.string().optional().describe("Filter by discount ID"),
       orderId: external_exports.string().optional().describe("Filter by order ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'discount,order')"),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -21439,7 +21461,7 @@ var discountTools = [
   },
   {
     name: "ls_list_discounts",
-    description: "List all discounts, optionally filtered by store.",
+    description: "List all discounts, optionally filtered by store. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List discounts",
       readOnlyHint: true,
@@ -21450,8 +21472,8 @@ var discountTools = [
     inputSchema: external_exports.object({
       storeId: external_exports.string().optional().describe("Filter by store ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'store,variants,discount-redemptions')"),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -21478,19 +21500,19 @@ var discountTools = [
       storeId: external_exports.string().describe("The store ID to create the discount in"),
       name: external_exports.string().describe("Internal name for the discount"),
       code: external_exports.string().describe("The discount code customers will enter (e.g. 'SAVE20')"),
-      amount: external_exports.number().describe(
+      amount: external_exports.number().int().min(1).describe(
         "Discount amount \u2014 in cents for 'fixed' type (e.g. 1000 = $10.00), or percentage for 'percent' type (e.g. 20 = 20%)"
       ),
-      amountType: external_exports.string().describe("Discount type: 'percent' or 'fixed'"),
-      duration: external_exports.string().optional().describe(
+      amountType: external_exports.enum(["percent", "fixed"]).describe("Discount type: 'percent' or 'fixed'"),
+      duration: external_exports.enum(["once", "repeating", "forever"]).optional().describe(
         "How long the discount applies: 'once' (first payment only), 'repeating' (for N months), or 'forever' (default)"
       ),
-      durationInMonths: external_exports.number().optional().describe("Number of months the discount applies (required when duration is 'repeating')"),
-      maxRedemptions: external_exports.number().optional().describe("Maximum number of times this discount can be redeemed (0 = unlimited)"),
+      durationInMonths: external_exports.number().int().min(1).optional().describe("Number of months the discount applies (required when duration is 'repeating')"),
+      maxRedemptions: external_exports.number().int().min(0).optional().describe("Maximum number of times this discount can be redeemed (0 = unlimited)"),
       startsAt: external_exports.string().optional().describe("When the discount becomes active (ISO 8601 format)"),
       expiresAt: external_exports.string().optional().describe("When the discount expires (ISO 8601 format)"),
       isLimitedToProducts: external_exports.boolean().optional().describe("If true, the discount only applies to specific variants (set via variantIds)"),
-      variantIds: external_exports.array(external_exports.number()).optional().describe("Array of variant IDs this discount applies to (requires isLimitedToProducts: true)")
+      variantIds: external_exports.array(external_exports.string()).optional().describe("Array of variant IDs this discount applies to (requires isLimitedToProducts: true)")
     }),
     handler: async (input) => {
       const attributes = {
@@ -21510,7 +21532,7 @@ var discountTools = [
       };
       if (input.variantIds?.length) {
         relationships.variants = {
-          data: input.variantIds.map((id) => ({ type: "variants", id: String(id) }))
+          data: input.variantIds.map((id) => ({ type: "variants", id }))
         };
       }
       return apiPost("/discounts", {
@@ -21564,7 +21586,7 @@ var fileTools = [
   },
   {
     name: "ls_list_files",
-    description: "List all files, optionally filtered by variant.",
+    description: "List all files, optionally filtered by variant. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List files",
       readOnlyHint: true,
@@ -21575,8 +21597,8 @@ var fileTools = [
     inputSchema: external_exports.object({
       variantId: external_exports.string().optional().describe("Filter by variant ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'variant')"),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -21614,7 +21636,7 @@ var licenseKeyInstanceTools = [
   },
   {
     name: "ls_list_license_key_instances",
-    description: "List all license key instances (activations), optionally filtered by license key.",
+    description: "List all license key instances (activations), optionally filtered by license key. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List license key instances",
       readOnlyHint: true,
@@ -21625,8 +21647,8 @@ var licenseKeyInstanceTools = [
     inputSchema: external_exports.object({
       licenseKeyId: external_exports.string().optional().describe("Filter by license key ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'license-key')"),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -21666,7 +21688,7 @@ var licenseKeyTools = [
   },
   {
     name: "ls_list_license_keys",
-    description: "List all license keys, optionally filtered by store, order, or product.",
+    description: "List all license keys, optionally filtered by store, order, or product. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List license keys",
       readOnlyHint: true,
@@ -21682,8 +21704,8 @@ var licenseKeyTools = [
       include: external_exports.string().optional().describe(
         "Comma-separated related resources to include (e.g. 'store,customer,order,order-item,product,license-key-instances')"
       ),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -21711,7 +21733,7 @@ var licenseKeyTools = [
     },
     inputSchema: external_exports.object({
       licenseKeyId: external_exports.string().describe("The license key ID to update"),
-      activationLimit: external_exports.number().optional().describe("Maximum number of activations allowed (0 = unlimited)"),
+      activationLimit: external_exports.number().int().min(0).optional().describe("Maximum number of activations allowed (0 = unlimited)"),
       disabled: external_exports.boolean().optional().describe("Set to true to disable this license key"),
       expiresAt: external_exports.string().optional().describe("Expiry date (ISO 8601 format). Set to null to remove expiry.")
     }),
@@ -21770,7 +21792,7 @@ var licenseTools = [
     }),
     handler: async (input) => {
       const body = { license_key: input.licenseKey };
-      if (input.instanceId) body.instance_id = input.instanceId;
+      if (input.instanceId !== void 0) body.instance_id = input.instanceId;
       return licenseRequest("/licenses/validate", body);
     }
   },
@@ -21820,7 +21842,7 @@ var orderItemTools = [
   },
   {
     name: "ls_list_order_items",
-    description: "List all order items, optionally filtered by order or product.",
+    description: "List all order items, optionally filtered by order or product. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List order items",
       readOnlyHint: true,
@@ -21833,8 +21855,8 @@ var orderItemTools = [
       productId: external_exports.string().optional().describe("Filter by product ID"),
       variantId: external_exports.string().optional().describe("Filter by variant ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'order,product,variant')"),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -21876,7 +21898,7 @@ var orderTools = [
   },
   {
     name: "ls_list_orders",
-    description: "List all orders, optionally filtered by store, email, or user email.",
+    description: "List all orders, optionally filtered by store or user email. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List orders",
       readOnlyHint: true,
@@ -21890,8 +21912,8 @@ var orderTools = [
       include: external_exports.string().optional().describe(
         "Comma-separated related resources to include (e.g. 'store,customer,order-items,subscriptions,license-keys,discount-redemptions')"
       ),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -21923,18 +21945,21 @@ var orderTools = [
       state: external_exports.string().optional().describe("Customer state/region"),
       zipCode: external_exports.string().optional().describe("Customer ZIP/postal code"),
       country: external_exports.string().optional().describe("Customer country"),
-      notes: external_exports.string().optional().describe("Additional notes to include on the invoice")
+      notes: external_exports.string().optional().describe("Additional notes to include on the invoice"),
+      locale: external_exports.string().optional().describe("Invoice language locale (e.g. 'en', 'fr', 'de')")
     }),
     handler: async (input) => {
-      const body = {};
-      if (input.name !== void 0) body.name = input.name;
-      if (input.address !== void 0) body.address = input.address;
-      if (input.city !== void 0) body.city = input.city;
-      if (input.state !== void 0) body.state = input.state;
-      if (input.zipCode !== void 0) body.zip_code = input.zipCode;
-      if (input.country !== void 0) body.country = input.country;
-      if (input.notes !== void 0) body.notes = input.notes;
-      return apiPost(`/orders/${input.orderId}/generate-invoice`, body);
+      const params = new URLSearchParams();
+      if (input.name !== void 0) params.set("name", input.name);
+      if (input.address !== void 0) params.set("address", input.address);
+      if (input.city !== void 0) params.set("city", input.city);
+      if (input.state !== void 0) params.set("state", input.state);
+      if (input.zipCode !== void 0) params.set("zip_code", input.zipCode);
+      if (input.country !== void 0) params.set("country", input.country);
+      if (input.notes !== void 0) params.set("notes", input.notes);
+      if (input.locale !== void 0) params.set("locale", input.locale);
+      const qs = params.toString();
+      return apiPost(`/orders/${input.orderId}/generate-invoice${qs ? `?${qs}` : ""}`);
     }
   },
   {
@@ -21949,7 +21974,7 @@ var orderTools = [
     },
     inputSchema: external_exports.object({
       orderId: external_exports.string().describe("The order ID to refund"),
-      amount: external_exports.number().describe("Refund amount in cents (e.g. 1000 = $10.00)")
+      amount: external_exports.number().int().min(1).describe("Refund amount in cents (e.g. 1000 = $10.00)")
     }),
     handler: async (input) => {
       return apiPost(`/orders/${input.orderId}/refund`, {
@@ -21982,7 +22007,7 @@ var priceTools = [
   },
   {
     name: "ls_list_prices",
-    description: "List all prices, optionally filtered by variant.",
+    description: "List all prices, optionally filtered by variant. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List prices",
       readOnlyHint: true,
@@ -21993,8 +22018,8 @@ var priceTools = [
     inputSchema: external_exports.object({
       variantId: external_exports.string().optional().describe("Filter by variant ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'variant')"),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -22032,7 +22057,7 @@ var productTools = [
   },
   {
     name: "ls_list_products",
-    description: "List all products, optionally filtered by store.",
+    description: "List all products, optionally filtered by store. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List products",
       readOnlyHint: true,
@@ -22043,8 +22068,8 @@ var productTools = [
     inputSchema: external_exports.object({
       storeId: external_exports.string().optional().describe("Filter by store ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'store,variants')"),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -22084,7 +22109,7 @@ var storeTools = [
   },
   {
     name: "ls_list_stores",
-    description: "List all stores for the authenticated user.",
+    description: "List all stores for the authenticated user. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List stores",
       readOnlyHint: true,
@@ -22096,8 +22121,8 @@ var storeTools = [
       include: external_exports.string().optional().describe(
         "Comma-separated related resources to include (e.g. 'products,discounts,license-keys,subscriptions,webhooks')"
       ),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const query = buildQuery({
@@ -22132,7 +22157,7 @@ var subscriptionInvoiceTools = [
   },
   {
     name: "ls_list_subscription_invoices",
-    description: "List all subscription invoices, optionally filtered by store, subscription, or status.",
+    description: "List all subscription invoices, optionally filtered by store, subscription, or status. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List subscription invoices",
       readOnlyHint: true,
@@ -22143,18 +22168,18 @@ var subscriptionInvoiceTools = [
     inputSchema: external_exports.object({
       storeId: external_exports.string().optional().describe("Filter by store ID"),
       subscriptionId: external_exports.string().optional().describe("Filter by subscription ID"),
-      status: external_exports.string().optional().describe("Filter by status (pending, paid, void, refunded)"),
-      refunded: external_exports.string().optional().describe("Filter by refunded status ('true' or 'false')"),
+      status: external_exports.enum(["pending", "paid", "void", "refunded"]).optional().describe("Filter by invoice status"),
+      refunded: external_exports.boolean().optional().describe("Filter by refunded status"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'store,subscription')"),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
       if (input.storeId) filter.store_id = input.storeId;
       if (input.subscriptionId) filter.subscription_id = input.subscriptionId;
       if (input.status) filter.status = input.status;
-      if (input.refunded) filter.refunded = input.refunded;
+      if (input.refunded !== void 0) filter.refunded = String(input.refunded);
       const query = buildQuery({
         include: input.include?.split(","),
         filter,
@@ -22181,18 +22206,21 @@ var subscriptionInvoiceTools = [
       state: external_exports.string().optional().describe("Customer state/region"),
       zipCode: external_exports.string().optional().describe("Customer ZIP/postal code"),
       country: external_exports.string().optional().describe("Customer country"),
-      notes: external_exports.string().optional().describe("Additional notes to include on the invoice")
+      notes: external_exports.string().optional().describe("Additional notes to include on the invoice"),
+      locale: external_exports.string().optional().describe("Invoice language locale (e.g. 'en', 'fr', 'de')")
     }),
     handler: async (input) => {
-      const body = {};
-      if (input.name !== void 0) body.name = input.name;
-      if (input.address !== void 0) body.address = input.address;
-      if (input.city !== void 0) body.city = input.city;
-      if (input.state !== void 0) body.state = input.state;
-      if (input.zipCode !== void 0) body.zip_code = input.zipCode;
-      if (input.country !== void 0) body.country = input.country;
-      if (input.notes !== void 0) body.notes = input.notes;
-      return apiPost(`/subscription-invoices/${input.subscriptionInvoiceId}/generate-invoice`, body);
+      const params = new URLSearchParams();
+      if (input.name !== void 0) params.set("name", input.name);
+      if (input.address !== void 0) params.set("address", input.address);
+      if (input.city !== void 0) params.set("city", input.city);
+      if (input.state !== void 0) params.set("state", input.state);
+      if (input.zipCode !== void 0) params.set("zip_code", input.zipCode);
+      if (input.country !== void 0) params.set("country", input.country);
+      if (input.notes !== void 0) params.set("notes", input.notes);
+      if (input.locale !== void 0) params.set("locale", input.locale);
+      const qs = params.toString();
+      return apiPost(`/subscription-invoices/${input.subscriptionInvoiceId}/generate-invoice${qs ? `?${qs}` : ""}`);
     }
   },
   {
@@ -22207,7 +22235,7 @@ var subscriptionInvoiceTools = [
     },
     inputSchema: external_exports.object({
       subscriptionInvoiceId: external_exports.string().describe("The subscription invoice ID to refund"),
-      amount: external_exports.number().describe("Refund amount in cents (e.g. 1000 = $10.00)")
+      amount: external_exports.number().int().min(1).describe("Refund amount in cents (e.g. 1000 = $10.00)")
     }),
     handler: async (input) => {
       return apiPost(`/subscription-invoices/${input.subscriptionInvoiceId}/refund`, {
@@ -22244,7 +22272,7 @@ var subscriptionItemTools = [
   },
   {
     name: "ls_list_subscription_items",
-    description: "List all subscription items, optionally filtered by subscription or price.",
+    description: "List all subscription items, optionally filtered by subscription or price. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List subscription items",
       readOnlyHint: true,
@@ -22256,8 +22284,8 @@ var subscriptionItemTools = [
       subscriptionId: external_exports.string().optional().describe("Filter by subscription ID"),
       priceId: external_exports.string().optional().describe("Filter by price ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'subscription,price,usage-records')"),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -22283,7 +22311,7 @@ var subscriptionItemTools = [
     },
     inputSchema: external_exports.object({
       subscriptionItemId: external_exports.string().describe("The subscription item ID to update"),
-      quantity: external_exports.number().describe("New quantity for the subscription item")
+      quantity: external_exports.number().int().min(1).describe("New quantity for the subscription item")
     }),
     handler: async (input) => {
       return apiPatch(`/subscription-items/${input.subscriptionItemId}`, {
@@ -22339,7 +22367,7 @@ var subscriptionTools = [
   },
   {
     name: "ls_list_subscriptions",
-    description: "List all subscriptions, optionally filtered by store, order, product, variant, or status.",
+    description: "List all subscriptions, optionally filtered by store, order, product, variant, or status. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List subscriptions",
       readOnlyHint: true,
@@ -22354,12 +22382,12 @@ var subscriptionTools = [
       productId: external_exports.string().optional().describe("Filter by product ID"),
       variantId: external_exports.string().optional().describe("Filter by variant ID"),
       userEmail: external_exports.string().optional().describe("Filter by user email"),
-      status: external_exports.string().optional().describe("Filter by status (on_trial, active, paused, past_due, unpaid, cancelled, expired)"),
+      status: external_exports.enum(["on_trial", "active", "paused", "past_due", "unpaid", "cancelled", "expired"]).optional().describe("Filter by subscription status"),
       include: external_exports.string().optional().describe(
         "Comma-separated related resources to include (e.g. 'store,customer,order,order-item,product,variant')"
       ),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -22390,18 +22418,20 @@ var subscriptionTools = [
     },
     inputSchema: external_exports.object({
       subscriptionId: external_exports.string().describe("The subscription ID to update"),
-      variantId: external_exports.number().optional().describe("New variant ID for plan switching"),
-      pause: external_exports.string().optional().describe("Pause mode: 'void' (pause immediately, no invoice) or 'free' (pause immediately, no charge)"),
-      cancelled: external_exports.boolean().optional().describe("Set to false to resume a cancelled subscription (before it expires)"),
-      billingAnchor: external_exports.number().optional().describe("Day of month (1-28) to anchor billing to"),
+      variantId: external_exports.string().optional().describe("New variant ID for plan switching"),
+      pause: external_exports.enum(["void", "free", "resume"]).optional().describe("Pause mode: 'void' (pause, skip billing), 'free' (pause, keep access free), or 'resume' to unpause"),
+      cancelled: external_exports.literal(false).optional().describe(
+        "Set to false to un-cancel a subscription before it expires. To cancel, use ls_cancel_subscription instead."
+      ),
+      billingAnchor: external_exports.number().int().min(1).max(28).optional().describe("Day of month (1-28) to anchor billing to"),
       invoiceImmediately: external_exports.boolean().optional().describe("If true, invoice immediately when updating (default false for prorated changes)"),
       disableProrations: external_exports.boolean().optional().describe("If true, disable prorations when changing plans"),
       trialEndsAt: external_exports.string().optional().describe("Set trial end date (ISO 8601 format). Set to null to end trial immediately.")
     }),
     handler: async (input) => {
       const attributes = {};
-      if (input.variantId !== void 0) attributes.variant_id = input.variantId;
-      if (input.pause !== void 0) attributes.pause = input.pause === "" ? null : { mode: input.pause };
+      if (input.variantId !== void 0) attributes.variant_id = Number(input.variantId);
+      if (input.pause !== void 0) attributes.pause = input.pause === "resume" ? null : { mode: input.pause };
       if (input.cancelled !== void 0) attributes.cancelled = input.cancelled;
       if (input.billingAnchor !== void 0) attributes.billing_anchor = input.billingAnchor;
       if (input.invoiceImmediately !== void 0) attributes.invoice_immediately = input.invoiceImmediately;
@@ -22458,7 +22488,7 @@ var usageRecordTools = [
   },
   {
     name: "ls_list_usage_records",
-    description: "List all usage records, optionally filtered by subscription item.",
+    description: "List all usage records, optionally filtered by subscription item. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List usage records",
       readOnlyHint: true,
@@ -22469,8 +22499,8 @@ var usageRecordTools = [
     inputSchema: external_exports.object({
       subscriptionItemId: external_exports.string().optional().describe("Filter by subscription item ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'subscription-item')"),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -22495,14 +22525,14 @@ var usageRecordTools = [
     },
     inputSchema: external_exports.object({
       subscriptionItemId: external_exports.string().describe("The subscription item ID to report usage for"),
-      quantity: external_exports.number().describe("The usage quantity to report"),
-      action: external_exports.string().optional().describe("How to apply the quantity: 'increment' (add to current, default) or 'set' (replace current)")
+      quantity: external_exports.number().int().min(0).describe("The usage quantity to report"),
+      action: external_exports.enum(["increment", "set"]).optional().describe("How to apply the quantity: 'increment' (add to current, default) or 'set' (replace current)")
     }),
     handler: async (input) => {
       const attributes = {
         quantity: input.quantity
       };
-      if (input.action) attributes.action = input.action;
+      if (input.action !== void 0) attributes.action = input.action;
       return apiPost("/usage-records", {
         data: {
           type: "usage-records",
@@ -22560,7 +22590,7 @@ var variantTools = [
   },
   {
     name: "ls_list_variants",
-    description: "List all variants, optionally filtered by product.",
+    description: "List all variants, optionally filtered by product. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List variants",
       readOnlyHint: true,
@@ -22571,8 +22601,8 @@ var variantTools = [
     inputSchema: external_exports.object({
       productId: external_exports.string().optional().describe("Filter by product ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'product,files')"),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -22610,7 +22640,7 @@ var webhookTools = [
   },
   {
     name: "ls_list_webhooks",
-    description: "List all webhooks, optionally filtered by store.",
+    description: "List all webhooks, optionally filtered by store. Results are paginated \u2014 check meta.page in the response for currentPage, lastPage, and total.",
     annotations: {
       title: "List webhooks",
       readOnlyHint: true,
@@ -22621,8 +22651,8 @@ var webhookTools = [
     inputSchema: external_exports.object({
       storeId: external_exports.string().optional().describe("Filter by store ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'store')"),
-      pageNumber: external_exports.number().optional().describe("Page number (1-indexed)"),
-      pageSize: external_exports.number().optional().describe("Results per page (1-100)")
+      pageNumber: external_exports.number().int().min(1).optional().describe("Page number (1-indexed)"),
+      pageSize: external_exports.number().int().min(1).max(100).optional().describe("Results per page (1-100)")
     }),
     handler: async (input) => {
       const filter = {};
@@ -22651,7 +22681,7 @@ var webhookTools = [
       events: external_exports.array(external_exports.string()).describe(
         "Event types to subscribe to (e.g. ['order_created', 'subscription_created', 'subscription_updated', 'subscription_cancelled', 'subscription_payment_success', 'subscription_payment_failed', 'license_key_created'])"
       ),
-      secret: external_exports.string().describe("A signing secret for verifying webhook payloads (min 6, max 40 characters)")
+      secret: external_exports.string().min(6).max(40).describe("A signing secret for verifying webhook payloads")
     }),
     handler: async (input) => {
       return apiPost("/webhooks", {
@@ -22719,7 +22749,7 @@ var webhookTools = [
 ];
 
 // src/index.ts
-var version2 = true ? "0.1.1" : (await null).createRequire(import.meta.url)("../package.json").version;
+var version2 = true ? "0.2.0" : (await null).createRequire(import.meta.url)("../package.json").version;
 var subcommand = process.argv[2];
 if (subcommand === "version" || subcommand === "--version") {
   console.log(version2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yawlabs/lemonsqueezy-mcp",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "LemonSqueezy MCP server for managing your store from AI assistants",
   "license": "MIT",
   "author": "YawLabs <contact@yaw.sh>",