@open-loyalty/mcp-server 1.5.3 → 1.7.0

package/dist/tools/analytics/index.js

@@ -0,0 +1,91 @@
+// Re-export schemas
+export { AnalyticsTiersInputSchema, AnalyticsMembersInputSchema, AnalyticsPointsInputSchema, AnalyticsTransactionsInputSchema, AnalyticsReferralsInputSchema, AnalyticsCampaignsInputSchema, AnalyticsDashboardInputSchema, AnalyticsUnitsInputSchema, AnalyticsCampaignDetailInputSchema, } from "./schemas.js";
+// Re-export handlers
+export { analyticsTiers, analyticsMembers, analyticsPoints, analyticsTransactions, analyticsReferrals, analyticsCampaigns, analyticsDashboard, analyticsUnits, analyticsCampaignDetail, } from "./handlers.js";
+// Imports for tool definitions
+import { AnalyticsTiersInputSchema, AnalyticsMembersInputSchema, AnalyticsPointsInputSchema, AnalyticsTransactionsInputSchema, AnalyticsReferralsInputSchema, AnalyticsCampaignsInputSchema, AnalyticsDashboardInputSchema, AnalyticsUnitsInputSchema, AnalyticsCampaignDetailInputSchema, } from "./schemas.js";
+import { analyticsTiers, analyticsMembers, analyticsPoints, analyticsTransactions, analyticsReferrals, analyticsCampaigns, analyticsDashboard, analyticsUnits, analyticsCampaignDetail, } from "./handlers.js";
+// Tool definitions
+export const analyticsToolDefinitions = [
+    {
+        name: "ol_analytics_tiers",
+        title: "Get Tier Analytics",
+        description: "Get tier (level) analytics showing member distribution across tiers. Returns tier IDs, names, and member counts for each tier level.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: AnalyticsTiersInputSchema,
+        handler: analyticsTiers,
+    },
+    {
+        name: "ol_analytics_members",
+        title: "Get Member Analytics",
+        description: "Get member analytics showing registration trends. Returns member counts by time intervals (1 day, 7 days, 30 days, 365 days). Filter by transaction status to see engaged vs unengaged members.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: AnalyticsMembersInputSchema,
+        handler: analyticsMembers,
+    },
+    {
+        name: "ol_analytics_points",
+        title: "Get Points Analytics",
+        description: "Get points analytics showing program health. Returns total active points, points spent, points issued, expired points, and pending points. Use to monitor points economy.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: AnalyticsPointsInputSchema,
+        handler: analyticsPoints,
+    },
+    {
+        name: "ol_analytics_transactions",
+        title: "Get Transaction Analytics",
+        description: "Get transaction analytics showing purchase trends. Returns transaction counts by intervals, total count, total amount, and average values. Use to monitor sales performance.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: AnalyticsTransactionsInputSchema,
+        handler: analyticsTransactions,
+    },
+    {
+        name: "ol_analytics_referrals",
+        title: "Get Referral Analytics",
+        description: "Get referral program analytics showing referral activity. Returns total referral count. Use to monitor referral program performance.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: AnalyticsReferralsInputSchema,
+        handler: analyticsReferrals,
+    },
+    {
+        name: "ol_analytics_campaigns",
+        title: "Get Campaign Analytics",
+        description: "Get campaign analytics showing execution counts per campaign. Returns list of campaigns with their execution counts. Use to identify most successful campaigns.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: AnalyticsCampaignsInputSchema,
+        handler: analyticsCampaigns,
+    },
+    {
+        name: "ol_analytics_dashboard",
+        title: "Get Dashboard Overview",
+        description: "Get dashboard overview metrics with time-series data. Returns key metrics (registered members, active members, revenue, avg spending, transactions) with optional date range and aggregation. Use for high-level program dashboards.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: AnalyticsDashboardInputSchema,
+        handler: analyticsDashboard,
+    },
+    {
+        name: "ol_analytics_units",
+        title: "Get Units Overview",
+        description: "Get wallet-specific analytics (units overview). Returns units issued, spent, expired, pending, active, plus redemption and breakage rates. Requires walletTypeCode parameter. Use for detailed points economy analysis.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: AnalyticsUnitsInputSchema,
+        handler: analyticsUnits,
+    },
+    {
+        name: "ol_analytics_campaign_detail",
+        title: "Get Campaign Detail Analytics",
+        description: "Get detailed analytics for a specific campaign. Returns campaign-specific performance metrics. Use after analytics_campaigns to drill into individual campaign performance.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: AnalyticsCampaignDetailInputSchema,
+        handler: analyticsCampaignDetail,
+    },
+];

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

@@ -0,0 +1,42 @@
+import { z } from "zod";
+export declare const AnalyticsTiersInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+};
+export declare const AnalyticsMembersInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    withTransaction: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const AnalyticsPointsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+};
+export declare const AnalyticsTransactionsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+};
+export declare const AnalyticsReferralsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+};
+export declare const AnalyticsCampaignsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    executedAt: z.ZodOptional<z.ZodString>;
+};
+export declare const AnalyticsDashboardInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    dataType: z.ZodEnum<["registeredMembers", "activeMembers", "revenue", "avgSpending", "transactions", "avgTransactionValue", "avgNumberOfTransactions"]>;
+    aggregationType: z.ZodOptional<z.ZodEnum<["day", "week", "month"]>>;
+    intervalStartDate: z.ZodOptional<z.ZodString>;
+    intervalEndDate: z.ZodOptional<z.ZodString>;
+};
+export declare const AnalyticsUnitsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    walletTypeCode: z.ZodString;
+    dataType: z.ZodOptional<z.ZodEnum<["unitsIssued", "unitsSpent", "unitsExpired", "unitsPending", "unitsActive"]>>;
+    aggregationType: z.ZodOptional<z.ZodEnum<["day", "week", "month"]>>;
+    intervalStartDate: z.ZodOptional<z.ZodString>;
+    intervalEndDate: z.ZodOptional<z.ZodString>;
+};
+export declare const AnalyticsCampaignDetailInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    campaignId: z.ZodString;
+};

package/dist/tools/analytics/schemas.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+export const AnalyticsTiersInputSchema = {
+    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."),
+};
+export const AnalyticsMembersInputSchema = {
+    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."),
+    withTransaction: z.boolean().optional().describe("Filter: true for members with transactions, false for members without, omit for all."),
+};
+export const AnalyticsPointsInputSchema = {
+    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."),
+};
+export const AnalyticsTransactionsInputSchema = {
+    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."),
+};
+export const AnalyticsReferralsInputSchema = {
+    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."),
+};
+export const AnalyticsCampaignsInputSchema = {
+    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)."),
+    executedAt: z.string().optional().describe("Filter by execution date (ISO format)."),
+};
+export const AnalyticsDashboardInputSchema = {
+    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."),
+    dataType: z.enum([
+        "registeredMembers", "activeMembers", "revenue", "avgSpending",
+        "transactions", "avgTransactionValue", "avgNumberOfTransactions"
+    ]).describe("REQUIRED: Type of data to retrieve. Options: registeredMembers, activeMembers, revenue, avgSpending, transactions, avgTransactionValue, avgNumberOfTransactions."),
+    aggregationType: z.enum(["day", "week", "month"]).optional().describe("Aggregation granularity."),
+    intervalStartDate: z.string().optional().describe("Start date (YYYY-MM-DD format)."),
+    intervalEndDate: z.string().optional().describe("End date (YYYY-MM-DD format)."),
+};
+export const AnalyticsUnitsInputSchema = {
+    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."),
+    walletTypeCode: z.string().describe("Wallet type code (e.g., 'default' or 'points')."),
+    dataType: z.enum([
+        "unitsIssued", "unitsSpent", "unitsExpired", "unitsPending", "unitsActive"
+    ]).optional().describe("Type of data to retrieve."),
+    aggregationType: z.enum(["day", "week", "month"]).optional().describe("Aggregation granularity."),
+    intervalStartDate: z.string().optional().describe("Start date (YYYY-MM-DD format)."),
+    intervalEndDate: z.string().optional().describe("End date (YYYY-MM-DD format)."),
+};
+export const AnalyticsCampaignDetailInputSchema = {
+    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."),
+    campaignId: z.string().describe("The campaign ID to get analytics for."),
+};

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

@@ -0,0 +1,15 @@
+import type { ApiKey, ApiKeyListResponse } from "./schemas.js";
+export declare function apiKeyCreate(input: {
+    adminId: string;
+    name?: string;
+    expirationDate?: string;
+}): Promise<ApiKey>;
+export declare function apiKeyList(input: {
+    adminId: string;
+    page?: number;
+    perPage?: number;
+}): Promise<ApiKeyListResponse>;
+export declare function apiKeyDelete(input: {
+    adminId: string;
+    apiKeyId: string;
+}): Promise<void>;

package/dist/tools/apikey/handlers.js

@@ -0,0 +1,53 @@
+import { apiGet, apiPost, apiDelete } from "../../client/http.js";
+import { formatApiError, OpenLoyaltyError } from "../../utils/errors.js";
+import axios from "axios";
+export async function apiKeyCreate(input) {
+    const payload = {};
+    if (input.name)
+        payload.name = input.name;
+    if (input.expirationDate)
+        payload.expirationDate = input.expirationDate;
+    try {
+        const response = await apiPost(`/admin/${input.adminId}/api-key`, { apiKey: payload });
+        return response;
+    }
+    catch (error) {
+        if (axios.isAxiosError(error) && error.response?.status === 404) {
+            throw new OpenLoyaltyError({ code: "NOT_FOUND", message: `Admin '${input.adminId}' not found`,
+                hint: "Use ol_admin_list() to find existing admin users and their IDs.", relatedTool: "ol_apikey_create" });
+        }
+        throw formatApiError(error, "ol_apikey_create");
+    }
+}
+export async function apiKeyList(input) {
+    const params = new URLSearchParams();
+    if (input.page)
+        params.append("_page", String(input.page));
+    if (input.perPage)
+        params.append("_itemsOnPage", String(input.perPage));
+    const queryString = params.toString();
+    const url = `/admin/${input.adminId}/api-key${queryString ? `?${queryString}` : ""}`;
+    try {
+        const response = await apiGet(url);
+        return response;
+    }
+    catch (error) {
+        if (axios.isAxiosError(error) && error.response?.status === 404) {
+            throw new OpenLoyaltyError({ code: "NOT_FOUND", message: `Admin '${input.adminId}' not found`,
+                hint: "Use ol_admin_list() to find existing admin users and their IDs.", relatedTool: "ol_apikey_list" });
+        }
+        throw formatApiError(error, "ol_apikey_list");
+    }
+}
+export async function apiKeyDelete(input) {
+    try {
+        await apiDelete(`/admin/${input.adminId}/api-key/${input.apiKeyId}`);
+    }
+    catch (error) {
+        if (axios.isAxiosError(error) && error.response?.status === 404) {
+            throw new OpenLoyaltyError({ code: "NOT_FOUND", message: `API key '${input.apiKeyId}' not found for admin '${input.adminId}'`,
+                hint: "Use ol_apikey_list(adminId) to find existing API keys. The apiKeyId or adminId may be incorrect.", relatedTool: "ol_apikey_delete" });
+        }
+        throw formatApiError(error, "ol_apikey_delete");
+    }
+}

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

@@ -0,0 +1,41 @@
+export { ApiKeyCreateInputSchema, ApiKeyListInputSchema, ApiKeyDeleteInputSchema, } from "./schemas.js";
+export type { ApiKey, ApiKeyListResponse } from "./schemas.js";
+export { apiKeyCreate, apiKeyList, apiKeyDelete, } from "./handlers.js";
+import { apiKeyCreate, apiKeyList, apiKeyDelete } from "./handlers.js";
+export declare const apiKeyToolDefinitions: readonly [{
+    readonly name: "ol_apikey_create";
+    readonly title: "Create API Key";
+    readonly description: "Create a new API key for an admin user. CRITICAL: The API token is ONLY returned at creation time. Store it securely immediately - it cannot be retrieved later. Returns apiKeyId, token, adminId, name, and expirationDate.";
+    readonly readOnly: false;
+    readonly idempotent: false;
+    readonly inputSchema: {
+        adminId: import("zod").ZodString;
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        expirationDate: import("zod").ZodOptional<import("zod").ZodString>;
+    };
+    readonly handler: typeof apiKeyCreate;
+}, {
+    readonly name: "ol_apikey_list";
+    readonly title: "List API Keys";
+    readonly description: "List API keys for an admin user. Returns list of API keys with apiKeyId, adminId, name, and expirationDate. Note: tokens are not returned in list responses for security.";
+    readonly readOnly: true;
+    readonly idempotent: true;
+    readonly inputSchema: {
+        adminId: import("zod").ZodString;
+        page: import("zod").ZodOptional<import("zod").ZodNumber>;
+        perPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+    };
+    readonly handler: typeof apiKeyList;
+}, {
+    readonly name: "ol_apikey_delete";
+    readonly title: "Delete API Key (Permanent)";
+    readonly description: "Delete an API key. Returns void on success (204 No Content). The API key will be immediately invalidated.";
+    readonly readOnly: false;
+    readonly destructive: true;
+    readonly idempotent: true;
+    readonly inputSchema: {
+        adminId: import("zod").ZodString;
+        apiKeyId: import("zod").ZodString;
+    };
+    readonly handler: typeof apiKeyDelete;
+}];

package/dist/tools/apikey/index.js

@@ -0,0 +1,38 @@
+// Re-export schemas and types
+export { ApiKeyCreateInputSchema, ApiKeyListInputSchema, ApiKeyDeleteInputSchema, } from "./schemas.js";
+// Re-export handlers
+export { apiKeyCreate, apiKeyList, apiKeyDelete, } from "./handlers.js";
+// Imports for tool definitions
+import { ApiKeyCreateInputSchema, ApiKeyListInputSchema, ApiKeyDeleteInputSchema, } from "./schemas.js";
+import { apiKeyCreate, apiKeyList, apiKeyDelete, } from "./handlers.js";
+// Tool definitions
+export const apiKeyToolDefinitions = [
+    {
+        name: "ol_apikey_create",
+        title: "Create API Key",
+        description: "Create a new API key for an admin user. CRITICAL: The API token is ONLY returned at creation time. Store it securely immediately - it cannot be retrieved later. Returns apiKeyId, token, adminId, name, and expirationDate.",
+        readOnly: false,
+        idempotent: false,
+        inputSchema: ApiKeyCreateInputSchema,
+        handler: apiKeyCreate,
+    },
+    {
+        name: "ol_apikey_list",
+        title: "List API Keys",
+        description: "List API keys for an admin user. Returns list of API keys with apiKeyId, adminId, name, and expirationDate. Note: tokens are not returned in list responses for security.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: ApiKeyListInputSchema,
+        handler: apiKeyList,
+    },
+    {
+        name: "ol_apikey_delete",
+        title: "Delete API Key (Permanent)",
+        description: "Delete an API key. Returns void on success (204 No Content). The API key will be immediately invalidated.",
+        readOnly: false,
+        destructive: true,
+        idempotent: true,
+        inputSchema: ApiKeyDeleteInputSchema,
+        handler: apiKeyDelete,
+    },
+];

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

@@ -0,0 +1,31 @@
+import { z } from "zod";
+export interface ApiKey {
+    apiKeyId: string;
+    token?: string;
+    adminId: string;
+    name: string;
+    legacy?: boolean;
+    expirationDate?: string;
+}
+export interface ApiKeyListResponse {
+    items: ApiKey[];
+    total?: {
+        all?: number | string;
+        filtered?: number | string;
+        estimated?: boolean;
+    };
+}
+export declare const ApiKeyCreateInputSchema: {
+    adminId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    expirationDate: z.ZodOptional<z.ZodString>;
+};
+export declare const ApiKeyListInputSchema: {
+    adminId: z.ZodString;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+};
+export declare const ApiKeyDeleteInputSchema: {
+    adminId: z.ZodString;
+    apiKeyId: z.ZodString;
+};

package/dist/tools/apikey/schemas.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+export const ApiKeyCreateInputSchema = {
+    adminId: z.string().describe("The admin ID (UUID) to create API key for."),
+    name: z.string().optional().describe("Name/description for the API key."),
+    expirationDate: z.string().optional().describe("Expiration date (ISO format: YYYY-MM-DD)."),
+};
+export const ApiKeyListInputSchema = {
+    adminId: z.string().describe("The admin ID (UUID) to list API keys for."),
+    page: z.number().optional().describe("Page number (default: 1)."),
+    perPage: z.number().optional().describe("Items per page (default: 25)."),
+};
+export const ApiKeyDeleteInputSchema = {
+    adminId: z.string().describe("The admin ID (UUID) that owns the API key."),
+    apiKeyId: z.string().describe("The API key ID to delete."),
+};

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

@@ -0,0 +1,20 @@
+import type { AuditLogListResponse } from "./schemas.js";
+export declare function auditList(input: {
+    page?: number;
+    perPage?: number;
+    eventType?: string;
+    entityId?: string;
+    entityType?: string;
+    username?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    store?: string;
+}): Promise<AuditLogListResponse>;
+export declare function auditExport(input: {
+    dateFrom?: string;
+    dateTo?: string;
+    page?: number;
+    perPage?: number;
+}): Promise<{
+    exportId: string;
+}>;

package/dist/tools/audit/handlers.js

@@ -0,0 +1,82 @@
+import { apiGet, apiPost } from "../../client/http.js";
+import { formatApiError, OpenLoyaltyError } from "../../utils/errors.js";
+import axios from "axios";
+export async function auditList(input) {
+    const params = new URLSearchParams();
+    if (input.page)
+        params.append("_page", String(input.page));
+    if (input.perPage)
+        params.append("_itemsOnPage", String(input.perPage));
+    if (input.eventType)
+        params.append("eventType", input.eventType);
+    if (input.entityId)
+        params.append("entityId", input.entityId);
+    if (input.entityType)
+        params.append("entityType", input.entityType);
+    if (input.username)
+        params.append("username", input.username);
+    if (input.dateFrom)
+        params.append("createdAt[gte]", input.dateFrom);
+    if (input.dateTo)
+        params.append("createdAt[lte]", input.dateTo);
+    if (input.store)
+        params.append("store", input.store);
+    const queryString = params.toString();
+    const url = `/audit/log${queryString ? `?${queryString}` : ""}`;
+    try {
+        const response = await apiGet(url);
+        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("date") || allMessages.includes("format") || allMessages.includes("created")) {
+                throw new OpenLoyaltyError({
+                    code: "INVALID_DATE_FORMAT",
+                    message: "Invalid date format in audit log filter",
+                    hint: "Use ISO 8601 format for dateFrom/dateTo: 'YYYY-MM-DDTHH:mm:ss+00:00' (e.g., '2026-01-01T00:00:00+00:00').",
+                    relatedTool: "ol_audit_list",
+                });
+            }
+        }
+        if (axios.isAxiosError(error) && error.response?.status === 403) {
+            throw new OpenLoyaltyError({
+                code: "AUDIT_PERMISSION_DENIED",
+                message: "You don't have permission to view audit logs",
+                hint: "Audit log access requires super admin privileges or the AUDIT:VIEW permission. Contact your system administrator.",
+                relatedTool: "ol_audit_list",
+            });
+        }
+        throw formatApiError(error, "ol_audit_list");
+    }
+}
+export async function auditExport(input) {
+    const payload = {};
+    const systemLogPayload = {};
+    if (input.dateFrom || input.dateTo) {
+        systemLogPayload.createdAt = {};
+        if (input.dateFrom)
+            systemLogPayload.createdAt.gte = input.dateFrom;
+        if (input.dateTo)
+            systemLogPayload.createdAt.lte = input.dateTo;
+    }
+    if (input.page)
+        systemLogPayload._page = input.page;
+    if (input.perPage)
+        systemLogPayload._itemsOnPage = input.perPage;
+    payload.systemLog = systemLogPayload;
+    try {
+        const response = await apiPost("/system-log/export", 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("date") || allMessages.includes("format") || allMessages.includes("invalid")) {
+                throw new OpenLoyaltyError({ code: "INVALID_DATE_FORMAT", message: "Invalid date format in audit export request",
+                    hint: "Use ISO 8601 format for dates: 'YYYY-MM-DDTHH:mm:ss+00:00' (e.g., '2026-01-01T00:00:00+00:00').", relatedTool: "ol_audit_export" });
+            }
+        }
+        throw formatApiError(error, "ol_audit_export");
+    }
+}

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

@@ -0,0 +1,36 @@
+export { AuditListInputSchema, AuditExportInputSchema, } from "./schemas.js";
+export type { AuditLogStore, AuditLogEntry, AuditLogListResponse, AuditExport, AuditExportListResponse, } from "./schemas.js";
+export { auditList, auditExport, } from "./handlers.js";
+import { auditList, auditExport } from "./handlers.js";
+export declare const auditToolDefinitions: readonly [{
+    readonly name: "ol_audit_list";
+    readonly title: "List Audit Logs";
+    readonly description: "List audit log entries with optional filtering. Returns paginated list of audit entries with auditLogId, eventType, entityType, entityId, username, timestamp, and details. Audit logs track all administrative actions. Use for compliance and troubleshooting.";
+    readonly readOnly: true;
+    readonly idempotent: true;
+    readonly inputSchema: {
+        page: import("zod").ZodOptional<import("zod").ZodNumber>;
+        perPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+        eventType: import("zod").ZodOptional<import("zod").ZodString>;
+        entityId: import("zod").ZodOptional<import("zod").ZodString>;
+        entityType: import("zod").ZodOptional<import("zod").ZodString>;
+        username: import("zod").ZodOptional<import("zod").ZodString>;
+        dateFrom: import("zod").ZodOptional<import("zod").ZodString>;
+        dateTo: import("zod").ZodOptional<import("zod").ZodString>;
+        store: import("zod").ZodOptional<import("zod").ZodString>;
+    };
+    readonly handler: typeof auditList;
+}, {
+    readonly name: "ol_audit_export";
+    readonly title: "Export Audit Logs";
+    readonly description: "Create an export of system logs. Returns exportId that can be used to track export status. The export will be processed asynchronously. Use date filters to scope the export range.";
+    readonly readOnly: false;
+    readonly idempotent: false;
+    readonly inputSchema: {
+        dateFrom: import("zod").ZodOptional<import("zod").ZodString>;
+        dateTo: import("zod").ZodOptional<import("zod").ZodString>;
+        page: import("zod").ZodOptional<import("zod").ZodNumber>;
+        perPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+    };
+    readonly handler: typeof auditExport;
+}];

package/dist/tools/audit/index.js

@@ -0,0 +1,28 @@
+// Re-export schemas and types
+export { AuditListInputSchema, AuditExportInputSchema, } from "./schemas.js";
+// Re-export handlers
+export { auditList, auditExport, } from "./handlers.js";
+// Imports for tool definitions
+import { AuditListInputSchema, AuditExportInputSchema, } from "./schemas.js";
+import { auditList, auditExport, } from "./handlers.js";
+// Tool definitions
+export const auditToolDefinitions = [
+    {
+        name: "ol_audit_list",
+        title: "List Audit Logs",
+        description: "List audit log entries with optional filtering. Returns paginated list of audit entries with auditLogId, eventType, entityType, entityId, username, timestamp, and details. Audit logs track all administrative actions. Use for compliance and troubleshooting.",
+        readOnly: true,
+        idempotent: true,
+        inputSchema: AuditListInputSchema,
+        handler: auditList,
+    },
+    {
+        name: "ol_audit_export",
+        title: "Export Audit Logs",
+        description: "Create an export of system logs. Returns exportId that can be used to track export status. The export will be processed asynchronously. Use date filters to scope the export range.",
+        readOnly: false,
+        idempotent: false,
+        inputSchema: AuditExportInputSchema,
+        handler: auditExport,
+    },
+];

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

@@ -0,0 +1,62 @@
+import { z } from "zod";
+export interface AuditLogStore {
+    storeId: string;
+    code: string;
+    currency?: string;
+    name: string;
+    active?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+    createdBy?: string;
+    updatedBy?: string;
+}
+export interface AuditLogEntry {
+    auditLogId: string;
+    store?: AuditLogStore;
+    eventType: string;
+    entityType: string;
+    entityId: string;
+    username: string;
+    userId?: string;
+    userType?: string;
+    ip?: string;
+    createdAt: string;
+}
+export interface AuditLogListResponse {
+    items: AuditLogEntry[];
+    total?: Record<string, unknown>;
+}
+export interface AuditExport {
+    exportId: string;
+    status: string;
+    createdAt: string;
+    finishedAt?: string;
+    criteria?: string;
+    exportedRows?: number;
+    message?: string;
+}
+export interface AuditExportListResponse {
+    items: AuditExport[];
+    total?: {
+        all?: number;
+        filtered?: number;
+        estimated?: boolean;
+    };
+}
+export declare const AuditListInputSchema: {
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    eventType: z.ZodOptional<z.ZodString>;
+    entityId: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodOptional<z.ZodString>;
+    username: z.ZodOptional<z.ZodString>;
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+    store: z.ZodOptional<z.ZodString>;
+};
+export declare const AuditExportInputSchema: {
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+};

package/dist/tools/audit/schemas.js

@@ -0,0 +1,18 @@
+import { z } from "zod";
+export const AuditListInputSchema = {
+    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."),
+    entityId: z.string().optional().describe("Filter by entity ID."),
+    entityType: z.string().optional().describe("Filter by entity type (e.g., MEMBER, CAMPAIGN)."),
+    username: z.string().optional().describe("Filter by username who performed the action."),
+    dateFrom: z.string().optional().describe("Filter by creation date from (ISO format)."),
+    dateTo: z.string().optional().describe("Filter by creation date to (ISO format)."),
+    store: z.string().optional().describe("Filter by store code."),
+};
+export const AuditExportInputSchema = {
+    dateFrom: z.string().optional().describe("Export logs from this date (ISO format)."),
+    dateTo: z.string().optional().describe("Export logs to this date (ISO format)."),
+    page: z.number().optional().describe("Page number for export."),
+    perPage: z.number().optional().describe("Items per page for export."),
+};