@azlib/cms 0.3.0 → 0.5.0

package/dist/index.d.cts

@@ -516,7 +516,7 @@ interface CMSPlugin {
 /**
  * Type-safe helper for authoring reusable CMS plugins and plugin factories.
  */
-declare function definePlugin<TOptions = void>(factory: (options: TOptions) => CMSPlugin): (options: TOptions) => CMSPlugin;
+declare function definePlugin<TOptions = void>(factory: (options: TOptions) => CMSPlugin): void extends TOptions ? (options?: TOptions) => CMSPlugin : undefined extends TOptions ? (options?: TOptions) => CMSPlugin : (options: TOptions) => CMSPlugin;
 //#endregion
 //#region src/core/types.d.ts
 type ContentStatus = "draft" | "pending_review" | "scheduled" | "published" | "private" | "trash";
@@ -946,6 +946,10 @@ declare class CMSClient {
   private fetchFn;
   private headers;
   constructor(options: CMSClientOptions);
+  /**
+   * Access underlying CMSEngine instance when in in-process mode.
+   */
+  getEngine(): CMSEngine | undefined;
   collection<TData extends Record<string, unknown> = Record<string, unknown>>(slug: string): ClientCollectionApi<TData>;
   readonly taxonomies: {
     getTerms: (taxonomy: string) => Promise<TermItem[]>;
@@ -961,9 +965,935 @@ declare class CMSClient {
   readonly options: {
     get: <T = unknown>(key: string, defaultValue?: T) => Promise<T | undefined>;
   };
-  private request;
+  /**
+   * Perform an HTTP request against the CMS API (available in remote mode).
+   */
+  request<T>(endpoint: string, init?: RequestInit): Promise<T>;
 }
 declare function createCmsClient(options: CMSClientOptions): CMSClient;
 //#endregion
-export { type ActionCallback, type BooleanFieldOptions, CMSCapability, CMSClient, type CMSClientOptions, CMSConfig, CMSEngine, type CMSPlugin, type CMSPluginContext, CMSRouter, type CMSStorageAdapter, CMSUser, type ClientCollectionApi, CollectionConfig, type CollectionOptions, type CollectionService, ContentItem, ContentLifecycle, ContentQueryOptions, ContentStatus, type CreateContentInput, type CustomRouteHandler, DEFAULT_COLLECTIONS, DEFAULT_ROLE_CAPABILITIES, type DateFieldOptions, FieldDefinition, FieldType, type FilterCallback, type HookEntry, HooksManager, type ImageFieldOptions, type JsonFieldOptions, MediaItem, MediaManager, type MediaUploadInput, MemoryStorageAdapter, type NumberFieldOptions, OptionItem, OptionsManager, PaginatedResult, RBACManager, type RelationshipFieldOptions, type RepeaterFieldOptions, RevisionDiff, RevisionDiffField, RevisionManager, RevisionRecord, type RichTextFieldOptions, type RouteContext, type SelectFieldOptions, SelectOption, SiteConfig, type SlugFieldOptions, type SyncFilterCallback, TaxonomyConfig, type TaxonomyFieldOptions, TaxonomyManager, TermItem, TermTreeItem, type TextFieldOptions, type UpdateContentInput, UserRole, VALID_STATUS_TRANSITIONS, collection, createCMSEngine, createCMSRouter, createCmsClient, defaultHooks, defineConfig, definePlugin, fields, normalizeConfig, resolveUniqueSlug, slugify, validateAndNormalizeData };
+//#region src/plugins/ecommerce/types.d.ts
+type ProductStatus = "draft" | "published" | "out_of_stock" | "archived";
+interface ProductVariant {
+  readonly id: string;
+  readonly title: string;
+  readonly sku?: string;
+  readonly price?: number;
+  readonly compareAtPrice?: number;
+  readonly stock?: number;
+  readonly attributes?: Record<string, string>;
+  readonly image?: string;
+}
+interface ProductImage {
+  readonly id?: string;
+  readonly url: string;
+  readonly altText?: string;
+  readonly caption?: string;
+  readonly width?: number;
+  readonly height?: number;
+}
+interface ProductData extends Record<string, unknown> {
+  sku?: string;
+  price: number;
+  compareAtPrice?: number;
+  costPrice?: number;
+  currency?: string;
+  stock: number;
+  trackInventory?: boolean;
+  status: ProductStatus;
+  description?: string;
+  shortDescription?: string;
+  featuredImage?: string;
+  gallery?: ProductImage[];
+  variants?: ProductVariant[];
+  attributes?: Record<string, unknown>;
+  weight?: number;
+}
+type ProductItem = ContentItem<ProductData>;
+type DiscountType = "percentage" | "fixed_amount" | "free_shipping";
+type DiscountStatus = "active" | "disabled" | "expired";
+interface DiscountData extends Record<string, unknown> {
+  code: string;
+  discountType: DiscountType;
+  value: number;
+  minOrderAmount?: number;
+  maxDiscountAmount?: number;
+  maxUses?: number;
+  usedCount: number;
+  startDate?: string;
+  endDate?: string;
+  status: DiscountStatus;
+  appliesToProductIds?: string[];
+  appliesToCategoryIds?: string[];
+}
+type DiscountItem = ContentItem<DiscountData>;
+type OrderStatus = "pending" | "paid" | "processing" | "shipped" | "delivered" | "cancelled" | "refunded";
+interface OrderLineItem {
+  productId: string;
+  variantId?: string;
+  title: string;
+  sku?: string;
+  price: number;
+  quantity: number;
+  subtotal: number;
+  image?: string;
+}
+interface OrderAddress {
+  firstName?: string;
+  lastName?: string;
+  company?: string;
+  address1: string;
+  address2?: string;
+  city: string;
+  province?: string;
+  country: string;
+  postalCode: string;
+  phone?: string;
+}
+interface OrderData extends Record<string, unknown> {
+  orderNumber: string;
+  customerEmail: string;
+  customerName?: string;
+  status: OrderStatus;
+  currency: string;
+  items: OrderLineItem[];
+  subtotal: number;
+  discountTotal: number;
+  discountCode?: string;
+  shippingTotal: number;
+  taxTotal: number;
+  total: number;
+  shippingAddress?: OrderAddress;
+  billingAddress?: OrderAddress;
+  paymentMethod?: string;
+  notes?: string;
+}
+type OrderItem = ContentItem<OrderData>;
+interface EcommercePluginOptions {
+  /**
+   * Slug for the products collection. Default: "products"
+   */
+  readonly productCollectionSlug?: string;
+  /**
+   * Slug for the discounts collection. Default: "discounts"
+   */
+  readonly discountCollectionSlug?: string;
+  /**
+   * Slug for the orders collection. Default: "orders"
+   */
+  readonly orderCollectionSlug?: string;
+  /**
+   * Slug for the categories taxonomy. Default: "product_categories"
+   */
+  readonly categoriesTaxonomySlug?: string;
+  /**
+   * Slug for the tags taxonomy. Default: "product_tags"
+   */
+  readonly tagsTaxonomySlug?: string;
+  /**
+   * Slug for the brands taxonomy. Default: "product_brands"
+   */
+  readonly brandsTaxonomySlug?: string;
+  /**
+   * Default currency code. Default: "USD"
+   */
+  readonly defaultCurrency?: string;
+  /**
+   * REST API route prefix. Default: "/api/ecommerce"
+   */
+  readonly apiPrefix?: string;
+  /**
+   * Enable inventory management (decrement stock on orders, check availability). Default: true
+   */
+  readonly inventoryManagement?: boolean;
+  /**
+   * Enable orders collection and order routes. Default: true
+   */
+  readonly enableOrders?: boolean;
+  /**
+   * Enable discounts collection and discount calculation. Default: true
+   */
+  readonly enableDiscounts?: boolean;
+  /**
+   * Default flat tax rate multiplier (e.g. 0.08 for 8%). Default: 0
+   */
+  readonly defaultTaxRate?: number;
+  /**
+   * Default flat shipping cost. Default: 0
+   */
+  readonly defaultShippingCost?: number;
+}
+interface CreateProductInput {
+  title: string;
+  slug?: string;
+  price: number;
+  compareAtPrice?: number;
+  costPrice?: number;
+  sku?: string;
+  currency?: string;
+  stock?: number;
+  trackInventory?: boolean;
+  status?: ProductStatus;
+  description?: string;
+  shortDescription?: string;
+  featuredImage?: string;
+  gallery?: ProductImage[];
+  variants?: ProductVariant[];
+  attributes?: Record<string, unknown>;
+  weight?: number;
+  categoryIds?: string[];
+  tagIds?: string[];
+  brandIds?: string[];
+}
+interface UpdateProductInput {
+  title?: string;
+  slug?: string;
+  price?: number;
+  compareAtPrice?: number;
+  costPrice?: number;
+  sku?: string;
+  currency?: string;
+  stock?: number;
+  trackInventory?: boolean;
+  status?: ProductStatus;
+  description?: string;
+  shortDescription?: string;
+  featuredImage?: string;
+  gallery?: ProductImage[];
+  variants?: ProductVariant[];
+  attributes?: Record<string, unknown>;
+  weight?: number;
+  categoryIds?: string[];
+  tagIds?: string[];
+  brandIds?: string[];
+}
+interface CreateDiscountInput {
+  title: string;
+  code: string;
+  discountType: DiscountType;
+  value: number;
+  minOrderAmount?: number;
+  maxDiscountAmount?: number;
+  maxUses?: number;
+  startDate?: string;
+  endDate?: string;
+  status?: DiscountStatus;
+  appliesToProductIds?: string[];
+  appliesToCategoryIds?: string[];
+}
+interface CartItemInput {
+  productId: string;
+  variantId?: string;
+  quantity: number;
+}
+interface CartCalculationInput {
+  items: CartItemInput[];
+  discountCode?: string;
+  shippingCost?: number;
+  taxRate?: number;
+}
+interface CartCalculationResult {
+  items: OrderLineItem[];
+  subtotal: number;
+  discountTotal: number;
+  discountCode?: string;
+  shippingTotal: number;
+  taxTotal: number;
+  total: number;
+  currency: string;
+}
+interface DiscountValidationResult {
+  valid: boolean;
+  code: string;
+  message?: string;
+  discountAmount: number;
+  discountType?: DiscountType;
+  discount?: DiscountItem;
+}
+interface CreateOrderInput {
+  customerEmail: string;
+  customerName?: string;
+  items: CartItemInput[];
+  discountCode?: string;
+  shippingCost?: number;
+  taxRate?: number;
+  shippingAddress?: OrderAddress;
+  billingAddress?: OrderAddress;
+  paymentMethod?: string;
+  notes?: string;
+}
+interface EcommerceProductQuery {
+  categorySlug?: string;
+  categoryId?: string;
+  tagSlug?: string;
+  brandSlug?: string;
+  minPrice?: number;
+  maxPrice?: number;
+  inStock?: boolean;
+  status?: ProductStatus | ProductStatus[];
+  search?: string;
+  orderBy?: "price" | "createdAt" | "title" | "stock";
+  orderDirection?: "asc" | "desc";
+  limit?: number;
+  offset?: number;
+}
+//#endregion
+//#region src/plugins/ecommerce/service.d.ts
+declare class EcommerceService {
+  readonly engine: CMSEngine;
+  readonly options: EcommercePluginOptions;
+  readonly productSlug: string;
+  readonly discountSlug: string;
+  readonly orderSlug: string;
+  readonly categoriesTaxonomy: string;
+  readonly tagsTaxonomy: string;
+  readonly brandsTaxonomy: string;
+  readonly defaultCurrency: string;
+  readonly inventoryManagement: boolean;
+  constructor(engine: CMSEngine, options?: EcommercePluginOptions);
+  private get productsCollection();
+  private get discountsCollection();
+  private get ordersCollection();
+  /**
+   * Create a new product in the catalog.
+   */
+  createProduct(input: CreateProductInput, authorId?: string | null): Promise<ProductItem>;
+  /**
+   * Update an existing product.
+   */
+  updateProduct(id: string, input: UpdateProductInput, authorId?: string | null): Promise<ProductItem | null>;
+  /**
+   * Get a product by ID.
+   */
+  getProduct(id: string): Promise<ProductItem | null>;
+  /**
+   * Get a product by its URL slug.
+   */
+  getProductBySlug(slug: string): Promise<ProductItem | null>;
+  /**
+   * Delete a product by ID.
+   */
+  deleteProduct(id: string): Promise<boolean>;
+  /**
+   * List and filter catalog products.
+   */
+  listProducts(query?: EcommerceProductQuery): Promise<PaginatedResult<ProductItem>>;
+  /**
+   * Upload and link a product image to its gallery and featured slot.
+   */
+  uploadProductImage(productId: string, file: {
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
+    url?: string;
+    altText?: string;
+    caption?: string;
+    width?: number;
+    height?: number;
+    isFeatured?: boolean;
+  }, authorId?: string | null): Promise<{
+    media: MediaItem;
+    product: ProductItem;
+  }>;
+  /**
+   * Adjust inventory stock for a product or variant.
+   */
+  adjustStock(productId: string, delta: number, variantId?: string): Promise<ProductItem | null>;
+  /**
+   * Create a catalog category in the hierarchical category taxonomy.
+   */
+  createCategory(input: {
+    name: string;
+    slug?: string;
+    parentId?: string | null;
+    description?: string;
+    meta?: Record<string, unknown>;
+  }): Promise<TermItem>;
+  /**
+   * Get all catalog categories.
+   */
+  getCategories(options?: {
+    parentId?: string | null;
+  }): Promise<TermItem[]>;
+  /**
+   * Get full hierarchical catalog category tree.
+   */
+  getCategoryTree(): Promise<TermTreeItem[]>;
+  /**
+   * Assign category IDs to a product.
+   */
+  assignProductCategory(productId: string, categoryIds: string | string[]): Promise<void>;
+  /**
+   * Get assigned categories for a product.
+   */
+  getProductCategories(productId: string): Promise<TermItem[]>;
+  /**
+   * Create a promotional coupon / discount code.
+   */
+  createDiscount(input: CreateDiscountInput, authorId?: string | null): Promise<DiscountItem>;
+  /**
+   * Find a discount code.
+   */
+  getDiscountByCode(code: string): Promise<DiscountItem | null>;
+  /**
+   * Validate a discount coupon against cart items and order subtotal.
+   */
+  validateDiscount(code: string, cartSubtotal: number, productIds?: string[]): Promise<DiscountValidationResult>;
+  /**
+   * Calculate cart subtotals, apply discounts, shipping, and taxes.
+   */
+  calculateCart(input: CartCalculationInput): Promise<CartCalculationResult>;
+  /**
+   * Place a new order with cart validation, inventory deduction, and coupon counter updates.
+   */
+  createOrder(input: CreateOrderInput, authorId?: string | null): Promise<OrderItem>;
+  /**
+   * Get order by ID.
+   */
+  getOrder(id: string): Promise<OrderItem | null>;
+  /**
+   * Get order by order number.
+   */
+  getOrderByNumber(orderNumber: string): Promise<OrderItem | null>;
+  /**
+   * Update the status of an order (e.g. pending -> paid -> shipped).
+   */
+  updateOrderStatus(id: string, status: OrderStatus, note?: string): Promise<OrderItem | null>;
+}
+//#endregion
+//#region src/plugins/ecommerce/schemas.d.ts
+/**
+ * Creates the collection configuration for Products.
+ */
+declare function createProductCollection(options?: EcommercePluginOptions): CollectionConfig;
+/**
+ * Creates the collection configuration for Discounts / Coupons.
+ */
+declare function createDiscountCollection(options?: EcommercePluginOptions): CollectionConfig;
+/**
+ * Creates the collection configuration for Orders.
+ */
+declare function createOrderCollection(options?: EcommercePluginOptions): CollectionConfig;
+/**
+ * Creates the standard e-commerce taxonomies: product categories, tags, and brands.
+ */
+declare function createEcommerceTaxonomies(options?: EcommercePluginOptions): TaxonomyConfig[];
+//#endregion
+//#region src/plugins/ecommerce/client.d.ts
+declare class EcommerceClient {
+  private client;
+  private options;
+  private service?;
+  private prefix;
+  constructor(client: CMSClient, options?: EcommercePluginOptions);
+  readonly products: {
+    find: (query?: EcommerceProductQuery) => Promise<PaginatedResult<ProductItem>>;
+    get: (idOrSlug: string, by?: "id" | "slug") => Promise<ProductItem | null>;
+    create: (data: CreateProductInput) => Promise<ProductItem>;
+    update: (id: string, data: UpdateProductInput) => Promise<ProductItem | null>;
+    delete: (id: string) => Promise<boolean>;
+    uploadImage: (productId: string, file: {
+      filename: string;
+      mimeType: string;
+      sizeBytes: number;
+      url?: string;
+      altText?: string;
+      caption?: string;
+      width?: number;
+      height?: number;
+      isFeatured?: boolean;
+    }) => Promise<{
+      media: MediaItem;
+      product: ProductItem;
+    }>;
+  };
+  readonly categories: {
+    list: (options?: {
+      parentId?: string | null;
+    }) => Promise<TermItem[]>;
+    tree: () => Promise<TermTreeItem[]>;
+    create: (input: {
+      name: string;
+      slug?: string;
+      parentId?: string | null;
+      description?: string;
+    }) => Promise<TermItem>;
+  };
+  readonly discounts: {
+    validate: (code: string, subtotal: number, productIds?: string[]) => Promise<DiscountValidationResult>;
+    create: (input: CreateDiscountInput) => Promise<DiscountItem>;
+  };
+  readonly cart: {
+    calculate: (input: CartCalculationInput) => Promise<CartCalculationResult>;
+  };
+  readonly orders: {
+    create: (input: CreateOrderInput) => Promise<OrderItem>;
+    get: (idOrNumber: string, by?: "id" | "number") => Promise<OrderItem | null>;
+    updateStatus: (id: string, status: OrderStatus, note?: string) => Promise<OrderItem | null>;
+  };
+}
+/**
+ * Get or create an EcommerceClient adapter for a CMSClient.
+ */
+declare function getEcommerceClient(client: CMSClient, options?: EcommercePluginOptions): EcommerceClient;
+//#endregion
+//#region src/plugins/ecommerce/index.d.ts
+/**
+ * Built-in E-commerce plugin factory for @azlib/cms.
+ * Equips the CMS engine with product catalogs, hierarchical categories,
+ * image uploading, discount coupons, cart calculation, and order tracking.
+ */
+declare const ecommercePlugin: (options?: void | EcommercePluginOptions | undefined) => CMSPlugin;
+/**
+ * Retrieve the active EcommerceService instance associated with a CMSEngine.
+ */
+declare function getEcommerceService(engine: CMSEngine, options?: EcommercePluginOptions): EcommerceService;
+//#endregion
+//#region src/plugins/hrms/types.d.ts
+type EmployerStatus = "active" | "inactive";
+interface EmployerWorkSchedule {
+  readonly startTime: string;
+  readonly endTime: string;
+  readonly standardHoursPerDay: number;
+  readonly gracePeriodMinutes?: number;
+  readonly workDays?: number[];
+}
+interface EmployerData extends Record<string, unknown> {
+  companyName: string;
+  legalName?: string;
+  taxId?: string;
+  email?: string;
+  phone?: string;
+  website?: string;
+  logo?: string;
+  address?: string | Record<string, unknown>;
+  timezone?: string;
+  workSchedule?: EmployerWorkSchedule;
+  status: EmployerStatus;
+}
+type EmployerItem = ContentItem<EmployerData>;
+type EmploymentType = "full_time" | "part_time" | "contractor" | "intern";
+type EmployeeStatus = "active" | "on_leave" | "terminated" | "suspended";
+interface EmployeeEmergencyContact {
+  readonly name: string;
+  readonly relationship: string;
+  readonly phone: string;
+  readonly email?: string;
+}
+interface EmployeeDocument {
+  readonly id?: string;
+  readonly title: string;
+  readonly fileUrl: string;
+  readonly category?: string;
+  readonly uploadedAt?: string;
+}
+interface EmployeeData extends Record<string, unknown> {
+  employerId: string;
+  userId?: string;
+  employeeNumber: string;
+  firstName: string;
+  lastName: string;
+  email: string;
+  phone?: string;
+  avatar?: string;
+  jobTitle?: string;
+  employmentType: EmploymentType;
+  status: EmployeeStatus;
+  hireDate: string;
+  terminationDate?: string;
+  managerId?: string;
+  emergencyContact?: EmployeeEmergencyContact;
+  documents?: EmployeeDocument[];
+  salary?: number;
+  notes?: string;
+}
+type EmployeeItem = ContentItem<EmployeeData>;
+type AttendanceStatus = "present" | "late" | "half_day" | "absent" | "on_leave";
+interface AttendanceData extends Record<string, unknown> {
+  employerId: string;
+  employeeId: string;
+  date: string;
+  checkInAt: string;
+  checkOutAt?: string;
+  totalHours?: number;
+  overtimeHours?: number;
+  status: AttendanceStatus;
+  location?: string;
+  notes?: string;
+}
+type AttendanceItem = ContentItem<AttendanceData>;
+interface LeaveTypeData extends Record<string, unknown> {
+  employerId?: string;
+  name: string;
+  code: string;
+  daysAllowedPerYear: number;
+  paid: boolean;
+  requiresApproval: boolean;
+  color?: string;
+  description?: string;
+}
+type LeaveTypeItem = ContentItem<LeaveTypeData>;
+type LeaveRequestStatus = "pending" | "approved" | "rejected" | "cancelled";
+interface LeaveRequestData extends Record<string, unknown> {
+  employerId: string;
+  employeeId: string;
+  leaveTypeId: string;
+  startDate: string;
+  endDate: string;
+  daysCount: number;
+  reason?: string;
+  status: LeaveRequestStatus;
+  approvedBy?: string;
+  approvedAt?: string;
+  rejectionReason?: string;
+}
+type LeaveRequestItem = ContentItem<LeaveRequestData>;
+interface LeaveBalanceItem {
+  readonly leaveTypeId: string;
+  readonly leaveTypeName: string;
+  readonly leaveTypeCode: string;
+  readonly allocatedDays: number;
+  readonly usedDays: number;
+  readonly pendingDays: number;
+  readonly remainingDays: number;
+}
+interface EmployeeLeaveBalanceReport {
+  readonly employeeId: string;
+  readonly year: number;
+  readonly balances: readonly LeaveBalanceItem[];
+  readonly totalAllocated: number;
+  readonly totalUsed: number;
+  readonly totalRemaining: number;
+}
+interface CreateEmployerInput {
+  companyName: string;
+  legalName?: string;
+  taxId?: string;
+  email?: string;
+  phone?: string;
+  website?: string;
+  logo?: string;
+  address?: string | Record<string, unknown>;
+  timezone?: string;
+  workSchedule?: EmployerWorkSchedule;
+  status?: EmployerStatus;
+}
+interface UpdateEmployerInput {
+  companyName?: string;
+  legalName?: string;
+  taxId?: string;
+  email?: string;
+  phone?: string;
+  website?: string;
+  logo?: string;
+  address?: string | Record<string, unknown>;
+  timezone?: string;
+  workSchedule?: EmployerWorkSchedule;
+  status?: EmployerStatus;
+}
+interface CreateEmployeeInput {
+  employerId: string;
+  userId?: string;
+  employeeNumber: string;
+  firstName: string;
+  lastName: string;
+  email: string;
+  phone?: string;
+  avatar?: string;
+  jobTitle?: string;
+  departmentSlug?: string;
+  employmentType?: EmploymentType;
+  status?: EmployeeStatus;
+  hireDate: string;
+  managerId?: string;
+  emergencyContact?: EmployeeEmergencyContact;
+  documents?: EmployeeDocument[];
+  salary?: number;
+  notes?: string;
+}
+interface UpdateEmployeeInput {
+  employerId?: string;
+  userId?: string;
+  employeeNumber?: string;
+  firstName?: string;
+  lastName?: string;
+  email?: string;
+  phone?: string;
+  avatar?: string;
+  jobTitle?: string;
+  departmentSlug?: string;
+  employmentType?: EmploymentType;
+  status?: EmployeeStatus;
+  hireDate?: string;
+  terminationDate?: string;
+  managerId?: string;
+  emergencyContact?: EmployeeEmergencyContact;
+  documents?: EmployeeDocument[];
+  salary?: number;
+  notes?: string;
+}
+interface CheckInInput {
+  employeeId: string;
+  timestamp?: string | Date;
+  location?: string;
+  notes?: string;
+}
+interface CheckOutInput {
+  employeeId: string;
+  timestamp?: string | Date;
+  location?: string;
+  notes?: string;
+}
+interface RecordAttendanceManualInput {
+  employerId: string;
+  employeeId: string;
+  date: string;
+  checkInAt: string;
+  checkOutAt?: string;
+  totalHours?: number;
+  overtimeHours?: number;
+  status?: AttendanceStatus;
+  location?: string;
+  notes?: string;
+}
+interface CreateLeaveTypeInput {
+  employerId?: string;
+  name: string;
+  code: string;
+  daysAllowedPerYear: number;
+  paid?: boolean;
+  requiresApproval?: boolean;
+  color?: string;
+  description?: string;
+}
+interface CreateLeaveRequestInput {
+  employerId?: string;
+  employeeId: string;
+  leaveTypeId: string;
+  startDate: string;
+  endDate: string;
+  daysCount?: number;
+  reason?: string;
+}
+interface ApproveLeaveInput {
+  requestId: string;
+  approverId: string;
+}
+interface RejectLeaveInput {
+  requestId: string;
+  approverId: string;
+  reason?: string;
+}
+interface HRMSEmployeeQuery {
+  employerId?: string;
+  department?: string;
+  employmentType?: EmploymentType;
+  status?: EmployeeStatus;
+  search?: string;
+  page?: number;
+  limit?: number;
+}
+interface HRMSAttendanceQuery {
+  employerId?: string;
+  employeeId?: string;
+  date?: string;
+  startDate?: string;
+  endDate?: string;
+  status?: AttendanceStatus;
+  page?: number;
+  limit?: number;
+}
+interface HRMSLeaveQuery {
+  employerId?: string;
+  employeeId?: string;
+  leaveTypeId?: string;
+  status?: LeaveRequestStatus;
+  year?: number;
+  page?: number;
+  limit?: number;
+}
+interface HRMSPluginOptions {
+  employerCollectionSlug?: string;
+  employeeCollectionSlug?: string;
+  attendanceCollectionSlug?: string;
+  leaveTypeCollectionSlug?: string;
+  leaveRequestCollectionSlug?: string;
+  departmentsTaxonomySlug?: string;
+  designationsTaxonomySlug?: string;
+  apiPrefix?: string;
+  standardWorkDayHours?: number;
+  workScheduleStart?: string;
+  workScheduleEnd?: string;
+  gracePeriodMinutes?: number;
+  enableEmployers?: boolean;
+  enableAttendance?: boolean;
+  enableLeaves?: boolean;
+}
+//#endregion
+//#region src/plugins/hrms/service.d.ts
+declare class HRMSService {
+  readonly engine: CMSEngine;
+  readonly options: HRMSPluginOptions;
+  readonly employerSlug: string;
+  readonly employeeSlug: string;
+  readonly attendanceSlug: string;
+  readonly leaveTypeSlug: string;
+  readonly leaveRequestSlug: string;
+  readonly departmentsTaxonomy: string;
+  readonly designationsTaxonomy: string;
+  readonly standardWorkDayHours: number;
+  readonly workScheduleStart: string;
+  readonly workScheduleEnd: string;
+  readonly gracePeriodMinutes: number;
+  constructor(engine: CMSEngine, options?: HRMSPluginOptions);
+  private get employersCollection();
+  private get employeesCollection();
+  private get attendanceCollection();
+  private get leaveTypesCollection();
+  private get leaveRequestsCollection();
+  createEmployer(input: CreateEmployerInput, authorId?: string | null): Promise<EmployerItem>;
+  getEmployer(id: string): Promise<EmployerItem | null>;
+  getEmployerBySlug(slug: string): Promise<EmployerItem | null>;
+  updateEmployer(id: string, input: UpdateEmployerInput, authorId?: string | null): Promise<EmployerItem | null>;
+  listEmployers(query?: {
+    status?: "active" | "inactive";
+    page?: number;
+    limit?: number;
+  }): Promise<PaginatedResult<EmployerItem>>;
+  createEmployee(input: CreateEmployeeInput, authorId?: string | null): Promise<EmployeeItem>;
+  getEmployee(id: string): Promise<EmployeeItem | null>;
+  getEmployeeByNumber(employerId: string, employeeNumber: string): Promise<EmployeeItem | null>;
+  updateEmployee(id: string, input: UpdateEmployeeInput, authorId?: string | null): Promise<EmployeeItem | null>;
+  deleteEmployee(id: string): Promise<boolean>;
+  listEmployees(query?: HRMSEmployeeQuery): Promise<PaginatedResult<EmployeeItem>>;
+  getDirectReports(managerId: string): Promise<EmployeeItem[]>;
+  private parseTimeToMinutes;
+  private formatDateString;
+  private getHoursAndMinutes;
+  /**
+   * Check in an employee for today (or specified timestamp).
+   */
+  checkIn(input: CheckInInput): Promise<AttendanceItem>;
+  /**
+   * Check out an employee for today (or specified timestamp).
+   */
+  checkOut(input: CheckOutInput): Promise<AttendanceItem>;
+  getDailyAttendance(employeeId: string, date: string): Promise<AttendanceItem | null>;
+  recordAttendanceManual(input: RecordAttendanceManualInput): Promise<AttendanceItem>;
+  listAttendance(query?: HRMSAttendanceQuery): Promise<PaginatedResult<AttendanceItem>>;
+  createLeaveType(input: CreateLeaveTypeInput, authorId?: string | null): Promise<LeaveTypeItem>;
+  getLeaveType(id: string): Promise<LeaveTypeItem | null>;
+  listLeaveTypes(employerId?: string): Promise<LeaveTypeItem[]>;
+  /**
+   * Calculate leave balance report for an employee for a given year.
+   */
+  calculateLeaveBalance(employeeId: string, year?: number): Promise<EmployeeLeaveBalanceReport>;
+  /**
+   * Submit a new leave request.
+   */
+  requestLeave(input: CreateLeaveRequestInput, authorId?: string | null): Promise<LeaveRequestItem>;
+  /**
+   * Approve a pending leave request.
+   */
+  approveLeave(input: ApproveLeaveInput): Promise<LeaveRequestItem>;
+  /**
+   * Reject a pending leave request.
+   */
+  rejectLeave(input: RejectLeaveInput): Promise<LeaveRequestItem>;
+  /**
+   * Cancel a leave request.
+   */
+  cancelLeave(requestId: string): Promise<LeaveRequestItem>;
+  listLeaveRequests(query?: HRMSLeaveQuery): Promise<PaginatedResult<LeaveRequestItem>>;
+}
+//#endregion
+//#region src/plugins/hrms/schemas.d.ts
+/**
+ * Creates the collection configuration for Employers (Organizations / Companies).
+ */
+declare function createEmployerCollection(options?: HRMSPluginOptions): CollectionConfig;
+/**
+ * Creates the collection configuration for Employees.
+ */
+declare function createEmployeeCollection(options?: HRMSPluginOptions): CollectionConfig;
+/**
+ * Creates the collection configuration for Daily Attendance.
+ */
+declare function createAttendanceCollection(options?: HRMSPluginOptions): CollectionConfig;
+/**
+ * Creates the collection configuration for Leave Types.
+ */
+declare function createLeaveTypeCollection(options?: HRMSPluginOptions): CollectionConfig;
+/**
+ * Creates the collection configuration for Leave Requests.
+ */
+declare function createLeaveRequestCollection(options?: HRMSPluginOptions): CollectionConfig;
+/**
+ * Creates the standard HRMS taxonomies: departments and designations.
+ */
+declare function createHRMSTaxonomies(options?: HRMSPluginOptions): TaxonomyConfig[];
+//#endregion
+//#region src/plugins/hrms/client.d.ts
+declare class HRMSClient {
+  private client;
+  private options;
+  private service?;
+  private prefix;
+  constructor(client: CMSClient, options?: HRMSPluginOptions);
+  readonly employers: {
+    find: (query?: {
+      status?: "active" | "inactive";
+      page?: number;
+      limit?: number;
+    }) => Promise<PaginatedResult<EmployerItem>>;
+    get: (id: string) => Promise<EmployerItem | null>;
+    create: (input: CreateEmployerInput) => Promise<EmployerItem>;
+    update: (id: string, input: UpdateEmployerInput) => Promise<EmployerItem | null>;
+  };
+  readonly employees: {
+    find: (query?: HRMSEmployeeQuery) => Promise<PaginatedResult<EmployeeItem>>;
+    get: (id: string) => Promise<EmployeeItem | null>;
+    getByNumber: (employerId: string, employeeNumber: string) => Promise<EmployeeItem | null>;
+    create: (input: CreateEmployeeInput) => Promise<EmployeeItem>;
+    update: (id: string, input: UpdateEmployeeInput) => Promise<EmployeeItem | null>;
+    delete: (id: string) => Promise<boolean>;
+    getLeaveBalance: (employeeId: string, year?: number) => Promise<EmployeeLeaveBalanceReport>;
+    getDirectReports: (managerId: string) => Promise<EmployeeItem[]>;
+  };
+  readonly attendance: {
+    checkIn: (input: CheckInInput) => Promise<AttendanceItem>;
+    checkOut: (input: CheckOutInput) => Promise<AttendanceItem>;
+    getDaily: (employeeId: string, date: string) => Promise<AttendanceItem | null>;
+    find: (query?: HRMSAttendanceQuery) => Promise<PaginatedResult<AttendanceItem>>;
+    recordManual: (input: RecordAttendanceManualInput) => Promise<AttendanceItem>;
+  };
+  readonly leaves: {
+    listTypes: (employerId?: string) => Promise<LeaveTypeItem[]>;
+    createType: (input: CreateLeaveTypeInput) => Promise<LeaveTypeItem>;
+    getType: (id: string) => Promise<LeaveTypeItem | null>;
+    findRequests: (query?: HRMSLeaveQuery) => Promise<PaginatedResult<LeaveRequestItem>>;
+    request: (input: CreateLeaveRequestInput) => Promise<LeaveRequestItem>;
+    approve: (input: ApproveLeaveInput) => Promise<LeaveRequestItem>;
+    reject: (input: RejectLeaveInput) => Promise<LeaveRequestItem>;
+    cancel: (requestId: string) => Promise<LeaveRequestItem>;
+  };
+}
+/**
+ * Get or create an HRMSClient adapter for a CMSClient.
+ */
+declare function getHRMSClient(client: CMSClient, options?: HRMSPluginOptions): HRMSClient;
+//#endregion
+//#region src/plugins/hrms/index.d.ts
+/**
+ * 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.
+ */
+declare const hrmsPlugin: (options?: void | HRMSPluginOptions | undefined) => CMSPlugin;
+/**
+ * Retrieve the active HRMSService instance associated with a CMSEngine.
+ */
+declare function getHRMSService(engine: CMSEngine, options?: HRMSPluginOptions): HRMSService;
+//#endregion
+export { type ActionCallback, ApproveLeaveInput, AttendanceData, AttendanceItem, AttendanceStatus, type BooleanFieldOptions, CMSCapability, CMSClient, type CMSClientOptions, CMSConfig, CMSEngine, type CMSPlugin, type CMSPluginContext, CMSRouter, type CMSStorageAdapter, CMSUser, CartCalculationInput, CartCalculationResult, CartItemInput, CheckInInput, CheckOutInput, type ClientCollectionApi, CollectionConfig, type CollectionOptions, type CollectionService, ContentItem, ContentLifecycle, ContentQueryOptions, ContentStatus, type CreateContentInput, CreateDiscountInput, CreateEmployeeInput, CreateEmployerInput, CreateLeaveRequestInput, CreateLeaveTypeInput, CreateOrderInput, CreateProductInput, type CustomRouteHandler, DEFAULT_COLLECTIONS, DEFAULT_ROLE_CAPABILITIES, type DateFieldOptions, DiscountData, DiscountItem, DiscountStatus, DiscountType, DiscountValidationResult, EcommerceClient, EcommercePluginOptions, EcommerceProductQuery, EcommerceService, EmployeeData, EmployeeDocument, EmployeeEmergencyContact, EmployeeItem, EmployeeLeaveBalanceReport, EmployeeStatus, EmployerData, EmployerItem, EmployerStatus, EmployerWorkSchedule, EmploymentType, FieldDefinition, FieldType, type FilterCallback, HRMSAttendanceQuery, HRMSClient, HRMSEmployeeQuery, HRMSLeaveQuery, HRMSPluginOptions, HRMSService, type HookEntry, HooksManager, type ImageFieldOptions, type JsonFieldOptions, LeaveBalanceItem, LeaveRequestData, LeaveRequestItem, LeaveRequestStatus, LeaveTypeData, LeaveTypeItem, MediaItem, MediaManager, type MediaUploadInput, MemoryStorageAdapter, type NumberFieldOptions, OptionItem, OptionsManager, OrderAddress, OrderData, OrderItem, OrderLineItem, OrderStatus, PaginatedResult, ProductData, ProductImage, ProductItem, ProductStatus, ProductVariant, RBACManager, RecordAttendanceManualInput, RejectLeaveInput, type RelationshipFieldOptions, type RepeaterFieldOptions, RevisionDiff, RevisionDiffField, RevisionManager, RevisionRecord, type RichTextFieldOptions, type RouteContext, type SelectFieldOptions, SelectOption, SiteConfig, type SlugFieldOptions, type SyncFilterCallback, TaxonomyConfig, type TaxonomyFieldOptions, TaxonomyManager, TermItem, TermTreeItem, type TextFieldOptions, type UpdateContentInput, UpdateEmployeeInput, UpdateEmployerInput, UpdateProductInput, UserRole, VALID_STATUS_TRANSITIONS, collection, createAttendanceCollection, createCMSEngine, createCMSRouter, createCmsClient, createDiscountCollection, createEcommerceTaxonomies, createEmployeeCollection, createEmployerCollection, createHRMSTaxonomies, createLeaveRequestCollection, createLeaveTypeCollection, createOrderCollection, createProductCollection, defaultHooks, defineConfig, definePlugin, ecommercePlugin, fields, getEcommerceClient, getEcommerceService, getHRMSClient, getHRMSService, hrmsPlugin, normalizeConfig, resolveUniqueSlug, slugify, validateAndNormalizeData };
 //# sourceMappingURL=index.d.cts.map