@open-loyalty/mcp-server 1.0.3 → 1.3.1

package/dist/tools/points.js

@@ -1,11 +1,13 @@
 import { z } from "zod";
 import { apiGet, apiPost } from "../client/http.js";
+import "../types/schemas/points.js";
 import { formatApiError, OpenLoyaltyError } from "../utils/errors.js";
-import { getConfig } from "../config.js";
+import { getStoreCode } from "../config.js";
 import { buildPaginationParams } from "../utils/pagination.js";
+import { omitUndefined } from "../utils/payload.js";
 // Input Schemas
 export const PointsAddInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     memberId: z.string().describe("The member ID (UUID) to add points to."),
     points: z.number().describe("Number of points to add (positive number)."),
     walletCode: z.string().optional().describe("Wallet type code (e.g., 'default'). Uses default wallet if not specified."),
@@ -14,25 +16,25 @@ export const PointsAddInputSchema = {
     lockedUntilDays: z.number().optional().describe("Days until points become available (1-9999)."),
 };
 export const PointsSpendInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     memberId: z.string().describe("The member ID (UUID) to spend points from."),
     points: z.number().describe("Number of points to spend (positive number)."),
     walletCode: z.string().optional().describe("Wallet type code (e.g., 'default'). Uses default wallet if not specified."),
     comment: z.string().optional().describe("Reason for spending points (max 500 chars)."),
 };
 export const PointsTransferInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     senderId: z.string().describe("The sender member ID (UUID)."),
     receiverId: z.string().describe("The receiver member ID (UUID)."),
     points: z.number().describe("Number of points to transfer."),
 };
 export const PointsBalanceInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     memberId: z.string().describe("The member ID (UUID) to get balance for."),
     walletCode: z.string().optional().describe("Wallet type code. Returns all wallets if not specified."),
 };
 export const PointsHistoryInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     memberId: z.string().describe("The member ID (UUID) to get history for."),
     cursor: z.string().optional().describe("Pagination cursor from previous response. If provided, page/perPage are ignored."),
     page: z.number().optional().describe("Page number (default: 1)."),
@@ -40,7 +42,7 @@ export const PointsHistoryInputSchema = {
     type: z.enum(["adding", "spending", "p2p_spending", "p2p_adding", "blocked", "expired"]).optional().describe("Filter by transfer type."),
 };
 export const PointsHistogramInputSchema = {
-    storeCode: z.string().optional().describe("Store code. If not provided, uses the default store code from configuration."),
+    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
     memberId: z.string().describe("The member ID (UUID) to get histogram for."),
     pointType: z.enum(["spent", "earned", "expired", "pending"]).describe("Filter by point type (required). One of: spent, earned, expired, pending."),
     walletCode: z.string().optional().describe("Wallet type code. Uses default if not specified."),
@@ -50,37 +52,29 @@ export const PointsHistogramInputSchema = {
 };
 // Handler functions
 export async function pointsAdd(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
-    const payload = {
+    const storeCode = getStoreCode(input.storeCode);
+    const payload = omitUndefined({
         points: input.points,
-    };
-    if (input.walletCode)
-        payload.walletCode = input.walletCode;
-    if (input.comment)
-        payload.comment = input.comment;
-    if (input.expiresInDays)
-        payload.expiresInDays = input.expiresInDays;
-    if (input.lockedUntilDays)
-        payload.lockedUntilDays = input.lockedUntilDays;
+        walletCode: input.walletCode,
+        comment: input.comment,
+        expiresInDays: input.expiresInDays,
+        lockedUntilDays: input.lockedUntilDays,
+    });
     try {
         const response = await apiPost(`/${storeCode}/points/add`, { transfer: { customer: input.memberId, ...payload } });
         return { transferId: response.transferId };
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_points_add");
+        throw formatApiError(error, "ol_points_add");
     }
 }
 export async function pointsSpend(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
-    const payload = {
+    const storeCode = getStoreCode(input.storeCode);
+    const payload = omitUndefined({
         points: input.points,
-    };
-    if (input.walletCode)
-        payload.walletCode = input.walletCode;
-    if (input.comment)
-        payload.comment = input.comment;
+        walletCode: input.walletCode,
+        comment: input.comment,
+    });
     try {
         const response = await apiPost(`/${storeCode}/points/spend`, { transfer: { customer: input.memberId, ...payload } });
         return { transferId: response.transferId };
@@ -93,15 +87,14 @@ export async function pointsSpend(input) {
                 code: "INSUFFICIENT_BALANCE",
                 message: "Member does not have enough points to complete this operation",
                 hint: `Use points_get_balance(memberId: "${input.memberId}") to check available balance before spending.`,
-                relatedTool: "openloyalty_points_spend",
+                relatedTool: "ol_points_spend",
             });
         }
-        throw formatApiError(error, "openloyalty_points_spend");
+        throw formatApiError(error, "ol_points_spend");
     }
 }
 export async function pointsTransfer(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     if (input.senderId === input.receiverId) {
         throw new Error("Cannot transfer points to yourself. senderId and receiverId must be different.");
     }
@@ -123,15 +116,14 @@ export async function pointsTransfer(input) {
                 code: "INSUFFICIENT_BALANCE",
                 message: "Sender does not have enough points to transfer",
                 hint: `Use points_get_balance(memberId: "${input.senderId}") to check sender's available balance before transferring.`,
-                relatedTool: "openloyalty_points_transfer",
+                relatedTool: "ol_points_transfer",
             });
         }
-        throw formatApiError(error, "openloyalty_points_transfer");
+        throw formatApiError(error, "ol_points_transfer");
     }
 }
 export async function pointsGetBalance(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     if (input.walletCode)
         params.append("walletType:code", input.walletCode);
@@ -176,12 +168,11 @@ export async function pointsGetBalance(input) {
         };
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_points_get_balance");
+        throw formatApiError(error, "ol_points_get_balance");
     }
 }
 export async function pointsGetHistory(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     params.append("member:id", input.memberId);
     // Use buildPaginationParams for cursor/page handling
@@ -214,12 +205,11 @@ export async function pointsGetHistory(input) {
         };
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_points_get_history");
+        throw formatApiError(error, "ol_points_get_history");
     }
 }
 export async function pointsGetHistogram(input) {
-    const config = getConfig();
-    const storeCode = input.storeCode || config.defaultStoreCode;
+    const storeCode = getStoreCode(input.storeCode);
     const params = new URLSearchParams();
     params.append("member:id", input.memberId);
     // pointType is required by the API: spent|earned|expired|pending
@@ -255,51 +245,63 @@ export async function pointsGetHistogram(input) {
         });
     }
     catch (error) {
-        throw formatApiError(error, "openloyalty_points_get_histogram");
+        throw formatApiError(error, "ol_points_get_histogram");
     }
 }
 // Tool definitions
 export const pointsToolDefinitions = [
     {
-        name: "openloyalty_points_add",
+        name: "ol_points_add",
+        title: "Add Points to Member",
         description: "Add points to member wallet. Points can have optional expiration and lock period. " +
             "Use for welcome bonuses, manual adjustments, or custom rewards. Returns transferId.",
+        readOnly: false,
         inputSchema: PointsAddInputSchema,
         handler: pointsAdd,
     },
     {
-        name: "openloyalty_points_spend",
+        name: "ol_points_spend",
+        title: "Spend Member Points",
         description: "Deduct points from member wallet. Fails if insufficient balance. " +
             "Use points_get_balance first to verify available points. Returns transferId.",
+        readOnly: false,
         inputSchema: PointsSpendInputSchema,
         handler: pointsSpend,
     },
     {
-        name: "openloyalty_points_transfer",
+        name: "ol_points_transfer",
+        title: "Transfer Points Between Members",
         description: "Transfer points from one member to another (P2P transfer). " +
             "Sender must have sufficient balance. Returns transferId.",
+        readOnly: false,
         inputSchema: PointsTransferInputSchema,
         handler: pointsTransfer,
     },
     {
-        name: "openloyalty_points_get_balance",
+        name: "ol_points_get_balance",
+        title: "Check Points Balance",
         description: "Get member points balance breakdown. activeUnits is available for spending. " +
             "earnedUnits shows lifetime earnings, lockedUnits shows pending points.",
+        readOnly: true,
         inputSchema: PointsBalanceInputSchema,
         handler: pointsGetBalance,
     },
     {
-        name: "openloyalty_points_get_history",
+        name: "ol_points_get_history",
+        title: "View Points History",
         description: "Get points transaction history for a member. Filter by type: adding, spending, " +
             "p2p_spending, p2p_adding, blocked, expired. Returns paginated list of transfers. " +
             "Supports cursor pagination: provide 'cursor' from previous response to get next page.",
+        readOnly: true,
         inputSchema: PointsHistoryInputSchema,
         handler: pointsGetHistory,
     },
     {
-        name: "openloyalty_points_get_histogram",
+        name: "ol_points_get_histogram",
+        title: "View Points Trends",
         description: "Get points histogram data for visualization. Shows earning and spending patterns over time. " +
             "Use interval (day/week/month) to aggregate data and dateFrom/dateTo to filter range.",
+        readOnly: true,
         inputSchema: PointsHistogramInputSchema,
         handler: pointsGetHistogram,
     },

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

@@ -0,0 +1,47 @@
+/**
+ * Create a referral relationship between two members
+ * POST /api/:storeCode/member/:member/referral
+ */
+export declare function referralCreate(input: {
+    storeCode?: string;
+    memberId: string;
+    referrerId: string;
+}): Promise<void>;
+/**
+ * List referrals with optional filters
+ * GET /api/:storeCode/referral
+ */
+export declare function referralList(input: {
+    storeCode?: string;
+    referralId?: string;
+    referrerId?: string;
+    referrerName?: string;
+    referrerToken?: string;
+    refereeId?: string;
+    refereeName?: string;
+    createdAt?: string;
+    page?: number;
+    perPage?: number;
+}): Promise<{
+    referrals: Array<{
+        referralId: string;
+        referrerId: string;
+        referrerName?: string;
+        referrerToken?: string;
+        refereeId: string;
+        refereeName?: string;
+        createdAt: string;
+    }>;
+    total: {
+        all?: number;
+        filtered?: number;
+    };
+}>;
+/**
+ * Delete a referral relationship
+ * DELETE /api/:storeCode/member/:member/referral
+ */
+export declare function referralDelete(input: {
+    storeCode?: string;
+    memberId: string;
+}): Promise<void>;

package/dist/tools/referral/handlers.js

@@ -0,0 +1,115 @@
+import { apiGet, apiPost, apiDelete } from "../../client/http.js";
+import { formatApiError, OpenLoyaltyError } from "../../utils/errors.js";
+import { getStoreCode } from "../../config.js";
+/**
+ * Create a referral relationship between two members
+ * POST /api/:storeCode/member/:member/referral
+ */
+export async function referralCreate(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    // Validate that memberId and referrerId are different
+    if (input.memberId === input.referrerId) {
+        throw new OpenLoyaltyError({
+            code: "INVALID_REFERRAL",
+            message: "A member cannot refer themselves",
+            hint: "The memberId (referee) must be different from the referrerId (referrer). The referee is the new member, the referrer is the existing member who made the referral.",
+            relatedTool: "ol_referral_create",
+        });
+    }
+    try {
+        await apiPost(`/${storeCode}/member/${input.memberId}/referral`, { referrerId: input.referrerId });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes("already has a referrer") || errorMessage.includes("referral already exists")) {
+            throw new OpenLoyaltyError({
+                code: "REFERRAL_EXISTS",
+                message: "This member already has a referral relationship",
+                hint: `Member ${input.memberId} has already been referred by someone. Use referral_list(refereeId: "${input.memberId}") to see existing referral.`,
+                relatedTool: "ol_referral_create",
+            });
+        }
+        if (errorMessage.includes("not found") || errorMessage.includes("Not Found")) {
+            throw new OpenLoyaltyError({
+                code: "MEMBER_NOT_FOUND",
+                message: "One or both member IDs do not exist",
+                hint: `Verify both members exist: member_get(memberId: "${input.memberId}") for referee and member_get(memberId: "${input.referrerId}") for referrer.`,
+                relatedTool: "ol_referral_create",
+            });
+        }
+        throw formatApiError(error, "ol_referral_create");
+    }
+}
+/**
+ * List referrals with optional filters
+ * GET /api/:storeCode/referral
+ */
+export async function referralList(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    const params = new URLSearchParams();
+    if (input.referralId)
+        params.append("referralId", input.referralId);
+    if (input.referrerId)
+        params.append("referrerId", input.referrerId);
+    if (input.referrerName)
+        params.append("referrerName", input.referrerName);
+    if (input.referrerToken)
+        params.append("referrerToken", input.referrerToken);
+    if (input.refereeId)
+        params.append("refereeId", input.refereeId);
+    if (input.refereeName)
+        params.append("refereeName", input.refereeName);
+    if (input.createdAt)
+        params.append("createdAt", input.createdAt);
+    if (input.page)
+        params.append("_page", String(input.page));
+    if (input.perPage)
+        params.append("_itemsOnPage", String(input.perPage));
+    const queryString = params.toString();
+    const url = `/${storeCode}/referral${queryString ? `?${queryString}` : ""}`;
+    try {
+        const response = await apiGet(url);
+        const referrals = (response.items || []).map((item) => ({
+            referralId: item.referralId,
+            referrerId: item.referrerId,
+            referrerName: item.referrerName,
+            referrerToken: item.referrerToken,
+            refereeId: item.refereeId,
+            refereeName: item.refereeName,
+            createdAt: item.createdAt,
+        }));
+        const total = response.total || {};
+        return {
+            referrals,
+            total: {
+                all: typeof total.all === "number" ? total.all : undefined,
+                filtered: typeof total.filtered === "number" ? total.filtered : undefined,
+            },
+        };
+    }
+    catch (error) {
+        throw formatApiError(error, "ol_referral_list");
+    }
+}
+/**
+ * Delete a referral relationship
+ * DELETE /api/:storeCode/member/:member/referral
+ */
+export async function referralDelete(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    try {
+        await apiDelete(`/${storeCode}/member/${input.memberId}/referral`);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes("not found") || errorMessage.includes("Not Found")) {
+            throw new OpenLoyaltyError({
+                code: "REFERRAL_NOT_FOUND",
+                message: "No referral relationship found for this member",
+                hint: `Member ${input.memberId} does not have a referral relationship. Use referral_list(refereeId: "${input.memberId}") to verify.`,
+                relatedTool: "ol_referral_delete",
+            });
+        }
+        throw formatApiError(error, "ol_referral_delete");
+    }
+}

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

@@ -0,0 +1,44 @@
+export { ReferralCreateInputSchema, ReferralListInputSchema, ReferralDeleteInputSchema, } from "./schemas.js";
+export { referralCreate, referralList, referralDelete } from "./handlers.js";
+import { referralCreate, referralList, referralDelete } from "./handlers.js";
+export declare const referralToolDefinitions: readonly [{
+    readonly name: "ol_referral_create";
+    readonly title: "Create Referral Relationship";
+    readonly description: string;
+    readonly readOnly: false;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        memberId: import("zod").ZodString;
+        referrerId: import("zod").ZodString;
+    };
+    readonly handler: typeof referralCreate;
+}, {
+    readonly name: "ol_referral_list";
+    readonly title: "List Referrals";
+    readonly description: string;
+    readonly readOnly: true;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        referralId: import("zod").ZodOptional<import("zod").ZodString>;
+        referrerId: import("zod").ZodOptional<import("zod").ZodString>;
+        referrerName: import("zod").ZodOptional<import("zod").ZodString>;
+        referrerToken: import("zod").ZodOptional<import("zod").ZodString>;
+        refereeId: import("zod").ZodOptional<import("zod").ZodString>;
+        refereeName: import("zod").ZodOptional<import("zod").ZodString>;
+        createdAt: import("zod").ZodOptional<import("zod").ZodString>;
+        page: import("zod").ZodOptional<import("zod").ZodNumber>;
+        perPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+    };
+    readonly handler: typeof referralList;
+}, {
+    readonly name: "ol_referral_delete";
+    readonly title: "Delete Referral Relationship";
+    readonly description: string;
+    readonly readOnly: false;
+    readonly destructive: true;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        memberId: import("zod").ZodString;
+    };
+    readonly handler: typeof referralDelete;
+}];

package/dist/tools/referral/index.js

@@ -0,0 +1,44 @@
+// Re-export schemas
+export { ReferralCreateInputSchema, ReferralListInputSchema, ReferralDeleteInputSchema, } from "./schemas.js";
+// Re-export handlers
+export { referralCreate, referralList, referralDelete } from "./handlers.js";
+// Imports for tool definitions
+import { ReferralCreateInputSchema, ReferralListInputSchema, ReferralDeleteInputSchema, } from "./schemas.js";
+import { referralCreate, referralList, referralDelete } from "./handlers.js";
+// Tool definitions
+export const referralToolDefinitions = [
+    {
+        name: "ol_referral_create",
+        title: "Create Referral Relationship",
+        description: "Create a referral relationship between an existing member (referrer) and a new member (referee). " +
+            "The referrer is the member who made the referral and will receive referral rewards. " +
+            "The referee (memberId) is the new member who was referred. " +
+            "Use this after creating a new member who was referred by an existing member. " +
+            "Both members must exist. A member can only have one referrer.",
+        readOnly: false,
+        inputSchema: ReferralCreateInputSchema,
+        handler: referralCreate,
+    },
+    {
+        name: "ol_referral_list",
+        title: "List Referrals",
+        description: "List referral relationships with optional filters. " +
+            "Filter by referrerId to see all members a specific person has referred. " +
+            "Filter by refereeId to find who referred a specific member. " +
+            "Returns referralId, referrerId, referrerName, refereeId, refereeName, and createdAt.",
+        readOnly: true,
+        inputSchema: ReferralListInputSchema,
+        handler: referralList,
+    },
+    {
+        name: "ol_referral_delete",
+        title: "Delete Referral Relationship",
+        description: "Delete a referral relationship for a member. " +
+            "Use with caution - this removes the referral tracking but may not reverse any rewards already given. " +
+            "The memberId is the referee (the member who was referred).",
+        readOnly: false,
+        destructive: true,
+        inputSchema: ReferralDeleteInputSchema,
+        handler: referralDelete,
+    },
+];

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

@@ -0,0 +1,34 @@
+import { z } from "zod";
+/**
+ * Schema for creating a referral relationship
+ * POST /api/:storeCode/member/:member/referral
+ */
+export declare const ReferralCreateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    memberId: z.ZodString;
+    referrerId: z.ZodString;
+};
+/**
+ * Schema for listing referrals
+ * GET /api/:storeCode/referral
+ */
+export declare const ReferralListInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    referralId: z.ZodOptional<z.ZodString>;
+    referrerId: z.ZodOptional<z.ZodString>;
+    referrerName: z.ZodOptional<z.ZodString>;
+    referrerToken: z.ZodOptional<z.ZodString>;
+    refereeId: z.ZodOptional<z.ZodString>;
+    refereeName: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+};
+/**
+ * Schema for deleting a referral relationship
+ * DELETE /api/:storeCode/member/:member/referral
+ */
+export declare const ReferralDeleteInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    memberId: z.ZodString;
+};

package/dist/tools/referral/schemas.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+/**
+ * Schema for creating a referral relationship
+ * POST /api/:storeCode/member/:member/referral
+ */
+export const ReferralCreateInputSchema = {
+    storeCode: z
+        .string()
+        .optional()
+        .describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    memberId: z
+        .string()
+        .uuid()
+        .describe("The member ID (UUID) of the referee (the new member being referred). This is the member who was referred by someone else."),
+    referrerId: z
+        .string()
+        .uuid()
+        .describe("The member ID (UUID) of the referrer (the existing member who made the referral). This member will receive referral rewards."),
+};
+/**
+ * Schema for listing referrals
+ * GET /api/:storeCode/referral
+ */
+export const ReferralListInputSchema = {
+    storeCode: z
+        .string()
+        .optional()
+        .describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    referralId: z.string().uuid().optional().describe("Filter by specific referral ID"),
+    referrerId: z.string().uuid().optional().describe("Filter by referrer member ID"),
+    referrerName: z.string().max(255).optional().describe("Filter by referrer name"),
+    referrerToken: z.string().max(255).optional().describe("Filter by referrer token"),
+    refereeId: z.string().uuid().optional().describe("Filter by referee member ID"),
+    refereeName: z.string().max(255).optional().describe("Filter by referee name"),
+    createdAt: z.string().optional().describe("Filter by creation date (ISO 8601)"),
+    page: z.number().int().min(1).optional().describe("Page number (starts from 1)"),
+    perPage: z.number().int().min(1).max(100).optional().describe("Items per page (default 25, max 100)"),
+};
+/**
+ * Schema for deleting a referral relationship
+ * DELETE /api/:storeCode/member/:member/referral
+ */
+export const ReferralDeleteInputSchema = {
+    storeCode: z
+        .string()
+        .optional()
+        .describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    memberId: z
+        .string()
+        .uuid()
+        .describe("The member ID (UUID) of the referee whose referral relationship should be deleted."),
+};