@htlkg/data 0.0.19 → 0.0.21

package/dist/mutations/index.d.ts

@@ -1,6 +1,9 @@
-import { C as CreateAuditFields, a as UpdateWithSoftDeleteFields } from '../productInstances-BA3cNsYc.js';
-export { b as CreateProductInstanceInput, S as SoftDeleteFields, U as UpdateAuditFields, e as UpdateProductInstanceInput, c as createProductInstance, d as deleteProductInstance, t as toggleProductInstanceEnabled, u as updateProductInstance } from '../productInstances-BA3cNsYc.js';
-import { Brand, Account, User, SystemSettings } from '@htlkg/core/types';
+import { C as CreateAuditFields, a as UpdateWithSoftDeleteFields } from '../common-DSxswsZ3.js';
+export { S as SoftDeleteFields, U as UpdateAuditFields } from '../common-DSxswsZ3.js';
+import { Brand, Account, User, SystemSettings, Contact } from '@htlkg/core/types';
+export { C as CreateProductInstanceInput, U as UpdateProductInstanceInput, c as createProductInstance, d as deleteProductInstance, t as toggleProductInstanceEnabled, u as updateProductInstance } from '../productInstances-BpQv1oLS.js';
+export { C as CreateReservationInput, b as ReservationStatus, R as ReservationValidationError, U as UpdateReservationInput, c as createReservation, d as deleteReservation, r as restoreReservation, s as softDeleteReservation, u as updateReservation, a as updateReservationStatus } from '../reservations-CdDfkcZ_.js';
+import { z } from 'zod';
 
 /**
  * Brand Mutation Functions
@@ -375,4 +378,339 @@ declare function updateSystemSettings<TClient = any>(client: TClient, input: Upd
  */
 declare function initializeSystemSettings<TClient = any>(client: TClient, initializedBy: string): Promise<SystemSettings | null>;
 
-export { type CreateAccountInput, CreateAuditFields, type CreateBrandInput, type CreateUserInput, type UpdateAccountInput, type UpdateBrandInput, type UpdateSystemSettingsInput, type UpdateUserInput, UpdateWithSoftDeleteFields, createAccount, createBrand, createUser, deleteAccount, deleteBrand, deleteUser, initializeSystemSettings, restoreAccount, restoreBrand, restoreUser, softDeleteAccount, softDeleteBrand, softDeleteUser, updateAccount, updateBrand, updateSystemSettings, updateUser };
+/**
+ * Contact Mutation Functions
+ *
+ * Provides type-safe mutation functions for creating, updating, and deleting contacts.
+ * Includes Zod validation for input data before mutations.
+ */
+
+/**
+ * Zod schema for creating a contact
+ */
+declare const createContactSchema: z.ZodObject<{
+    brandId: z.ZodString;
+    email: z.ZodString;
+    phone: z.ZodOptional<z.ZodString>;
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    locale: z.ZodOptional<z.ZodString>;
+    gdprConsent: z.ZodBoolean;
+    gdprConsentDate: z.ZodOptional<z.ZodString>;
+    marketingOptIn: z.ZodOptional<z.ZodBoolean>;
+    preferences: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    totalVisits: z.ZodOptional<z.ZodNumber>;
+    lastVisitDate: z.ZodOptional<z.ZodString>;
+    firstVisitDate: z.ZodOptional<z.ZodString>;
+    legacyId: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    createdBy: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    updatedBy: 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;
+    locale?: string | undefined;
+    gdprConsentDate?: string | undefined;
+    marketingOptIn?: boolean | undefined;
+    preferences?: Record<string, any> | undefined;
+    tags?: string[] | undefined;
+    totalVisits?: number | undefined;
+    lastVisitDate?: string | undefined;
+    firstVisitDate?: string | undefined;
+    legacyId?: string | undefined;
+    createdAt?: string | undefined;
+    createdBy?: string | undefined;
+}, {
+    brandId: string;
+    email: string;
+    lastName: string;
+    firstName: string;
+    gdprConsent: boolean;
+    updatedAt?: string | undefined;
+    updatedBy?: string | undefined;
+    phone?: string | undefined;
+    locale?: string | undefined;
+    gdprConsentDate?: string | undefined;
+    marketingOptIn?: boolean | undefined;
+    preferences?: Record<string, any> | undefined;
+    tags?: string[] | undefined;
+    totalVisits?: number | undefined;
+    lastVisitDate?: string | undefined;
+    firstVisitDate?: string | undefined;
+    legacyId?: string | undefined;
+    createdAt?: string | undefined;
+    createdBy?: string | undefined;
+}>;
+/**
+ * Zod schema for updating a contact
+ */
+declare const updateContactSchema: z.ZodObject<{
+    id: z.ZodString;
+    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>;
+    locale: z.ZodOptional<z.ZodString>;
+    gdprConsent: z.ZodOptional<z.ZodBoolean>;
+    gdprConsentDate: z.ZodOptional<z.ZodString>;
+    marketingOptIn: z.ZodOptional<z.ZodBoolean>;
+    preferences: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    totalVisits: z.ZodOptional<z.ZodNumber>;
+    lastVisitDate: z.ZodOptional<z.ZodString>;
+    firstVisitDate: z.ZodOptional<z.ZodString>;
+    legacyId: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    updatedBy: z.ZodOptional<z.ZodString>;
+    deletedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deletedBy: z.ZodOptional<z.ZodNullable<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, any> | 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, any> | undefined;
+    tags?: string[] | undefined;
+    totalVisits?: number | undefined;
+    lastVisitDate?: string | undefined;
+    firstVisitDate?: string | undefined;
+    legacyId?: string | undefined;
+}>;
+/**
+ * Zod schema for merging 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[];
+}>;
+/**
+ * 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 { ContactValidationError, type CreateAccountInput, CreateAuditFields, type CreateBrandInput, type CreateContactInput, type CreateUserInput, type MergeContactsInput, type MergeContactsResult, type UpdateAccountInput, type UpdateBrandInput, type UpdateContactInput, type UpdateSystemSettingsInput, type UpdateUserInput, UpdateWithSoftDeleteFields, createAccount, createBrand, createContact, createContactSchema, createUser, deleteAccount, deleteBrand, deleteContact, deleteUser, initializeSystemSettings, mergeContacts, mergeContactsSchema, restoreAccount, restoreBrand, restoreContact, restoreUser, softDeleteAccount, softDeleteBrand, softDeleteContact, softDeleteUser, updateAccount, updateBrand, updateContact, updateContactSchema, updateSystemSettings, updateUser };