wiil-core-js 0.0.82

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

@@ -0,0 +1,122 @@
+import z from "zod";
+/**
+ * @fileoverview Service Person schema definitions for service providers/staff.
+ * @module business-mgt/service-person
+ *
+ * Service persons represent staff members who can be assigned to perform services.
+ */
+/**
+ * Service Person schema.
+ * Represents a staff member or provider who can perform services.
+ *
+ * @typedef {Object} ServicePerson
+ * @property {string} [locationId] - Location this provider is assigned to
+ * @property {string} [userAccountId] - Linked user account ID
+ * @property {string} name - Display name for this provider
+ * @property {string} [avatar] - Provider avatar URL
+ * @property {string} [description] - Provider description/bio
+ * @property {Array} [skills] - Skill IDs this provider can perform
+ * @property {number} [commissionPercent] - Provider commission percentage (0-100)
+ * @property {string} [scheduleId] - Schedule ID for provider availability
+ * @property {boolean} bookableOnline - Whether customers can book online
+ * @property {boolean} bookableByStaff - Whether staff can assign internally
+ * @property {boolean} isActive - Whether this provider is active
+ */
+export declare const ServicePersonSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    userAccountId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodString;
+    avatar: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    skills: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    commissionPercent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    scheduleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bookableOnline: z.ZodDefault<z.ZodBoolean>;
+    bookableByStaff: z.ZodDefault<z.ZodBoolean>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new service person.
+ * Omits auto-generated fields.
+ */
+export declare const CreateServicePersonSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    userAccountId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    avatar: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+    skills: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    commissionPercent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    scheduleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bookableOnline: z.ZodDefault<z.ZodBoolean>;
+    bookableByStaff: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing service person.
+ * All fields optional except id (required).
+ */
+export declare const UpdateServicePersonSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    isActive: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    locationId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    userAccountId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    avatar: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodURL>>>;
+    skills: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>>;
+    commissionPercent: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    scheduleId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    bookableOnline: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    bookableByStaff: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type ServicePerson = z.infer<typeof ServicePersonSchema>;
+export type CreateServicePerson = z.infer<typeof CreateServicePersonSchema>;
+export type UpdateServicePerson = z.infer<typeof UpdateServicePersonSchema>;
+/**
+ * Service person filter options.
+ * @interface ServicePersonFilters
+ */
+export interface ServicePersonFilters {
+    /** Text search across name/description */
+    search?: string;
+    /** Filter by location ID */
+    locationId?: string;
+    /** Filter by linked user account ID */
+    userAccountId?: string;
+    /** Filter by skill ID */
+    skillId?: string;
+    /** Filter by online bookability */
+    bookableOnline?: boolean;
+    /** Filter by staff bookability */
+    bookableByStaff?: boolean;
+    /** Filter by active status */
+    isActive?: boolean;
+}
+/**
+ * Service person sorting options.
+ * @interface ServicePersonSorting
+ */
+export interface ServicePersonSorting {
+    /** Field to sort by */
+    field: "name" | "commissionPercent" | "createdAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Service person query options.
+ * @interface ServicePersonQueryOptions
+ */
+export interface ServicePersonQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: ServicePersonFilters;
+    /** Optional sorting */
+    sorting?: ServicePersonSorting;
+}

package/dist/core/business-mgt/service-management/service-person.schema.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateServicePersonSchema = exports.CreateServicePersonSchema = exports.ServicePersonSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+const base_schema_1 = require("../../base.schema");
+/**
+ * @fileoverview Service Person schema definitions for service providers/staff.
+ * @module business-mgt/service-person
+ *
+ * Service persons represent staff members who can be assigned to perform services.
+ */
+// ============================================================================
+// SERVICE PERSON SCHEMA
+// ============================================================================
+/**
+ * Service Person schema.
+ * Represents a staff member or provider who can perform services.
+ *
+ * @typedef {Object} ServicePerson
+ * @property {string} [locationId] - Location this provider is assigned to
+ * @property {string} [userAccountId] - Linked user account ID
+ * @property {string} name - Display name for this provider
+ * @property {string} [avatar] - Provider avatar URL
+ * @property {string} [description] - Provider description/bio
+ * @property {Array} [skills] - Skill IDs this provider can perform
+ * @property {number} [commissionPercent] - Provider commission percentage (0-100)
+ * @property {string} [scheduleId] - Schedule ID for provider availability
+ * @property {boolean} bookableOnline - Whether customers can book online
+ * @property {boolean} bookableByStaff - Whether staff can assign internally
+ * @property {boolean} isActive - Whether this provider is active
+ */
+exports.ServicePersonSchema = base_schema_1.BaseModelSchema.safeExtend({
+    locationId: zod_1.default.string().nullable().optional().describe("Location this provider is assigned to. Null for providers available at all locations."),
+    userAccountId: zod_1.default.string().nullable().optional().describe("Linked user account ID for staff login and calendar sync."),
+    name: zod_1.default.string().min(1).describe("Display name for this provider shown to customers during booking."),
+    avatar: zod_1.default.url().nullable().optional().describe("Provider avatar URL for visual identification."),
+    description: zod_1.default.string().nullable().optional().describe("Provider description or bio displayed during booking."),
+    skills: zod_1.default.array(zod_1.default.string()).nullable().optional().describe("Skill IDs this provider can perform. Used to filter available providers per service."),
+    commissionPercent: zod_1.default.number().min(0).max(100).nullable().optional().describe("Provider commission percentage (0-100). Used for payroll calculations."),
+    scheduleId: zod_1.default.string().nullable().optional().describe("Schedule ID for provider availability. Links to scheduling system."),
+    bookableOnline: zod_1.default.boolean().default(true).describe("Whether customers can book this provider online."),
+    bookableByStaff: zod_1.default.boolean().default(true).describe("Whether staff can assign this provider internally."),
+    isActive: zod_1.default.boolean().default(true).describe("Whether this provider is active and available for booking."),
+});
+// ============================================================================
+// CREATE/UPDATE SCHEMAS
+// ============================================================================
+/**
+ * Schema for creating a new service person.
+ * Omits auto-generated fields.
+ */
+exports.CreateServicePersonSchema = exports.ServicePersonSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+});
+/**
+ * Schema for updating an existing service person.
+ * All fields optional except id (required).
+ */
+exports.UpdateServicePersonSchema = exports.CreateServicePersonSchema.partial().safeExtend({
+    id: zod_1.default.string().describe("Unique identifier of the ServicePerson to update"),
+});

package/dist/core/business-mgt/service-management/service-pricing-rule.schema.d.ts

@@ -0,0 +1,221 @@
+import z from "zod";
+import { PricingChannel, PricingRuleAdjustmentType, PricingRuleApplyLevel } from "../pricing-rule.shared.schema";
+/**
+ * @fileoverview Service Pricing Rule schema definitions.
+ * @module business-mgt/service-pricing-rule
+ *
+ * Service pricing rules define conditional pricing adjustments for services.
+ * Supports time-based promotions, channel-specific pricing, and service targeting.
+ */
+/**
+ * Service pricing rule condition schema.
+ * Extends common pricing conditions with service-specific targeting.
+ *
+ * @typedef {Object} ServicePricingRuleCondition
+ * @property {boolean} allServices - Apply to all services
+ * @property {string[]} serviceIdsAny - Apply if any of these services match
+ * @property {string[]} serviceIdsAll - Apply only if all these services are present
+ */
+export declare const ServicePricingRuleConditionSchema: z.ZodObject<{
+    daysOfWeek: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    startMinute: z.ZodOptional<z.ZodNumber>;
+    endMinute: z.ZodOptional<z.ZodNumber>;
+    customerSegmentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    channel: z.ZodDefault<z.ZodEnum<typeof PricingChannel>>;
+    allServices: z.ZodDefault<z.ZodBoolean>;
+    serviceIdsAny: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    serviceIdsAll: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Service Pricing Rule schema.
+ * Defines a pricing rule for service-based pricing adjustments.
+ *
+ * @typedef {Object} ServicePricingRule
+ * @property {string} [locationId] - Location scope (null for all locations)
+ * @property {string} name - Rule display name
+ * @property {string} applyLevel - Apply at ORDER or LINE level
+ * @property {boolean} isStackable - Whether rule can stack with others
+ * @property {number} priority - Rule priority (higher = applied first)
+ * @property {Array} [channelMappings] - Per-channel external rule ID mappings
+ * @property {Object} condition - Rule matching conditions
+ * @property {Object} action - Pricing adjustment action
+ * @property {number} [effectiveFrom] - Start timestamp for rule
+ * @property {number} [effectiveTo] - End timestamp for rule
+ * @property {boolean} isActive - Whether rule is active
+ */
+export declare const ServicePricingRuleSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodString;
+    applyLevel: z.ZodDefault<z.ZodEnum<typeof PricingRuleApplyLevel>>;
+    isStackable: z.ZodDefault<z.ZodBoolean>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    channelMappings: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        channelId: z.ZodString;
+        externalPricingRuleId: z.ZodString;
+    }, z.core.$strip>>>>;
+    condition: z.ZodDefault<z.ZodObject<{
+        daysOfWeek: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+        startMinute: z.ZodOptional<z.ZodNumber>;
+        endMinute: z.ZodOptional<z.ZodNumber>;
+        customerSegmentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        channel: z.ZodDefault<z.ZodEnum<typeof PricingChannel>>;
+        allServices: z.ZodDefault<z.ZodBoolean>;
+        serviceIdsAny: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        serviceIdsAll: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    action: z.ZodObject<{
+        adjustmentType: z.ZodEnum<typeof PricingRuleAdjustmentType>;
+        adjustmentValue: z.ZodNumber;
+        currency: z.ZodDefault<z.ZodString>;
+        maxAdjustmentAmount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    effectiveFrom: z.ZodOptional<z.ZodNumber>;
+    effectiveTo: z.ZodOptional<z.ZodNumber>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new service pricing rule.
+ * Omits auto-generated fields, includes optional placement for ordering.
+ */
+export declare const CreateServicePricingRuleSchema: z.ZodObject<{
+    name: z.ZodString;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isStackable: z.ZodDefault<z.ZodBoolean>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    effectiveFrom: z.ZodOptional<z.ZodNumber>;
+    effectiveTo: z.ZodOptional<z.ZodNumber>;
+    applyLevel: z.ZodDefault<z.ZodEnum<typeof PricingRuleApplyLevel>>;
+    channelMappings: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        channelId: z.ZodString;
+        externalPricingRuleId: z.ZodString;
+    }, z.core.$strip>>>>;
+    condition: z.ZodDefault<z.ZodObject<{
+        daysOfWeek: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+        startMinute: z.ZodOptional<z.ZodNumber>;
+        endMinute: z.ZodOptional<z.ZodNumber>;
+        customerSegmentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        channel: z.ZodDefault<z.ZodEnum<typeof PricingChannel>>;
+        allServices: z.ZodDefault<z.ZodBoolean>;
+        serviceIdsAny: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        serviceIdsAll: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    action: z.ZodObject<{
+        adjustmentType: z.ZodEnum<typeof PricingRuleAdjustmentType>;
+        adjustmentValue: z.ZodNumber;
+        currency: z.ZodDefault<z.ZodString>;
+        maxAdjustmentAmount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    placement: z.ZodOptional<z.ZodObject<{
+        placementIntent: z.ZodObject<{
+            mode: z.ZodEnum<{
+                BEGINNING: "BEGINNING";
+                END: "END";
+                KEEP_CURRENT: "KEEP_CURRENT";
+                BEFORE_ITEM: "BEFORE_ITEM";
+                AFTER_ITEM: "AFTER_ITEM";
+                ABSOLUTE_INDEX: "ABSOLUTE_INDEX";
+            }>;
+        }, z.core.$strip>;
+        anchorItemId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        absoluteIndex: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing service pricing rule.
+ * All fields optional except id (required).
+ */
+export declare const UpdateServicePricingRuleSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    locationId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    isStackable: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    priority: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    effectiveFrom: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    effectiveTo: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    applyLevel: z.ZodOptional<z.ZodDefault<z.ZodEnum<typeof PricingRuleApplyLevel>>>;
+    channelMappings: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        channelId: z.ZodString;
+        externalPricingRuleId: z.ZodString;
+    }, z.core.$strip>>>>>;
+    condition: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+        daysOfWeek: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+        startMinute: z.ZodOptional<z.ZodNumber>;
+        endMinute: z.ZodOptional<z.ZodNumber>;
+        customerSegmentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        channel: z.ZodDefault<z.ZodEnum<typeof PricingChannel>>;
+        allServices: z.ZodDefault<z.ZodBoolean>;
+        serviceIdsAny: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        serviceIdsAll: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    action: z.ZodOptional<z.ZodObject<{
+        adjustmentType: z.ZodEnum<typeof PricingRuleAdjustmentType>;
+        adjustmentValue: z.ZodNumber;
+        currency: z.ZodDefault<z.ZodString>;
+        maxAdjustmentAmount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    placement: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        placementIntent: z.ZodObject<{
+            mode: z.ZodEnum<{
+                BEGINNING: "BEGINNING";
+                END: "END";
+                KEEP_CURRENT: "KEEP_CURRENT";
+                BEFORE_ITEM: "BEFORE_ITEM";
+                AFTER_ITEM: "AFTER_ITEM";
+                ABSOLUTE_INDEX: "ABSOLUTE_INDEX";
+            }>;
+        }, z.core.$strip>;
+        anchorItemId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        absoluteIndex: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type ServicePricingRuleCondition = z.infer<typeof ServicePricingRuleConditionSchema>;
+export type ServicePricingRule = z.infer<typeof ServicePricingRuleSchema>;
+export type CreateServicePricingRule = z.infer<typeof CreateServicePricingRuleSchema>;
+export type UpdateServicePricingRule = z.infer<typeof UpdateServicePricingRuleSchema>;
+/**
+ * Service pricing rule filter options.
+ * @interface ServicePricingRuleFilters
+ */
+export interface ServicePricingRuleFilters {
+    /** Text search across name */
+    search?: string;
+    /** Filter by location ID */
+    locationId?: string;
+    /** Filter by apply level */
+    applyLevel?: PricingRuleApplyLevel;
+    /** Filter by pricing channel */
+    channel?: PricingChannel;
+    /** Filter by stackability */
+    isStackable?: boolean;
+    /** Filter by active status */
+    isActive?: boolean;
+}
+/**
+ * Service pricing rule sorting options.
+ * @interface ServicePricingRuleSorting
+ */
+export interface ServicePricingRuleSorting {
+    /** Field to sort by */
+    field: "name" | "priority" | "createdAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Service pricing rule query options.
+ * @interface ServicePricingRuleQueryOptions
+ */
+export interface ServicePricingRuleQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: ServicePricingRuleFilters;
+    /** Optional sorting */
+    sorting?: ServicePricingRuleSorting;
+}

package/dist/core/business-mgt/service-management/service-pricing-rule.schema.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateServicePricingRuleSchema = exports.CreateServicePricingRuleSchema = exports.ServicePricingRuleSchema = exports.ServicePricingRuleConditionSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+const base_schema_1 = require("../../base.schema");
+const display_order_1 = require("../../type-definitions/display-order");
+const pricing_rule_shared_schema_1 = require("../pricing-rule.shared.schema");
+/**
+ * @fileoverview Service Pricing Rule schema definitions.
+ * @module business-mgt/service-pricing-rule
+ *
+ * Service pricing rules define conditional pricing adjustments for services.
+ * Supports time-based promotions, channel-specific pricing, and service targeting.
+ */
+// ============================================================================
+// SERVICE PRICING RULE CONDITION SCHEMA
+// ============================================================================
+/**
+ * Service pricing rule condition schema.
+ * Extends common pricing conditions with service-specific targeting.
+ *
+ * @typedef {Object} ServicePricingRuleCondition
+ * @property {boolean} allServices - Apply to all services
+ * @property {string[]} serviceIdsAny - Apply if any of these services match
+ * @property {string[]} serviceIdsAll - Apply only if all these services are present
+ */
+exports.ServicePricingRuleConditionSchema = pricing_rule_shared_schema_1.PricingRuleCommonConditionSchema.safeExtend({
+    allServices: zod_1.default.boolean().default(false).describe("Apply rule to all services"),
+    serviceIdsAny: zod_1.default.array(zod_1.default.string()).default([]).describe("Apply if any of these service IDs match"),
+    serviceIdsAll: zod_1.default.array(zod_1.default.string()).default([]).describe("Apply only if all these service IDs are present"),
+}).superRefine((data, ctx) => {
+    const hasServiceSelectors = data.serviceIdsAny.length > 0 || data.serviceIdsAll.length > 0;
+    if (data.allServices && hasServiceSelectors) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["allServices"],
+            message: "allServices cannot be combined with serviceIdsAny/serviceIdsAll",
+        });
+    }
+});
+// ============================================================================
+// SERVICE PRICING RULE SCHEMA
+// ============================================================================
+/**
+ * Service Pricing Rule schema.
+ * Defines a pricing rule for service-based pricing adjustments.
+ *
+ * @typedef {Object} ServicePricingRule
+ * @property {string} [locationId] - Location scope (null for all locations)
+ * @property {string} name - Rule display name
+ * @property {string} applyLevel - Apply at ORDER or LINE level
+ * @property {boolean} isStackable - Whether rule can stack with others
+ * @property {number} priority - Rule priority (higher = applied first)
+ * @property {Array} [channelMappings] - Per-channel external rule ID mappings
+ * @property {Object} condition - Rule matching conditions
+ * @property {Object} action - Pricing adjustment action
+ * @property {number} [effectiveFrom] - Start timestamp for rule
+ * @property {number} [effectiveTo] - End timestamp for rule
+ * @property {boolean} isActive - Whether rule is active
+ */
+exports.ServicePricingRuleSchema = base_schema_1.BaseModelSchema.safeExtend({
+    locationId: zod_1.default.string().nullable().optional().describe("Location ID scope. Null for all locations."),
+    name: zod_1.default.string().min(1).max(120).describe("Rule display name"),
+    applyLevel: zod_1.default.enum(pricing_rule_shared_schema_1.PricingRuleApplyLevel).default(pricing_rule_shared_schema_1.PricingRuleApplyLevel.ORDER).describe("Apply at ORDER or LINE level"),
+    isStackable: zod_1.default.boolean().default(true).describe("Whether this rule can stack with other rules"),
+    priority: zod_1.default.number().int().nonnegative().default(0).describe("Rule priority (higher = applied first)"),
+    channelMappings: zod_1.default.array(pricing_rule_shared_schema_1.PricingRuleChannelMappingSchema).nullable().optional().describe("Per-channel external pricing rule ID mappings"),
+    condition: exports.ServicePricingRuleConditionSchema.default({
+        allServices: false,
+        serviceIdsAny: [],
+        serviceIdsAll: [],
+        daysOfWeek: [],
+        channel: pricing_rule_shared_schema_1.PricingChannel.ALL,
+    }).describe("Rule matching conditions"),
+    action: pricing_rule_shared_schema_1.PricingRuleActionSchema.describe("Pricing adjustment action"),
+    effectiveFrom: zod_1.default.number().int().nonnegative().optional().describe("Unix timestamp when rule becomes active"),
+    effectiveTo: zod_1.default.number().int().nonnegative().optional().describe("Unix timestamp when rule expires"),
+    isActive: zod_1.default.boolean().default(true).describe("Whether this rule is currently active"),
+}).superRefine((data, ctx) => {
+    if (data.action.adjustmentType === pricing_rule_shared_schema_1.PricingRuleAdjustmentType.PERCENTAGE && data.action.adjustmentValue > 100) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["action", "adjustmentValue"],
+            message: "adjustmentValue cannot exceed 100 for percentage adjustments",
+        });
+    }
+    if (data.effectiveFrom !== undefined && data.effectiveTo !== undefined && data.effectiveTo < data.effectiveFrom) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["effectiveTo"],
+            message: "effectiveTo must be greater than or equal to effectiveFrom",
+        });
+    }
+});
+// ============================================================================
+// CREATE/UPDATE SCHEMAS
+// ============================================================================
+/**
+ * Schema for creating a new service pricing rule.
+ * Omits auto-generated fields, includes optional placement for ordering.
+ */
+exports.CreateServicePricingRuleSchema = exports.ServicePricingRuleSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+}).safeExtend({
+    placement: display_order_1.CreateDisplayOrderPlacementSchema.optional().describe("Optional placement for display ordering"),
+});
+/**
+ * Schema for updating an existing service pricing rule.
+ * All fields optional except id (required).
+ */
+exports.UpdateServicePricingRuleSchema = exports.CreateServicePricingRuleSchema.partial().safeExtend({
+    id: zod_1.default.string().describe("Unique identifier of the ServicePricingRule to update"),
+});

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

@@ -0,0 +1,90 @@
+import z from "zod";
+/**
+ * @fileoverview Service Provider join schema for service-to-provider assignments.
+ * @module business-mgt/service-provider
+ *
+ * Many-to-many relationship between services and providers with per-provider overrides.
+ */
+/**
+ * Service Provider join schema.
+ * Links services to providers with optional price/duration overrides.
+ *
+ * @typedef {Object} ServiceProvider
+ * @property {string} serviceId - Service ID being assigned
+ * @property {string} providerId - Provider ID (typically ServicePerson ID)
+ * @property {number} [priceOverride] - Provider-specific price override
+ * @property {number} [durationOverride] - Provider-specific duration override in minutes
+ * @property {boolean} active - Whether this assignment is active
+ */
+export declare const ServiceProviderSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    serviceId: z.ZodString;
+    providerId: z.ZodString;
+    priceOverride: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    durationOverride: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    active: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new service provider assignment.
+ * Omits auto-generated fields.
+ */
+export declare const CreateServiceProviderSchema: z.ZodObject<{
+    active: z.ZodDefault<z.ZodBoolean>;
+    serviceId: z.ZodString;
+    providerId: z.ZodString;
+    priceOverride: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    durationOverride: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing service provider assignment.
+ * All fields optional except id (required).
+ */
+export declare const UpdateServiceProviderSchema: z.ZodObject<{
+    active: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    serviceId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    priceOverride: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    durationOverride: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type ServiceProvider = z.infer<typeof ServiceProviderSchema>;
+export type CreateServiceProvider = z.infer<typeof CreateServiceProviderSchema>;
+export type UpdateServiceProvider = z.infer<typeof UpdateServiceProviderSchema>;
+/**
+ * Service provider filter options.
+ * @interface ServiceProviderFilters
+ */
+export interface ServiceProviderFilters {
+    /** Filter by service ID */
+    serviceId?: string;
+    /** Filter by provider ID */
+    providerId?: string;
+    /** Filter by active status */
+    active?: boolean;
+}
+/**
+ * Service provider sorting options.
+ * @interface ServiceProviderSorting
+ */
+export interface ServiceProviderSorting {
+    /** Field to sort by */
+    field: "createdAt" | "updatedAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Service provider query options.
+ * @interface ServiceProviderQueryOptions
+ */
+export interface ServiceProviderQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: ServiceProviderFilters;
+    /** Optional sorting */
+    sorting?: ServiceProviderSorting;
+}

package/dist/core/business-mgt/service-management/service-provider.schema.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateServiceProviderSchema = exports.CreateServiceProviderSchema = exports.ServiceProviderSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+const base_schema_1 = require("../../base.schema");
+/**
+ * @fileoverview Service Provider join schema for service-to-provider assignments.
+ * @module business-mgt/service-provider
+ *
+ * Many-to-many relationship between services and providers with per-provider overrides.
+ */
+// ============================================================================
+// SERVICE PROVIDER SCHEMA
+// ============================================================================
+/**
+ * Service Provider join schema.
+ * Links services to providers with optional price/duration overrides.
+ *
+ * @typedef {Object} ServiceProvider
+ * @property {string} serviceId - Service ID being assigned
+ * @property {string} providerId - Provider ID (typically ServicePerson ID)
+ * @property {number} [priceOverride] - Provider-specific price override
+ * @property {number} [durationOverride] - Provider-specific duration override in minutes
+ * @property {boolean} active - Whether this assignment is active
+ */
+exports.ServiceProviderSchema = base_schema_1.BaseModelSchema.safeExtend({
+    serviceId: zod_1.default.string().describe("Service ID being assigned to the provider"),
+    providerId: zod_1.default.string().describe("Provider ID (typically ServicePerson ID)"),
+    priceOverride: zod_1.default.number().nonnegative().nullable().optional().describe("Provider-specific price override. Null means use service default price."),
+    durationOverride: zod_1.default.number().int().positive().nullable().optional().describe("Provider-specific duration override in minutes. Null means use service default duration."),
+    active: zod_1.default.boolean().default(true).describe("Whether this provider assignment is active"),
+});
+// ============================================================================
+// CREATE/UPDATE SCHEMAS
+// ============================================================================
+/**
+ * Schema for creating a new service provider assignment.
+ * Omits auto-generated fields.
+ */
+exports.CreateServiceProviderSchema = exports.ServiceProviderSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+});
+/**
+ * Schema for updating an existing service provider assignment.
+ * All fields optional except id (required).
+ */
+exports.UpdateServiceProviderSchema = exports.CreateServiceProviderSchema.partial().safeExtend({
+    id: zod_1.default.string().describe("Unique identifier of the ServiceProvider to update"),
+});