@levo-so/core 0.1.81 → 0.1.105

package/dist/index.d.ts

@@ -183,7 +183,7 @@ export declare const createLevoClient: (options: ILevoClientOptions) => {
         signUpWithPassword: <T = import("./types").ILevoMembership.Account>(data: import("./types").ILevoMembership.Request.SignUpWithPassword, options?: WretchOptions) => Promise<T>;
     };
     readonly collection: {
-        getAllCollections: (data?: import("./types").LevoQuery.FindQuery<"name" | "workspace_id" | "created_at" | "id" | "description" | "updated_at" | "key" | "readonly" | "hidden" | "icon" | "on_submit" | "on_update" | "sections" | "views" | "title_field" | "email_field" | "mobile_field" | "settings" | "module_name" | "allow_draft">, options?: WretchOptions) => Promise<IResponseMultiple<ILemaCollection>>;
+        getAllCollections: (data?: import("./types").LevoQuery.FindQuery<"name" | "workspace_id" | "created_at" | "id" | "kind" | "description" | "updated_at" | "icon" | "key" | "readonly" | "hidden" | "on_submit" | "on_update" | "module_name" | "allow_public_submit" | "public_submit_set_by" | "sections" | "views" | "title_field" | "email_field" | "mobile_field" | "settings" | "allow_draft" | "allow_public_view" | "public_view_set_by" | "public_view_set_by_account" | "public_submit_set_by_account" | "entry_count">, options?: WretchOptions) => Promise<IResponseMultiple<ILemaCollection>>;
         getCollectionByIDExpanded: <T = ILemaCollection>(id: string, options?: WretchOptions) => Promise<IResponseSingle<T>>;
         createCollection: (data: ILemaCollection) => Promise<IResponseSingle<ILemaCollection>>;
         saveCollectionData: ({ collection_id, data, options, }: {
@@ -201,14 +201,21 @@ export declare const createLevoClient: (options: ILevoClientOptions) => {
         getFilters: (collectionId: string, options?: WretchOptions) => Promise<IResponseMultiple<ILemaCollection["sections"][number]["fields"][number]>>;
     };
     readonly media: {
-        mediaBulkUpload: (formData: FormData, options?: WretchOptions) => Promise<IResponseMultiple<IMedia>>;
+        mediaBulkUpload: (formData: FormData, options?: WretchOptions, context?: IMediaUploadContext) => Promise<IResponseMultiple<IMedia>>;
         getAllMedia: (data?: import("./types").LevoQuery.FindQuery) => Promise<IResponseMultiple<IMedia>>;
     };
     readonly logger: {
         debug: (...args: any[]) => void;
         info: (...args: any[]) => void;
         warn: (...args: any[]) => void;
-        error: (...args: any[]) => void;
+        error: {
+            (message: string): void;
+            <T extends {
+                exception?: unknown;
+                [key: string]: any;
+            }>(message: string, props: T extends Error ? never : T): void;
+        };
+        attachMiddleware: (mw: ILevoLoggerMiddleware) => (() => void);
     };
     readonly fetch: QueryStringAddon & Wretch<QueryStringAddon, unknown, undefined>;
     readonly APP_MODE: string;
@@ -218,12 +225,43 @@ export declare const createLevoClient: (options: ILevoClientOptions) => {
     updateWorkspace: (workspace: string | null) => void;
 };
 
+/**
+ * @description base factory that includes levo workspace details, analytics tools & fetch client
+ */
+declare const createLevoControl: (options: ICoreOptions) => {
+    workspace: WorkspaceID | null;
+    readonly appName: string | undefined;
+    readonly apiUrl: string;
+    readonly NODE_ENV: string;
+    readonly APP_MODE: string;
+};
+
+export declare const createLevoLogger: (core: ILevoControl, options?: ILoggerOptions) => {
+    debug: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    error: {
+        (message: string): void;
+        <T extends {
+            exception?: unknown;
+            [key: string]: any;
+        }>(message: string, props: NotError<T>): void;
+    };
+    attachMiddleware: (mw: ILevoLoggerMiddleware) => (() => void);
+};
+
 export declare type DeepPartial<T> = {
     [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
 };
 
 export declare const defaultByKinds: Record<(typeof FieldKindList)[number], any>;
 
+/**
+ * Define a named logger middleware. Name is used for dedup — attaching
+ * a middleware with the same name replaces the previous one.
+ */
+export declare const defineLevoLoggerMiddleware: (name: string, callback: (core: ILevoControl, level: LogLevel, args: any[]) => void) => ILevoLoggerMiddleware;
+
 export declare type FieldFilter<T extends string = string> = Partial<Record<T, ComparableFilter<T> | FieldType>>;
 
 export declare const FieldInterfaces: Record<"TextWidget" | "CurrencyWidget" | "TextareaWidget" | "GeocoderWidget" | "MultiGeocoderWidget" | "DropdownWidget" | "ToggleCheckboxWidget" | "RadioWidget" | "NumberWidget" | "EmailWidget" | "PhoneWidget" | "URLWidget" | "DateWidget" | "TimeWidget" | "SwitchWidget" | "RichTextWidget" | "DateTimeWidget" | "CheckboxWidget" | "ImageUploadWidget" | "MultiImageUploadWidget" | "FileUploadWidget" | "MultiFileUploadWidget" | "MultiDropdownWidget" | "MultiTextWidget" | "CollectionWidget" | "ArrayWidget" | "RecordWidget" | "JSONWidget" | "SlugWidget", "TextWidget" | "CurrencyWidget" | "TextareaWidget" | "GeocoderWidget" | "MultiGeocoderWidget" | "DropdownWidget" | "ToggleCheckboxWidget" | "RadioWidget" | "NumberWidget" | "EmailWidget" | "PhoneWidget" | "URLWidget" | "DateWidget" | "TimeWidget" | "SwitchWidget" | "RichTextWidget" | "DateTimeWidget" | "CheckboxWidget" | "ImageUploadWidget" | "MultiImageUploadWidget" | "FileUploadWidget" | "MultiFileUploadWidget" | "MultiDropdownWidget" | "MultiTextWidget" | "CollectionWidget" | "ArrayWidget" | "RecordWidget" | "JSONWidget" | "SlugWidget">;
@@ -285,6 +323,12 @@ export declare const ForumPostKindExpandedList: Array<keyof typeof FORUM_POST_KI
 
 export declare type ForumPostStatus = (typeof FORUM_POST_STATUS)[keyof typeof FORUM_POST_STATUS];
 
+/**
+ * Derives the collection kind client-side when the API field is absent.
+ * Matches the server derivation exactly.
+ */
+export declare const getCollectionKind: (collection: Pick<ILemaCollection, "module_name" | "allow_public_submit" | "public_submit_set_by">) => ICollectionKind;
+
 export declare const getLevoError: (error: any) => LevoError;
 
 export declare interface IAddress {
@@ -329,10 +373,6 @@ export declare interface IAuthor {
     active_at: Date;
 }
 
-declare interface IBatchOptions {
-    logApiUrl?: string;
-}
-
 export declare interface IBlog {
     _id: string;
     slug: string;
@@ -349,6 +389,13 @@ export declare interface IBlog {
     created_by: string;
     updated_by: string;
     studio_config: IModuleStudioConfig[];
+    icon?: IIcon | null;
+    /**
+     * Default brief applied to every post in this blog. Merges per-field with
+     * `post.brief`; per-post values win. Setting `documents: ["DC_BRAND_GUIDE"]`
+     * here means every post is audited against that guide unless overridden.
+     */
+    brief_defaults?: IBrief | null;
 }
 
 export declare interface IBlogCategory {
@@ -411,6 +458,68 @@ export declare interface IBooking {
     attendees?: IAttendee[];
 }
 
+export declare interface IBrief {
+    /** PR... persona id. Falls back to `post.target_persona` when null. */
+    persona_id?: string | null;
+    /** Reserved — server accepts but doesn't yet route on it. */
+    writer_id?: string | null;
+    /** DC... ai_document ids (brand guide, compliance, research). */
+    documents?: string[] | null;
+    intent?: IBriefIntent | null;
+    focus_keyword?: string | null;
+    /** Semantic anchor; falls back to focus_keyword for drift checks. */
+    core_topic?: string | null;
+    funnel_stage?: IBriefFunnelStage | null;
+    brand_placement?: IBriefBrandPlacement | null;
+    word_limit?: IBriefWordLimit | null;
+    topic_drift?: IBriefTopicDrift | null;
+    cta_targets?: IBriefCtaTargets | null;
+}
+
+export declare type IBriefBrandPlacement = "soft" | "standard" | "strong";
+
+export declare interface IBriefCtaTargets {
+    top?: boolean;
+    mid?: boolean;
+    bottom?: boolean;
+}
+
+export declare type IBriefFunnelStage = "tofu" | "mofu" | "bofu";
+
+export declare type IBriefIntent = "educate" | "persuade" | "compare" | "convert";
+
+/**
+ * Snapshot of the merged brief at audit-run time, returned on the audit doc.
+ * `null` when both `post.brief` and `blog.brief_defaults` are empty.
+ */
+export declare interface IBriefSnapshot {
+    brief: IBrief;
+    documents: IBriefSnapshotDocument[];
+}
+
+/**
+ * Document fingerprint embedded in the audit response. The body itself is not
+ * inlined — only sha256 + length, used for drift detection on the audit cache key.
+ */
+export declare interface IBriefSnapshotDocument {
+    id: string;
+    title: string;
+    tags: string[];
+    body_sha256: string;
+    length: number;
+}
+
+export declare type IBriefTopicDrift = "tight" | "normal" | "loose";
+
+export declare interface IBriefWordLimit {
+    target: number;
+    /** Default 0.2 (±20%) when omitted on the wire. */
+    tolerance?: number;
+}
+
+/** Structural kind of a collection object. Read-only, derived server-side. */
+export declare type ICollectionKind = "collection" | "form" | "module";
+
 export declare interface ICollectionLayout {
     kind: ICollectionsView;
     options: ICollectionLayoutOptions;
@@ -431,6 +540,9 @@ export declare interface ICollectionLayoutOptions {
     infoFields?: string[];
 }
 
+/** Access level for collection-level public visibility or submission. */
+export declare type ICollectionPublicAccess = "public" | "members" | "own" | null;
+
 export declare interface ICollectionQuery {
     where: Record<string, any>;
     sort?: Record<string, any>;
@@ -533,17 +645,7 @@ declare interface ICoreOptions {
     APP_MODE: string;
 }
 
-export declare interface IDefaultPermissionsObject {
-    status?: "enabled" | "disabled" | "hidden";
-    create?: boolean;
-    modify?: boolean;
-    delete?: boolean;
-    archive?: boolean;
-    duplicate?: boolean;
-    export?: boolean;
-    upload?: boolean;
-    list_actions?: boolean;
-}
+export declare type IDelayUnit = "minutes" | "hours" | "days";
 
 export declare interface IDraftEntry {
     _id: string;
@@ -573,6 +675,9 @@ export declare interface IErrorContent {
     description: string;
     type?: string;
     errors?: IFieldError[];
+    url?: string;
+    /** Raw response body from the server, preserved for debugging/error tracking. */
+    responseData?: unknown;
 }
 
 export declare type IErrorParams = {
@@ -604,8 +709,37 @@ declare interface IFaviconSrcset {
     "192": string;
 }
 
-export declare interface IFeatureFlags extends Partial<IModuleAccessControl> {
+/**
+ * Public surface of per-workspace feature flags exposed via the external SDK.
+ * Only fields renderer/SDK consumers need at runtime belong here. A small,
+ * runtime-facing subset of `studio_config` (currently `kb_chat` and
+ * `kb_chat_preview_only`) is included so the published site can gate the
+ * visitor AI chat widget; the full admin-only studio_config / blogs_config
+ * shape remains in `@levo/types` `IFeatureFlags` and is not part of the SDK
+ * contract.
+ */
+export declare interface IFeatureFlags {
+    /** Controls the "Powered by Levo" badge on rendered workspace sites. */
     branding?: boolean;
+    /**
+     * Only the subset of studio_config the public site renderer needs at
+     * runtime. The full studio_config shape stays in `@levo/types`.
+     */
+    studio_config?: {
+        /** Visitor-facing AI chat widget on the published site. Default off. */
+        kb_chat?: boolean;
+        /**
+         * When true (default) the KB chat only mounts on preview deployments.
+         * Flip to false per-workspace to release the widget to production.
+         */
+        kb_chat_preview_only?: boolean;
+        /**
+         * Launcher shape for the visitor AI chat. `"bar"` (default) renders the
+         * centered morphing pill at the bottom of the viewport; `"fab"` renders
+         * the bottom-right floating action button + popover panel.
+         */
+        kb_chat_variant?: "bar" | "fab";
+    };
 }
 
 /**
@@ -678,7 +812,9 @@ export declare interface IForum {
     description: string;
     status: string;
     settings: IForumSettings;
+    listing_page_url?: string;
     created_at: string;
+    studio_config?: IModuleStudioConfig[];
 }
 
 export declare interface IForumCategory {
@@ -854,11 +990,9 @@ export declare interface IIconData {
 /**
  * Defines the schema structure for a Levo Collection.
  *
- * A Levo Collection is a feature of the Levo platform that enables dynamic form rendering using the `@levo-so/react-collection` library.
+ * A Levo Collection is a feature of the Levo platform that enables dynamic form rendering using the `@levo.libraries/react-collection` library.
  * This interface describes the schema used to generate forms, including sections, fields, and configuration options.
  * The schema is referenced anywhere a Levo Collection is required in the Levo ecosystem.
- *
- * For more details, see the documentation in external/react-collection/docs/readme.md.
  */
 export declare interface ILemaCollection {
     /** Unique identifier for the collection schema. */
@@ -901,6 +1035,33 @@ export declare interface ILemaCollection {
     updated_at?: Date | string;
     /** Whether the collection allows draft items. */
     allow_draft?: boolean;
+    /** Structural kind — read-only, derived server-side. Use getCollectionKind() if absent. */
+    kind?: ICollectionKind;
+    /** Collection-level public view access level. null = private/disabled. */
+    allow_public_view?: ICollectionPublicAccess;
+    /** Collection-level public submit access level. null = private/disabled. */
+    allow_public_submit?: ICollectionPublicAccess;
+    /** Account ID who manually set the public view flag. null = auto-set by system. */
+    public_view_set_by?: string | null;
+    /** Account ID who manually set the public submit flag. null = auto-set by system. */
+    public_submit_set_by?: string | null;
+    /** Expanded account details for who set public view. */
+    public_view_set_by_account?: ILemaCollectionAccount | null;
+    /** Expanded account details for who set public submit. */
+    public_submit_set_by_account?: ILemaCollectionAccount | null;
+    /** Number of entries in the collection. Returned by listing API. */
+    entry_count?: number;
+}
+
+/** Account details embedded in collection responses for _set_by fields. */
+export declare interface ILemaCollectionAccount {
+    id: string;
+    first_name: string;
+    last_name: string;
+    email: string;
+    profile_picture?: {
+        location: string;
+    } | null;
 }
 
 export declare type ILemaCollectionRelationship = "o2m" | "m2o" | "o2o" | "m2m";
@@ -915,6 +1076,10 @@ export declare type ILemaField = Mandatory<Omit<IField, "fields" | "options">, "
     fields?: ILemaField[];
     /** Field options for configuring widget behavior. */
     options: ILemaFieldOptions;
+    /** Whether this field is visible publicly. */
+    allow_public_view?: boolean;
+    /** Whether this field accepts public submissions. */
+    allow_public_submit?: boolean;
 };
 
 /**
@@ -958,6 +1123,10 @@ export declare interface ILemaFieldOptions {
     validationsPresets?: string[];
     /** Whether to verify email/phone values or not */
     verification?: boolean;
+    /** Restrict upload widget to specific media types (e.g. ["image", "document"]). All types allowed when absent. */
+    allowed_upload_types?: string[];
+    /** Restrict upload widget to specific file extensions (e.g. ["pdf", "docx"]). All extensions for the allowed types when absent. */
+    allowed_extensions?: string[];
 }
 
 export declare type ILemaRelation = {
@@ -1055,20 +1224,12 @@ export declare interface ILevoClientOptions extends ICoreOptions {
     loggerOptions?: ILoggerOptions;
 }
 
-export declare type ILevoIntegrationInstance = {
-    id: string;
-    name: string;
-    publisher: string;
-    description: string;
-    url: string | null;
-    logo: string | null;
-    dashboard_url: string | null;
-    sidebar_icon: string | null;
-    show_on_sidebar: boolean;
-    key: string;
-};
+declare type ILevoControl = ReturnType<typeof createLevoControl>;
 
-export declare type ILevoIntegrationList = (typeof LEVO_INTEGRATIONS)[keyof typeof LEVO_INTEGRATIONS][];
+export declare interface ILevoLoggerMiddleware {
+    name: string;
+    callback: (core: ILevoControl, level: LogLevel, args: any[]) => void;
+}
 
 export declare namespace ILevoMembership {
     export interface sub_account_oauth_credentials {
@@ -1247,15 +1408,13 @@ export declare namespace ILevoMembership {
             password: string;
         };
     }
-        {};
+    export {};
 }
 
 export declare type ILevoOAuthProvider = (typeof LevoOAuthProviderList)[number];
 
-declare interface ILoggerOptions extends IBatchOptions {
+export declare interface ILoggerOptions {
     level?: LogLevel;
-    enableRemote?: boolean;
-    context?: Record<string, any>;
 }
 
 export declare interface IMe {
@@ -1313,34 +1472,23 @@ export declare type IMediaObject = Pick<IMedia, "id" | "location" | "srcset" | "
     mimetype?: IMedia["metadata"]["mimetype"];
 };
 
+/** Source context attached to a media upload so the backend can record where the file originated. */
+export declare interface IMediaUploadContext {
+    /** The product module the upload belongs to (e.g. "community", "blog"). */
+    module: "community" | "collection" | "blog" | "event" | "membership" | "beacon" | "studio" | "ai";
+    /** Module-specific resource key (e.g. blog slug, collection key, event slug). */
+    identifier: string;
+    /** Schema field key within the module (e.g. "cover_image", "attachment"). */
+    field_key?: string;
+    /** Human-readable field label (e.g. "Cover Image", "Attachment"). */
+    field_label?: string;
+}
+
 export declare interface IMeta {
     total: number;
     pages: number;
 }
 
-export declare type IModuleAccessControl = {
-    dashboard_config: IDefaultPermissionsObject;
-    studio_config: IDefaultPermissionsObject & {
-        addBlocks: boolean;
-        version: string;
-        preview_url: string | null;
-        modules: {
-            my_blocks: IDefaultPermissionsObject;
-        };
-    };
-    collections_config: IDefaultPermissionsObject & {
-        modules: {
-            records: IDefaultPermissionsObject;
-        };
-    };
-    media_config: IDefaultPermissionsObject;
-    events_config: IDefaultPermissionsObject;
-    blogs_config: IDefaultPermissionsObject;
-    memberships_config: IDefaultPermissionsObject;
-    insights_config: IDefaultPermissionsObject;
-    settings_config: IDefaultPermissionsObject;
-};
-
 export declare interface IModuleStudioConfig {
     page_id: string;
     preview_url: string;
@@ -1363,7 +1511,10 @@ export declare interface INotificationData {
         reply_to?: string;
         cc_email?: string[];
         bcc_email?: string[];
+        delay_value?: number;
+        delay_unit?: IDelayUnit;
         info: {
+            title?: string;
             show_download_button?: boolean;
             hide_fields?: string[];
             body?: string;
@@ -1479,6 +1630,10 @@ export declare interface IPost {
             location: string;
         };
     }[];
+    /** Staff account who created the post. Immutable. `null` for legacy/unbackfilled posts. */
+    created_by?: IPostStaffAccount | null;
+    /** Staff account who last edited the post. Re-stamped on every save. `null` for legacy/unbackfilled posts. */
+    updated_by?: IPostStaffAccount | null;
     settings: Record<string, any>;
     in_review_at?: Date;
     approved_at?: Date;
@@ -1496,6 +1651,75 @@ export declare interface IPost {
         name: string;
         slug: string;
     }[];
+    /** Latest completed audit for this post. `null` when never audited. Platform list only. */
+    audit?: IPostAuditSummary | null;
+    /** True while a pending/running audit exists for this post. Independent of `audit`. */
+    is_auditing?: boolean;
+    /**
+     * Per-post writing/audit brief. All fields optional; absent fields fall
+     * through to the parent blog's `brief_defaults`.
+     */
+    brief?: IBrief | null;
+}
+
+export declare interface IPostAuditDimensionGrade {
+    key: string;
+    name: string;
+    grade: IPostAuditGrade;
+}
+
+/**
+ * Counts of recommended fixes by severity. `total` includes any unknown
+ * severities so the headline number stays honest if the BE enum grows.
+ */
+export declare interface IPostAuditFixesCount {
+    high: number;
+    medium: number;
+    low: number;
+    total: number;
+}
+
+export declare type IPostAuditGrade = "A+" | "A" | "B" | "C" | "D" | "F";
+
+export declare type IPostAuditMode = "quick" | "full";
+
+/**
+ * Lightweight audit summary attached to each post in the platform list response.
+ * Full body (signals, fixes, execution) lives on `GET /v1/agents/audit/:id`.
+ */
+export declare interface IPostAuditSummary {
+    id: string;
+    mode: IPostAuditMode;
+    overall_grade: IPostAuditGrade;
+    overall_score: number;
+    dimensions: IPostAuditDimensionGrade[];
+    fixes_count: IPostAuditFixesCount;
+    completed_at: string;
+    /** True when post.updated_at > audit.completed_at — any post edit flags it. */
+    is_stale: boolean;
+}
+
+/**
+ * Staff account audit shape returned for `created_by` / `updated_by` on blog posts.
+ * Distinct from the editorial `authors` byline — this is the internal CMS audit trail.
+ */
+export declare interface IPostStaffAccount {
+    _id: string;
+    first_name: string;
+    last_name: string;
+    username?: string;
+    slug?: string;
+    profile_picture?: {
+        location: string;
+    } | null;
+    last_access_at?: string | null;
+}
+
+export declare interface IRemoteLoggerMiddlewareOptions {
+    /** URL of the log ingestion API */
+    logApiUrl: string;
+    /** Extra static context merged into every log payload */
+    context?: Record<string, any>;
 }
 
 export declare interface IResponseError {
@@ -1586,6 +1810,8 @@ export declare interface ISubscription {
     status: "active" | "cancelled" | "past_due" | "trialing" | "incomplete" | "trial_expired";
     plan_id?: string;
     price_id?: string;
+    provider?: string;
+    customer_id?: string;
 }
 
 /**
@@ -1615,7 +1841,6 @@ export declare interface IWorkspace {
     created_at: string;
     updated_at: string;
     deleted_at?: null;
-    integrations?: ILevoIntegrationList | ILevoIntegrationInstance[];
     description: any;
     icon: IMediaObject | null;
     workspace_id: string;
@@ -1672,18 +1897,6 @@ declare type JSONContent = {
     [key: string]: any;
 };
 
-export declare const LEVO_INTEGRATIONS: {
-    readonly beacon: "so.levo.beacon";
-    readonly blog: "so.levo.blog";
-    readonly event: "so.levo.event";
-    readonly membership: "so.levo.membership";
-    readonly payment: "so.levo.payment";
-    readonly community: "so.levo.community";
-    readonly search_console: "com.google.search_console";
-};
-
-export declare const LEVO_INTEGRATIONS_LIST: ("so.levo.beacon" | "so.levo.blog" | "so.levo.event" | "so.levo.membership" | "so.levo.payment" | "so.levo.community" | "com.google.search_console")[];
-
 /**
  * Enhanced error class that matches backend response structure
  */
@@ -1693,6 +1906,9 @@ export declare class LevoError extends Error {
     status: number;
     type?: string;
     errors?: IFieldError[];
+    url?: string;
+    /** Raw response body from the server, preserved for debugging/error tracking. */
+    responseData?: unknown;
     constructor(data: IErrorContent);
     /**
      * Get validation errors for form fields
@@ -1724,6 +1940,7 @@ export declare namespace LevoEvent {
         slug: string;
         status: "draft" | "canceled" | "published";
         accept_registration: boolean;
+        one_attendee_per_account: boolean;
         max_capacity: number;
         banners: IMediaObject[];
         created_at: Date;
@@ -1764,6 +1981,7 @@ export declare namespace LevoEvent {
             hidden: boolean;
             allow_to_upgrade: boolean;
             include_in_upgrade: boolean;
+            one_attendee_per_account: boolean;
             enforce_max_quantity: boolean;
             status: string;
             offerings: string[];
@@ -1796,6 +2014,11 @@ export declare namespace LevoEvent {
             expires_at: Date | null;
             max_redemptions: number | null;
             minimum_amount: number | null;
+            /** Minimum transaction amount required to use this coupon */
+            min_trnx_amount: number | null;
+            /** Maximum discount amount cap (for percent coupons) */
+            max_amount_off: number | null;
+            redeem_count: number;
             is_public: boolean;
             created_at: Date;
             created_by: string;
@@ -1838,19 +2061,41 @@ export declare namespace LevoEvent {
     export namespace Attendee {
         export interface Root {
             _id: string;
+            slug: string;
             public_id: string;
             name: string;
             email: string;
             mobile: string | null;
             event: string;
+            organization: string;
+            designation: string;
+            details: Record<string, any>;
             booking: Booking.Root;
             ticket: Pick<LevoEvent.Ticket.Root, "_id" | "title" | "currency" | "quantity" | "status" | "unit_amount">;
             price: string;
-            account: string | null;
+            /** Raw string ID, or populated account object when `include.account` is used */
+            account: string | IAttendeeAccount | null;
             status: string;
+            info: Record<string, any>;
+            qr_image: IMediaObject & {
+                width: number;
+                height: number;
+            };
+            checkin_at: Date | null;
             created_at: Date;
             updated_at: Date;
         }
+        /** Populated account shape returned when `include.account` is used in the query */
+        export interface IAttendeeAccount {
+            _id: string;
+            reducted_email?: string;
+            reducted_mobile?: string;
+            slug?: string;
+            username?: string;
+            profile_picture?: {
+                location: string;
+            };
+        }
     }
     export namespace Booking {
         export interface Root {
@@ -1869,13 +2114,17 @@ export declare namespace LevoEvent {
             code: string | null;
             status: string;
             paid: boolean;
+            tax_inclusive: boolean;
+            is_business_purchase: boolean;
+            billing_details: IBillingDetails | null;
             info: Record<string, any>;
             taxes?: Array<{
                 id: string;
                 label: string;
-                percentage: number;
+                percentage?: number;
                 amount: number;
-            }>;
+            }> | Record<string, never>;
+            payment_details: IPaymentDetail[];
             qr_image: IMediaObject & {
                 width: number;
                 height: number;
@@ -1885,10 +2134,49 @@ export declare namespace LevoEvent {
                 width: number;
                 height: number;
             }) | null;
+            /** How this booking was created: public (website), manual (dashboard), csv (import) */
+            source: "public" | "manual" | "csv";
+            /** Visit ID or null — populated when `include._visit` is used */
+            _visit: string | null;
+            _page: IBookingPage | null;
+            upgraded_at: Date | null;
             created_at: Date;
             updated_at: Date;
             attendees: LevoEvent.Attendee.Root[];
         }
+        export interface IBillingDetails {
+            name: string;
+            tax_id?: string;
+            address?: {
+                line1: string;
+                line2?: string;
+                city: string;
+                state: string;
+                postal_code: string;
+                country_code: string;
+            };
+        }
+        export interface IPaymentDetail {
+            order_id: string;
+            link_id: string;
+            payment_kind: string;
+            payment_id: string;
+            provider: string;
+            kind: string;
+            identifier: string;
+            amount: number;
+            currency: string;
+            status: string;
+            info: Record<string, any>;
+            created_at: string;
+        }
+        export interface IBookingPage {
+            url: string;
+            hostname: string;
+            pathname: string;
+            id: string;
+            title: string;
+        }
         export type Create = Omit<Pick<Root, "event" | "coupon">, "attendees"> & {
             attendees: Mandatory<LevoEvent.Attendee.Root, "name" | "ticket" | "email">;
         };
@@ -1900,6 +2188,7 @@ export declare namespace LevoEvent {
             name: string;
             description: string;
             cover_image: string | null;
+            icon?: IIcon | null;
             status: "published" | string;
             created_at: string;
             updated_at: string;
@@ -1911,6 +2200,7 @@ export declare namespace LevoEvent {
         }
         export interface Update {
             name: string;
+            icon?: IIcon | null;
         }
     }
 }
@@ -1954,7 +2244,7 @@ export declare const LogicalOperators: {
 
 export declare type LogicalOperators = keyof typeof LogicalOperators;
 
-declare enum LogLevel {
+export declare enum LogLevel {
     debug = 0,
     info = 1,
     warn = 2,
@@ -1968,12 +2258,21 @@ export declare const MediaKind: Record<"image" | "video" | "audio" | "document",
 
 export declare const MediaKindList: readonly ["image", "video", "audio", "document"];
 
+/** Reject types assignable to Error — forces `{ exception }` wrapping at the call site. */
+declare type NotError<T> = T extends Error ? never : T;
+
 export declare type PlanKind = "addon" | "base";
 
 export declare type Prettify<T> = {
     [K in keyof T]: T[K];
 };
 
+/**
+ * Middleware that batches error logs and sends them to a remote API.
+ * Only forwards `LogLevel.error` — lower levels are ignored.
+ */
+export declare const remoteLoggerMiddleware: (options: IRemoteLoggerMiddlewareOptions) => ILevoLoggerMiddleware;
+
 export declare type WithinFilterType = {
     latitude: number;
     longitude: number;