@kyro-cms/core 0.12.71 → 0.13.0

package/dist/client.d.ts

@@ -0,0 +1,1248 @@
+/**
+ * Serializable condition for conditional field visibility.
+ * Unlike function conditions, these survive JSON serialization
+ * and can be used in admin configs that are built at compile time.
+ */
+type DeclarativeCondition = {
+    /** The field name to evaluate (resolved from root form data, supports dot-notation) */
+    field: string;
+    /** Show the field when the target field equals this value */
+    equals?: string | number | boolean;
+    /** Show the field when the target field does NOT equal this value */
+    notEquals?: string | number | boolean;
+    /** Show the field when the target field's value is one of these */
+    in?: (string | number | boolean)[];
+    /** Show the field when the target field's value is greater than this */
+    greaterThan?: number;
+} | {
+    and: DeclarativeCondition[];
+} | {
+    or: DeclarativeCondition[];
+};
+interface FieldAdmin {
+    description?: string;
+    placeholder?: string;
+    readOnly?: boolean | ((data: Record<string, unknown>, siblingData: Record<string, unknown>) => boolean);
+    hidden?: boolean | ((data: Record<string, unknown>, siblingData: Record<string, unknown>) => boolean);
+    width?: string;
+    position?: "sidebar" | "main";
+    autoGenerate?: string;
+    action?: string;
+    method?: string;
+    inline?: boolean;
+    compact?: boolean;
+    display?: "receipt" | "table" | "default";
+    collapsible?: boolean;
+    initCollapsed?: boolean;
+    pickerMode?: "drawer" | "dropdown";
+    condition?: ((data: Record<string, unknown>, siblingData: Record<string, unknown>) => boolean) | DeclarativeCondition;
+}
+interface FieldAccess {
+    read?: (args: {
+        user: any;
+        req?: Request;
+        doc?: any;
+        data?: any;
+        siblingData?: any;
+    }) => boolean | Promise<boolean>;
+    update?: (args: {
+        user: any;
+        req?: Request;
+        doc?: any;
+        data?: any;
+        siblingData?: any;
+    }) => boolean | Promise<boolean>;
+    create?: (args: {
+        user: any;
+        req?: Request;
+        doc?: any;
+        data?: any;
+        siblingData?: any;
+    }) => boolean | Promise<boolean>;
+}
+interface BaseField {
+    name: string;
+    label?: string;
+    required?: boolean;
+    unique?: boolean;
+    indexed?: boolean;
+    defaultValue?: any;
+    admin?: FieldAdmin;
+    access?: FieldAccess;
+    validate?: (value: any, options: ValidateOptions) => string | true | Promise<string | true>;
+    hooks?: {
+        beforeValidate?: Hook$1[];
+        beforeChange?: Hook$1[];
+        afterChange?: Hook$1[];
+        afterRead?: Hook$1[];
+    };
+}
+interface ValidateOptions {
+    data?: Record<string, any>;
+    siblingData?: Record<string, any>;
+    user?: unknown;
+    operation?: string;
+    required?: boolean;
+}
+type Hook$1 = (args: any) => Promise<any> | any;
+type TextFieldVariant = "text" | "email" | "password" | "url" | "id";
+interface TextField extends BaseField {
+    type: "text";
+    variant?: TextFieldVariant;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    hasMany?: boolean;
+    localized?: boolean;
+}
+interface NumberField extends BaseField {
+    type: "number";
+    min?: number;
+    max?: number;
+    step?: number;
+    integer?: boolean;
+    hasMany?: boolean;
+}
+interface CheckboxField extends BaseField {
+    type: "checkbox";
+}
+interface DateField extends BaseField {
+    type: "date";
+    minDate?: string;
+    maxDate?: string;
+    time?: boolean;
+}
+interface EmailField extends BaseField {
+    type: "email";
+}
+interface PasswordField extends BaseField {
+    type: "password";
+}
+interface TextareaField extends BaseField {
+    type: "textarea";
+    minLength?: number;
+    maxLength?: number;
+    rows?: number;
+    localized?: boolean;
+}
+interface SelectField extends BaseField {
+    type: "select";
+    options?: Array<{
+        label: string;
+        value: string;
+    }> | ((args: {
+        data: any;
+        siblingData: any;
+    }) => Array<{
+        label: string;
+        value: string;
+    }>);
+    dynamicOptions?: string;
+    hasMany?: boolean;
+    defaultValue?: string | string[];
+}
+interface RadioField extends BaseField {
+    type: "radio";
+    options: Array<{
+        label: string;
+        value: string;
+    }> | ((args: {
+        data: any;
+        siblingData: any;
+    }) => Array<{
+        label: string;
+        value: string;
+    }>);
+    defaultValue?: string;
+}
+interface ColorField extends BaseField {
+    type: "color";
+    format?: "hex" | "rgb" | "hsl";
+    defaultValue?: string;
+}
+interface ImageField extends BaseField {
+    type: "image";
+    minCount?: number;
+    maxCount?: number;
+    allowedTypes?: string[];
+    maxSize?: number;
+}
+type RichTextBlock = Record<string, any>;
+interface RichTextField extends BaseField {
+    type: "richtext";
+    defaultValue?: Record<string, any>;
+    localized?: boolean;
+}
+interface JSONField extends BaseField {
+    type: "json";
+    defaultValue?: Record<string, any>;
+}
+interface CodeField extends BaseField {
+    type: "code";
+    language?: string;
+    defaultValue?: string;
+}
+interface UploadField extends BaseField {
+    type: "upload";
+    relationTo: string;
+    hasMany?: boolean;
+    maxDepth?: number;
+    defaultValue?: string;
+}
+interface MarkdownField extends BaseField {
+    type: "markdown";
+    localized?: boolean;
+    defaultValue?: string;
+}
+interface RelationshipField extends BaseField {
+    type: "relationship";
+    /**
+     * The collection slug(s) to relate to.
+     * Use "*" to allow relating to ANY registered collection.
+     */
+    relationTo: string | string[];
+    hasMany?: boolean;
+    maxDepth?: number;
+    filterOptions?: (args: {
+        data: any;
+        user: any;
+    }) => Record<string, any>;
+    defaultValue?: string | string[];
+}
+interface ArrayField extends BaseField {
+    type: "array";
+    fields: Field[];
+    minRows?: number;
+    maxRows?: number;
+    labels?: {
+        singular?: string;
+        plural?: string;
+    };
+    defaultValue?: Record<string, any>[];
+}
+interface ListField extends BaseField {
+    type: "list";
+    defaultValue?: string[];
+}
+interface GroupField extends BaseField {
+    type: "group";
+    fields: Field[];
+    defaultValue?: Record<string, any>;
+}
+interface BlockImage {
+    url: string;
+    alt?: string;
+}
+interface BlockAdmin {
+    group?: string;
+    description?: string;
+    images?: {
+        icon?: BlockImage | string;
+        thumbnail?: BlockImage | string;
+    };
+}
+interface Block {
+    slug: string;
+    label: string;
+    fields: Field[];
+    imageURL?: string;
+    admin?: BlockAdmin;
+}
+interface BlocksField extends BaseField {
+    type: "blocks";
+    blocks?: Block[];
+    minRows?: number;
+    maxRows?: number;
+    defaultValue?: Array<{
+        blockType: string;
+        [key: string]: any;
+    }>;
+}
+interface RowField extends Omit<BaseField, "name"> {
+    type: "row";
+    fields: Field[];
+    name?: string;
+}
+interface CollapsibleField extends Omit<BaseField, "name"> {
+    type: "collapsible";
+    fields: Field[];
+    label: string;
+    name?: string;
+}
+interface TabsField extends Omit<BaseField, "name"> {
+    type: "tabs";
+    tabs: Array<{
+        label: string;
+        fields: Field[];
+        name?: string;
+    }>;
+    name?: string;
+}
+interface ButtonField extends BaseField {
+    type: "button";
+    label: string;
+    action?: string;
+    method?: string;
+    inline?: boolean;
+}
+interface ActionField extends BaseField {
+    type: "action";
+    label: string;
+    action?: string;
+    method?: string;
+    inline?: boolean;
+}
+interface SecretField extends BaseField {
+    type: "secret";
+}
+interface IconField extends BaseField {
+    type: "icon";
+}
+interface EmbeddingField extends BaseField {
+    type: "embedding";
+    sourceField: string;
+    provider?: "openai" | "cohere" | "groq" | "local-fastembed";
+    model?: string;
+    dimensions?: number;
+}
+type Field = TextField | NumberField | CheckboxField | DateField | EmailField | PasswordField | TextareaField | SelectField | RadioField | ColorField | ImageField | RichTextField | JSONField | CodeField | UploadField | MarkdownField | RelationshipField | ArrayField | ListField | GroupField | BlocksField | RowField | CollapsibleField | TabsField | ButtonField | ActionField | SecretField | IconField | EmbeddingField;
+type FieldType = Field["type"];
+declare const ALL_FIELD_TYPES: readonly ["text", "number", "checkbox", "date", "email", "password", "textarea", "select", "radio", "color", "icon", "richtext", "json", "code", "upload", "image", "markdown", "embedding", "relationship", "array", "group", "blocks", "row", "collapsible", "tabs"];
+
+interface Request$1 {
+    body?: any;
+    headers: Record<string, string>;
+    method?: string;
+    url?: string;
+    cookies?: Record<string, string>;
+    query?: Record<string, any>;
+}
+interface User {
+    id: string;
+    email: string;
+    role: string;
+    tenantId?: string;
+    [key: string]: any;
+}
+interface HookArgs<T = any> {
+    collection?: string;
+    global?: string;
+    data?: T;
+    originalDoc?: T;
+    doc?: T;
+    req: Request$1;
+    user?: User;
+    operation: 'create' | 'read' | 'update' | 'delete';
+    tenantId?: string;
+    field?: string;
+    siblingData?: Record<string, any>;
+    value?: any;
+    previousValue?: any;
+    context?: Record<string, any>;
+}
+type Hook<T = any> = (args: HookArgs<T>) => Promise<T | void> | T | void;
+interface CollectionHooks {
+    beforeValidate?: Hook[];
+    beforeChange?: Hook[];
+    afterChange?: Hook[];
+    beforeRead?: Hook[];
+    afterRead?: Hook[];
+    beforeDelete?: Hook[];
+    afterDelete?: Hook[];
+    beforeLogin?: Hook[];
+    afterLogin?: Hook[];
+    afterLogout?: Hook[];
+    afterRefresh?: Hook[];
+    afterForgotPassword?: Hook[];
+}
+interface GlobalHooks {
+    beforeValidate?: Hook[];
+    beforeChange?: Hook[];
+    afterChange?: Hook[];
+    beforeRead?: Hook[];
+    afterRead?: Hook[];
+}
+
+interface PluginHooks {
+    beforeInit?: Hook[];
+    afterInit?: Hook[];
+    beforeRegisterCollections?: Hook[];
+    afterRegisterCollections?: Hook[];
+    beforeRegisterGlobals?: Hook[];
+    afterRegisterGlobals?: Hook[];
+    beforeServerStart?: Hook[];
+    afterServerStart?: Hook[];
+    beforeServerStop?: Hook[];
+    afterServerStop?: Hook[];
+}
+interface PluginCollectionExtension {
+    slug: string;
+    config: Partial<CollectionConfig>;
+}
+interface PluginGlobalExtension {
+    slug: string;
+    config: Partial<GlobalConfig>;
+}
+interface PluginFieldExtension {
+    collectionSlug: string;
+    field: Field;
+}
+interface PluginAPI {
+    registry: {
+        getCollection: (slug: string) => CollectionConfig | undefined;
+        getCollections: () => CollectionConfig[];
+        getGlobal: (slug: string) => GlobalConfig | undefined;
+        addCollection: (config: CollectionConfig) => void;
+        addGlobal: (config: GlobalConfig) => void;
+        extendCollection: (slug: string, extension: Partial<CollectionConfig>) => void;
+        extendGlobal: (slug: string, extension: Partial<GlobalConfig>) => void;
+        addField: (collectionSlug: string, field: Field, position?: number) => void;
+    };
+    hooks: {
+        register: (event: string, handler: Hook) => void;
+        unregister: (event: string, handler: Hook) => void;
+    };
+    config: {
+        get: (key: string) => any;
+        set: (key: string, value: any) => void;
+    };
+    db: any;
+}
+declare abstract class KyroPlugin {
+    name: string;
+    displayName?: string;
+    adminEntry?: string;
+    version?: string;
+    description?: string;
+    hooks: PluginHooks;
+    collections: Partial<CollectionConfig>[];
+    globals: Partial<GlobalConfig>[];
+    fields: PluginFieldExtension[];
+    extensions: {
+        collections: PluginCollectionExtension[];
+        globals: PluginGlobalExtension[];
+    };
+    adminComponents: Record<string, any>;
+    adminStyles: string[];
+    serverMiddleware?: (app: any) => void;
+    clientMiddleware?: (req: any) => any;
+    constructor(name: string);
+    init?(api: PluginAPI): Promise<void>;
+    beforeInit?(api: PluginAPI): Promise<void>;
+    afterInit?(api: PluginAPI): Promise<void>;
+    getCollections?(): Partial<CollectionConfig>[];
+    getGlobals?(): Partial<GlobalConfig>[];
+    getHooks?(): PluginHooks;
+}
+
+interface WhereClause {
+    [field: string]: any;
+}
+interface AccessArgs {
+    req: Request$1;
+    user?: User;
+    data?: unknown;
+    doc?: unknown;
+    id?: string;
+    tenantId?: string;
+    context?: Record<string, unknown>;
+}
+type AccessControl = boolean | ((args: AccessArgs) => Promise<boolean | WhereClause> | boolean | WhereClause);
+interface CollectionAccess {
+    create?: AccessControl;
+    read?: AccessControl;
+    update?: AccessControl;
+    delete?: AccessControl;
+    admin?: AccessControl;
+    unlock?: AccessControl;
+    readVersions?: AccessControl;
+}
+interface GlobalAccess {
+    read?: AccessControl;
+    update?: AccessControl;
+}
+
+type AuditAction = "login" | "logout" | "login_failed" | "register" | "verify_email" | "password_change" | "password_reset" | "password_reset_request" | "role_change" | "permission_change" | "document_create" | "document_update" | "document_delete" | "settings_change" | "user_lockout" | "user_unlock" | "user_create" | "user_update" | "user_delete" | "api_request" | "api_key_create" | "api_key_update" | "api_key_rotate" | "api_key_delete" | "tenant_create" | "tenant_delete";
+interface AuditLog {
+    id: string;
+    timestamp: Date;
+    action: AuditAction;
+    userId?: string;
+    userEmail?: string;
+    role?: string;
+    resource: string;
+    resourceId?: string;
+    changes?: {
+        field: string;
+        old: any;
+        new: any;
+    }[];
+    ipAddress?: string;
+    userAgent?: string;
+    success: boolean;
+    error?: string;
+    metadata?: Record<string, any>;
+}
+interface AuditLogFilter {
+    userId?: string;
+    action?: AuditAction | AuditAction[];
+    resource?: string;
+    resourceId?: string;
+    success?: boolean;
+    startDate?: Date;
+    endDate?: Date;
+    limit?: number;
+    offset?: number;
+}
+
+interface AuthUser {
+    id: string;
+    name?: string;
+    email: string;
+    passwordHash?: string;
+    role: UserRole;
+    avatar?: string;
+    tenantId?: string;
+    emailVerified?: boolean;
+    locked?: boolean;
+    lastLogin?: string;
+    failedLoginAttempts?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+type UserRole = "super_admin" | "admin" | "editor" | "author" | "customer" | "guest";
+interface Session {
+    id: string;
+    userId: string;
+    token: string;
+    refreshToken?: string;
+    expiresAt: string;
+    createdAt: string;
+    ipAddress?: string;
+    userAgent?: string;
+}
+interface JWTPayload {
+    sub: string;
+    email: string;
+    role: UserRole;
+    tenantId?: string;
+    iat?: number;
+    exp?: number;
+    sid?: string;
+}
+interface AuthTokenConfig {
+    secret: string;
+    expiresIn?: string | number;
+    refreshExpiresIn?: string | number;
+    issuer?: string;
+    audience?: string[];
+    saltRounds?: number;
+}
+interface LoginCredentials {
+    email: string;
+    password: string;
+}
+interface RegisterData {
+    email: string;
+    password: string;
+    role?: UserRole;
+    tenantId?: string;
+}
+interface AuthResult {
+    success: boolean;
+    user?: AuthUser;
+    session?: Session;
+    token?: string;
+    error?: string;
+}
+interface AuthAdapter {
+    createUser(data: {
+        email: string;
+        password: string;
+        name?: string;
+        role?: UserRole;
+        avatar?: string;
+        tenantId?: string;
+    }): Promise<AuthUser>;
+    findUserByEmail(email: string): Promise<AuthUser | null>;
+    findUserById(id: string): Promise<AuthUser | null>;
+    updateUser(id: string, data: Partial<AuthUser> & {
+        password?: string;
+    }): Promise<AuthUser | null>;
+    deleteUser(id: string): Promise<boolean>;
+    verifyPassword(email: string, password: string): Promise<AuthUser | null>;
+    hashPassword(password: string): Promise<string>;
+    createSession(userId: string, data?: {
+        ipAddress?: string;
+        userAgent?: string;
+    }): Promise<Session>;
+    findSessionByToken(token: string): Promise<Session | null>;
+    findSessionByRefreshToken(refreshToken: string): Promise<Session | null>;
+    deleteSession(sessionId: string): Promise<boolean>;
+    deleteUserSessions(userId: string): Promise<number>;
+    createEmailVerificationToken(userId: string): Promise<{
+        token: string;
+        expiresAt: Date;
+    }>;
+    verifyEmailToken(token: string): Promise<{
+        success: boolean;
+        userId?: string;
+        error?: string;
+    }>;
+    createPasswordResetToken(email: string): Promise<{
+        token: string;
+        expiresAt: Date;
+        error?: string;
+    }>;
+    resetPasswordWithToken(token: string, newPassword: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    hasAnyUsers?(): Promise<boolean>;
+    connect?(): Promise<void>;
+    disconnect?(): Promise<void>;
+    addPasswordToHistory?(userId: string, passwordHash: string): Promise<void>;
+    getPasswordHistory?(userId: string, count?: number): Promise<string[]>;
+    isPasswordInHistory?(password: string, userId: string, historyCount?: number): Promise<boolean>;
+    findAuditLogs(filter: AuditLogFilter): Promise<{
+        logs: AuditLog[];
+        total: number;
+    }>;
+    createAuditLog(data: Omit<AuditLog, "id" | "timestamp">): Promise<AuditLog>;
+}
+
+interface TenantContext {
+    tenantId: string;
+    userId: string;
+    role?: string;
+    roles?: string[];
+    permissions?: string[];
+    isSuperAdmin?: boolean;
+}
+
+interface UploadOptions {
+    folder?: string;
+    filename?: string;
+    mimeType?: string;
+    metadata?: Record<string, unknown>;
+}
+interface UploadedFile {
+    id: string;
+    filename: string;
+    originalName: string;
+    mimeType: string;
+    size: number;
+    url: string;
+    thumbnailUrl?: string;
+    width?: number;
+    height?: number;
+    folder?: string;
+    provider: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+}
+interface ImageTransforms {
+    width?: number;
+    height?: number;
+    fit?: "clip" | "crop" | "fill" | "fillmax" | "scale" | "max" | "min";
+    format?: "webp" | "avif" | "jpeg" | "jpg" | "png" | "gif";
+    quality?: number;
+    blur?: number;
+    sharpen?: number;
+    /** Crop region as percentages (0-100) of the original image */
+    cropX?: number;
+    cropY?: number;
+    cropWidth?: number;
+    cropHeight?: number;
+}
+interface StorageProvider {
+    name: string;
+    displayName: string;
+    supportsDynamicResize: boolean;
+    upload(file: File, options?: UploadOptions): Promise<UploadedFile>;
+    uploadFromUrl(url: string, options?: UploadOptions): Promise<UploadedFile>;
+    delete(url: string): Promise<void>;
+    rename(oldUrl: string, newKey: string): Promise<string>;
+    getImageUrl(url: string, transforms?: ImageTransforms): string;
+    generateThumbnail(file: UploadedFile, size: {
+        width: number;
+        height: number;
+    }): Promise<string>;
+    list(prefix?: string): Promise<UploadedFile[]>;
+    exists(url: string): Promise<boolean>;
+    createFolder?(folder: string): Promise<void>;
+    deleteFolder?(folder: string): Promise<void>;
+}
+
+interface AdminConfig {
+    useAsTitle?: string;
+    defaultColumns?: string[];
+    hidden?: boolean;
+    description?: string;
+    hideAPIURL?: boolean;
+    group?: string;
+    folder?: string;
+    parentFolder?: string;
+    treeHierarchy?: boolean;
+    icon?: string;
+    order?: number;
+    preview?: (doc: Record<string, unknown>, options: {
+        req: unknown;
+        token?: string;
+    }) => string | Promise<string>;
+    disableDuplicate?: boolean;
+    disablePreview?: boolean;
+    pagination?: {
+        defaultLimit?: number;
+        limits?: number[];
+    };
+    layout?: "split" | "single";
+    smartViews?: SmartViewConfig[];
+}
+interface HierarchyConfig {
+    parentField?: string;
+    maxDepth?: number;
+    slugPrefix?: boolean;
+}
+interface ProjectConfig {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    environment?: 'development' | 'staging' | 'production' | string;
+    collections?: string[];
+    globals?: string[];
+    settings?: Record<string, unknown>;
+}
+interface SmartViewConfig {
+    id: string;
+    name: string;
+    icon?: string;
+    color?: string;
+    filter: Record<string, any>;
+    collections?: string[];
+    description?: string;
+}
+interface OrganizationConfig {
+    id: string;
+    name: string;
+    slug: string;
+    billingEmail?: string;
+    projects?: ProjectConfig[];
+    roles?: Array<{
+        name: string;
+        description?: string;
+        permissions?: string[];
+    }>;
+}
+interface FieldOverrides {
+    [fieldPath: string]: any;
+}
+interface CollectionOverrideConfig extends Partial<AdminConfig> {
+    label?: string;
+    singularLabel?: string;
+    labelPlural?: string;
+    labels?: {
+        singular?: string;
+        plural?: string;
+    };
+    hidden?: boolean;
+    timestamps?: boolean;
+    versions?: {
+        drafts?: boolean;
+        maxPerDoc?: number;
+        autosave?: boolean;
+    };
+    seo?: boolean | Record<string, any>;
+    access?: CollectionAccess;
+    hooks?: CollectionHooks;
+    fields?: FieldOverrides;
+    blocks?: Record<string, any> | any[];
+    tabs?: Record<string, any> | any[];
+    [key: string]: any;
+}
+interface GlobalOverrideConfig extends Partial<AdminConfig> {
+    label?: string;
+    hidden?: boolean;
+    access?: GlobalAccess;
+    hooks?: GlobalHooks;
+    fields?: FieldOverrides;
+    blocks?: Record<string, any> | any[];
+    tabs?: Record<string, any> | any[];
+    [key: string]: any;
+}
+interface UploadConfig {
+    staticDir?: string;
+    staticURL?: string;
+    mimeTypes?: string[];
+    fileSize?: number;
+    imageSizes?: ImageSize[];
+    crop?: boolean;
+    focalPoint?: boolean;
+    formatOptions?: {
+        format: "webp" | "png" | "jpg" | "avif";
+        options?: Record<string, unknown>;
+    };
+    resizeOptions?: Record<string, any>;
+    adminThumbnail?: string;
+}
+interface ImageSize {
+    name: string;
+    width?: number;
+    height?: number;
+    crop?: string;
+    position?: string;
+    formatOptions?: {
+        format: "webp" | "png" | "jpg" | "avif";
+    };
+    generateImageName?: (doc: any) => string;
+}
+interface VersionConfig {
+    maxPerDoc?: number;
+    drafts?: boolean;
+    retainDeleted?: boolean;
+}
+type DocumentStatus = 'draft' | 'published' | 'archived';
+interface AuthConfig {
+    tokenExpiration?: number;
+    verify?: boolean | {
+        generateEmailHTML?: (args: any) => string;
+    };
+    maxLoginAttempts?: number;
+    lockTime?: number;
+    cookies?: {
+        secure?: boolean;
+        sameSite?: "strict" | "lax" | "none";
+        domain?: string;
+    };
+    forgotPassword?: {
+        generateEmailHTML?: (args: any) => string;
+        generateEmailSubject?: (args: any) => string;
+    };
+    strategies?: Array<{
+        name: string;
+        authenticate: (args: any) => Promise<any>;
+    }>;
+}
+interface CollectionConfig {
+    slug: string;
+    label?: string;
+    labelPlural?: string;
+    singularLabel?: string;
+    admin?: AdminConfig;
+    fields: Field[];
+    access?: CollectionAccess;
+    hooks?: CollectionHooks;
+    timestamps?: boolean;
+    tenantScoped?: boolean;
+    tenantField?: string;
+    upload?: UploadConfig;
+    versions?: VersionConfig;
+    folder?: string;
+    hierarchy?: HierarchyConfig;
+    auth?: boolean | AuthConfig;
+    graphQL?: {
+        singularName?: string;
+        pluralName?: string;
+    };
+    indexes?: Array<{
+        fields: Record<string, number | "text">;
+        options?: Record<string, any>;
+    }>;
+    seo?: boolean | Record<string, any>;
+    custom?: Record<string, any>;
+    tabs?: Array<{
+        label: string;
+        fields: Field[];
+        name?: string;
+    }>;
+}
+interface GlobalConfig {
+    slug: string;
+    label?: string;
+    folder?: string;
+    admin?: AdminConfig;
+    fields: Field[];
+    access?: GlobalAccess;
+    hooks?: GlobalHooks;
+    versions?: VersionConfig;
+    graphQL?: {
+        name?: string;
+    };
+    typescript?: {
+        interface?: string;
+    };
+    custom?: Record<string, any>;
+    tabs?: Array<{
+        label: string;
+        fields: Field[];
+        name?: string;
+    }>;
+}
+interface FindArgs {
+    collection: string;
+    where?: Record<string, any>;
+    sort?: string;
+    limit?: number;
+    page?: number;
+    depth?: number;
+    tenantId?: string;
+    select?: string[];
+    user?: any;
+    context?: Record<string, any>;
+    overrideAccess?: boolean;
+    /** If true, returns draft docs (admin view). If false/omitted, only published docs are returned (public API). */
+    draft?: boolean;
+}
+interface FindOneArgs {
+    collection: string;
+    where: Record<string, any>;
+    tenantId?: string;
+    draft?: boolean;
+    depth?: number;
+    select?: string[];
+}
+interface FindByIDArgs {
+    collection: string;
+    id: string;
+    depth?: number;
+    tenantId?: string;
+    select?: string[];
+    user?: any;
+    context?: Record<string, any>;
+    overrideAccess?: boolean;
+    /** If true, returns document regardless of status (admin view). */
+    draft?: boolean;
+}
+interface CreateArgs {
+    collection: string;
+    data: Record<string, any>;
+    depth?: number;
+    tenantId?: string;
+    select?: string[];
+    user?: any;
+    context?: Record<string, any>;
+    overrideAccess?: boolean;
+}
+interface UpdateArgs {
+    collection: string;
+    id: string;
+    data: Record<string, any>;
+    depth?: number;
+    tenantId?: string;
+    select?: string[];
+    user?: any;
+    context?: Record<string, any>;
+    overrideAccess?: boolean;
+}
+interface DeleteArgs {
+    collection: string;
+    id: string;
+    tenantId?: string;
+    user?: any;
+    context?: Record<string, any>;
+    overrideAccess?: boolean;
+}
+interface FindResult<T = any> {
+    docs: T[];
+    totalDocs: number;
+    limit: number;
+    totalPages: number;
+    page: number;
+    pagingCounter: number;
+    hasPrevPage: boolean;
+    hasNextPage: boolean;
+    prevPage: number | null;
+    nextPage: number | null;
+}
+interface VersionRecord<T = Record<string, any>> {
+    id: string;
+    collection: string;
+    documentId: string;
+    version: number;
+    status: DocumentStatus;
+    data: T;
+    createdBy?: string;
+    createdAt: string;
+    updatedAt: string;
+    publishedAt?: string | null;
+    changeDescription?: string;
+    autosave?: boolean;
+}
+interface CreateVersionArgs<T = Record<string, any>> {
+    collection: string;
+    documentId: string;
+    data: T;
+    status: DocumentStatus;
+    createdBy?: string;
+    changeDescription?: string;
+    tenantId?: string;
+    /** When true, reuses a single version slot (find existing + update) */
+    autosave?: boolean;
+}
+interface FindVersionsArgs {
+    collection: string;
+    documentId: string;
+    tenantId?: string;
+    limit?: number;
+    page?: number;
+    sort?: string;
+}
+interface BaseAdapter {
+    init(collections: CollectionConfig[], globals: GlobalConfig[]): Promise<void>;
+    find<T = Record<string, any>>(args: FindArgs): Promise<FindResult<T>>;
+    findByID<T = Record<string, any>>(args: FindByIDArgs): Promise<T | null>;
+    create<T = Record<string, any>>(args: CreateArgs): Promise<T>;
+    update<T = Record<string, any>>(args: UpdateArgs): Promise<T>;
+    delete<T = Record<string, any>>(args: DeleteArgs): Promise<T>;
+    count(args: {
+        collection: string;
+        where?: Record<string, any>;
+        tenantId?: string;
+    }): Promise<number>;
+    findOne(args: FindOneArgs): Promise<any>;
+    findVersions(args: FindVersionsArgs): Promise<FindResult<VersionRecord>>;
+    findVersionByID(args: {
+        collection: string;
+        versionId: string;
+        tenantId?: string;
+    }): Promise<VersionRecord | null>;
+    createVersion<T = Record<string, any>>(args: CreateVersionArgs<T>): Promise<VersionRecord<T>>;
+    deleteVersions(args: {
+        collection: string;
+        documentId: string;
+        keepLatest?: number;
+        tenantId?: string;
+    }): Promise<void>;
+    updateLatestVersion<T = Record<string, any>>(args: CreateVersionArgs<T>): Promise<VersionRecord<T>>;
+    migrate?(): Promise<void>;
+    rollback?(): Promise<void>;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    transaction?<T>(fn: (tx: any) => Promise<T>): Promise<T>;
+    setTenantContext(context: TenantContext | undefined): void;
+    getTenantContext(): TenantContext | undefined;
+}
+interface KyroConfig {
+    collections?: CollectionConfig[];
+    globals?: GlobalConfig[];
+    projects?: ProjectConfig[];
+    organizations?: OrganizationConfig[];
+    adapter: BaseAdapter;
+    storage?: StorageProvider;
+    plugins?: KyroPlugin[];
+    auth?: boolean | {
+        secret?: string;
+        tokenExpiration?: number;
+        cookie?: {
+            secure?: boolean;
+            sameSite?: "strict" | "lax" | "none";
+            domain?: string;
+        };
+        checkSession?: boolean;
+    };
+    authAdapter?: any;
+    cors?: {
+        origins?: string[];
+        credentials?: boolean;
+    };
+    admin?: {
+        meta?: {
+            title?: string;
+            description?: string;
+            ogImage?: string;
+        };
+        dateFormat?: string;
+        avatar?: "default" | "gravatar";
+        disable?: boolean;
+        indexRoute?: string;
+        components?: Record<string, any>;
+        collectionOverrides?: Record<string, CollectionOverrideConfig>;
+        globalOverrides?: Record<string, GlobalOverrideConfig>;
+        smartViews?: SmartViewConfig[];
+    };
+    upload?: {
+        limits?: {
+            fileSize?: number;
+        };
+    };
+    graphQL?: {
+        maxComplexity?: number;
+        disablePlayground?: boolean;
+    };
+    typescript?: {
+        outputFile?: string;
+    };
+    localization?: {
+        locales: string[];
+        defaultLocale: string;
+    };
+    rateLimit?: {
+        window?: number;
+        max?: number;
+    };
+    debug?: boolean;
+}
+
+declare const richTextStyles: string;
+declare function renderRichText(value: unknown): string;
+
+type StylingMode = 'css' | 'tailwind' | 'css-in-js' | 'styled-components' | 'vanilla-extract';
+interface StylingConfig {
+    mode: StylingMode;
+    theme?: ThemeConfig;
+    customProperties?: Record<string, string>;
+}
+interface ThemeConfig {
+    colors?: ThemeColors;
+    fonts?: ThemeFonts;
+    spacing?: ThemeSpacing;
+    borderRadius?: ThemeBorderRadius;
+    shadows?: ThemeShadows;
+    breakpoints?: Record<string, string>;
+}
+interface ThemeColors {
+    primary?: string;
+    secondary?: string;
+    accent?: string;
+    background?: string;
+    surface?: string;
+    text?: string;
+    textMuted?: string;
+    border?: string;
+    error?: string;
+    warning?: string;
+    success?: string;
+    info?: string;
+}
+interface ThemeFonts {
+    sans?: string;
+    serif?: string;
+    mono?: string;
+}
+interface ThemeSpacing {
+    xs?: string;
+    sm?: string;
+    md?: string;
+    lg?: string;
+    xl?: string;
+    '2xl'?: string;
+    '3xl'?: string;
+    '4xl'?: string;
+}
+interface ThemeBorderRadius {
+    sm?: string;
+    md?: string;
+    lg?: string;
+    xl?: string;
+    full?: string;
+}
+interface ThemeShadows {
+    sm?: string;
+    md?: string;
+    lg?: string;
+    xl?: string;
+}
+declare class CSSGenerator {
+    private config;
+    private css;
+    constructor(config: StylingConfig);
+    addRule(selector: string, properties: Record<string, string>): this;
+    addMediaQuery(breakpoint: string, rules: string[]): this;
+    generate(): string;
+}
+declare function generateTailwindConfig(theme: ThemeConfig): Record<string, any>;
+declare const defaultLightTheme: ThemeConfig;
+declare const defaultDarkTheme: ThemeConfig;
+declare const ecommerce2026Theme: ThemeConfig;
+declare function generateCSSVariables(theme: ThemeConfig): string;
+interface AdminStylingConfig {
+    mode: StylingMode;
+    theme?: ThemeConfig;
+    customStyles?: string;
+    componentOverrides?: Record<string, Record<string, string>>;
+}
+declare function createAdminStyling(config: AdminStylingConfig): string;
+interface FieldStyling {
+    wrapper?: Record<string, string>;
+    label?: Record<string, string>;
+    input?: Record<string, string>;
+    error?: Record<string, string>;
+    description?: Record<string, string>;
+}
+declare const defaultFieldStyling: Record<string, FieldStyling>;
+
+declare function createAuditContext(req: Request): {
+    ipAddress: string;
+    userAgent: string;
+};
+
+declare const FIELD_DEFINITION_KEYS: Set<string>;
+declare function isFieldOverrideDefinition(obj: any): boolean;
+declare function flattenFieldOverrides(overrides: Record<string, any>, prefix?: string): Record<string, any>;
+declare function updateFieldByPath(fields: any[], path: string, updates: Record<string, any>, allowAppend?: boolean): boolean;
+declare function applyBlocksOverrides(fields: any[], rawBlocks: any): void;
+declare function applyTabsOverrides(fields: any[], rawTabs: any): void;
+declare function applyCollectionOverrides(collections: CollectionConfig[], overrides?: Record<string, any>): void;
+declare function applyGlobalOverrides(globals: GlobalConfig[], overrides?: Record<string, any>): void;
+
+interface HierarchyNode<T = Record<string, any>> {
+    doc: T;
+    id: string | number;
+    slug?: string;
+    depth: number;
+    path: string;
+    fullPath: string;
+    children: HierarchyNode<T>[];
+}
+interface BuildTreeOptions {
+    idField?: string;
+    parentField?: string;
+    slugField?: string;
+    slugPrefix?: boolean;
+    basePath?: string;
+    maxDepth?: number;
+}
+interface BreadcrumbItem {
+    id: string | number;
+    label: string;
+    slug?: string;
+    path?: string;
+}
+/**
+ * Builds a nested hierarchical tree from a flat list of collection documents.
+ */
+declare function buildDocumentTree<T extends Record<string, any>>(docs: T[], options?: BuildTreeOptions): HierarchyNode<T>[];
+/**
+ * Returns breadcrumb trail for a given document within a collection.
+ * Supports both getBreadcrumbs(docs, docId, options) and getBreadcrumbs(docId, docs, options).
+ */
+declare function getBreadcrumbs<T extends Record<string, any>>(arg1: T[] | string | number, arg2: T[] | string | number, options?: {
+    idField?: string;
+    parentField?: string;
+    labelField?: string;
+    slugField?: string;
+    basePath?: string;
+}): BreadcrumbItem[];
+/**
+ * Resolves the full URL path for a document in a hierarchical collection.
+ */
+declare function getNestedPath<T extends Record<string, any>>(docId: string | number, docs: T[], options?: {
+    idField?: string;
+    parentField?: string;
+    slugField?: string;
+    basePath?: string;
+}): string;
+/**
+ * Flattens a document hierarchy tree with depth indicators (useful for admin select dropdowns and indented lists).
+ */
+declare function flattenDocumentTree<T extends Record<string, any>>(nodes: HierarchyNode<T>[]): Array<{
+    doc: T;
+    id: string | number;
+    depth: number;
+    path: string;
+    fullPath: string;
+    hasChildren: boolean;
+}>;
+
+export { ALL_FIELD_TYPES, type AdminConfig, type AdminStylingConfig, type ArrayField, type AuthAdapter, type AuthConfig, type AuthResult, type Session as AuthSession, type AuthTokenConfig, type AuthUser, type BaseField, type Block, type BlockAdmin, type BlockImage, type BlocksField, type BuildTreeOptions, CSSGenerator, type CheckboxField, type CodeField, type CollapsibleField, type CollectionConfig, type ColorField, type DateField, type DeclarativeCondition, type EmailField, FIELD_DEFINITION_KEYS, type Field, type FieldAdmin, type FieldStyling, type FieldType, type GlobalConfig, type GroupField, type HierarchyNode, type IconField, type ImageField, type ImageSize, type JSONField, type JWTPayload, type KyroConfig, type LoginCredentials, type MarkdownField, type NumberField, type PasswordField, type RadioField, type RegisterData, type RelationshipField, type RichTextBlock, type RichTextField, type RowField, type SecretField, type SelectField, type Session, type StylingConfig, type StylingMode, type TabsField, type TextField, type TextareaField, type ThemeBorderRadius, type ThemeColors, type ThemeConfig, type ThemeFonts, type ThemeShadows, type ThemeSpacing, type UploadConfig, type UploadField, type UserRole, type VersionConfig, applyBlocksOverrides, applyCollectionOverrides, applyGlobalOverrides, applyTabsOverrides, buildDocumentTree, createAdminStyling, createAuditContext, defaultDarkTheme, defaultFieldStyling, defaultLightTheme, ecommerce2026Theme, flattenDocumentTree, flattenFieldOverrides, generateCSSVariables, generateTailwindConfig, getBreadcrumbs, getNestedPath, isFieldOverrideDefinition, renderRichText, richTextStyles, updateFieldByPath };