@open-loyalty/mcp-server 1.5.3 → 1.7.0

package/dist/tools/wallet-type/index.d.ts

@@ -6,6 +6,7 @@ export declare const walletTypeToolDefinitions: readonly [{
     readonly title: "List Point Currencies";
     readonly description: string;
     readonly readOnly: true;
+    readonly idempotent: true;
     readonly inputSchema: {
         storeCode: import("zod").ZodOptional<import("zod").ZodString>;
     };
@@ -15,6 +16,7 @@ export declare const walletTypeToolDefinitions: readonly [{
     readonly title: "Get Point Currency Details";
     readonly description: string;
     readonly readOnly: true;
+    readonly idempotent: true;
     readonly inputSchema: {
         storeCode: import("zod").ZodOptional<import("zod").ZodString>;
         walletTypeId: import("zod").ZodString;
@@ -25,6 +27,7 @@ export declare const walletTypeToolDefinitions: readonly [{
     readonly title: "Create Point Currency";
     readonly description: string;
     readonly readOnly: false;
+    readonly idempotent: false;
     readonly inputSchema: {
         storeCode: import("zod").ZodOptional<import("zod").ZodString>;
         translations: import("zod").ZodObject<{
@@ -76,6 +79,7 @@ export declare const walletTypeToolDefinitions: readonly [{
 }, {
     readonly name: "ol_wallet_type_update";
     readonly title: "Update Point Currency";
+    readonly idempotent: true;
     readonly description: string;
     readonly readOnly: false;
     readonly inputSchema: {

package/dist/tools/wallet-type/index.js

@@ -15,6 +15,7 @@ export const walletTypeToolDefinitions = [
             "(code: 'default', units: points) pre-installed. " +
             "Returns walletTypeId (UUID), code (unique identifier like 'default'), and name for each wallet type.",
         readOnly: true,
+        idempotent: true,
         inputSchema: WalletTypeListInputSchema,
         handler: walletTypeList,
     },
@@ -25,6 +26,7 @@ export const walletTypeToolDefinitions = [
             "Returns configuration including limits, expiry settings, and translations. " +
             "💡 TIP: Use ol_wallet_type_list() first to find the walletTypeId.",
         readOnly: true,
+        idempotent: true,
         inputSchema: WalletTypeGetInputSchema,
         handler: walletTypeGet,
     },
@@ -36,16 +38,18 @@ export const walletTypeToolDefinitions = [
             "1. Point expiration -- 'all_time_active' (never expire, growing financial liability) vs '365' (standard 1-year) vs annual date? " +
             "2. Pending period -- allTimeNotLocked=true (immediate, no fraud protection) vs false + unitDaysLocked (fraud/return protection)? " +
             "3. Negative balance -- allow members to go below zero? (credit risk, default: no) " +
-            "REQUIRED: translations.en.name, unitSingularName, unitPluralName, unitDaysExpiryAfter. " +
+            "REQUIRED: translations.en.name, unitSingularName, unitPluralName, unitDaysExpiryAfter (STRING value -- '365' not 365, or 'all_time_active' for no expiry). " +
             "NOTE: 'active' and 'limits' not supported at creation -- use ol_wallet_type_update. " +
             "New wallets are blocked for ~2 minutes after creation.",
         readOnly: false,
+        idempotent: false,
         inputSchema: WalletTypeCreateInputSchema,
         handler: walletTypeCreate,
     },
     {
         name: "ol_wallet_type_update",
         title: "Update Point Currency",
+        idempotent: true,
         description: "Update an existing wallet type's configuration. " +
             "⚠️ IMPORTANT: Only provide fields you want to change - others are preserved. " +
             "⚠️ CANNOT CHANGE: The 'code' field cannot be modified after creation. " +

package/dist/tools/webhook/handlers.d.ts

@@ -0,0 +1,34 @@
+import type { WebhookHeader, WebhookSubscription, WebhookSubscriptionListResponse, WebhookEventTypesResponse } from "./schemas.js";
+export declare function webhookList(input: {
+    storeCode?: string;
+    page?: number;
+    perPage?: number;
+    eventName?: string;
+    url?: string;
+}): Promise<WebhookSubscriptionListResponse>;
+export declare function webhookCreate(input: {
+    storeCode?: string;
+    eventName: string;
+    url: string;
+    headers?: WebhookHeader[];
+}): Promise<{
+    webhookSubscriptionId: string;
+}>;
+export declare function webhookGet(input: {
+    storeCode?: string;
+    webhookSubscriptionId: string;
+}): Promise<WebhookSubscription>;
+export declare function webhookUpdate(input: {
+    storeCode?: string;
+    webhookSubscriptionId: string;
+    eventName?: string;
+    url?: string;
+    headers?: WebhookHeader[];
+}): Promise<void>;
+export declare function webhookDelete(input: {
+    storeCode?: string;
+    webhookSubscriptionId: string;
+}): Promise<void>;
+export declare function webhookEvents(input: {
+    storeCode?: string;
+}): Promise<WebhookEventTypesResponse>;

package/dist/tools/webhook/handlers.js

@@ -0,0 +1,147 @@
+import { apiGet, apiPost, apiPut, apiDelete } from "../../client/http.js";
+import { formatApiError, OpenLoyaltyError } from "../../utils/errors.js";
+import axios from "axios";
+import { getStoreCode } from "../../config.js";
+export async function webhookList(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    const params = new URLSearchParams();
+    if (input.page)
+        params.append("_page", String(input.page));
+    if (input.perPage)
+        params.append("_itemsOnPage", String(input.perPage));
+    if (input.eventName)
+        params.append("eventName", input.eventName);
+    if (input.url)
+        params.append("url", input.url);
+    const queryString = params.toString();
+    const url = `/${storeCode}/webhook/subscription${queryString ? `?${queryString}` : ""}`;
+    try {
+        const response = await apiGet(url);
+        return response;
+    }
+    catch (error) {
+        if (axios.isAxiosError(error) && error.response?.status === 404) {
+            throw new OpenLoyaltyError({
+                code: "STORE_NOT_FOUND",
+                message: "No webhook subscriptions found for this store",
+                hint: "Use ol_store_list() to verify the store code is correct.",
+                relatedTool: "ol_webhook_list",
+            });
+        }
+        if (axios.isAxiosError(error) && error.response?.status === 403) {
+            throw new OpenLoyaltyError({
+                code: "WEBHOOK_PERMISSION_DENIED",
+                message: "You don't have permission to view webhook subscriptions",
+                hint: "Webhook management requires the WEBHOOK:VIEW permission. Use ol_admin_get_permissions() to check your access.",
+                relatedTool: "ol_webhook_list",
+            });
+        }
+        throw formatApiError(error, "ol_webhook_list");
+    }
+}
+export async function webhookCreate(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    const payload = {
+        eventName: input.eventName,
+        url: input.url,
+    };
+    if (input.headers) {
+        payload.headers = input.headers;
+    }
+    try {
+        const response = await apiPost(`/${storeCode}/webhook/subscription`, { webhookSubscription: payload });
+        return response;
+    }
+    catch (error) {
+        if (axios.isAxiosError(error) && error.response?.status === 400) {
+            const allMessages = [error.response?.data?.message || "", ...(error.response?.data?.errors || []).map((e) => e.message)].join(" ").toLowerCase();
+            if (allMessages.includes("event") && (allMessages.includes("invalid") || allMessages.includes("choice") || allMessages.includes("not found"))) {
+                throw new OpenLoyaltyError({ code: "INVALID_EVENT_NAME", message: `Event name '${input.eventName}' is not valid`,
+                    hint: "Use ol_webhook_events() to discover available event types before creating subscriptions.", relatedTool: "ol_webhook_create" });
+            }
+        }
+        throw formatApiError(error, "ol_webhook_create");
+    }
+}
+export async function webhookGet(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    try {
+        const response = await apiGet(`/${storeCode}/webhook/subscription/${input.webhookSubscriptionId}`);
+        return response;
+    }
+    catch (error) {
+        if (axios.isAxiosError(error) && error.response?.status === 404) {
+            throw new OpenLoyaltyError({ code: "NOT_FOUND", message: `Webhook subscription '${input.webhookSubscriptionId}' not found`,
+                hint: "Use ol_webhook_list() to find existing webhook subscriptions and their IDs.", relatedTool: "ol_webhook_get" });
+        }
+        throw formatApiError(error, "ol_webhook_get");
+    }
+}
+export async function webhookUpdate(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    const payload = {};
+    if (input.eventName)
+        payload.eventName = input.eventName;
+    if (input.url)
+        payload.url = input.url;
+    if (input.headers)
+        payload.headers = input.headers;
+    try {
+        await apiPut(`/${storeCode}/webhook/subscription/${input.webhookSubscriptionId}`, { webhookSubscription: payload });
+    }
+    catch (error) {
+        if (axios.isAxiosError(error)) {
+            if (error.response?.status === 404) {
+                throw new OpenLoyaltyError({ code: "NOT_FOUND", message: `Webhook subscription '${input.webhookSubscriptionId}' not found`,
+                    hint: "Use ol_webhook_list() to find existing webhook subscriptions and their IDs.", relatedTool: "ol_webhook_update" });
+            }
+            if (error.response?.status === 400) {
+                const allMessages = [error.response?.data?.message || "", ...(error.response?.data?.errors || []).map((e) => e.message)].join(" ").toLowerCase();
+                if (allMessages.includes("event") && (allMessages.includes("invalid") || allMessages.includes("choice"))) {
+                    throw new OpenLoyaltyError({ code: "INVALID_EVENT_NAME", message: `Event name '${input.eventName}' is not valid`,
+                        hint: "Use ol_webhook_events() to discover available event types.", relatedTool: "ol_webhook_update" });
+                }
+            }
+        }
+        throw formatApiError(error, "ol_webhook_update");
+    }
+}
+export async function webhookDelete(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    try {
+        await apiDelete(`/${storeCode}/webhook/subscription/${input.webhookSubscriptionId}`);
+    }
+    catch (error) {
+        if (axios.isAxiosError(error) && error.response?.status === 404) {
+            throw new OpenLoyaltyError({ code: "NOT_FOUND", message: `Webhook subscription '${input.webhookSubscriptionId}' not found`,
+                hint: "Use ol_webhook_list() to find existing webhook subscriptions and their IDs.", relatedTool: "ol_webhook_delete" });
+        }
+        throw formatApiError(error, "ol_webhook_delete");
+    }
+}
+export async function webhookEvents(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    try {
+        const response = await apiGet(`/${storeCode}/webhook/event`);
+        return response;
+    }
+    catch (error) {
+        if (axios.isAxiosError(error) && error.response?.status === 404) {
+            throw new OpenLoyaltyError({
+                code: "STORE_NOT_FOUND",
+                message: "Cannot retrieve webhook events - store not found",
+                hint: "Use ol_store_list() to verify the store code is correct.",
+                relatedTool: "ol_webhook_events",
+            });
+        }
+        if (axios.isAxiosError(error) && error.response?.status === 403) {
+            throw new OpenLoyaltyError({
+                code: "WEBHOOK_PERMISSION_DENIED",
+                message: "You don't have permission to view webhook events",
+                hint: "Webhook management requires the WEBHOOK:VIEW permission. Use ol_admin_get_permissions() to check your access.",
+                relatedTool: "ol_webhook_events",
+            });
+        }
+        throw formatApiError(error, "ol_webhook_events");
+    }
+}

package/dist/tools/webhook/index.d.ts

@@ -0,0 +1,97 @@
+export { WebhookListInputSchema, WebhookCreateInputSchema, WebhookGetInputSchema, WebhookUpdateInputSchema, WebhookDeleteInputSchema, WebhookEventsInputSchema, } from "./schemas.js";
+export type { WebhookHeader, WebhookSubscription, WebhookSubscriptionListResponse, WebhookEventTypesResponse, } from "./schemas.js";
+export { webhookList, webhookCreate, webhookGet, webhookUpdate, webhookDelete, webhookEvents, } from "./handlers.js";
+import { webhookList, webhookCreate, webhookGet, webhookUpdate, webhookDelete, webhookEvents } from "./handlers.js";
+export declare const webhookToolDefinitions: readonly [{
+    readonly name: "ol_webhook_list";
+    readonly title: "List Webhook Subscriptions";
+    readonly description: "List webhook subscriptions with optional filtering. Returns paginated list of subscriptions with webhookSubscriptionId, eventName, url, and createdAt.";
+    readonly readOnly: true;
+    readonly idempotent: true;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        page: import("zod").ZodOptional<import("zod").ZodNumber>;
+        perPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+        eventName: import("zod").ZodOptional<import("zod").ZodString>;
+        url: import("zod").ZodOptional<import("zod").ZodString>;
+    };
+    readonly handler: typeof webhookList;
+}, {
+    readonly name: "ol_webhook_create";
+    readonly title: "Create Webhook Subscription";
+    readonly description: "Create a new webhook subscription to receive event notifications. Returns webhookSubscriptionId on success. Use webhook_events to discover available event types before creating subscriptions.";
+    readonly readOnly: false;
+    readonly idempotent: false;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        eventName: import("zod").ZodString;
+        url: import("zod").ZodEffects<import("zod").ZodString, string, string>;
+        headers: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            headerName: import("zod").ZodString;
+            headerValue: import("zod").ZodString;
+        }, "strip", import("zod").ZodTypeAny, {
+            headerName: string;
+            headerValue: string;
+        }, {
+            headerName: string;
+            headerValue: string;
+        }>, "many">>;
+    };
+    readonly handler: typeof webhookCreate;
+}, {
+    readonly name: "ol_webhook_get";
+    readonly title: "Get Webhook Subscription Details";
+    readonly description: "Get full webhook subscription details including headers configuration.";
+    readonly readOnly: true;
+    readonly idempotent: true;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        webhookSubscriptionId: import("zod").ZodString;
+    };
+    readonly handler: typeof webhookGet;
+}, {
+    readonly name: "ol_webhook_update";
+    readonly title: "Update Webhook Subscription";
+    readonly description: "Update a webhook subscription. Can update eventName, url, and headers. Returns void on success (204 No Content).";
+    readonly readOnly: false;
+    readonly idempotent: true;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        webhookSubscriptionId: import("zod").ZodString;
+        eventName: import("zod").ZodOptional<import("zod").ZodString>;
+        url: import("zod").ZodOptional<import("zod").ZodEffects<import("zod").ZodString, string, string>>;
+        headers: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            headerName: import("zod").ZodString;
+            headerValue: import("zod").ZodString;
+        }, "strip", import("zod").ZodTypeAny, {
+            headerName: string;
+            headerValue: string;
+        }, {
+            headerName: string;
+            headerValue: string;
+        }>, "many">>;
+    };
+    readonly handler: typeof webhookUpdate;
+}, {
+    readonly name: "ol_webhook_delete";
+    readonly title: "Delete Webhook Subscription (Permanent)";
+    readonly description: "Delete a webhook subscription. Returns void on success (204 No Content). The subscription will stop receiving events immediately.";
+    readonly readOnly: false;
+    readonly destructive: true;
+    readonly idempotent: true;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        webhookSubscriptionId: import("zod").ZodString;
+    };
+    readonly handler: typeof webhookDelete;
+}, {
+    readonly name: "ol_webhook_events";
+    readonly title: "List Available Webhook Events";
+    readonly description: "Get available webhook event types. Returns list of event names that can be used when creating webhook subscriptions. Use this to discover available events before creating subscriptions.";
+    readonly readOnly: true;
+    readonly idempotent: true;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+    };
+    readonly handler: typeof webhookEvents;
+}];

package/dist/tools/webhook/index.js

@@ -0,0 +1,65 @@
+// Re-export schemas and types
+export { WebhookListInputSchema, WebhookCreateInputSchema, WebhookGetInputSchema, WebhookUpdateInputSchema, WebhookDeleteInputSchema, WebhookEventsInputSchema, } from "./schemas.js";
+// Re-export handlers
+export { webhookList, webhookCreate, webhookGet, webhookUpdate, webhookDelete, webhookEvents, } from "./handlers.js";
+// Imports for tool definitions
+import { WebhookListInputSchema, WebhookCreateInputSchema, WebhookGetInputSchema, WebhookUpdateInputSchema, WebhookDeleteInputSchema, WebhookEventsInputSchema, } from "./schemas.js";
+import { webhookList, webhookCreate, webhookGet, webhookUpdate, webhookDelete, webhookEvents, } from "./handlers.js";
+// Tool definitions
+export const webhookToolDefinitions = [
+    {
+        name: "ol_webhook_list",
+        title: "List Webhook Subscriptions",
+        description: "List webhook subscriptions with optional filtering. Returns paginated list of subscriptions with webhookSubscriptionId, eventName, url, and createdAt.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: WebhookListInputSchema,
+        handler: webhookList,
+    },
+    {
+        name: "ol_webhook_create",
+        title: "Create Webhook Subscription",
+        description: "Create a new webhook subscription to receive event notifications. Returns webhookSubscriptionId on success. Use webhook_events to discover available event types before creating subscriptions.",
+        readOnly: false,
+        idempotent: false,
+        inputSchema: WebhookCreateInputSchema,
+        handler: webhookCreate,
+    },
+    {
+        name: "ol_webhook_get",
+        title: "Get Webhook Subscription Details",
+        description: "Get full webhook subscription details including headers configuration.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: WebhookGetInputSchema,
+        handler: webhookGet,
+    },
+    {
+        name: "ol_webhook_update",
+        title: "Update Webhook Subscription",
+        description: "Update a webhook subscription. Can update eventName, url, and headers. Returns void on success (204 No Content).",
+        readOnly: false,
+        idempotent: true,
+        inputSchema: WebhookUpdateInputSchema,
+        handler: webhookUpdate,
+    },
+    {
+        name: "ol_webhook_delete",
+        title: "Delete Webhook Subscription (Permanent)",
+        description: "Delete a webhook subscription. Returns void on success (204 No Content). The subscription will stop receiving events immediately.",
+        readOnly: false,
+        destructive: true,
+        idempotent: true,
+        inputSchema: WebhookDeleteInputSchema,
+        handler: webhookDelete,
+    },
+    {
+        name: "ol_webhook_events",
+        title: "List Available Webhook Events",
+        description: "Get available webhook event types. Returns list of event names that can be used when creating webhook subscriptions. Use this to discover available events before creating subscriptions.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: WebhookEventsInputSchema,
+        handler: webhookEvents,
+    },
+];

package/dist/tools/webhook/schemas.d.ts

@@ -0,0 +1,72 @@
+import { z } from "zod";
+export interface WebhookHeader {
+    headerName: string;
+    headerValue: string;
+}
+export interface WebhookSubscription {
+    webhookSubscriptionId: string;
+    eventName: string;
+    url: string;
+    headers?: WebhookHeader[];
+    createdAt?: string;
+}
+export interface WebhookSubscriptionListResponse {
+    items: WebhookSubscription[];
+    total?: {
+        all?: number | string;
+        filtered?: number | string;
+        estimated?: boolean;
+    };
+}
+export interface WebhookEventTypesResponse {
+    items: string[];
+}
+export declare const WebhookListInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    eventName: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+};
+export declare const WebhookCreateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    eventName: z.ZodString;
+    url: z.ZodEffects<z.ZodString, string, string>;
+    headers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        headerName: z.ZodString;
+        headerValue: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        headerName: string;
+        headerValue: string;
+    }, {
+        headerName: string;
+        headerValue: string;
+    }>, "many">>;
+};
+export declare const WebhookGetInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    webhookSubscriptionId: z.ZodString;
+};
+export declare const WebhookUpdateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    webhookSubscriptionId: z.ZodString;
+    eventName: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    headers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        headerName: z.ZodString;
+        headerValue: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        headerName: string;
+        headerValue: string;
+    }, {
+        headerName: string;
+        headerValue: string;
+    }>, "many">>;
+};
+export declare const WebhookDeleteInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    webhookSubscriptionId: z.ZodString;
+};
+export declare const WebhookEventsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+};

package/dist/tools/{webhook.js → webhook/schemas.js}

@@ -1,8 +1,5 @@
 import { z } from "zod";
 import { isIP } from "net";
-import { apiGet, apiPost, apiPut, apiDelete } from "../client/http.js";
-import { formatApiError } from "../utils/errors.js";
-import { getStoreCode } from "../config.js";
 /**
  * Check if an IP address is private, loopback, link-local, or otherwise internal.
  * Blocks IPv4 and IPv6 private ranges to prevent SSRF attacks.
@@ -97,7 +94,6 @@ function isValidWebhookUrl(url) {
 const webhookUrlSchema = z.string()
     .url("Must be a valid URL")
     .refine(isValidWebhookUrl, "URL must be an external HTTPS endpoint (no localhost, private IPs, or metadata endpoints)");
-// Input Schemas
 export const WebhookListInputSchema = {
     storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     page: z.number().optional().describe("Page number (default: 1)."),
@@ -135,139 +131,3 @@ export const WebhookDeleteInputSchema = {
 export const WebhookEventsInputSchema = {
     storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
 };
-// Handler functions
-export async function webhookList(input) {
-    const storeCode = getStoreCode(input.storeCode);
-    const params = new URLSearchParams();
-    if (input.page)
-        params.append("_page", String(input.page));
-    if (input.perPage)
-        params.append("_itemsOnPage", String(input.perPage));
-    if (input.eventName)
-        params.append("eventName", input.eventName);
-    if (input.url)
-        params.append("url", input.url);
-    const queryString = params.toString();
-    const url = `/${storeCode}/webhook/subscription${queryString ? `?${queryString}` : ""}`;
-    try {
-        const response = await apiGet(url);
-        return response;
-    }
-    catch (error) {
-        throw formatApiError(error, "ol_webhook_list");
-    }
-}
-export async function webhookCreate(input) {
-    const storeCode = getStoreCode(input.storeCode);
-    const payload = {
-        eventName: input.eventName,
-        url: input.url,
-    };
-    if (input.headers) {
-        payload.headers = input.headers;
-    }
-    try {
-        const response = await apiPost(`/${storeCode}/webhook/subscription`, { webhookSubscription: payload });
-        return response;
-    }
-    catch (error) {
-        throw formatApiError(error, "ol_webhook_create");
-    }
-}
-export async function webhookGet(input) {
-    const storeCode = getStoreCode(input.storeCode);
-    try {
-        const response = await apiGet(`/${storeCode}/webhook/subscription/${input.webhookSubscriptionId}`);
-        return response;
-    }
-    catch (error) {
-        throw formatApiError(error, "ol_webhook_get");
-    }
-}
-export async function webhookUpdate(input) {
-    const storeCode = getStoreCode(input.storeCode);
-    const payload = {};
-    if (input.eventName)
-        payload.eventName = input.eventName;
-    if (input.url)
-        payload.url = input.url;
-    if (input.headers)
-        payload.headers = input.headers;
-    try {
-        await apiPut(`/${storeCode}/webhook/subscription/${input.webhookSubscriptionId}`, { webhookSubscription: payload });
-    }
-    catch (error) {
-        throw formatApiError(error, "ol_webhook_update");
-    }
-}
-export async function webhookDelete(input) {
-    const storeCode = getStoreCode(input.storeCode);
-    try {
-        await apiDelete(`/${storeCode}/webhook/subscription/${input.webhookSubscriptionId}`);
-    }
-    catch (error) {
-        throw formatApiError(error, "ol_webhook_delete");
-    }
-}
-export async function webhookEvents(input) {
-    const storeCode = getStoreCode(input.storeCode);
-    try {
-        const response = await apiGet(`/${storeCode}/webhook/event`);
-        return response;
-    }
-    catch (error) {
-        throw formatApiError(error, "ol_webhook_events");
-    }
-}
-// Tool definitions
-export const webhookToolDefinitions = [
-    {
-        name: "ol_webhook_list",
-        title: "List Webhook Subscriptions",
-        description: "List webhook subscriptions with optional filtering. Returns paginated list of subscriptions with webhookSubscriptionId, eventName, url, and createdAt.",
-        readOnly: true,
-        inputSchema: WebhookListInputSchema,
-        handler: webhookList,
-    },
-    {
-        name: "ol_webhook_create",
-        title: "Create Webhook Subscription",
-        description: "Create a new webhook subscription to receive event notifications. Returns webhookSubscriptionId on success. Use webhook_events to discover available event types before creating subscriptions.",
-        readOnly: false,
-        inputSchema: WebhookCreateInputSchema,
-        handler: webhookCreate,
-    },
-    {
-        name: "ol_webhook_get",
-        title: "Get Webhook Subscription Details",
-        description: "Get full webhook subscription details including headers configuration.",
-        readOnly: true,
-        inputSchema: WebhookGetInputSchema,
-        handler: webhookGet,
-    },
-    {
-        name: "ol_webhook_update",
-        title: "Update Webhook Subscription",
-        description: "Update a webhook subscription. Can update eventName, url, and headers. Returns void on success (204 No Content).",
-        readOnly: false,
-        inputSchema: WebhookUpdateInputSchema,
-        handler: webhookUpdate,
-    },
-    {
-        name: "ol_webhook_delete",
-        title: "Delete Webhook Subscription (Permanent)",
-        description: "Delete a webhook subscription. Returns void on success (204 No Content). The subscription will stop receiving events immediately.",
-        readOnly: false,
-        destructive: true,
-        inputSchema: WebhookDeleteInputSchema,
-        handler: webhookDelete,
-    },
-    {
-        name: "ol_webhook_events",
-        title: "List Available Webhook Events",
-        description: "Get available webhook event types. Returns list of event names that can be used when creating webhook subscriptions. Use this to discover available events before creating subscriptions.",
-        readOnly: true,
-        inputSchema: WebhookEventsInputSchema,
-        handler: webhookEvents,
-    },
-];

package/dist/types/schemas/tierset.js

@@ -58,4 +58,6 @@ export const TierSetListResponseSchema = z.object({
     items: z.array(TierSetListItemSchema),
     total: TotalSchema,
 });
-export const DowngradeModeEnum = z.enum(["none", "automatic", "x_days"]);
+export const DowngradeModeEnum = z.enum(["none", "automatic", "x_days"]).describe("Downgrade mode: 'none' = members never lose tier status, " +
+    "'automatic' = immediate downgrade when conditions are no longer met, " +
+    "'x_days' = downgrade after a grace period (set days in downgrade.days).");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-loyalty/mcp-server",
-  "version": "1.5.3",
+  "version": "1.7.0",
   "type": "module",
   "description": "MCP server for Open Loyalty API - enables AI agents to manage loyalty programs, members, points, rewards, and transactions",
   "author": "Marcin Dyguda <md@openloyalty.io>",