wiil-core-js 0.0.82

package/dist/core/business-mgt/service-config.schema.d.ts

@@ -0,0 +1,453 @@
+import z from "zod";
+/**
+ * @fileoverview Business service configuration schema definitions.
+ * @module business-mgt/business-service-config
+ */
+/**
+ * Service-level appointment field configuration (embedded in BusinessServiceConfigSchema).
+ *
+ * This schema represents the **Service Level** in the dynamic fields hierarchy:
+ *
+ * ```
+ * Organization Level (AppointmentFieldConfigSchema)
+ *         │
+ *         ▼ inherits via appointmentFieldConfigId
+ * Service Level (ServiceAppointmentFieldConfigSchema) ← THIS SCHEMA
+ *         │
+ *         ▼ stores values
+ * Appointment Level (AppointmentAdditionalInfoSchema)
+ * ```
+ *
+ * Allows services to:
+ * - Inherit specific fields from the organization-level configuration
+ * - Override properties of inherited fields (e.g., make a field required)
+ * - Add service-specific fields not in the organization config
+ *
+ * @see AppointmentFieldConfigSchema - Organization-level field definitions
+ * @see AppointmentAdditionalInfoSchema - Stores captured field values
+ */
+export declare const ServiceAppointmentFieldConfigSchema: z.ZodObject<{
+    inheritedFieldKeys: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    fieldOverrides: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        fieldKey: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        validation: z.ZodOptional<z.ZodObject<{
+            required: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+            minLength: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            maxLength: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            min: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            max: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            pattern: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            patternMessage: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strip>>;
+        uiHints: z.ZodOptional<z.ZodObject<{
+            placeholder: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            helpText: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            displayOrder: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            width: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+                full: "full";
+                half: "half";
+                third: "third";
+            }>>>;
+        }, z.core.$strip>>;
+        defaultValue: z.ZodOptional<z.ZodAny>;
+        isActive: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    additionalFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        fieldKey: z.ZodString;
+        fieldType: z.ZodEnum<{
+            text: import("../type-definitions/dynamic-fields").DynamicFieldType.TEXT;
+            textarea: import("../type-definitions/dynamic-fields").DynamicFieldType.TEXTAREA;
+            number: import("../type-definitions/dynamic-fields").DynamicFieldType.NUMBER;
+            boolean: import("../type-definitions/dynamic-fields").DynamicFieldType.BOOLEAN;
+            date: import("../type-definitions/dynamic-fields").DynamicFieldType.DATE;
+            time: import("../type-definitions/dynamic-fields").DynamicFieldType.TIME;
+            datetime: import("../type-definitions/dynamic-fields").DynamicFieldType.DATETIME;
+            email: import("../type-definitions/dynamic-fields").DynamicFieldType.EMAIL;
+            phone: import("../type-definitions/dynamic-fields").DynamicFieldType.PHONE;
+            select: import("../type-definitions/dynamic-fields").DynamicFieldType.SELECT;
+            multiselect: import("../type-definitions/dynamic-fields").DynamicFieldType.MULTISELECT;
+        }>;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        validation: z.ZodOptional<z.ZodObject<{
+            required: z.ZodOptional<z.ZodBoolean>;
+            minLength: z.ZodOptional<z.ZodNumber>;
+            maxLength: z.ZodOptional<z.ZodNumber>;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            pattern: z.ZodOptional<z.ZodString>;
+            patternMessage: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        uiHints: z.ZodOptional<z.ZodObject<{
+            placeholder: z.ZodOptional<z.ZodString>;
+            helpText: z.ZodOptional<z.ZodString>;
+            displayOrder: z.ZodOptional<z.ZodNumber>;
+            width: z.ZodOptional<z.ZodEnum<{
+                full: "full";
+                half: "half";
+                third: "third";
+            }>>;
+        }, z.core.$strip>>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+            displayOrder: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        defaultValue: z.ZodOptional<z.ZodAny>;
+        isActive: z.ZodOptional<z.ZodBoolean>;
+        condition: z.ZodOptional<z.ZodObject<{
+            dependsOn: z.ZodString;
+            operator: z.ZodEnum<{
+                equals: "equals";
+                notEquals: "notEquals";
+                contains: "contains";
+                isEmpty: "isEmpty";
+                isNotEmpty: "isNotEmpty";
+                greaterThan: "greaterThan";
+                lessThan: "lessThan";
+            }>;
+            value: z.ZodOptional<z.ZodAny>;
+        }, z.core.$strip>>;
+        groupKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    reuseDetails: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ServiceAppointmentFieldConfig = z.infer<typeof ServiceAppointmentFieldConfigSchema>;
+/**
+ * Business service configuration schema.
+ *
+ * @typedef {Object} BusinessServiceConfig
+ * @property {string} id - Unique identifier for the service
+ * @property {string} name - Name of the service offered
+ * @property {string} [description] - Detailed description of the service
+ * @property {number} duration - Service duration in minutes (max 8 hours)
+ * @property {number} bufferTime - Buffer time between appointments in minutes
+ * @property {boolean} isBookable - Whether this service can be booked online
+ * @property {number} [price] - Service price in account currency
+ * @property {boolean} isActive - Whether the service is currently available
+
+ */
+export declare const BusinessServiceConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodString;
+    description: z.ZodString;
+    duration: z.ZodDefault<z.ZodNumber>;
+    bufferTime: z.ZodDefault<z.ZodNumber>;
+    isBookable: z.ZodDefault<z.ZodBoolean>;
+    price: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    requiredDatafieldConfig: z.ZodOptional<z.ZodObject<{
+        inheritedFieldKeys: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        fieldOverrides: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            fieldKey: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            validation: z.ZodOptional<z.ZodObject<{
+                required: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+                minLength: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                maxLength: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                min: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                max: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                pattern: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+                patternMessage: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            uiHints: z.ZodOptional<z.ZodObject<{
+                placeholder: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+                helpText: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+                displayOrder: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                width: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+                    full: "full";
+                    half: "half";
+                    third: "third";
+                }>>>;
+            }, z.core.$strip>>;
+            defaultValue: z.ZodOptional<z.ZodAny>;
+            isActive: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        additionalFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            fieldKey: z.ZodString;
+            fieldType: z.ZodEnum<{
+                text: import("../type-definitions/dynamic-fields").DynamicFieldType.TEXT;
+                textarea: import("../type-definitions/dynamic-fields").DynamicFieldType.TEXTAREA;
+                number: import("../type-definitions/dynamic-fields").DynamicFieldType.NUMBER;
+                boolean: import("../type-definitions/dynamic-fields").DynamicFieldType.BOOLEAN;
+                date: import("../type-definitions/dynamic-fields").DynamicFieldType.DATE;
+                time: import("../type-definitions/dynamic-fields").DynamicFieldType.TIME;
+                datetime: import("../type-definitions/dynamic-fields").DynamicFieldType.DATETIME;
+                email: import("../type-definitions/dynamic-fields").DynamicFieldType.EMAIL;
+                phone: import("../type-definitions/dynamic-fields").DynamicFieldType.PHONE;
+                select: import("../type-definitions/dynamic-fields").DynamicFieldType.SELECT;
+                multiselect: import("../type-definitions/dynamic-fields").DynamicFieldType.MULTISELECT;
+            }>;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            validation: z.ZodOptional<z.ZodObject<{
+                required: z.ZodOptional<z.ZodBoolean>;
+                minLength: z.ZodOptional<z.ZodNumber>;
+                maxLength: z.ZodOptional<z.ZodNumber>;
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                pattern: z.ZodOptional<z.ZodString>;
+                patternMessage: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            uiHints: z.ZodOptional<z.ZodObject<{
+                placeholder: z.ZodOptional<z.ZodString>;
+                helpText: z.ZodOptional<z.ZodString>;
+                displayOrder: z.ZodOptional<z.ZodNumber>;
+                width: z.ZodOptional<z.ZodEnum<{
+                    full: "full";
+                    half: "half";
+                    third: "third";
+                }>>;
+            }, z.core.$strip>>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+                displayOrder: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            defaultValue: z.ZodOptional<z.ZodAny>;
+            isActive: z.ZodOptional<z.ZodBoolean>;
+            condition: z.ZodOptional<z.ZodObject<{
+                dependsOn: z.ZodString;
+                operator: z.ZodEnum<{
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    contains: "contains";
+                    isEmpty: "isEmpty";
+                    isNotEmpty: "isNotEmpty";
+                    greaterThan: "greaterThan";
+                    lessThan: "lessThan";
+                }>;
+                value: z.ZodOptional<z.ZodAny>;
+            }, z.core.$strip>>;
+            groupKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        isActive: z.ZodDefault<z.ZodBoolean>;
+        reuseDetails: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Service QR code schema for appointment booking.
+ *
+ * @typedef {Object} ServiceQRCode
+ * @property {string} id - Unique identifier for the QR code
+ * @property {string} appointmentUrl - Direct link to the appointment page
+ * @property {string} [qrCodeImage] - Base64 encoded QR code image
+ * @property {string} [serviceId] - Specific service ID for direct appointment
+ */
+export declare const ServiceQRCodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    appointmentUrl: z.ZodString;
+    qrCodeImage: z.ZodOptional<z.ZodString>;
+    serviceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new business service.
+ * Omits auto-generated fields.
+ */
+export declare const CreateBusinessServiceSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    price: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    duration: z.ZodDefault<z.ZodNumber>;
+    bufferTime: z.ZodDefault<z.ZodNumber>;
+    isBookable: z.ZodDefault<z.ZodBoolean>;
+    requiredDatafieldConfig: z.ZodOptional<z.ZodObject<{
+        inheritedFieldKeys: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        fieldOverrides: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            fieldKey: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            validation: z.ZodOptional<z.ZodObject<{
+                required: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+                minLength: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                maxLength: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                min: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                max: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                pattern: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+                patternMessage: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            uiHints: z.ZodOptional<z.ZodObject<{
+                placeholder: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+                helpText: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+                displayOrder: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                width: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+                    full: "full";
+                    half: "half";
+                    third: "third";
+                }>>>;
+            }, z.core.$strip>>;
+            defaultValue: z.ZodOptional<z.ZodAny>;
+            isActive: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        additionalFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            fieldKey: z.ZodString;
+            fieldType: z.ZodEnum<{
+                text: import("../type-definitions/dynamic-fields").DynamicFieldType.TEXT;
+                textarea: import("../type-definitions/dynamic-fields").DynamicFieldType.TEXTAREA;
+                number: import("../type-definitions/dynamic-fields").DynamicFieldType.NUMBER;
+                boolean: import("../type-definitions/dynamic-fields").DynamicFieldType.BOOLEAN;
+                date: import("../type-definitions/dynamic-fields").DynamicFieldType.DATE;
+                time: import("../type-definitions/dynamic-fields").DynamicFieldType.TIME;
+                datetime: import("../type-definitions/dynamic-fields").DynamicFieldType.DATETIME;
+                email: import("../type-definitions/dynamic-fields").DynamicFieldType.EMAIL;
+                phone: import("../type-definitions/dynamic-fields").DynamicFieldType.PHONE;
+                select: import("../type-definitions/dynamic-fields").DynamicFieldType.SELECT;
+                multiselect: import("../type-definitions/dynamic-fields").DynamicFieldType.MULTISELECT;
+            }>;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            validation: z.ZodOptional<z.ZodObject<{
+                required: z.ZodOptional<z.ZodBoolean>;
+                minLength: z.ZodOptional<z.ZodNumber>;
+                maxLength: z.ZodOptional<z.ZodNumber>;
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                pattern: z.ZodOptional<z.ZodString>;
+                patternMessage: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            uiHints: z.ZodOptional<z.ZodObject<{
+                placeholder: z.ZodOptional<z.ZodString>;
+                helpText: z.ZodOptional<z.ZodString>;
+                displayOrder: z.ZodOptional<z.ZodNumber>;
+                width: z.ZodOptional<z.ZodEnum<{
+                    full: "full";
+                    half: "half";
+                    third: "third";
+                }>>;
+            }, z.core.$strip>>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+                displayOrder: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            defaultValue: z.ZodOptional<z.ZodAny>;
+            isActive: z.ZodOptional<z.ZodBoolean>;
+            condition: z.ZodOptional<z.ZodObject<{
+                dependsOn: z.ZodString;
+                operator: z.ZodEnum<{
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    contains: "contains";
+                    isEmpty: "isEmpty";
+                    isNotEmpty: "isNotEmpty";
+                    greaterThan: "greaterThan";
+                    lessThan: "lessThan";
+                }>;
+                value: z.ZodOptional<z.ZodAny>;
+            }, z.core.$strip>>;
+            groupKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        isActive: z.ZodDefault<z.ZodBoolean>;
+        reuseDetails: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing business service.
+ * All fields are optional except id.
+ */
+export declare const UpdateBusinessServiceSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    price: z.ZodOptional<z.ZodOptional<z.ZodDefault<z.ZodNumber>>>;
+    duration: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    bufferTime: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    isBookable: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    requiredDatafieldConfig: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        inheritedFieldKeys: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        fieldOverrides: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            fieldKey: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            validation: z.ZodOptional<z.ZodObject<{
+                required: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+                minLength: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                maxLength: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                min: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                max: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                pattern: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+                patternMessage: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            uiHints: z.ZodOptional<z.ZodObject<{
+                placeholder: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+                helpText: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+                displayOrder: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                width: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+                    full: "full";
+                    half: "half";
+                    third: "third";
+                }>>>;
+            }, z.core.$strip>>;
+            defaultValue: z.ZodOptional<z.ZodAny>;
+            isActive: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        additionalFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            fieldKey: z.ZodString;
+            fieldType: z.ZodEnum<{
+                text: import("../type-definitions/dynamic-fields").DynamicFieldType.TEXT;
+                textarea: import("../type-definitions/dynamic-fields").DynamicFieldType.TEXTAREA;
+                number: import("../type-definitions/dynamic-fields").DynamicFieldType.NUMBER;
+                boolean: import("../type-definitions/dynamic-fields").DynamicFieldType.BOOLEAN;
+                date: import("../type-definitions/dynamic-fields").DynamicFieldType.DATE;
+                time: import("../type-definitions/dynamic-fields").DynamicFieldType.TIME;
+                datetime: import("../type-definitions/dynamic-fields").DynamicFieldType.DATETIME;
+                email: import("../type-definitions/dynamic-fields").DynamicFieldType.EMAIL;
+                phone: import("../type-definitions/dynamic-fields").DynamicFieldType.PHONE;
+                select: import("../type-definitions/dynamic-fields").DynamicFieldType.SELECT;
+                multiselect: import("../type-definitions/dynamic-fields").DynamicFieldType.MULTISELECT;
+            }>;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            validation: z.ZodOptional<z.ZodObject<{
+                required: z.ZodOptional<z.ZodBoolean>;
+                minLength: z.ZodOptional<z.ZodNumber>;
+                maxLength: z.ZodOptional<z.ZodNumber>;
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                pattern: z.ZodOptional<z.ZodString>;
+                patternMessage: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            uiHints: z.ZodOptional<z.ZodObject<{
+                placeholder: z.ZodOptional<z.ZodString>;
+                helpText: z.ZodOptional<z.ZodString>;
+                displayOrder: z.ZodOptional<z.ZodNumber>;
+                width: z.ZodOptional<z.ZodEnum<{
+                    full: "full";
+                    half: "half";
+                    third: "third";
+                }>>;
+            }, z.core.$strip>>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+                displayOrder: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            defaultValue: z.ZodOptional<z.ZodAny>;
+            isActive: z.ZodOptional<z.ZodBoolean>;
+            condition: z.ZodOptional<z.ZodObject<{
+                dependsOn: z.ZodString;
+                operator: z.ZodEnum<{
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    contains: "contains";
+                    isEmpty: "isEmpty";
+                    isNotEmpty: "isNotEmpty";
+                    greaterThan: "greaterThan";
+                    lessThan: "lessThan";
+                }>;
+                value: z.ZodOptional<z.ZodAny>;
+            }, z.core.$strip>>;
+            groupKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        isActive: z.ZodDefault<z.ZodBoolean>;
+        reuseDetails: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type BusinessService = z.infer<typeof BusinessServiceConfigSchema>;
+export type ServiceQRCode = z.infer<typeof ServiceQRCodeSchema>;
+export type CreateBusinessService = z.infer<typeof CreateBusinessServiceSchema>;
+export type UpdateBusinessService = z.infer<typeof UpdateBusinessServiceSchema>;

package/dist/core/business-mgt/service-config.schema.js

@@ -0,0 +1,102 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateBusinessServiceSchema = exports.CreateBusinessServiceSchema = exports.ServiceQRCodeSchema = exports.BusinessServiceConfigSchema = exports.ServiceAppointmentFieldConfigSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+const base_schema_1 = require("../base.schema");
+const dynamic_fields_1 = require("../type-definitions/dynamic-fields");
+/**
+ * @fileoverview Business service configuration schema definitions.
+ * @module business-mgt/business-service-config
+ */
+/**
+ * Service-level appointment field configuration (embedded in BusinessServiceConfigSchema).
+ *
+ * This schema represents the **Service Level** in the dynamic fields hierarchy:
+ *
+ * ```
+ * Organization Level (AppointmentFieldConfigSchema)
+ *         │
+ *         ▼ inherits via appointmentFieldConfigId
+ * Service Level (ServiceAppointmentFieldConfigSchema) ← THIS SCHEMA
+ *         │
+ *         ▼ stores values
+ * Appointment Level (AppointmentAdditionalInfoSchema)
+ * ```
+ *
+ * Allows services to:
+ * - Inherit specific fields from the organization-level configuration
+ * - Override properties of inherited fields (e.g., make a field required)
+ * - Add service-specific fields not in the organization config
+ *
+ * @see AppointmentFieldConfigSchema - Organization-level field definitions
+ * @see AppointmentAdditionalInfoSchema - Stores captured field values
+ */
+exports.ServiceAppointmentFieldConfigSchema = zod_1.default.object({
+    inheritedFieldKeys: zod_1.default.array(zod_1.default.string()).default([]).describe("Array of fieldKey values to inherit from the organization-level AppointmentFieldConfigSchema. Only fields with matching fieldKey values are included for this service. Example: ['allergies', 'emergency_contact'] inherits those two fields from the org config."),
+    fieldOverrides: zod_1.default.array(dynamic_fields_1.FieldOverrideSchema).default([]).describe("Array of field overrides to customize inherited fields for this service. Each override specifies a fieldKey and the properties to override (label, validation, uiHints, defaultValue, isActive). Example: Override 'allergies' field to make validation.required=true for this service."),
+    additionalFields: zod_1.default.array(dynamic_fields_1.FieldDefinitionSchema).default([]).describe("Array of service-specific field definitions not present in the organization config. These fields are only available for this particular service. Example: A spa service might add 'preferred_pressure' field with SELECT options."),
+    isActive: zod_1.default.boolean().default(true).describe("Controls whether this field configuration is active for the service. When false, no additional fields are collected during appointment booking. Defaults to true."),
+    reuseDetails: zod_1.default.boolean().default(false).describe("When true, captured field data for this service can be reused across appointments for the same customer. Overrides the organization-level reuseDetails setting when specified."),
+});
+/**
+ * Business service configuration schema.
+ *
+ * @typedef {Object} BusinessServiceConfig
+ * @property {string} id - Unique identifier for the service
+ * @property {string} name - Name of the service offered
+ * @property {string} [description] - Detailed description of the service
+ * @property {number} duration - Service duration in minutes (max 8 hours)
+ * @property {number} bufferTime - Buffer time between appointments in minutes
+ * @property {boolean} isBookable - Whether this service can be booked online
+ * @property {number} [price] - Service price in account currency
+ * @property {boolean} isActive - Whether the service is currently available
+
+ */
+exports.BusinessServiceConfigSchema = base_schema_1.BaseModelSchema.safeExtend({
+    name: zod_1.default.string().min(1, "Service name is required").describe("Display name of the service offered (e.g., 'Haircut', 'Massage', 'Consultation'). Used by AI Powered Services when presenting booking options to customers."),
+    description: zod_1.default.string().describe("Detailed description of the service including what's included, benefits, or special instructions. Helps customers understand the service before booking via Service Appointment workflow."),
+    // Scheduling & Duration
+    duration: zod_1.default.number().int().positive().max(480).default(60).describe("Service duration in minutes with maximum of 480 minutes (8 hours). Used by AI Powered Services to calculate appointment end times and availability slots. Defaults to 60 minutes."),
+    bufferTime: zod_1.default.number().int().nonnegative().default(0).describe("Buffer time in minutes between consecutive appointments for cleanup, preparation, or transition. Ensures adequate spacing in Service Person schedules. Defaults to 0."),
+    isBookable: zod_1.default.boolean().default(true).describe("Whether this service can be booked online through AI Powered Services conversations. Services marked false require manual booking or are for internal use only. Defaults to true."),
+    // Pricing
+    price: zod_1.default.number().nonnegative().default(0).optional().describe("Service price in the account's currency. Used for Service Appointment pricing and customer quotes during AI conversations. Defaults to 0 for complimentary services."),
+    // Business Management
+    isActive: zod_1.default.boolean().default(true).describe("Whether the service is currently active and available for booking. Inactive services are hidden from customers and AI Powered Services. Defaults to true."),
+    // Dynamic Field Configuration
+    requiredDatafieldConfig: exports.ServiceAppointmentFieldConfigSchema.optional().describe("Service-level dynamic field configuration for capturing additional appointment information. Inherits fields from organization-level AppointmentFieldConfigSchema via inheritedFieldKeys, allows overrides via fieldOverrides, and supports service-specific fields via additionalFields. When omitted, no additional fields are collected for this service."),
+});
+/**
+ * Service QR code schema for appointment booking.
+ *
+ * @typedef {Object} ServiceQRCode
+ * @property {string} id - Unique identifier for the QR code
+ * @property {string} appointmentUrl - Direct link to the appointment page
+ * @property {string} [qrCodeImage] - Base64 encoded QR code image
+ * @property {string} [serviceId] - Specific service ID for direct appointment
+ */
+exports.ServiceQRCodeSchema = zod_1.default.object({
+    id: zod_1.default.string().describe("Unique identifier for this QR code instance."),
+    appointmentUrl: zod_1.default.string().url().describe("URL to the appointment booking interface accessed by scanning this QR code. Links to service selection and scheduling flow powered by AI Powered Services."),
+    qrCodeImage: zod_1.default.string().optional().describe("Base64 encoded QR code image for printing or digital display (posters, flyers, websites). Generated from appointmentUrl."),
+    serviceId: zod_1.default.string().optional().describe("Optional specific Business Service ID for direct appointment booking. When provided, QR code bypasses service selection and goes directly to scheduling for this service."),
+});
+/**
+ * Schema for creating a new business service.
+ * Omits auto-generated fields.
+ */
+exports.CreateBusinessServiceSchema = exports.BusinessServiceConfigSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+});
+/**
+ * Schema for updating an existing business service.
+ * All fields are optional except id.
+ */
+exports.UpdateBusinessServiceSchema = exports.CreateBusinessServiceSchema.partial().safeExtend({
+    id: zod_1.default.string(),
+});

package/dist/core/business-mgt/service-management/appointment-additional-info.schema.d.ts

@@ -0,0 +1,110 @@
+import z from "zod";
+/**
+ * @fileoverview Appointment Additional Info schema for storing dynamic field values.
+ * @module business-mgt/appointment-additional-info
+ *
+ * This schema represents the **Appointment Level** in the dynamic fields hierarchy:
+ *
+ * ```
+ * Organization Level (AppointmentFieldConfigSchema)
+ *         │
+ *         ▼ inherits via appointmentFieldConfigId
+ * Service Level (ServiceAppointmentFieldConfigSchema)
+ *         │
+ *         ▼ stores values
+ * Appointment Level (AppointmentAdditionalInfoSchema) ← THIS SCHEMA
+ * ```
+ *
+ * Stores the actual captured field values for a specific appointment instance.
+ * The `data` property contains key-value pairs where keys correspond to `fieldKey`
+ * values defined in the organization and service-level field configurations.
+ *
+ * @see AppointmentFieldConfigSchema - Organization-level field definitions
+ * @see ServiceAppointmentFieldConfigSchema - Service-level field customization
+ */
+/**
+ * Schema for dynamic field value types.
+ * Accepts any value type to support the various DynamicFieldType values
+ * (text, number, boolean, date, select options, etc.)
+ */
+export declare const DynamicFieldValueSchema: z.ZodAny;
+export type DynamicFieldValue = z.infer<typeof DynamicFieldValueSchema>;
+/**
+ * Appointment Additional Info schema.
+ * Stores dynamic field values captured during appointment booking.
+ *
+ * @typedef {Object} AppointmentAdditionalInfo
+ * @property {string} businessServiceId - Reference to the business service
+ * @property {string} appointmentId - Reference to the appointment instance
+ * @property {string} customerId - Reference to the customer who provided info
+ * @property {Object} data - Key-value store of captured field values
+ */
+export declare const AppointmentAdditionalInfoSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    businessServiceId: z.ZodString;
+    appointmentId: z.ZodString;
+    customerId: z.ZodString;
+    data: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+/**
+ * Schema for creating appointment additional info.
+ * Omits auto-generated fields.
+ */
+export declare const CreateAppointmentAdditionalInfoSchema: z.ZodObject<{
+    data: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    customerId: z.ZodString;
+    businessServiceId: z.ZodString;
+    appointmentId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Schema for updating appointment additional info.
+ * All fields optional except id (required).
+ */
+export declare const UpdateAppointmentAdditionalInfoSchema: z.ZodObject<{
+    data: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    customerId: z.ZodOptional<z.ZodString>;
+    businessServiceId: z.ZodOptional<z.ZodString>;
+    appointmentId: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type AppointmentAdditionalInfo = z.infer<typeof AppointmentAdditionalInfoSchema>;
+export type CreateAppointmentAdditionalInfo = z.infer<typeof CreateAppointmentAdditionalInfoSchema>;
+export type UpdateAppointmentAdditionalInfo = z.infer<typeof UpdateAppointmentAdditionalInfoSchema>;
+/**
+ * Appointment additional info filter options.
+ * @interface AppointmentAdditionalInfoFilters
+ */
+export interface AppointmentAdditionalInfoFilters {
+    /** Filter by business service ID */
+    businessServiceId?: string;
+    /** Filter by appointment ID */
+    appointmentId?: string;
+    /** Filter by customer ID */
+    customerId?: string;
+}
+/**
+ * Appointment additional info sorting options.
+ * @interface AppointmentAdditionalInfoSorting
+ */
+export interface AppointmentAdditionalInfoSorting {
+    /** Field to sort by */
+    field: "createdAt" | "updatedAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Appointment additional info query options.
+ * @interface AppointmentAdditionalInfoQueryOptions
+ */
+export interface AppointmentAdditionalInfoQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: AppointmentAdditionalInfoFilters;
+    /** Optional sorting */
+    sorting?: AppointmentAdditionalInfoSorting;
+}