@kyro-cms/core 0.5.3 → 0.5.5

package/dist/types-Bs1up4yP.d.ts

@@ -0,0 +1,461 @@
+import { F as Field } from './types-VtjUxIMp.js';
+
+interface Request {
+    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;
+    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 FieldHooks {
+    beforeValidate?: Hook[];
+    beforeChange?: Hook[];
+    afterChange?: Hook[];
+    afterRead?: Hook[];
+}
+interface GlobalHooks {
+    beforeValidate?: Hook[];
+    beforeChange?: Hook[];
+    afterChange?: Hook[];
+    beforeRead?: Hook[];
+    afterRead?: Hook[];
+}
+declare function runHooks(hooks: Hook[], args: HookArgs): Promise<any>;
+declare function runFieldHooks(hooks: Hook[], args: HookArgs): Promise<any>;
+
+interface WhereClause {
+    [field: string]: any;
+}
+interface AccessArgs {
+    req: Request;
+    user?: User;
+    data?: any;
+    doc?: any;
+    id?: string;
+    tenantID?: string;
+    context?: Record<string, any>;
+}
+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;
+}
+interface FieldAccess {
+    create?: AccessControl;
+    read?: AccessControl;
+    update?: AccessControl;
+}
+declare function evaluateAccess(access: AccessControl, args: AccessArgs): Promise<boolean | WhereClause>;
+declare function mergeWhereClauses(...whereClauses: (WhereClause | boolean | undefined)[]): WhereClause;
+declare function getWhereClause(access: AccessControl, args: AccessArgs): Promise<WhereClause | undefined>;
+
+interface AdminConfig {
+    useAsTitle?: string;
+    defaultColumns?: string[];
+    hidden?: boolean;
+    description?: string;
+    hideAPIURL?: boolean;
+    group?: string;
+    icon?: string;
+    preview?: (doc: any, options: {
+        req: any;
+    }) => string;
+    disableDuplicate?: boolean;
+    pagination?: {
+        defaultLimit?: number;
+        limits?: number[];
+    };
+    layout?: "split" | "single";
+}
+interface UploadConfig {
+    staticDir?: string;
+    staticURL?: string;
+    mimeTypes?: string[];
+    fileSize?: number;
+    imageSizes?: ImageSize[];
+    crop?: boolean;
+    focalPoint?: boolean;
+    formatOptions?: {
+        format: "webp" | "png" | "jpg";
+        options?: Record<string, any>;
+    };
+    resizeOptions?: Record<string, any>;
+    adminThumbnail?: string;
+}
+interface ImageSize {
+    name: string;
+    width?: number;
+    height?: number;
+    crop?: string;
+    position?: string;
+    formatOptions?: {
+        format: "webp" | "png" | "jpg";
+    };
+    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;
+    auth?: boolean | AuthConfig;
+    graphQL?: {
+        singularName?: string;
+        pluralName?: string;
+    };
+    indexes?: Array<{
+        fields: Record<string, number | "text">;
+        options?: Record<string, any>;
+    }>;
+    custom?: Record<string, any>;
+    tabs?: Array<{
+        label: string;
+        fields: Field[];
+        name?: string;
+    }>;
+}
+interface GlobalConfig {
+    slug: string;
+    label?: 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 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 DraftSnapshot<T = Record<string, any>> {
+    id: string;
+    collection: string;
+    documentId: string;
+    tenantID?: string;
+    data: T;
+    baseUpdatedAt?: string | null;
+    draftUpdatedAt: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface DraftFindArgs {
+    collection: string;
+    documentId: string;
+    tenantID?: string;
+}
+interface DraftUpsertArgs<T = Record<string, any>> extends DraftFindArgs {
+    data: T;
+    baseUpdatedAt?: string | null;
+    draftUpdatedAt?: string;
+}
+interface DraftDeleteArgs extends DraftFindArgs {
+}
+interface CreateResult<T = any> {
+    doc: T;
+    errors?: Array<{
+        field: string;
+        message: string;
+    }>;
+}
+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;
+}
+interface CreateVersionArgs<T = Record<string, any>> {
+    collection: string;
+    documentId: string;
+    data: T;
+    status: DocumentStatus;
+    createdBy?: string;
+    changeDescription?: string;
+    tenantID?: string;
+}
+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>(args: FindArgs): Promise<FindResult<T>>;
+    findByID<T>(args: FindByIDArgs): Promise<T | null>;
+    create<T>(args: CreateArgs): Promise<T>;
+    update<T>(args: UpdateArgs): Promise<T>;
+    delete<T>(args: DeleteArgs): Promise<T>;
+    count(args: {
+        collection: string;
+        where?: Record<string, any>;
+        tenantID?: string;
+    }): Promise<number>;
+    findOne(args: {
+        collection: string;
+        where: Record<string, any>;
+        tenantID?: string;
+        draft?: boolean;
+    }): 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>;
+    findDraft<T = Record<string, any>>(args: DraftFindArgs): Promise<DraftSnapshot<T> | null>;
+    upsertDraft<T = Record<string, any>>(args: DraftUpsertArgs<T>): Promise<DraftSnapshot<T>>;
+    deleteDraft(args: DraftDeleteArgs): Promise<void>;
+    migrate?(): Promise<void>;
+    rollback?(): Promise<void>;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    transaction?<T>(fn: (tx: any) => Promise<T>): Promise<T>;
+}
+interface AdapterConfig {
+    type: "drizzle" | "mongodb";
+    client: any;
+    schema?: any;
+    connectionOptions?: Record<string, any>;
+}
+interface PluginConfig {
+    name: string;
+    version?: string;
+    init?: (kyro: any) => void | Promise<void>;
+    extendCollection?: (slug: string, config: CollectionConfig) => CollectionConfig;
+    extendGlobal?: (slug: string, config: GlobalConfig) => GlobalConfig;
+    hooks?: CollectionHooks;
+    fields?: Field[];
+    api?: (kyro: any) => any;
+}
+interface KyroConfig {
+    collections?: CollectionConfig[];
+    globals?: GlobalConfig[];
+    adapter: BaseAdapter;
+    plugins?: PluginConfig[];
+    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>;
+    };
+    upload?: {
+        limits?: {
+            fileSize?: number;
+        };
+    };
+    graphQL?: {
+        maxComplexity?: number;
+        disablePlayground?: boolean;
+    };
+    typescript?: {
+        outputFile?: string;
+    };
+    localization?: {
+        locales: string[];
+        defaultLocale: string;
+    };
+    rateLimit?: {
+        window?: number;
+        max?: number;
+    };
+    debug?: boolean;
+}
+
+export { type AdminConfig as A, type BaseAdapter as B, type CollectionConfig as C, type DeleteArgs as D, mergeWhereClauses as E, type FindArgs as F, type GlobalConfig as G, type Hook as H, type ImageSize as I, runFieldHooks as J, type KyroConfig as K, runHooks as L, type PluginConfig as P, type Request as R, type UploadConfig as U, type VersionConfig as V, type WhereClause as W, type AuthConfig as a, type FindResult as b, type FindByIDArgs as c, type CreateArgs as d, type UpdateArgs as e, type FindVersionsArgs as f, type VersionRecord as g, type CreateVersionArgs as h, type DraftFindArgs as i, type DraftSnapshot as j, type DraftUpsertArgs as k, type DraftDeleteArgs as l, type User as m, type AccessArgs as n, type AccessControl as o, type AdapterConfig as p, type CollectionAccess as q, type CollectionHooks as r, type CreateResult as s, type FieldAccess as t, type FieldHooks as u, type GlobalAccess as v, type GlobalHooks as w, type HookArgs as x, evaluateAccess as y, getWhereClause as z };

package/dist/types-DqN4ckOC.d.cts

@@ -0,0 +1,130 @@
+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;
+    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;
+        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>;
+    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>;
+}
+
+export type { AuthAdapter as A, JWTPayload as J, LoginCredentials as L, RegisterData as R, Session as S, UserRole as U, AuthResult as a, AuthTokenConfig as b, AuthUser as c, AuditLogFilter as d, AuditLog as e, AuditAction as f };

package/dist/types-DqN4ckOC.d.ts

@@ -0,0 +1,130 @@
+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;
+    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;
+        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>;
+    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>;
+}
+
+export type { AuthAdapter as A, JWTPayload as J, LoginCredentials as L, RegisterData as R, Session as S, UserRole as U, AuthResult as a, AuthTokenConfig as b, AuthUser as c, AuditLogFilter as d, AuditLog as e, AuditAction as f };