wiil-core-js 0.0.82

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

@@ -0,0 +1,251 @@
+import { z } from "zod";
+/**
+ * @fileoverview Organization-level appointment field configuration schema.
+ * @module business-mgt/appointment-field-config
+ *
+ * This schema represents the **Organization Level** in the dynamic fields hierarchy:
+ *
+ * ```
+ * Organization Level (AppointmentFieldConfigSchema) ← THIS SCHEMA
+ *         │
+ *         ▼ inherits via appointmentFieldConfigId
+ * Service Level (ServiceAppointmentFieldConfigSchema)
+ *         │
+ *         ▼ stores values
+ * Appointment Level (AppointmentAdditionalInfoSchema)
+ * ```
+ *
+ * Defines the base field library that can be reused across multiple services
+ * within an organization. Services can inherit fields from this configuration
+ * and optionally override specific properties or add service-specific fields.
+ *
+ * @see ServiceAppointmentFieldConfigSchema - Service-level field customization
+ * @see AppointmentAdditionalInfoSchema - Stores captured field values
+ */
+/**
+ * Organization-level appointment field configuration.
+ * Defines the base field library available to all services within an organization.
+ * Services reference this configuration via `appointmentFieldConfigId` and can
+ * selectively inherit, override, or extend the defined fields.
+ */
+export declare const AppointmentFieldConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    fields: 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>>>;
+    groups: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        groupKey: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        displayOrder: z.ZodOptional<z.ZodNumber>;
+        collapsible: z.ZodOptional<z.ZodBoolean>;
+        defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    reuseDetails: z.ZodDefault<z.ZodBoolean>;
+    ensureEmail: z.ZodDefault<z.ZodBoolean>;
+    ensurePhone: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type AppointmentFieldConfig = z.infer<typeof AppointmentFieldConfigSchema>;
+export declare const CreateAppointmentFieldConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    fields: 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>>>;
+    groups: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        groupKey: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        displayOrder: z.ZodOptional<z.ZodNumber>;
+        collapsible: z.ZodOptional<z.ZodBoolean>;
+        defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    reuseDetails: z.ZodDefault<z.ZodBoolean>;
+    ensureEmail: z.ZodDefault<z.ZodBoolean>;
+    ensurePhone: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CreateAppointmentFieldConfig = z.infer<typeof CreateAppointmentFieldConfigSchema>;
+export declare const UpdateAppointmentFieldConfigSchema: z.ZodObject<{
+    fields: z.ZodOptional<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>>>>;
+    groups: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        groupKey: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        displayOrder: z.ZodOptional<z.ZodNumber>;
+        collapsible: z.ZodOptional<z.ZodBoolean>;
+        defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>>;
+    reuseDetails: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    ensureEmail: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    ensurePhone: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type UpdateAppointmentFieldConfig = z.infer<typeof UpdateAppointmentFieldConfigSchema>;

package/dist/core/business-mgt/appointment-field-config.schema.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateAppointmentFieldConfigSchema = exports.CreateAppointmentFieldConfigSchema = exports.AppointmentFieldConfigSchema = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("../base.schema");
+const dynamic_fields_1 = require("../type-definitions/dynamic-fields");
+/**
+ * @fileoverview Organization-level appointment field configuration schema.
+ * @module business-mgt/appointment-field-config
+ *
+ * This schema represents the **Organization Level** in the dynamic fields hierarchy:
+ *
+ * ```
+ * Organization Level (AppointmentFieldConfigSchema) ← THIS SCHEMA
+ *         │
+ *         ▼ inherits via appointmentFieldConfigId
+ * Service Level (ServiceAppointmentFieldConfigSchema)
+ *         │
+ *         ▼ stores values
+ * Appointment Level (AppointmentAdditionalInfoSchema)
+ * ```
+ *
+ * Defines the base field library that can be reused across multiple services
+ * within an organization. Services can inherit fields from this configuration
+ * and optionally override specific properties or add service-specific fields.
+ *
+ * @see ServiceAppointmentFieldConfigSchema - Service-level field customization
+ * @see AppointmentAdditionalInfoSchema - Stores captured field values
+ */
+/**
+ * Organization-level appointment field configuration.
+ * Defines the base field library available to all services within an organization.
+ * Services reference this configuration via `appointmentFieldConfigId` and can
+ * selectively inherit, override, or extend the defined fields.
+ */
+exports.AppointmentFieldConfigSchema = base_schema_1.BaseModelSchema.safeExtend({
+    fields: zod_1.z.array(dynamic_fields_1.FieldDefinitionSchema).default([]).describe("Array of field definitions available at the organization level. Each field has a unique fieldKey, fieldType (text, number, date, etc.), label, and optional validation/UI hints. Services can inherit these fields via inheritedFieldKeys."),
+    groups: zod_1.z.array(dynamic_fields_1.FieldGroupSchema).default([]).describe("Logical groupings for organizing fields into sections (e.g., 'Contact Information', 'Medical History'). Each group has a groupKey, label, and optional display settings like collapsible and displayOrder. Fields reference groups via their groupKey property."),
+    reuseDetails: zod_1.z.boolean().default(false).describe("When true, indicates that captured field data can be reused across appointments for the same customer. Enables pre-populating fields for returning customers to reduce redundant data entry."),
+    ensureEmail: zod_1.z.boolean().default(false).describe("When true, ensures an email field is always included in the field configuration, even if not explicitly defined. Useful for organizations that require email for all appointments."),
+    ensurePhone: zod_1.z.boolean().default(false).describe("When true, ensures a phone field is always included in the field configuration, even if not explicitly defined. Useful for organizations that require phone contact for all appointments."),
+});
+exports.CreateAppointmentFieldConfigSchema = exports.AppointmentFieldConfigSchema.omit({
+    createdAt: true,
+    updatedAt: true,
+});
+exports.UpdateAppointmentFieldConfigSchema = exports.CreateAppointmentFieldConfigSchema.partial().safeExtend({
+    id: zod_1.z.string(),
+});

package/dist/core/business-mgt/bookings.shared.schema.d.ts

@@ -0,0 +1,47 @@
+import z from "zod";
+/**
+ * @fileoverview Shared booking schema definitions used across services and reservations.
+ * @module business-mgt/bookings-shared
+ */
+/**
+ * Service deposit strategy options.
+ *
+ * @enum {string}
+ */
+export declare enum ServiceDepositStrategy {
+    NONE = "NONE",
+    FIXED = "FIXED",
+    PERCENTAGE = "PERCENTAGE"
+}
+/**
+ * Reservation type options.
+ *
+ * @enum {string}
+ */
+export declare enum ReservationType {
+    Table = "TABLE",
+    Room = "ROOM",
+    Rental = "RENTAL",
+    Other = "OTHER"
+}
+/**
+ * Service booking rules schema.
+ * Configures online booking availability, customer restrictions, and cancellation policies.
+ *
+ * @typedef {Object} ServiceBookingRules
+ * @property {boolean} onlineEnabled - Whether online booking is enabled
+ * @property {boolean} existingOnly - Whether only existing customers can book
+ * @property {boolean} requiresConsult - Whether a consultation is required before booking
+ * @property {number} maxDaysOut - Max days in advance this can be booked
+ * @property {number} minNoticeHours - Minimum booking notice in hours
+ * @property {number} lateCancelHours - Late cancellation threshold in hours
+ */
+export declare const ServiceBookingRulesSchema: z.ZodObject<{
+    onlineEnabled: z.ZodDefault<z.ZodBoolean>;
+    existingOnly: z.ZodDefault<z.ZodBoolean>;
+    requiresConsult: z.ZodDefault<z.ZodBoolean>;
+    maxDaysOut: z.ZodDefault<z.ZodNumber>;
+    minNoticeHours: z.ZodDefault<z.ZodNumber>;
+    lateCancelHours: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type ServiceBookingRules = z.infer<typeof ServiceBookingRulesSchema>;

package/dist/core/business-mgt/bookings.shared.schema.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceBookingRulesSchema = exports.ReservationType = exports.ServiceDepositStrategy = void 0;
+const zod_1 = __importDefault(require("zod"));
+/**
+ * @fileoverview Shared booking schema definitions used across services and reservations.
+ * @module business-mgt/bookings-shared
+ */
+// ============================================================================
+// ENUMS
+// ============================================================================
+/**
+ * Service deposit strategy options.
+ *
+ * @enum {string}
+ */
+var ServiceDepositStrategy;
+(function (ServiceDepositStrategy) {
+    ServiceDepositStrategy["NONE"] = "NONE";
+    ServiceDepositStrategy["FIXED"] = "FIXED";
+    ServiceDepositStrategy["PERCENTAGE"] = "PERCENTAGE";
+})(ServiceDepositStrategy || (exports.ServiceDepositStrategy = ServiceDepositStrategy = {}));
+/**
+ * Reservation type options.
+ *
+ * @enum {string}
+ */
+var ReservationType;
+(function (ReservationType) {
+    ReservationType["Table"] = "TABLE";
+    ReservationType["Room"] = "ROOM";
+    ReservationType["Rental"] = "RENTAL";
+    ReservationType["Other"] = "OTHER";
+})(ReservationType || (exports.ReservationType = ReservationType = {}));
+// ============================================================================
+// SERVICE BOOKING RULES SCHEMA
+// ============================================================================
+/**
+ * Service booking rules schema.
+ * Configures online booking availability, customer restrictions, and cancellation policies.
+ *
+ * @typedef {Object} ServiceBookingRules
+ * @property {boolean} onlineEnabled - Whether online booking is enabled
+ * @property {boolean} existingOnly - Whether only existing customers can book
+ * @property {boolean} requiresConsult - Whether a consultation is required before booking
+ * @property {number} maxDaysOut - Max days in advance this can be booked
+ * @property {number} minNoticeHours - Minimum booking notice in hours
+ * @property {number} lateCancelHours - Late cancellation threshold in hours
+ */
+exports.ServiceBookingRulesSchema = zod_1.default.object({
+    onlineEnabled: zod_1.default.boolean().default(true).describe("Whether online booking is enabled"),
+    existingOnly: zod_1.default.boolean().default(false).describe("Whether only existing customers can book"),
+    requiresConsult: zod_1.default.boolean().default(false).describe("Whether a consultation is required before booking"),
+    maxDaysOut: zod_1.default.number().int().positive().default(30).describe("Max days in advance this can be booked"),
+    minNoticeHours: zod_1.default.number().int().nonnegative().default(0).describe("Minimum booking notice in hours"),
+    lateCancelHours: zod_1.default.number().int().nonnegative().default(24).describe("Late cancellation threshold in hours"),
+});