wiil-core-js 0.0.82

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

@@ -0,0 +1,90 @@
+import z from "zod";
+/**
+ * @fileoverview Service Slot Query schemas for availability lookups.
+ * @module business-mgt/service-slot-query
+ *
+ * Request/response schemas for querying available appointment slots.
+ * These are transient query objects, not persisted database models.
+ */
+/**
+ * Local date format schema (YYYY-MM-DD).
+ */
+export declare const LocalDateSchema: z.ZodString;
+/**
+ * Timezone identifier schema.
+ */
+export declare const TimezoneSchema: z.ZodString;
+/**
+ * Time of day value schema (h:mm AM/PM format).
+ */
+export declare const TimeOfDayValueSchema: z.ZodString;
+/**
+ * Service slot query request schema.
+ * Used to request available appointment slots for a service.
+ *
+ * @typedef {Object} ServiceSlotQueryRequest
+ * @property {string} serviceId - Service ID to query slots for
+ * @property {string} localDate - Business local date (YYYY-MM-DD)
+ * @property {string} [locationId] - Optional location filter
+ * @property {string} providerId - Provider filter
+ * @property {number} maxResults - Maximum slots to return
+ */
+export declare const ServiceSlotQueryRequestSchema: z.ZodObject<{
+    serviceId: z.ZodString;
+    localDate: z.ZodString;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    providerId: z.ZodString;
+    maxResults: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Service candidate slot schema.
+ * Represents an available time slot for booking.
+ *
+ * @typedef {Object} ServiceCandidateSlot
+ * @property {string} providerId - Provider that can serve this slot
+ * @property {string} [serviceProviderId] - Optional service-provider assignment ID
+ * @property {string} startTimeOfDay - Local start time (h:mm AM/PM)
+ * @property {number} startMinuteOfDay - Local start minute in day (0-1439)
+ * @property {number} endMinuteOfDay - Local end minute in day (1-1440)
+ * @property {number} startTimeUtcSec - Slot start UTC timestamp in seconds
+ * @property {number} endTimeUtcSec - Slot end UTC timestamp in seconds
+ */
+export declare const ServiceCandidateSlotSchema: z.ZodObject<{
+    providerId: z.ZodString;
+    serviceProviderId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    startTimeOfDay: z.ZodString;
+    startMinuteOfDay: z.ZodNumber;
+    endMinuteOfDay: z.ZodNumber;
+    startTimeUtcSec: z.ZodNumber;
+    endTimeUtcSec: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Service slot query response schema.
+ * Contains available slots for the requested date.
+ *
+ * @typedef {Object} ServiceSlotQueryResponse
+ * @property {string} localDate - The queried local date
+ * @property {string} timezone - Timezone used for the response
+ * @property {number} generatedAt - Generation timestamp (UTC milliseconds)
+ * @property {Array} slots - Available candidate slots
+ */
+export declare const ServiceSlotQueryResponseSchema: z.ZodObject<{
+    localDate: z.ZodString;
+    timezone: z.ZodString;
+    generatedAt: z.ZodNumber;
+    slots: z.ZodArray<z.ZodObject<{
+        providerId: z.ZodString;
+        serviceProviderId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        startTimeOfDay: z.ZodString;
+        startMinuteOfDay: z.ZodNumber;
+        endMinuteOfDay: z.ZodNumber;
+        startTimeUtcSec: z.ZodNumber;
+        endTimeUtcSec: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LocalDate = z.infer<typeof LocalDateSchema>;
+export type Timezone = z.infer<typeof TimezoneSchema>;
+export type TimeOfDayValue = z.infer<typeof TimeOfDayValueSchema>;
+export type ServiceSlotQueryRequest = z.infer<typeof ServiceSlotQueryRequestSchema>;
+export type ServiceCandidateSlot = z.infer<typeof ServiceCandidateSlotSchema>;
+export type ServiceSlotQueryResponse = z.infer<typeof ServiceSlotQueryResponseSchema>;

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

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceSlotQueryResponseSchema = exports.ServiceCandidateSlotSchema = exports.ServiceSlotQueryRequestSchema = exports.TimeOfDayValueSchema = exports.TimezoneSchema = exports.LocalDateSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+/**
+ * @fileoverview Service Slot Query schemas for availability lookups.
+ * @module business-mgt/service-slot-query
+ *
+ * Request/response schemas for querying available appointment slots.
+ * These are transient query objects, not persisted database models.
+ */
+// ============================================================================
+// HELPER SCHEMAS
+// ============================================================================
+/**
+ * Local date format schema (YYYY-MM-DD).
+ */
+exports.LocalDateSchema = zod_1.default
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}$/, "localDate must be YYYY-MM-DD");
+/**
+ * Timezone identifier schema.
+ */
+exports.TimezoneSchema = zod_1.default.string().min(1);
+/**
+ * Time of day value schema (h:mm AM/PM format).
+ */
+exports.TimeOfDayValueSchema = zod_1.default
+    .string()
+    .regex(/^(0?[1-9]|1[0-2]):[0-5]\d\s?(AM|PM)$/i, "startTimeOfDay must be h:mm AM/PM");
+// ============================================================================
+// REQUEST SCHEMA
+// ============================================================================
+/**
+ * Service slot query request schema.
+ * Used to request available appointment slots for a service.
+ *
+ * @typedef {Object} ServiceSlotQueryRequest
+ * @property {string} serviceId - Service ID to query slots for
+ * @property {string} localDate - Business local date (YYYY-MM-DD)
+ * @property {string} [locationId] - Optional location filter
+ * @property {string} providerId - Provider filter
+ * @property {number} maxResults - Maximum slots to return
+ */
+exports.ServiceSlotQueryRequestSchema = zod_1.default.object({
+    serviceId: zod_1.default.string().describe("Service ID"),
+    localDate: exports.LocalDateSchema.describe("Business local date for slot generation"),
+    locationId: zod_1.default.string().nullable().optional().describe("Optional location filter"),
+    providerId: zod_1.default.string().describe("Optional provider filter"),
+    maxResults: zod_1.default.number().int().positive().max(1000).default(10).describe("Maximum number of slots returned"),
+});
+// ============================================================================
+// CANDIDATE SLOT SCHEMA
+// ============================================================================
+/**
+ * Service candidate slot schema.
+ * Represents an available time slot for booking.
+ *
+ * @typedef {Object} ServiceCandidateSlot
+ * @property {string} providerId - Provider that can serve this slot
+ * @property {string} [serviceProviderId] - Optional service-provider assignment ID
+ * @property {string} startTimeOfDay - Local start time (h:mm AM/PM)
+ * @property {number} startMinuteOfDay - Local start minute in day (0-1439)
+ * @property {number} endMinuteOfDay - Local end minute in day (1-1440)
+ * @property {number} startTimeUtcSec - Slot start UTC timestamp in seconds
+ * @property {number} endTimeUtcSec - Slot end UTC timestamp in seconds
+ */
+exports.ServiceCandidateSlotSchema = zod_1.default.object({
+    providerId: zod_1.default.string().describe("Provider that can serve this slot"),
+    serviceProviderId: zod_1.default.string().nullable().optional().describe("Optional service-provider assignment ID"),
+    startTimeOfDay: exports.TimeOfDayValueSchema.describe("Local start time in h:mm AM/PM format"),
+    startMinuteOfDay: zod_1.default.number().int().min(0).max(1439).describe("Local start minute in day"),
+    endMinuteOfDay: zod_1.default.number().int().min(1).max(1440).describe("Local end minute in day"),
+    startTimeUtcSec: zod_1.default.number().describe("Slot start UTC timestamp in seconds"),
+    endTimeUtcSec: zod_1.default.number().describe("Slot end UTC timestamp in seconds"),
+}).superRefine((slot, ctx) => {
+    if (slot.endMinuteOfDay <= slot.startMinuteOfDay) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["endMinuteOfDay"],
+            message: "endMinuteOfDay must be greater than startMinuteOfDay",
+        });
+    }
+    if (slot.endTimeUtcSec <= slot.startTimeUtcSec) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["endTimeUtcSec"],
+            message: "endTimeUtcSec must be greater than startTimeUtcSec",
+        });
+    }
+});
+// ============================================================================
+// RESPONSE SCHEMA
+// ============================================================================
+/**
+ * Service slot query response schema.
+ * Contains available slots for the requested date.
+ *
+ * @typedef {Object} ServiceSlotQueryResponse
+ * @property {string} localDate - The queried local date
+ * @property {string} timezone - Timezone used for the response
+ * @property {number} generatedAt - Generation timestamp (UTC milliseconds)
+ * @property {Array} slots - Available candidate slots
+ */
+exports.ServiceSlotQueryResponseSchema = zod_1.default.object({
+    localDate: exports.LocalDateSchema.describe("The queried local date"),
+    timezone: exports.TimezoneSchema.describe("Timezone identifier used for slot times"),
+    generatedAt: zod_1.default.number().describe("Generation timestamp in UTC milliseconds"),
+    slots: zod_1.default.array(exports.ServiceCandidateSlotSchema).describe("Available candidate slots for the requested local date"),
+});

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

@@ -0,0 +1,121 @@
+import z from "zod";
+import { ServiceProviderTimeOffType, ServiceProviderTimeOffStatus } from "../../type-definitions";
+/**
+ * @fileoverview Service Provider Time Off schema definitions.
+ * @module business-mgt/service-time-off
+ *
+ * Time off records represent periods when service providers are unavailable.
+ * Supports both recurring (weekly) and specific (one-time) time off entries.
+ */
+/**
+ * Recurrence rule for recurring time off.
+ * Defines which days of the week the time off applies.
+ *
+ * @typedef {Object} ServiceProviderTimeOffRecurrence
+ * @property {string[]} dayOfWeek - Days of week (0=Sunday ... 6=Saturday)
+ */
+export declare const ServiceProviderTimeOffRecurrenceSchema: z.ZodObject<{
+    dayOfWeek: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Service Provider Time Off schema.
+ * Represents a time period when a provider is unavailable for appointments.
+ *
+ * @typedef {Object} ServiceProviderTimeOff
+ * @property {string} providerId - Provider ID (ServicePerson ID)
+ * @property {string} type - Time-off type (recurring or specific)
+ * @property {number} startDate - Start date/time as Unix epoch seconds
+ * @property {number} endDate - End date/time as Unix epoch seconds
+ * @property {string} [reason] - Optional reason for time off
+ * @property {string} status - Approval status
+ * @property {Object} [recurrence] - Recurrence rule for recurring time off
+ */
+export declare const ServiceProviderTimeOffSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    providerId: z.ZodString;
+    type: z.ZodEnum<typeof ServiceProviderTimeOffType>;
+    startDate: z.ZodNumber;
+    endDate: z.ZodNumber;
+    reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodDefault<z.ZodEnum<typeof ServiceProviderTimeOffStatus>>;
+    recurrence: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        dayOfWeek: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new service provider time off record.
+ * Omits auto-generated fields.
+ */
+export declare const CreateServiceProviderTimeOffSchema: z.ZodObject<{
+    type: z.ZodEnum<typeof ServiceProviderTimeOffType>;
+    status: z.ZodDefault<z.ZodEnum<typeof ServiceProviderTimeOffStatus>>;
+    reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    startDate: z.ZodNumber;
+    endDate: z.ZodNumber;
+    providerId: z.ZodString;
+    recurrence: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        dayOfWeek: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing service provider time off record.
+ * All fields optional except id (required).
+ */
+export declare const UpdateServiceProviderTimeOffSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<typeof ServiceProviderTimeOffType>>;
+    status: z.ZodOptional<z.ZodDefault<z.ZodEnum<typeof ServiceProviderTimeOffStatus>>>;
+    reason: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    startDate: z.ZodOptional<z.ZodNumber>;
+    endDate: z.ZodOptional<z.ZodNumber>;
+    providerId: z.ZodOptional<z.ZodString>;
+    recurrence: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        dayOfWeek: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type ServiceProviderTimeOffRecurrence = z.infer<typeof ServiceProviderTimeOffRecurrenceSchema>;
+export type ServiceProviderTimeOff = z.infer<typeof ServiceProviderTimeOffSchema>;
+export type CreateServiceProviderTimeOff = z.infer<typeof CreateServiceProviderTimeOffSchema>;
+export type UpdateServiceProviderTimeOff = z.infer<typeof UpdateServiceProviderTimeOffSchema>;
+/**
+ * Service provider time off filter options.
+ * @interface ServiceProviderTimeOffFilters
+ */
+export interface ServiceProviderTimeOffFilters {
+    /** Filter by provider ID */
+    providerId?: string;
+    /** Filter by time-off type */
+    type?: ServiceProviderTimeOffType;
+    /** Filter by approval status */
+    status?: ServiceProviderTimeOffStatus;
+    /** Filter by start date (Unix epoch seconds) */
+    fromDate?: number;
+    /** Filter by end date (Unix epoch seconds) */
+    toDate?: number;
+}
+/**
+ * Service provider time off sorting options.
+ * @interface ServiceProviderTimeOffSorting
+ */
+export interface ServiceProviderTimeOffSorting {
+    /** Field to sort by */
+    field: "startDate" | "endDate" | "createdAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Service provider time off query options.
+ * @interface ServiceProviderTimeOffQueryOptions
+ */
+export interface ServiceProviderTimeOffQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: ServiceProviderTimeOffFilters;
+    /** Optional sorting */
+    sorting?: ServiceProviderTimeOffSorting;
+}

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

@@ -0,0 +1,95 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateServiceProviderTimeOffSchema = exports.CreateServiceProviderTimeOffSchema = exports.ServiceProviderTimeOffSchema = exports.ServiceProviderTimeOffRecurrenceSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+const base_schema_1 = require("../../base.schema");
+const type_definitions_1 = require("../../type-definitions");
+/**
+ * @fileoverview Service Provider Time Off schema definitions.
+ * @module business-mgt/service-time-off
+ *
+ * Time off records represent periods when service providers are unavailable.
+ * Supports both recurring (weekly) and specific (one-time) time off entries.
+ */
+// ============================================================================
+// RECURRENCE SCHEMA
+// ============================================================================
+/**
+ * Recurrence rule for recurring time off.
+ * Defines which days of the week the time off applies.
+ *
+ * @typedef {Object} ServiceProviderTimeOffRecurrence
+ * @property {string[]} dayOfWeek - Days of week (0=Sunday ... 6=Saturday)
+ */
+exports.ServiceProviderTimeOffRecurrenceSchema = zod_1.default.object({
+    dayOfWeek: zod_1.default.array(zod_1.default.string().regex(/^[0-6]$/, "Day must be 0-6")).min(1).describe("Recurring days of week (0=Sunday ... 6=Saturday)"),
+}).describe("Recurrence rule for recurring time off");
+// ============================================================================
+// SERVICE PROVIDER TIME OFF SCHEMA
+// ============================================================================
+/**
+ * Service Provider Time Off schema.
+ * Represents a time period when a provider is unavailable for appointments.
+ *
+ * @typedef {Object} ServiceProviderTimeOff
+ * @property {string} providerId - Provider ID (ServicePerson ID)
+ * @property {string} type - Time-off type (recurring or specific)
+ * @property {number} startDate - Start date/time as Unix epoch seconds
+ * @property {number} endDate - End date/time as Unix epoch seconds
+ * @property {string} [reason] - Optional reason for time off
+ * @property {string} status - Approval status
+ * @property {Object} [recurrence] - Recurrence rule for recurring time off
+ */
+exports.ServiceProviderTimeOffSchema = base_schema_1.BaseModelSchema.safeExtend({
+    providerId: zod_1.default.string().describe("Provider ID (ServicePerson ID)"),
+    type: zod_1.default.enum(type_definitions_1.ServiceProviderTimeOffType).describe("Time-off type (recurring or specific)"),
+    startDate: zod_1.default.number().int().positive().describe("Start date/time as Unix epoch seconds"),
+    endDate: zod_1.default.number().int().positive().describe("End date/time as Unix epoch seconds"),
+    reason: zod_1.default.string().nullable().optional().describe("Optional reason for time off"),
+    status: zod_1.default.enum(type_definitions_1.ServiceProviderTimeOffStatus).default(type_definitions_1.ServiceProviderTimeOffStatus.PENDING).describe("Approval status"),
+    recurrence: exports.ServiceProviderTimeOffRecurrenceSchema.nullable().optional().describe("Recurrence rule for recurring time off"),
+}).superRefine((data, ctx) => {
+    if (data.endDate < data.startDate) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["endDate"],
+            message: "endDate must be greater than or equal to startDate",
+        });
+    }
+    if (data.type === type_definitions_1.ServiceProviderTimeOffType.RECURRING && !data.recurrence) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["recurrence"],
+            message: "recurrence is required when type is recurring",
+        });
+    }
+    if (data.type === type_definitions_1.ServiceProviderTimeOffType.SPECIFIC && data.recurrence) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["recurrence"],
+            message: "recurrence must be empty for specific time off",
+        });
+    }
+});
+// ============================================================================
+// CREATE/UPDATE SCHEMAS
+// ============================================================================
+/**
+ * Schema for creating a new service provider time off record.
+ * Omits auto-generated fields.
+ */
+exports.CreateServiceProviderTimeOffSchema = exports.ServiceProviderTimeOffSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+});
+/**
+ * Schema for updating an existing service provider time off record.
+ * All fields optional except id (required).
+ */
+exports.UpdateServiceProviderTimeOffSchema = exports.CreateServiceProviderTimeOffSchema.partial().safeExtend({
+    id: zod_1.default.string().describe("Unique identifier of the ServiceProviderTimeOff to update"),
+});

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

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+/**
+ * @fileoverview Service person schema definitions for managing service providers.
+ * @module business-mgt/service-person
+ */
+/**
+ * Service person schema - Complete service person record.
+ *
+ * @typedef {Object} ServicePerson
+ * @property {string} accountId - User account ID of the service person
+ * @property {string} [description] - Description of the service person
+ * @property {string} serviceId - ID of the service this person provides
+ */
+export declare const ServicePersonSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    accountId: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    serviceId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new service person.
+ * Omits auto-generated fields.
+ */
+export declare const CreateServicePersonSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    serviceId: z.ZodString;
+    accountId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing service person.
+ * All fields are optional except id.
+ */
+export declare const UpdateServicePersonSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    serviceId: z.ZodOptional<z.ZodString>;
+    accountId: z.ZodOptional<z.ZodString>;
+    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>;

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

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateServicePersonSchema = exports.CreateServicePersonSchema = exports.ServicePersonSchema = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("../base.schema");
+/**
+ * @fileoverview Service person schema definitions for managing service providers.
+ * @module business-mgt/service-person
+ */
+/**
+ * Service person schema - Complete service person record.
+ *
+ * @typedef {Object} ServicePerson
+ * @property {string} accountId - User account ID of the service person
+ * @property {string} [description] - Description of the service person
+ * @property {string} serviceId - ID of the service this person provides
+ */
+exports.ServicePersonSchema = base_schema_1.BaseModelSchema.safeExtend({
+    accountId: zod_1.z.string().describe("User account ID linking this service provider to platform identity management for authentication, scheduling access, and availability management."),
+    description: zod_1.z.string().optional().describe("Professional bio displayed to customers during booking: qualifications, specializations, experience, languages spoken. Helps customers make informed provider selection."),
+    serviceId: zod_1.z.string().describe("References Business Service from service-config.schema that this person provides. Multiple persons can offer same service, enabling parallel scheduling and staff load distribution."),
+});
+/**
+ * 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 are optional except id.
+ */
+exports.UpdateServicePersonSchema = exports.CreateServicePersonSchema.partial().safeExtend({
+    id: zod_1.z.string(),
+});

package/dist/core/business-mgt/tax-rule.schema.d.ts

@@ -0,0 +1,161 @@
+import { z } from "zod";
+import { TaxCatalogScope, TaxRateType, TaxScope } from "../type-definitions";
+/**
+ * @fileoverview Tax rule schema definitions for order pricing.
+ * @module business-mgt/tax-rule
+ */
+/**
+ * Tax rule schema.
+ * Defines tax configurations for orders including percentage and fixed amount taxes.
+ *
+ * @typedef {Object} TaxRule
+ * @property {string} [locationId] - Business location where this tax applies
+ * @property {string} name - Tax display name
+ * @property {TaxScope} scope - Tax scope (order, item, category)
+ * @property {TaxRateType} rateType - Tax rate type (percentage, fixed)
+ * @property {number} rateValue - Tax rate value
+ * @property {string} currency - Currency code for fixed taxes
+ * @property {TaxCatalogScope} catalogScope - Catalog scope for item-level taxes
+ * @property {string} [externalTaxId] - External system tax ID
+ * @property {boolean} isInclusive - Whether tax is included in prices
+ * @property {number} priority - Priority for tax application order
+ * @property {boolean} isCompound - Whether tax compounds on other taxes
+ * @property {number} [effectiveFrom] - Start timestamp for tax validity
+ * @property {number} [effectiveTo] - End timestamp for tax validity
+ * @property {boolean} isActive - Whether tax is currently active
+ */
+export declare const TaxRuleSchema: 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;
+    scope: z.ZodDefault<z.ZodEnum<typeof TaxScope>>;
+    rateType: z.ZodDefault<z.ZodEnum<typeof TaxRateType>>;
+    rateValue: z.ZodNumber;
+    currency: z.ZodDefault<z.ZodString>;
+    catalogScope: z.ZodDefault<z.ZodEnum<typeof TaxCatalogScope>>;
+    externalTaxId: z.ZodOptional<z.ZodString>;
+    isInclusive: z.ZodDefault<z.ZodBoolean>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    isCompound: z.ZodDefault<z.ZodBoolean>;
+    effectiveFrom: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    effectiveTo: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new tax rule.
+ * Omits auto-generated fields.
+ */
+export declare const CreateTaxRuleSchema: z.ZodObject<{
+    name: z.ZodString;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    currency: z.ZodDefault<z.ZodString>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    scope: z.ZodDefault<z.ZodEnum<typeof TaxScope>>;
+    catalogScope: z.ZodDefault<z.ZodEnum<typeof TaxCatalogScope>>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    effectiveFrom: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    effectiveTo: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    externalTaxId: z.ZodOptional<z.ZodString>;
+    rateType: z.ZodDefault<z.ZodEnum<typeof TaxRateType>>;
+    rateValue: z.ZodNumber;
+    isInclusive: z.ZodDefault<z.ZodBoolean>;
+    isCompound: z.ZodDefault<z.ZodBoolean>;
+    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 tax rule.
+ * All fields optional except id.
+ */
+export declare const UpdateTaxRuleSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    currency: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    locationId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    scope: z.ZodOptional<z.ZodDefault<z.ZodEnum<typeof TaxScope>>>;
+    catalogScope: z.ZodOptional<z.ZodDefault<z.ZodEnum<typeof TaxCatalogScope>>>;
+    priority: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    effectiveFrom: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    effectiveTo: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    externalTaxId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    rateType: z.ZodOptional<z.ZodDefault<z.ZodEnum<typeof TaxRateType>>>;
+    rateValue: z.ZodOptional<z.ZodNumber>;
+    isInclusive: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    isCompound: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    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 TaxRule = z.infer<typeof TaxRuleSchema>;
+export type CreateTaxRule = z.infer<typeof CreateTaxRuleSchema>;
+export type UpdateTaxRule = z.infer<typeof UpdateTaxRuleSchema>;
+/**
+ * Tax rule filter options.
+ * @interface TaxRuleFilters
+ */
+export interface TaxRuleFilters {
+    /** Text search across tax name */
+    search?: string;
+    /** Filter by business location ID */
+    locationId?: string;
+    /** Filter by tax scope */
+    scope?: TaxScope;
+    /** Filter by tax rate type */
+    rateType?: TaxRateType;
+    /** Filter by catalog scope */
+    catalogScope?: TaxCatalogScope;
+    /** Filter by inclusive status */
+    isInclusive?: boolean;
+    /** Filter by active status */
+    isActive?: boolean;
+}
+/**
+ * Tax rule sorting options.
+ * @interface TaxRuleSorting
+ */
+export interface TaxRuleSorting {
+    /** Field to sort by */
+    field: "name" | "priority" | "rateValue" | "createdAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Tax rule query options.
+ * @interface TaxRuleQueryOptions
+ */
+export interface TaxRuleQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: TaxRuleFilters;
+    /** Optional sorting */
+    sorting?: TaxRuleSorting;
+}