@open-loyalty/mcp-server 1.0.0

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

@@ -0,0 +1,542 @@
+import { z } from "zod";
+/**
+ * Date Range Schema for analytics queries.
+ */
+export declare const AnalyticsDateRangeSchema: z.ZodObject<{
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    dateFrom?: string | undefined;
+    dateTo?: string | undefined;
+}, {
+    dateFrom?: string | undefined;
+    dateTo?: string | undefined;
+}>;
+export type AnalyticsDateRange = z.infer<typeof AnalyticsDateRangeSchema>;
+/**
+ * Tier Analytics Schema.
+ * Response from GET /api/{storeCode}/analytics/levels
+ */
+export declare const TierAnalyticsItemSchema: z.ZodObject<{
+    levelId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    conditionValue: z.ZodOptional<z.ZodNumber>;
+    store: z.ZodOptional<z.ZodString>;
+    customers: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+}, "strip", z.ZodTypeAny, {
+    levelId: string;
+    name?: string | undefined;
+    conditionValue?: number | undefined;
+    store?: string | undefined;
+    customers?: number | boolean | undefined;
+}, {
+    levelId: string;
+    name?: string | undefined;
+    conditionValue?: number | undefined;
+    store?: string | undefined;
+    customers?: number | boolean | undefined;
+}>;
+export type TierAnalyticsItem = z.infer<typeof TierAnalyticsItemSchema>;
+export declare const TierAnalyticsSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        levelId: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        conditionValue: z.ZodOptional<z.ZodNumber>;
+        store: z.ZodOptional<z.ZodString>;
+        customers: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+    }, "strip", z.ZodTypeAny, {
+        levelId: string;
+        name?: string | undefined;
+        conditionValue?: number | undefined;
+        store?: string | undefined;
+        customers?: number | boolean | undefined;
+    }, {
+        levelId: string;
+        name?: string | undefined;
+        conditionValue?: number | undefined;
+        store?: string | undefined;
+        customers?: number | boolean | undefined;
+    }>, "many">;
+    total: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        levelId: string;
+        name?: string | undefined;
+        conditionValue?: number | undefined;
+        store?: string | undefined;
+        customers?: number | boolean | undefined;
+    }[];
+    total?: number | undefined;
+}, {
+    items: {
+        levelId: string;
+        name?: string | undefined;
+        conditionValue?: number | undefined;
+        store?: string | undefined;
+        customers?: number | boolean | undefined;
+    }[];
+    total?: number | undefined;
+}>;
+export type TierAnalytics = z.infer<typeof TierAnalyticsSchema>;
+/**
+ * Member Analytics Schema.
+ * Response from GET /api/{storeCode}/analytics/members
+ */
+export declare const MemberAnalyticsIntervalSchema: z.ZodObject<{
+    in_1_days: z.ZodOptional<z.ZodNumber>;
+    in_7_days: z.ZodOptional<z.ZodNumber>;
+    in_30_days: z.ZodOptional<z.ZodNumber>;
+    in_365_days: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    in_1_days?: number | undefined;
+    in_7_days?: number | undefined;
+    in_30_days?: number | undefined;
+    in_365_days?: number | undefined;
+}, {
+    in_1_days?: number | undefined;
+    in_7_days?: number | undefined;
+    in_30_days?: number | undefined;
+    in_365_days?: number | undefined;
+}>;
+export type MemberAnalyticsInterval = z.infer<typeof MemberAnalyticsIntervalSchema>;
+export declare const MemberAnalyticsSchema: z.ZodObject<{
+    intervals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        in_1_days: z.ZodOptional<z.ZodNumber>;
+        in_7_days: z.ZodOptional<z.ZodNumber>;
+        in_30_days: z.ZodOptional<z.ZodNumber>;
+        in_365_days: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        in_1_days?: number | undefined;
+        in_7_days?: number | undefined;
+        in_30_days?: number | undefined;
+        in_365_days?: number | undefined;
+    }, {
+        in_1_days?: number | undefined;
+        in_7_days?: number | undefined;
+        in_30_days?: number | undefined;
+        in_365_days?: number | undefined;
+    }>, "many">>;
+    total: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    total?: number | undefined;
+    intervals?: {
+        in_1_days?: number | undefined;
+        in_7_days?: number | undefined;
+        in_30_days?: number | undefined;
+        in_365_days?: number | undefined;
+    }[] | undefined;
+}, {
+    total?: number | undefined;
+    intervals?: {
+        in_1_days?: number | undefined;
+        in_7_days?: number | undefined;
+        in_30_days?: number | undefined;
+        in_365_days?: number | undefined;
+    }[] | undefined;
+}>;
+export type MemberAnalytics = z.infer<typeof MemberAnalyticsSchema>;
+/**
+ * Points Analytics Schema.
+ * Response from GET /api/{storeCode}/analytics/points
+ */
+export declare const PointsAnalyticsItemSchema: z.ZodObject<{
+    totalPointsActive: z.ZodOptional<z.ZodNumber>;
+    totalPointsSpent: z.ZodOptional<z.ZodNumber>;
+    totalPointsAdded: z.ZodOptional<z.ZodNumber>;
+    totalPointsExpired: z.ZodOptional<z.ZodNumber>;
+    totalPointsPending: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    totalPointsActive?: number | undefined;
+    totalPointsSpent?: number | undefined;
+    totalPointsAdded?: number | undefined;
+    totalPointsExpired?: number | undefined;
+    totalPointsPending?: number | undefined;
+}, {
+    totalPointsActive?: number | undefined;
+    totalPointsSpent?: number | undefined;
+    totalPointsAdded?: number | undefined;
+    totalPointsExpired?: number | undefined;
+    totalPointsPending?: number | undefined;
+}>;
+export type PointsAnalyticsItem = z.infer<typeof PointsAnalyticsItemSchema>;
+export declare const PointsAnalyticsSchema: z.ZodArray<z.ZodObject<{
+    totalPointsActive: z.ZodOptional<z.ZodNumber>;
+    totalPointsSpent: z.ZodOptional<z.ZodNumber>;
+    totalPointsAdded: z.ZodOptional<z.ZodNumber>;
+    totalPointsExpired: z.ZodOptional<z.ZodNumber>;
+    totalPointsPending: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    totalPointsActive?: number | undefined;
+    totalPointsSpent?: number | undefined;
+    totalPointsAdded?: number | undefined;
+    totalPointsExpired?: number | undefined;
+    totalPointsPending?: number | undefined;
+}, {
+    totalPointsActive?: number | undefined;
+    totalPointsSpent?: number | undefined;
+    totalPointsAdded?: number | undefined;
+    totalPointsExpired?: number | undefined;
+    totalPointsPending?: number | undefined;
+}>, "many">;
+export type PointsAnalytics = z.infer<typeof PointsAnalyticsSchema>;
+/**
+ * Transaction Analytics Schema.
+ * Response from GET /api/{storeCode}/analytics/transactions
+ */
+export declare const TransactionAnalyticsIntervalSchema: z.ZodObject<{
+    in_1_days: z.ZodOptional<z.ZodNumber>;
+    in_7_days: z.ZodOptional<z.ZodNumber>;
+    in_30_days: z.ZodOptional<z.ZodNumber>;
+    in_365_days: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    in_1_days?: number | undefined;
+    in_7_days?: number | undefined;
+    in_30_days?: number | undefined;
+    in_365_days?: number | undefined;
+}, {
+    in_1_days?: number | undefined;
+    in_7_days?: number | undefined;
+    in_30_days?: number | undefined;
+    in_365_days?: number | undefined;
+}>;
+export type TransactionAnalyticsInterval = z.infer<typeof TransactionAnalyticsIntervalSchema>;
+export declare const TransactionAnalyticsItemSchema: z.ZodObject<{
+    countIntervals: z.ZodOptional<z.ZodObject<{
+        in_1_days: z.ZodOptional<z.ZodNumber>;
+        in_7_days: z.ZodOptional<z.ZodNumber>;
+        in_30_days: z.ZodOptional<z.ZodNumber>;
+        in_365_days: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        in_1_days?: number | undefined;
+        in_7_days?: number | undefined;
+        in_30_days?: number | undefined;
+        in_365_days?: number | undefined;
+    }, {
+        in_1_days?: number | undefined;
+        in_7_days?: number | undefined;
+        in_30_days?: number | undefined;
+        in_365_days?: number | undefined;
+    }>>;
+    total: z.ZodOptional<z.ZodNumber>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    amountWithoutDeliveryCosts: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    total?: number | undefined;
+    countIntervals?: {
+        in_1_days?: number | undefined;
+        in_7_days?: number | undefined;
+        in_30_days?: number | undefined;
+        in_365_days?: number | undefined;
+    } | undefined;
+    amount?: number | undefined;
+    amountWithoutDeliveryCosts?: number | undefined;
+    currency?: string | undefined;
+}, {
+    total?: number | undefined;
+    countIntervals?: {
+        in_1_days?: number | undefined;
+        in_7_days?: number | undefined;
+        in_30_days?: number | undefined;
+        in_365_days?: number | undefined;
+    } | undefined;
+    amount?: number | undefined;
+    amountWithoutDeliveryCosts?: number | undefined;
+    currency?: string | undefined;
+}>;
+export type TransactionAnalyticsItem = z.infer<typeof TransactionAnalyticsItemSchema>;
+export declare const TransactionAnalyticsSchema: z.ZodArray<z.ZodObject<{
+    countIntervals: z.ZodOptional<z.ZodObject<{
+        in_1_days: z.ZodOptional<z.ZodNumber>;
+        in_7_days: z.ZodOptional<z.ZodNumber>;
+        in_30_days: z.ZodOptional<z.ZodNumber>;
+        in_365_days: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        in_1_days?: number | undefined;
+        in_7_days?: number | undefined;
+        in_30_days?: number | undefined;
+        in_365_days?: number | undefined;
+    }, {
+        in_1_days?: number | undefined;
+        in_7_days?: number | undefined;
+        in_30_days?: number | undefined;
+        in_365_days?: number | undefined;
+    }>>;
+    total: z.ZodOptional<z.ZodNumber>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    amountWithoutDeliveryCosts: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    total?: number | undefined;
+    countIntervals?: {
+        in_1_days?: number | undefined;
+        in_7_days?: number | undefined;
+        in_30_days?: number | undefined;
+        in_365_days?: number | undefined;
+    } | undefined;
+    amount?: number | undefined;
+    amountWithoutDeliveryCosts?: number | undefined;
+    currency?: string | undefined;
+}, {
+    total?: number | undefined;
+    countIntervals?: {
+        in_1_days?: number | undefined;
+        in_7_days?: number | undefined;
+        in_30_days?: number | undefined;
+        in_365_days?: number | undefined;
+    } | undefined;
+    amount?: number | undefined;
+    amountWithoutDeliveryCosts?: number | undefined;
+    currency?: string | undefined;
+}>, "many">;
+export type TransactionAnalytics = z.infer<typeof TransactionAnalyticsSchema>;
+/**
+ * Referral Analytics Schema.
+ * Response from GET /api/{storeCode}/analytics/referrals
+ */
+export declare const ReferralAnalyticsSchema: z.ZodObject<{
+    total: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    total?: number | undefined;
+}, {
+    total?: number | undefined;
+}>;
+export type ReferralAnalytics = z.infer<typeof ReferralAnalyticsSchema>;
+/**
+ * Campaign Analytics Schema.
+ * Response from GET /api/{storeCode}/analytics/campaigns
+ */
+export declare const CampaignAnalyticsItemSchema: z.ZodObject<{
+    campaignId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    executions: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    campaignId: string;
+    name?: string | undefined;
+    executions?: number | undefined;
+}, {
+    campaignId: string;
+    name?: string | undefined;
+    executions?: number | undefined;
+}>;
+export type CampaignAnalyticsItem = z.infer<typeof CampaignAnalyticsItemSchema>;
+export declare const CampaignAnalyticsSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        campaignId: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        executions: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        campaignId: string;
+        name?: string | undefined;
+        executions?: number | undefined;
+    }, {
+        campaignId: string;
+        name?: string | undefined;
+        executions?: number | undefined;
+    }>, "many">;
+    total: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        campaignId: string;
+        name?: string | undefined;
+        executions?: number | undefined;
+    }[];
+    total?: Record<string, unknown> | undefined;
+}, {
+    items: {
+        campaignId: string;
+        name?: string | undefined;
+        executions?: number | undefined;
+    }[];
+    total?: Record<string, unknown> | undefined;
+}>;
+export type CampaignAnalytics = z.infer<typeof CampaignAnalyticsSchema>;
+/**
+ * Dashboard General Overview Schema.
+ * Response from GET /api/{storeCode}/analytics/dashboard/general-overview
+ */
+export declare const DashboardHeaderSchema: z.ZodObject<{
+    registeredMembers: z.ZodOptional<z.ZodNumber>;
+    activeMembers: z.ZodOptional<z.ZodNumber>;
+    revenue: z.ZodOptional<z.ZodNumber>;
+    avgSpending: z.ZodOptional<z.ZodNumber>;
+    transactions: z.ZodOptional<z.ZodNumber>;
+    avgTransactionValue: z.ZodOptional<z.ZodNumber>;
+    avgNumberOfTransactions: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    transactions?: number | undefined;
+    registeredMembers?: number | undefined;
+    activeMembers?: number | undefined;
+    revenue?: number | undefined;
+    avgSpending?: number | undefined;
+    avgTransactionValue?: number | undefined;
+    avgNumberOfTransactions?: number | undefined;
+}, {
+    transactions?: number | undefined;
+    registeredMembers?: number | undefined;
+    activeMembers?: number | undefined;
+    revenue?: number | undefined;
+    avgSpending?: number | undefined;
+    avgTransactionValue?: number | undefined;
+    avgNumberOfTransactions?: number | undefined;
+}>;
+export type DashboardHeader = z.infer<typeof DashboardHeaderSchema>;
+export declare const DashboardOverviewSchema: z.ZodObject<{
+    intervalStartDate: z.ZodOptional<z.ZodString>;
+    intervalEndDate: z.ZodOptional<z.ZodString>;
+    header: z.ZodOptional<z.ZodObject<{
+        registeredMembers: z.ZodOptional<z.ZodNumber>;
+        activeMembers: z.ZodOptional<z.ZodNumber>;
+        revenue: z.ZodOptional<z.ZodNumber>;
+        avgSpending: z.ZodOptional<z.ZodNumber>;
+        transactions: z.ZodOptional<z.ZodNumber>;
+        avgTransactionValue: z.ZodOptional<z.ZodNumber>;
+        avgNumberOfTransactions: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        transactions?: number | undefined;
+        registeredMembers?: number | undefined;
+        activeMembers?: number | undefined;
+        revenue?: number | undefined;
+        avgSpending?: number | undefined;
+        avgTransactionValue?: number | undefined;
+        avgNumberOfTransactions?: number | undefined;
+    }, {
+        transactions?: number | undefined;
+        registeredMembers?: number | undefined;
+        activeMembers?: number | undefined;
+        revenue?: number | undefined;
+        avgSpending?: number | undefined;
+        avgTransactionValue?: number | undefined;
+        avgNumberOfTransactions?: number | undefined;
+    }>>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    aggregationType: z.ZodOptional<z.ZodEnum<["day", "week", "month"]>>;
+    dataType: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    data?: Record<string, unknown> | undefined;
+    header?: {
+        transactions?: number | undefined;
+        registeredMembers?: number | undefined;
+        activeMembers?: number | undefined;
+        revenue?: number | undefined;
+        avgSpending?: number | undefined;
+        avgTransactionValue?: number | undefined;
+        avgNumberOfTransactions?: number | undefined;
+    } | undefined;
+    intervalStartDate?: string | undefined;
+    intervalEndDate?: string | undefined;
+    aggregationType?: "day" | "week" | "month" | undefined;
+    dataType?: string | undefined;
+}, {
+    data?: Record<string, unknown> | undefined;
+    header?: {
+        transactions?: number | undefined;
+        registeredMembers?: number | undefined;
+        activeMembers?: number | undefined;
+        revenue?: number | undefined;
+        avgSpending?: number | undefined;
+        avgTransactionValue?: number | undefined;
+        avgNumberOfTransactions?: number | undefined;
+    } | undefined;
+    intervalStartDate?: string | undefined;
+    intervalEndDate?: string | undefined;
+    aggregationType?: "day" | "week" | "month" | undefined;
+    dataType?: string | undefined;
+}>;
+export type DashboardOverview = z.infer<typeof DashboardOverviewSchema>;
+/**
+ * Units Overview Schema.
+ * Response from GET /api/{storeCode}/analytics/units-overview/{walletTypeCode}
+ */
+export declare const UnitsOverviewHeaderSchema: z.ZodObject<{
+    unitsIssued: z.ZodOptional<z.ZodNumber>;
+    unitsSpent: z.ZodOptional<z.ZodNumber>;
+    unitsExpired: z.ZodOptional<z.ZodNumber>;
+    unitsPending: z.ZodOptional<z.ZodNumber>;
+    unitsActive: z.ZodOptional<z.ZodNumber>;
+    redemptionRate: z.ZodOptional<z.ZodNumber>;
+    breakageRate: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    unitsIssued?: number | undefined;
+    unitsSpent?: number | undefined;
+    unitsExpired?: number | undefined;
+    unitsPending?: number | undefined;
+    unitsActive?: number | undefined;
+    redemptionRate?: number | undefined;
+    breakageRate?: number | undefined;
+}, {
+    unitsIssued?: number | undefined;
+    unitsSpent?: number | undefined;
+    unitsExpired?: number | undefined;
+    unitsPending?: number | undefined;
+    unitsActive?: number | undefined;
+    redemptionRate?: number | undefined;
+    breakageRate?: number | undefined;
+}>;
+export type UnitsOverviewHeader = z.infer<typeof UnitsOverviewHeaderSchema>;
+export declare const UnitsOverviewSchema: z.ZodObject<{
+    intervalStartDate: z.ZodOptional<z.ZodString>;
+    intervalEndDate: z.ZodOptional<z.ZodString>;
+    walletTypeCode: z.ZodOptional<z.ZodString>;
+    header: z.ZodOptional<z.ZodObject<{
+        unitsIssued: z.ZodOptional<z.ZodNumber>;
+        unitsSpent: z.ZodOptional<z.ZodNumber>;
+        unitsExpired: z.ZodOptional<z.ZodNumber>;
+        unitsPending: z.ZodOptional<z.ZodNumber>;
+        unitsActive: z.ZodOptional<z.ZodNumber>;
+        redemptionRate: z.ZodOptional<z.ZodNumber>;
+        breakageRate: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        unitsIssued?: number | undefined;
+        unitsSpent?: number | undefined;
+        unitsExpired?: number | undefined;
+        unitsPending?: number | undefined;
+        unitsActive?: number | undefined;
+        redemptionRate?: number | undefined;
+        breakageRate?: number | undefined;
+    }, {
+        unitsIssued?: number | undefined;
+        unitsSpent?: number | undefined;
+        unitsExpired?: number | undefined;
+        unitsPending?: number | undefined;
+        unitsActive?: number | undefined;
+        redemptionRate?: number | undefined;
+        breakageRate?: number | undefined;
+    }>>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    aggregationType: z.ZodOptional<z.ZodEnum<["day", "week", "month"]>>;
+    dataType: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    data?: Record<string, unknown> | undefined;
+    header?: {
+        unitsIssued?: number | undefined;
+        unitsSpent?: number | undefined;
+        unitsExpired?: number | undefined;
+        unitsPending?: number | undefined;
+        unitsActive?: number | undefined;
+        redemptionRate?: number | undefined;
+        breakageRate?: number | undefined;
+    } | undefined;
+    intervalStartDate?: string | undefined;
+    intervalEndDate?: string | undefined;
+    aggregationType?: "day" | "week" | "month" | undefined;
+    dataType?: string | undefined;
+    walletTypeCode?: string | undefined;
+}, {
+    data?: Record<string, unknown> | undefined;
+    header?: {
+        unitsIssued?: number | undefined;
+        unitsSpent?: number | undefined;
+        unitsExpired?: number | undefined;
+        unitsPending?: number | undefined;
+        unitsActive?: number | undefined;
+        redemptionRate?: number | undefined;
+        breakageRate?: number | undefined;
+    } | undefined;
+    intervalStartDate?: string | undefined;
+    intervalEndDate?: string | undefined;
+    aggregationType?: "day" | "week" | "month" | undefined;
+    dataType?: string | undefined;
+    walletTypeCode?: string | undefined;
+}>;
+export type UnitsOverview = z.infer<typeof UnitsOverviewSchema>;

package/dist/types/schemas/analytics.js

@@ -0,0 +1,130 @@
+import { z } from "zod";
+/**
+ * Date Range Schema for analytics queries.
+ */
+export const AnalyticsDateRangeSchema = z.object({
+    dateFrom: z.string().optional().describe("Start date for analytics (ISO date format: YYYY-MM-DD)."),
+    dateTo: z.string().optional().describe("End date for analytics (ISO date format: YYYY-MM-DD)."),
+});
+/**
+ * Tier Analytics Schema.
+ * Response from GET /api/{storeCode}/analytics/levels
+ */
+export const TierAnalyticsItemSchema = z.object({
+    levelId: z.string().describe("Tier level ID."),
+    name: z.string().optional().describe("Tier name."),
+    conditionValue: z.number().optional().describe("Condition threshold value."),
+    store: z.string().optional().describe("Store code."),
+    customers: z.union([z.boolean(), z.number()]).optional().describe("Customer count or flag."),
+});
+export const TierAnalyticsSchema = z.object({
+    items: z.array(TierAnalyticsItemSchema).describe("Tier analytics data."),
+    total: z.number().optional().describe("Total count."),
+});
+/**
+ * Member Analytics Schema.
+ * Response from GET /api/{storeCode}/analytics/members
+ */
+export const MemberAnalyticsIntervalSchema = z.object({
+    in_1_days: z.number().optional().describe("Members in last 1 day."),
+    in_7_days: z.number().optional().describe("Members in last 7 days."),
+    in_30_days: z.number().optional().describe("Members in last 30 days."),
+    in_365_days: z.number().optional().describe("Members in last 365 days."),
+});
+export const MemberAnalyticsSchema = z.object({
+    intervals: z.array(MemberAnalyticsIntervalSchema).optional().describe("Member registration intervals."),
+    total: z.number().optional().describe("Total member count."),
+});
+/**
+ * Points Analytics Schema.
+ * Response from GET /api/{storeCode}/analytics/points
+ */
+export const PointsAnalyticsItemSchema = z.object({
+    totalPointsActive: z.number().optional().describe("Total active points balance."),
+    totalPointsSpent: z.number().optional().describe("Total points spent."),
+    totalPointsAdded: z.number().optional().describe("Total points added/issued."),
+    totalPointsExpired: z.number().optional().describe("Total points expired."),
+    totalPointsPending: z.number().optional().describe("Total pending/locked points."),
+});
+export const PointsAnalyticsSchema = z.array(PointsAnalyticsItemSchema);
+/**
+ * Transaction Analytics Schema.
+ * Response from GET /api/{storeCode}/analytics/transactions
+ */
+export const TransactionAnalyticsIntervalSchema = z.object({
+    in_1_days: z.number().optional().describe("Transactions in last 1 day."),
+    in_7_days: z.number().optional().describe("Transactions in last 7 days."),
+    in_30_days: z.number().optional().describe("Transactions in last 30 days."),
+    in_365_days: z.number().optional().describe("Transactions in last 365 days."),
+});
+export const TransactionAnalyticsItemSchema = z.object({
+    countIntervals: TransactionAnalyticsIntervalSchema.optional().describe("Transaction count intervals."),
+    total: z.number().optional().describe("Total transaction count."),
+    amount: z.number().optional().describe("Total transaction amount."),
+    amountWithoutDeliveryCosts: z.number().optional().describe("Amount excluding delivery."),
+    currency: z.string().optional().describe("Currency code."),
+});
+export const TransactionAnalyticsSchema = z.array(TransactionAnalyticsItemSchema);
+/**
+ * Referral Analytics Schema.
+ * Response from GET /api/{storeCode}/analytics/referrals
+ */
+export const ReferralAnalyticsSchema = z.object({
+    total: z.number().optional().describe("Total referral count."),
+});
+/**
+ * Campaign Analytics Schema.
+ * Response from GET /api/{storeCode}/analytics/campaigns
+ */
+export const CampaignAnalyticsItemSchema = z.object({
+    campaignId: z.string().describe("Campaign ID."),
+    name: z.string().optional().describe("Campaign name."),
+    executions: z.number().optional().describe("Number of campaign executions."),
+});
+export const CampaignAnalyticsSchema = z.object({
+    items: z.array(CampaignAnalyticsItemSchema).describe("Campaign execution data."),
+    total: z.record(z.string(), z.unknown()).optional().describe("Total counts."),
+});
+/**
+ * Dashboard General Overview Schema.
+ * Response from GET /api/{storeCode}/analytics/dashboard/general-overview
+ */
+export const DashboardHeaderSchema = z.object({
+    registeredMembers: z.number().optional().describe("Total registered members."),
+    activeMembers: z.number().optional().describe("Active members count."),
+    revenue: z.number().optional().describe("Total revenue."),
+    avgSpending: z.number().optional().describe("Average spending per member."),
+    transactions: z.number().optional().describe("Total transactions."),
+    avgTransactionValue: z.number().optional().describe("Average transaction value."),
+    avgNumberOfTransactions: z.number().optional().describe("Average number of transactions per member."),
+});
+export const DashboardOverviewSchema = z.object({
+    intervalStartDate: z.string().optional().describe("Start date of data interval."),
+    intervalEndDate: z.string().optional().describe("End date of data interval."),
+    header: DashboardHeaderSchema.optional().describe("Summary header metrics."),
+    data: z.record(z.string(), z.unknown()).optional().describe("Time-series data points."),
+    aggregationType: z.enum(["day", "week", "month"]).optional().describe("Aggregation granularity."),
+    dataType: z.string().optional().describe("Type of data returned."),
+});
+/**
+ * Units Overview Schema.
+ * Response from GET /api/{storeCode}/analytics/units-overview/{walletTypeCode}
+ */
+export const UnitsOverviewHeaderSchema = z.object({
+    unitsIssued: z.number().optional().describe("Total units issued."),
+    unitsSpent: z.number().optional().describe("Total units spent."),
+    unitsExpired: z.number().optional().describe("Total units expired."),
+    unitsPending: z.number().optional().describe("Total pending units."),
+    unitsActive: z.number().optional().describe("Total active units."),
+    redemptionRate: z.number().optional().describe("Redemption rate percentage."),
+    breakageRate: z.number().optional().describe("Breakage rate percentage."),
+});
+export const UnitsOverviewSchema = z.object({
+    intervalStartDate: z.string().optional().describe("Start date of data interval."),
+    intervalEndDate: z.string().optional().describe("End date of data interval."),
+    walletTypeCode: z.string().optional().describe("Wallet type code."),
+    header: UnitsOverviewHeaderSchema.optional().describe("Summary header metrics."),
+    data: z.record(z.string(), z.unknown()).optional().describe("Time-series data points."),
+    aggregationType: z.enum(["day", "week", "month"]).optional().describe("Aggregation granularity."),
+    dataType: z.string().optional().describe("Type of data returned."),
+});