wiil-core-js 0.0.82

package/dist/core/business-mgt/reservation-mgt/resource/reservation-resource-category.schema.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateResourceCategorySchema = exports.CreateResourceCategorySchema = exports.ResourceCategorySchema = exports.ResourceCategoryChannelMappingSchema = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("../../../base.schema");
+const display_order_1 = require("../../../type-definitions/display-order");
+const type_definitions_1 = require("../../../type-definitions");
+/**
+ * @fileoverview Reservation resource category schema definitions.
+ * @module business-mgt/reservation-mgt/resource-category
+ */
+// ============================================================================
+// CHANNEL MAPPING SCHEMAS
+// ============================================================================
+/**
+ * Resource category channel mapping schema.
+ * Maps reservation resource categories to external platform category IDs.
+ *
+ * @typedef {Object} ResourceCategoryChannelMapping
+ * @property {string} channelId - Channel identifier
+ * @property {string} externalCategoryId - External category ID
+ */
+exports.ResourceCategoryChannelMappingSchema = zod_1.z.object({
+    channelId: zod_1.z.string().describe("Channel ID (e.g., opentable, booking-com, resy)"),
+    externalCategoryId: zod_1.z.string().describe("External category ID for this specific channel"),
+}).describe("Per-channel external resource category ID mapping");
+// ============================================================================
+// RESOURCE CATEGORY SCHEMA
+// ============================================================================
+/**
+ * Resource category schema.
+ * Groups reservation resources by type, location, channel mapping, and display order.
+ *
+ * @typedef {Object} ResourceCategory
+ * @property {string} [resourceRevisionId] - Version control for resource category changes
+ * @property {string} [locationId] - Business location where the category applies
+ * @property {string} name - Category display name
+ * @property {string} [description] - Category description
+ * @property {ResourceCategoryChannelMapping[]} [channelMappings] - Per-channel category mappings
+ * @property {ResourceType} [resourceType] - Optional resource type scope
+ * @property {number} [displayOrder] - Display order in category lists
+ * @property {boolean} isActive - Whether the category is active
+ * @property {Object} [metadata] - Additional category metadata
+ */
+exports.ResourceCategorySchema = base_schema_1.BaseModelSchema.safeExtend({
+    resourceRevisionId: zod_1.z.string().nullable().optional().describe("Optional resource revision ID for version-scoped data"),
+    locationId: zod_1.z.string().nullable().optional().describe("Business location ID where this resource category applies. Null applies across locations."),
+    name: zod_1.z.string().min(1, "Category name is required").describe("Display name for the reservation resource category."),
+    description: zod_1.z.string().nullable().optional().describe("Customer or staff-facing description of this resource category."),
+    channelMappings: zod_1.z.array(exports.ResourceCategoryChannelMappingSchema).nullable().optional().describe("Per-channel resource category ID mappings"),
+    resourceType: zod_1.z.enum(type_definitions_1.ResourceType).nullable().optional().describe("Optional resource type scope for this category."),
+    displayOrder: zod_1.z.number().int().nullable().optional().describe("Numeric display order for category lists. Lower numbers appear first."),
+    isActive: zod_1.z.boolean().default(true).describe("Whether this resource category is active and available for assignment."),
+    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).nullable().optional().describe("Additional structured metadata for resource category integrations."),
+});
+// ============================================================================
+// CREATE/UPDATE SCHEMAS
+// ============================================================================
+/**
+ * Schema for creating a new resource category.
+ * Omits auto-generated fields.
+ */
+exports.CreateResourceCategorySchema = exports.ResourceCategorySchema.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 resource category.
+ * All fields optional except id.
+ */
+exports.UpdateResourceCategorySchema = exports.CreateResourceCategorySchema.partial().safeExtend({
+    id: zod_1.z.string().describe("Unique identifier of the resource category to update."),
+});

package/dist/core/business-mgt/reservation-mgt/resource/reservation-resource-instance.schema.d.ts

@@ -0,0 +1,137 @@
+import { z } from "zod";
+/**
+ * @fileoverview Reservation resource instance schema definitions.
+ * @module business-mgt/reservation-mgt/resource-instance
+ */
+/**
+ * Operational status of a physical resource instance.
+ *
+ * @enum {string}
+ */
+export declare enum ResourceInstanceStatus {
+    AVAILABLE = "available",
+    RESERVED = "reserved",
+    OCCUPIED = "occupied",
+    MAINTENANCE = "maintenance",
+    CLEANING = "cleaning",
+    OUT_OF_SERVICE = "out_of_service"
+}
+/**
+ * Resource instance attribute schema.
+ * Stores flexible key/value attributes on physical reservation inventory.
+ *
+ * @typedef {Object} ResourceInstanceAttribute
+ * @property {string} key - Attribute key
+ * @property {string} value - Attribute value
+ */
+export declare const ResourceInstanceAttributeSchema: z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Resource instance schema.
+ * Represents a physical table, room, rental unit, or other reservable unit.
+ *
+ * @typedef {Object} ResourceInstance
+ * @property {string} [resourceRevisionId] - Version control for resource instance changes
+ * @property {string} [locationId] - Business location where the instance is located
+ * @property {string} resourceId - Parent resource ID
+ * @property {string} [name] - Instance display name
+ * @property {string} [code] - Instance code or number
+ * @property {ResourceInstanceStatus} status - Current operational status
+ * @property {boolean} isAvailable - Whether the instance can be assigned
+ * @property {ResourceInstanceAttribute[]} [attributes] - Instance-level attributes
+ */
+export declare const ResourceInstanceSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    resourceRevisionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    resourceId: z.ZodString;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    code: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodDefault<z.ZodEnum<typeof ResourceInstanceStatus>>;
+    isAvailable: z.ZodDefault<z.ZodBoolean>;
+    attributes: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new resource instance.
+ * Omits auto-generated fields.
+ */
+export declare const CreateResourceInstanceSchema: z.ZodObject<{
+    code: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodDefault<z.ZodEnum<typeof ResourceInstanceStatus>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isAvailable: z.ZodDefault<z.ZodBoolean>;
+    attributes: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>>>;
+    resourceId: z.ZodString;
+    resourceRevisionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing resource instance.
+ * All fields optional except id.
+ */
+export declare const UpdateResourceInstanceSchema: z.ZodObject<{
+    code: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    name: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    locationId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    isAvailable: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    attributes: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>>>>;
+    resourceId: z.ZodOptional<z.ZodString>;
+    resourceRevisionId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    id: z.ZodString;
+    status: z.ZodOptional<z.ZodEnum<typeof ResourceInstanceStatus>>;
+}, z.core.$strip>;
+export type ResourceInstanceAttribute = z.infer<typeof ResourceInstanceAttributeSchema>;
+export type ResourceInstance = z.infer<typeof ResourceInstanceSchema>;
+export type CreateResourceInstance = z.infer<typeof CreateResourceInstanceSchema>;
+export type UpdateResourceInstance = z.infer<typeof UpdateResourceInstanceSchema>;
+/**
+ * Resource instance filter options.
+ * @interface ResourceInstanceFilters
+ */
+export interface ResourceInstanceFilters {
+    /** Filter by parent resource ID */
+    resourceId?: string;
+    /** Filter by business location ID */
+    locationId?: string;
+    /** Filter by operational statuses */
+    status?: ResourceInstanceStatus[];
+    /** Filter by assignment availability */
+    isAvailable?: boolean;
+}
+/**
+ * Resource instance sorting options.
+ * @interface ResourceInstanceSorting
+ */
+export interface ResourceInstanceSorting {
+    /** Field to sort by */
+    field: "name" | "status" | "createdAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Resource instance query options.
+ * @interface ResourceInstanceQueryOptions
+ */
+export interface ResourceInstanceQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: ResourceInstanceFilters;
+    /** Optional sorting */
+    sorting?: ResourceInstanceSorting;
+}

package/dist/core/business-mgt/reservation-mgt/resource/reservation-resource-instance.schema.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateResourceInstanceSchema = exports.CreateResourceInstanceSchema = exports.ResourceInstanceSchema = exports.ResourceInstanceAttributeSchema = exports.ResourceInstanceStatus = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("../../../base.schema");
+/**
+ * @fileoverview Reservation resource instance schema definitions.
+ * @module business-mgt/reservation-mgt/resource-instance
+ */
+// ============================================================================
+// ENUMS
+// ============================================================================
+/**
+ * Operational status of a physical resource instance.
+ *
+ * @enum {string}
+ */
+var ResourceInstanceStatus;
+(function (ResourceInstanceStatus) {
+    ResourceInstanceStatus["AVAILABLE"] = "available";
+    ResourceInstanceStatus["RESERVED"] = "reserved";
+    ResourceInstanceStatus["OCCUPIED"] = "occupied";
+    ResourceInstanceStatus["MAINTENANCE"] = "maintenance";
+    ResourceInstanceStatus["CLEANING"] = "cleaning";
+    ResourceInstanceStatus["OUT_OF_SERVICE"] = "out_of_service";
+})(ResourceInstanceStatus || (exports.ResourceInstanceStatus = ResourceInstanceStatus = {}));
+// ============================================================================
+// RESOURCE INSTANCE SCHEMAS
+// ============================================================================
+/**
+ * Resource instance attribute schema.
+ * Stores flexible key/value attributes on physical reservation inventory.
+ *
+ * @typedef {Object} ResourceInstanceAttribute
+ * @property {string} key - Attribute key
+ * @property {string} value - Attribute value
+ */
+exports.ResourceInstanceAttributeSchema = zod_1.z.object({
+    key: zod_1.z.string().describe("Attribute key used by operations or integrations."),
+    value: zod_1.z.string().describe("Attribute value for the instance-specific key."),
+});
+/**
+ * Resource instance schema.
+ * Represents a physical table, room, rental unit, or other reservable unit.
+ *
+ * @typedef {Object} ResourceInstance
+ * @property {string} [resourceRevisionId] - Version control for resource instance changes
+ * @property {string} [locationId] - Business location where the instance is located
+ * @property {string} resourceId - Parent resource ID
+ * @property {string} [name] - Instance display name
+ * @property {string} [code] - Instance code or number
+ * @property {ResourceInstanceStatus} status - Current operational status
+ * @property {boolean} isAvailable - Whether the instance can be assigned
+ * @property {ResourceInstanceAttribute[]} [attributes] - Instance-level attributes
+ */
+exports.ResourceInstanceSchema = base_schema_1.BaseModelSchema.safeExtend({
+    resourceRevisionId: zod_1.z.string().nullable().optional().describe("Optional resource revision ID for version-scoped data"),
+    locationId: zod_1.z.string().nullable().optional().describe("Business location ID where this resource instance is located. Null applies when the instance is not location-specific."),
+    resourceId: zod_1.z.string().describe("Parent resource ID that defines this physical instance."),
+    name: zod_1.z.string().nullable().optional().describe("Instance name/label"),
+    code: zod_1.z.string().nullable().optional().describe("Optional instance code/number"),
+    status: zod_1.z.enum(ResourceInstanceStatus).default(ResourceInstanceStatus.AVAILABLE).describe("Current operational status"),
+    isAvailable: zod_1.z.boolean().default(true).describe("Quick availability toggle for assignment"),
+    attributes: zod_1.z.array(exports.ResourceInstanceAttributeSchema).nullable().optional().describe("Instance-level attributes"),
+}).superRefine((data, ctx) => {
+    if (data.status !== ResourceInstanceStatus.AVAILABLE && data.isAvailable) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["isAvailable"],
+            message: "isAvailable should be false when status is not available",
+        });
+    }
+});
+// ============================================================================
+// CREATE/UPDATE SCHEMAS
+// ============================================================================
+/**
+ * Schema for creating a new resource instance.
+ * Omits auto-generated fields.
+ */
+exports.CreateResourceInstanceSchema = exports.ResourceInstanceSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+});
+/**
+ * Schema for updating an existing resource instance.
+ * All fields optional except id.
+ */
+exports.UpdateResourceInstanceSchema = exports.CreateResourceInstanceSchema.partial().safeExtend({
+    id: zod_1.z.string().describe("Unique identifier of the resource instance to update."),
+    // Re-declared without the base `.default()` so partial updates don't inject a status the caller never set
+    status: zod_1.z.enum(ResourceInstanceStatus).optional().describe("Current operational status"),
+});