@htlkg/data 0.0.24 → 0.0.25

package/dist/index-ZmmFz38a.d.ts

@@ -0,0 +1,1089 @@
+import { C as CreateAuditFields, a as UpdateWithSoftDeleteFields } from './common-DSxswsZ3.js';
+import { Brand, Account, User, SystemSettings, Contact } from '@htlkg/core/types';
+import './productInstances-BpQv1oLS.js';
+import './reservations-CdDfkcZ_.js';
+import { z } from 'zod';
+
+/**
+ * Brand Mutation Functions
+ *
+ * Provides mutation functions for creating, updating, and deleting brands.
+ */
+
+/**
+ * Input type for creating a brand
+ */
+interface CreateBrandInput extends CreateAuditFields {
+    accountId: string;
+    name: string;
+    logo?: string;
+    timezone?: string;
+    status?: "active" | "inactive" | "maintenance" | "suspended" | "deleted";
+    settings?: Record<string, any>;
+}
+/**
+ * Input type for updating a brand
+ */
+interface UpdateBrandInput extends UpdateWithSoftDeleteFields {
+    id: string;
+    name?: string;
+    logo?: string;
+    timezone?: string;
+    status?: "active" | "inactive" | "maintenance" | "suspended" | "deleted";
+    settings?: Record<string, any>;
+}
+/**
+ * Create a new brand
+ *
+ * @example
+ * ```typescript
+ * import { createBrand } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const brand = await createBrand(client, {
+ *   accountId: 'account-123',
+ *   name: 'My Brand',
+ *   timezone: 'America/New_York',
+ *   status: 'active'
+ * });
+ * ```
+ */
+declare function createBrand<TClient = any>(client: TClient, input: CreateBrandInput): Promise<Brand | null>;
+/**
+ * Update an existing brand
+ *
+ * @example
+ * ```typescript
+ * import { updateBrand } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const brand = await updateBrand(client, {
+ *   id: 'brand-123',
+ *   name: 'Updated Brand Name',
+ *   status: 'maintenance'
+ * });
+ * ```
+ */
+declare function updateBrand<TClient = any>(client: TClient, input: UpdateBrandInput): Promise<Brand | null>;
+/**
+ * Soft delete a brand (sets status to "deleted" instead of removing)
+ *
+ * @example
+ * ```typescript
+ * import { softDeleteBrand } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * await softDeleteBrand(client, 'brand-123', 'admin@example.com');
+ * ```
+ */
+declare function softDeleteBrand<TClient = any>(client: TClient, id: string, deletedBy: string): Promise<boolean>;
+/**
+ * Restore a soft-deleted brand (sets status back to "active")
+ * Checks retention period before allowing restoration
+ *
+ * @example
+ * ```typescript
+ * import { restoreBrand } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * await restoreBrand(client, 'brand-123');
+ * // Or with custom retention days:
+ * await restoreBrand(client, 'brand-123', 60);
+ * ```
+ */
+declare function restoreBrand<TClient = any>(client: TClient, id: string, retentionDays?: number): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Hard delete a brand (permanently removes from database)
+ * Use with caution - prefer softDeleteBrand for recoverable deletion
+ *
+ * @example
+ * ```typescript
+ * import { deleteBrand } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * await deleteBrand(client, 'brand-123');
+ * ```
+ */
+declare function deleteBrand<TClient = any>(client: TClient, id: string): Promise<boolean>;
+
+/**
+ * Account Mutation Functions
+ *
+ * Provides mutation functions for creating, updating, and deleting accounts.
+ */
+
+/**
+ * Input type for creating an account
+ */
+interface CreateAccountInput extends CreateAuditFields {
+    name: string;
+    logo?: string;
+    subscription?: Record<string, any>;
+    settings?: Record<string, any>;
+    status?: "active" | "inactive" | "deleted";
+}
+/**
+ * Input type for updating an account
+ */
+interface UpdateAccountInput extends UpdateWithSoftDeleteFields {
+    id: string;
+    name?: string;
+    logo?: string;
+    subscription?: Record<string, any>;
+    settings?: Record<string, any>;
+    status?: "active" | "inactive" | "deleted";
+}
+/**
+ * Create a new account
+ *
+ * @example
+ * ```typescript
+ * import { createAccount } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const account = await createAccount(client, {
+ *   name: 'My Account',
+ *   subscription: { plan: 'premium' }
+ * });
+ * ```
+ */
+declare function createAccount<TClient = any>(client: TClient, input: CreateAccountInput): Promise<Account | null>;
+/**
+ * Update an existing account
+ *
+ * @example
+ * ```typescript
+ * import { updateAccount } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const account = await updateAccount(client, {
+ *   id: 'account-123',
+ *   name: 'Updated Account Name'
+ * });
+ * ```
+ */
+declare function updateAccount<TClient = any>(client: TClient, input: UpdateAccountInput): Promise<Account | null>;
+/**
+ * Soft delete an account (sets status to "deleted" instead of removing)
+ *
+ * @example
+ * ```typescript
+ * import { softDeleteAccount } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * await softDeleteAccount(client, 'account-123', 'admin@example.com');
+ * ```
+ */
+declare function softDeleteAccount<TClient = any>(client: TClient, id: string, deletedBy: string): Promise<boolean>;
+/**
+ * Restore a soft-deleted account (sets status back to "active")
+ * Checks retention period before allowing restoration
+ *
+ * @example
+ * ```typescript
+ * import { restoreAccount } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * await restoreAccount(client, 'account-123');
+ * // Or with custom retention days:
+ * await restoreAccount(client, 'account-123', 60);
+ * ```
+ */
+declare function restoreAccount<TClient = any>(client: TClient, id: string, retentionDays?: number): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Hard delete an account (permanently removes from database)
+ * Use with caution - prefer softDeleteAccount for recoverable deletion
+ *
+ * @example
+ * ```typescript
+ * import { deleteAccount } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * await deleteAccount(client, 'account-123');
+ * ```
+ */
+declare function deleteAccount<TClient = any>(client: TClient, id: string): Promise<boolean>;
+
+/**
+ * User Mutation Functions
+ *
+ * Provides mutation functions for creating, updating, and deleting users.
+ */
+
+/**
+ * Input type for creating a user
+ */
+interface CreateUserInput extends CreateAuditFields {
+    cognitoId: string;
+    email: string;
+    accountId: string;
+    brandIds?: string[];
+    roles?: string[];
+    permissions?: Record<string, any>;
+    status?: "active" | "inactive" | "pending" | "suspended" | "deleted";
+}
+/**
+ * Input type for updating a user
+ */
+interface UpdateUserInput extends UpdateWithSoftDeleteFields {
+    id: string;
+    email?: string;
+    brandIds?: string[];
+    roles?: string[];
+    permissions?: Record<string, any>;
+    lastLogin?: string;
+    status?: "active" | "inactive" | "pending" | "suspended" | "deleted";
+}
+/**
+ * Create a new user
+ *
+ * @example
+ * ```typescript
+ * import { createUser } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const user = await createUser(client, {
+ *   cognitoId: 'cognito-123',
+ *   email: 'user@example.com',
+ *   accountId: 'account-123',
+ *   roles: ['BRAND_ADMIN'],
+ *   status: 'active'
+ * });
+ * ```
+ */
+declare function createUser<TClient = any>(client: TClient, input: CreateUserInput): Promise<User | null>;
+/**
+ * Update an existing user
+ *
+ * @example
+ * ```typescript
+ * import { updateUser } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const user = await updateUser(client, {
+ *   id: 'user-123',
+ *   roles: ['BRAND_ADMIN', 'ACCOUNT_ADMIN'],
+ *   status: 'active'
+ * });
+ * ```
+ */
+declare function updateUser<TClient = any>(client: TClient, input: UpdateUserInput): Promise<User | null>;
+/**
+ * Soft delete a user (sets status to "deleted" instead of removing)
+ *
+ * @example
+ * ```typescript
+ * import { softDeleteUser } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * await softDeleteUser(client, 'user-123', 'admin@example.com');
+ * ```
+ */
+declare function softDeleteUser<TClient = any>(client: TClient, id: string, deletedBy: string): Promise<boolean>;
+/**
+ * Restore a soft-deleted user (sets status back to "active")
+ * Checks retention period before allowing restoration
+ *
+ * @example
+ * ```typescript
+ * import { restoreUser } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * await restoreUser(client, 'user-123');
+ * // Or with custom retention days:
+ * await restoreUser(client, 'user-123', 60);
+ * ```
+ */
+declare function restoreUser<TClient = any>(client: TClient, id: string, retentionDays?: number): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Hard delete a user (permanently removes from database)
+ * Use with caution - prefer softDeleteUser for recoverable deletion
+ *
+ * @example
+ * ```typescript
+ * import { deleteUser } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * await deleteUser(client, 'user-123');
+ * ```
+ */
+declare function deleteUser<TClient = any>(client: TClient, id: string): Promise<boolean>;
+
+/**
+ * SystemSettings Mutation Functions
+ *
+ * Provides mutation functions for managing system settings.
+ */
+
+/**
+ * Input type for updating system settings
+ */
+interface UpdateSystemSettingsInput {
+    softDeleteRetentionDays: number;
+    updatedBy: string;
+}
+/**
+ * Update or create system settings
+ * Only SUPER_ADMINS can update system settings
+ *
+ * @example
+ * ```typescript
+ * import { updateSystemSettings } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const settings = await updateSystemSettings(client, {
+ *   softDeleteRetentionDays: 60,
+ *   updatedBy: 'admin@example.com'
+ * });
+ * ```
+ */
+declare function updateSystemSettings<TClient = any>(client: TClient, input: UpdateSystemSettingsInput): Promise<SystemSettings | null>;
+/**
+ * Initialize system settings with default values if they don't exist
+ *
+ * @example
+ * ```typescript
+ * import { initializeSystemSettings } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const settings = await initializeSystemSettings(client, 'system@hotelinking.com');
+ * ```
+ */
+declare function initializeSystemSettings<TClient = any>(client: TClient, initializedBy: string): Promise<SystemSettings | null>;
+
+/**
+ * Contact Validation Schemas
+ *
+ * Comprehensive Zod validation schemas for Contact entities.
+ * Includes field-level validators, custom field schemas, and complete entity schemas.
+ *
+ * @module @htlkg/data/validation/contact.schemas
+ */
+
+/**
+ * Email validation schema
+ * - Must be valid email format
+ * - Transforms to lowercase for consistency
+ * - Max 254 characters (RFC 5321)
+ */
+declare const emailSchema: z.ZodString;
+/**
+ * Optional email validation schema
+ * Same rules as emailSchema but allows undefined
+ */
+declare const optionalEmailSchema: z.ZodOptional<z.ZodString>;
+declare const phoneSchema: z.ZodString;
+/**
+ * Optional phone validation schema
+ * Validates format only if value is provided and non-empty
+ */
+declare const optionalPhoneSchema: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
+declare const firstNameSchema: z.ZodString;
+/**
+ * Last name validation schema
+ * - Required, 1-100 characters
+ * - Trims whitespace
+ * - Allows Unicode letters, spaces, hyphens, apostrophes
+ */
+declare const lastNameSchema: z.ZodString;
+/**
+ * Optional first name validation schema
+ */
+declare const optionalFirstNameSchema: z.ZodOptional<z.ZodString>;
+/**
+ * Optional last name validation schema
+ */
+declare const optionalLastNameSchema: z.ZodOptional<z.ZodString>;
+declare const localeSchema: z.ZodString;
+/**
+ * Optional locale validation schema
+ */
+declare const optionalLocaleSchema: z.ZodOptional<z.ZodString>;
+/**
+ * ISO 8601 date string validation schema
+ * Validates date strings in ISO 8601 format
+ */
+declare const isoDateStringSchema: z.ZodEffects<z.ZodString, string, string>;
+/**
+ * Optional ISO 8601 date string validation schema
+ */
+declare const optionalIsoDateStringSchema: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+/**
+ * UUID validation schema
+ */
+declare const uuidSchema: z.ZodUnion<[z.ZodString, z.ZodString]>;
+/**
+ * Brand ID validation schema
+ */
+declare const brandIdSchema: z.ZodString;
+/**
+ * Tag validation schema
+ * - Non-empty string
+ * - Max 50 characters per tag
+ * - Trimmed and lowercased for consistency
+ */
+declare const tagSchema: z.ZodString;
+/**
+ * Tags array validation schema
+ * - Array of valid tags
+ * - Max 100 tags per contact
+ */
+declare const tagsArraySchema: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+/**
+ * Supported custom field types
+ */
+declare const CustomFieldType: {
+    readonly STRING: "string";
+    readonly NUMBER: "number";
+    readonly BOOLEAN: "boolean";
+    readonly DATE: "date";
+    readonly ARRAY: "array";
+    readonly OBJECT: "object";
+};
+type CustomFieldTypeValue = (typeof CustomFieldType)[keyof typeof CustomFieldType];
+/**
+ * Custom field definition schema
+ * Defines the structure for a single custom field
+ */
+declare const customFieldDefinitionSchema: z.ZodObject<{
+    type: z.ZodEnum<["string", "number", "boolean", "date", "array", "object"]>;
+    required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    minLength: z.ZodOptional<z.ZodNumber>;
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    pattern: z.ZodOptional<z.ZodString>;
+    enum: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "string" | "number" | "boolean" | "object" | "date" | "array";
+    required: boolean;
+    maxLength?: number | undefined;
+    minLength?: number | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    pattern?: string | undefined;
+    enum?: (string | number)[] | undefined;
+}, {
+    type: "string" | "number" | "boolean" | "object" | "date" | "array";
+    required?: boolean | undefined;
+    maxLength?: number | undefined;
+    minLength?: number | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    pattern?: string | undefined;
+    enum?: (string | number)[] | undefined;
+}>;
+type CustomFieldDefinition = z.infer<typeof customFieldDefinitionSchema>;
+/**
+ * Custom field value schema
+ * Validates a value based on its field definition
+ */
+declare function createCustomFieldValueSchema(definition: CustomFieldDefinition): z.ZodTypeAny;
+/**
+ * Contact preferences schema
+ * Validates the preferences Record with type-safe structure
+ *
+ * Known preference fields with validation:
+ * - theme: "light" | "dark" | "system"
+ * - language: BCP 47 locale
+ * - notifications: { email: boolean, sms: boolean, push: boolean }
+ * - communication: { preferredChannel: "email" | "phone" | "sms" }
+ * - Other fields: any valid JSON value
+ */
+declare const contactPreferencesSchema: z.ZodEffects<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodAny, "many">, z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodNull]>>>, Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined, Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined>;
+/**
+ * Notification preferences sub-schema
+ */
+declare const notificationPreferencesSchema: z.ZodObject<{
+    email: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    sms: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    push: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    push: boolean;
+    email: boolean;
+    sms: boolean;
+}, {
+    push?: boolean | undefined;
+    email?: boolean | undefined;
+    sms?: boolean | undefined;
+}>;
+/**
+ * Communication preferences sub-schema
+ */
+declare const communicationPreferencesSchema: z.ZodObject<{
+    preferredChannel: z.ZodDefault<z.ZodOptional<z.ZodEnum<["email", "phone", "sms"]>>>;
+}, "strip", z.ZodTypeAny, {
+    preferredChannel: "email" | "phone" | "sms";
+}, {
+    preferredChannel?: "email" | "phone" | "sms" | undefined;
+}>;
+/**
+ * Create Contact Schema
+ * Full validation for creating a new contact
+ */
+declare const createContactSchema: z.ZodObject<{
+    createdAt: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    createdBy: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    updatedBy: z.ZodOptional<z.ZodString>;
+    brandId: z.ZodString;
+    email: z.ZodString;
+    phone: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    locale: z.ZodOptional<z.ZodString>;
+    gdprConsent: z.ZodBoolean;
+    gdprConsentDate: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    marketingOptIn: z.ZodOptional<z.ZodBoolean>;
+    preferences: z.ZodEffects<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodAny, "many">, z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodNull]>>>, Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined, Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    totalVisits: z.ZodOptional<z.ZodNumber>;
+    lastVisitDate: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    firstVisitDate: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    legacyId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    brandId: string;
+    email: string;
+    lastName: string;
+    firstName: string;
+    gdprConsent: boolean;
+    updatedAt?: string | undefined;
+    updatedBy?: string | undefined;
+    phone?: string | undefined;
+    createdAt?: string | undefined;
+    createdBy?: string | undefined;
+    locale?: string | undefined;
+    gdprConsentDate?: string | undefined;
+    marketingOptIn?: boolean | undefined;
+    preferences?: Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined;
+    tags?: string[] | undefined;
+    totalVisits?: number | undefined;
+    lastVisitDate?: string | undefined;
+    firstVisitDate?: string | undefined;
+    legacyId?: string | undefined;
+}, {
+    brandId: string;
+    email: string;
+    lastName: string;
+    firstName: string;
+    gdprConsent: boolean;
+    updatedAt?: string | undefined;
+    updatedBy?: string | undefined;
+    phone?: string | undefined;
+    createdAt?: string | undefined;
+    createdBy?: string | undefined;
+    locale?: string | undefined;
+    gdprConsentDate?: string | undefined;
+    marketingOptIn?: boolean | undefined;
+    preferences?: Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined;
+    tags?: string[] | undefined;
+    totalVisits?: number | undefined;
+    lastVisitDate?: string | undefined;
+    firstVisitDate?: string | undefined;
+    legacyId?: string | undefined;
+}>;
+/**
+ * Update Contact Schema
+ * Partial validation for updating an existing contact
+ * All fields except 'id' are optional
+ */
+declare const updateContactSchema: z.ZodObject<{
+    updatedAt: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    updatedBy: z.ZodOptional<z.ZodString>;
+    deletedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deletedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodString;
+    brandId: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    phone: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
+    firstName: z.ZodOptional<z.ZodString>;
+    lastName: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodString>;
+    gdprConsent: z.ZodOptional<z.ZodBoolean>;
+    gdprConsentDate: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    marketingOptIn: z.ZodOptional<z.ZodBoolean>;
+    preferences: z.ZodEffects<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodAny, "many">, z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodNull]>>>, Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined, Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    totalVisits: z.ZodOptional<z.ZodNumber>;
+    lastVisitDate: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    firstVisitDate: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    legacyId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    updatedAt?: string | undefined;
+    updatedBy?: string | undefined;
+    brandId?: string | undefined;
+    deletedAt?: string | null | undefined;
+    deletedBy?: string | null | undefined;
+    email?: string | undefined;
+    phone?: string | undefined;
+    lastName?: string | undefined;
+    firstName?: string | undefined;
+    locale?: string | undefined;
+    gdprConsent?: boolean | undefined;
+    gdprConsentDate?: string | undefined;
+    marketingOptIn?: boolean | undefined;
+    preferences?: Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined;
+    tags?: string[] | undefined;
+    totalVisits?: number | undefined;
+    lastVisitDate?: string | undefined;
+    firstVisitDate?: string | undefined;
+    legacyId?: string | undefined;
+}, {
+    id: string;
+    updatedAt?: string | undefined;
+    updatedBy?: string | undefined;
+    brandId?: string | undefined;
+    deletedAt?: string | null | undefined;
+    deletedBy?: string | null | undefined;
+    email?: string | undefined;
+    phone?: string | undefined;
+    lastName?: string | undefined;
+    firstName?: string | undefined;
+    locale?: string | undefined;
+    gdprConsent?: boolean | undefined;
+    gdprConsentDate?: string | undefined;
+    marketingOptIn?: boolean | undefined;
+    preferences?: Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined;
+    tags?: string[] | undefined;
+    totalVisits?: number | undefined;
+    lastVisitDate?: string | undefined;
+    firstVisitDate?: string | undefined;
+    legacyId?: string | undefined;
+}>;
+/**
+ * Merge Contacts Schema
+ * Validation for merging duplicate contacts
+ */
+declare const mergeContactsSchema: z.ZodObject<{
+    primaryId: z.ZodString;
+    duplicateIds: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    primaryId: string;
+    duplicateIds: string[];
+}, {
+    primaryId: string;
+    duplicateIds: string[];
+}>;
+/**
+ * Search/Filter Contact Schema
+ * Validation for contact search and filter operations
+ */
+declare const searchContactSchema: z.ZodObject<{
+    brandId: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    firstName: z.ZodOptional<z.ZodString>;
+    lastName: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    gdprConsent: z.ZodOptional<z.ZodBoolean>;
+    marketingOptIn: z.ZodOptional<z.ZodBoolean>;
+    includeDeleted: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    nextToken: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    includeDeleted: boolean;
+    brandId?: string | undefined;
+    nextToken?: string | undefined;
+    email?: string | undefined;
+    phone?: string | undefined;
+    lastName?: string | undefined;
+    firstName?: string | undefined;
+    gdprConsent?: boolean | undefined;
+    marketingOptIn?: boolean | undefined;
+    tags?: string[] | undefined;
+    search?: string | undefined;
+}, {
+    brandId?: string | undefined;
+    nextToken?: string | undefined;
+    limit?: number | undefined;
+    email?: string | undefined;
+    phone?: string | undefined;
+    lastName?: string | undefined;
+    firstName?: string | undefined;
+    gdprConsent?: boolean | undefined;
+    marketingOptIn?: boolean | undefined;
+    tags?: string[] | undefined;
+    search?: string | undefined;
+    includeDeleted?: boolean | undefined;
+}>;
+/**
+ * Bulk Import Contact Schema
+ * Validation for importing contacts in bulk
+ */
+declare const bulkImportContactSchema: z.ZodObject<{
+    contacts: z.ZodArray<z.ZodObject<Omit<{
+        createdAt: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        createdBy: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        updatedBy: z.ZodOptional<z.ZodString>;
+        brandId: z.ZodString;
+        email: z.ZodString;
+        phone: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
+        firstName: z.ZodString;
+        lastName: z.ZodString;
+        locale: z.ZodOptional<z.ZodString>;
+        gdprConsent: z.ZodBoolean;
+        gdprConsentDate: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        marketingOptIn: z.ZodOptional<z.ZodBoolean>;
+        preferences: z.ZodEffects<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodAny, "many">, z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodNull]>>>, Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined, Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        totalVisits: z.ZodOptional<z.ZodNumber>;
+        lastVisitDate: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        firstVisitDate: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        legacyId: z.ZodOptional<z.ZodString>;
+    }, "updatedAt" | "updatedBy" | "createdAt" | "createdBy">, "strip", z.ZodTypeAny, {
+        brandId: string;
+        email: string;
+        lastName: string;
+        firstName: string;
+        gdprConsent: boolean;
+        phone?: string | undefined;
+        locale?: string | undefined;
+        gdprConsentDate?: string | undefined;
+        marketingOptIn?: boolean | undefined;
+        preferences?: Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined;
+        tags?: string[] | undefined;
+        totalVisits?: number | undefined;
+        lastVisitDate?: string | undefined;
+        firstVisitDate?: string | undefined;
+        legacyId?: string | undefined;
+    }, {
+        brandId: string;
+        email: string;
+        lastName: string;
+        firstName: string;
+        gdprConsent: boolean;
+        phone?: string | undefined;
+        locale?: string | undefined;
+        gdprConsentDate?: string | undefined;
+        marketingOptIn?: boolean | undefined;
+        preferences?: Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined;
+        tags?: string[] | undefined;
+        totalVisits?: number | undefined;
+        lastVisitDate?: string | undefined;
+        firstVisitDate?: string | undefined;
+        legacyId?: string | undefined;
+    }>, "many">;
+    skipDuplicates: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    updateExisting: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    contacts: {
+        brandId: string;
+        email: string;
+        lastName: string;
+        firstName: string;
+        gdprConsent: boolean;
+        phone?: string | undefined;
+        locale?: string | undefined;
+        gdprConsentDate?: string | undefined;
+        marketingOptIn?: boolean | undefined;
+        preferences?: Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined;
+        tags?: string[] | undefined;
+        totalVisits?: number | undefined;
+        lastVisitDate?: string | undefined;
+        firstVisitDate?: string | undefined;
+        legacyId?: string | undefined;
+    }[];
+    skipDuplicates: boolean;
+    updateExisting: boolean;
+}, {
+    contacts: {
+        brandId: string;
+        email: string;
+        lastName: string;
+        firstName: string;
+        gdprConsent: boolean;
+        phone?: string | undefined;
+        locale?: string | undefined;
+        gdprConsentDate?: string | undefined;
+        marketingOptIn?: boolean | undefined;
+        preferences?: Record<string, string | number | boolean | any[] | Record<string, any> | null> | undefined;
+        tags?: string[] | undefined;
+        totalVisits?: number | undefined;
+        lastVisitDate?: string | undefined;
+        firstVisitDate?: string | undefined;
+        legacyId?: string | undefined;
+    }[];
+    skipDuplicates?: boolean | undefined;
+    updateExisting?: boolean | undefined;
+}>;
+type CreateContactInput$1 = z.infer<typeof createContactSchema>;
+type UpdateContactInput$1 = z.infer<typeof updateContactSchema>;
+type SearchContactInput = z.infer<typeof searchContactSchema>;
+type BulkImportContactInput = z.infer<typeof bulkImportContactSchema>;
+type ContactPreferences = z.infer<typeof contactPreferencesSchema>;
+type NotificationPreferences = z.infer<typeof notificationPreferencesSchema>;
+type CommunicationPreferences = z.infer<typeof communicationPreferencesSchema>;
+/**
+ * Validate email address
+ * @param email - Email string to validate
+ * @returns Validation result with success status and normalized email or error
+ */
+declare function validateEmail(email: string): z.SafeParseReturnType<string, string>;
+/**
+ * Validate phone number
+ * @param phone - Phone string to validate
+ * @returns Validation result with success status and normalized phone or error
+ */
+declare function validatePhone(phone: string): z.SafeParseReturnType<string, string>;
+/**
+ * Validate contact name
+ * @param firstName - First name to validate
+ * @param lastName - Last name to validate
+ * @returns Object with validation results for both names
+ */
+declare function validateContactName(firstName: string, lastName: string): {
+    firstName: z.SafeParseReturnType<string, string>;
+    lastName: z.SafeParseReturnType<string, string>;
+    isValid: boolean;
+};
+/**
+ * Validate create contact input
+ * @param input - Contact input to validate
+ * @returns Validation result with success status and validated data or error
+ */
+declare function validateCreateContact(input: unknown): z.SafeParseReturnType<unknown, CreateContactInput$1>;
+/**
+ * Validate update contact input
+ * @param input - Contact update input to validate
+ * @returns Validation result with success status and validated data or error
+ */
+declare function validateUpdateContact(input: unknown): z.SafeParseReturnType<unknown, UpdateContactInput$1>;
+/**
+ * Format Zod errors into user-friendly message
+ * @param error - Zod error object
+ * @returns Formatted error message string
+ */
+declare function formatValidationErrors(error: z.ZodError): string;
+/**
+ * Get validation error details as array
+ * @param error - Zod error object
+ * @returns Array of error details with path and message
+ */
+declare function getValidationErrorDetails(error: z.ZodError): Array<{
+    path: string;
+    message: string;
+    code: string;
+}>;
+
+/**
+ * Contact Mutation Functions
+ *
+ * Provides type-safe mutation functions for creating, updating, and deleting contacts.
+ * Includes Zod validation for input data before mutations.
+ */
+
+/**
+ * Validation error class for contact operations
+ */
+declare class ContactValidationError extends Error {
+    readonly issues: z.ZodIssue[];
+    constructor(message: string, issues?: z.ZodIssue[]);
+}
+/**
+ * Input type for creating a contact
+ */
+interface CreateContactInput extends CreateAuditFields {
+    brandId: string;
+    email: string;
+    phone?: string;
+    firstName: string;
+    lastName: string;
+    locale?: string;
+    gdprConsent: boolean;
+    gdprConsentDate?: string;
+    marketingOptIn?: boolean;
+    preferences?: Record<string, any>;
+    tags?: string[];
+    totalVisits?: number;
+    lastVisitDate?: string;
+    firstVisitDate?: string;
+    legacyId?: string;
+}
+/**
+ * Input type for updating a contact
+ */
+interface UpdateContactInput extends UpdateWithSoftDeleteFields {
+    id: string;
+    brandId?: string;
+    email?: string;
+    phone?: string;
+    firstName?: string;
+    lastName?: string;
+    locale?: string;
+    gdprConsent?: boolean;
+    gdprConsentDate?: string;
+    marketingOptIn?: boolean;
+    preferences?: Record<string, any>;
+    tags?: string[];
+    totalVisits?: number;
+    lastVisitDate?: string;
+    firstVisitDate?: string;
+    legacyId?: string;
+}
+/**
+ * Input type for merging contacts
+ */
+interface MergeContactsInput {
+    primaryId: string;
+    duplicateIds: string[];
+}
+/**
+ * Result type for merge operation
+ */
+interface MergeContactsResult {
+    success: boolean;
+    mergedContact?: Contact;
+    deletedIds?: string[];
+    error?: string;
+}
+/**
+ * Create a new contact with Zod validation
+ *
+ * @throws {ContactValidationError} if input validation fails
+ *
+ * @example
+ * ```typescript
+ * import { createContact } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const contact = await createContact(client, {
+ *   brandId: 'brand-123',
+ *   email: 'guest@example.com',
+ *   firstName: 'John',
+ *   lastName: 'Doe',
+ *   gdprConsent: true,
+ *   gdprConsentDate: new Date().toISOString()
+ * });
+ * ```
+ */
+declare function createContact<TClient = any>(client: TClient, input: CreateContactInput): Promise<Contact | null>;
+/**
+ * Update an existing contact with Zod validation
+ *
+ * @throws {ContactValidationError} if input validation fails
+ *
+ * @example
+ * ```typescript
+ * import { updateContact } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const contact = await updateContact(client, {
+ *   id: 'contact-123',
+ *   firstName: 'Jane',
+ *   marketingOptIn: true
+ * });
+ * ```
+ */
+declare function updateContact<TClient = any>(client: TClient, input: UpdateContactInput): Promise<Contact | null>;
+/**
+ * Soft delete a contact (sets deletedAt/deletedBy instead of removing)
+ *
+ * @example
+ * ```typescript
+ * import { softDeleteContact } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * await softDeleteContact(client, 'contact-123', 'admin@example.com');
+ * ```
+ */
+declare function softDeleteContact<TClient = any>(client: TClient, id: string, deletedBy: string): Promise<boolean>;
+/**
+ * Restore a soft-deleted contact
+ * Checks retention period before allowing restoration
+ *
+ * @example
+ * ```typescript
+ * import { restoreContact } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * await restoreContact(client, 'contact-123');
+ * // Or with custom retention days:
+ * await restoreContact(client, 'contact-123', 60);
+ * ```
+ */
+declare function restoreContact<TClient = any>(client: TClient, id: string, retentionDays?: number): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Hard delete a contact (permanently removes from database)
+ * Use with caution - prefer softDeleteContact for recoverable deletion
+ *
+ * @example
+ * ```typescript
+ * import { deleteContact } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * await deleteContact(client, 'contact-123');
+ * ```
+ */
+declare function deleteContact<TClient = any>(client: TClient, id: string): Promise<boolean>;
+/**
+ * Merge duplicate contacts into a primary contact
+ *
+ * This function:
+ * 1. Validates all contact IDs exist
+ * 2. Aggregates data from duplicates into the primary contact
+ * 3. Soft deletes the duplicate contacts
+ * 4. Returns the updated primary contact
+ *
+ * Merge strategy:
+ * - totalVisits: Sum of all contacts
+ * - firstVisitDate: Earliest date across all contacts
+ * - lastVisitDate: Latest date across all contacts
+ * - tags: Merged unique tags from all contacts
+ * - preferences: Primary contact preferences take precedence
+ * - Other fields: Primary contact values are preserved
+ *
+ * @throws {ContactValidationError} if input validation fails
+ *
+ * @example
+ * ```typescript
+ * import { mergeContacts } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const result = await mergeContacts(client, {
+ *   primaryId: 'contact-primary',
+ *   duplicateIds: ['contact-dup-1', 'contact-dup-2']
+ * }, 'admin@example.com');
+ * ```
+ */
+declare function mergeContacts<TClient = any>(client: TClient, input: MergeContactsInput, mergedBy: string): Promise<MergeContactsResult>;
+
+export { tagsArraySchema as $, restoreContact as A, mergeContacts as B, type CreateBrandInput as C, ContactValidationError as D, createContactSchema as E, updateContactSchema as F, mergeContactsSchema as G, type CreateContactInput as H, type UpdateContactInput as I, type MergeContactsResult as J, emailSchema as K, optionalEmailSchema as L, type MergeContactsInput as M, phoneSchema as N, optionalPhoneSchema as O, firstNameSchema as P, lastNameSchema as Q, optionalFirstNameSchema as R, optionalLastNameSchema as S, localeSchema as T, type UpdateBrandInput as U, optionalLocaleSchema as V, isoDateStringSchema as W, optionalIsoDateStringSchema as X, uuidSchema as Y, brandIdSchema as Z, tagSchema as _, createAccount as a, CustomFieldType as a0, customFieldDefinitionSchema as a1, createCustomFieldValueSchema as a2, contactPreferencesSchema as a3, notificationPreferencesSchema as a4, communicationPreferencesSchema as a5, searchContactSchema as a6, bulkImportContactSchema as a7, validateEmail as a8, validatePhone as a9, validateContactName as aa, validateCreateContact as ab, validateUpdateContact as ac, formatValidationErrors as ad, getValidationErrorDetails as ae, type CustomFieldTypeValue as af, type CustomFieldDefinition as ag, type SearchContactInput as ah, type BulkImportContactInput as ai, type ContactPreferences as aj, type NotificationPreferences as ak, type CommunicationPreferences as al, updateAccount as b, createBrand as c, deleteBrand as d, deleteAccount as e, softDeleteAccount as f, restoreAccount as g, type CreateAccountInput as h, type UpdateAccountInput as i, createUser as j, updateUser as k, deleteUser as l, softDeleteUser as m, restoreUser as n, type CreateUserInput as o, type UpdateUserInput as p, updateSystemSettings as q, restoreBrand as r, softDeleteBrand as s, initializeSystemSettings as t, updateBrand as u, type UpdateSystemSettingsInput as v, createContact as w, updateContact as x, deleteContact as y, softDeleteContact as z };