@azlib/cms 0.5.0 → 0.7.0

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import { DatabaseClient, PersistenceConfig } from "@azlib/persistence";
 //#region src/core/hooks.d.ts
 /**
  * @azlib/cms - WordPress-style Action and Filter Hook System
@@ -251,12 +252,33 @@ declare class TaxonomyManager {
   removeTerms(contentId: string, termIds: string[]): Promise<void>;
 }
 //#endregion
+//#region src/media/drivers/driver-contract.d.ts
+/**
+ * @azlib/cms - Media Storage Driver Contract
+ */
+interface MediaStorageDriver {
+  write(input: {
+    filename: string;
+    buffer: Uint8Array;
+    mimeType: string;
+  }): Promise<{
+    url: string;
+    path?: string;
+    sizeBytes: number;
+  }>;
+  read(pathOrUrl: string): Promise<Uint8Array | null>;
+  delete(pathOrUrl: string): Promise<boolean>;
+  getUrl(path: string): string;
+}
+//#endregion
 //#region src/media/media-manager.d.ts
 interface MediaUploadInput {
   filename: string;
   mimeType: string;
-  sizeBytes: number;
+  sizeBytes?: number;
+  buffer?: Uint8Array;
   url?: string;
+  path?: string;
   width?: number;
   height?: number;
   altText?: string;
@@ -267,8 +289,9 @@ declare class MediaManager {
   private storage;
   private hooks?;
   private publicBaseUrl;
+  private driver?;
   private allowedMimePrefixes;
-  constructor(storage: CMSStorageAdapter, hooks?: HooksManager | undefined, publicBaseUrl?: string);
+  constructor(storage: CMSStorageAdapter, hooks?: HooksManager | undefined, publicBaseUrl?: string, driver?: MediaStorageDriver | undefined);
   /**
    * Upload / register a new media item.
    */
@@ -328,6 +351,101 @@ declare class RBACManager {
   }): boolean;
 }
 //#endregion
+//#region src/auth/auth-service.d.ts
+interface StoredUserRecord extends CMSUser {
+  passwordHash: string;
+  createdAt: string;
+  updatedAt: string;
+}
+declare class AuthService {
+  private config;
+  private rbac;
+  private users;
+  private defaultSecret;
+  constructor(config: CMSAuthConfig | undefined, rbac: RBACManager);
+  get enabled(): boolean;
+  /**
+   * Register a new user account.
+   */
+  register(input: {
+    username: string;
+    email: string;
+    password: string;
+    displayName?: string;
+    role?: UserRole;
+  }): Promise<CMSUser>;
+  /**
+   * Authenticate with email/username and password.
+   */
+  login(identifier: string, password: string): Promise<{
+    user: CMSUser;
+    token: string;
+  }>;
+  /**
+   * Extract and authenticate user from Request (Bearer JWT, ApiKey, or X-API-Key).
+   */
+  authenticateRequest(request: Request): Promise<CMSUser | null>;
+  /**
+   * Find a user by ID.
+   */
+  getUserById(id: string): CMSUser | null;
+  private sanitizeUser;
+}
+//#endregion
+//#region src/core/webhooks.d.ts
+declare function computeHmacSignature(payload: string, secret: string): Promise<string>;
+declare class WebhookManager {
+  private hooks?;
+  private webhooks;
+  private fetchFn;
+  constructor(initialWebhooks?: readonly CMSWebhookConfig[], hooks?: HooksManager | undefined, fetchFn?: typeof globalThis.fetch);
+  /**
+   * Register a new webhook endpoint.
+   */
+  registerWebhook(webhook: CMSWebhookConfig): string;
+  /**
+   * Get all registered webhooks.
+   */
+  getWebhooks(): CMSWebhookConfig[];
+  /**
+   * Delete a webhook by ID.
+   */
+  deleteWebhook(id: string): boolean;
+  /**
+   * Dispatch an event to all matching webhooks asynchronously.
+   */
+  dispatch(event: CMSWebhookEvent, data: Record<string, unknown>): Promise<{
+    url: string;
+    success: boolean;
+    status?: number;
+  }[]>;
+}
+//#endregion
+//#region src/core/preview.d.ts
+/**
+ * @azlib/cms - Draft Preview Mode Engine
+ */
+interface PreviewTokenPayload extends Record<string, unknown> {
+  contentId: string;
+  collection: string;
+  scope: "preview";
+}
+declare class PreviewManager {
+  private secret;
+  constructor(secret?: string);
+  /**
+   * Mint a signed draft preview token.
+   */
+  createPreviewToken(contentId: string, collection: string, expiresInSeconds?: number): Promise<string>;
+  /**
+   * Verify and unpack a draft preview token.
+   */
+  verifyPreviewToken(token: string): Promise<{
+    contentId: string;
+    collection: string;
+  } | null>;
+}
+//#endregion
 //#region src/core/engine.d.ts
 interface CreateContentInput {
   title?: string;
@@ -350,8 +468,16 @@ interface UpdateContentInput {
 interface CollectionService<TData extends Record<string, unknown> = Record<string, unknown>> {
   readonly config: CollectionConfig;
   create(input: CreateContentInput, authorId?: string | null): Promise<ContentItem<TData>>;
-  findById(id: string): Promise<ContentItem<TData> | null>;
-  findBySlug(slug: string): Promise<ContentItem<TData> | null>;
+  findById(id: string, options?: {
+    populate?: string[];
+    select?: string[];
+    locale?: string;
+  }): Promise<ContentItem<TData> | null>;
+  findBySlug(slug: string, options?: {
+    populate?: string[];
+    select?: string[];
+    locale?: string;
+  }): Promise<ContentItem<TData> | null>;
   find(options?: ContentQueryOptions): Promise<PaginatedResult<ContentItem<TData>>>;
   update(id: string, input: UpdateContentInput, authorId?: string | null, revisionNote?: string): Promise<ContentItem<TData> | null>;
   delete(id: string): Promise<boolean>;
@@ -370,6 +496,9 @@ declare class CMSEngine {
   readonly taxonomies: TaxonomyManager;
   readonly media: MediaManager;
   readonly rbac: RBACManager;
+  readonly auth: AuthService;
+  readonly webhooks: WebhookManager;
+  readonly preview: PreviewManager;
   readonly revisions: RevisionManager;
   readonly lifecycle: ContentLifecycle;
   private collections;
@@ -520,11 +649,17 @@ declare function definePlugin<TOptions = void>(factory: (options: TOptions) => C
 //#endregion
 //#region src/core/types.d.ts
 type ContentStatus = "draft" | "pending_review" | "scheduled" | "published" | "private" | "trash";
-type FieldType = "text" | "slug" | "richText" | "number" | "boolean" | "select" | "image" | "taxonomy" | "relationship" | "date" | "json" | "repeater";
+type FieldType = "text" | "slug" | "richText" | "number" | "boolean" | "select" | "image" | "taxonomy" | "relationship" | "date" | "json" | "repeater" | "blocks" | "email" | "url" | "array";
 interface SelectOption {
   readonly label: string;
   readonly value: string | number;
 }
+interface BlockDefinition {
+  readonly slug: string;
+  readonly label: string;
+  readonly description?: string;
+  readonly fields: readonly FieldDefinition[];
+}
 interface FieldDefinition<TValue = any> {
   readonly name: string;
   readonly type: FieldType;
@@ -538,6 +673,10 @@ interface FieldDefinition<TValue = any> {
   readonly targetCollection?: string;
   readonly fromField?: string;
   readonly fields?: readonly FieldDefinition[];
+  readonly blocks?: readonly BlockDefinition[];
+  readonly readRoles?: readonly string[];
+  readonly writeRoles?: readonly string[];
+  readonly localized?: boolean;
   readonly min?: number;
   readonly max?: number;
   readonly pattern?: string;
@@ -559,6 +698,21 @@ interface CollectionConfig {
     readonly direction: "asc" | "desc";
   };
 }
+interface QueryOperatorExpression {
+  $eq?: unknown;
+  $ne?: unknown;
+  $gt?: unknown;
+  $gte?: unknown;
+  $lt?: unknown;
+  $lte?: unknown;
+  $in?: unknown[];
+  $nin?: unknown[];
+  $contains?: string;
+  $startsWith?: string;
+  $endsWith?: string;
+  $between?: [unknown, unknown];
+  $exists?: boolean;
+}
 interface ContentItem<TData extends Record<string, unknown> = Record<string, unknown>> {
   id: string;
   collection: string;
@@ -572,8 +726,10 @@ interface ContentItem<TData extends Record<string, unknown> = Record<string, unk
   createdAt: string;
   updatedAt: string;
   version: number;
+  locale?: string;
   data: TData;
   terms?: Record<string, string[]>;
+  populated?: Record<string, unknown>;
 }
 interface ContentQueryOptions {
   status?: ContentStatus | ContentStatus[];
@@ -581,13 +737,17 @@ interface ContentQueryOptions {
   parentId?: string | null;
   termIds?: string[];
   search?: string;
-  where?: Record<string, unknown>;
+  where?: Record<string, unknown | QueryOperatorExpression>;
   orderBy?: string;
   orderDirection?: "asc" | "desc";
   limit?: number;
   offset?: number;
   includeRevisions?: boolean;
   includeTerms?: boolean;
+  populate?: string[];
+  select?: string[];
+  locale?: string;
+  fallbackLocale?: string;
 }
 interface PaginatedResult<T> {
   items: T[];
@@ -683,6 +843,44 @@ interface SiteConfig {
   locale?: string;
   timezone?: string;
 }
+interface CMSApiKeyConfig {
+  key: string;
+  role: UserRole;
+  name?: string;
+  capabilities?: string[];
+}
+interface CMSAuthConfig {
+  enabled?: boolean;
+  jwtSecret?: string;
+  tokenExpiresIn?: string | number;
+  apiKeys?: CMSApiKeyConfig[];
+  publicCollections?: string[];
+  publicMutations?: boolean;
+}
+type CMSWebhookEvent = "content.created" | "content.updated" | "content.deleted" | "content.published" | "media.uploaded" | "media.deleted" | (string & {});
+interface CMSWebhookConfig {
+  id?: string;
+  name: string;
+  url: string;
+  secret?: string;
+  events: CMSWebhookEvent[];
+  enabled?: boolean;
+  headers?: Record<string, string>;
+}
+interface MediaStorageDriver$1 {
+  write(input: {
+    filename: string;
+    buffer: Uint8Array;
+    mimeType: string;
+  }): Promise<{
+    url: string;
+    path?: string;
+    sizeBytes: number;
+  }>;
+  read(pathOrUrl: string): Promise<Uint8Array | null>;
+  delete(pathOrUrl: string): Promise<boolean>;
+  getUrl(path: string): string;
+}
 interface CMSConfig {
   site?: SiteConfig;
   collections: readonly CollectionConfig[];
@@ -692,6 +890,19 @@ interface CMSConfig {
     route?: string;
     enableRegistration?: boolean;
   };
+  auth?: CMSAuthConfig;
+  webhooks?: readonly CMSWebhookConfig[];
+  media?: {
+    storageDriver?: MediaStorageDriver$1;
+    uploadDir?: string;
+    publicBaseUrl?: string;
+    maxSizeBytes?: number;
+  };
+  i18n?: {
+    defaultLocale: string;
+    locales: readonly string[];
+    fallback?: boolean;
+  };
 }
 //#endregion
 //#region src/core/config.d.ts
@@ -709,7 +920,12 @@ declare function defineConfig(config: CMSConfig): CMSConfig;
 declare function normalizeConfig(config: Partial<CMSConfig>): CMSConfig;
 //#endregion
 //#region src/content/schema.d.ts
-interface TextFieldOptions {
+interface BaseFieldOptions {
+  readRoles?: readonly (UserRole | string)[];
+  writeRoles?: readonly (UserRole | string)[];
+  localized?: boolean;
+}
+interface TextFieldOptions extends BaseFieldOptions {
   name: string;
   label?: string;
   description?: string;
@@ -721,21 +937,21 @@ interface TextFieldOptions {
   pattern?: string;
   validate?: (value: string, data: Record<string, unknown>) => string | null | boolean;
 }
-interface SlugFieldOptions {
+interface SlugFieldOptions extends BaseFieldOptions {
   name?: string;
   label?: string;
   from?: string;
   required?: boolean;
   unique?: boolean;
 }
-interface RichTextFieldOptions {
+interface RichTextFieldOptions extends BaseFieldOptions {
   name: string;
   label?: string;
   description?: string;
   required?: boolean;
   defaultValue?: string;
 }
-interface NumberFieldOptions {
+interface NumberFieldOptions extends BaseFieldOptions {
   name: string;
   label?: string;
   description?: string;
@@ -744,13 +960,13 @@ interface NumberFieldOptions {
   min?: number;
   max?: number;
 }
-interface BooleanFieldOptions {
+interface BooleanFieldOptions extends BaseFieldOptions {
   name: string;
   label?: string;
   description?: string;
   defaultValue?: boolean;
 }
-interface SelectFieldOptions {
+interface SelectFieldOptions extends BaseFieldOptions {
   name: string;
   label?: string;
   description?: string;
@@ -758,40 +974,40 @@ interface SelectFieldOptions {
   options: readonly (string | SelectOption)[];
   defaultValue?: string | number;
 }
-interface ImageFieldOptions {
+interface ImageFieldOptions extends BaseFieldOptions {
   name: string;
   label?: string;
   description?: string;
   required?: boolean;
 }
-interface TaxonomyFieldOptions {
+interface TaxonomyFieldOptions extends BaseFieldOptions {
   name: string;
   taxonomy: string;
   label?: string;
   required?: boolean;
 }
-interface RelationshipFieldOptions {
+interface RelationshipFieldOptions extends BaseFieldOptions {
   name: string;
   targetCollection: string;
   label?: string;
   description?: string;
   required?: boolean;
 }
-interface DateFieldOptions {
+interface DateFieldOptions extends BaseFieldOptions {
   name: string;
   label?: string;
   description?: string;
   required?: boolean;
   defaultValue?: string;
 }
-interface JsonFieldOptions {
+interface JsonFieldOptions extends BaseFieldOptions {
   name: string;
   label?: string;
   description?: string;
   required?: boolean;
   defaultValue?: unknown;
 }
-interface RepeaterFieldOptions {
+interface RepeaterFieldOptions extends BaseFieldOptions {
   name: string;
   label?: string;
   description?: string;
@@ -799,6 +1015,37 @@ interface RepeaterFieldOptions {
   min?: number;
   max?: number;
 }
+interface BlocksFieldOptions extends BaseFieldOptions {
+  name: string;
+  label?: string;
+  description?: string;
+  required?: boolean;
+  blocks: readonly BlockDefinition[];
+  min?: number;
+  max?: number;
+}
+interface EmailFieldOptions extends BaseFieldOptions {
+  name: string;
+  label?: string;
+  description?: string;
+  required?: boolean;
+  defaultValue?: string;
+  unique?: boolean;
+}
+interface UrlFieldOptions extends BaseFieldOptions {
+  name: string;
+  label?: string;
+  description?: string;
+  required?: boolean;
+  defaultValue?: string;
+}
+interface ArrayFieldOptions extends BaseFieldOptions {
+  name: string;
+  label?: string;
+  description?: string;
+  required?: boolean;
+  defaultValue?: unknown[];
+}
 declare const fields: {
   text(options: TextFieldOptions): FieldDefinition<string>;
   slug(options?: SlugFieldOptions): FieldDefinition<string>;
@@ -812,6 +1059,13 @@ declare const fields: {
   date(options: DateFieldOptions): FieldDefinition<string>;
   json(options: JsonFieldOptions): FieldDefinition<unknown>;
   repeater(options: RepeaterFieldOptions): FieldDefinition<Record<string, unknown>[]>;
+  blocks(options: BlocksFieldOptions): FieldDefinition<{
+    blockType: string;
+    [key: string]: unknown;
+  }[]>;
+  email(options: EmailFieldOptions): FieldDefinition<string>;
+  url(options: UrlFieldOptions): FieldDefinition<string>;
+  array(options: ArrayFieldOptions): FieldDefinition<unknown[]>;
 };
 interface CollectionOptions {
   slug: string;
@@ -841,6 +1095,16 @@ declare function validateAndNormalizeData(fieldsList: readonly FieldDefinition[]
   errors: Record<string, string>;
 };
 //#endregion
+//#region src/content/i18n.d.ts
+/**
+ * Resolve localized fields on a content record for a target locale.
+ */
+declare function resolveLocalizedData(data: Record<string, unknown>, fieldsList: readonly FieldDefinition[], targetLocale: string, fallbackLocale?: string): Record<string, unknown>;
+/**
+ * Merge an incoming update for a specific locale into existing localized dictionaries.
+ */
+declare function mergeLocalizedInput(incomingData: Record<string, unknown>, existingData: Record<string, unknown> | undefined, fieldsList: readonly FieldDefinition[], locale: string): Record<string, unknown>;
+//#endregion
 //#region src/content/slug.d.ts
 /**
  * @azlib/cms - Slug generation and normalization utility
@@ -854,6 +1118,38 @@ declare function slugify(input: string): string;
  */
 declare function resolveUniqueSlug(baseSlug: string, isSlugTaken: (slug: string) => Promise<boolean> | boolean, currentId?: string): Promise<string>;
 //#endregion
+//#region src/media/drivers/disk-driver.d.ts
+interface DiskMediaStorageDriverOptions {
+  uploadDir: string;
+  publicBaseUrl?: string;
+}
+declare class DiskMediaStorageDriver implements MediaStorageDriver {
+  private uploadDir;
+  private publicBaseUrl;
+  constructor(options: DiskMediaStorageDriverOptions);
+  write(input: {
+    filename: string;
+    buffer: Uint8Array;
+    mimeType: string;
+  }): Promise<{
+    url: string;
+    path: string;
+    sizeBytes: number;
+  }>;
+  read(pathOrUrl: string): Promise<Uint8Array | null>;
+  delete(pathOrUrl: string): Promise<boolean>;
+  getUrl(filePathOrName: string): string;
+}
+//#endregion
+//#region src/auth/jwt.d.ts
+/**
+ * @azlib/cms - Universal Web Crypto JWT & Password Hashing
+ */
+declare function signJwt(payload: Record<string, unknown>, secret: string, expiresInSeconds?: number): Promise<string>;
+declare function verifyJwt<T extends Record<string, unknown> = Record<string, unknown>>(token: string, secret: string): Promise<T | null>;
+declare function hashPassword(password: string): Promise<string>;
+declare function verifyPassword(password: string, storedHash: string): Promise<boolean>;
+//#endregion
 //#region src/storage/memory-adapter.d.ts
 declare class MemoryStorageAdapter implements CMSStorageAdapter {
   private content;
@@ -868,6 +1164,8 @@ declare class MemoryStorageAdapter implements CMSStorageAdapter {
   getContent<T extends Record<string, unknown>>(collection: string, id: string): Promise<ContentItem<T> | null>;
   getContentBySlug<T extends Record<string, unknown>>(collection: string, slug: string): Promise<ContentItem<T> | null>;
   findContent<T extends Record<string, unknown>>(collection: string, options?: ContentQueryOptions): Promise<PaginatedResult<ContentItem<T>>>;
+  private populateItem;
+  private projectItem;
   updateContent<T extends Record<string, unknown>>(collection: string, id: string, updates: Partial<Omit<ContentItem<T>, "id" | "collection" | "createdAt">>): Promise<ContentItem<T> | null>;
   deleteContent(collection: string, id: string): Promise<boolean>;
   countContent(collection: string, options?: ContentQueryOptions): Promise<number>;
@@ -904,6 +1202,63 @@ declare class MemoryStorageAdapter implements CMSStorageAdapter {
   getOptions(namespace?: string): Promise<OptionItem[]>;
 }
 //#endregion
+//#region src/storage/persistence-adapter.d.ts
+interface PersistenceStorageAdapterOptions {
+  client: DatabaseClient;
+  config: PersistenceConfig;
+  autoMigrate?: boolean;
+}
+declare class PersistenceStorageAdapter implements CMSStorageAdapter {
+  private client;
+  private config;
+  private autoMigrate;
+  constructor(options: PersistenceStorageAdapterOptions);
+  init(): Promise<void>;
+  close(): Promise<void>;
+  createContent<T extends Record<string, unknown>>(item: Omit<ContentItem<T>, "id" | "createdAt" | "updatedAt" | "version">): Promise<ContentItem<T>>;
+  getContent<T extends Record<string, unknown>>(collection: string, id: string): Promise<ContentItem<T> | null>;
+  getContentBySlug<T extends Record<string, unknown>>(collection: string, slug: string): Promise<ContentItem<T> | null>;
+  findContent<T extends Record<string, unknown>>(collection: string, options?: ContentQueryOptions): Promise<PaginatedResult<ContentItem<T>>>;
+  updateContent<T extends Record<string, unknown>>(collection: string, id: string, updates: Partial<Omit<ContentItem<T>, "id" | "collection" | "createdAt">>): Promise<ContentItem<T> | null>;
+  deleteContent(collection: string, id: string): Promise<boolean>;
+  countContent(collection: string, options?: ContentQueryOptions): Promise<number>;
+  createRevision(contentId: string, collection: string, version: number, snapshot: ContentItem, authorId?: string | null, note?: string): Promise<RevisionRecord>;
+  getRevisions(contentId: string): Promise<RevisionRecord[]>;
+  getRevision(revisionId: string): Promise<RevisionRecord | null>;
+  deleteRevisionsByContentId(contentId: string): Promise<number>;
+  createTerm(term: Omit<TermItem, "id" | "count" | "createdAt" | "updatedAt">): Promise<TermItem>;
+  getTermById(id: string): Promise<TermItem | null>;
+  getTermBySlug(taxonomy: string, slug: string): Promise<TermItem | null>;
+  getTerms(taxonomy: string, options?: {
+    parentId?: string | null;
+  }): Promise<TermItem[]>;
+  updateTerm(id: string, updates: Partial<Omit<TermItem, "id" | "taxonomy" | "createdAt">>): Promise<TermItem | null>;
+  deleteTerm(id: string): Promise<boolean>;
+  assignTermsToContent(contentId: string, termIds: string[]): Promise<void>;
+  getContentTerms(contentId: string, taxonomy?: string): Promise<TermItem[]>;
+  removeTermsFromContent(contentId: string, termIds: string[]): Promise<void>;
+  createMedia(item: Omit<MediaItem, "id" | "createdAt" | "updatedAt">): Promise<MediaItem>;
+  getMedia(id: string): Promise<MediaItem | null>;
+  findMedia(options?: {
+    search?: string;
+    mimeType?: string;
+    authorId?: string;
+    limit?: number;
+    offset?: number;
+  }): Promise<PaginatedResult<MediaItem>>;
+  updateMedia(id: string, updates: Partial<Omit<MediaItem, "id" | "createdAt">>): Promise<MediaItem | null>;
+  deleteMedia(id: string): Promise<boolean>;
+  getOption<T = unknown>(key: string): Promise<OptionItem<T> | null>;
+  setOption<T = unknown>(item: OptionItem<T>): Promise<void>;
+  deleteOption(key: string): Promise<boolean>;
+  getOptions(namespace?: string): Promise<OptionItem[]>;
+  private deserializeContent;
+  private deserializeTerm;
+  private deserializeMedia;
+  private populateItem;
+  private matchesCondition;
+}
+//#endregion
 //#region src/api/router.d.ts
 declare class CMSRouter {
   private engine;
@@ -918,10 +1273,12 @@ declare class CMSRouter {
    */
   handle(request: Request): Promise<Response>;
   private handleCustomRoute;
+  private handleAuth;
   private handleContent;
   private handleTaxonomies;
   private handleMedia;
   private handleOptions;
+  private filterRestrictedFields;
 }
 declare function createCMSRouter(engine: CMSEngine): CMSRouter;
 //#endregion
@@ -1895,5 +2252,443 @@ declare const hrmsPlugin: (options?: void | HRMSPluginOptions | undefined) => CM
  */
 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 };
+//#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, 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 };
 //# sourceMappingURL=index.d.mts.map