@azlib/cms 0.7.0 → 0.8.0

package/dist/index.d.mts

@@ -522,6 +522,10 @@ declare class CMSEngine {
    * Check if a plugin is registered.
    */
   hasPlugin(name: string): boolean;
+  /**
+   * Check if a collection is registered.
+   */
+  hasCollection(slug: string): boolean;
   /**
    * Register a collection dynamically.
    */
@@ -2690,5 +2694,658 @@ declare const transferPlugin: (options?: void | TransferPluginOptions | undefine
  */
 declare function getTransferService(engine: CMSEngine, options?: TransferPluginOptions): TransferService;
 //#endregion
-export { type ActionCallback, ApproveLeaveInput, type ArrayFieldOptions, AttendanceData, AttendanceItem, AttendanceStatus, AuthService, BlockDefinition, type BlocksFieldOptions, type BooleanFieldOptions, CMSApiKeyConfig, CMSAuthConfig, CMSCapability, CMSClient, type CMSClientOptions, CMSConfig, CMSEngine, type CMSPlugin, type CMSPluginContext, CMSRouter, type CMSStorageAdapter, CMSUser, CMSWebhookConfig, CMSWebhookEvent, 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, DiskMediaStorageDriver, type DiskMediaStorageDriverOptions, EcommerceClient, EcommercePluginOptions, EcommerceProductQuery, EcommerceService, type EmailFieldOptions, 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, MediaStorageDriver, type MediaUploadInput, MemoryStorageAdapter, type NumberFieldOptions, OptionItem, OptionsManager, OrderAddress, OrderData, OrderItem, OrderLineItem, OrderStatus, PaginatedResult, ParseExcelResult, ParseSourceOptions, ParsedSourceResult, PersistenceStorageAdapter, type PersistenceStorageAdapterOptions, PreviewManager, type PreviewTokenPayload, ProductData, ProductImage, ProductItem, ProductStatus, ProductVariant, QueryOperatorExpression, 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, type StoredUserRecord, 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, type UrlFieldOptions, UserRole, VALID_STATUS_TRANSITIONS, ValidateTransferOptions, ValidationPreviewRow, ValidationResult, WebhookManager, applyFieldTransform, collection, computeHmacSignature, 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, hashPassword, hrmsPlugin, inspectSource, mapCmsItemForExport, mapSourceRecord, mergeLocalizedInput, normalizeConfig, parseCsvSource, parseExcelSource, parseJsonSource, parseSource, resolveLocalizedData, resolveUniqueSlug, serializeCsv, serializeExcel, serializeJson, serializeSource, signJwt, slugify, summarizeCollection, transferPlugin, validateAndNormalizeData, validateTransferBatch, verifyJwt, verifyPassword };
+//#region src/plugins/seo/types.d.ts
+/**
+ * @azlib/cms - Built-in SEO & Metadata Plugin Types
+ */
+interface RobotsTxtPolicy {
+  userAgent: string;
+  allow?: string[];
+  disallow?: string[];
+}
+interface RobotsTxtConfig {
+  policies?: RobotsTxtPolicy[];
+  sitemapUrl?: string;
+  host?: string;
+}
+interface SeoPluginOptions {
+  siteUrl?: string;
+  defaultTitle?: string;
+  titleTemplate?: string | ((title: string) => string);
+  defaultDescription?: string;
+  defaultOgImage?: string;
+  defaultTwitterCard?: "summary" | "summary_large_image" | "app" | "player";
+  sitemapCollections?: string[];
+  robotsTxt?: RobotsTxtConfig;
+  apiPrefix?: string;
+  enableRoutes?: boolean;
+  autoExtendCollections?: boolean | string[];
+}
+interface SeoMetadata {
+  title: string;
+  description?: string;
+  canonicalUrl?: string;
+  ogTitle?: string;
+  ogDescription?: string;
+  ogImage?: string;
+  ogType?: string;
+  twitterCard?: "summary" | "summary_large_image" | "app" | "player";
+  robots?: string;
+  keywords?: string[];
+  jsonLd?: Record<string, unknown>;
+}
+interface SitemapItem {
+  loc: string;
+  lastmod?: string;
+  changefreq?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+  priority?: number;
+}
+interface SeoCheckResult {
+  name: string;
+  passed: boolean;
+  message: string;
+  scoreImpact: number;
+}
+interface SeoContentAnalysisInput {
+  title?: string;
+  content?: string;
+  keyword?: string;
+  metaDescription?: string;
+}
+interface SeoContentAnalysis {
+  wordCount: number;
+  readingTimeMinutes: number;
+  keywordDensity: number;
+  score: number;
+  checks: SeoCheckResult[];
+  recommendations: string[];
+}
+//#endregion
+//#region src/plugins/seo/schemas.d.ts
+/**
+ * Generate standard SEO field definitions to attach to or extend content collections.
+ */
+declare function createSeoFieldDefinitions(): readonly FieldDefinition[];
+//#endregion
+//#region src/plugins/seo/service.d.ts
+declare class SeoService {
+  private engine;
+  private options;
+  private siteUrl;
+  constructor(engine: CMSEngine, options?: SeoPluginOptions);
+  /**
+   * Generate an XML sitemap for all published content items in configured collections.
+   */
+  generateSitemap(): Promise<string>;
+  /**
+   * Generate robots.txt content adhering to search crawler specifications.
+   */
+  generateRobotsTxt(): string;
+  /**
+   * Resolve consolidated SEO metadata for a document, using smart fallbacks.
+   */
+  resolveMetadata(collectionSlug: string, documentOrId: string | ContentItem): Promise<SeoMetadata>;
+  /**
+   * Generate schema.org JSON-LD structured data for a content item.
+   */
+  generateJsonLd(collectionSlug: string, item: ContentItem): Record<string, unknown>;
+  /**
+   * Analyze text content and title for SEO optimization, readability, and keyword density.
+   */
+  analyzeContent(input: SeoContentAnalysisInput): SeoContentAnalysis;
+  private formatTitle;
+  private stripHtml;
+  private escapeXml;
+}
+/**
+ * Retrieve the active SeoService instance associated with a CMSEngine.
+ */
+declare function getSeoService(engine: CMSEngine, options?: SeoPluginOptions): SeoService;
+//#endregion
+//#region src/plugins/seo/client.d.ts
+declare class SeoClient {
+  private client;
+  private options;
+  private service?;
+  private prefix;
+  constructor(client: CMSClient, options?: SeoPluginOptions);
+  /**
+   * Fetch XML sitemap string.
+   */
+  getSitemapXml(): Promise<string>;
+  /**
+   * Fetch robots.txt plain text string.
+   */
+  getRobotsTxt(): Promise<string>;
+  /**
+   * Resolve consolidated SEO metadata for a document.
+   */
+  getMetadata(collection: string, id: string): Promise<SeoMetadata>;
+  /**
+   * Run SEO and readability analysis on draft content.
+   */
+  analyze(input: SeoContentAnalysisInput): Promise<SeoContentAnalysis>;
+}
+/**
+ * Get or create an SeoClient adapter for a CMSClient.
+ */
+declare function getSeoClient(client: CMSClient, options?: SeoPluginOptions): SeoClient;
+//#endregion
+//#region src/plugins/seo/index.d.ts
+/**
+ * Built-in SEO & Metadata plugin factory for @azlib/cms.
+ * Equips the CMS engine with dynamic XML sitemaps, robots.txt generation,
+ * OpenGraph/Twitter social cards, JSON-LD structured data, SEO readability scoring,
+ * and declarative schema field extensions.
+ */
+declare const seoPlugin: (options?: void | SeoPluginOptions | undefined) => CMSPlugin;
+//#endregion
+//#region src/plugins/search/types.d.ts
+interface SearchDocument {
+  id: string;
+  collection: string;
+  title: string;
+  slug: string;
+  content?: string;
+  excerpt?: string;
+  status?: string;
+  terms?: Record<string, string[]>;
+  data?: Record<string, unknown>;
+  boost?: number;
+}
+interface SearchCollectionRule {
+  fields?: string[];
+  weights?: Record<string, number>;
+  filter?: (item: ContentItem) => boolean;
+}
+interface SearchQuery {
+  q: string;
+  collections?: string[];
+  limit?: number;
+  offset?: number;
+  status?: string;
+  filters?: Record<string, unknown>;
+}
+interface SearchResultItem {
+  id: string;
+  collection: string;
+  title: string;
+  slug: string;
+  snippet?: string;
+  score: number;
+  terms?: Record<string, string[]>;
+}
+interface SearchResults {
+  items: SearchResultItem[];
+  total: number;
+  query: string;
+  tookMs: number;
+}
+interface SearchAdapterContract {
+  index(docs: SearchDocument[]): Promise<void>;
+  remove(collection: string, id: string): Promise<void>;
+  search(query: SearchQuery): Promise<SearchResults>;
+  clear(): Promise<void>;
+}
+interface SearchPluginOptions {
+  collections?: string[] | Record<string, SearchCollectionRule>;
+  enableAutoIndex?: boolean;
+  enableRoutes?: boolean;
+  apiPrefix?: string;
+  adapter?: SearchAdapterContract;
+}
+//#endregion
+//#region src/plugins/search/adapters/memory-search-adapter.d.ts
+declare class MemorySearchAdapter implements SearchAdapterContract {
+  private docs;
+  private invertedIndex;
+  index(documents: SearchDocument[]): Promise<void>;
+  remove(collection: string, id: string): Promise<void>;
+  clear(): Promise<void>;
+  search(query: SearchQuery): Promise<SearchResults>;
+  private generateSnippet;
+  private tokenize;
+}
+//#endregion
+//#region src/plugins/search/service.d.ts
+declare class SearchService {
+  private engine;
+  private options;
+  private adapter;
+  constructor(engine: CMSEngine, options?: SearchPluginOptions);
+  getAdapter(): SearchAdapterContract;
+  /**
+   * Search across indexed CMS collections.
+   */
+  search(query: SearchQuery): Promise<SearchResults>;
+  /**
+   * Index or update a single content item.
+   */
+  indexItem(item: ContentItem): Promise<void>;
+  /**
+   * Remove a single content item from the search index.
+   */
+  removeItem(collection: string, id: string): Promise<void>;
+  /**
+   * Reindex all published items across configured CMS collections.
+   */
+  reindexAll(): Promise<{
+    indexedCount: number;
+  }>;
+  private shouldIndex;
+  private toSearchDocument;
+  private getTargetCollections;
+  private attachHooks;
+}
+/**
+ * Retrieve the active SearchService instance associated with a CMSEngine.
+ */
+declare function getSearchService(engine: CMSEngine, options?: SearchPluginOptions): SearchService;
+//#endregion
+//#region src/plugins/search/client.d.ts
+declare class SearchClient {
+  private client;
+  private options;
+  private service?;
+  private prefix;
+  constructor(client: CMSClient, options?: SearchPluginOptions);
+  /**
+   * Search across indexed CMS collections.
+   */
+  search(query: SearchQuery): Promise<SearchResults>;
+  /**
+   * Reindex all content in the search index.
+   */
+  reindex(): Promise<{
+    success: boolean;
+    indexedCount: number;
+  }>;
+}
+/**
+ * Get or create a SearchClient adapter for a CMSClient.
+ */
+declare function getSearchClient(client: CMSClient, options?: SearchPluginOptions): SearchClient;
+//#endregion
+//#region src/plugins/search/index.d.ts
+/**
+ * Built-in Search Indexing & Discovery plugin factory for @azlib/cms.
+ * Equips the CMS engine with fast inverted-index full-text search, field weighting,
+ * fuzzy/prefix matching, snippet highlights, and automatic indexing via lifecycle hooks.
+ */
+declare const searchPlugin: (options?: void | SearchPluginOptions | undefined) => CMSPlugin;
+//#endregion
+//#region src/plugins/audit-log/types.d.ts
+/**
+ * @azlib/cms - Built-in Audit Log & Activity Trail Plugin Types
+ */
+type AuditAction = "create" | "update" | "delete" | "publish" | "restore" | "upload" | "login" | "logout" | "option_change";
+type AuditEntityType = "content" | "media" | "taxonomy" | "auth" | "option" | "system";
+interface AuditDiff {
+  before?: Record<string, unknown>;
+  after?: Record<string, unknown>;
+  changedFields?: string[];
+}
+interface AuditLogEntry {
+  id: string;
+  action: AuditAction | string;
+  entityType: AuditEntityType | string;
+  collectionSlug?: string;
+  entityId: string;
+  actorId?: string | null;
+  actorName?: string;
+  ip?: string;
+  userAgent?: string;
+  diff?: AuditDiff;
+  timestamp: string;
+  metadata?: Record<string, unknown>;
+}
+interface AuditLogQuery {
+  entityType?: string;
+  collectionSlug?: string;
+  entityId?: string;
+  actorId?: string;
+  action?: string;
+  startDate?: string;
+  endDate?: string;
+  limit?: number;
+  offset?: number;
+}
+interface AuditLogPluginOptions {
+  collections?: string[];
+  recordMedia?: boolean;
+  recordTaxonomies?: boolean;
+  recordOptions?: boolean;
+  apiPrefix?: string;
+  enableRoutes?: boolean;
+  maxEntries?: number;
+}
+//#endregion
+//#region src/plugins/audit-log/schemas.d.ts
+declare function createAuditLogCollection(_options?: AuditLogPluginOptions): CollectionConfig;
+//#endregion
+//#region src/plugins/audit-log/service.d.ts
+declare class AuditLogService {
+  private engine;
+  private options;
+  private inMemoryLogs;
+  private maxEntries;
+  constructor(engine: CMSEngine, options?: AuditLogPluginOptions);
+  /**
+   * Record an audit log entry.
+   */
+  record(entry: Omit<AuditLogEntry, "id" | "timestamp">): Promise<AuditLogEntry>;
+  /**
+   * Query audit logs with multi-attribute filtering and pagination.
+   */
+  query(query?: AuditLogQuery): Promise<PaginatedResult<AuditLogEntry>>;
+  /**
+   * Get an audit log entry by its ID.
+   */
+  getById(id: string): Promise<AuditLogEntry | null>;
+  /**
+   * Calculate a field-level diff between two states.
+   */
+  calculateDiff(before?: Record<string, unknown> | null, after?: Record<string, unknown> | null): AuditDiff;
+  private shouldAuditCollection;
+  private attachHooks;
+}
+/**
+ * Retrieve the active AuditLogService instance associated with a CMSEngine.
+ */
+declare function getAuditLogService(engine: CMSEngine, options?: AuditLogPluginOptions): AuditLogService;
+//#endregion
+//#region src/plugins/audit-log/client.d.ts
+declare class AuditLogClient {
+  private client;
+  private options;
+  private service?;
+  private prefix;
+  constructor(client: CMSClient, options?: AuditLogPluginOptions);
+  /**
+   * Query recorded audit logs with multi-field filters.
+   */
+  query(query?: AuditLogQuery): Promise<PaginatedResult<AuditLogEntry>>;
+  /**
+   * Fetch a single audit log entry by ID.
+   */
+  get(id: string): Promise<AuditLogEntry | null>;
+}
+/**
+ * Get or create an AuditLogClient adapter for a CMSClient.
+ */
+declare function getAuditLogClient(client: CMSClient, options?: AuditLogPluginOptions): AuditLogClient;
+//#endregion
+//#region src/plugins/audit-log/index.d.ts
+/**
+ * Built-in Audit Log & Activity Trail plugin factory for @azlib/cms.
+ * Equips the CMS engine with immutable enterprise change logs, mutation auditing
+ * across content, media, taxonomies, and options, field-level diffs, and query APIs.
+ */
+declare const auditLogPlugin: (options?: void | AuditLogPluginOptions | undefined) => CMSPlugin;
+//#endregion
+//#region src/plugins/forms/types.d.ts
+/**
+ * @azlib/cms - Built-in Forms & Submissions Plugin Types
+ */
+type FormFieldType = "text" | "email" | "number" | "textarea" | "select" | "checkbox" | "radio" | "url" | "tel";
+interface FormFieldRule {
+  name: string;
+  label: string;
+  type: FormFieldType;
+  required?: boolean;
+  placeholder?: string;
+  defaultValue?: unknown;
+  options?: string[];
+  pattern?: string;
+  minLength?: number;
+  maxLength?: number;
+  min?: number;
+  max?: number;
+}
+interface FormDefinition {
+  id?: string;
+  slug: string;
+  title: string;
+  description?: string;
+  fields: FormFieldRule[];
+  successMessage?: string;
+  redirectUrl?: string;
+  notifyEmails?: string[];
+  isActive?: boolean;
+}
+type SubmissionStatus = "unread" | "read" | "spam" | "archived";
+interface FormSubmission {
+  id: string;
+  formSlug: string;
+  data: Record<string, unknown>;
+  ip?: string;
+  userAgent?: string;
+  submittedAt: string;
+  status: SubmissionStatus;
+}
+interface SubmitFormInput {
+  data: Record<string, unknown>;
+  honeypotValue?: string;
+}
+interface FormValidationResult {
+  valid: boolean;
+  errors: Record<string, string>;
+  sanitizedData: Record<string, unknown>;
+}
+interface FormsPluginOptions {
+  enableAntiSpam?: boolean;
+  honeypotFieldName?: string;
+  enableRoutes?: boolean;
+  apiPrefix?: string;
+}
+//#endregion
+//#region src/plugins/forms/schemas.d.ts
+/**
+ * Forms definition collection schema.
+ */
+declare function createFormsCollection(_options?: FormsPluginOptions): CollectionConfig;
+/**
+ * Form submissions collection schema.
+ */
+declare function createSubmissionsCollection(_options?: FormsPluginOptions): CollectionConfig;
+//#endregion
+//#region src/plugins/forms/service.d.ts
+declare class FormsService {
+  private engine;
+  private options;
+  private inMemoryForms;
+  private inMemorySubmissions;
+  private honeypotField;
+  constructor(engine: CMSEngine, options?: FormsPluginOptions);
+  /**
+   * Register or update a form schema programmatically or dynamically.
+   */
+  registerForm(form: FormDefinition): Promise<FormDefinition>;
+  /**
+   * Retrieve a form definition by its slug.
+   */
+  getForm(slug: string): Promise<FormDefinition | null>;
+  /**
+   * List all registered forms.
+   */
+  listForms(): Promise<FormDefinition[]>;
+  /**
+   * Validate a submission payload against the form's field definitions.
+   */
+  validateSubmission(form: FormDefinition, input: SubmitFormInput): FormValidationResult;
+  /**
+   * Submit data to a form by its slug.
+   */
+  submit(formSlug: string, input: SubmitFormInput, clientMeta?: {
+    ip?: string;
+    userAgent?: string;
+  }): Promise<FormSubmission>;
+  /**
+   * List submissions for a specific form.
+   */
+  listSubmissions(formSlug: string, options?: {
+    status?: SubmissionStatus;
+    limit?: number;
+    offset?: number;
+  }): Promise<PaginatedResult<FormSubmission>>;
+  /**
+   * Update submission status (e.g. read, spam, archived).
+   */
+  updateSubmissionStatus(id: string, status: SubmissionStatus): Promise<FormSubmission | null>;
+}
+/**
+ * Retrieve the active FormsService instance associated with a CMSEngine.
+ */
+declare function getFormsService(engine: CMSEngine, options?: FormsPluginOptions): FormsService;
+//#endregion
+//#region src/plugins/forms/client.d.ts
+declare class FormsClient {
+  private client;
+  private options;
+  private service?;
+  private prefix;
+  constructor(client: CMSClient, options?: FormsPluginOptions);
+  /**
+   * List public forms.
+   */
+  listForms(): Promise<FormDefinition[]>;
+  /**
+   * Get public form schema definition by slug.
+   */
+  getForm(slug: string): Promise<FormDefinition | null>;
+  /**
+   * Submit data to a form.
+   */
+  submit(slug: string, data: Record<string, unknown>, honeypotValue?: string): Promise<{
+    success: boolean;
+    message: string;
+    submissionId: string;
+    redirectUrl?: string;
+  }>;
+  /**
+   * List submissions for a form.
+   */
+  listSubmissions(slug: string, options?: {
+    status?: SubmissionStatus;
+    limit?: number;
+    offset?: number;
+  }): Promise<PaginatedResult<FormSubmission>>;
+}
+/**
+ * Get or create a FormsClient adapter for a CMSClient.
+ */
+declare function getFormsClient(client: CMSClient, options?: FormsPluginOptions): FormsClient;
+//#endregion
+//#region src/plugins/forms/index.d.ts
+/**
+ * Built-in Forms & Submissions plugin factory for @azlib/cms.
+ * Equips the CMS engine with dynamic form creation, schema validation,
+ * anti-spam honeypots, submission storage, and custom Web Standard REST routes.
+ */
+declare const formsPlugin: (options?: void | FormsPluginOptions | undefined) => CMSPlugin;
+//#endregion
+//#region src/plugins/revalidation/types.d.ts
+type RevalidationEvent = "create" | "update" | "delete" | "publish" | "manual";
+interface RevalidationEndpoint {
+  url: string;
+  secret?: string;
+  headers?: Record<string, string>;
+  method?: "POST" | "GET";
+}
+interface RevalidationPayload {
+  event: RevalidationEvent;
+  collectionSlug?: string;
+  itemId?: string;
+  slug?: string;
+  paths: string[];
+  tags: string[];
+  timestamp: string;
+}
+interface RevalidationDeliveryResult {
+  endpoint: string;
+  status: number | "error";
+  success: boolean;
+  durationMs: number;
+  error?: string;
+}
+interface RevalidationTriggerInput {
+  paths?: string[];
+  tags?: string[];
+  event?: RevalidationEvent;
+  collectionSlug?: string;
+  itemId?: string;
+}
+interface RevalidationPluginOptions {
+  endpoints?: RevalidationEndpoint[];
+  collectionPathMap?: Record<string, (item: ContentItem) => string[] | string>;
+  tagPrefix?: string;
+  enableAutoRevalidate?: boolean;
+  enableRoutes?: boolean;
+  apiPrefix?: string;
+}
+//#endregion
+//#region src/plugins/revalidation/service.d.ts
+declare class RevalidationService {
+  private engine;
+  private options;
+  private endpoints;
+  private history;
+  private tagPrefix;
+  private fetchFn;
+  constructor(engine: CMSEngine, options?: RevalidationPluginOptions);
+  addEndpoint(endpoint: RevalidationEndpoint): void;
+  getEndpoints(): readonly RevalidationEndpoint[];
+  getHistory(): readonly RevalidationDeliveryResult[];
+  /**
+   * Derive cache tags for a content item.
+   */
+  deriveTags(collection: string, id?: string, slug?: string): string[];
+  /**
+   * Derive frontend URL paths affected by this content change.
+   */
+  derivePaths(item: ContentItem): string[];
+  /**
+   * Dispatch revalidation to all configured endpoints.
+   */
+  revalidate(input: RevalidationTriggerInput): Promise<RevalidationDeliveryResult[]>;
+  private attachHooks;
+}
+/**
+ * Retrieve the active RevalidationService instance associated with a CMSEngine.
+ */
+declare function getRevalidationService(engine: CMSEngine, options?: RevalidationPluginOptions): RevalidationService;
+//#endregion
+//#region src/plugins/revalidation/client.d.ts
+declare class RevalidationClient {
+  private client;
+  private options;
+  private service?;
+  private prefix;
+  constructor(client: CMSClient, options?: RevalidationPluginOptions);
+  /**
+   * Manually trigger cache invalidation and revalidation for paths or tags.
+   */
+  revalidate(input: RevalidationTriggerInput): Promise<{
+    success: boolean;
+    results: RevalidationDeliveryResult[];
+  }>;
+  /**
+   * Fetch recent revalidation webhook delivery logs.
+   */
+  getHistory(): Promise<RevalidationDeliveryResult[]>;
+}
+/**
+ * Get or create a RevalidationClient adapter for a CMSClient.
+ */
+declare function getRevalidationClient(client: CMSClient, options?: RevalidationPluginOptions): RevalidationClient;
+//#endregion
+//#region src/plugins/revalidation/index.d.ts
+/**
+ * Built-in Frontend Cache & Revalidation plugin factory for @azlib/cms.
+ * Automatically invalidates edge caches and triggers on-demand revalidation
+ * (Next.js, Vercel, Cloudflare, Astro) with HMAC-signed webhooks and manual APIs.
+ */
+declare const revalidationPlugin: (options?: void | RevalidationPluginOptions | undefined) => CMSPlugin;
+//#endregion
+export { type ActionCallback, ApproveLeaveInput, type ArrayFieldOptions, AttendanceData, AttendanceItem, AttendanceStatus, AuditAction, AuditDiff, AuditEntityType, AuditLogClient, AuditLogEntry, AuditLogPluginOptions, AuditLogQuery, AuditLogService, AuthService, BlockDefinition, type BlocksFieldOptions, type BooleanFieldOptions, CMSApiKeyConfig, CMSAuthConfig, CMSCapability, CMSClient, type CMSClientOptions, CMSConfig, CMSEngine, type CMSPlugin, type CMSPluginContext, CMSRouter, type CMSStorageAdapter, CMSUser, CMSWebhookConfig, CMSWebhookEvent, 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, DiskMediaStorageDriver, type DiskMediaStorageDriverOptions, EcommerceClient, EcommercePluginOptions, EcommerceProductQuery, EcommerceService, type EmailFieldOptions, EmployeeData, EmployeeDocument, EmployeeEmergencyContact, EmployeeItem, EmployeeLeaveBalanceReport, EmployeeStatus, EmployerData, EmployerItem, EmployerStatus, EmployerWorkSchedule, EmploymentType, FieldDefinition, FieldMappingRule, FieldTransformFn, FieldTransformPreset, FieldType, type FilterCallback, FormDefinition, FormFieldRule, FormFieldType, FormSubmission, FormValidationResult, FormsClient, FormsPluginOptions, FormsService, 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, MediaStorageDriver, type MediaUploadInput, MemorySearchAdapter, MemoryStorageAdapter, type NumberFieldOptions, OptionItem, OptionsManager, OrderAddress, OrderData, OrderItem, OrderLineItem, OrderStatus, PaginatedResult, ParseExcelResult, ParseSourceOptions, ParsedSourceResult, PersistenceStorageAdapter, type PersistenceStorageAdapterOptions, PreviewManager, type PreviewTokenPayload, ProductData, ProductImage, ProductItem, ProductStatus, ProductVariant, QueryOperatorExpression, RBACManager, RecordAttendanceManualInput, RejectLeaveInput, type RelationshipFieldOptions, type RepeaterFieldOptions, RevalidationClient, RevalidationDeliveryResult, RevalidationEndpoint, RevalidationEvent, RevalidationPayload, RevalidationPluginOptions, RevalidationService, RevalidationTriggerInput, RevisionDiff, RevisionDiffField, RevisionManager, RevisionRecord, type RichTextFieldOptions, RobotsTxtConfig, RobotsTxtPolicy, type RouteContext, SearchAdapterContract, SearchClient, SearchCollectionRule, SearchDocument, SearchPluginOptions, SearchQuery, SearchResultItem, SearchResults, SearchService, type SelectFieldOptions, SelectOption, SeoCheckResult, SeoClient, SeoContentAnalysis, SeoContentAnalysisInput, SeoMetadata, SeoPluginOptions, SeoService, SerializeCsvOptions, SerializeExcelOptions, SerializeJsonOptions, SerializeSourceOptions, SiteConfig, SitemapItem, type SlugFieldOptions, SourceFieldSchema, SourceFormat, SourceInspectionResult, type StoredUserRecord, SubmissionStatus, SubmitFormInput, 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, type UrlFieldOptions, UserRole, VALID_STATUS_TRANSITIONS, ValidateTransferOptions, ValidationPreviewRow, ValidationResult, WebhookManager, applyFieldTransform, auditLogPlugin, collection, computeHmacSignature, createAttendanceCollection, createAuditLogCollection, createCMSEngine, createCMSRouter, createCmsClient, createDiscountCollection, createEcommerceTaxonomies, createEmployeeCollection, createEmployerCollection, createFormsCollection, createHRMSTaxonomies, createLeaveRequestCollection, createLeaveTypeCollection, createOrderCollection, createProductCollection, createSeoFieldDefinitions, createSubmissionsCollection, defaultHooks, defineConfig, definePlugin, detectFormat, ecommercePlugin, fields, formsPlugin, generateSuggestedMapping, getAuditLogClient, getAuditLogService, getEcommerceClient, getEcommerceService, getFormsClient, getFormsService, getHRMSClient, getHRMSService, getRevalidationClient, getRevalidationService, getSearchClient, getSearchService, getSeoClient, getSeoService, getTransferClient, getTransferService, hashPassword, hrmsPlugin, inspectSource, mapCmsItemForExport, mapSourceRecord, mergeLocalizedInput, normalizeConfig, parseCsvSource, parseExcelSource, parseJsonSource, parseSource, resolveLocalizedData, resolveUniqueSlug, revalidationPlugin, searchPlugin, seoPlugin, serializeCsv, serializeExcel, serializeJson, serializeSource, signJwt, slugify, summarizeCollection, transferPlugin, validateAndNormalizeData, validateTransferBatch, verifyJwt, verifyPassword };
 //# sourceMappingURL=index.d.mts.map