@azlib/cms 0.4.0 → 0.6.0

package/dist/index.d.cts

@@ -1449,5 +1449,889 @@ declare const ecommercePlugin: (options?: void | EcommercePluginOptions | undefi
  */
 declare function getEcommerceService(engine: CMSEngine, options?: EcommercePluginOptions): EcommerceService;
 //#endregion
-export { type ActionCallback, type BooleanFieldOptions, CMSCapability, CMSClient, type CMSClientOptions, CMSConfig, CMSEngine, type CMSPlugin, type CMSPluginContext, CMSRouter, type CMSStorageAdapter, CMSUser, CartCalculationInput, CartCalculationResult, CartItemInput, type ClientCollectionApi, CollectionConfig, type CollectionOptions, type CollectionService, ContentItem, ContentLifecycle, ContentQueryOptions, ContentStatus, type CreateContentInput, CreateDiscountInput, CreateOrderInput, CreateProductInput, type CustomRouteHandler, DEFAULT_COLLECTIONS, DEFAULT_ROLE_CAPABILITIES, type DateFieldOptions, DiscountData, DiscountItem, DiscountStatus, DiscountType, DiscountValidationResult, EcommerceClient, EcommercePluginOptions, EcommerceProductQuery, EcommerceService, FieldDefinition, FieldType, type FilterCallback, type HookEntry, HooksManager, type ImageFieldOptions, type JsonFieldOptions, MediaItem, MediaManager, type MediaUploadInput, MemoryStorageAdapter, type NumberFieldOptions, OptionItem, OptionsManager, OrderAddress, OrderData, OrderItem, OrderLineItem, OrderStatus, PaginatedResult, ProductData, ProductImage, ProductItem, ProductStatus, ProductVariant, 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, UpdateProductInput, UserRole, VALID_STATUS_TRANSITIONS, collection, createCMSEngine, createCMSRouter, createCmsClient, createDiscountCollection, createEcommerceTaxonomies, createOrderCollection, createProductCollection, defaultHooks, defineConfig, definePlugin, ecommercePlugin, fields, getEcommerceClient, getEcommerceService, normalizeConfig, resolveUniqueSlug, slugify, validateAndNormalizeData };
+//#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
+//#region src/plugins/transfer/types.d.ts
+type SourceFormat = "json" | "excel" | "csv";
+type InferredFieldType = "string" | "number" | "boolean" | "date" | "object" | "array" | "unknown";
+interface SourceFieldSchema {
+  name: string;
+  inferredType: InferredFieldType;
+  sampleValues: unknown[];
+  nullCount: number;
+  totalCount: number;
+}
+interface CollectionFieldSummary {
+  name: string;
+  label: string;
+  type: string;
+  required: boolean;
+  unique?: boolean;
+  description?: string;
+  defaultValue?: unknown;
+  targetCollection?: string;
+  options?: readonly (string | {
+    label: string;
+    value: string | number;
+  })[];
+}
+interface CollectionSchemaSummary {
+  slug: string;
+  label: string;
+  singularLabel: string;
+  description?: string;
+  fields: CollectionFieldSummary[];
+  taxonomies: readonly string[];
+}
+interface SuggestedMappingRule {
+  sourceField: string;
+  targetField: string;
+  confidence: number;
+}
+interface SourceInspectionResult {
+  format: SourceFormat;
+  sheets?: string[];
+  selectedSheet?: string;
+  totalRows: number;
+  sourceFields: SourceFieldSchema[];
+  targetSchema?: CollectionSchemaSummary;
+  suggestedMapping?: SuggestedMappingRule[];
+  previewRows: Record<string, unknown>[];
+}
+type FieldTransformPreset = "trim" | "lowercase" | "uppercase" | "number" | "boolean" | "date" | "json" | "slug" | "split_comma" | "identity";
+type FieldTransformFn = (value: unknown, record: Record<string, unknown>) => unknown;
+interface FieldMappingRule {
+  /** Column / property name in source data */
+  sourceField: string;
+  /** Field name in target CMS collection */
+  targetField: string;
+  /** Transformation preset or custom transform callback */
+  transform?: FieldTransformPreset | FieldTransformFn;
+  /** Default fallback value if source value is null, undefined, or empty string */
+  defaultValue?: unknown;
+  /** If true, this field must be present and valid */
+  required?: boolean;
+}
+interface MappingOptions {
+  /** Strip/ignore source fields that are not explicitly mapped (default: true) */
+  ignoreUnmappedFields?: boolean;
+  /** Default content item status: 'draft' | 'published' | 'archived' */
+  defaultStatus?: "draft" | "published" | "archived";
+  /** Mapped field that supplies status value */
+  statusField?: string;
+  /** Auto generate unique slug from title if no slug is mapped (default: true) */
+  autoGenerateSlug?: boolean;
+  /** Worksheet name for multi-sheet Excel files */
+  sheetName?: string;
+  /** Date format parsing hint */
+  dateFormat?: string;
+  /** Action when duplicate unique field is encountered */
+  onDuplicate?: "error" | "update" | "skip";
+  /** Key field to identify existing record when updating (defaults to id, slug, or unique field) */
+  uniqueIdentifierField?: string;
+  /** Abort entire import on first error (default: false) */
+  abortOnError?: boolean;
+}
+interface DataMappingDefinition {
+  id?: string;
+  name?: string;
+  collectionSlug: string;
+  fields: FieldMappingRule[];
+  options?: MappingOptions;
+}
+type TransferErrorCode = "REQUIRED_FIELD_MISSING" | "INVALID_DATA_TYPE" | "INVALID_SELECT_OPTION" | "CONSTRAINT_UNIQUE_VIOLATION" | "CONSTRAINT_FOREIGN_KEY_VIOLATION" | "VALIDATION_RULE_FAILED" | "TRANSFORM_ERROR" | "PARSE_ERROR";
+interface TransferErrorDetail {
+  rowNumber: number;
+  field?: string;
+  value?: unknown;
+  code: TransferErrorCode;
+  reason: string;
+}
+interface ValidationPreviewRow {
+  rowNumber: number;
+  raw: Record<string, unknown>;
+  mapped: Record<string, unknown>;
+  valid: boolean;
+  errors?: TransferErrorDetail[];
+}
+interface ValidationResult {
+  valid: boolean;
+  totalRows: number;
+  validCount: number;
+  errorCount: number;
+  errors: TransferErrorDetail[];
+  previewRows: ValidationPreviewRow[];
+}
+interface TransferImportOptions {
+  onDuplicate?: "error" | "update" | "skip";
+  uniqueIdentifierField?: string;
+  abortOnError?: boolean;
+  authorId?: string | null;
+  revisionNote?: string;
+  dryRun?: boolean;
+}
+interface TransferImportResult {
+  success: boolean;
+  collectionSlug: string;
+  totalRows: number;
+  importedCount: number;
+  updatedCount: number;
+  skippedCount: number;
+  failedCount: number;
+  createdIds: string[];
+  updatedIds: string[];
+  errors: TransferErrorDetail[];
+}
+interface TransferExportOptions {
+  collectionSlug?: string;
+  format?: SourceFormat;
+  mapping?: DataMappingDefinition;
+  fields?: string[];
+  query?: ContentQueryOptions;
+  fileName?: string;
+  sheetName?: string;
+  includeId?: boolean;
+  includeTimestamps?: boolean;
+}
+interface TransferExportResult {
+  format: SourceFormat;
+  data: Uint8Array | string;
+  mimeType: string;
+  fileName: string;
+  totalRecords: number;
+}
+interface TransferPluginOptions {
+  apiPrefix?: string;
+  maxBatchSize?: number;
+  enableRoutes?: boolean;
+}
+//#endregion
+//#region src/plugins/transfer/parsers/json.d.ts
+/**
+ * @azlib/cms - Universal JSON Data Parser
+ */
+declare function parseJsonSource(input: string | Uint8Array | Buffer | unknown): Record<string, unknown>[];
+//#endregion
+//#region src/plugins/transfer/parsers/csv.d.ts
+/**
+ * @azlib/cms - Universal RFC 4180 CSV Data Parser
+ */
+declare function parseCsvSource(input: string | Uint8Array | Buffer): Record<string, unknown>[];
+//#endregion
+//#region src/plugins/transfer/parsers/excel.d.ts
+/**
+ * @azlib/cms - Universal Excel (.xlsx) Data Parser using ExcelJS
+ */
+interface ParseExcelResult {
+  sheets: string[];
+  selectedSheet: string;
+  records: Record<string, unknown>[];
+}
+declare function parseExcelSource(input: Buffer | Uint8Array | ArrayBuffer, options?: {
+  sheetName?: string;
+}): Promise<ParseExcelResult>;
+//#endregion
+//#region src/plugins/transfer/parsers/index.d.ts
+interface ParseSourceOptions {
+  format?: SourceFormat;
+  fileName?: string;
+  sheetName?: string;
+}
+interface ParsedSourceResult {
+  format: SourceFormat;
+  sheets?: string[];
+  selectedSheet?: string;
+  records: Record<string, unknown>[];
+}
+/**
+ * Detect the format of an input payload if not explicitly provided.
+ */
+declare function detectFormat(input: unknown, fileName?: string): SourceFormat;
+/**
+ * Universal source parser that handles JSON, CSV, and Excel (.xlsx).
+ */
+declare function parseSource(input: unknown, options?: ParseSourceOptions): Promise<ParsedSourceResult>;
+//#endregion
+//#region src/plugins/transfer/service.d.ts
+declare class TransferService {
+  readonly engine: CMSEngine;
+  readonly options: TransferPluginOptions;
+  private presets;
+  constructor(engine: CMSEngine, options?: TransferPluginOptions);
+  /**
+   * List all registered collections across all active plugins in the engine.
+   */
+  listCollections(): CollectionSchemaSummary[];
+  /**
+   * Get the collection schema summary for a specific collection slug.
+   */
+  getCollectionSchema(collectionSlug: string): CollectionSchemaSummary;
+  /**
+   * Register a reusable data mapping preset.
+   */
+  registerPreset(preset: DataMappingDefinition): void;
+  /**
+   * Get a registered preset by ID.
+   */
+  getPreset(id: string): DataMappingDefinition | undefined;
+  /**
+   * Get all registered presets, optionally filtered by target collection.
+   */
+  getPresets(collectionSlug?: string): DataMappingDefinition[];
+  /**
+   * Generate a 1:1 default mapping template for any collection.
+   */
+  getMappingTemplate(collectionSlug: string): DataMappingDefinition;
+  /**
+   * Inspect any source payload or file (JSON, Excel, CSV) to extract headers,
+   * infer data types, and generate auto-mapping suggestions against a target collection.
+   */
+  inspectSource(input: unknown, options?: ParseSourceOptions & {
+    collectionSlug?: string;
+    previewLimit?: number;
+  }): Promise<SourceInspectionResult>;
+  /**
+   * Dry-run validation of a source batch against a target collection's schema
+   * and live database constraints without committing any changes.
+   */
+  validateImport(collectionSlug: string, input: unknown, mapping?: DataMappingDefinition, options?: ParseSourceOptions & {
+    onDuplicate?: "error" | "update" | "skip";
+    previewLimit?: number;
+  }): Promise<ValidationResult>;
+  /**
+   * Execute an import batch from raw data or an external file (JSON, Excel, CSV)
+   * into a target CMS collection.
+   */
+  importData(collectionSlug: string, input: unknown, mapping?: DataMappingDefinition, options?: TransferImportOptions & ParseSourceOptions): Promise<TransferImportResult>;
+  /**
+   * Export CMS collection records to JSON, Excel (.xlsx), or CSV.
+   */
+  exportData(collectionSlug: string, options?: TransferExportOptions): Promise<TransferExportResult>;
+  private getCollectionConfigOrThrow;
+  private detectUniqueField;
+}
+//#endregion
+//#region src/plugins/transfer/client.d.ts
+declare class TransferClient {
+  private client;
+  private options;
+  private service?;
+  private prefix;
+  constructor(client: CMSClient, options?: TransferPluginOptions);
+  /**
+   * List all registered collections across all active plugins.
+   */
+  listCollections(): Promise<CollectionSchemaSummary[]>;
+  /**
+   * Get the collection schema and default mapping template.
+   */
+  getSchema(collectionSlug: string): Promise<{
+    schema: CollectionSchemaSummary;
+    template: DataMappingDefinition;
+  }>;
+  /**
+   * Inspect a source file or payload.
+   */
+  inspect(data: unknown, options?: {
+    collectionSlug?: string;
+    format?: SourceFormat;
+    fileName?: string;
+    sheetName?: string;
+  }): Promise<SourceInspectionResult>;
+  /**
+   * Dry-run validation of a source batch against a target collection and database constraints.
+   */
+  preview(collectionSlug: string, data: unknown, mapping?: DataMappingDefinition, options?: {
+    format?: SourceFormat;
+    fileName?: string;
+    sheetName?: string;
+    onDuplicate?: "error" | "update" | "skip";
+  }): Promise<ValidationResult>;
+  /**
+   * Execute an import batch into a target collection.
+   */
+  import(collectionSlug: string, data: unknown, mapping?: DataMappingDefinition, options?: TransferImportOptions & {
+    format?: SourceFormat;
+    fileName?: string;
+    sheetName?: string;
+  }): Promise<TransferImportResult>;
+  /**
+   * Export collection records to JSON, Excel, or CSV.
+   */
+  export(collectionSlug: string, options?: TransferExportOptions): Promise<TransferExportResult>;
+}
+/**
+ * Access or instantiate the TransferClient associated with a CMSClient instance.
+ */
+declare function getTransferClient(client: CMSClient, options?: TransferPluginOptions): TransferClient;
+//#endregion
+//#region src/plugins/transfer/mapping.d.ts
+/**
+ * Apply a mapping definition to transform an external raw record into a CMS content payload.
+ */
+declare function mapSourceRecord(rawRecord: Record<string, unknown>, mapping: DataMappingDefinition): {
+  data: Record<string, unknown>;
+  title?: string;
+  slug?: string;
+  status?: string;
+};
+/**
+ * Applies transform preset or custom function to a field value.
+ */
+declare function applyFieldTransform(rule: FieldMappingRule, value: unknown, rawRecord: Record<string, unknown>): unknown;
+/**
+ * Reverse mapping for export: transforms a CMS ContentItem into an external export record.
+ */
+declare function mapCmsItemForExport(item: ContentItem<Record<string, unknown>>, mapping?: DataMappingDefinition, options?: {
+  includeId?: boolean;
+  includeTimestamps?: boolean;
+}): Record<string, unknown>;
+//#endregion
+//#region src/plugins/transfer/inspect.d.ts
+interface InspectOptions extends ParseSourceOptions {
+  collectionConfig?: CollectionConfig;
+  previewLimit?: number;
+}
+/**
+ * Inspect an uploaded source file or payload to discover its schema,
+ * infer column types, and generate auto-mapping suggestions against a target collection.
+ */
+declare function inspectSource(input: unknown, options?: InspectOptions): Promise<SourceInspectionResult>;
+/**
+ * Summarize a CMS CollectionConfig into consumer-friendly schema details.
+ */
+declare function summarizeCollection(config: CollectionConfig): CollectionSchemaSummary;
+/**
+ * Generates intelligent auto-mapping suggestions matching source headers to CMS fields.
+ */
+declare function generateSuggestedMapping(sourceHeaders: string[], targetSchema: CollectionSchemaSummary): SuggestedMappingRule[];
+//#endregion
+//#region src/plugins/transfer/validator.d.ts
+interface ValidateTransferOptions {
+  storage?: CMSStorageAdapter;
+  onDuplicate?: "error" | "update" | "skip";
+  previewLimit?: number;
+}
+/**
+ * Validates a batch of source records against a target CMS collection configuration
+ * and live database constraints.
+ */
+declare function validateTransferBatch(rawRecords: Record<string, unknown>[], mapping: DataMappingDefinition, collectionConfig: CollectionConfig, options?: ValidateTransferOptions): Promise<ValidationResult>;
+//#endregion
+//#region src/plugins/transfer/serializers/json.d.ts
+/**
+ * @azlib/cms - Universal JSON Serializer
+ */
+interface SerializeJsonOptions {
+  pretty?: boolean;
+}
+declare function serializeJson(records: Record<string, unknown>[], options?: SerializeJsonOptions): string;
+//#endregion
+//#region src/plugins/transfer/serializers/csv.d.ts
+/**
+ * @azlib/cms - Universal RFC 4180 CSV Serializer
+ */
+interface SerializeCsvOptions {
+  columns?: {
+    key: string;
+    header: string;
+  }[];
+}
+declare function serializeCsv(records: Record<string, unknown>[], options?: SerializeCsvOptions): string;
+//#endregion
+//#region src/plugins/transfer/serializers/excel.d.ts
+/**
+ * @azlib/cms - Universal Excel (.xlsx) Serializer using ExcelJS
+ */
+interface SerializeExcelOptions {
+  sheetName?: string;
+  columns?: {
+    key: string;
+    header: string;
+    width?: number;
+  }[];
+}
+declare function serializeExcel(records: Record<string, unknown>[], options?: SerializeExcelOptions): Promise<Uint8Array>;
+//#endregion
+//#region src/plugins/transfer/serializers/index.d.ts
+interface SerializeSourceOptions {
+  format?: SourceFormat;
+  fileName?: string;
+  sheetName?: string;
+  columns?: {
+    key: string;
+    header: string;
+    width?: number;
+  }[];
+}
+declare function serializeSource(records: Record<string, unknown>[], options?: SerializeSourceOptions): Promise<TransferExportResult>;
+//#endregion
+//#region src/plugins/transfer/presets/hrms.d.ts
+/**
+ * Preconfigured mapping definition for importing and exporting HRMS Employers.
+ */
+declare const HRMS_EMPLOYER_TRANSFER_PRESET: DataMappingDefinition;
+/**
+ * Preconfigured mapping definition for importing and exporting HRMS Employees.
+ */
+declare const HRMS_EMPLOYEE_TRANSFER_PRESET: DataMappingDefinition;
+//#endregion
+//#region src/plugins/transfer/index.d.ts
+/**
+ * Built-in Universal Data Transfer plugin factory for @azlib/cms.
+ * Equips the CMS engine with dynamic, schema-driven import and export capabilities
+ * across all collections, featuring file schema discovery, definition mapping,
+ * multi-level data validation, database constraint verification, and multi-format support.
+ */
+declare const transferPlugin: (options?: void | TransferPluginOptions | undefined) => CMSPlugin;
+/**
+ * Retrieve the active TransferService instance associated with a CMSEngine.
+ */
+declare function getTransferService(engine: CMSEngine, options?: TransferPluginOptions): TransferService;
+//#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, CollectionFieldSummary, type CollectionOptions, CollectionSchemaSummary, type CollectionService, ContentItem, ContentLifecycle, ContentQueryOptions, ContentStatus, type CreateContentInput, CreateDiscountInput, CreateEmployeeInput, CreateEmployerInput, CreateLeaveRequestInput, CreateLeaveTypeInput, CreateOrderInput, CreateProductInput, type CustomRouteHandler, DEFAULT_COLLECTIONS, DEFAULT_ROLE_CAPABILITIES, DataMappingDefinition, type DateFieldOptions, DiscountData, DiscountItem, DiscountStatus, DiscountType, DiscountValidationResult, EcommerceClient, EcommercePluginOptions, EcommerceProductQuery, EcommerceService, EmployeeData, EmployeeDocument, EmployeeEmergencyContact, EmployeeItem, EmployeeLeaveBalanceReport, EmployeeStatus, EmployerData, EmployerItem, EmployerStatus, EmployerWorkSchedule, EmploymentType, FieldDefinition, FieldMappingRule, FieldTransformFn, FieldTransformPreset, FieldType, type FilterCallback, HRMSAttendanceQuery, HRMSClient, HRMSEmployeeQuery, HRMSLeaveQuery, HRMSPluginOptions, HRMSService, HRMS_EMPLOYEE_TRANSFER_PRESET, HRMS_EMPLOYER_TRANSFER_PRESET, type HookEntry, HooksManager, type ImageFieldOptions, InferredFieldType, InspectOptions, type JsonFieldOptions, LeaveBalanceItem, LeaveRequestData, LeaveRequestItem, LeaveRequestStatus, LeaveTypeData, LeaveTypeItem, MappingOptions, MediaItem, MediaManager, type MediaUploadInput, MemoryStorageAdapter, type NumberFieldOptions, OptionItem, OptionsManager, OrderAddress, OrderData, OrderItem, OrderLineItem, OrderStatus, PaginatedResult, ParseExcelResult, ParseSourceOptions, ParsedSourceResult, ProductData, ProductImage, ProductItem, ProductStatus, ProductVariant, RBACManager, RecordAttendanceManualInput, RejectLeaveInput, type RelationshipFieldOptions, type RepeaterFieldOptions, RevisionDiff, RevisionDiffField, RevisionManager, RevisionRecord, type RichTextFieldOptions, type RouteContext, type SelectFieldOptions, SelectOption, SerializeCsvOptions, SerializeExcelOptions, SerializeJsonOptions, SerializeSourceOptions, SiteConfig, type SlugFieldOptions, SourceFieldSchema, SourceFormat, SourceInspectionResult, SuggestedMappingRule, type SyncFilterCallback, TaxonomyConfig, type TaxonomyFieldOptions, TaxonomyManager, TermItem, TermTreeItem, type TextFieldOptions, TransferClient, TransferErrorCode, TransferErrorDetail, TransferExportOptions, TransferExportResult, TransferImportOptions, TransferImportResult, TransferPluginOptions, TransferService, type UpdateContentInput, UpdateEmployeeInput, UpdateEmployerInput, UpdateProductInput, UserRole, VALID_STATUS_TRANSITIONS, ValidateTransferOptions, ValidationPreviewRow, ValidationResult, applyFieldTransform, collection, createAttendanceCollection, createCMSEngine, createCMSRouter, createCmsClient, createDiscountCollection, createEcommerceTaxonomies, createEmployeeCollection, createEmployerCollection, createHRMSTaxonomies, createLeaveRequestCollection, createLeaveTypeCollection, createOrderCollection, createProductCollection, defaultHooks, defineConfig, definePlugin, detectFormat, ecommercePlugin, fields, generateSuggestedMapping, getEcommerceClient, getEcommerceService, getHRMSClient, getHRMSService, getTransferClient, getTransferService, hrmsPlugin, inspectSource, mapCmsItemForExport, mapSourceRecord, normalizeConfig, parseCsvSource, parseExcelSource, parseJsonSource, parseSource, resolveUniqueSlug, serializeCsv, serializeExcel, serializeJson, serializeSource, slugify, summarizeCollection, transferPlugin, validateAndNormalizeData, validateTransferBatch };
 //# sourceMappingURL=index.d.cts.map