@open-loyalty/mcp-server 1.5.3 → 1.7.0

package/dist/tools/custom-event/index.js

@@ -0,0 +1,78 @@
+// Re-export schemas
+export { CustomEventSchemaListInputSchema, CustomEventSchemaGetInputSchema, CustomEventSchemaCreateInputSchema, CustomEventSchemaUpdateInputSchema, CustomEventSchemaActivateInputSchema, CustomEventSendInputSchema, CustomEventListInputSchema, } from "./schemas.js";
+// Re-export handlers
+export { customEventSchemaList, customEventSchemaGet, customEventSchemaCreate, customEventSchemaUpdate, customEventSchemaActivate, customEventSend, customEventList, } from "./handlers.js";
+// Imports for tool definitions
+import { CustomEventSchemaListInputSchema, CustomEventSchemaGetInputSchema, CustomEventSchemaCreateInputSchema, CustomEventSchemaUpdateInputSchema, CustomEventSchemaActivateInputSchema, CustomEventSendInputSchema, CustomEventListInputSchema, } from "./schemas.js";
+import { customEventSchemaList, customEventSchemaGet, customEventSchemaCreate, customEventSchemaUpdate, customEventSchemaActivate, customEventSend, customEventList, } from "./handlers.js";
+// Tool definitions
+export const customEventToolDefinitions = [
+    {
+        name: "ol_custom_event_schema_list",
+        title: "List Custom Event Schemas",
+        description: "List available custom event schemas. Custom event schemas define event types that can trigger campaigns and achievements. " +
+            "Use this to discover existing event types before creating campaigns/achievements with trigger='custom_event'.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: CustomEventSchemaListInputSchema,
+        handler: customEventSchemaList,
+    },
+    {
+        name: "ol_custom_event_schema_get",
+        title: "Get Custom Event Schema",
+        description: "Get details of a specific custom event schema including its fields.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: CustomEventSchemaGetInputSchema,
+        handler: customEventSchemaGet,
+    },
+    {
+        name: "ol_custom_event_schema_create",
+        title: "Create Custom Event Schema",
+        description: "Create a new custom event schema. REQUIRED before using a custom event in campaigns or achievements. " +
+            "Example: To track location visits, create schema with eventType='location_visit' and fields like [{name: 'location_id', type: 'text'}]. " +
+            "Valid field types: 'text' (strings), 'number' (integers/decimals), 'boolean', 'datetime'. " +
+            "Then use campaign_create with trigger='custom_event', event='location_visit'.",
+        readOnly: false,
+        idempotent: false,
+        inputSchema: CustomEventSchemaCreateInputSchema,
+        handler: customEventSchemaCreate,
+    },
+    {
+        name: "ol_custom_event_schema_update",
+        title: "Update Custom Event Schema",
+        description: "Update an existing custom event schema (name, fields, active status).",
+        readOnly: false,
+        idempotent: true,
+        inputSchema: CustomEventSchemaUpdateInputSchema,
+        handler: customEventSchemaUpdate,
+    },
+    {
+        name: "ol_custom_event_schema_activate",
+        title: "Activate/Deactivate Custom Event Schema",
+        description: "Activate or deactivate a custom event schema. Inactive schemas won't trigger campaigns/achievements.",
+        readOnly: false,
+        idempotent: true,
+        inputSchema: CustomEventSchemaActivateInputSchema,
+        handler: customEventSchemaActivate,
+    },
+    {
+        name: "ol_custom_event_send",
+        title: "Send Custom Event",
+        description: "Send a custom event for a member. Triggers any campaigns/achievements that match the event type. " +
+            "The event schema must exist. Identify member by customerId, email, phone, or loyaltyCardNumber.",
+        readOnly: false,
+        idempotent: false,
+        inputSchema: CustomEventSendInputSchema,
+        handler: customEventSend,
+    },
+    {
+        name: "ol_custom_event_list",
+        title: "List Custom Events",
+        description: "List custom events that have been sent. Filter by event type or member to see event history.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: CustomEventListInputSchema,
+        handler: customEventList,
+    },
+];

package/dist/tools/custom-event/schemas.d.ts

@@ -0,0 +1,87 @@
+import { z } from "zod";
+export declare const CustomEventSchemaListInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    eventType: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    active: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const CustomEventSchemaGetInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    eventType: z.ZodString;
+};
+export declare const CustomEventSchemaCreateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    eventType: z.ZodString;
+    name: z.ZodString;
+    fields: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<["text", "number", "boolean", "datetime"]>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "number" | "boolean" | "text" | "datetime";
+        name: string;
+        description?: string | undefined;
+    }, {
+        type: "number" | "boolean" | "text" | "datetime";
+        name: string;
+        description?: string | undefined;
+    }>, "many">;
+    active: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const CustomEventSchemaUpdateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    eventType: z.ZodString;
+    name: z.ZodString;
+    fields: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<["text", "number", "boolean", "datetime"]>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "number" | "boolean" | "text" | "datetime";
+        name: string;
+        description?: string | undefined;
+    }, {
+        type: "number" | "boolean" | "text" | "datetime";
+        name: string;
+        description?: string | undefined;
+    }>, "many">;
+    active: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const CustomEventSchemaActivateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    eventType: z.ZodString;
+    active: z.ZodBoolean;
+};
+export declare const CustomEventSendInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    eventType: z.ZodString;
+    customerData: z.ZodObject<{
+        customerId: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        loyaltyCardNumber: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        email?: string | undefined;
+        phone?: string | undefined;
+        loyaltyCardNumber?: string | undefined;
+        customerId?: string | undefined;
+    }, {
+        email?: string | undefined;
+        phone?: string | undefined;
+        loyaltyCardNumber?: string | undefined;
+        customerId?: string | undefined;
+    }>;
+    eventDate: z.ZodString;
+    body: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    eventId: z.ZodOptional<z.ZodString>;
+};
+export declare const CustomEventListInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodOptional<z.ZodString>;
+    customerId: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+};

package/dist/tools/custom-event/schemas.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+export const CustomEventSchemaListInputSchema = {
+    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)."),
+    perPage: z.number().optional().describe("Items per page (default: 25)."),
+    eventType: z.string().optional().describe("Filter by event type code."),
+    name: z.string().optional().describe("Filter by event schema name."),
+    active: z.boolean().optional().describe("Filter by active status."),
+};
+export const CustomEventSchemaGetInputSchema = {
+    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."),
+    eventType: z.string().describe("The custom event type code to retrieve."),
+};
+const CustomEventSchemaFieldSchema = z.object({
+    name: z.string().describe("Field name (e.g., 'minutes_watched', 'location_id')."),
+    type: z.enum(["text", "number", "boolean", "datetime"]).describe("Field data type: 'text' (strings), 'number' (integers/decimals), 'boolean' (true/false), 'datetime' (ISO 8601 format)."),
+    description: z.string().optional().describe("Field description."),
+});
+export const CustomEventSchemaCreateInputSchema = {
+    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."),
+    eventType: z.string().describe("Unique event type code (e.g., 'location_visit', 'app_login', 'video_watch'). " +
+        "Use snake_case. This is referenced in campaigns and achievements."),
+    name: z.string().describe("Human-readable name for the event schema."),
+    fields: z.array(CustomEventSchemaFieldSchema).describe("Array of fields. Example: [{name: 'minutes_watched', type: 'number'}, {name: 'location', type: 'text'}]. Valid types: text, number, boolean, datetime."),
+    active: z.boolean().optional().describe("Whether the schema is active (default: true)."),
+};
+export const CustomEventSchemaUpdateInputSchema = {
+    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."),
+    eventType: z.string().describe("The custom event type code to update."),
+    name: z.string().describe("Human-readable name for the event schema."),
+    fields: z.array(CustomEventSchemaFieldSchema).describe("Array of fields the event can contain."),
+    active: z.boolean().optional().describe("Whether the schema is active."),
+};
+export const CustomEventSchemaActivateInputSchema = {
+    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."),
+    eventType: z.string().describe("The custom event type code to activate/deactivate."),
+    active: z.boolean().describe("Set to true to activate, false to deactivate."),
+};
+export const CustomEventSendInputSchema = {
+    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."),
+    eventType: z.string().describe("The custom event type code (must match an existing schema). Use ol_custom_event_schema_list to find valid event codes."),
+    customerData: z.object({
+        customerId: z.string().optional().describe("Member ID (UUID) for identification."),
+        email: z.string().optional().describe("Member email for identification."),
+        phone: z.string().optional().describe("Member phone for identification."),
+        loyaltyCardNumber: z.string().optional().describe("Member loyalty card number for identification."),
+    }).describe("Customer identification (provide at least one field)."),
+    eventDate: z.string().describe("Event date/time in ISO format (e.g., '2025-01-15T14:30:00+00:00')."),
+    body: z.record(z.unknown()).optional().describe("Event-specific data matching the schema fields. Use ol_custom_event_schema_get(eventType) to see expected field names and types."),
+    eventId: z.string().optional().describe("Unique event identifier for deduplication (optional, max 255 chars)."),
+};
+export const CustomEventListInputSchema = {
+    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)."),
+    perPage: z.number().optional().describe("Items per page (default: 25)."),
+    type: z.string().optional().describe("Filter by event type."),
+    customerId: z.string().optional().describe("Filter by member ID."),
+    email: z.string().optional().describe("Filter by member email."),
+};

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

@@ -0,0 +1,29 @@
+import type { Export, ExportListResponse } from "./schemas.js";
+export declare function exportCreate(input: {
+    storeCode?: string;
+    type: string;
+    filters?: Record<string, unknown>;
+    page?: number;
+    perPage?: number;
+}): Promise<{
+    exportId: string;
+}>;
+export declare function exportList(input: {
+    storeCode?: string;
+    page?: number;
+    perPage?: number;
+    exportId?: string;
+    type?: string;
+    status?: string;
+}): Promise<ExportListResponse>;
+export declare function exportGet(input: {
+    storeCode?: string;
+    exportId: string;
+}): Promise<Export>;
+export declare function exportDownload(input: {
+    storeCode?: string;
+    exportId: string;
+}): Promise<{
+    content: string;
+    contentType: string;
+}>;

package/dist/tools/export/handlers.js

@@ -0,0 +1,128 @@
+import { apiGet, apiPost } from "../../client/http.js";
+import { formatApiError, OpenLoyaltyError } from "../../utils/errors.js";
+import { getConfig, getStoreCode } from "../../config.js";
+import axios from "axios";
+export async function exportCreate(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    // Build the payload with type-specific wrapper
+    // The API expects { [type]: { ...filters, _page?, _itemsOnPage? } }
+    const innerPayload = {
+        ...(input.filters || {}),
+    };
+    if (input.page)
+        innerPayload._page = input.page;
+    if (input.perPage)
+        innerPayload._itemsOnPage = input.perPage;
+    const payload = {
+        [input.type]: innerPayload,
+    };
+    try {
+        const response = await apiPost(`/${storeCode}/export/${input.type}`, 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("filter") || allMessages.includes("campaign") || allMessages.includes("segment")) {
+                throw new OpenLoyaltyError({
+                    code: "INVALID_EXPORT_FILTERS",
+                    message: `Invalid filters for '${input.type}' export`,
+                    hint: "Each export type accepts specific filters. For campaignCode: { campaignId, code, status }. For member: { email, firstName, lastName, active }. For memberTier: { tierSetId, levelId }. For memberSegment: { segmentId }. For rewardFulfillment: { rewardId, memberId, status }.",
+                    relatedTool: "ol_export_create",
+                });
+            }
+        }
+        if (axios.isAxiosError(error) && error.response?.status === 404) {
+            throw new OpenLoyaltyError({
+                code: "FILTER_RESOURCE_NOT_FOUND",
+                message: "A resource referenced in the export filters was not found",
+                hint: "Verify that IDs in your filters exist: for campaignCode exports use ol_campaign_list(), for memberSegment use ol_segment_list(), for memberTier use ol_tierset_list(), for rewardFulfillment use ol_reward_list().",
+                relatedTool: "ol_export_create",
+            });
+        }
+        if (axios.isAxiosError(error) && error.response?.status === 403) {
+            throw new OpenLoyaltyError({
+                code: "EXPORT_PERMISSION_DENIED",
+                message: "You don't have permission to create exports",
+                hint: "Data exports require the EXPORT:MODIFY permission. Use ol_admin_get_permissions() to check your access.",
+                relatedTool: "ol_export_create",
+            });
+        }
+        throw formatApiError(error, "ol_export_create");
+    }
+}
+export async function exportList(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.exportId)
+        params.append("exportId", input.exportId);
+    if (input.type)
+        params.append("type", input.type);
+    if (input.status)
+        params.append("status", input.status);
+    const queryString = params.toString();
+    const url = `/${storeCode}/export${queryString ? `?${queryString}` : ""}`;
+    try {
+        const response = await apiGet(url);
+        return response;
+    }
+    catch (error) {
+        if (axios.isAxiosError(error) && error.response?.status === 403) {
+            throw new OpenLoyaltyError({
+                code: "EXPORT_PERMISSION_DENIED",
+                message: "You don't have permission to list exports",
+                hint: "Data exports require the EXPORT:VIEW permission. Use ol_admin_get_permissions() to check your access.",
+                relatedTool: "ol_export_list",
+            });
+        }
+        throw formatApiError(error, "ol_export_list");
+    }
+}
+export async function exportGet(input) {
+    const storeCode = getStoreCode(input.storeCode);
+    try {
+        const response = await apiGet(`/${storeCode}/export/${input.exportId}`);
+        return response;
+    }
+    catch (error) {
+        if (axios.isAxiosError(error) && error.response?.status === 404) {
+            throw new OpenLoyaltyError({ code: "NOT_FOUND", message: `Export '${input.exportId}' not found`,
+                hint: "Use ol_export_list() to find existing exports and their IDs.", relatedTool: "ol_export_get" });
+        }
+        throw formatApiError(error, "ol_export_get");
+    }
+}
+export async function exportDownload(input) {
+    const config = getConfig();
+    const storeCode = getStoreCode(input.storeCode);
+    try {
+        const response = await axios.get(`${config.apiUrl}/${storeCode}/export/${input.exportId}/download`, {
+            headers: {
+                "X-AUTH-TOKEN": config.apiToken,
+                "Accept": "text/csv",
+            },
+            responseType: "text",
+        });
+        return {
+            content: response.data,
+            contentType: response.headers["content-type"] || "text/csv",
+        };
+    }
+    catch (error) {
+        if (axios.isAxiosError(error)) {
+            if (error.response?.status === 404) {
+                throw new OpenLoyaltyError({ code: "NOT_FOUND", message: `Export '${input.exportId}' not found`,
+                    hint: "Use ol_export_list() to find existing exports and their IDs.", relatedTool: "ol_export_download" });
+            }
+            if (error.response?.status === 400 || error.response?.status === 409) {
+                throw new OpenLoyaltyError({ code: "EXPORT_NOT_READY", message: "Export is not ready for download yet",
+                    hint: `Use ol_export_get(exportId: "${input.exportId}") to check export status. Download is only available when status is 'done'.`, relatedTool: "ol_export_download" });
+            }
+        }
+        throw formatApiError(error, "ol_export_download");
+    }
+}

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

@@ -0,0 +1,56 @@
+export { ExportCreateInputSchema, ExportListInputSchema, ExportGetInputSchema, ExportDownloadInputSchema, } from "./schemas.js";
+export type { Export, ExportListResponse } from "./schemas.js";
+export { exportCreate, exportList, exportGet, exportDownload, } from "./handlers.js";
+import { exportCreate, exportList, exportGet, exportDownload } from "./handlers.js";
+export declare const exportToolDefinitions: readonly [{
+    readonly name: "ol_export_create";
+    readonly title: "Create Data Export";
+    readonly description: "Create a new data export. Returns exportId for async tracking. Export types: campaignCode (campaign redemption codes), member (member data), memberTier (member tier assignments), memberSegment (member segment membership), rewardFulfillment (reward fulfillment records). The export runs asynchronously - use export_get to check status and export_download when status is 'done'.";
+    readonly readOnly: false;
+    readonly idempotent: false;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        type: import("zod").ZodEnum<["campaignCode", "member", "memberTier", "memberSegment", "rewardFulfillment"]>;
+        filters: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+        page: import("zod").ZodOptional<import("zod").ZodNumber>;
+        perPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+    };
+    readonly handler: typeof exportCreate;
+}, {
+    readonly name: "ol_export_list";
+    readonly title: "List Exports";
+    readonly description: "List exports with optional filtering. Returns paginated list of exports with exportId, type, status, createdAt, and finishedAt. Status values: pending, done, failed, error.";
+    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>;
+        exportId: import("zod").ZodOptional<import("zod").ZodString>;
+        type: import("zod").ZodOptional<import("zod").ZodEnum<["campaignCode", "member", "memberTier", "memberSegment", "rewardFulfillment"]>>;
+        status: import("zod").ZodOptional<import("zod").ZodEnum<["pending", "done", "failed", "error"]>>;
+    };
+    readonly handler: typeof exportList;
+}, {
+    readonly name: "ol_export_get";
+    readonly title: "Get Export Details";
+    readonly description: "Get export details and status. Returns exportId, type, status, createdAt, finishedAt, exportedRows, and message. Check status before downloading - export must have status 'done'.";
+    readonly readOnly: true;
+    readonly idempotent: true;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        exportId: import("zod").ZodString;
+    };
+    readonly handler: typeof exportGet;
+}, {
+    readonly name: "ol_export_download";
+    readonly title: "Download Export File";
+    readonly description: "Download export file content. Returns CSV content. IMPORTANT: Only available when export status is 'done'. Check status with export_get first.";
+    readonly readOnly: true;
+    readonly idempotent: true;
+    readonly inputSchema: {
+        storeCode: import("zod").ZodOptional<import("zod").ZodString>;
+        exportId: import("zod").ZodString;
+    };
+    readonly handler: typeof exportDownload;
+}];

package/dist/tools/export/index.js

@@ -0,0 +1,46 @@
+// Re-export schemas and types
+export { ExportCreateInputSchema, ExportListInputSchema, ExportGetInputSchema, ExportDownloadInputSchema, } from "./schemas.js";
+// Re-export handlers
+export { exportCreate, exportList, exportGet, exportDownload, } from "./handlers.js";
+// Imports for tool definitions
+import { ExportCreateInputSchema, ExportListInputSchema, ExportGetInputSchema, ExportDownloadInputSchema, } from "./schemas.js";
+import { exportCreate, exportList, exportGet, exportDownload, } from "./handlers.js";
+// Tool definitions
+export const exportToolDefinitions = [
+    {
+        name: "ol_export_create",
+        title: "Create Data Export",
+        description: "Create a new data export. Returns exportId for async tracking. Export types: campaignCode (campaign redemption codes), member (member data), memberTier (member tier assignments), memberSegment (member segment membership), rewardFulfillment (reward fulfillment records). The export runs asynchronously - use export_get to check status and export_download when status is 'done'.",
+        readOnly: false,
+        idempotent: false,
+        inputSchema: ExportCreateInputSchema,
+        handler: exportCreate,
+    },
+    {
+        name: "ol_export_list",
+        title: "List Exports",
+        description: "List exports with optional filtering. Returns paginated list of exports with exportId, type, status, createdAt, and finishedAt. Status values: pending, done, failed, error.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: ExportListInputSchema,
+        handler: exportList,
+    },
+    {
+        name: "ol_export_get",
+        title: "Get Export Details",
+        description: "Get export details and status. Returns exportId, type, status, createdAt, finishedAt, exportedRows, and message. Check status before downloading - export must have status 'done'.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: ExportGetInputSchema,
+        handler: exportGet,
+    },
+    {
+        name: "ol_export_download",
+        title: "Download Export File",
+        description: "Download export file content. Returns CSV content. IMPORTANT: Only available when export status is 'done'. Check status with export_get first.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: ExportDownloadInputSchema,
+        handler: exportDownload,
+    },
+];

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

@@ -0,0 +1,42 @@
+import { z } from "zod";
+export interface Export {
+    exportId: string;
+    type?: string;
+    status?: string;
+    createdAt?: string;
+    finishedAt?: string;
+    criteria?: string;
+    exportedRows?: number;
+    message?: string;
+}
+export interface ExportListResponse {
+    items: Export[];
+    total?: {
+        all?: number | string;
+        filtered?: number | string;
+        estimated?: boolean;
+    };
+}
+export declare const ExportCreateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<["campaignCode", "member", "memberTier", "memberSegment", "rewardFulfillment"]>;
+    filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+};
+export declare const ExportListInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    exportId: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["campaignCode", "member", "memberTier", "memberSegment", "rewardFulfillment"]>>;
+    status: z.ZodOptional<z.ZodEnum<["pending", "done", "failed", "error"]>>;
+};
+export declare const ExportGetInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    exportId: z.ZodString;
+};
+export declare const ExportDownloadInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    exportId: z.ZodString;
+};

package/dist/tools/export/schemas.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+export const ExportCreateInputSchema = {
+    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."),
+    type: z.enum([
+        "campaignCode",
+        "member",
+        "memberTier",
+        "memberSegment",
+        "rewardFulfillment",
+    ]).describe("Export type. Options: campaignCode, member, memberTier, memberSegment, rewardFulfillment."),
+    filters: z.record(z.unknown()).optional().describe("Type-specific filters. " +
+        "For campaignCode: { campaignId?, code?, status?, codeId?, usedByMemberId?, createdAt?, usedAt? }. " +
+        "For member: { email?, firstName?, lastName?, active?, loyaltyCardNumber? }. " +
+        "For memberTier: { tierSetId?, levelId? }. " +
+        "For memberSegment: { segmentId? }. " +
+        "For rewardFulfillment: { rewardId?, memberId?, status? }."),
+    page: z.number().optional().describe("Page number for export (included in export criteria)."),
+    perPage: z.number().optional().describe("Items per page for export."),
+};
+export const ExportListInputSchema = {
+    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)."),
+    perPage: z.number().optional().describe("Items per page (default: 25)."),
+    exportId: z.string().optional().describe("Filter by export ID."),
+    type: z.enum([
+        "campaignCode",
+        "member",
+        "memberTier",
+        "memberSegment",
+        "rewardFulfillment",
+    ]).optional().describe("Filter by export type."),
+    status: z.enum(["pending", "done", "failed", "error"]).optional().describe("Filter by export status."),
+};
+export const ExportGetInputSchema = {
+    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."),
+    exportId: z.string().describe("The export ID (UUID) to retrieve."),
+};
+export const ExportDownloadInputSchema = {
+    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."),
+    exportId: z.string().describe("The export ID (UUID) to download. Export must have status 'done'."),
+};

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

@@ -0,0 +1,22 @@
+import type { ImportListResponse, ImportDetailsResponse } from "./schemas.js";
+export declare function importCreate(input: {
+    storeCode?: string;
+    type: string;
+    fileContent: string;
+    fileName?: string;
+}): Promise<{
+    importId: string;
+}>;
+export declare function importList(input: {
+    storeCode?: string;
+    page?: number;
+    perPage?: number;
+    importId?: string;
+    type?: string;
+}): Promise<ImportListResponse>;
+export declare function importGet(input: {
+    storeCode?: string;
+    importId: string;
+    page?: number;
+    perPage?: number;
+}): Promise<ImportDetailsResponse>;