@yawlabs/lemonsqueezy-mcp 0.1.1 → 0.2.1

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,17 +21055,30 @@ 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") {
+  if (res.status === 204) {
     return { ok: true, status: res.status };
   }
   const data = await res.json();
@@ -21073,22 +21086,61 @@ 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.errors?.[0]?.detail ?? parsed.error ?? errorBody
+      };
+    } catch {
+      return { ok: false, status: res.status, error: errorBody };
+    }
   }
   const data = await res.json();
   return { ok: true, status: res.status, data };
 }
+function getHandler(endpoint, idField) {
+  return async (input) => {
+    const query = buildQuery({ include: input.include?.split(",") });
+    return apiGet(`${endpoint}/${input[idField]}${query}`);
+  };
+}
+function listHandler(endpoint, filterMap = {}) {
+  return async (input) => {
+    const filter = {};
+    for (const [inputKey, apiKey] of Object.entries(filterMap)) {
+      const val = input[inputKey];
+      if (val !== void 0) filter[apiKey] = String(val);
+    }
+    const query = buildQuery({
+      include: input.include?.split(","),
+      filter,
+      page: { number: input.pageNumber, size: input.pageSize }
+    });
+    return apiGet(`${endpoint}${query}`);
+  };
+}
 async function apiGet(path) {
   return apiRequest("GET", path);
 }
@@ -21118,14 +21170,11 @@ var checkoutTools = [
       checkoutId: external_exports.string().describe("The checkout ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'store,variant')")
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/checkouts/${input.checkoutId}${query}`);
-    }
+    handler: getHandler("/checkouts", "checkoutId")
   },
   {
     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,20 +21186,10 @@ 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 = {};
-      if (input.storeId) filter.store_id = input.storeId;
-      if (input.variantId) filter.variant_id = input.variantId;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/checkouts${query}`);
-    }
+    handler: listHandler("/checkouts", { storeId: "store_id", variantId: "variant_id" })
   },
   {
     name: "ls_create_checkout",
@@ -21165,21 +21204,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 +21234,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", {
@@ -21232,14 +21267,11 @@ var customerTools = [
       customerId: external_exports.string().describe("The customer ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'store,orders,subscriptions,license-keys')")
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/customers/${input.customerId}${query}`);
-    }
+    handler: getHandler("/customers", "customerId")
   },
   {
     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,20 +21283,10 @@ 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 = {};
-      if (input.storeId) filter.store_id = input.storeId;
-      if (input.email) filter.email = input.email;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/customers${query}`);
-    }
+    handler: listHandler("/customers", { storeId: "store_id", email: "email" })
   },
   {
     name: "ls_create_customer",
@@ -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",
@@ -21380,14 +21402,11 @@ var discountRedemptionTools = [
       discountRedemptionId: external_exports.string().describe("The discount redemption ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'discount,order')")
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/discount-redemptions/${input.discountRedemptionId}${query}`);
-    }
+    handler: getHandler("/discount-redemptions", "discountRedemptionId")
   },
   {
     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,20 +21418,10 @@ 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 = {};
-      if (input.discountId) filter.discount_id = input.discountId;
-      if (input.orderId) filter.order_id = input.orderId;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/discount-redemptions${query}`);
-    }
+    handler: listHandler("/discount-redemptions", { discountId: "discount_id", orderId: "order_id" })
   }
 ];
 
@@ -21432,14 +21441,11 @@ var discountTools = [
       discountId: external_exports.string().describe("The discount ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'store,variants,discount-redemptions')")
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/discounts/${input.discountId}${query}`);
-    }
+    handler: getHandler("/discounts", "discountId")
   },
   {
     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,19 +21456,10 @@ 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 = {};
-      if (input.storeId) filter.store_id = input.storeId;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/discounts${query}`);
-    }
+    handler: listHandler("/discounts", { storeId: "store_id" })
   },
   {
     name: "ls_create_discount",
@@ -21478,19 +21475,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 +21507,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", {
@@ -21557,14 +21554,11 @@ var fileTools = [
       fileId: external_exports.string().describe("The file ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'variant')")
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/files/${input.fileId}${query}`);
-    }
+    handler: getHandler("/files", "fileId")
   },
   {
     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,19 +21569,10 @@ 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 = {};
-      if (input.variantId) filter.variant_id = input.variantId;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/files${query}`);
-    }
+    handler: listHandler("/files", { variantId: "variant_id" })
   }
 ];
 
@@ -21607,14 +21592,11 @@ var licenseKeyInstanceTools = [
       licenseKeyInstanceId: external_exports.string().describe("The license key instance ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'license-key')")
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/license-key-instances/${input.licenseKeyInstanceId}${query}`);
-    }
+    handler: getHandler("/license-key-instances", "licenseKeyInstanceId")
   },
   {
     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,19 +21607,10 @@ 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 = {};
-      if (input.licenseKeyId) filter.license_key_id = input.licenseKeyId;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/license-key-instances${query}`);
-    }
+    handler: listHandler("/license-key-instances", { licenseKeyId: "license_key_id" })
   }
 ];
 
@@ -21659,14 +21632,11 @@ var licenseKeyTools = [
         "Comma-separated related resources to include (e.g. 'store,customer,order,order-item,product,license-key-instances')"
       )
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/license-keys/${input.licenseKeyId}${query}`);
-    }
+    handler: getHandler("/license-keys", "licenseKeyId")
   },
   {
     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,22 +21652,15 @@ 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 = {};
-      if (input.storeId) filter.store_id = input.storeId;
-      if (input.orderId) filter.order_id = input.orderId;
-      if (input.orderItemId) filter.order_item_id = input.orderItemId;
-      if (input.productId) filter.product_id = input.productId;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/license-keys${query}`);
-    }
+    handler: listHandler("/license-keys", {
+      storeId: "store_id",
+      orderId: "order_id",
+      orderItemId: "order_item_id",
+      productId: "product_id"
+    })
   },
   {
     name: "ls_update_license_key",
@@ -21711,7 +21674,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 +21733,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);
     }
   },
@@ -21813,14 +21776,11 @@ var orderItemTools = [
       orderItemId: external_exports.string().describe("The order item ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'order,product,variant')")
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/order-items/${input.orderItemId}${query}`);
-    }
+    handler: getHandler("/order-items", "orderItemId")
   },
   {
     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,21 +21793,10 @@ 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 = {};
-      if (input.orderId) filter.order_id = input.orderId;
-      if (input.productId) filter.product_id = input.productId;
-      if (input.variantId) filter.variant_id = input.variantId;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/order-items${query}`);
-    }
+    handler: listHandler("/order-items", { orderId: "order_id", productId: "product_id", variantId: "variant_id" })
   }
 ];
 
@@ -21869,14 +21818,11 @@ var orderTools = [
         "Comma-separated related resources to include (e.g. 'store,customer,order-items,subscriptions,license-keys,discount-redemptions')"
       )
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/orders/${input.orderId}${query}`);
-    }
+    handler: getHandler("/orders", "orderId")
   },
   {
     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,20 +21836,10 @@ 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 = {};
-      if (input.storeId) filter.store_id = input.storeId;
-      if (input.userEmail) filter.user_email = input.userEmail;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/orders${query}`);
-    }
+    handler: listHandler("/orders", { storeId: "store_id", userEmail: "user_email" })
   },
   {
     name: "ls_generate_order_invoice",
@@ -21923,18 +21859,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 +21888,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`, {
@@ -21975,14 +21914,11 @@ var priceTools = [
       priceId: external_exports.string().describe("The price ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'variant')")
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/prices/${input.priceId}${query}`);
-    }
+    handler: getHandler("/prices", "priceId")
   },
   {
     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,19 +21929,10 @@ 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 = {};
-      if (input.variantId) filter.variant_id = input.variantId;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/prices${query}`);
-    }
+    handler: listHandler("/prices", { variantId: "variant_id" })
   }
 ];
 
@@ -22025,14 +21952,11 @@ var productTools = [
       productId: external_exports.string().describe("The product ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'store,variants')")
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/products/${input.productId}${query}`);
-    }
+    handler: getHandler("/products", "productId")
   },
   {
     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,19 +21967,10 @@ 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 = {};
-      if (input.storeId) filter.store_id = input.storeId;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/products${query}`);
-    }
+    handler: listHandler("/products", { storeId: "store_id" })
   }
 ];
 
@@ -22077,14 +21992,11 @@ var storeTools = [
         "Comma-separated related resources to include (e.g. 'products,discounts,license-keys,subscriptions,webhooks')"
       )
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/stores/${input.storeId}${query}`);
-    }
+    handler: getHandler("/stores", "storeId")
   },
   {
     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,16 +22008,10 @@ 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({
-        include: input.include?.split(","),
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/stores${query}`);
-    }
+    handler: listHandler("/stores")
   }
 ];
 
@@ -22125,14 +22031,11 @@ var subscriptionInvoiceTools = [
       subscriptionInvoiceId: external_exports.string().describe("The subscription invoice ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'store,subscription')")
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/subscription-invoices/${input.subscriptionInvoiceId}${query}`);
-    }
+    handler: getHandler("/subscription-invoices", "subscriptionInvoiceId")
   },
   {
     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,25 +22046,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;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/subscription-invoices${query}`);
-    }
+    handler: listHandler("/subscription-invoices", {
+      storeId: "store_id",
+      subscriptionId: "subscription_id",
+      status: "status",
+      refunded: "refunded"
+    })
   },
   {
     name: "ls_generate_subscription_invoice",
@@ -22181,18 +22077,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 +22106,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`, {
@@ -22237,14 +22136,11 @@ var subscriptionItemTools = [
       subscriptionItemId: external_exports.string().describe("The subscription item ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'subscription,price,usage-records')")
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/subscription-items/${input.subscriptionItemId}${query}`);
-    }
+    handler: getHandler("/subscription-items", "subscriptionItemId")
   },
   {
     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,20 +22152,10 @@ 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 = {};
-      if (input.subscriptionId) filter.subscription_id = input.subscriptionId;
-      if (input.priceId) filter.price_id = input.priceId;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/subscription-items${query}`);
-    }
+    handler: listHandler("/subscription-items", { subscriptionId: "subscription_id", priceId: "price_id" })
   },
   {
     name: "ls_update_subscription_item",
@@ -22283,7 +22169,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}`, {
@@ -22332,14 +22218,11 @@ var subscriptionTools = [
         "Comma-separated related resources to include (e.g. 'store,customer,order,order-item,product,variant,subscription-items,subscription-invoices')"
       )
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/subscriptions/${input.subscriptionId}${query}`);
-    }
+    handler: getHandler("/subscriptions", "subscriptionId")
   },
   {
     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,29 +22237,22 @@ 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 = {};
-      if (input.storeId) filter.store_id = input.storeId;
-      if (input.orderId) filter.order_id = input.orderId;
-      if (input.orderItemId) filter.order_item_id = input.orderItemId;
-      if (input.productId) filter.product_id = input.productId;
-      if (input.variantId) filter.variant_id = input.variantId;
-      if (input.userEmail) filter.user_email = input.userEmail;
-      if (input.status) filter.status = input.status;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/subscriptions${query}`);
-    }
+    handler: listHandler("/subscriptions", {
+      storeId: "store_id",
+      orderId: "order_id",
+      orderItemId: "order_item_id",
+      productId: "product_id",
+      variantId: "variant_id",
+      userEmail: "user_email",
+      status: "status"
+    })
   },
   {
     name: "ls_update_subscription",
@@ -22390,18 +22266,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;
@@ -22451,14 +22329,11 @@ var usageRecordTools = [
       usageRecordId: external_exports.string().describe("The usage record ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'subscription-item')")
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/usage-records/${input.usageRecordId}${query}`);
-    }
+    handler: getHandler("/usage-records", "usageRecordId")
   },
   {
     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,19 +22344,10 @@ 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 = {};
-      if (input.subscriptionItemId) filter.subscription_item_id = input.subscriptionItemId;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/usage-records${query}`);
-    }
+    handler: listHandler("/usage-records", { subscriptionItemId: "subscription_item_id" })
   },
   {
     name: "ls_create_usage_record",
@@ -22495,14 +22361,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",
@@ -22553,14 +22419,11 @@ var variantTools = [
       variantId: external_exports.string().describe("The variant ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'product,files')")
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/variants/${input.variantId}${query}`);
-    }
+    handler: getHandler("/variants", "variantId")
   },
   {
     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,19 +22434,10 @@ 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 = {};
-      if (input.productId) filter.product_id = input.productId;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/variants${query}`);
-    }
+    handler: listHandler("/variants", { productId: "product_id" })
   }
 ];
 
@@ -22603,14 +22457,11 @@ var webhookTools = [
       webhookId: external_exports.string().describe("The webhook ID"),
       include: external_exports.string().optional().describe("Comma-separated related resources to include (e.g. 'store')")
     }),
-    handler: async (input) => {
-      const query = buildQuery({ include: input.include?.split(",") });
-      return apiGet(`/webhooks/${input.webhookId}${query}`);
-    }
+    handler: getHandler("/webhooks", "webhookId")
   },
   {
     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,19 +22472,10 @@ 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 = {};
-      if (input.storeId) filter.store_id = input.storeId;
-      const query = buildQuery({
-        include: input.include?.split(","),
-        filter,
-        page: { number: input.pageNumber, size: input.pageSize }
-      });
-      return apiGet(`/webhooks${query}`);
-    }
+    handler: listHandler("/webhooks", { storeId: "store_id" })
   },
   {
     name: "ls_create_webhook",
@@ -22651,7 +22493,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 +22561,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.1" : (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.1",
   "description": "LemonSqueezy MCP server for managing your store from AI assistants",
   "license": "MIT",
   "author": "YawLabs <contact@yaw.sh>",
@@ -34,7 +34,7 @@
     "test:ci": "npm run test",
     "lint": "biome check src/",
     "lint:fix": "biome check --write src/",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build && node --test dist/**/*.test.js"
   },
   "dependencies": {},
   "devDependencies": {