@open-loyalty/mcp-server 1.0.0

package/dist/tools/achievement.d.ts

@@ -0,0 +1,983 @@
+import { z } from "zod";
+import { AchievementListItem } from "../types/schemas/achievement.js";
+export declare const AchievementListInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    name: z.ZodOptional<z.ZodString>;
+};
+export declare const AchievementCreateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    translations: z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description?: string | undefined;
+    }, {
+        name: string;
+        description?: string | undefined;
+    }>>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    activity: z.ZodOptional<z.ZodObject<{
+        startsAt: z.ZodOptional<z.ZodString>;
+        endsAt: z.ZodOptional<z.ZodString>;
+        operator: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        operator?: string | undefined;
+        startsAt?: string | undefined;
+        endsAt?: string | undefined;
+    }, {
+        operator?: string | undefined;
+        startsAt?: string | undefined;
+        endsAt?: string | undefined;
+    }>>;
+    limit: z.ZodOptional<z.ZodObject<{
+        value: z.ZodOptional<z.ZodNumber>;
+        interval: z.ZodOptional<z.ZodObject<{
+            type: z.ZodString;
+            value: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            value?: number | undefined;
+        }, {
+            type: string;
+            value?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        value?: number | undefined;
+        interval?: {
+            type: string;
+            value?: number | undefined;
+        } | undefined;
+    }, {
+        value?: number | undefined;
+        interval?: {
+            type: string;
+            value?: number | undefined;
+        } | undefined;
+    }>>;
+    rules: z.ZodArray<z.ZodObject<{
+        achievementRuleId: z.ZodOptional<z.ZodString>;
+        translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description?: string | undefined;
+        }, {
+            name: string;
+            description?: string | undefined;
+        }>>>;
+        trigger: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        event: z.ZodOptional<z.ZodString>;
+        completeRule: z.ZodObject<{
+            periodGoal: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+            period: z.ZodOptional<z.ZodObject<{
+                consecutive: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                value?: number | undefined;
+                consecutive?: number | undefined;
+            }, {
+                value?: number | undefined;
+                consecutive?: number | undefined;
+            }>>;
+            uniqueAttribute: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            periodGoal: string | number;
+            period?: {
+                value?: number | undefined;
+                consecutive?: number | undefined;
+            } | undefined;
+            uniqueAttribute?: string | undefined;
+        }, {
+            periodGoal: string | number;
+            period?: {
+                value?: number | undefined;
+                consecutive?: number | undefined;
+            } | undefined;
+            uniqueAttribute?: string | undefined;
+        }>;
+        aggregation: z.ZodOptional<z.ZodObject<{
+            rule: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            rule?: string | undefined;
+        }, {
+            rule?: string | undefined;
+        }>>;
+        conditions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        limit: z.ZodOptional<z.ZodObject<{
+            value: z.ZodOptional<z.ZodNumber>;
+            interval: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                value: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                value?: number | undefined;
+            }, {
+                type: string;
+                value?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        }, {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        }>>;
+        uniqueReferee: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        completeRule: {
+            periodGoal: string | number;
+            period?: {
+                value?: number | undefined;
+                consecutive?: number | undefined;
+            } | undefined;
+            uniqueAttribute?: string | undefined;
+        };
+        type?: string | undefined;
+        conditions?: Record<string, unknown>[] | undefined;
+        translations?: Record<string, {
+            name: string;
+            description?: string | undefined;
+        }> | undefined;
+        trigger?: string | undefined;
+        event?: string | undefined;
+        achievementRuleId?: string | undefined;
+        aggregation?: {
+            rule?: string | undefined;
+        } | undefined;
+        limit?: {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        } | undefined;
+        uniqueReferee?: boolean | undefined;
+    }, {
+        completeRule: {
+            periodGoal: string | number;
+            period?: {
+                value?: number | undefined;
+                consecutive?: number | undefined;
+            } | undefined;
+            uniqueAttribute?: string | undefined;
+        };
+        type?: string | undefined;
+        conditions?: Record<string, unknown>[] | undefined;
+        translations?: Record<string, {
+            name: string;
+            description?: string | undefined;
+        }> | undefined;
+        trigger?: string | undefined;
+        event?: string | undefined;
+        achievementRuleId?: string | undefined;
+        aggregation?: {
+            rule?: string | undefined;
+        } | undefined;
+        limit?: {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        } | undefined;
+        uniqueReferee?: boolean | undefined;
+    }>, "many">;
+    badgeTypeId: z.ZodOptional<z.ZodString>;
+};
+export declare const AchievementGetInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    achievementId: z.ZodString;
+};
+export declare const AchievementUpdateInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    achievementId: z.ZodString;
+    translations: z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description?: string | undefined;
+    }, {
+        name: string;
+        description?: string | undefined;
+    }>>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    activity: z.ZodOptional<z.ZodObject<{
+        startsAt: z.ZodOptional<z.ZodString>;
+        endsAt: z.ZodOptional<z.ZodString>;
+        operator: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        operator?: string | undefined;
+        startsAt?: string | undefined;
+        endsAt?: string | undefined;
+    }, {
+        operator?: string | undefined;
+        startsAt?: string | undefined;
+        endsAt?: string | undefined;
+    }>>;
+    limit: z.ZodOptional<z.ZodObject<{
+        value: z.ZodOptional<z.ZodNumber>;
+        interval: z.ZodOptional<z.ZodObject<{
+            type: z.ZodString;
+            value: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            value?: number | undefined;
+        }, {
+            type: string;
+            value?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        value?: number | undefined;
+        interval?: {
+            type: string;
+            value?: number | undefined;
+        } | undefined;
+    }, {
+        value?: number | undefined;
+        interval?: {
+            type: string;
+            value?: number | undefined;
+        } | undefined;
+    }>>;
+    rules: z.ZodArray<z.ZodObject<{
+        achievementRuleId: z.ZodOptional<z.ZodString>;
+        translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description?: string | undefined;
+        }, {
+            name: string;
+            description?: string | undefined;
+        }>>>;
+        trigger: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        event: z.ZodOptional<z.ZodString>;
+        completeRule: z.ZodObject<{
+            periodGoal: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+            period: z.ZodOptional<z.ZodObject<{
+                consecutive: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                value?: number | undefined;
+                consecutive?: number | undefined;
+            }, {
+                value?: number | undefined;
+                consecutive?: number | undefined;
+            }>>;
+            uniqueAttribute: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            periodGoal: string | number;
+            period?: {
+                value?: number | undefined;
+                consecutive?: number | undefined;
+            } | undefined;
+            uniqueAttribute?: string | undefined;
+        }, {
+            periodGoal: string | number;
+            period?: {
+                value?: number | undefined;
+                consecutive?: number | undefined;
+            } | undefined;
+            uniqueAttribute?: string | undefined;
+        }>;
+        aggregation: z.ZodOptional<z.ZodObject<{
+            rule: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            rule?: string | undefined;
+        }, {
+            rule?: string | undefined;
+        }>>;
+        conditions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        limit: z.ZodOptional<z.ZodObject<{
+            value: z.ZodOptional<z.ZodNumber>;
+            interval: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                value: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                value?: number | undefined;
+            }, {
+                type: string;
+                value?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        }, {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        }>>;
+        uniqueReferee: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        completeRule: {
+            periodGoal: string | number;
+            period?: {
+                value?: number | undefined;
+                consecutive?: number | undefined;
+            } | undefined;
+            uniqueAttribute?: string | undefined;
+        };
+        type?: string | undefined;
+        conditions?: Record<string, unknown>[] | undefined;
+        translations?: Record<string, {
+            name: string;
+            description?: string | undefined;
+        }> | undefined;
+        trigger?: string | undefined;
+        event?: string | undefined;
+        achievementRuleId?: string | undefined;
+        aggregation?: {
+            rule?: string | undefined;
+        } | undefined;
+        limit?: {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        } | undefined;
+        uniqueReferee?: boolean | undefined;
+    }, {
+        completeRule: {
+            periodGoal: string | number;
+            period?: {
+                value?: number | undefined;
+                consecutive?: number | undefined;
+            } | undefined;
+            uniqueAttribute?: string | undefined;
+        };
+        type?: string | undefined;
+        conditions?: Record<string, unknown>[] | undefined;
+        translations?: Record<string, {
+            name: string;
+            description?: string | undefined;
+        }> | undefined;
+        trigger?: string | undefined;
+        event?: string | undefined;
+        achievementRuleId?: string | undefined;
+        aggregation?: {
+            rule?: string | undefined;
+        } | undefined;
+        limit?: {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        } | undefined;
+        uniqueReferee?: boolean | undefined;
+    }>, "many">;
+    badgeTypeId: z.ZodOptional<z.ZodString>;
+};
+export declare const AchievementPatchInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    achievementId: z.ZodString;
+    active: z.ZodOptional<z.ZodBoolean>;
+    translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name?: string | undefined;
+        description?: string | undefined;
+    }, {
+        name?: string | undefined;
+        description?: string | undefined;
+    }>>>;
+};
+export declare const AchievementGetMemberProgressInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    memberId: z.ZodString;
+    achievementId: z.ZodString;
+};
+export declare const AchievementListMemberAchievementsInputSchema: {
+    storeCode: z.ZodOptional<z.ZodString>;
+    memberId: z.ZodString;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodOptional<z.ZodString>;
+    achievementId: z.ZodOptional<z.ZodString>;
+};
+export declare function achievementList(input: {
+    storeCode?: string;
+    page?: number;
+    perPage?: number;
+    active?: boolean;
+    name?: string;
+}): Promise<{
+    achievements: AchievementListItem[];
+    total: {
+        all?: number;
+        filtered?: number;
+    };
+}>;
+interface AchievementCreateInput {
+    storeCode?: string;
+    translations: Record<string, {
+        name: string;
+        description?: string;
+    }>;
+    active?: boolean;
+    activity?: {
+        startsAt?: string;
+        endsAt?: string;
+        operator?: string;
+    };
+    limit?: {
+        value?: number;
+        interval?: {
+            type: string;
+            value?: number;
+        };
+    };
+    rules: Array<Record<string, unknown>>;
+    badgeTypeId?: string;
+}
+export declare function achievementCreate(input: AchievementCreateInput): Promise<{
+    achievementId: string;
+}>;
+export declare function achievementGet(input: {
+    storeCode?: string;
+    achievementId: string;
+}): Promise<Record<string, unknown>>;
+interface AchievementUpdateInput {
+    storeCode?: string;
+    achievementId: string;
+    translations: Record<string, {
+        name: string;
+        description?: string;
+    }>;
+    active?: boolean;
+    activity?: {
+        startsAt?: string;
+        endsAt?: string;
+        operator?: string;
+    };
+    limit?: {
+        value?: number;
+        interval?: {
+            type: string;
+            value?: number;
+        };
+    };
+    rules: Array<Record<string, unknown>>;
+    badgeTypeId?: string;
+}
+export declare function achievementUpdate(input: AchievementUpdateInput): Promise<void>;
+interface AchievementPatchInput {
+    storeCode?: string;
+    achievementId: string;
+    active?: boolean;
+    translations?: Record<string, {
+        name?: string;
+        description?: string;
+    }>;
+}
+export declare function achievementPatch(input: AchievementPatchInput): Promise<void>;
+interface AchievementMemberProgress {
+    achievementId: string;
+    achievementName?: string;
+    achievementDescription?: string;
+    limitReached?: boolean;
+    memberProgress: {
+        completedCount: number;
+        rules: Array<{
+            achievementRuleId: string;
+            periodGoal: number;
+            currentPeriodValue: number;
+            consecutivePeriods?: number;
+            completedConsecutivePeriods?: number;
+            periodType?: string;
+            type?: string;
+            trigger?: string;
+            periodValue?: number;
+        }>;
+    };
+}
+export declare function achievementGetMemberProgress(input: {
+    storeCode?: string;
+    memberId: string;
+    achievementId: string;
+}): Promise<AchievementMemberProgress>;
+export declare function achievementListMemberAchievements(input: {
+    storeCode?: string;
+    memberId: string;
+    page?: number;
+    perPage?: number;
+    name?: string;
+    achievementId?: string;
+}): Promise<{
+    achievements: AchievementMemberProgress[];
+    total: {
+        all?: number;
+        filtered?: number;
+    };
+}>;
+export declare const achievementToolDefinitions: readonly [{
+    readonly name: "openloyalty_achievement_list";
+    readonly description: "List achievements. Achievements gamify member behavior by setting goals (e.g., 'Make 5 purchases this month'). Returns achievementId, name, active status, and associated badge. Use achievement_get for full rules and configuration.";
+    readonly inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+        page: z.ZodOptional<z.ZodNumber>;
+        perPage: z.ZodOptional<z.ZodNumber>;
+        active: z.ZodOptional<z.ZodBoolean>;
+        name: z.ZodOptional<z.ZodString>;
+    };
+    readonly handler: typeof achievementList;
+}, {
+    readonly name: "openloyalty_achievement_create";
+    readonly description: "Create achievement with rules that track member progress. Triggers: transaction (purchases), custom_event (custom actions), points_transfer, referral, etc. CompleteRule sets the goal: periodGoal (target value) with optional period (consecutive periods). Example - '5 purchases/month': rules: [{ trigger: 'transaction', completeRule: { periodGoal: 5, period: { value: 1, consecutive: 1 } } }]";
+    readonly inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+        translations: z.ZodRecord<z.ZodString, z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description?: string | undefined;
+        }, {
+            name: string;
+            description?: string | undefined;
+        }>>;
+        active: z.ZodOptional<z.ZodBoolean>;
+        activity: z.ZodOptional<z.ZodObject<{
+            startsAt: z.ZodOptional<z.ZodString>;
+            endsAt: z.ZodOptional<z.ZodString>;
+            operator: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            operator?: string | undefined;
+            startsAt?: string | undefined;
+            endsAt?: string | undefined;
+        }, {
+            operator?: string | undefined;
+            startsAt?: string | undefined;
+            endsAt?: string | undefined;
+        }>>;
+        limit: z.ZodOptional<z.ZodObject<{
+            value: z.ZodOptional<z.ZodNumber>;
+            interval: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                value: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                value?: number | undefined;
+            }, {
+                type: string;
+                value?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        }, {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        }>>;
+        rules: z.ZodArray<z.ZodObject<{
+            achievementRuleId: z.ZodOptional<z.ZodString>;
+            translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                description?: string | undefined;
+            }, {
+                name: string;
+                description?: string | undefined;
+            }>>>;
+            trigger: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            completeRule: z.ZodObject<{
+                periodGoal: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+                period: z.ZodOptional<z.ZodObject<{
+                    consecutive: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    value?: number | undefined;
+                    consecutive?: number | undefined;
+                }, {
+                    value?: number | undefined;
+                    consecutive?: number | undefined;
+                }>>;
+                uniqueAttribute: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                periodGoal: string | number;
+                period?: {
+                    value?: number | undefined;
+                    consecutive?: number | undefined;
+                } | undefined;
+                uniqueAttribute?: string | undefined;
+            }, {
+                periodGoal: string | number;
+                period?: {
+                    value?: number | undefined;
+                    consecutive?: number | undefined;
+                } | undefined;
+                uniqueAttribute?: string | undefined;
+            }>;
+            aggregation: z.ZodOptional<z.ZodObject<{
+                rule: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                rule?: string | undefined;
+            }, {
+                rule?: string | undefined;
+            }>>;
+            conditions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+            limit: z.ZodOptional<z.ZodObject<{
+                value: z.ZodOptional<z.ZodNumber>;
+                interval: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodString;
+                    value: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    type: string;
+                    value?: number | undefined;
+                }, {
+                    type: string;
+                    value?: number | undefined;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                value?: number | undefined;
+                interval?: {
+                    type: string;
+                    value?: number | undefined;
+                } | undefined;
+            }, {
+                value?: number | undefined;
+                interval?: {
+                    type: string;
+                    value?: number | undefined;
+                } | undefined;
+            }>>;
+            uniqueReferee: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            completeRule: {
+                periodGoal: string | number;
+                period?: {
+                    value?: number | undefined;
+                    consecutive?: number | undefined;
+                } | undefined;
+                uniqueAttribute?: string | undefined;
+            };
+            type?: string | undefined;
+            conditions?: Record<string, unknown>[] | undefined;
+            translations?: Record<string, {
+                name: string;
+                description?: string | undefined;
+            }> | undefined;
+            trigger?: string | undefined;
+            event?: string | undefined;
+            achievementRuleId?: string | undefined;
+            aggregation?: {
+                rule?: string | undefined;
+            } | undefined;
+            limit?: {
+                value?: number | undefined;
+                interval?: {
+                    type: string;
+                    value?: number | undefined;
+                } | undefined;
+            } | undefined;
+            uniqueReferee?: boolean | undefined;
+        }, {
+            completeRule: {
+                periodGoal: string | number;
+                period?: {
+                    value?: number | undefined;
+                    consecutive?: number | undefined;
+                } | undefined;
+                uniqueAttribute?: string | undefined;
+            };
+            type?: string | undefined;
+            conditions?: Record<string, unknown>[] | undefined;
+            translations?: Record<string, {
+                name: string;
+                description?: string | undefined;
+            }> | undefined;
+            trigger?: string | undefined;
+            event?: string | undefined;
+            achievementRuleId?: string | undefined;
+            aggregation?: {
+                rule?: string | undefined;
+            } | undefined;
+            limit?: {
+                value?: number | undefined;
+                interval?: {
+                    type: string;
+                    value?: number | undefined;
+                } | undefined;
+            } | undefined;
+            uniqueReferee?: boolean | undefined;
+        }>, "many">;
+        badgeTypeId: z.ZodOptional<z.ZodString>;
+    };
+    readonly handler: typeof achievementCreate;
+}, {
+    readonly name: "openloyalty_achievement_get";
+    readonly description: "Get achievement details including all rules, conditions, activity period, limits, and completions count.";
+    readonly inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+        achievementId: z.ZodString;
+    };
+    readonly handler: typeof achievementGet;
+}, {
+    readonly name: "openloyalty_achievement_update";
+    readonly description: "Update achievement configuration. Requires full achievement object (translations, rules). Use achievement_get first to retrieve current configuration.";
+    readonly inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+        achievementId: z.ZodString;
+        translations: z.ZodRecord<z.ZodString, z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description?: string | undefined;
+        }, {
+            name: string;
+            description?: string | undefined;
+        }>>;
+        active: z.ZodOptional<z.ZodBoolean>;
+        activity: z.ZodOptional<z.ZodObject<{
+            startsAt: z.ZodOptional<z.ZodString>;
+            endsAt: z.ZodOptional<z.ZodString>;
+            operator: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            operator?: string | undefined;
+            startsAt?: string | undefined;
+            endsAt?: string | undefined;
+        }, {
+            operator?: string | undefined;
+            startsAt?: string | undefined;
+            endsAt?: string | undefined;
+        }>>;
+        limit: z.ZodOptional<z.ZodObject<{
+            value: z.ZodOptional<z.ZodNumber>;
+            interval: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                value: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                value?: number | undefined;
+            }, {
+                type: string;
+                value?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        }, {
+            value?: number | undefined;
+            interval?: {
+                type: string;
+                value?: number | undefined;
+            } | undefined;
+        }>>;
+        rules: z.ZodArray<z.ZodObject<{
+            achievementRuleId: z.ZodOptional<z.ZodString>;
+            translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                description?: string | undefined;
+            }, {
+                name: string;
+                description?: string | undefined;
+            }>>>;
+            trigger: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            completeRule: z.ZodObject<{
+                periodGoal: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+                period: z.ZodOptional<z.ZodObject<{
+                    consecutive: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    value?: number | undefined;
+                    consecutive?: number | undefined;
+                }, {
+                    value?: number | undefined;
+                    consecutive?: number | undefined;
+                }>>;
+                uniqueAttribute: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                periodGoal: string | number;
+                period?: {
+                    value?: number | undefined;
+                    consecutive?: number | undefined;
+                } | undefined;
+                uniqueAttribute?: string | undefined;
+            }, {
+                periodGoal: string | number;
+                period?: {
+                    value?: number | undefined;
+                    consecutive?: number | undefined;
+                } | undefined;
+                uniqueAttribute?: string | undefined;
+            }>;
+            aggregation: z.ZodOptional<z.ZodObject<{
+                rule: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                rule?: string | undefined;
+            }, {
+                rule?: string | undefined;
+            }>>;
+            conditions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+            limit: z.ZodOptional<z.ZodObject<{
+                value: z.ZodOptional<z.ZodNumber>;
+                interval: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodString;
+                    value: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    type: string;
+                    value?: number | undefined;
+                }, {
+                    type: string;
+                    value?: number | undefined;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                value?: number | undefined;
+                interval?: {
+                    type: string;
+                    value?: number | undefined;
+                } | undefined;
+            }, {
+                value?: number | undefined;
+                interval?: {
+                    type: string;
+                    value?: number | undefined;
+                } | undefined;
+            }>>;
+            uniqueReferee: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            completeRule: {
+                periodGoal: string | number;
+                period?: {
+                    value?: number | undefined;
+                    consecutive?: number | undefined;
+                } | undefined;
+                uniqueAttribute?: string | undefined;
+            };
+            type?: string | undefined;
+            conditions?: Record<string, unknown>[] | undefined;
+            translations?: Record<string, {
+                name: string;
+                description?: string | undefined;
+            }> | undefined;
+            trigger?: string | undefined;
+            event?: string | undefined;
+            achievementRuleId?: string | undefined;
+            aggregation?: {
+                rule?: string | undefined;
+            } | undefined;
+            limit?: {
+                value?: number | undefined;
+                interval?: {
+                    type: string;
+                    value?: number | undefined;
+                } | undefined;
+            } | undefined;
+            uniqueReferee?: boolean | undefined;
+        }, {
+            completeRule: {
+                periodGoal: string | number;
+                period?: {
+                    value?: number | undefined;
+                    consecutive?: number | undefined;
+                } | undefined;
+                uniqueAttribute?: string | undefined;
+            };
+            type?: string | undefined;
+            conditions?: Record<string, unknown>[] | undefined;
+            translations?: Record<string, {
+                name: string;
+                description?: string | undefined;
+            }> | undefined;
+            trigger?: string | undefined;
+            event?: string | undefined;
+            achievementRuleId?: string | undefined;
+            aggregation?: {
+                rule?: string | undefined;
+            } | undefined;
+            limit?: {
+                value?: number | undefined;
+                interval?: {
+                    type: string;
+                    value?: number | undefined;
+                } | undefined;
+            } | undefined;
+            uniqueReferee?: boolean | undefined;
+        }>, "many">;
+        badgeTypeId: z.ZodOptional<z.ZodString>;
+    };
+    readonly handler: typeof achievementUpdate;
+}, {
+    readonly name: "openloyalty_achievement_patch";
+    readonly description: "Partial update of achievement. Use for simple changes like activating/deactivating or updating translations without providing full rules.";
+    readonly inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+        achievementId: z.ZodString;
+        active: z.ZodOptional<z.ZodBoolean>;
+        translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name?: string | undefined;
+            description?: string | undefined;
+        }, {
+            name?: string | undefined;
+            description?: string | undefined;
+        }>>>;
+    };
+    readonly handler: typeof achievementPatch;
+}, {
+    readonly name: "openloyalty_achievement_get_member_progress";
+    readonly description: "Get member's progress on a specific achievement. Returns completedCount, and for each rule: periodGoal, currentPeriodValue, and consecutive period tracking.";
+    readonly inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+        memberId: z.ZodString;
+        achievementId: z.ZodString;
+    };
+    readonly handler: typeof achievementGetMemberProgress;
+}, {
+    readonly name: "openloyalty_achievement_list_member_achievements";
+    readonly description: "List all achievements with member's progress. Returns each achievement's status, completion count, and per-rule progress. Use for displaying gamification dashboard.";
+    readonly inputSchema: {
+        storeCode: z.ZodOptional<z.ZodString>;
+        memberId: z.ZodString;
+        page: z.ZodOptional<z.ZodNumber>;
+        perPage: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodOptional<z.ZodString>;
+        achievementId: z.ZodOptional<z.ZodString>;
+    };
+    readonly handler: typeof achievementListMemberAchievements;
+}];
+export {};