@objectstack/objectql 1.0.4 → 1.0.5

package/dist/index.d.ts

@@ -1,6 +1,999 @@
-export { SchemaRegistry } from './registry.js';
-export { ObjectStackProtocolImplementation } from './protocol.js';
-export { ObjectQL } from './engine.js';
-export type { ObjectQLHostContext, HookHandler } from './engine.js';
-export { ObjectQLPlugin } from './plugin.js';
-//# sourceMappingURL=index.d.ts.map
+import { ServiceObject, HookContext, DataEngineQueryOptions, DataEngineInsertOptions, DataEngineUpdateOptions, DataEngineDeleteOptions, DataEngineCountOptions, DataEngineAggregateOptions } from '@objectstack/spec/data';
+import { ObjectStackManifest } from '@objectstack/spec/kernel';
+import { ObjectStackProtocol, MetadataCacheRequest, MetadataCacheResponse, BatchUpdateRequest, BatchUpdateResponse, UpdateManyDataRequest, DeleteManyDataRequest } from '@objectstack/spec/api';
+import { IDataEngine, DriverInterface, Logger, Plugin, PluginContext } from '@objectstack/core';
+
+/**
+ * Global Schema Registry
+ * Unified storage for all metadata types (Objects, Apps, Flows, Layouts, etc.)
+ */
+declare class SchemaRegistry {
+    private static metadata;
+    /**
+     * Universal Register Method
+     * @param type The category of metadata (e.g., 'object', 'app', 'plugin')
+     * @param item The metadata item itself
+     * @param keyField The property to use as the unique key (default: 'name')
+     */
+    static registerItem<T>(type: string, item: T, keyField?: keyof T): void;
+    /**
+     * Validate Metadata against Spec Zod Schemas
+     */
+    static validate(type: string, item: any): true | {
+        fields: Record<string, {
+            type: "number" | "boolean" | "code" | "date" | "lookup" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
+            required: boolean;
+            searchable: boolean;
+            multiple: boolean;
+            unique: boolean;
+            deleteBehavior: "set_null" | "cascade" | "restrict";
+            auditTrail: boolean;
+            hidden: boolean;
+            readonly: boolean;
+            encryption: boolean;
+            index: boolean;
+            externalId: boolean;
+            options?: {
+                value: string;
+                label: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            expression?: string | undefined;
+            defaultValue?: any;
+            min?: number | undefined;
+            max?: number | undefined;
+            step?: number | undefined;
+            language?: string | undefined;
+            encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "field" | "database" | "record";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            formula?: string | undefined;
+            label?: string | undefined;
+            precision?: number | undefined;
+            name?: string | undefined;
+            description?: string | undefined;
+            format?: string | undefined;
+            maxLength?: number | undefined;
+            minLength?: number | undefined;
+            scale?: number | undefined;
+            reference?: string | undefined;
+            referenceFilters?: string[] | undefined;
+            writeRequiresMasterRead?: boolean | undefined;
+            summaryOperations?: {
+                object: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+                field: string;
+            } | undefined;
+            theme?: string | undefined;
+            lineNumbers?: boolean | undefined;
+            maxRating?: number | undefined;
+            allowHalf?: boolean | undefined;
+            displayMap?: boolean | undefined;
+            allowGeocoding?: boolean | undefined;
+            addressFormat?: "us" | "uk" | "international" | undefined;
+            colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            allowAlpha?: boolean | undefined;
+            presetColors?: string[] | undefined;
+            showValue?: boolean | undefined;
+            marks?: Record<string, string> | undefined;
+            barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            displayValue?: boolean | undefined;
+            allowScanning?: boolean | undefined;
+            currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+            } | undefined;
+            fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    autoRotate: boolean;
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            maskingRule?: {
+                field: string;
+                strategy: "partial" | "hash" | "redact" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            dependencies?: string[] | undefined;
+            cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+        }>;
+        name: string;
+        active: boolean;
+        isSystem: boolean;
+        abstract: boolean;
+        datasource: string;
+        search?: {
+            fields: string[];
+            displayFields?: string[] | undefined;
+            filters?: string[] | undefined;
+        } | undefined;
+        tags?: string[] | undefined;
+        label?: string | undefined;
+        description?: string | undefined;
+        pluralLabel?: string | undefined;
+        icon?: string | undefined;
+        tableName?: string | undefined;
+        indexes?: {
+            type: "hash" | "btree" | "gin" | "gist" | "fulltext";
+            fields: string[];
+            unique: boolean;
+            partial?: string | undefined;
+            name?: string | undefined;
+        }[] | undefined;
+        tenancy?: {
+            enabled: boolean;
+            strategy: "shared" | "isolated" | "hybrid";
+            tenantField: string;
+            crossTenantAccess: boolean;
+        } | undefined;
+        softDelete?: {
+            enabled: boolean;
+            field: string;
+            cascadeDelete: boolean;
+        } | undefined;
+        versioning?: {
+            enabled: boolean;
+            strategy: "snapshot" | "delta" | "event-sourcing";
+            versionField: string;
+            retentionDays?: number | undefined;
+        } | undefined;
+        partitioning?: {
+            enabled: boolean;
+            strategy: "hash" | "range" | "list";
+            key: string;
+            interval?: string | undefined;
+        } | undefined;
+        cdc?: {
+            enabled: boolean;
+            events: ("insert" | "update" | "delete")[];
+            destination: string;
+        } | undefined;
+        validations?: any[] | undefined;
+        titleFormat?: string | undefined;
+        compactLayout?: string[] | undefined;
+        enable?: {
+            searchable: boolean;
+            trackHistory: boolean;
+            apiEnabled: boolean;
+            files: boolean;
+            feeds: boolean;
+            activities: boolean;
+            trash: boolean;
+            mru: boolean;
+            clone: boolean;
+            apiMethods?: ("search" | "update" | "delete" | "get" | "list" | "create" | "upsert" | "bulk" | "aggregate" | "history" | "restore" | "purge" | "import" | "export")[] | undefined;
+        } | undefined;
+    } | {
+        label: string;
+        name: string;
+        active: boolean;
+        isDefault: boolean;
+        description?: string | undefined;
+        version?: string | undefined;
+        icon?: string | undefined;
+        objects?: any[] | undefined;
+        branding?: {
+            primaryColor?: string | undefined;
+            logo?: string | undefined;
+            favicon?: string | undefined;
+        } | undefined;
+        navigation?: any[] | undefined;
+        homePageId?: string | undefined;
+        requiredPermissions?: string[] | undefined;
+        apis?: any[] | undefined;
+    } | {
+        type: "driver" | "app" | "plugin" | "module" | "objectql" | "gateway" | "adapter";
+        name: string;
+        version: string;
+        id: string;
+        description?: string | undefined;
+        dependencies?: Record<string, string> | undefined;
+        data?: {
+            object: string;
+            mode: "insert" | "upsert" | "ignore";
+            records: Record<string, any>[];
+        }[] | undefined;
+        capabilities?: {
+            implements?: {
+                protocol: {
+                    label: string;
+                    version: {
+                        major: number;
+                        minor: number;
+                        patch: number;
+                    };
+                    id: string;
+                    description?: string | undefined;
+                    specification?: string | undefined;
+                };
+                conformance: "partial" | "full" | "deprecated" | "experimental";
+                certified: boolean;
+                metadata?: Record<string, any> | undefined;
+                features?: {
+                    enabled: boolean;
+                    name: string;
+                    description?: string | undefined;
+                    sinceVersion?: string | undefined;
+                    deprecatedSince?: string | undefined;
+                }[] | undefined;
+                implementedFeatures?: string[] | undefined;
+                certificationDate?: string | undefined;
+            }[] | undefined;
+            provides?: {
+                methods: {
+                    name: string;
+                    async: boolean;
+                    description?: string | undefined;
+                    parameters?: {
+                        type: string;
+                        required: boolean;
+                        name: string;
+                        description?: string | undefined;
+                    }[] | undefined;
+                    returnType?: string | undefined;
+                }[];
+                name: string;
+                version: {
+                    major: number;
+                    minor: number;
+                    patch: number;
+                };
+                id: string;
+                stability: "alpha" | "experimental" | "stable" | "beta";
+                description?: string | undefined;
+                events?: {
+                    name: string;
+                    description?: string | undefined;
+                    payload?: string | undefined;
+                }[] | undefined;
+            }[] | undefined;
+            requires?: {
+                version: string;
+                optional: boolean;
+                pluginId: string;
+                reason?: string | undefined;
+                requiredCapabilities?: string[] | undefined;
+            }[] | undefined;
+            extensionPoints?: {
+                type: "provider" | "action" | "widget" | "hook" | "transformer" | "validator" | "decorator";
+                name: string;
+                id: string;
+                cardinality: "multiple" | "single";
+                description?: string | undefined;
+                contract?: {
+                    signature?: string | undefined;
+                    input?: string | undefined;
+                    output?: string | undefined;
+                } | undefined;
+            }[] | undefined;
+            extensions?: {
+                priority: number;
+                implementation: string;
+                targetPluginId: string;
+                extensionPointId: string;
+            }[] | undefined;
+        } | undefined;
+        objects?: string[] | undefined;
+        permissions?: string[] | undefined;
+        extensions?: Record<string, any> | undefined;
+        loading?: {
+            strategy: "parallel" | "eager" | "lazy" | "deferred" | "on-demand";
+            caching?: {
+                enabled: boolean;
+                storage: "hybrid" | "memory" | "disk" | "indexeddb";
+                keyStrategy: "hash" | "version" | "timestamp";
+                maxSize?: number | undefined;
+                ttl?: number | undefined;
+                invalidateOn?: ("error" | "manual" | "version-change" | "dependency-change")[] | undefined;
+                compression?: {
+                    enabled: boolean;
+                    algorithm: "gzip" | "brotli" | "deflate";
+                } | undefined;
+            } | undefined;
+            preload?: {
+                enabled: boolean;
+                priority: number;
+                conditions?: {
+                    roles?: string[] | undefined;
+                    routes?: string[] | undefined;
+                    deviceType?: ("desktop" | "mobile" | "tablet")[] | undefined;
+                    minNetworkSpeed?: "slow-2g" | "2g" | "3g" | "4g" | undefined;
+                } | undefined;
+                resources?: ("code" | "dependencies" | "metadata" | "assets" | "services")[] | undefined;
+            } | undefined;
+            codeSplitting?: {
+                enabled: boolean;
+                strategy: "custom" | "size" | "route" | "feature";
+                chunkNaming: "hashed" | "named" | "sequential";
+                maxChunkSize?: number | undefined;
+                sharedDependencies?: {
+                    enabled: boolean;
+                    minChunks: number;
+                } | undefined;
+            } | undefined;
+            dynamicImport?: {
+                enabled: boolean;
+                timeout: number;
+                mode: "async" | "eager" | "lazy" | "sync";
+                prefetch: boolean;
+                preload: boolean;
+                retry?: {
+                    enabled: boolean;
+                    maxAttempts: number;
+                    backoffMs: number;
+                } | undefined;
+                webpackChunkName?: string | undefined;
+            } | undefined;
+            initialization?: {
+                timeout: number;
+                priority: number;
+                mode: "async" | "parallel" | "sequential" | "sync";
+                critical: boolean;
+                retry?: {
+                    enabled: boolean;
+                    maxAttempts: number;
+                    backoffMs: number;
+                } | undefined;
+                healthCheckInterval?: number | undefined;
+            } | undefined;
+            dependencyResolution?: {
+                strategy: "strict" | "latest" | "compatible" | "pinned";
+                conflictResolution: "latest" | "manual" | "fail" | "oldest";
+                circularDependencies: "error" | "warn" | "allow";
+                peerDependencies?: {
+                    resolve: boolean;
+                    onMissing: "error" | "warn" | "ignore";
+                    onMismatch: "error" | "warn" | "ignore";
+                } | undefined;
+                optionalDependencies?: {
+                    load: boolean;
+                    onFailure: "warn" | "ignore";
+                } | undefined;
+            } | undefined;
+            hotReload?: {
+                enabled: boolean;
+                strategy: "partial" | "full" | "state-preserve";
+                debounceMs: number;
+                preserveState: boolean;
+                watchPatterns?: string[] | undefined;
+                ignorePatterns?: string[] | undefined;
+                stateSerialization?: {
+                    enabled: boolean;
+                    handler?: string | undefined;
+                } | undefined;
+                hooks?: {
+                    onError?: string | undefined;
+                    beforeReload?: string | undefined;
+                    afterReload?: string | undefined;
+                } | undefined;
+            } | undefined;
+            sandboxing?: {
+                enabled: boolean;
+                isolationLevel: "none" | "process" | "vm" | "iframe" | "web-worker";
+                permissions?: {
+                    allowedAPIs?: string[] | undefined;
+                    allowedPaths?: string[] | undefined;
+                    allowedEndpoints?: string[] | undefined;
+                    allowedEnvVars?: string[] | undefined;
+                } | undefined;
+                allowedCapabilities?: string[] | undefined;
+                resourceQuotas?: {
+                    maxMemoryMB?: number | undefined;
+                    maxCpuTimeMs?: number | undefined;
+                    maxFileDescriptors?: number | undefined;
+                    maxNetworkKBps?: number | undefined;
+                } | undefined;
+            } | undefined;
+            monitoring?: {
+                enabled: boolean;
+                samplingRate: number;
+                reportingInterval: number;
+                onBudgetViolation: "error" | "warn" | "ignore";
+                metrics?: ("load-time" | "init-time" | "memory-usage" | "cpu-usage" | "api-calls" | "error-rate" | "cache-hit-rate")[] | undefined;
+                budgets?: {
+                    maxMemoryMB?: number | undefined;
+                    maxLoadTimeMs?: number | undefined;
+                    maxInitTimeMs?: number | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        datasources?: string[] | undefined;
+        configuration?: {
+            properties: Record<string, {
+                type: "string" | "number" | "boolean" | "object" | "array";
+                required?: boolean | undefined;
+                default?: any;
+                description?: string | undefined;
+                enum?: string[] | undefined;
+                secret?: boolean | undefined;
+            }>;
+            title?: string | undefined;
+        } | undefined;
+        contributes?: {
+            events?: string[] | undefined;
+            fieldTypes?: {
+                label: string;
+                name: string;
+                description?: string | undefined;
+            }[] | undefined;
+            actions?: {
+                name: string;
+                label?: string | undefined;
+                description?: string | undefined;
+                input?: any;
+                output?: any;
+            }[] | undefined;
+            kinds?: {
+                id: string;
+                globs: string[];
+                description?: string | undefined;
+            }[] | undefined;
+            menus?: Record<string, {
+                label: string;
+                id: string;
+                command?: string | undefined;
+            }[]> | undefined;
+            themes?: {
+                path: string;
+                label: string;
+                id: string;
+            }[] | undefined;
+            translations?: {
+                path: string;
+                locale: string;
+            }[] | undefined;
+            drivers?: {
+                label: string;
+                id: string;
+                description?: string | undefined;
+            }[] | undefined;
+            functions?: {
+                name: string;
+                description?: string | undefined;
+                returnType?: string | undefined;
+                args?: string[] | undefined;
+            }[] | undefined;
+        } | undefined;
+    };
+    /**
+     * Universal Unregister Method
+     */
+    static unregisterItem(type: string, name: string): void;
+    /**
+     * Universal Get Method
+     */
+    static getItem<T>(type: string, name: string): T | undefined;
+    /**
+     * Universal List Method
+     */
+    static listItems<T>(type: string): T[];
+    /**
+     * Get all registered metadata types (Kinds)
+     */
+    static getRegisteredTypes(): string[];
+    /**
+     * Object Helpers
+     */
+    static registerObject(schema: ServiceObject): void;
+    static getObject(name: string): ServiceObject | undefined;
+    static getAllObjects(): ServiceObject[];
+    /**
+     * Plugin Helpers
+     */
+    static registerPlugin(manifest: ObjectStackManifest): void;
+    static getAllPlugins(): ObjectStackManifest[];
+    /**
+     * Kind (Metadata Type) Helpers
+     */
+    static registerKind(kind: {
+        id: string;
+        globs: string[];
+    }): void;
+    static getAllKinds(): {
+        id: string;
+        globs: string[];
+    }[];
+}
+
+declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
+    private engine;
+    constructor(engine: IDataEngine);
+    getDiscovery(_request: {}): Promise<{
+        version: string;
+        apiName: string;
+        capabilities: {
+            graphql: boolean;
+            search: boolean;
+            websockets: boolean;
+            files: boolean;
+            analytics: boolean;
+            hub: boolean;
+        };
+        endpoints: {
+            data: string;
+            metadata: string;
+            auth: string;
+        };
+    }>;
+    getMetaTypes(_request: {}): Promise<{
+        types: string[];
+    }>;
+    getMetaItems(request: {
+        type: string;
+    }): Promise<{
+        type: string;
+        items: unknown[];
+    }>;
+    getMetaItem(request: {
+        type: string;
+        name: string;
+    }): Promise<{
+        type: string;
+        name: string;
+        item: unknown;
+    }>;
+    getUiView(request: {
+        object: string;
+        type: 'list' | 'form';
+    }): Promise<any>;
+    findData(request: {
+        object: string;
+        query?: any;
+    }): Promise<{
+        object: string;
+        value: any[];
+        records: any[];
+        total: number;
+        hasMore: boolean;
+    }>;
+    getData(request: {
+        object: string;
+        id: string;
+    }): Promise<{
+        object: string;
+        id: string;
+        record: any;
+    }>;
+    createData(request: {
+        object: string;
+        data: any;
+    }): Promise<{
+        object: string;
+        id: any;
+        record: any;
+    }>;
+    updateData(request: {
+        object: string;
+        id: string;
+        data: any;
+    }): Promise<{
+        object: string;
+        id: string;
+        record: any;
+    }>;
+    deleteData(request: {
+        object: string;
+        id: string;
+    }): Promise<{
+        object: string;
+        id: string;
+        success: boolean;
+    }>;
+    getMetaItemCached(request: {
+        type: string;
+        name: string;
+        cacheRequest?: MetadataCacheRequest;
+    }): Promise<MetadataCacheResponse>;
+    batchData(_request: {
+        object: string;
+        request: BatchUpdateRequest;
+    }): Promise<BatchUpdateResponse>;
+    createManyData(request: {
+        object: string;
+        records: any[];
+    }): Promise<any>;
+    updateManyData(_request: UpdateManyDataRequest): Promise<any>;
+    analyticsQuery(_request: any): Promise<any>;
+    getAnalyticsMeta(_request: any): Promise<any>;
+    triggerAutomation(_request: any): Promise<any>;
+    listSpaces(_request: any): Promise<any>;
+    createSpace(_request: any): Promise<any>;
+    installPlugin(_request: any): Promise<any>;
+    deleteManyData(request: DeleteManyDataRequest): Promise<any>;
+    saveMetaItem(request: {
+        type: string;
+        name: string;
+        item?: any;
+    }): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+}
+
+type HookHandler = (context: HookContext) => Promise<void> | void;
+/**
+ * Host Context provided to plugins (Internal ObjectQL Plugin System)
+ */
+interface ObjectQLHostContext {
+    ql: ObjectQL;
+    logger: Logger;
+    [key: string]: any;
+}
+/**
+ * ObjectQL Engine
+ *
+ * Implements the IDataEngine interface for data persistence.
+ * Acts as the reference implementation for:
+ * - CoreServiceName.data (CRUD)
+ * - CoreServiceName.metadata (Schema Registry)
+ */
+declare class ObjectQL implements IDataEngine {
+    private drivers;
+    private defaultDriver;
+    private logger;
+    private hooks;
+    private hostContext;
+    constructor(hostContext?: Record<string, any>);
+    /**
+     * Service Status Report
+     * Used by Kernel to verify health and capabilities.
+     */
+    getStatus(): {
+        name: "data";
+        status: string;
+        version: string;
+        features: string[];
+    };
+    /**
+     * Expose the SchemaRegistry for plugins to register metadata
+     */
+    get registry(): typeof SchemaRegistry;
+    /**
+     * Load and Register a Plugin
+     */
+    use(manifestPart: any, runtimePart?: any): Promise<void>;
+    /**
+     * Register a hook
+     * @param event The event name (e.g. 'beforeFind', 'afterInsert')
+     * @param handler The handler function
+     */
+    registerHook(event: string, handler: HookHandler): void;
+    triggerHooks(event: string, context: HookContext): Promise<void>;
+    /**
+     * Register contribution (Manifest)
+     */
+    registerApp(manifest: any): void;
+    /**
+     * Register a new storage driver
+     */
+    registerDriver(driver: DriverInterface, isDefault?: boolean): void;
+    /**
+     * Helper to get object definition
+     */
+    getSchema(objectName: string): {
+        fields: Record<string, {
+            type: "number" | "boolean" | "code" | "date" | "lookup" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
+            required: boolean;
+            searchable: boolean;
+            multiple: boolean;
+            unique: boolean;
+            deleteBehavior: "set_null" | "cascade" | "restrict";
+            auditTrail: boolean;
+            hidden: boolean;
+            readonly: boolean;
+            encryption: boolean;
+            index: boolean;
+            externalId: boolean;
+            options?: {
+                value: string;
+                label: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            expression?: string | undefined;
+            defaultValue?: any;
+            min?: number | undefined;
+            max?: number | undefined;
+            step?: number | undefined;
+            language?: string | undefined;
+            encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "field" | "database" | "record";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            formula?: string | undefined;
+            label?: string | undefined;
+            precision?: number | undefined;
+            name?: string | undefined;
+            description?: string | undefined;
+            format?: string | undefined;
+            maxLength?: number | undefined;
+            minLength?: number | undefined;
+            scale?: number | undefined;
+            reference?: string | undefined;
+            referenceFilters?: string[] | undefined;
+            writeRequiresMasterRead?: boolean | undefined;
+            summaryOperations?: {
+                object: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+                field: string;
+            } | undefined;
+            theme?: string | undefined;
+            lineNumbers?: boolean | undefined;
+            maxRating?: number | undefined;
+            allowHalf?: boolean | undefined;
+            displayMap?: boolean | undefined;
+            allowGeocoding?: boolean | undefined;
+            addressFormat?: "us" | "uk" | "international" | undefined;
+            colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            allowAlpha?: boolean | undefined;
+            presetColors?: string[] | undefined;
+            showValue?: boolean | undefined;
+            marks?: Record<string, string> | undefined;
+            barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            displayValue?: boolean | undefined;
+            allowScanning?: boolean | undefined;
+            currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+            } | undefined;
+            fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    autoRotate: boolean;
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            maskingRule?: {
+                field: string;
+                strategy: "partial" | "hash" | "redact" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            dependencies?: string[] | undefined;
+            cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+        }>;
+        name: string;
+        active: boolean;
+        isSystem: boolean;
+        abstract: boolean;
+        datasource: string;
+        search?: {
+            fields: string[];
+            displayFields?: string[] | undefined;
+            filters?: string[] | undefined;
+        } | undefined;
+        tags?: string[] | undefined;
+        label?: string | undefined;
+        description?: string | undefined;
+        pluralLabel?: string | undefined;
+        icon?: string | undefined;
+        tableName?: string | undefined;
+        indexes?: {
+            type: "hash" | "btree" | "gin" | "gist" | "fulltext";
+            fields: string[];
+            unique: boolean;
+            partial?: string | undefined;
+            name?: string | undefined;
+        }[] | undefined;
+        tenancy?: {
+            enabled: boolean;
+            strategy: "shared" | "isolated" | "hybrid";
+            tenantField: string;
+            crossTenantAccess: boolean;
+        } | undefined;
+        softDelete?: {
+            enabled: boolean;
+            field: string;
+            cascadeDelete: boolean;
+        } | undefined;
+        versioning?: {
+            enabled: boolean;
+            strategy: "snapshot" | "delta" | "event-sourcing";
+            versionField: string;
+            retentionDays?: number | undefined;
+        } | undefined;
+        partitioning?: {
+            enabled: boolean;
+            strategy: "hash" | "range" | "list";
+            key: string;
+            interval?: string | undefined;
+        } | undefined;
+        cdc?: {
+            enabled: boolean;
+            events: ("insert" | "update" | "delete")[];
+            destination: string;
+        } | undefined;
+        validations?: any[] | undefined;
+        titleFormat?: string | undefined;
+        compactLayout?: string[] | undefined;
+        enable?: {
+            searchable: boolean;
+            trackHistory: boolean;
+            apiEnabled: boolean;
+            files: boolean;
+            feeds: boolean;
+            activities: boolean;
+            trash: boolean;
+            mru: boolean;
+            clone: boolean;
+            apiMethods?: ("search" | "update" | "delete" | "get" | "list" | "create" | "upsert" | "bulk" | "aggregate" | "history" | "restore" | "purge" | "import" | "export")[] | undefined;
+        } | undefined;
+    } | undefined;
+    /**
+     * Helper to get the target driver
+     */
+    private getDriver;
+    /**
+     * Initialize the engine and all registered drivers
+     */
+    init(): Promise<void>;
+    destroy(): Promise<void>;
+    private toQueryAST;
+    find(object: string, query?: DataEngineQueryOptions): Promise<any[]>;
+    findOne(objectName: string, query?: DataEngineQueryOptions): Promise<any>;
+    insert(object: string, data: any | any[], options?: DataEngineInsertOptions): Promise<any>;
+    update(object: string, data: any, options?: DataEngineUpdateOptions): Promise<any>;
+    delete(object: string, options?: DataEngineDeleteOptions): Promise<any>;
+    count(object: string, query?: DataEngineCountOptions): Promise<number>;
+    aggregate(object: string, query: DataEngineAggregateOptions): Promise<any[]>;
+    execute(command: any, options?: Record<string, any>): Promise<any>;
+}
+
+declare class ObjectQLPlugin implements Plugin {
+    name: string;
+    type: "objectql";
+    version: string;
+    private ql;
+    private hostContext?;
+    constructor(ql?: ObjectQL, hostContext?: Record<string, any>);
+    init: (ctx: PluginContext) => Promise<void>;
+    start: (ctx: PluginContext) => Promise<void>;
+}
+
+export { type HookHandler, ObjectQL, type ObjectQLHostContext, ObjectQLPlugin, ObjectStackProtocolImplementation, SchemaRegistry };