@open-loyalty/mcp-server 1.3.7 → 1.5.3

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

@@ -253,11 +253,11 @@ export declare const CampaignVisibilitySchema: z.ZodObject<{
     tiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     segments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    target: "all" | "segment" | "tier";
+    target: "all" | "tier" | "segment";
     tiers?: string[] | undefined;
     segments?: string[] | undefined;
 }, {
-    target: "all" | "segment" | "tier";
+    target: "all" | "tier" | "segment";
     tiers?: string[] | undefined;
     segments?: string[] | undefined;
 }>;
@@ -267,11 +267,11 @@ export declare const CampaignAudienceSchema: z.ZodObject<{
     tiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     segments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    target: "all" | "segment" | "tier";
+    target: "all" | "tier" | "segment";
     tiers?: string[] | undefined;
     segments?: string[] | undefined;
 }, {
-    target: "all" | "segment" | "tier";
+    target: "all" | "tier" | "segment";
     tiers?: string[] | undefined;
     segments?: string[] | undefined;
 }>;
@@ -733,11 +733,11 @@ export declare const CampaignSchema: z.ZodObject<{
         tiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         segments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
-        target: "all" | "segment" | "tier";
+        target: "all" | "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     }, {
-        target: "all" | "segment" | "tier";
+        target: "all" | "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     }>>;
@@ -746,11 +746,11 @@ export declare const CampaignSchema: z.ZodObject<{
         tiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         segments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
-        target: "all" | "segment" | "tier";
+        target: "all" | "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     }, {
-        target: "all" | "segment" | "tier";
+        target: "all" | "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     }>>;
@@ -1040,7 +1040,7 @@ export declare const CampaignSchema: z.ZodObject<{
         endsAt?: string | undefined;
     } | undefined;
     visibility?: {
-        target: "all" | "segment" | "tier";
+        target: "all" | "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     } | undefined;
@@ -1049,7 +1049,7 @@ export declare const CampaignSchema: z.ZodObject<{
         key: string;
     }[] | undefined;
     audience?: {
-        target: "all" | "segment" | "tier";
+        target: "all" | "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     } | undefined;
@@ -1140,7 +1140,7 @@ export declare const CampaignSchema: z.ZodObject<{
         endsAt?: string | undefined;
     } | undefined;
     visibility?: {
-        target: "all" | "segment" | "tier";
+        target: "all" | "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     } | undefined;
@@ -1149,7 +1149,7 @@ export declare const CampaignSchema: z.ZodObject<{
         key: string;
     }[] | undefined;
     audience?: {
-        target: "all" | "segment" | "tier";
+        target: "all" | "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     } | undefined;

package/dist/types/schemas/common.js

@@ -3,7 +3,7 @@ import { z } from "zod";
  * Common storeCode schema used across all tools.
  * Extracted to single source of truth to avoid 86+ duplications.
  */
-export const StoreCodeSchema = z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store.");
+export const StoreCodeSchema = z.string().optional().describe("INTERNAL: Auto-filled from server settings when configured. NEVER prompt for this. Only set if no default is configured or user explicitly requests a different store.");
 /**
  * Common schema for paginated list responses.
  * The Open Loyalty API returns total in varying formats depending on the endpoint:

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

@@ -68,9 +68,11 @@ export declare const MemberSchema: z.ZodObject<{
     levelName: z.ZodOptional<z.ZodString>;
     points: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    email: string;
     active: boolean;
+    email: string;
     memberId: string;
+    createdAt?: string | undefined;
+    points?: number | undefined;
     phone?: string | undefined;
     address?: {
         street?: string | undefined;
@@ -84,17 +86,17 @@ export declare const MemberSchema: z.ZodObject<{
     lastName?: string | undefined;
     birthDate?: string | undefined;
     gender?: "male" | "female" | "not_disclosed" | undefined;
-    createdAt?: string | undefined;
-    points?: number | undefined;
     levelId?: string | undefined;
     agreement1?: boolean | undefined;
     agreement2?: boolean | undefined;
     agreement3?: boolean | undefined;
     levelName?: string | undefined;
 }, {
-    email: string;
     active: boolean;
+    email: string;
     memberId: string;
+    createdAt?: string | undefined;
+    points?: number | undefined;
     phone?: string | undefined;
     address?: {
         street?: string | undefined;
@@ -108,8 +110,6 @@ export declare const MemberSchema: z.ZodObject<{
     lastName?: string | undefined;
     birthDate?: string | undefined;
     gender?: "male" | "female" | "not_disclosed" | undefined;
-    createdAt?: string | undefined;
-    points?: number | undefined;
     levelId?: string | undefined;
     agreement1?: boolean | undefined;
     agreement2?: boolean | undefined;
@@ -129,28 +129,28 @@ export declare const MemberListItemSchema: z.ZodObject<{
     createdAt: z.ZodOptional<z.ZodString>;
     registeredAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    email: string;
     active: boolean;
+    email: string;
     customerId: string;
+    createdAt?: string | undefined;
     phone?: string | undefined;
     loyaltyCardNumber?: string | undefined;
     firstName?: string | undefined;
     lastName?: string | undefined;
     birthDate?: string | undefined;
     gender?: string | undefined;
-    createdAt?: string | undefined;
     registeredAt?: string | undefined;
 }, {
-    email: string;
     active: boolean;
+    email: string;
     customerId: string;
+    createdAt?: string | undefined;
     phone?: string | undefined;
     loyaltyCardNumber?: string | undefined;
     firstName?: string | undefined;
     lastName?: string | undefined;
     birthDate?: string | undefined;
     gender?: string | undefined;
-    createdAt?: string | undefined;
     registeredAt?: string | undefined;
 }>;
 export declare const MemberListResponseSchema: z.ZodObject<{
@@ -167,28 +167,28 @@ export declare const MemberListResponseSchema: z.ZodObject<{
         createdAt: z.ZodOptional<z.ZodString>;
         registeredAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        email: string;
         active: boolean;
+        email: string;
         customerId: string;
+        createdAt?: string | undefined;
         phone?: string | undefined;
         loyaltyCardNumber?: string | undefined;
         firstName?: string | undefined;
         lastName?: string | undefined;
         birthDate?: string | undefined;
         gender?: string | undefined;
-        createdAt?: string | undefined;
         registeredAt?: string | undefined;
     }, {
-        email: string;
         active: boolean;
+        email: string;
         customerId: string;
+        createdAt?: string | undefined;
         phone?: string | undefined;
         loyaltyCardNumber?: string | undefined;
         firstName?: string | undefined;
         lastName?: string | undefined;
         birthDate?: string | undefined;
         gender?: string | undefined;
-        createdAt?: string | undefined;
         registeredAt?: string | undefined;
     }>, "many">;
     total: z.ZodObject<{
@@ -206,16 +206,16 @@ export declare const MemberListResponseSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">>;
 }, "strip", z.ZodTypeAny, {
     items: {
-        email: string;
         active: boolean;
+        email: string;
         customerId: string;
+        createdAt?: string | undefined;
         phone?: string | undefined;
         loyaltyCardNumber?: string | undefined;
         firstName?: string | undefined;
         lastName?: string | undefined;
         birthDate?: string | undefined;
         gender?: string | undefined;
-        createdAt?: string | undefined;
         registeredAt?: string | undefined;
     }[];
     total: {
@@ -227,16 +227,16 @@ export declare const MemberListResponseSchema: z.ZodObject<{
     };
 }, {
     items: {
-        email: string;
         active: boolean;
+        email: string;
         customerId: string;
+        createdAt?: string | undefined;
         phone?: string | undefined;
         loyaltyCardNumber?: string | undefined;
         firstName?: string | undefined;
         lastName?: string | undefined;
         birthDate?: string | undefined;
         gender?: string | undefined;
-        createdAt?: string | undefined;
         registeredAt?: string | undefined;
     }[];
     total: {

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

@@ -56,9 +56,9 @@ export declare const RoleSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     id: string | number;
+    default?: boolean | undefined;
     role?: string | undefined;
     master?: boolean | undefined;
-    default?: boolean | undefined;
     permissions?: {
         resource: string;
         access: string;
@@ -70,9 +70,9 @@ export declare const RoleSchema: z.ZodObject<{
 }, {
     name: string;
     id: string | number;
+    default?: boolean | undefined;
     role?: string | undefined;
     master?: boolean | undefined;
-    default?: boolean | undefined;
     permissions?: {
         resource: string;
         access: string;
@@ -116,9 +116,9 @@ export declare const RoleListItemSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     id: string | number;
+    default?: boolean | undefined;
     role?: string | undefined;
     master?: boolean | undefined;
-    default?: boolean | undefined;
     permissions?: {
         resource: string;
         access: string;
@@ -130,9 +130,9 @@ export declare const RoleListItemSchema: z.ZodObject<{
 }, {
     name: string;
     id: string | number;
+    default?: boolean | undefined;
     role?: string | undefined;
     master?: boolean | undefined;
-    default?: boolean | undefined;
     permissions?: {
         resource: string;
         access: string;

package/dist/types/schemas/tierset.js

@@ -6,7 +6,8 @@ export const TierSetAttributeEnum = z.enum([
     "totalSpending",
     "monthsSinceJoiningProgram",
     "cumulatedEarnedUnits",
-]);
+]).describe("Condition attribute. IMPORTANT: The field name is 'attribute', NOT 'type'. " +
+    "Valid values: activeUnits, totalEarnedUnits, totalSpending, monthsSinceJoiningProgram, cumulatedEarnedUnits.");
 // Condition schema for tier set - API uses 'id' not 'conditionId'
 export const TierSetConditionSchema = z.object({
     id: z.string(),

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

@@ -141,6 +141,7 @@ export declare const TransactionCustomerDataSchema: z.ZodObject<{
         address1?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
     email?: string | undefined;
     phone?: string | undefined;
     address?: {
@@ -152,10 +153,10 @@ export declare const TransactionCustomerDataSchema: z.ZodObject<{
         address1?: string | undefined;
     } | undefined;
     loyaltyCardNumber?: string | undefined;
-    name?: string | undefined;
     customerId?: string | undefined;
     nip?: string | undefined;
 }, {
+    name?: string | undefined;
     email?: string | undefined;
     phone?: string | undefined;
     address?: {
@@ -167,7 +168,6 @@ export declare const TransactionCustomerDataSchema: z.ZodObject<{
         address1?: string | undefined;
     } | undefined;
     loyaltyCardNumber?: string | undefined;
-    name?: string | undefined;
     customerId?: string | undefined;
     nip?: string | undefined;
 }>;
@@ -283,6 +283,7 @@ export declare const TransactionSchema: z.ZodObject<{
             address1?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
+        name?: string | undefined;
         email?: string | undefined;
         phone?: string | undefined;
         address?: {
@@ -294,10 +295,10 @@ export declare const TransactionSchema: z.ZodObject<{
             address1?: string | undefined;
         } | undefined;
         loyaltyCardNumber?: string | undefined;
-        name?: string | undefined;
         customerId?: string | undefined;
         nip?: string | undefined;
     }, {
+        name?: string | undefined;
         email?: string | undefined;
         phone?: string | undefined;
         address?: {
@@ -309,7 +310,6 @@ export declare const TransactionSchema: z.ZodObject<{
             address1?: string | undefined;
         } | undefined;
         loyaltyCardNumber?: string | undefined;
-        name?: string | undefined;
         customerId?: string | undefined;
         nip?: string | undefined;
     }>>;
@@ -349,6 +349,7 @@ export declare const TransactionSchema: z.ZodObject<{
     createdAt?: string | undefined;
     customerId?: string | undefined;
     customerData?: {
+        name?: string | undefined;
         email?: string | undefined;
         phone?: string | undefined;
         address?: {
@@ -360,7 +361,6 @@ export declare const TransactionSchema: z.ZodObject<{
             address1?: string | undefined;
         } | undefined;
         loyaltyCardNumber?: string | undefined;
-        name?: string | undefined;
         customerId?: string | undefined;
         nip?: string | undefined;
     } | undefined;
@@ -396,6 +396,7 @@ export declare const TransactionSchema: z.ZodObject<{
     createdAt?: string | undefined;
     customerId?: string | undefined;
     customerData?: {
+        name?: string | undefined;
         email?: string | undefined;
         phone?: string | undefined;
         address?: {
@@ -407,7 +408,6 @@ export declare const TransactionSchema: z.ZodObject<{
             address1?: string | undefined;
         } | undefined;
         loyaltyCardNumber?: string | undefined;
-        name?: string | undefined;
         customerId?: string | undefined;
         nip?: string | undefined;
     } | undefined;
@@ -526,6 +526,7 @@ export declare const TransactionListResponseSchema: z.ZodObject<{
                 address1?: string | undefined;
             }>>;
         }, "strip", z.ZodTypeAny, {
+            name?: string | undefined;
             email?: string | undefined;
             phone?: string | undefined;
             address?: {
@@ -537,10 +538,10 @@ export declare const TransactionListResponseSchema: z.ZodObject<{
                 address1?: string | undefined;
             } | undefined;
             loyaltyCardNumber?: string | undefined;
-            name?: string | undefined;
             customerId?: string | undefined;
             nip?: string | undefined;
         }, {
+            name?: string | undefined;
             email?: string | undefined;
             phone?: string | undefined;
             address?: {
@@ -552,7 +553,6 @@ export declare const TransactionListResponseSchema: z.ZodObject<{
                 address1?: string | undefined;
             } | undefined;
             loyaltyCardNumber?: string | undefined;
-            name?: string | undefined;
             customerId?: string | undefined;
             nip?: string | undefined;
         }>>;
@@ -592,6 +592,7 @@ export declare const TransactionListResponseSchema: z.ZodObject<{
         createdAt?: string | undefined;
         customerId?: string | undefined;
         customerData?: {
+            name?: string | undefined;
             email?: string | undefined;
             phone?: string | undefined;
             address?: {
@@ -603,7 +604,6 @@ export declare const TransactionListResponseSchema: z.ZodObject<{
                 address1?: string | undefined;
             } | undefined;
             loyaltyCardNumber?: string | undefined;
-            name?: string | undefined;
             customerId?: string | undefined;
             nip?: string | undefined;
         } | undefined;
@@ -639,6 +639,7 @@ export declare const TransactionListResponseSchema: z.ZodObject<{
         createdAt?: string | undefined;
         customerId?: string | undefined;
         customerData?: {
+            name?: string | undefined;
             email?: string | undefined;
             phone?: string | undefined;
             address?: {
@@ -650,7 +651,6 @@ export declare const TransactionListResponseSchema: z.ZodObject<{
                 address1?: string | undefined;
             } | undefined;
             loyaltyCardNumber?: string | undefined;
-            name?: string | undefined;
             customerId?: string | undefined;
             nip?: string | undefined;
         } | undefined;
@@ -701,6 +701,7 @@ export declare const TransactionListResponseSchema: z.ZodObject<{
         createdAt?: string | undefined;
         customerId?: string | undefined;
         customerData?: {
+            name?: string | undefined;
             email?: string | undefined;
             phone?: string | undefined;
             address?: {
@@ -712,7 +713,6 @@ export declare const TransactionListResponseSchema: z.ZodObject<{
                 address1?: string | undefined;
             } | undefined;
             loyaltyCardNumber?: string | undefined;
-            name?: string | undefined;
             customerId?: string | undefined;
             nip?: string | undefined;
         } | undefined;
@@ -757,6 +757,7 @@ export declare const TransactionListResponseSchema: z.ZodObject<{
         createdAt?: string | undefined;
         customerId?: string | undefined;
         customerData?: {
+            name?: string | undefined;
             email?: string | undefined;
             phone?: string | undefined;
             address?: {
@@ -768,7 +769,6 @@ export declare const TransactionListResponseSchema: z.ZodObject<{
                 address1?: string | undefined;
             } | undefined;
             loyaltyCardNumber?: string | undefined;
-            name?: string | undefined;
             customerId?: string | undefined;
             nip?: string | undefined;
         } | undefined;

package/dist/types/schemas/wallet-type.js

@@ -30,10 +30,10 @@ export const WalletTypeCreateResponseSchema = z.object({
 // INPUT SCHEMAS (for MCP tool definitions)
 // =============================================================================
 export const WalletTypeListInputSchema = {
-    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    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 WalletTypeGetInputSchema = {
-    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    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."),
     walletTypeId: z.string().describe("The wallet type ID (UUID) to retrieve."),
 };
 // Translations schema for wallet types
@@ -59,17 +59,19 @@ export const WalletTypeLimitsInputSchema = z.object({
     pointsPerMember: PointsLimitSchema.describe("Per-member points limit. Example: { interval: { type: 'calendarYears', value: 1 }, value: 10000 }"),
 }).optional();
 export const WalletTypeCreateInputSchema = {
-    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    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."),
     translations: WalletTypeTranslationsInputSchema.describe("Translations with at least 'en' key containing { name }. REQUIRED."),
     unitSingularName: z.string().describe("Singular unit name (e.g., 'point', 'coin', 'star'). REQUIRED."),
     unitPluralName: z.string().describe("Plural unit name (e.g., 'points', 'coins', 'stars'). REQUIRED."),
-    unitDaysExpiryAfter: z.string().describe("⚠️ REQUIRED. Days after earning before points expire. Use 'all_time_active' for never-expiring points, " +
-        "or a number string like '365' for points that expire 365 days after earning."),
+    unitDaysExpiryAfter: z.string().describe("Days after earning before points expire. REQUIRED. " +
+        "BUSINESS DECISION: 'all_time_active' = points never expire (growing financial liability on balance sheet). " +
+        "'365' = standard 1-year expiry (controls liability). " +
+        "BUSINESS IMPACT: Never-expiring points accumulate as balance sheet liability."),
     code: z.string().optional().describe("Unique code for the wallet type (e.g., 'bonus_points', 'store_credit'). " +
         "Use lowercase with underscores. If not provided, a code will be auto-generated. " +
         "IMPORTANT: Cannot be changed after creation."),
     allowNegativeBalance: z.boolean().optional().describe("Whether to allow negative balances (default: false). " +
-        "Set to true for credit-like systems where members can owe points."),
+        "BUSINESS DECISION: Allowing negative balances creates credit risk. Should never be defaulted to true."),
     unitExpiryDate: z.string().optional().describe("Annual expiry date in 'MM-DD' format (e.g., '12-31' for end of year). " +
         "Points earned during the year expire on this date. " +
         "IMPORTANT: Use 'MM-DD' format, NOT 'YYYY-MM-DD'."),
@@ -77,12 +79,12 @@ export const WalletTypeCreateInputSchema = {
     unitYearsActiveCount: z.number().int().nonnegative().optional().describe("Number of years points remain active after earning."),
     unitDaysLocked: z.number().int().nonnegative().optional().describe("Number of days points are PENDING (locked) after earning before becoming spendable. " +
         "Only used when allTimeNotLocked is false. Example: 7 for a 7-day pending period."),
-    allTimeNotLocked: z.boolean().optional().describe("⭐ PENDING METHOD: Set to TRUE for 'No pending' (points immediately available). " +
-        "Set to FALSE (or omit) for 'Pending for X days' mode, then set unitDaysLocked to the number of days. " +
-        "This maps to the 'Unit pending method' dropdown in the UI."),
+    allTimeNotLocked: z.boolean().optional().describe("BUSINESS DECISION: true = points immediately available (better member experience). " +
+        "false = pending period for fraud/return protection (set unitDaysLocked for duration). " +
+        "Typical values: true for low-risk programs, false + 14-day lock for high-value transactions."),
 };
 export const WalletTypeUpdateInputSchema = {
-    storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
+    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."),
     walletTypeId: z.string().describe("The wallet type ID (UUID) to update."),
     name: z.string().optional().describe("Update the wallet type name (updates translations.en.name)."),
     description: z.string().optional().describe("Update the description (updates translations.en.description)."),

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

@@ -29,20 +29,20 @@ export declare const WebhookSubscriptionSchema: z.ZodObject<{
     url: string;
     eventName: string;
     webhookSubscriptionId: string;
+    createdAt?: string | undefined;
     headers?: {
         headerName: string;
         headerValue: string;
     }[] | undefined;
-    createdAt?: string | undefined;
 }, {
     url: string;
     eventName: string;
     webhookSubscriptionId: string;
+    createdAt?: string | undefined;
     headers?: {
         headerName: string;
         headerValue: string;
     }[] | undefined;
-    createdAt?: string | undefined;
 }>;
 export type WebhookSubscription = z.infer<typeof WebhookSubscriptionSchema>;
 export declare const WebhookEventTypesSchema: z.ZodObject<{
@@ -73,20 +73,20 @@ export declare const WebhookSubscriptionListResponseSchema: z.ZodObject<{
         url: string;
         eventName: string;
         webhookSubscriptionId: string;
+        createdAt?: string | undefined;
         headers?: {
             headerName: string;
             headerValue: string;
         }[] | undefined;
-        createdAt?: string | undefined;
     }, {
         url: string;
         eventName: string;
         webhookSubscriptionId: string;
+        createdAt?: string | undefined;
         headers?: {
             headerName: string;
             headerValue: string;
         }[] | undefined;
-        createdAt?: string | undefined;
     }>, "many">;
     total: z.ZodOptional<z.ZodObject<{
         all: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
@@ -106,11 +106,11 @@ export declare const WebhookSubscriptionListResponseSchema: z.ZodObject<{
         url: string;
         eventName: string;
         webhookSubscriptionId: string;
+        createdAt?: string | undefined;
         headers?: {
             headerName: string;
             headerValue: string;
         }[] | undefined;
-        createdAt?: string | undefined;
     }[];
     total?: {
         all?: string | number | undefined;
@@ -122,11 +122,11 @@ export declare const WebhookSubscriptionListResponseSchema: z.ZodObject<{
         url: string;
         eventName: string;
         webhookSubscriptionId: string;
+        createdAt?: string | undefined;
         headers?: {
             headerName: string;
             headerValue: string;
         }[] | undefined;
-        createdAt?: string | undefined;
     }[];
     total?: {
         all?: string | number | undefined;

package/dist/utils/errors.js

@@ -28,6 +28,22 @@ export function formatApiError(error, relatedTool) {
                 relatedTool,
             });
         }
+        if (status === 401) {
+            return new OpenLoyaltyError({
+                code: "UNAUTHORIZED",
+                message: "Authentication failed or token expired",
+                hint: "The API token may be invalid or expired. Check the OL_API_TOKEN environment variable. If using OAuth, the token may need to be refreshed.",
+                relatedTool,
+            });
+        }
+        if (status === 403) {
+            return new OpenLoyaltyError({
+                code: "PERMISSION_DENIED",
+                message: "You don't have permission for this operation",
+                hint: "The current admin user lacks the required permission. Use ol_admin_get_permissions() to check available permissions, or contact an admin with higher privileges.",
+                relatedTool,
+            });
+        }
         if (status === 400) {
             const errors = data?.errors;
             const errorDetails = errors?.map(e => `${e.path || ''}: ${e.message}`).join('; ') || '';
@@ -72,6 +88,30 @@ export function formatApiError(error, relatedTool) {
                 relatedTool,
             });
         }
+        if (status === 409) {
+            return new OpenLoyaltyError({
+                code: "CONFLICT",
+                message: data?.message ? String(data.message) : "Resource conflict - the resource may already exist or be in use",
+                hint: "A resource with this identifier already exists, or the resource is in a conflicting state. Try listing existing resources first.",
+                relatedTool,
+            });
+        }
+        if (status === 429) {
+            return new OpenLoyaltyError({
+                code: "RATE_LIMITED",
+                message: "Too many requests - rate limit exceeded",
+                hint: "Wait a few seconds and retry the request. If doing bulk operations, add delays between requests.",
+                relatedTool,
+            });
+        }
+        if (status && status >= 500) {
+            return new OpenLoyaltyError({
+                code: "SERVER_ERROR",
+                message: `API server error (HTTP ${status})`,
+                hint: "This is a server-side error, not a problem with your request. Wait a moment and retry. If the error persists, the API may be experiencing downtime.",
+                relatedTool,
+            });
+        }
         return new OpenLoyaltyError({
             code: `HTTP_${status || "UNKNOWN"}`,
             message: error.message,