@azlib/cms 0.2.0 → 0.4.0

package/dist/index.d.cts

@@ -1,195 +1,3 @@
-//#region src/core/types.d.ts
-/**
- * @azlib/cms - Universal Domain Types & Interfaces
- */
-type ContentStatus = "draft" | "pending_review" | "scheduled" | "published" | "private" | "trash";
-type FieldType = "text" | "slug" | "richText" | "number" | "boolean" | "select" | "image" | "taxonomy" | "relationship" | "date" | "json" | "repeater";
-interface SelectOption {
-  readonly label: string;
-  readonly value: string | number;
-}
-interface FieldDefinition<TValue = any> {
-  readonly name: string;
-  readonly type: FieldType;
-  readonly label?: string;
-  readonly description?: string;
-  readonly required?: boolean;
-  readonly defaultValue?: TValue;
-  readonly unique?: boolean;
-  readonly options?: readonly (string | SelectOption)[];
-  readonly taxonomy?: string;
-  readonly targetCollection?: string;
-  readonly fromField?: string;
-  readonly fields?: readonly FieldDefinition[];
-  readonly min?: number;
-  readonly max?: number;
-  readonly pattern?: string;
-  readonly validate?: (value: any, data: Record<string, unknown>) => string | null | boolean;
-}
-interface CollectionConfig {
-  readonly slug: string;
-  readonly label: string;
-  readonly singularLabel?: string;
-  readonly description?: string;
-  readonly hierarchical?: boolean;
-  readonly timestamps?: boolean;
-  readonly revisions?: boolean;
-  readonly draftable?: boolean;
-  readonly fields: readonly FieldDefinition[];
-  readonly taxonomies?: readonly string[];
-  readonly defaultSort?: {
-    readonly field: string;
-    readonly direction: "asc" | "desc";
-  };
-}
-interface ContentItem<TData extends Record<string, unknown> = Record<string, unknown>> {
-  id: string;
-  collection: string;
-  slug: string;
-  status: ContentStatus;
-  title?: string;
-  parentId?: string | null;
-  authorId?: string | null;
-  publishedAt?: string | null;
-  scheduledAt?: string | null;
-  createdAt: string;
-  updatedAt: string;
-  version: number;
-  data: TData;
-  terms?: Record<string, string[]>;
-}
-interface ContentQueryOptions {
-  status?: ContentStatus | ContentStatus[];
-  authorId?: string;
-  parentId?: string | null;
-  termIds?: string[];
-  search?: string;
-  where?: Record<string, unknown>;
-  orderBy?: string;
-  orderDirection?: "asc" | "desc";
-  limit?: number;
-  offset?: number;
-  includeRevisions?: boolean;
-  includeTerms?: boolean;
-}
-interface PaginatedResult<T> {
-  items: T[];
-  total: number;
-  limit: number;
-  offset: number;
-  hasMore: boolean;
-}
-interface RevisionRecord {
-  id: string;
-  contentId: string;
-  collection: string;
-  version: number;
-  snapshot: ContentItem;
-  authorId?: string | null;
-  note?: string;
-  createdAt: string;
-}
-interface RevisionDiffField {
-  field: string;
-  oldValue: unknown;
-  newValue: unknown;
-}
-interface RevisionDiff {
-  contentId: string;
-  fromVersion: number;
-  toVersion: number;
-  changes: RevisionDiffField[];
-}
-interface TaxonomyConfig {
-  readonly slug: string;
-  readonly label: string;
-  readonly singularLabel?: string;
-  readonly hierarchical?: boolean;
-  readonly postTypes?: readonly string[];
-  readonly description?: string;
-}
-interface TermItem {
-  id: string;
-  taxonomy: string;
-  name: string;
-  slug: string;
-  description?: string;
-  parentId?: string | null;
-  count: number;
-  meta?: Record<string, unknown>;
-  createdAt: string;
-  updatedAt: string;
-}
-interface TermTreeItem extends TermItem {
-  children: TermTreeItem[];
-}
-interface MediaItem {
-  id: string;
-  filename: string;
-  originalName: string;
-  mimeType: string;
-  sizeBytes: number;
-  url: string;
-  path?: string;
-  width?: number;
-  height?: number;
-  altText?: string;
-  caption?: string;
-  authorId?: string | null;
-  variants?: Record<string, string>;
-  createdAt: string;
-  updatedAt: string;
-}
-interface OptionItem<T = unknown> {
-  key: string;
-  value: T;
-  autoload: boolean;
-  namespace?: string;
-  updatedAt: string;
-}
-type UserRole = "admin" | "editor" | "author" | "contributor" | "subscriber" | (string & {});
-type CMSCapability = "manage_options" | "manage_taxonomies" | "upload_files" | "delete_files" | "edit_posts" | "edit_others_posts" | "publish_posts" | "delete_posts" | "delete_others_posts" | "read_private_posts" | (string & {});
-interface CMSUser {
-  id: string;
-  username: string;
-  email: string;
-  displayName: string;
-  role: UserRole;
-  capabilities?: string[];
-  active?: boolean;
-}
-interface SiteConfig {
-  name: string;
-  description?: string;
-  url?: string;
-  logo?: string;
-  locale?: string;
-  timezone?: string;
-}
-interface CMSConfig {
-  site?: SiteConfig;
-  collections: readonly CollectionConfig[];
-  taxonomies?: readonly TaxonomyConfig[];
-  admin?: {
-    route?: string;
-    enableRegistration?: boolean;
-  };
-}
-//#endregion
-//#region src/core/config.d.ts
-/**
- * Default standard collections provided when not explicitly specified.
- */
-declare const DEFAULT_COLLECTIONS: CollectionConfig[];
-/**
- * Type-safe configuration helper function for azlib.config.ts.
- */
-declare function defineConfig(config: CMSConfig): CMSConfig;
-/**
- * Normalize and merge user config with CMS defaults.
- */
-declare function normalizeConfig(config: Partial<CMSConfig>): CMSConfig;
-//#endregion
 //#region src/core/hooks.d.ts
 /**
  * @azlib/cms - WordPress-style Action and Filter Hook System
@@ -565,13 +373,48 @@ declare class CMSEngine {
   readonly revisions: RevisionManager;
   readonly lifecycle: ContentLifecycle;
   private collections;
+  private plugins;
+  private customRoutes;
+  private pendingPluginSetups;
   constructor(config?: Partial<CMSConfig>, storage?: CMSStorageAdapter, hooks?: HooksManager);
+  /**
+   * Register a plugin with the CMS engine.
+   */
+  use(plugin: CMSPlugin): this;
+  /**
+   * Get all registered plugins.
+   */
+  getPlugins(): readonly CMSPlugin[];
+  /**
+   * Get a registered plugin by name.
+   */
+  getPlugin(name: string): CMSPlugin | undefined;
+  /**
+   * Check if a plugin is registered.
+   */
+  hasPlugin(name: string): boolean;
+  /**
+   * Register a collection dynamically.
+   */
+  registerCollection(coll: CollectionConfig): void;
+  /**
+   * Inject additional field definitions into an existing collection.
+   */
+  extendCollection(slug: string, newFields: readonly FieldDefinition[]): void;
+  /**
+   * Register a custom Web Standard HTTP route on the engine.
+   */
+  registerRoute(method: string, path: string, handler: CustomRouteHandler): void;
+  /**
+   * Get all custom routes registered across all HTTP methods.
+   */
+  getCustomRoutes(): Map<string, Map<string, CustomRouteHandler>>;
   /**
    * Initialize storage and trigger bootstrap hooks.
    */
   init(): Promise<void>;
   /**
-   * Close storage connections.
+   * Close storage connections and run plugin teardown hooks.
    */
   close(): Promise<void>;
   /**
@@ -596,40 +439,309 @@ declare class CMSEngine {
  */
 declare function createCMSEngine(config?: Partial<CMSConfig>, storage?: CMSStorageAdapter, hooks?: HooksManager): CMSEngine;
 //#endregion
-//#region src/content/schema.d.ts
-interface TextFieldOptions {
-  name: string;
-  label?: string;
-  description?: string;
-  required?: boolean;
-  defaultValue?: string;
-  unique?: boolean;
-  min?: number;
-  max?: number;
-  pattern?: string;
-  validate?: (value: string, data: Record<string, unknown>) => string | null | boolean;
-}
-interface SlugFieldOptions {
-  name?: string;
-  label?: string;
-  from?: string;
-  required?: boolean;
-  unique?: boolean;
+//#region src/core/plugin.d.ts
+interface RouteContext {
+  readonly params: Record<string, string>;
+  readonly url: URL;
+  readonly engine: CMSEngine;
 }
-interface RichTextFieldOptions {
-  name: string;
-  label?: string;
-  description?: string;
-  required?: boolean;
-  defaultValue?: string;
+type CustomRouteHandler = (request: Request, context: RouteContext) => Promise<Response> | Response;
+interface CMSPluginContext {
+  readonly engine: CMSEngine;
+  readonly hooks: HooksManager;
+  readonly storage: CMSStorageAdapter;
+  readonly options: OptionsManager;
+  readonly taxonomies: TaxonomyManager;
+  readonly media: MediaManager;
+  readonly rbac: RBACManager;
+  readonly revisions: RevisionManager;
+  readonly lifecycle: ContentLifecycle;
+  /**
+   * Register a new collection dynamically.
+   */
+  registerCollection(config: CollectionConfig): void;
+  /**
+   * Extend an existing collection with additional field definitions.
+   */
+  extendCollection(collectionSlug: string, fields: readonly FieldDefinition[]): void;
+  /**
+   * Register a new taxonomy dynamically.
+   */
+  registerTaxonomy(config: TaxonomyConfig): void;
+  /**
+   * Register a custom Web Standard HTTP route on the CMS router.
+   */
+  registerRoute(method: string, path: string, handler: CustomRouteHandler): void;
 }
-interface NumberFieldOptions {
-  name: string;
-  label?: string;
-  description?: string;
-  required?: boolean;
-  defaultValue?: number;
-  min?: number;
+interface CMSPlugin {
+  /**
+   * Unique name of the plugin (e.g. "@azlib/cms-plugin-seo", "audit-log").
+   */
+  readonly name: string;
+  /**
+   * Optional semantic version string.
+   */
+  readonly version?: string;
+  /**
+   * Optional human-readable description.
+   */
+  readonly description?: string;
+  /**
+   * Declarative new collections provided by this plugin.
+   */
+  readonly collections?: readonly CollectionConfig[];
+  /**
+   * Declarative new taxonomies provided by this plugin.
+   */
+  readonly taxonomies?: readonly TaxonomyConfig[];
+  /**
+   * Declarative field extensions to inject into existing collections.
+   * Maps collection slug -> array of field definitions.
+   */
+  readonly extendCollections?: Record<string, readonly FieldDefinition[]>;
+  /**
+   * Setup hook called when the plugin is registered with the engine.
+   * Allows programmatic registration of hooks, routes, services, and schema extensions.
+   */
+  setup?: (context: CMSPluginContext) => void | Promise<void>;
+  /**
+   * Lifecycle hook executed during cms.init().
+   */
+  onInit?: (engine: CMSEngine) => void | Promise<void>;
+  /**
+   * Lifecycle hook executed during cms.close().
+   */
+  onClose?: (engine: CMSEngine) => void | Promise<void>;
+}
+/**
+ * Type-safe helper for authoring reusable CMS plugins and plugin factories.
+ */
+declare function definePlugin<TOptions = void>(factory: (options: TOptions) => CMSPlugin): void extends TOptions ? (options?: TOptions) => CMSPlugin : undefined extends TOptions ? (options?: TOptions) => CMSPlugin : (options: TOptions) => CMSPlugin;
+//#endregion
+//#region src/core/types.d.ts
+type ContentStatus = "draft" | "pending_review" | "scheduled" | "published" | "private" | "trash";
+type FieldType = "text" | "slug" | "richText" | "number" | "boolean" | "select" | "image" | "taxonomy" | "relationship" | "date" | "json" | "repeater";
+interface SelectOption {
+  readonly label: string;
+  readonly value: string | number;
+}
+interface FieldDefinition<TValue = any> {
+  readonly name: string;
+  readonly type: FieldType;
+  readonly label?: string;
+  readonly description?: string;
+  readonly required?: boolean;
+  readonly defaultValue?: TValue;
+  readonly unique?: boolean;
+  readonly options?: readonly (string | SelectOption)[];
+  readonly taxonomy?: string;
+  readonly targetCollection?: string;
+  readonly fromField?: string;
+  readonly fields?: readonly FieldDefinition[];
+  readonly min?: number;
+  readonly max?: number;
+  readonly pattern?: string;
+  readonly validate?: (value: any, data: Record<string, unknown>) => string | null | boolean;
+}
+interface CollectionConfig {
+  readonly slug: string;
+  readonly label: string;
+  readonly singularLabel?: string;
+  readonly description?: string;
+  readonly hierarchical?: boolean;
+  readonly timestamps?: boolean;
+  readonly revisions?: boolean;
+  readonly draftable?: boolean;
+  readonly fields: readonly FieldDefinition[];
+  readonly taxonomies?: readonly string[];
+  readonly defaultSort?: {
+    readonly field: string;
+    readonly direction: "asc" | "desc";
+  };
+}
+interface ContentItem<TData extends Record<string, unknown> = Record<string, unknown>> {
+  id: string;
+  collection: string;
+  slug: string;
+  status: ContentStatus;
+  title?: string;
+  parentId?: string | null;
+  authorId?: string | null;
+  publishedAt?: string | null;
+  scheduledAt?: string | null;
+  createdAt: string;
+  updatedAt: string;
+  version: number;
+  data: TData;
+  terms?: Record<string, string[]>;
+}
+interface ContentQueryOptions {
+  status?: ContentStatus | ContentStatus[];
+  authorId?: string;
+  parentId?: string | null;
+  termIds?: string[];
+  search?: string;
+  where?: Record<string, unknown>;
+  orderBy?: string;
+  orderDirection?: "asc" | "desc";
+  limit?: number;
+  offset?: number;
+  includeRevisions?: boolean;
+  includeTerms?: boolean;
+}
+interface PaginatedResult<T> {
+  items: T[];
+  total: number;
+  limit: number;
+  offset: number;
+  hasMore: boolean;
+}
+interface RevisionRecord {
+  id: string;
+  contentId: string;
+  collection: string;
+  version: number;
+  snapshot: ContentItem;
+  authorId?: string | null;
+  note?: string;
+  createdAt: string;
+}
+interface RevisionDiffField {
+  field: string;
+  oldValue: unknown;
+  newValue: unknown;
+}
+interface RevisionDiff {
+  contentId: string;
+  fromVersion: number;
+  toVersion: number;
+  changes: RevisionDiffField[];
+}
+interface TaxonomyConfig {
+  readonly slug: string;
+  readonly label: string;
+  readonly singularLabel?: string;
+  readonly hierarchical?: boolean;
+  readonly postTypes?: readonly string[];
+  readonly description?: string;
+}
+interface TermItem {
+  id: string;
+  taxonomy: string;
+  name: string;
+  slug: string;
+  description?: string;
+  parentId?: string | null;
+  count: number;
+  meta?: Record<string, unknown>;
+  createdAt: string;
+  updatedAt: string;
+}
+interface TermTreeItem extends TermItem {
+  children: TermTreeItem[];
+}
+interface MediaItem {
+  id: string;
+  filename: string;
+  originalName: string;
+  mimeType: string;
+  sizeBytes: number;
+  url: string;
+  path?: string;
+  width?: number;
+  height?: number;
+  altText?: string;
+  caption?: string;
+  authorId?: string | null;
+  variants?: Record<string, string>;
+  createdAt: string;
+  updatedAt: string;
+}
+interface OptionItem<T = unknown> {
+  key: string;
+  value: T;
+  autoload: boolean;
+  namespace?: string;
+  updatedAt: string;
+}
+type UserRole = "admin" | "editor" | "author" | "contributor" | "subscriber" | (string & {});
+type CMSCapability = "manage_options" | "manage_taxonomies" | "upload_files" | "delete_files" | "edit_posts" | "edit_others_posts" | "publish_posts" | "delete_posts" | "delete_others_posts" | "read_private_posts" | (string & {});
+interface CMSUser {
+  id: string;
+  username: string;
+  email: string;
+  displayName: string;
+  role: UserRole;
+  capabilities?: string[];
+  active?: boolean;
+}
+interface SiteConfig {
+  name: string;
+  description?: string;
+  url?: string;
+  logo?: string;
+  locale?: string;
+  timezone?: string;
+}
+interface CMSConfig {
+  site?: SiteConfig;
+  collections: readonly CollectionConfig[];
+  taxonomies?: readonly TaxonomyConfig[];
+  plugins?: readonly CMSPlugin[];
+  admin?: {
+    route?: string;
+    enableRegistration?: boolean;
+  };
+}
+//#endregion
+//#region src/core/config.d.ts
+/**
+ * Default standard collections provided when not explicitly specified.
+ */
+declare const DEFAULT_COLLECTIONS: CollectionConfig[];
+/**
+ * Type-safe configuration helper function for azlib.config.ts.
+ */
+declare function defineConfig(config: CMSConfig): CMSConfig;
+/**
+ * Normalize and merge user config with CMS defaults.
+ */
+declare function normalizeConfig(config: Partial<CMSConfig>): CMSConfig;
+//#endregion
+//#region src/content/schema.d.ts
+interface TextFieldOptions {
+  name: string;
+  label?: string;
+  description?: string;
+  required?: boolean;
+  defaultValue?: string;
+  unique?: boolean;
+  min?: number;
+  max?: number;
+  pattern?: string;
+  validate?: (value: string, data: Record<string, unknown>) => string | null | boolean;
+}
+interface SlugFieldOptions {
+  name?: string;
+  label?: string;
+  from?: string;
+  required?: boolean;
+  unique?: boolean;
+}
+interface RichTextFieldOptions {
+  name: string;
+  label?: string;
+  description?: string;
+  required?: boolean;
+  defaultValue?: string;
+}
+interface NumberFieldOptions {
+  name: string;
+  label?: string;
+  description?: string;
+  required?: boolean;
+  defaultValue?: number;
+  min?: number;
   max?: number;
 }
 interface BooleanFieldOptions {
@@ -795,11 +907,17 @@ declare class MemoryStorageAdapter implements CMSStorageAdapter {
 //#region src/api/router.d.ts
 declare class CMSRouter {
   private engine;
+  private localRoutes;
   constructor(engine: CMSEngine);
+  /**
+   * Register a custom Web Standard route on the router.
+   */
+  registerRoute(method: string, path: string, handler: CustomRouteHandler): this;
   /**
    * Universal Web Standards request handler.
    */
   handle(request: Request): Promise<Response>;
+  private handleCustomRoute;
   private handleContent;
   private handleTaxonomies;
   private handleMedia;
@@ -828,6 +946,10 @@ declare class CMSClient {
   private fetchFn;
   private headers;
   constructor(options: CMSClientOptions);
+  /**
+   * Access underlying CMSEngine instance when in in-process mode.
+   */
+  getEngine(): CMSEngine | undefined;
   collection<TData extends Record<string, unknown> = Record<string, unknown>>(slug: string): ClientCollectionApi<TData>;
   readonly taxonomies: {
     getTerms: (taxonomy: string) => Promise<TermItem[]>;
@@ -843,9 +965,489 @@ declare class CMSClient {
   readonly options: {
     get: <T = unknown>(key: string, defaultValue?: T) => Promise<T | undefined>;
   };
-  private request;
+  /**
+   * Perform an HTTP request against the CMS API (available in remote mode).
+   */
+  request<T>(endpoint: string, init?: RequestInit): Promise<T>;
 }
 declare function createCmsClient(options: CMSClientOptions): CMSClient;
 //#endregion
-export { type ActionCallback, type BooleanFieldOptions, CMSCapability, CMSClient, type CMSClientOptions, CMSConfig, CMSEngine, CMSRouter, type CMSStorageAdapter, CMSUser, type ClientCollectionApi, CollectionConfig, type CollectionOptions, type CollectionService, ContentItem, ContentLifecycle, ContentQueryOptions, ContentStatus, type CreateContentInput, DEFAULT_COLLECTIONS, DEFAULT_ROLE_CAPABILITIES, type DateFieldOptions, FieldDefinition, FieldType, type FilterCallback, type HookEntry, HooksManager, type ImageFieldOptions, type JsonFieldOptions, MediaItem, MediaManager, type MediaUploadInput, MemoryStorageAdapter, type NumberFieldOptions, OptionItem, OptionsManager, PaginatedResult, RBACManager, type RelationshipFieldOptions, type RepeaterFieldOptions, RevisionDiff, RevisionDiffField, RevisionManager, RevisionRecord, type RichTextFieldOptions, type SelectFieldOptions, SelectOption, SiteConfig, type SlugFieldOptions, type SyncFilterCallback, TaxonomyConfig, type TaxonomyFieldOptions, TaxonomyManager, TermItem, TermTreeItem, type TextFieldOptions, type UpdateContentInput, UserRole, VALID_STATUS_TRANSITIONS, collection, createCMSEngine, createCMSRouter, createCmsClient, defaultHooks, defineConfig, fields, normalizeConfig, resolveUniqueSlug, slugify, validateAndNormalizeData };
+//#region src/plugins/ecommerce/types.d.ts
+type ProductStatus = "draft" | "published" | "out_of_stock" | "archived";
+interface ProductVariant {
+  readonly id: string;
+  readonly title: string;
+  readonly sku?: string;
+  readonly price?: number;
+  readonly compareAtPrice?: number;
+  readonly stock?: number;
+  readonly attributes?: Record<string, string>;
+  readonly image?: string;
+}
+interface ProductImage {
+  readonly id?: string;
+  readonly url: string;
+  readonly altText?: string;
+  readonly caption?: string;
+  readonly width?: number;
+  readonly height?: number;
+}
+interface ProductData extends Record<string, unknown> {
+  sku?: string;
+  price: number;
+  compareAtPrice?: number;
+  costPrice?: number;
+  currency?: string;
+  stock: number;
+  trackInventory?: boolean;
+  status: ProductStatus;
+  description?: string;
+  shortDescription?: string;
+  featuredImage?: string;
+  gallery?: ProductImage[];
+  variants?: ProductVariant[];
+  attributes?: Record<string, unknown>;
+  weight?: number;
+}
+type ProductItem = ContentItem<ProductData>;
+type DiscountType = "percentage" | "fixed_amount" | "free_shipping";
+type DiscountStatus = "active" | "disabled" | "expired";
+interface DiscountData extends Record<string, unknown> {
+  code: string;
+  discountType: DiscountType;
+  value: number;
+  minOrderAmount?: number;
+  maxDiscountAmount?: number;
+  maxUses?: number;
+  usedCount: number;
+  startDate?: string;
+  endDate?: string;
+  status: DiscountStatus;
+  appliesToProductIds?: string[];
+  appliesToCategoryIds?: string[];
+}
+type DiscountItem = ContentItem<DiscountData>;
+type OrderStatus = "pending" | "paid" | "processing" | "shipped" | "delivered" | "cancelled" | "refunded";
+interface OrderLineItem {
+  productId: string;
+  variantId?: string;
+  title: string;
+  sku?: string;
+  price: number;
+  quantity: number;
+  subtotal: number;
+  image?: string;
+}
+interface OrderAddress {
+  firstName?: string;
+  lastName?: string;
+  company?: string;
+  address1: string;
+  address2?: string;
+  city: string;
+  province?: string;
+  country: string;
+  postalCode: string;
+  phone?: string;
+}
+interface OrderData extends Record<string, unknown> {
+  orderNumber: string;
+  customerEmail: string;
+  customerName?: string;
+  status: OrderStatus;
+  currency: string;
+  items: OrderLineItem[];
+  subtotal: number;
+  discountTotal: number;
+  discountCode?: string;
+  shippingTotal: number;
+  taxTotal: number;
+  total: number;
+  shippingAddress?: OrderAddress;
+  billingAddress?: OrderAddress;
+  paymentMethod?: string;
+  notes?: string;
+}
+type OrderItem = ContentItem<OrderData>;
+interface EcommercePluginOptions {
+  /**
+   * Slug for the products collection. Default: "products"
+   */
+  readonly productCollectionSlug?: string;
+  /**
+   * Slug for the discounts collection. Default: "discounts"
+   */
+  readonly discountCollectionSlug?: string;
+  /**
+   * Slug for the orders collection. Default: "orders"
+   */
+  readonly orderCollectionSlug?: string;
+  /**
+   * Slug for the categories taxonomy. Default: "product_categories"
+   */
+  readonly categoriesTaxonomySlug?: string;
+  /**
+   * Slug for the tags taxonomy. Default: "product_tags"
+   */
+  readonly tagsTaxonomySlug?: string;
+  /**
+   * Slug for the brands taxonomy. Default: "product_brands"
+   */
+  readonly brandsTaxonomySlug?: string;
+  /**
+   * Default currency code. Default: "USD"
+   */
+  readonly defaultCurrency?: string;
+  /**
+   * REST API route prefix. Default: "/api/ecommerce"
+   */
+  readonly apiPrefix?: string;
+  /**
+   * Enable inventory management (decrement stock on orders, check availability). Default: true
+   */
+  readonly inventoryManagement?: boolean;
+  /**
+   * Enable orders collection and order routes. Default: true
+   */
+  readonly enableOrders?: boolean;
+  /**
+   * Enable discounts collection and discount calculation. Default: true
+   */
+  readonly enableDiscounts?: boolean;
+  /**
+   * Default flat tax rate multiplier (e.g. 0.08 for 8%). Default: 0
+   */
+  readonly defaultTaxRate?: number;
+  /**
+   * Default flat shipping cost. Default: 0
+   */
+  readonly defaultShippingCost?: number;
+}
+interface CreateProductInput {
+  title: string;
+  slug?: string;
+  price: number;
+  compareAtPrice?: number;
+  costPrice?: number;
+  sku?: string;
+  currency?: string;
+  stock?: number;
+  trackInventory?: boolean;
+  status?: ProductStatus;
+  description?: string;
+  shortDescription?: string;
+  featuredImage?: string;
+  gallery?: ProductImage[];
+  variants?: ProductVariant[];
+  attributes?: Record<string, unknown>;
+  weight?: number;
+  categoryIds?: string[];
+  tagIds?: string[];
+  brandIds?: string[];
+}
+interface UpdateProductInput {
+  title?: string;
+  slug?: string;
+  price?: number;
+  compareAtPrice?: number;
+  costPrice?: number;
+  sku?: string;
+  currency?: string;
+  stock?: number;
+  trackInventory?: boolean;
+  status?: ProductStatus;
+  description?: string;
+  shortDescription?: string;
+  featuredImage?: string;
+  gallery?: ProductImage[];
+  variants?: ProductVariant[];
+  attributes?: Record<string, unknown>;
+  weight?: number;
+  categoryIds?: string[];
+  tagIds?: string[];
+  brandIds?: string[];
+}
+interface CreateDiscountInput {
+  title: string;
+  code: string;
+  discountType: DiscountType;
+  value: number;
+  minOrderAmount?: number;
+  maxDiscountAmount?: number;
+  maxUses?: number;
+  startDate?: string;
+  endDate?: string;
+  status?: DiscountStatus;
+  appliesToProductIds?: string[];
+  appliesToCategoryIds?: string[];
+}
+interface CartItemInput {
+  productId: string;
+  variantId?: string;
+  quantity: number;
+}
+interface CartCalculationInput {
+  items: CartItemInput[];
+  discountCode?: string;
+  shippingCost?: number;
+  taxRate?: number;
+}
+interface CartCalculationResult {
+  items: OrderLineItem[];
+  subtotal: number;
+  discountTotal: number;
+  discountCode?: string;
+  shippingTotal: number;
+  taxTotal: number;
+  total: number;
+  currency: string;
+}
+interface DiscountValidationResult {
+  valid: boolean;
+  code: string;
+  message?: string;
+  discountAmount: number;
+  discountType?: DiscountType;
+  discount?: DiscountItem;
+}
+interface CreateOrderInput {
+  customerEmail: string;
+  customerName?: string;
+  items: CartItemInput[];
+  discountCode?: string;
+  shippingCost?: number;
+  taxRate?: number;
+  shippingAddress?: OrderAddress;
+  billingAddress?: OrderAddress;
+  paymentMethod?: string;
+  notes?: string;
+}
+interface EcommerceProductQuery {
+  categorySlug?: string;
+  categoryId?: string;
+  tagSlug?: string;
+  brandSlug?: string;
+  minPrice?: number;
+  maxPrice?: number;
+  inStock?: boolean;
+  status?: ProductStatus | ProductStatus[];
+  search?: string;
+  orderBy?: "price" | "createdAt" | "title" | "stock";
+  orderDirection?: "asc" | "desc";
+  limit?: number;
+  offset?: number;
+}
+//#endregion
+//#region src/plugins/ecommerce/service.d.ts
+declare class EcommerceService {
+  readonly engine: CMSEngine;
+  readonly options: EcommercePluginOptions;
+  readonly productSlug: string;
+  readonly discountSlug: string;
+  readonly orderSlug: string;
+  readonly categoriesTaxonomy: string;
+  readonly tagsTaxonomy: string;
+  readonly brandsTaxonomy: string;
+  readonly defaultCurrency: string;
+  readonly inventoryManagement: boolean;
+  constructor(engine: CMSEngine, options?: EcommercePluginOptions);
+  private get productsCollection();
+  private get discountsCollection();
+  private get ordersCollection();
+  /**
+   * Create a new product in the catalog.
+   */
+  createProduct(input: CreateProductInput, authorId?: string | null): Promise<ProductItem>;
+  /**
+   * Update an existing product.
+   */
+  updateProduct(id: string, input: UpdateProductInput, authorId?: string | null): Promise<ProductItem | null>;
+  /**
+   * Get a product by ID.
+   */
+  getProduct(id: string): Promise<ProductItem | null>;
+  /**
+   * Get a product by its URL slug.
+   */
+  getProductBySlug(slug: string): Promise<ProductItem | null>;
+  /**
+   * Delete a product by ID.
+   */
+  deleteProduct(id: string): Promise<boolean>;
+  /**
+   * List and filter catalog products.
+   */
+  listProducts(query?: EcommerceProductQuery): Promise<PaginatedResult<ProductItem>>;
+  /**
+   * Upload and link a product image to its gallery and featured slot.
+   */
+  uploadProductImage(productId: string, file: {
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
+    url?: string;
+    altText?: string;
+    caption?: string;
+    width?: number;
+    height?: number;
+    isFeatured?: boolean;
+  }, authorId?: string | null): Promise<{
+    media: MediaItem;
+    product: ProductItem;
+  }>;
+  /**
+   * Adjust inventory stock for a product or variant.
+   */
+  adjustStock(productId: string, delta: number, variantId?: string): Promise<ProductItem | null>;
+  /**
+   * Create a catalog category in the hierarchical category taxonomy.
+   */
+  createCategory(input: {
+    name: string;
+    slug?: string;
+    parentId?: string | null;
+    description?: string;
+    meta?: Record<string, unknown>;
+  }): Promise<TermItem>;
+  /**
+   * Get all catalog categories.
+   */
+  getCategories(options?: {
+    parentId?: string | null;
+  }): Promise<TermItem[]>;
+  /**
+   * Get full hierarchical catalog category tree.
+   */
+  getCategoryTree(): Promise<TermTreeItem[]>;
+  /**
+   * Assign category IDs to a product.
+   */
+  assignProductCategory(productId: string, categoryIds: string | string[]): Promise<void>;
+  /**
+   * Get assigned categories for a product.
+   */
+  getProductCategories(productId: string): Promise<TermItem[]>;
+  /**
+   * Create a promotional coupon / discount code.
+   */
+  createDiscount(input: CreateDiscountInput, authorId?: string | null): Promise<DiscountItem>;
+  /**
+   * Find a discount code.
+   */
+  getDiscountByCode(code: string): Promise<DiscountItem | null>;
+  /**
+   * Validate a discount coupon against cart items and order subtotal.
+   */
+  validateDiscount(code: string, cartSubtotal: number, productIds?: string[]): Promise<DiscountValidationResult>;
+  /**
+   * Calculate cart subtotals, apply discounts, shipping, and taxes.
+   */
+  calculateCart(input: CartCalculationInput): Promise<CartCalculationResult>;
+  /**
+   * Place a new order with cart validation, inventory deduction, and coupon counter updates.
+   */
+  createOrder(input: CreateOrderInput, authorId?: string | null): Promise<OrderItem>;
+  /**
+   * Get order by ID.
+   */
+  getOrder(id: string): Promise<OrderItem | null>;
+  /**
+   * Get order by order number.
+   */
+  getOrderByNumber(orderNumber: string): Promise<OrderItem | null>;
+  /**
+   * Update the status of an order (e.g. pending -> paid -> shipped).
+   */
+  updateOrderStatus(id: string, status: OrderStatus, note?: string): Promise<OrderItem | null>;
+}
+//#endregion
+//#region src/plugins/ecommerce/schemas.d.ts
+/**
+ * Creates the collection configuration for Products.
+ */
+declare function createProductCollection(options?: EcommercePluginOptions): CollectionConfig;
+/**
+ * Creates the collection configuration for Discounts / Coupons.
+ */
+declare function createDiscountCollection(options?: EcommercePluginOptions): CollectionConfig;
+/**
+ * Creates the collection configuration for Orders.
+ */
+declare function createOrderCollection(options?: EcommercePluginOptions): CollectionConfig;
+/**
+ * Creates the standard e-commerce taxonomies: product categories, tags, and brands.
+ */
+declare function createEcommerceTaxonomies(options?: EcommercePluginOptions): TaxonomyConfig[];
+//#endregion
+//#region src/plugins/ecommerce/client.d.ts
+declare class EcommerceClient {
+  private client;
+  private options;
+  private service?;
+  private prefix;
+  constructor(client: CMSClient, options?: EcommercePluginOptions);
+  readonly products: {
+    find: (query?: EcommerceProductQuery) => Promise<PaginatedResult<ProductItem>>;
+    get: (idOrSlug: string, by?: "id" | "slug") => Promise<ProductItem | null>;
+    create: (data: CreateProductInput) => Promise<ProductItem>;
+    update: (id: string, data: UpdateProductInput) => Promise<ProductItem | null>;
+    delete: (id: string) => Promise<boolean>;
+    uploadImage: (productId: string, file: {
+      filename: string;
+      mimeType: string;
+      sizeBytes: number;
+      url?: string;
+      altText?: string;
+      caption?: string;
+      width?: number;
+      height?: number;
+      isFeatured?: boolean;
+    }) => Promise<{
+      media: MediaItem;
+      product: ProductItem;
+    }>;
+  };
+  readonly categories: {
+    list: (options?: {
+      parentId?: string | null;
+    }) => Promise<TermItem[]>;
+    tree: () => Promise<TermTreeItem[]>;
+    create: (input: {
+      name: string;
+      slug?: string;
+      parentId?: string | null;
+      description?: string;
+    }) => Promise<TermItem>;
+  };
+  readonly discounts: {
+    validate: (code: string, subtotal: number, productIds?: string[]) => Promise<DiscountValidationResult>;
+    create: (input: CreateDiscountInput) => Promise<DiscountItem>;
+  };
+  readonly cart: {
+    calculate: (input: CartCalculationInput) => Promise<CartCalculationResult>;
+  };
+  readonly orders: {
+    create: (input: CreateOrderInput) => Promise<OrderItem>;
+    get: (idOrNumber: string, by?: "id" | "number") => Promise<OrderItem | null>;
+    updateStatus: (id: string, status: OrderStatus, note?: string) => Promise<OrderItem | null>;
+  };
+}
+/**
+ * Get or create an EcommerceClient adapter for a CMSClient.
+ */
+declare function getEcommerceClient(client: CMSClient, options?: EcommercePluginOptions): EcommerceClient;
+//#endregion
+//#region src/plugins/ecommerce/index.d.ts
+/**
+ * Built-in E-commerce plugin factory for @azlib/cms.
+ * Equips the CMS engine with product catalogs, hierarchical categories,
+ * image uploading, discount coupons, cart calculation, and order tracking.
+ */
+declare const ecommercePlugin: (options?: void | EcommercePluginOptions | undefined) => CMSPlugin;
+/**
+ * Retrieve the active EcommerceService instance associated with a CMSEngine.
+ */
+declare function getEcommerceService(engine: CMSEngine, options?: EcommercePluginOptions): EcommerceService;
+//#endregion
+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 };
 //# sourceMappingURL=index.d.cts.map