@azlib/cms 0.4.0 → 0.5.0

package/dist/index.cjs

@@ -2857,7 +2857,7 @@ var EcommerceService = class {
 };
 //#endregion
 //#region src/plugins/ecommerce/routes.ts
-function json(data, status = 200) {
+function json$1(data, status = 200) {
 	return new Response(JSON.stringify(data), {
 		status,
 		headers: {
@@ -2866,11 +2866,11 @@ function json(data, status = 200) {
 		}
 	});
 }
-function badRequest(message) {
-	return json({ error: message }, 400);
+function badRequest$1(message) {
+	return json$1({ error: message }, 400);
 }
-function notFound(message) {
-	return json({ error: message }, 404);
+function notFound$1(message) {
+	return json$1({ error: message }, 404);
 }
 function registerEcommerceRoutes(ctx, service, options = {}) {
 	const prefix = (options.apiPrefix ?? "/api/ecommerce").replace(/\/+$/, "");
@@ -2893,7 +2893,7 @@ function registerEcommerceRoutes(ctx, service, options = {}) {
 			const offsetStr = url.searchParams.get("offset");
 			const limit = limitStr ? parseInt(limitStr, 10) : 20;
 			const offset = offsetStr ? parseInt(offsetStr, 10) : 0;
-			return json(await service.listProducts({
+			return json$1(await service.listProducts({
 				categorySlug,
 				categoryId,
 				tagSlug,
@@ -2909,7 +2909,7 @@ function registerEcommerceRoutes(ctx, service, options = {}) {
 				offset
 			}));
 		} catch (err) {
-			return badRequest(err instanceof Error ? err.message : String(err));
+			return badRequest$1(err instanceof Error ? err.message : String(err));
 		}
 	});
 	ctx.registerRoute("GET", `${prefix}/products/:id`, async (_req, { params, url }) => {
@@ -2921,32 +2921,32 @@ function registerEcommerceRoutes(ctx, service, options = {}) {
 			product = await service.getProduct(id);
 			if (!product) product = await service.getProductBySlug(id);
 		}
-		if (!product) return notFound(`Product '${id}' not found`);
-		return json(product);
+		if (!product) return notFound$1(`Product '${id}' not found`);
+		return json$1(product);
 	});
 	ctx.registerRoute("POST", `${prefix}/products`, async (req) => {
 		try {
 			const body = await req.json();
-			if (!body.title) return badRequest("Product 'title' is required.");
-			if (body.price === void 0 || body.price < 0) return badRequest("Valid product 'price' is required.");
-			return json(await service.createProduct(body), 201);
+			if (!body.title) return badRequest$1("Product 'title' is required.");
+			if (body.price === void 0 || body.price < 0) return badRequest$1("Valid product 'price' is required.");
+			return json$1(await service.createProduct(body), 201);
 		} catch (err) {
-			return badRequest(err instanceof Error ? err.message : String(err));
+			return badRequest$1(err instanceof Error ? err.message : String(err));
 		}
 	});
 	ctx.registerRoute("PUT", `${prefix}/products/:id`, async (req, { params }) => {
 		try {
 			const body = await req.json();
 			const updated = await service.updateProduct(params.id, body);
-			if (!updated) return notFound(`Product '${params.id}' not found.`);
-			return json(updated);
+			if (!updated) return notFound$1(`Product '${params.id}' not found.`);
+			return json$1(updated);
 		} catch (err) {
-			return badRequest(err instanceof Error ? err.message : String(err));
+			return badRequest$1(err instanceof Error ? err.message : String(err));
 		}
 	});
 	ctx.registerRoute("DELETE", `${prefix}/products/:id`, async (_req, { params }) => {
-		if (!await service.deleteProduct(params.id)) return notFound(`Product '${params.id}' not found.`);
-		return json({
+		if (!await service.deleteProduct(params.id)) return notFound$1(`Product '${params.id}' not found.`);
+		return json$1({
 			success: true,
 			id: params.id
 		});
@@ -2954,8 +2954,8 @@ function registerEcommerceRoutes(ctx, service, options = {}) {
 	ctx.registerRoute("POST", `${prefix}/products/:id/images`, async (req, { params }) => {
 		try {
 			const body = await req.json();
-			if (!body.filename || !body.mimeType) return badRequest("'filename' and 'mimeType' are required.");
-			return json(await service.uploadProductImage(params.id, {
+			if (!body.filename || !body.mimeType) return badRequest$1("'filename' and 'mimeType' are required.");
+			return json$1(await service.uploadProductImage(params.id, {
 				filename: body.filename,
 				mimeType: body.mimeType,
 				sizeBytes: body.sizeBytes ?? 0,
@@ -2967,68 +2967,68 @@ function registerEcommerceRoutes(ctx, service, options = {}) {
 				isFeatured: body.isFeatured
 			}), 201);
 		} catch (err) {
-			return badRequest(err instanceof Error ? err.message : String(err));
+			return badRequest$1(err instanceof Error ? err.message : String(err));
 		}
 	});
 	ctx.registerRoute("GET", `${prefix}/categories`, async (_req, { url }) => {
 		try {
-			if (url.searchParams.get("tree") === "true") return json(await service.getCategoryTree());
+			if (url.searchParams.get("tree") === "true") return json$1(await service.getCategoryTree());
 			const parentId = url.searchParams.get("parentId");
-			return json(await service.getCategories({ parentId: parentId === "null" ? null : parentId ?? void 0 }));
+			return json$1(await service.getCategories({ parentId: parentId === "null" ? null : parentId ?? void 0 }));
 		} catch (err) {
-			return badRequest(err instanceof Error ? err.message : String(err));
+			return badRequest$1(err instanceof Error ? err.message : String(err));
 		}
 	});
 	ctx.registerRoute("POST", `${prefix}/categories`, async (req) => {
 		try {
 			const body = await req.json();
-			if (!body.name) return badRequest("Category 'name' is required.");
-			return json(await service.createCategory(body), 201);
+			if (!body.name) return badRequest$1("Category 'name' is required.");
+			return json$1(await service.createCategory(body), 201);
 		} catch (err) {
-			return badRequest(err instanceof Error ? err.message : String(err));
+			return badRequest$1(err instanceof Error ? err.message : String(err));
 		}
 	});
 	if (options.enableDiscounts !== false) {
 		ctx.registerRoute("POST", `${prefix}/discounts`, async (req) => {
 			try {
 				const body = await req.json();
-				if (!body.title || !body.code) return badRequest("'title' and 'code' are required.");
-				if (body.value === void 0 || body.value < 0) return badRequest("Valid discount 'value' is required.");
-				return json(await service.createDiscount(body), 201);
+				if (!body.title || !body.code) return badRequest$1("'title' and 'code' are required.");
+				if (body.value === void 0 || body.value < 0) return badRequest$1("Valid discount 'value' is required.");
+				return json$1(await service.createDiscount(body), 201);
 			} catch (err) {
-				return badRequest(err instanceof Error ? err.message : String(err));
+				return badRequest$1(err instanceof Error ? err.message : String(err));
 			}
 		});
 		ctx.registerRoute("POST", `${prefix}/discounts/validate`, async (req) => {
 			try {
 				const body = await req.json();
-				if (!body.code) return badRequest("Discount 'code' is required.");
+				if (!body.code) return badRequest$1("Discount 'code' is required.");
 				const subtotal = Number(body.subtotal ?? 0);
 				const productIds = Array.isArray(body.productIds) ? body.productIds : [];
-				return json(await service.validateDiscount(body.code, subtotal, productIds));
+				return json$1(await service.validateDiscount(body.code, subtotal, productIds));
 			} catch (err) {
-				return badRequest(err instanceof Error ? err.message : String(err));
+				return badRequest$1(err instanceof Error ? err.message : String(err));
 			}
 		});
 	}
 	ctx.registerRoute("POST", `${prefix}/cart/calculate`, async (req) => {
 		try {
 			const body = await req.json();
-			if (!body.items || !Array.isArray(body.items) || body.items.length === 0) return badRequest("'items' array is required and must not be empty.");
-			return json(await service.calculateCart(body));
+			if (!body.items || !Array.isArray(body.items) || body.items.length === 0) return badRequest$1("'items' array is required and must not be empty.");
+			return json$1(await service.calculateCart(body));
 		} catch (err) {
-			return badRequest(err instanceof Error ? err.message : String(err));
+			return badRequest$1(err instanceof Error ? err.message : String(err));
 		}
 	});
 	if (options.enableOrders !== false) {
 		ctx.registerRoute("POST", `${prefix}/orders`, async (req) => {
 			try {
 				const body = await req.json();
-				if (!body.customerEmail) return badRequest("'customerEmail' is required.");
-				if (!body.items || !Array.isArray(body.items) || body.items.length === 0) return badRequest("'items' array is required.");
-				return json(await service.createOrder(body), 201);
+				if (!body.customerEmail) return badRequest$1("'customerEmail' is required.");
+				if (!body.items || !Array.isArray(body.items) || body.items.length === 0) return badRequest$1("'items' array is required.");
+				return json$1(await service.createOrder(body), 201);
 			} catch (err) {
-				return badRequest(err instanceof Error ? err.message : String(err));
+				return badRequest$1(err instanceof Error ? err.message : String(err));
 			}
 		});
 		ctx.registerRoute("GET", `${prefix}/orders/:id`, async (_req, { params, url }) => {
@@ -3040,18 +3040,18 @@ function registerEcommerceRoutes(ctx, service, options = {}) {
 				order = await service.getOrder(id);
 				if (!order) order = await service.getOrderByNumber(id);
 			}
-			if (!order) return notFound(`Order '${id}' not found.`);
-			return json(order);
+			if (!order) return notFound$1(`Order '${id}' not found.`);
+			return json$1(order);
 		});
 		ctx.registerRoute("PATCH", `${prefix}/orders/:id/status`, async (req, { params }) => {
 			try {
 				const body = await req.json();
-				if (!body.status) return badRequest("New 'status' is required.");
+				if (!body.status) return badRequest$1("New 'status' is required.");
 				const updated = await service.updateOrderStatus(params.id, body.status, body.note);
-				if (!updated) return notFound(`Order '${params.id}' not found.`);
-				return json(updated);
+				if (!updated) return notFound$1(`Order '${params.id}' not found.`);
+				return json$1(updated);
 			} catch (err) {
-				return badRequest(err instanceof Error ? err.message : String(err));
+				return badRequest$1(err instanceof Error ? err.message : String(err));
 			}
 		});
 	}
@@ -3235,6 +3235,1597 @@ function getEcommerceService(engine, options) {
 	return service;
 }
 //#endregion
+//#region src/plugins/hrms/schemas.ts
+/**
+* Creates the collection configuration for Employers (Organizations / Companies).
+*/
+function createEmployerCollection(options = {}) {
+	return collection({
+		slug: options.employerCollectionSlug ?? "employers",
+		label: "Employers",
+		singularLabel: "Employer",
+		description: "Companies and organizational entities managing employees, shifts, and leave policies",
+		timestamps: true,
+		revisions: true,
+		draftable: true,
+		defaultSort: {
+			field: "createdAt",
+			direction: "desc"
+		},
+		fields: [
+			fields.text({
+				name: "companyName",
+				label: "Company Name",
+				required: true
+			}),
+			fields.slug({
+				from: "companyName",
+				unique: true
+			}),
+			fields.text({
+				name: "legalName",
+				label: "Legal Entity Name"
+			}),
+			fields.text({
+				name: "taxId",
+				label: "Tax / EIN Number"
+			}),
+			fields.text({
+				name: "email",
+				label: "Primary Email"
+			}),
+			fields.text({
+				name: "phone",
+				label: "Phone Number"
+			}),
+			fields.text({
+				name: "website",
+				label: "Website URL"
+			}),
+			fields.image({
+				name: "logo",
+				label: "Company Logo"
+			}),
+			fields.json({
+				name: "address",
+				label: "Company Address"
+			}),
+			fields.text({
+				name: "timezone",
+				label: "Primary Timezone",
+				defaultValue: "UTC"
+			}),
+			fields.json({
+				name: "workSchedule",
+				label: "Standard Work Schedule",
+				defaultValue: {
+					startTime: options.workScheduleStart ?? "09:00",
+					endTime: options.workScheduleEnd ?? "17:00",
+					standardHoursPerDay: options.standardWorkDayHours ?? 8,
+					gracePeriodMinutes: options.gracePeriodMinutes ?? 15,
+					workDays: [
+						1,
+						2,
+						3,
+						4,
+						5
+					]
+				}
+			}),
+			fields.select({
+				name: "status",
+				label: "Status",
+				options: ["active", "inactive"],
+				defaultValue: "active"
+			})
+		]
+	});
+}
+/**
+* Creates the collection configuration for Employees.
+*/
+function createEmployeeCollection(options = {}) {
+	const slug = options.employeeCollectionSlug ?? "employees";
+	const employerSlug = options.employerCollectionSlug ?? "employers";
+	return collection({
+		slug,
+		label: "Employees",
+		singularLabel: "Employee",
+		description: "Employee profiles, job assignments, emergency contacts, and attached records",
+		timestamps: true,
+		revisions: true,
+		draftable: true,
+		taxonomies: [options.departmentsTaxonomySlug ?? "hrms_departments", options.designationsTaxonomySlug ?? "hrms_designations"],
+		defaultSort: {
+			field: "createdAt",
+			direction: "desc"
+		},
+		fields: [
+			fields.relationship({
+				name: "employerId",
+				label: "Employer",
+				targetCollection: employerSlug,
+				required: true
+			}),
+			fields.text({
+				name: "userId",
+				label: "Associated User ID",
+				description: "Optional reference to an authenticated user account"
+			}),
+			fields.text({
+				name: "employeeNumber",
+				label: "Employee Number",
+				required: true,
+				unique: true
+			}),
+			fields.text({
+				name: "firstName",
+				label: "First Name",
+				required: true
+			}),
+			fields.text({
+				name: "lastName",
+				label: "Last Name",
+				required: true
+			}),
+			fields.text({
+				name: "email",
+				label: "Work Email",
+				required: true
+			}),
+			fields.text({
+				name: "phone",
+				label: "Contact Phone"
+			}),
+			fields.image({
+				name: "avatar",
+				label: "Profile Picture"
+			}),
+			fields.text({
+				name: "jobTitle",
+				label: "Job Title"
+			}),
+			fields.select({
+				name: "employmentType",
+				label: "Employment Type",
+				options: [
+					"full_time",
+					"part_time",
+					"contractor",
+					"intern"
+				],
+				defaultValue: "full_time"
+			}),
+			fields.select({
+				name: "status",
+				label: "Status",
+				options: [
+					"active",
+					"on_leave",
+					"terminated",
+					"suspended"
+				],
+				defaultValue: "active"
+			}),
+			fields.date({
+				name: "hireDate",
+				label: "Hire Date",
+				required: true
+			}),
+			fields.date({
+				name: "terminationDate",
+				label: "Termination Date"
+			}),
+			fields.relationship({
+				name: "managerId",
+				label: "Reporting Manager",
+				targetCollection: slug
+			}),
+			fields.json({
+				name: "emergencyContact",
+				label: "Emergency Contact"
+			}),
+			fields.repeater({
+				name: "documents",
+				label: "Attached Documents & Contracts",
+				fields: [
+					fields.text({
+						name: "title",
+						label: "Document Title",
+						required: true
+					}),
+					fields.text({
+						name: "fileUrl",
+						label: "File URL",
+						required: true
+					}),
+					fields.text({
+						name: "category",
+						label: "Category"
+					}),
+					fields.text({
+						name: "uploadedAt",
+						label: "Uploaded Date"
+					})
+				]
+			}),
+			fields.number({
+				name: "salary",
+				label: "Base Salary"
+			}),
+			fields.text({
+				name: "notes",
+				label: "Internal Notes"
+			})
+		]
+	});
+}
+/**
+* Creates the collection configuration for Daily Attendance.
+*/
+function createAttendanceCollection(options = {}) {
+	const slug = options.attendanceCollectionSlug ?? "attendance";
+	const employerSlug = options.employerCollectionSlug ?? "employers";
+	const employeeSlug = options.employeeCollectionSlug ?? "employees";
+	return collection({
+		slug,
+		label: "Attendance",
+		singularLabel: "Attendance Record",
+		description: "Daily check-in and check-out logs, hours worked, overtime, and punctuality status",
+		timestamps: true,
+		revisions: false,
+		draftable: false,
+		defaultSort: {
+			field: "date",
+			direction: "desc"
+		},
+		fields: [
+			fields.relationship({
+				name: "employerId",
+				label: "Employer",
+				targetCollection: employerSlug,
+				required: true
+			}),
+			fields.relationship({
+				name: "employeeId",
+				label: "Employee",
+				targetCollection: employeeSlug,
+				required: true
+			}),
+			fields.date({
+				name: "date",
+				label: "Date",
+				required: true
+			}),
+			fields.text({
+				name: "checkInAt",
+				label: "Check-In Timestamp",
+				required: true
+			}),
+			fields.text({
+				name: "checkOutAt",
+				label: "Check-Out Timestamp"
+			}),
+			fields.number({
+				name: "totalHours",
+				label: "Total Hours",
+				defaultValue: 0
+			}),
+			fields.number({
+				name: "overtimeHours",
+				label: "Overtime Hours",
+				defaultValue: 0
+			}),
+			fields.select({
+				name: "status",
+				label: "Status",
+				options: [
+					"present",
+					"late",
+					"half_day",
+					"absent",
+					"on_leave"
+				],
+				defaultValue: "present"
+			}),
+			fields.text({
+				name: "location",
+				label: "Location / IP / Geofence"
+			}),
+			fields.text({
+				name: "notes",
+				label: "Notes"
+			})
+		]
+	});
+}
+/**
+* Creates the collection configuration for Leave Types.
+*/
+function createLeaveTypeCollection(options = {}) {
+	const slug = options.leaveTypeCollectionSlug ?? "leave_types";
+	const employerSlug = options.employerCollectionSlug ?? "employers";
+	return collection({
+		slug,
+		label: "Leave Types",
+		singularLabel: "Leave Type",
+		description: "Available leave categories (Annual, Sick, Unpaid) and yearly quotas",
+		timestamps: true,
+		revisions: true,
+		draftable: false,
+		fields: [
+			fields.relationship({
+				name: "employerId",
+				label: "Employer",
+				targetCollection: employerSlug
+			}),
+			fields.text({
+				name: "name",
+				label: "Leave Name",
+				required: true
+			}),
+			fields.text({
+				name: "code",
+				label: "Leave Code",
+				required: true
+			}),
+			fields.number({
+				name: "daysAllowedPerYear",
+				label: "Days Allowed Per Year",
+				required: true,
+				defaultValue: 15,
+				min: 0
+			}),
+			fields.boolean({
+				name: "paid",
+				label: "Paid Leave",
+				defaultValue: true
+			}),
+			fields.boolean({
+				name: "requiresApproval",
+				label: "Requires Manager Approval",
+				defaultValue: true
+			}),
+			fields.text({
+				name: "color",
+				label: "Display Color Code"
+			}),
+			fields.text({
+				name: "description",
+				label: "Description / Policy"
+			})
+		]
+	});
+}
+/**
+* Creates the collection configuration for Leave Requests.
+*/
+function createLeaveRequestCollection(options = {}) {
+	const slug = options.leaveRequestCollectionSlug ?? "leave_requests";
+	const employerSlug = options.employerCollectionSlug ?? "employers";
+	const employeeSlug = options.employeeCollectionSlug ?? "employees";
+	const leaveTypeSlug = options.leaveTypeCollectionSlug ?? "leave_types";
+	return collection({
+		slug,
+		label: "Leave Requests",
+		singularLabel: "Leave Request",
+		description: "Employee time-off requests, approval tracking, and deducted balances",
+		timestamps: true,
+		revisions: true,
+		draftable: false,
+		defaultSort: {
+			field: "createdAt",
+			direction: "desc"
+		},
+		fields: [
+			fields.relationship({
+				name: "employerId",
+				label: "Employer",
+				targetCollection: employerSlug,
+				required: true
+			}),
+			fields.relationship({
+				name: "employeeId",
+				label: "Employee",
+				targetCollection: employeeSlug,
+				required: true
+			}),
+			fields.relationship({
+				name: "leaveTypeId",
+				label: "Leave Type",
+				targetCollection: leaveTypeSlug,
+				required: true
+			}),
+			fields.date({
+				name: "startDate",
+				label: "Start Date",
+				required: true
+			}),
+			fields.date({
+				name: "endDate",
+				label: "End Date",
+				required: true
+			}),
+			fields.number({
+				name: "daysCount",
+				label: "Days Count",
+				required: true,
+				min: .5
+			}),
+			fields.text({
+				name: "reason",
+				label: "Reason"
+			}),
+			fields.select({
+				name: "status",
+				label: "Request Status",
+				options: [
+					"pending",
+					"approved",
+					"rejected",
+					"cancelled"
+				],
+				defaultValue: "pending"
+			}),
+			fields.relationship({
+				name: "approvedBy",
+				label: "Approved / Rejected By",
+				targetCollection: employeeSlug
+			}),
+			fields.text({
+				name: "approvedAt",
+				label: "Decision Timestamp"
+			}),
+			fields.text({
+				name: "rejectionReason",
+				label: "Rejection Reason"
+			})
+		]
+	});
+}
+/**
+* Creates the standard HRMS taxonomies: departments and designations.
+*/
+function createHRMSTaxonomies(options = {}) {
+	const employeeSlug = options.employeeCollectionSlug ?? "employees";
+	const deptSlug = options.departmentsTaxonomySlug ?? "hrms_departments";
+	const desigSlug = options.designationsTaxonomySlug ?? "hrms_designations";
+	return [{
+		slug: deptSlug,
+		label: "Departments",
+		singularLabel: "Department",
+		hierarchical: true,
+		postTypes: [employeeSlug],
+		description: "Hierarchical departmental tree (e.g. Engineering, Sales, HR)"
+	}, {
+		slug: desigSlug,
+		label: "Designations",
+		singularLabel: "Designation",
+		hierarchical: false,
+		postTypes: [employeeSlug],
+		description: "Job titles and designations across the workforce"
+	}];
+}
+//#endregion
+//#region src/plugins/hrms/service.ts
+var HRMSService = class {
+	engine;
+	options;
+	employerSlug;
+	employeeSlug;
+	attendanceSlug;
+	leaveTypeSlug;
+	leaveRequestSlug;
+	departmentsTaxonomy;
+	designationsTaxonomy;
+	standardWorkDayHours;
+	workScheduleStart;
+	workScheduleEnd;
+	gracePeriodMinutes;
+	constructor(engine, options = {}) {
+		this.engine = engine;
+		this.options = options;
+		this.employerSlug = options.employerCollectionSlug ?? "employers";
+		this.employeeSlug = options.employeeCollectionSlug ?? "employees";
+		this.attendanceSlug = options.attendanceCollectionSlug ?? "attendance";
+		this.leaveTypeSlug = options.leaveTypeCollectionSlug ?? "leave_types";
+		this.leaveRequestSlug = options.leaveRequestCollectionSlug ?? "leave_requests";
+		this.departmentsTaxonomy = options.departmentsTaxonomySlug ?? "hrms_departments";
+		this.designationsTaxonomy = options.designationsTaxonomySlug ?? "hrms_designations";
+		this.standardWorkDayHours = options.standardWorkDayHours ?? 8;
+		this.workScheduleStart = options.workScheduleStart ?? "09:00";
+		this.workScheduleEnd = options.workScheduleEnd ?? "17:00";
+		this.gracePeriodMinutes = options.gracePeriodMinutes ?? 15;
+	}
+	get employersCollection() {
+		return this.engine.collection(this.employerSlug);
+	}
+	get employeesCollection() {
+		return this.engine.collection(this.employeeSlug);
+	}
+	get attendanceCollection() {
+		return this.engine.collection(this.attendanceSlug);
+	}
+	get leaveTypesCollection() {
+		return this.engine.collection(this.leaveTypeSlug);
+	}
+	get leaveRequestsCollection() {
+		return this.engine.collection(this.leaveRequestSlug);
+	}
+	async createEmployer(input, authorId) {
+		const employerData = {
+			companyName: input.companyName,
+			legalName: input.legalName,
+			taxId: input.taxId,
+			email: input.email,
+			phone: input.phone,
+			website: input.website,
+			logo: input.logo,
+			address: input.address,
+			timezone: input.timezone ?? "UTC",
+			workSchedule: input.workSchedule ?? {
+				startTime: this.workScheduleStart,
+				endTime: this.workScheduleEnd,
+				standardHoursPerDay: this.standardWorkDayHours,
+				gracePeriodMinutes: this.gracePeriodMinutes,
+				workDays: [
+					1,
+					2,
+					3,
+					4,
+					5
+				]
+			},
+			status: input.status ?? "active"
+		};
+		const employer = await this.employersCollection.create({
+			title: input.companyName,
+			status: input.status === "inactive" ? "draft" : "published",
+			data: employerData
+		}, authorId);
+		await this.engine.hooks.doAction("hrms.employer_created", employer);
+		return employer;
+	}
+	async getEmployer(id) {
+		return this.employersCollection.findById(id);
+	}
+	async getEmployerBySlug(slug) {
+		return this.employersCollection.findBySlug(slug);
+	}
+	async updateEmployer(id, input, authorId) {
+		const existing = await this.getEmployer(id);
+		if (!existing) return null;
+		const updatedData = {
+			...existing.data,
+			...input.companyName !== void 0 ? { companyName: input.companyName } : {},
+			...input.legalName !== void 0 ? { legalName: input.legalName } : {},
+			...input.taxId !== void 0 ? { taxId: input.taxId } : {},
+			...input.email !== void 0 ? { email: input.email } : {},
+			...input.phone !== void 0 ? { phone: input.phone } : {},
+			...input.website !== void 0 ? { website: input.website } : {},
+			...input.logo !== void 0 ? { logo: input.logo } : {},
+			...input.address !== void 0 ? { address: input.address } : {},
+			...input.timezone !== void 0 ? { timezone: input.timezone } : {},
+			...input.workSchedule !== void 0 ? { workSchedule: input.workSchedule } : {},
+			...input.status !== void 0 ? { status: input.status } : {}
+		};
+		const updated = await this.employersCollection.update(id, {
+			title: input.companyName ?? existing.title,
+			data: updatedData
+		}, authorId);
+		if (updated) await this.engine.hooks.doAction("hrms.employer_updated", updated);
+		return updated;
+	}
+	async listEmployers(query = {}) {
+		const limit = query.limit ?? 20;
+		const offset = query.page ? (query.page - 1) * limit : 0;
+		let items = (await this.employersCollection.find({ limit: 500 })).items;
+		if (query.status) items = items.filter((item) => item.data.status === query.status);
+		const total = items.length;
+		return {
+			items: items.slice(offset, offset + limit),
+			total,
+			limit,
+			offset,
+			hasMore: offset + limit < total
+		};
+	}
+	async createEmployee(input, authorId) {
+		if (!await this.getEmployer(input.employerId)) throw new Error(`[HRMSService] Employer with ID '${input.employerId}' not found.`);
+		if (await this.getEmployeeByNumber(input.employerId, input.employeeNumber)) throw new Error(`[HRMSService] Employee number '${input.employeeNumber}' is already registered for this employer.`);
+		const employeeData = {
+			employerId: input.employerId,
+			userId: input.userId,
+			employeeNumber: input.employeeNumber,
+			firstName: input.firstName,
+			lastName: input.lastName,
+			email: input.email,
+			phone: input.phone,
+			avatar: input.avatar,
+			jobTitle: input.jobTitle,
+			employmentType: input.employmentType ?? "full_time",
+			status: input.status ?? "active",
+			hireDate: input.hireDate,
+			managerId: input.managerId,
+			emergencyContact: input.emergencyContact,
+			documents: input.documents ?? [],
+			salary: input.salary,
+			notes: input.notes
+		};
+		const title = `${input.firstName} ${input.lastName}`;
+		const employee = await this.employeesCollection.create({
+			title,
+			status: input.status === "terminated" ? "draft" : "published",
+			data: employeeData
+		}, authorId);
+		if (input.departmentSlug) {
+			const term = await this.engine.taxonomies.getTermBySlug(this.departmentsTaxonomy, input.departmentSlug);
+			if (term) await this.engine.taxonomies.assignTerms(employee.id, [term.id]);
+		}
+		await this.engine.hooks.doAction("hrms.employee_created", employee);
+		return employee;
+	}
+	async getEmployee(id) {
+		return this.employeesCollection.findById(id);
+	}
+	async getEmployeeByNumber(employerId, employeeNumber) {
+		return (await this.employeesCollection.find({ limit: 500 })).items.find((e) => e.data.employerId === employerId && e.data.employeeNumber === employeeNumber) ?? null;
+	}
+	async updateEmployee(id, input, authorId) {
+		const existing = await this.getEmployee(id);
+		if (!existing) return null;
+		const updatedData = {
+			...existing.data,
+			...input.employerId !== void 0 ? { employerId: input.employerId } : {},
+			...input.userId !== void 0 ? { userId: input.userId } : {},
+			...input.employeeNumber !== void 0 ? { employeeNumber: input.employeeNumber } : {},
+			...input.firstName !== void 0 ? { firstName: input.firstName } : {},
+			...input.lastName !== void 0 ? { lastName: input.lastName } : {},
+			...input.email !== void 0 ? { email: input.email } : {},
+			...input.phone !== void 0 ? { phone: input.phone } : {},
+			...input.avatar !== void 0 ? { avatar: input.avatar } : {},
+			...input.jobTitle !== void 0 ? { jobTitle: input.jobTitle } : {},
+			...input.employmentType !== void 0 ? { employmentType: input.employmentType } : {},
+			...input.status !== void 0 ? { status: input.status } : {},
+			...input.hireDate !== void 0 ? { hireDate: input.hireDate } : {},
+			...input.terminationDate !== void 0 ? { terminationDate: input.terminationDate } : {},
+			...input.managerId !== void 0 ? { managerId: input.managerId } : {},
+			...input.emergencyContact !== void 0 ? { emergencyContact: input.emergencyContact } : {},
+			...input.documents !== void 0 ? { documents: input.documents } : {},
+			...input.salary !== void 0 ? { salary: input.salary } : {},
+			...input.notes !== void 0 ? { notes: input.notes } : {}
+		};
+		const title = input.firstName || input.lastName ? `${updatedData.firstName} ${updatedData.lastName}` : existing.title;
+		const updated = await this.employeesCollection.update(id, {
+			title,
+			data: updatedData
+		}, authorId);
+		if (updated) {
+			if (input.departmentSlug) {
+				const term = await this.engine.taxonomies.getTermBySlug(this.departmentsTaxonomy, input.departmentSlug);
+				if (term) await this.engine.taxonomies.assignTerms(id, [term.id]);
+			}
+			await this.engine.hooks.doAction("hrms.employee_updated", updated);
+		}
+		return updated;
+	}
+	async deleteEmployee(id) {
+		const deleted = await this.employeesCollection.delete(id);
+		if (deleted) await this.engine.hooks.doAction("hrms.employee_deleted", id);
+		return deleted;
+	}
+	async listEmployees(query = {}) {
+		const limit = query.limit ?? 20;
+		const offset = query.page ? (query.page - 1) * limit : 0;
+		let termIds;
+		if (query.department) {
+			const term = await this.engine.taxonomies.getTermBySlug(this.departmentsTaxonomy, query.department);
+			if (term) termIds = [term.id];
+			else return {
+				items: [],
+				total: 0,
+				limit,
+				offset,
+				hasMore: false
+			};
+		}
+		let items = (await this.employeesCollection.find({
+			termIds,
+			limit: 1e3
+		})).items;
+		if (query.employerId) items = items.filter((e) => e.data.employerId === query.employerId);
+		if (query.employmentType) items = items.filter((e) => e.data.employmentType === query.employmentType);
+		if (query.status) items = items.filter((e) => e.data.status === query.status);
+		if (query.search) {
+			const s = query.search.toLowerCase();
+			items = items.filter((e) => e.data.firstName.toLowerCase().includes(s) || e.data.lastName.toLowerCase().includes(s) || e.data.email.toLowerCase().includes(s) || e.data.employeeNumber.toLowerCase().includes(s) || e.data.jobTitle && e.data.jobTitle.toLowerCase().includes(s));
+		}
+		const total = items.length;
+		return {
+			items: items.slice(offset, offset + limit),
+			total,
+			limit,
+			offset,
+			hasMore: offset + limit < total
+		};
+	}
+	async getDirectReports(managerId) {
+		return (await this.employeesCollection.find({ limit: 1e3 })).items.filter((e) => e.data.managerId === managerId);
+	}
+	parseTimeToMinutes(timeStr) {
+		const [hours, minutes] = timeStr.split(":").map((v) => parseInt(v, 10));
+		return (hours || 0) * 60 + (minutes || 0);
+	}
+	formatDateString(date, timezone) {
+		if (!timezone || timezone === "UTC") return date.toISOString().slice(0, 10);
+		try {
+			return new Intl.DateTimeFormat("en-CA", {
+				timeZone: timezone,
+				year: "numeric",
+				month: "2-digit",
+				day: "2-digit"
+			}).format(date);
+		} catch {
+			return date.toISOString().slice(0, 10);
+		}
+	}
+	getHoursAndMinutes(date, timezone) {
+		if (!timezone || timezone === "UTC") return {
+			hours: date.getUTCHours(),
+			minutes: date.getUTCMinutes()
+		};
+		try {
+			const parts = new Intl.DateTimeFormat("en-US", {
+				timeZone: timezone,
+				hour: "numeric",
+				minute: "numeric",
+				hour12: false
+			}).formatToParts(date);
+			const hoursPart = parts.find((p) => p.type === "hour");
+			const minutesPart = parts.find((p) => p.type === "minute");
+			return {
+				hours: hoursPart ? parseInt(hoursPart.value, 10) : date.getUTCHours(),
+				minutes: minutesPart ? parseInt(minutesPart.value, 10) : date.getUTCMinutes()
+			};
+		} catch {
+			return {
+				hours: date.getUTCHours(),
+				minutes: date.getUTCMinutes()
+			};
+		}
+	}
+	/**
+	* Check in an employee for today (or specified timestamp).
+	*/
+	async checkIn(input) {
+		const employee = await this.getEmployee(input.employeeId);
+		if (!employee) throw new Error(`[HRMSService] Employee with ID '${input.employeeId}' not found.`);
+		const employer = await this.getEmployer(employee.data.employerId);
+		const timezone = employer?.data?.timezone ?? "UTC";
+		const checkInDate = input.timestamp ? new Date(input.timestamp) : /* @__PURE__ */ new Date();
+		const dateStr = this.formatDateString(checkInDate, timezone);
+		const existing = await this.getDailyAttendance(employee.id, dateStr);
+		if (existing && existing.data.checkInAt) throw new Error(`[HRMSService] Employee '${employee.id}' is already checked in for date ${dateStr}.`);
+		const schedule = employer?.data?.workSchedule;
+		const schedStart = schedule?.startTime ?? this.workScheduleStart;
+		const grace = schedule?.gracePeriodMinutes ?? this.gracePeriodMinutes;
+		const schedMinutes = this.parseTimeToMinutes(schedStart);
+		const { hours: punchHours, minutes: punchMins } = this.getHoursAndMinutes(checkInDate, timezone);
+		const status = punchHours * 60 + punchMins > schedMinutes + grace ? "late" : "present";
+		const attendanceData = {
+			employerId: employee.data.employerId,
+			employeeId: employee.id,
+			date: dateStr,
+			checkInAt: checkInDate.toISOString(),
+			totalHours: 0,
+			overtimeHours: 0,
+			status,
+			location: input.location,
+			notes: input.notes
+		};
+		const attendance = await this.attendanceCollection.create({
+			title: `${employee.title} - ${dateStr}`,
+			status: "published",
+			data: attendanceData
+		});
+		await this.engine.hooks.doAction("hrms.checked_in", attendance, employee);
+		return attendance;
+	}
+	/**
+	* Check out an employee for today (or specified timestamp).
+	*/
+	async checkOut(input) {
+		const employee = await this.getEmployee(input.employeeId);
+		if (!employee) throw new Error(`[HRMSService] Employee with ID '${input.employeeId}' not found.`);
+		const employer = await this.getEmployer(employee.data.employerId);
+		const timezone = employer?.data?.timezone ?? "UTC";
+		const checkOutDate = input.timestamp ? new Date(input.timestamp) : /* @__PURE__ */ new Date();
+		const dateStr = this.formatDateString(checkOutDate, timezone);
+		const record = await this.getDailyAttendance(employee.id, dateStr);
+		if (!record || !record.data.checkInAt) throw new Error(`[HRMSService] No active check-in record found for employee '${employee.id}' on ${dateStr}.`);
+		if (record.data.checkOutAt) throw new Error(`[HRMSService] Employee '${employee.id}' has already checked out for date ${dateStr}.`);
+		const checkInDate = new Date(record.data.checkInAt);
+		const durationMs = Math.max(0, checkOutDate.getTime() - checkInDate.getTime());
+		const totalHours = Math.round(durationMs / (1e3 * 60 * 60) * 100) / 100;
+		const standardHours = employer?.data?.workSchedule?.standardHoursPerDay ?? this.standardWorkDayHours;
+		const overtimeHours = Math.max(0, Math.round((totalHours - standardHours) * 100) / 100);
+		let status = record.data.status;
+		if (totalHours < standardHours / 2 && status === "present") status = "half_day";
+		const updatedData = {
+			...record.data,
+			checkOutAt: checkOutDate.toISOString(),
+			totalHours,
+			overtimeHours,
+			status,
+			...input.location ? { location: input.location } : {},
+			...input.notes ? { notes: input.notes } : {}
+		};
+		const updated = await this.attendanceCollection.update(record.id, { data: updatedData });
+		if (!updated) throw new Error(`[HRMSService] Failed to update attendance record for '${employee.id}'.`);
+		await this.engine.hooks.doAction("hrms.checked_out", updated, employee);
+		return updated;
+	}
+	async getDailyAttendance(employeeId, date) {
+		return (await this.attendanceCollection.find({ limit: 1e3 })).items.find((a) => a.data.employeeId === employeeId && a.data.date === date) ?? null;
+	}
+	async recordAttendanceManual(input) {
+		const existing = await this.getDailyAttendance(input.employeeId, input.date);
+		const attendanceData = {
+			employerId: input.employerId,
+			employeeId: input.employeeId,
+			date: input.date,
+			checkInAt: input.checkInAt,
+			checkOutAt: input.checkOutAt,
+			totalHours: input.totalHours ?? 0,
+			overtimeHours: input.overtimeHours ?? 0,
+			status: input.status ?? "present",
+			location: input.location,
+			notes: input.notes
+		};
+		if (existing) {
+			const updated = await this.attendanceCollection.update(existing.id, { data: attendanceData });
+			if (!updated) throw new Error(`[HRMSService] Failed to update attendance for '${input.employeeId}'.`);
+			return updated;
+		}
+		return this.attendanceCollection.create({
+			title: `${input.employeeId} - ${input.date}`,
+			status: "published",
+			data: attendanceData
+		});
+	}
+	async listAttendance(query = {}) {
+		const limit = query.limit ?? 30;
+		const offset = query.page ? (query.page - 1) * limit : 0;
+		let items = (await this.attendanceCollection.find({ limit: 2e3 })).items;
+		if (query.employerId) items = items.filter((a) => a.data.employerId === query.employerId);
+		if (query.employeeId) items = items.filter((a) => a.data.employeeId === query.employeeId);
+		if (query.date) items = items.filter((a) => a.data.date === query.date);
+		if (query.startDate) items = items.filter((a) => a.data.date >= query.startDate);
+		if (query.endDate) items = items.filter((a) => a.data.date <= query.endDate);
+		if (query.status) items = items.filter((a) => a.data.status === query.status);
+		const total = items.length;
+		return {
+			items: items.slice(offset, offset + limit),
+			total,
+			limit,
+			offset,
+			hasMore: offset + limit < total
+		};
+	}
+	async createLeaveType(input, authorId) {
+		const leaveTypeData = {
+			employerId: input.employerId,
+			name: input.name,
+			code: input.code.toUpperCase(),
+			daysAllowedPerYear: input.daysAllowedPerYear,
+			paid: input.paid ?? true,
+			requiresApproval: input.requiresApproval ?? true,
+			color: input.color,
+			description: input.description
+		};
+		const item = await this.leaveTypesCollection.create({
+			title: input.name,
+			status: "published",
+			data: leaveTypeData
+		}, authorId);
+		await this.engine.hooks.doAction("hrms.leave_type_created", item);
+		return item;
+	}
+	async getLeaveType(id) {
+		return this.leaveTypesCollection.findById(id);
+	}
+	async listLeaveTypes(employerId) {
+		const result = await this.leaveTypesCollection.find({ limit: 100 });
+		if (!employerId) return result.items;
+		return result.items.filter((lt) => !lt.data.employerId || lt.data.employerId === employerId);
+	}
+	/**
+	* Calculate leave balance report for an employee for a given year.
+	*/
+	async calculateLeaveBalance(employeeId, year) {
+		const targetYear = year ?? (/* @__PURE__ */ new Date()).getFullYear();
+		const employee = await this.getEmployee(employeeId);
+		if (!employee) throw new Error(`[HRMSService] Employee with ID '${employeeId}' not found.`);
+		const leaveTypes = await this.listLeaveTypes(employee.data.employerId);
+		const allRequests = await this.leaveRequestsCollection.find({ limit: 1e3 });
+		const yearStr = String(targetYear);
+		const employeeRequests = allRequests.items.filter((r) => r.data.employeeId === employeeId && (r.data.startDate.startsWith(yearStr) || r.data.endDate.startsWith(yearStr)));
+		const balances = leaveTypes.map((lt) => {
+			const approved = employeeRequests.filter((r) => r.data.leaveTypeId === lt.id && r.data.status === "approved");
+			const pending = employeeRequests.filter((r) => r.data.leaveTypeId === lt.id && r.data.status === "pending");
+			const usedDays = approved.reduce((sum, r) => sum + (r.data.daysCount || 0), 0);
+			const pendingDays = pending.reduce((sum, r) => sum + (r.data.daysCount || 0), 0);
+			const allocatedDays = lt.data.daysAllowedPerYear ?? 0;
+			const remainingDays = Math.max(0, allocatedDays - usedDays);
+			return {
+				leaveTypeId: lt.id,
+				leaveTypeName: lt.data.name,
+				leaveTypeCode: lt.data.code,
+				allocatedDays,
+				usedDays,
+				pendingDays,
+				remainingDays
+			};
+		});
+		const report = {
+			employeeId,
+			year: targetYear,
+			balances,
+			totalAllocated: balances.reduce((sum, b) => sum + b.allocatedDays, 0),
+			totalUsed: balances.reduce((sum, b) => sum + b.usedDays, 0),
+			totalRemaining: balances.reduce((sum, b) => sum + b.remainingDays, 0)
+		};
+		return this.engine.hooks.applyFilters("hrms.calculate_leave_balance", report, employeeId, targetYear);
+	}
+	/**
+	* Submit a new leave request.
+	*/
+	async requestLeave(input, authorId) {
+		const employee = await this.getEmployee(input.employeeId);
+		if (!employee) throw new Error(`[HRMSService] Employee with ID '${input.employeeId}' not found.`);
+		const leaveType = await this.getLeaveType(input.leaveTypeId);
+		if (!leaveType) throw new Error(`[HRMSService] Leave type with ID '${input.leaveTypeId}' not found.`);
+		if (input.startDate > input.endDate) throw new Error(`[HRMSService] Start date '${input.startDate}' cannot be after end date '${input.endDate}'.`);
+		const start = new Date(input.startDate);
+		const end = new Date(input.endDate);
+		const calculatedDays = Math.max(1, Math.round((end.getTime() - start.getTime()) / (1e3 * 60 * 60 * 24)) + 1);
+		const daysCount = input.daysCount ?? calculatedDays;
+		const startYear = start.getFullYear();
+		const balance = (await this.calculateLeaveBalance(employee.id, startYear)).balances.find((b) => b.leaveTypeId === leaveType.id);
+		if (balance && leaveType.data.requiresApproval && daysCount > balance.remainingDays) throw new Error(`[HRMSService] Insufficient leave balance for ${leaveType.data.name}. Requested: ${daysCount}, Remaining: ${balance.remainingDays}.`);
+		const leaveRequestData = {
+			employerId: input.employerId ?? employee.data.employerId,
+			employeeId: employee.id,
+			leaveTypeId: leaveType.id,
+			startDate: input.startDate,
+			endDate: input.endDate,
+			daysCount,
+			reason: input.reason,
+			status: "pending"
+		};
+		const item = await this.leaveRequestsCollection.create({
+			title: `${employee.title} - ${leaveType.data.name} (${input.startDate})`,
+			status: "published",
+			data: leaveRequestData
+		}, authorId);
+		await this.engine.hooks.doAction("hrms.leave_requested", item, employee);
+		return item;
+	}
+	/**
+	* Approve a pending leave request.
+	*/
+	async approveLeave(input) {
+		const request = await this.leaveRequestsCollection.findById(input.requestId);
+		if (!request) throw new Error(`[HRMSService] Leave request with ID '${input.requestId}' not found.`);
+		if (request.data.status !== "pending") throw new Error(`[HRMSService] Cannot approve leave request with status '${request.data.status}'.`);
+		const updated = await this.leaveRequestsCollection.update(request.id, { data: {
+			...request.data,
+			status: "approved",
+			approvedBy: input.approverId,
+			approvedAt: (/* @__PURE__ */ new Date()).toISOString()
+		} });
+		if (!updated) throw new Error(`[HRMSService] Failed to update leave request.`);
+		await this.engine.hooks.doAction("hrms.leave_approved", updated);
+		return updated;
+	}
+	/**
+	* Reject a pending leave request.
+	*/
+	async rejectLeave(input) {
+		const request = await this.leaveRequestsCollection.findById(input.requestId);
+		if (!request) throw new Error(`[HRMSService] Leave request with ID '${input.requestId}' not found.`);
+		if (request.data.status !== "pending") throw new Error(`[HRMSService] Cannot reject leave request with status '${request.data.status}'.`);
+		const updated = await this.leaveRequestsCollection.update(request.id, { data: {
+			...request.data,
+			status: "rejected",
+			approvedBy: input.approverId,
+			rejectionReason: input.reason,
+			approvedAt: (/* @__PURE__ */ new Date()).toISOString()
+		} });
+		if (!updated) throw new Error(`[HRMSService] Failed to update leave request.`);
+		await this.engine.hooks.doAction("hrms.leave_rejected", updated);
+		return updated;
+	}
+	/**
+	* Cancel a leave request.
+	*/
+	async cancelLeave(requestId) {
+		const request = await this.leaveRequestsCollection.findById(requestId);
+		if (!request) throw new Error(`[HRMSService] Leave request with ID '${requestId}' not found.`);
+		if (request.data.status === "cancelled") return request;
+		const updated = await this.leaveRequestsCollection.update(request.id, { data: {
+			...request.data,
+			status: "cancelled"
+		} });
+		if (!updated) throw new Error(`[HRMSService] Failed to cancel leave request.`);
+		await this.engine.hooks.doAction("hrms.leave_cancelled", updated);
+		return updated;
+	}
+	async listLeaveRequests(query = {}) {
+		const limit = query.limit ?? 20;
+		const offset = query.page ? (query.page - 1) * limit : 0;
+		let items = (await this.leaveRequestsCollection.find({ limit: 1e3 })).items;
+		if (query.employerId) items = items.filter((r) => r.data.employerId === query.employerId);
+		if (query.employeeId) items = items.filter((r) => r.data.employeeId === query.employeeId);
+		if (query.leaveTypeId) items = items.filter((r) => r.data.leaveTypeId === query.leaveTypeId);
+		if (query.status) items = items.filter((r) => r.data.status === query.status);
+		if (query.year) {
+			const yearStr = String(query.year);
+			items = items.filter((r) => r.data.startDate.startsWith(yearStr) || r.data.endDate.startsWith(yearStr));
+		}
+		const total = items.length;
+		return {
+			items: items.slice(offset, offset + limit),
+			total,
+			limit,
+			offset,
+			hasMore: offset + limit < total
+		};
+	}
+};
+//#endregion
+//#region src/plugins/hrms/routes.ts
+function json(data, status = 200) {
+	return new Response(JSON.stringify(data), {
+		status,
+		headers: {
+			"Content-Type": "application/json",
+			"Access-Control-Allow-Origin": "*"
+		}
+	});
+}
+function badRequest(message) {
+	return json({ error: message }, 400);
+}
+function notFound(message) {
+	return json({ error: message }, 404);
+}
+function registerHRMSRoutes(ctx, service, options = {}) {
+	const prefix = (options.apiPrefix ?? "/api/hrms").replace(/\/+$/, "");
+	ctx.registerRoute("GET", `${prefix}/employers`, async (_req, { url }) => {
+		try {
+			const status = url.searchParams.get("status");
+			const pageStr = url.searchParams.get("page");
+			const limitStr = url.searchParams.get("limit");
+			const page = pageStr ? parseInt(pageStr, 10) : void 0;
+			const limit = limitStr ? parseInt(limitStr, 10) : void 0;
+			return json(await service.listEmployers({
+				status,
+				page,
+				limit
+			}));
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("POST", `${prefix}/employers`, async (req) => {
+		try {
+			const body = await req.json();
+			if (!body.companyName) return badRequest("companyName is required.");
+			return json(await service.createEmployer(body), 201);
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("GET", `${prefix}/employers/:id`, async (_req, { params }) => {
+		try {
+			const employer = await service.getEmployer(params.id);
+			if (!employer) return notFound(`Employer '${params.id}' not found.`);
+			return json(employer);
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("PUT", `${prefix}/employers/:id`, async (req, { params }) => {
+		try {
+			const body = await req.json();
+			const updated = await service.updateEmployer(params.id, body);
+			if (!updated) return notFound(`Employer '${params.id}' not found.`);
+			return json(updated);
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("GET", `${prefix}/employees`, async (_req, { url }) => {
+		try {
+			const employerId = url.searchParams.get("employerId") ?? void 0;
+			const department = url.searchParams.get("department") ?? void 0;
+			const employmentType = url.searchParams.get("employmentType");
+			const status = url.searchParams.get("status");
+			const search = url.searchParams.get("search") ?? void 0;
+			const pageStr = url.searchParams.get("page");
+			const limitStr = url.searchParams.get("limit");
+			const page = pageStr ? parseInt(pageStr, 10) : void 0;
+			const limit = limitStr ? parseInt(limitStr, 10) : void 0;
+			return json(await service.listEmployees({
+				employerId,
+				department,
+				employmentType,
+				status,
+				search,
+				page,
+				limit
+			}));
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("POST", `${prefix}/employees`, async (req) => {
+		try {
+			const body = await req.json();
+			if (!body.employerId) return badRequest("employerId is required.");
+			if (!body.employeeNumber) return badRequest("employeeNumber is required.");
+			if (!body.firstName || !body.lastName) return badRequest("firstName and lastName are required.");
+			if (!body.email) return badRequest("email is required.");
+			return json(await service.createEmployee(body), 201);
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("GET", `${prefix}/employees/:id`, async (_req, { params }) => {
+		try {
+			const employee = await service.getEmployee(params.id);
+			if (!employee) return notFound(`Employee '${params.id}' not found.`);
+			return json(employee);
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("PUT", `${prefix}/employees/:id`, async (req, { params }) => {
+		try {
+			const body = await req.json();
+			const updated = await service.updateEmployee(params.id, body);
+			if (!updated) return notFound(`Employee '${params.id}' not found.`);
+			return json(updated);
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("DELETE", `${prefix}/employees/:id`, async (_req, { params }) => {
+		try {
+			if (!await service.deleteEmployee(params.id)) return notFound(`Employee '${params.id}' not found.`);
+			return json({ success: true });
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("GET", `${prefix}/employees/:id/leave-balance`, async (_req, { params, url }) => {
+		try {
+			const yearStr = url.searchParams.get("year");
+			const year = yearStr ? parseInt(yearStr, 10) : void 0;
+			return json(await service.calculateLeaveBalance(params.id, year));
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("GET", `${prefix}/employees/:id/direct-reports`, async (_req, { params }) => {
+		try {
+			const reports = await service.getDirectReports(params.id);
+			return json({
+				items: reports,
+				total: reports.length
+			});
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("POST", `${prefix}/attendance/check-in`, async (req) => {
+		try {
+			const body = await req.json();
+			if (!body.employeeId) return badRequest("employeeId is required.");
+			return json(await service.checkIn(body), 201);
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("POST", `${prefix}/attendance/check-out`, async (req) => {
+		try {
+			const body = await req.json();
+			if (!body.employeeId) return badRequest("employeeId is required.");
+			return json(await service.checkOut(body));
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("GET", `${prefix}/attendance`, async (_req, { url }) => {
+		try {
+			const employerId = url.searchParams.get("employerId") ?? void 0;
+			const employeeId = url.searchParams.get("employeeId") ?? void 0;
+			const date = url.searchParams.get("date") ?? void 0;
+			const startDate = url.searchParams.get("startDate") ?? void 0;
+			const endDate = url.searchParams.get("endDate") ?? void 0;
+			const status = url.searchParams.get("status");
+			const pageStr = url.searchParams.get("page");
+			const limitStr = url.searchParams.get("limit");
+			const page = pageStr ? parseInt(pageStr, 10) : void 0;
+			const limit = limitStr ? parseInt(limitStr, 10) : void 0;
+			return json(await service.listAttendance({
+				employerId,
+				employeeId,
+				date,
+				startDate,
+				endDate,
+				status,
+				page,
+				limit
+			}));
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("POST", `${prefix}/attendance/manual`, async (req) => {
+		try {
+			const body = await req.json();
+			if (!body.employerId || !body.employeeId || !body.date || !body.checkInAt) return badRequest("employerId, employeeId, date, and checkInAt are required.");
+			return json(await service.recordAttendanceManual(body), 201);
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("GET", `${prefix}/leave-types`, async (_req, { url }) => {
+		try {
+			const employerId = url.searchParams.get("employerId") ?? void 0;
+			const types = await service.listLeaveTypes(employerId);
+			return json({
+				items: types,
+				total: types.length
+			});
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("POST", `${prefix}/leave-types`, async (req) => {
+		try {
+			const body = await req.json();
+			if (!body.name || !body.code || body.daysAllowedPerYear === void 0) return badRequest("name, code, and daysAllowedPerYear are required.");
+			return json(await service.createLeaveType(body), 201);
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("GET", `${prefix}/leave-types/:id`, async (_req, { params }) => {
+		try {
+			const leaveType = await service.getLeaveType(params.id);
+			if (!leaveType) return notFound(`Leave type '${params.id}' not found.`);
+			return json(leaveType);
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("GET", `${prefix}/leave-requests`, async (_req, { url }) => {
+		try {
+			const employerId = url.searchParams.get("employerId") ?? void 0;
+			const employeeId = url.searchParams.get("employeeId") ?? void 0;
+			const leaveTypeId = url.searchParams.get("leaveTypeId") ?? void 0;
+			const status = url.searchParams.get("status");
+			const yearStr = url.searchParams.get("year");
+			const year = yearStr ? parseInt(yearStr, 10) : void 0;
+			const pageStr = url.searchParams.get("page");
+			const limitStr = url.searchParams.get("limit");
+			const page = pageStr ? parseInt(pageStr, 10) : void 0;
+			const limit = limitStr ? parseInt(limitStr, 10) : void 0;
+			return json(await service.listLeaveRequests({
+				employerId,
+				employeeId,
+				leaveTypeId,
+				status,
+				year,
+				page,
+				limit
+			}));
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("POST", `${prefix}/leave-requests`, async (req) => {
+		try {
+			const body = await req.json();
+			if (!body.employeeId || !body.leaveTypeId || !body.startDate || !body.endDate) return badRequest("employeeId, leaveTypeId, startDate, and endDate are required.");
+			return json(await service.requestLeave(body), 201);
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("POST", `${prefix}/leave-requests/:id/approve`, async (req, { params }) => {
+		try {
+			const approverId = (await req.json().catch(() => ({}))).approverId ?? "admin";
+			return json(await service.approveLeave({
+				requestId: params.id,
+				approverId
+			}));
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("POST", `${prefix}/leave-requests/:id/reject`, async (req, { params }) => {
+		try {
+			const body = await req.json().catch(() => ({}));
+			const approverId = body.approverId ?? "admin";
+			return json(await service.rejectLeave({
+				requestId: params.id,
+				approverId,
+				reason: body.reason
+			}));
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+	ctx.registerRoute("POST", `${prefix}/leave-requests/:id/cancel`, async (_req, { params }) => {
+		try {
+			return json(await service.cancelLeave(params.id));
+		} catch (err) {
+			return badRequest(err instanceof Error ? err.message : String(err));
+		}
+	});
+}
+//#endregion
+//#region src/plugins/hrms/client.ts
+var HRMSClient = class {
+	client;
+	options;
+	service;
+	prefix;
+	constructor(client, options = {}) {
+		this.client = client;
+		this.options = options;
+		this.prefix = (options.apiPrefix ?? "/api/hrms").replace(/\/+$/, "");
+		const engine = client.getEngine();
+		if (engine) this.service = new HRMSService(engine, options);
+	}
+	employers = {
+		find: async (query = {}) => {
+			if (this.service) return this.service.listEmployers(query);
+			const params = new URLSearchParams();
+			if (query.status) params.set("status", query.status);
+			if (query.page) params.set("page", String(query.page));
+			if (query.limit) params.set("limit", String(query.limit));
+			const q = params.toString() ? `?${params.toString()}` : "";
+			return this.client.request(`${this.prefix}/employers${q}`);
+		},
+		get: async (id) => {
+			if (this.service) return this.service.getEmployer(id);
+			return this.client.request(`${this.prefix}/employers/${encodeURIComponent(id)}`);
+		},
+		create: async (input) => {
+			if (this.service) return this.service.createEmployer(input);
+			return this.client.request(`${this.prefix}/employers`, {
+				method: "POST",
+				body: JSON.stringify(input)
+			});
+		},
+		update: async (id, input) => {
+			if (this.service) return this.service.updateEmployer(id, input);
+			return this.client.request(`${this.prefix}/employers/${encodeURIComponent(id)}`, {
+				method: "PUT",
+				body: JSON.stringify(input)
+			});
+		}
+	};
+	employees = {
+		find: async (query = {}) => {
+			if (this.service) return this.service.listEmployees(query);
+			const params = new URLSearchParams();
+			if (query.employerId) params.set("employerId", query.employerId);
+			if (query.department) params.set("department", query.department);
+			if (query.employmentType) params.set("employmentType", query.employmentType);
+			if (query.status) params.set("status", query.status);
+			if (query.search) params.set("search", query.search);
+			if (query.page) params.set("page", String(query.page));
+			if (query.limit) params.set("limit", String(query.limit));
+			const q = params.toString() ? `?${params.toString()}` : "";
+			return this.client.request(`${this.prefix}/employees${q}`);
+		},
+		get: async (id) => {
+			if (this.service) return this.service.getEmployee(id);
+			return this.client.request(`${this.prefix}/employees/${encodeURIComponent(id)}`);
+		},
+		getByNumber: async (employerId, employeeNumber) => {
+			if (this.service) return this.service.getEmployeeByNumber(employerId, employeeNumber);
+			return (await this.employees.find({
+				employerId,
+				search: employeeNumber
+			})).items.find((e) => e.data.employeeNumber === employeeNumber) ?? null;
+		},
+		create: async (input) => {
+			if (this.service) return this.service.createEmployee(input);
+			return this.client.request(`${this.prefix}/employees`, {
+				method: "POST",
+				body: JSON.stringify(input)
+			});
+		},
+		update: async (id, input) => {
+			if (this.service) return this.service.updateEmployee(id, input);
+			return this.client.request(`${this.prefix}/employees/${encodeURIComponent(id)}`, {
+				method: "PUT",
+				body: JSON.stringify(input)
+			});
+		},
+		delete: async (id) => {
+			if (this.service) return this.service.deleteEmployee(id);
+			return (await this.client.request(`${this.prefix}/employees/${encodeURIComponent(id)}`, { method: "DELETE" })).success;
+		},
+		getLeaveBalance: async (employeeId, year) => {
+			if (this.service) return this.service.calculateLeaveBalance(employeeId, year);
+			const q = year ? `?year=${year}` : "";
+			return this.client.request(`${this.prefix}/employees/${encodeURIComponent(employeeId)}/leave-balance${q}`);
+		},
+		getDirectReports: async (managerId) => {
+			if (this.service) return this.service.getDirectReports(managerId);
+			return (await this.client.request(`${this.prefix}/employees/${encodeURIComponent(managerId)}/direct-reports`)).items;
+		}
+	};
+	attendance = {
+		checkIn: async (input) => {
+			if (this.service) return this.service.checkIn(input);
+			return this.client.request(`${this.prefix}/attendance/check-in`, {
+				method: "POST",
+				body: JSON.stringify(input)
+			});
+		},
+		checkOut: async (input) => {
+			if (this.service) return this.service.checkOut(input);
+			return this.client.request(`${this.prefix}/attendance/check-out`, {
+				method: "POST",
+				body: JSON.stringify(input)
+			});
+		},
+		getDaily: async (employeeId, date) => {
+			if (this.service) return this.service.getDailyAttendance(employeeId, date);
+			return (await this.attendance.find({
+				employeeId,
+				date
+			})).items[0] ?? null;
+		},
+		find: async (query = {}) => {
+			if (this.service) return this.service.listAttendance(query);
+			const params = new URLSearchParams();
+			if (query.employerId) params.set("employerId", query.employerId);
+			if (query.employeeId) params.set("employeeId", query.employeeId);
+			if (query.date) params.set("date", query.date);
+			if (query.startDate) params.set("startDate", query.startDate);
+			if (query.endDate) params.set("endDate", query.endDate);
+			if (query.status) params.set("status", query.status);
+			if (query.page) params.set("page", String(query.page));
+			if (query.limit) params.set("limit", String(query.limit));
+			const q = params.toString() ? `?${params.toString()}` : "";
+			return this.client.request(`${this.prefix}/attendance${q}`);
+		},
+		recordManual: async (input) => {
+			if (this.service) return this.service.recordAttendanceManual(input);
+			return this.client.request(`${this.prefix}/attendance/manual`, {
+				method: "POST",
+				body: JSON.stringify(input)
+			});
+		}
+	};
+	leaves = {
+		listTypes: async (employerId) => {
+			if (this.service) return this.service.listLeaveTypes(employerId);
+			const q = employerId ? `?employerId=${encodeURIComponent(employerId)}` : "";
+			return (await this.client.request(`${this.prefix}/leave-types${q}`)).items;
+		},
+		createType: async (input) => {
+			if (this.service) return this.service.createLeaveType(input);
+			return this.client.request(`${this.prefix}/leave-types`, {
+				method: "POST",
+				body: JSON.stringify(input)
+			});
+		},
+		getType: async (id) => {
+			if (this.service) return this.service.getLeaveType(id);
+			return this.client.request(`${this.prefix}/leave-types/${encodeURIComponent(id)}`);
+		},
+		findRequests: async (query = {}) => {
+			if (this.service) return this.service.listLeaveRequests(query);
+			const params = new URLSearchParams();
+			if (query.employerId) params.set("employerId", query.employerId);
+			if (query.employeeId) params.set("employeeId", query.employeeId);
+			if (query.leaveTypeId) params.set("leaveTypeId", query.leaveTypeId);
+			if (query.status) params.set("status", query.status);
+			if (query.year) params.set("year", String(query.year));
+			if (query.page) params.set("page", String(query.page));
+			if (query.limit) params.set("limit", String(query.limit));
+			const q = params.toString() ? `?${params.toString()}` : "";
+			return this.client.request(`${this.prefix}/leave-requests${q}`);
+		},
+		request: async (input) => {
+			if (this.service) return this.service.requestLeave(input);
+			return this.client.request(`${this.prefix}/leave-requests`, {
+				method: "POST",
+				body: JSON.stringify(input)
+			});
+		},
+		approve: async (input) => {
+			if (this.service) return this.service.approveLeave(input);
+			return this.client.request(`${this.prefix}/leave-requests/${encodeURIComponent(input.requestId)}/approve`, {
+				method: "POST",
+				body: JSON.stringify({ approverId: input.approverId })
+			});
+		},
+		reject: async (input) => {
+			if (this.service) return this.service.rejectLeave(input);
+			return this.client.request(`${this.prefix}/leave-requests/${encodeURIComponent(input.requestId)}/reject`, {
+				method: "POST",
+				body: JSON.stringify({
+					approverId: input.approverId,
+					reason: input.reason
+				})
+			});
+		},
+		cancel: async (requestId) => {
+			if (this.service) return this.service.cancelLeave(requestId);
+			return this.client.request(`${this.prefix}/leave-requests/${encodeURIComponent(requestId)}/cancel`, { method: "POST" });
+		}
+	};
+};
+/**
+* Get or create an HRMSClient adapter for a CMSClient.
+*/
+function getHRMSClient(client, options) {
+	return new HRMSClient(client, options);
+}
+//#endregion
+//#region src/plugins/hrms/index.ts
+/**
+* @azlib/cms - Built-in HRMS Plugin
+*/
+/**
+* Built-in HRMS plugin factory for @azlib/cms.
+* Equips the CMS engine with multi-tenant employers, employee profiles,
+* daily attendance check-in/out tracking, and leave quota approval workflows.
+*/
+const hrmsPlugin = definePlugin((options) => {
+	const opts = options || {};
+	const collections = [createEmployeeCollection(opts)];
+	if (opts.enableEmployers !== false) collections.unshift(createEmployerCollection(opts));
+	if (opts.enableAttendance !== false) collections.push(createAttendanceCollection(opts));
+	if (opts.enableLeaves !== false) {
+		collections.push(createLeaveTypeCollection(opts));
+		collections.push(createLeaveRequestCollection(opts));
+	}
+	return {
+		name: "hrms",
+		version: "1.0.0",
+		description: "Built-in Human Resource Management System (HRMS) plugin for employers, employees, attendance, and leave management",
+		collections,
+		taxonomies: createHRMSTaxonomies(opts),
+		setup(ctx) {
+			const service = new HRMSService(ctx.engine, opts);
+			ctx.engine.__hrmsService = service;
+			registerHRMSRoutes(ctx, service, opts);
+		}
+	};
+});
+/**
+* Retrieve the active HRMSService instance associated with a CMSEngine.
+*/
+function getHRMSService(engine, options) {
+	if (engine.__hrmsService) return engine.__hrmsService;
+	const service = new HRMSService(engine, options);
+	engine.__hrmsService = service;
+	return service;
+}
+//#endregion
 exports.CMSClient = CMSClient;
 exports.CMSEngine = CMSEngine;
 exports.CMSRouter = CMSRouter;
@@ -3243,6 +4834,8 @@ exports.DEFAULT_COLLECTIONS = DEFAULT_COLLECTIONS;
 exports.DEFAULT_ROLE_CAPABILITIES = DEFAULT_ROLE_CAPABILITIES;
 exports.EcommerceClient = EcommerceClient;
 exports.EcommerceService = EcommerceService;
+exports.HRMSClient = HRMSClient;
+exports.HRMSService = HRMSService;
 exports.HooksManager = HooksManager;
 exports.MediaManager = MediaManager;
 exports.MemoryStorageAdapter = MemoryStorageAdapter;
@@ -3252,11 +4845,17 @@ exports.RevisionManager = RevisionManager;
 exports.TaxonomyManager = TaxonomyManager;
 exports.VALID_STATUS_TRANSITIONS = VALID_STATUS_TRANSITIONS;
 exports.collection = collection;
+exports.createAttendanceCollection = createAttendanceCollection;
 exports.createCMSEngine = createCMSEngine;
 exports.createCMSRouter = createCMSRouter;
 exports.createCmsClient = createCmsClient;
 exports.createDiscountCollection = createDiscountCollection;
 exports.createEcommerceTaxonomies = createEcommerceTaxonomies;
+exports.createEmployeeCollection = createEmployeeCollection;
+exports.createEmployerCollection = createEmployerCollection;
+exports.createHRMSTaxonomies = createHRMSTaxonomies;
+exports.createLeaveRequestCollection = createLeaveRequestCollection;
+exports.createLeaveTypeCollection = createLeaveTypeCollection;
 exports.createOrderCollection = createOrderCollection;
 exports.createProductCollection = createProductCollection;
 exports.defaultHooks = defaultHooks;
@@ -3266,6 +4865,9 @@ exports.ecommercePlugin = ecommercePlugin;
 exports.fields = fields;
 exports.getEcommerceClient = getEcommerceClient;
 exports.getEcommerceService = getEcommerceService;
+exports.getHRMSClient = getHRMSClient;
+exports.getHRMSService = getHRMSService;
+exports.hrmsPlugin = hrmsPlugin;
 exports.normalizeConfig = normalizeConfig;
 exports.resolveUniqueSlug = resolveUniqueSlug;
 exports.slugify = slugify;