@vibecms/core 0.1.0

package/dist/index-C3P1J_of.d.ts

@@ -0,0 +1,339 @@
+import { S as StorageDriver, a as SyncEngine, V as VibeEngineConfig, C as CommitAuthor, L as ListOptions, H as HistoryEntry } from './types-BkDsDmQJ.js';
+import { z } from 'zod';
+import { ComponentType } from 'react';
+
+type VibeRole = 'owner' | 'editor' | 'viewer';
+interface VibeUser {
+    name?: string | null;
+    email?: string | null;
+    image?: string | null;
+    role?: VibeRole;
+}
+interface VibeAccessRule {
+    email: string;
+    role: VibeRole;
+}
+interface AuthProvider {
+    getSession(): Promise<{
+        user: VibeUser;
+        accessToken?: string;
+    } | null>;
+    signIn(): Promise<void>;
+    signOut(): Promise<void>;
+}
+
+type VibeEventType = 'content:save' | 'content:publish' | 'content:unpublish' | 'content:delete' | 'content:commit' | 'media:upload' | 'media:prune';
+interface VibeEvent {
+    type: VibeEventType;
+    collection?: string;
+    slug?: string;
+    data?: any;
+    timestamp: number;
+    author?: {
+        name: string;
+        email: string;
+    };
+}
+interface WebhookConfig {
+    /** URL to send the POST request to */
+    url: string;
+    /** Which events trigger this webhook. Empty = all events. */
+    events?: VibeEventType[];
+    /** Optional secret for HMAC signature verification (X-Vibe-Signature header) */
+    secret?: string;
+}
+type EventListener = (event: VibeEvent) => void | Promise<void>;
+declare class VibeEventBus {
+    private listeners;
+    private webhooks;
+    /**
+     * Register webhooks from config.
+     */
+    registerWebhooks(webhooks: WebhookConfig[]): void;
+    /**
+     * Subscribe to a specific event type or '*' for all events.
+     */
+    on(type: VibeEventType | '*', listener: EventListener): () => void;
+    /**
+     * Emit an event. Notifies all listeners and fires webhooks.
+     */
+    emit(event: VibeEvent): Promise<void>;
+    private fireWebhooks;
+}
+declare const vibeEvents: VibeEventBus;
+
+interface VibeCollection {
+    name: string;
+    schema: z.ZodTypeAny;
+    /** Restrict which roles can edit this collection. Default: ['owner', 'editor'] */
+    editRoles?: VibeRole[];
+}
+/**
+ * Registration entry for a custom block renderer.
+ */
+interface VibeBlockRegistration {
+    /** The `_type` value in your block schema */
+    type: string;
+    /** React component to render this block. Receives `{ data, index }` props. */
+    component: ComponentType<{
+        data: any;
+        index: string | number;
+    }>;
+}
+interface VibeConfig {
+    /**
+     * VibeCMS license key. Set via `VIBE_LICENSE_KEY` env var (preferred) or here.
+     * Get your key at https://vibecms.com/pricing
+     */
+    licenseKey?: string;
+    contentDir?: string;
+    publicDir?: string;
+    auth?: AuthProvider;
+    media?: {
+        driver: StorageDriver;
+    };
+    collections?: Record<string, VibeCollection>;
+    /**
+     * Single global documents that do not have a list view (e.g., globals, navigation, footer).
+     * They behave like collections but are enforced to have a single slug 'index'.
+     */
+    singletons?: Record<string, VibeCollection>;
+    /**
+     * Register custom block renderers. These are merged with built-in blocks.
+     * Custom registrations take precedence over built-in blocks with the same `_type`.
+     *
+     * Example:
+     *   blocks: [
+     *     { type: 'comparison-table', component: ComparisonTable },
+     *     { type: 'hero', component: CustomHero }, // overrides built-in hero
+     *   ]
+     */
+    blocks?: VibeBlockRegistration[];
+    /**
+     * Access control list. The first entry should be the owner.
+     * Users not in this list are denied access to the CMS editor.
+     *
+     * Example:
+     *   access: [
+     *     { email: 'owner@example.com', role: 'owner' },
+     *     { email: 'editor@company.de', role: 'editor' },
+     *     { email: 'viewer@company.de', role: 'viewer' },
+     *   ]
+     */
+    access?: VibeAccessRule[];
+    /**
+     * Webhooks to notify on content lifecycle events.
+     *
+     * Example:
+     *   webhooks: [
+     *     { url: 'https://hooks.example.com/deploy', events: ['content:publish'], secret: 'whsec_...' },
+     *   ]
+     */
+    webhooks?: WebhookConfig[];
+    /**
+     * Localization support. Specify all locales you want the CMS to generate files for.
+     * If enabled, documents are saved as `[slug].[locale].json`.
+     */
+    locales?: string[];
+    defaultLocale?: string;
+}
+declare function defineConfig(config: VibeConfig): VibeConfig;
+declare function registerCollectionSchemas(collections?: Record<string, VibeCollection>, singletons?: Record<string, VibeCollection>): void;
+declare function getCollectionSchema(collection: string): z.ZodTypeAny | undefined;
+/**
+ * Validate data against a collection's schema.
+ * Returns { success: true, data } or { success: false, errors }.
+ */
+declare function validateCollectionData(collection: string, data: unknown): {
+    success: true;
+    data: any;
+} | {
+    success: false;
+    errors: string[];
+};
+/**
+ * Resolve the role for a given email from the access list.
+ * Returns null if the user is not whitelisted.
+ */
+declare function resolveUserRole(config: VibeConfig, email: string | null | undefined): VibeRole | null;
+/**
+ * Check whether a role is allowed to edit a specific collection.
+ */
+declare function canEditCollection(config: VibeConfig, role: VibeRole | null, collectionKey: string): boolean;
+declare function registerCustomBlocks(blocks: VibeBlockRegistration[]): void;
+declare function getCustomBlockComponent(type: string): ComponentType<{
+    data: any;
+    index: string | number;
+}> | undefined;
+
+/**
+ * Validate a content slug. Slugs are used as filenames and must be safe
+ * for filesystem paths and shell arguments.
+ */
+declare function validateSlug(slug: string): boolean;
+/**
+ * Validate a git commit OID (SHA-1 hex hash).
+ */
+declare function validateCommitOid(oid: string): boolean;
+/**
+ * Validate a collection name.
+ */
+declare function validateCollection(collection: string): boolean;
+/**
+ * Assert slug is valid, throw if not.
+ */
+declare function assertValidSlug(slug: string): void;
+/**
+ * Assert commit OID is valid, throw if not.
+ */
+declare function assertValidCommitOid(oid: string): void;
+/**
+ * Assert collection name is valid, throw if not.
+ */
+declare function assertValidCollection(collection: string): void;
+/**
+ * Sanitize a redirect path to prevent open redirects.
+ * Returns '/' if the path is invalid.
+ */
+declare function sanitizeRedirectPath(path: string | null | undefined): string;
+
+declare class NodeEngine implements SyncEngine {
+    private contentDir;
+    private publicDir;
+    private config?;
+    private contentCache;
+    init(config?: VibeEngineConfig): Promise<void>;
+    private resolveFilename;
+    read(collection: string, slug: string, options?: {
+        locale?: string;
+    }): Promise<any>;
+    write(collection: string, slug: string, data: any, options?: {
+        locale?: string;
+    }): Promise<void>;
+    delete(collection: string, slug: string, options?: {
+        locale?: string;
+    }): Promise<void>;
+    isDirty(): Promise<boolean>;
+    revert(): Promise<void>;
+    commit(_message: string, _author?: CommitAuthor): Promise<void>;
+    push(): Promise<void>;
+    pull(): Promise<void>;
+    writeMedia(file: File, author?: CommitAuthor): Promise<string | {
+        url: string;
+        width?: number;
+        height?: number;
+        alt?: string;
+    }>;
+    listMedia(): Promise<string[]>;
+    deleteMedia(filename: string): Promise<void>;
+    renameMedia(oldFilename: string, newFilename: string): Promise<void>;
+    pruneMedia(): Promise<{
+        deletedCount: number;
+        bytesFreed: number;
+    }>;
+    getMediaUrl(relativePath: string): Promise<string>;
+    list(collection: string, options?: ListOptions): Promise<any[]>;
+    getHistory(collection: string, slug: string): Promise<HistoryEntry[]>;
+    getVersionContent(commitOid: string, collection: string, slug: string): Promise<any>;
+}
+
+declare class BrowserEngine implements SyncEngine {
+    private fs;
+    private pfs;
+    private dir;
+    private contentDir;
+    private publicDir;
+    private gitProxyUrl;
+    private isInitializing;
+    private initialized;
+    private config?;
+    constructor();
+    init(config?: VibeEngineConfig): Promise<void>;
+    private resolveFilename;
+    read(collection: string, slug: string, options?: {
+        locale?: string;
+    }): Promise<any>;
+    write(collection: string, slug: string, data: any, options?: {
+        locale?: string;
+    }): Promise<void>;
+    delete(collection: string, slug: string, options?: {
+        locale?: string;
+    }): Promise<void>;
+    isDirty(collection: string, slug: string): Promise<boolean>;
+    revert(collection: string, slug: string): Promise<void>;
+    commit(message: string, author?: CommitAuthor): Promise<void>;
+    push(oauthToken: string): Promise<void>;
+    pull(): Promise<void>;
+    writeMedia(file: File, author?: CommitAuthor): Promise<string | {
+        url: string;
+        width?: number;
+        height?: number;
+        alt?: string;
+    }>;
+    pruneMedia(): Promise<{
+        deletedCount: number;
+        bytesFreed: number;
+    }>;
+    listMedia(): Promise<string[]>;
+    deleteMedia(filename: string): Promise<void>;
+    renameMedia(oldFilename: string, newFilename: string): Promise<void>;
+    getMediaUrl(relativePath: string): Promise<string>;
+    list(collection: string, options?: ListOptions): Promise<any>;
+    getHistory(collection: string, slug: string): Promise<HistoryEntry[]>;
+    getVersionContent(commitOid: string, collection: string, slug: string): Promise<any>;
+}
+
+declare class DevEngine implements SyncEngine {
+    private apiBase;
+    private config?;
+    init(config?: VibeEngineConfig): Promise<void>;
+    private fetchApi;
+    read<T = any>(collection: string, slug: string, options?: {
+        locale?: string;
+    }): Promise<T | null>;
+    write<T = any>(collection: string, slug: string, data: T, options?: {
+        locale?: string;
+    }): Promise<void>;
+    delete(collection: string, slug: string, options?: {
+        locale?: string;
+    }): Promise<void>;
+    isDirty(): Promise<boolean>;
+    revert(): Promise<void>;
+    commit(_message: string, _author?: CommitAuthor): Promise<void>;
+    push(): Promise<void>;
+    pull(): Promise<void>;
+    writeMedia(file: File, author?: CommitAuthor): Promise<any>;
+    listMedia(): Promise<string[]>;
+    deleteMedia(filename: string): Promise<void>;
+    renameMedia(oldFilename: string, newFilename: string): Promise<void>;
+    pruneMedia(): Promise<{
+        deletedCount: number;
+        bytesFreed: number;
+    }>;
+    getMediaUrl(relativePath: string): Promise<string>;
+    list(collection: string, options?: ListOptions): Promise<any>;
+    getHistory(_collection: string, _slug: string): Promise<HistoryEntry[]>;
+    getVersionContent(commitOid: string, collection: string, slug: string): Promise<any>;
+}
+
+/**
+ * Proxy guard: prevents using VibeEngine methods without a valid license.
+ * All function calls (except init) require `_licensed === true`, which is
+ * only set by `initVibeEngine()` after successful license validation.
+ */
+declare const VibeEngine: SyncEngine;
+/**
+ * Initialize the engine with license validation, then register collection schemas.
+ * Call this once at app startup (e.g. in EditProvider or AdminShell).
+ *
+ * @throws {Error} if the license key is missing, invalid, or expired
+ */
+declare function initVibeEngine(config: VibeEngineConfig & {
+    licenseKey?: string;
+}, collections?: Record<string, VibeCollection>, singletons?: Record<string, VibeCollection>): Promise<void>;
+declare function populate(document: any, refs: {
+    field: string;
+    collection: string;
+}[]): Promise<any>;
+
+export { type AuthProvider as A, BrowserEngine as B, DevEngine as D, NodeEngine as N, type VibeAccessRule as V, type WebhookConfig as W, type VibeBlockRegistration as a, type VibeCollection as b, type VibeConfig as c, VibeEngine as d, type VibeEvent as e, type VibeEventType as f, type VibeRole as g, type VibeUser as h, assertValidCollection as i, assertValidCommitOid as j, assertValidSlug as k, canEditCollection as l, defineConfig as m, getCollectionSchema as n, getCustomBlockComponent as o, initVibeEngine as p, populate as q, registerCollectionSchemas as r, registerCustomBlocks as s, resolveUserRole as t, sanitizeRedirectPath as u, validateCollection as v, validateCollectionData as w, validateCommitOid as x, validateSlug as y, vibeEvents as z };

package/dist/index-CO4uwTdH.d.mts

@@ -0,0 +1,339 @@
+import { S as StorageDriver, a as SyncEngine, V as VibeEngineConfig, C as CommitAuthor, L as ListOptions, H as HistoryEntry } from './types-BkDsDmQJ.mjs';
+import { z } from 'zod';
+import { ComponentType } from 'react';
+
+type VibeRole = 'owner' | 'editor' | 'viewer';
+interface VibeUser {
+    name?: string | null;
+    email?: string | null;
+    image?: string | null;
+    role?: VibeRole;
+}
+interface VibeAccessRule {
+    email: string;
+    role: VibeRole;
+}
+interface AuthProvider {
+    getSession(): Promise<{
+        user: VibeUser;
+        accessToken?: string;
+    } | null>;
+    signIn(): Promise<void>;
+    signOut(): Promise<void>;
+}
+
+type VibeEventType = 'content:save' | 'content:publish' | 'content:unpublish' | 'content:delete' | 'content:commit' | 'media:upload' | 'media:prune';
+interface VibeEvent {
+    type: VibeEventType;
+    collection?: string;
+    slug?: string;
+    data?: any;
+    timestamp: number;
+    author?: {
+        name: string;
+        email: string;
+    };
+}
+interface WebhookConfig {
+    /** URL to send the POST request to */
+    url: string;
+    /** Which events trigger this webhook. Empty = all events. */
+    events?: VibeEventType[];
+    /** Optional secret for HMAC signature verification (X-Vibe-Signature header) */
+    secret?: string;
+}
+type EventListener = (event: VibeEvent) => void | Promise<void>;
+declare class VibeEventBus {
+    private listeners;
+    private webhooks;
+    /**
+     * Register webhooks from config.
+     */
+    registerWebhooks(webhooks: WebhookConfig[]): void;
+    /**
+     * Subscribe to a specific event type or '*' for all events.
+     */
+    on(type: VibeEventType | '*', listener: EventListener): () => void;
+    /**
+     * Emit an event. Notifies all listeners and fires webhooks.
+     */
+    emit(event: VibeEvent): Promise<void>;
+    private fireWebhooks;
+}
+declare const vibeEvents: VibeEventBus;
+
+interface VibeCollection {
+    name: string;
+    schema: z.ZodTypeAny;
+    /** Restrict which roles can edit this collection. Default: ['owner', 'editor'] */
+    editRoles?: VibeRole[];
+}
+/**
+ * Registration entry for a custom block renderer.
+ */
+interface VibeBlockRegistration {
+    /** The `_type` value in your block schema */
+    type: string;
+    /** React component to render this block. Receives `{ data, index }` props. */
+    component: ComponentType<{
+        data: any;
+        index: string | number;
+    }>;
+}
+interface VibeConfig {
+    /**
+     * VibeCMS license key. Set via `VIBE_LICENSE_KEY` env var (preferred) or here.
+     * Get your key at https://vibecms.com/pricing
+     */
+    licenseKey?: string;
+    contentDir?: string;
+    publicDir?: string;
+    auth?: AuthProvider;
+    media?: {
+        driver: StorageDriver;
+    };
+    collections?: Record<string, VibeCollection>;
+    /**
+     * Single global documents that do not have a list view (e.g., globals, navigation, footer).
+     * They behave like collections but are enforced to have a single slug 'index'.
+     */
+    singletons?: Record<string, VibeCollection>;
+    /**
+     * Register custom block renderers. These are merged with built-in blocks.
+     * Custom registrations take precedence over built-in blocks with the same `_type`.
+     *
+     * Example:
+     *   blocks: [
+     *     { type: 'comparison-table', component: ComparisonTable },
+     *     { type: 'hero', component: CustomHero }, // overrides built-in hero
+     *   ]
+     */
+    blocks?: VibeBlockRegistration[];
+    /**
+     * Access control list. The first entry should be the owner.
+     * Users not in this list are denied access to the CMS editor.
+     *
+     * Example:
+     *   access: [
+     *     { email: 'owner@example.com', role: 'owner' },
+     *     { email: 'editor@company.de', role: 'editor' },
+     *     { email: 'viewer@company.de', role: 'viewer' },
+     *   ]
+     */
+    access?: VibeAccessRule[];
+    /**
+     * Webhooks to notify on content lifecycle events.
+     *
+     * Example:
+     *   webhooks: [
+     *     { url: 'https://hooks.example.com/deploy', events: ['content:publish'], secret: 'whsec_...' },
+     *   ]
+     */
+    webhooks?: WebhookConfig[];
+    /**
+     * Localization support. Specify all locales you want the CMS to generate files for.
+     * If enabled, documents are saved as `[slug].[locale].json`.
+     */
+    locales?: string[];
+    defaultLocale?: string;
+}
+declare function defineConfig(config: VibeConfig): VibeConfig;
+declare function registerCollectionSchemas(collections?: Record<string, VibeCollection>, singletons?: Record<string, VibeCollection>): void;
+declare function getCollectionSchema(collection: string): z.ZodTypeAny | undefined;
+/**
+ * Validate data against a collection's schema.
+ * Returns { success: true, data } or { success: false, errors }.
+ */
+declare function validateCollectionData(collection: string, data: unknown): {
+    success: true;
+    data: any;
+} | {
+    success: false;
+    errors: string[];
+};
+/**
+ * Resolve the role for a given email from the access list.
+ * Returns null if the user is not whitelisted.
+ */
+declare function resolveUserRole(config: VibeConfig, email: string | null | undefined): VibeRole | null;
+/**
+ * Check whether a role is allowed to edit a specific collection.
+ */
+declare function canEditCollection(config: VibeConfig, role: VibeRole | null, collectionKey: string): boolean;
+declare function registerCustomBlocks(blocks: VibeBlockRegistration[]): void;
+declare function getCustomBlockComponent(type: string): ComponentType<{
+    data: any;
+    index: string | number;
+}> | undefined;
+
+/**
+ * Validate a content slug. Slugs are used as filenames and must be safe
+ * for filesystem paths and shell arguments.
+ */
+declare function validateSlug(slug: string): boolean;
+/**
+ * Validate a git commit OID (SHA-1 hex hash).
+ */
+declare function validateCommitOid(oid: string): boolean;
+/**
+ * Validate a collection name.
+ */
+declare function validateCollection(collection: string): boolean;
+/**
+ * Assert slug is valid, throw if not.
+ */
+declare function assertValidSlug(slug: string): void;
+/**
+ * Assert commit OID is valid, throw if not.
+ */
+declare function assertValidCommitOid(oid: string): void;
+/**
+ * Assert collection name is valid, throw if not.
+ */
+declare function assertValidCollection(collection: string): void;
+/**
+ * Sanitize a redirect path to prevent open redirects.
+ * Returns '/' if the path is invalid.
+ */
+declare function sanitizeRedirectPath(path: string | null | undefined): string;
+
+declare class NodeEngine implements SyncEngine {
+    private contentDir;
+    private publicDir;
+    private config?;
+    private contentCache;
+    init(config?: VibeEngineConfig): Promise<void>;
+    private resolveFilename;
+    read(collection: string, slug: string, options?: {
+        locale?: string;
+    }): Promise<any>;
+    write(collection: string, slug: string, data: any, options?: {
+        locale?: string;
+    }): Promise<void>;
+    delete(collection: string, slug: string, options?: {
+        locale?: string;
+    }): Promise<void>;
+    isDirty(): Promise<boolean>;
+    revert(): Promise<void>;
+    commit(_message: string, _author?: CommitAuthor): Promise<void>;
+    push(): Promise<void>;
+    pull(): Promise<void>;
+    writeMedia(file: File, author?: CommitAuthor): Promise<string | {
+        url: string;
+        width?: number;
+        height?: number;
+        alt?: string;
+    }>;
+    listMedia(): Promise<string[]>;
+    deleteMedia(filename: string): Promise<void>;
+    renameMedia(oldFilename: string, newFilename: string): Promise<void>;
+    pruneMedia(): Promise<{
+        deletedCount: number;
+        bytesFreed: number;
+    }>;
+    getMediaUrl(relativePath: string): Promise<string>;
+    list(collection: string, options?: ListOptions): Promise<any[]>;
+    getHistory(collection: string, slug: string): Promise<HistoryEntry[]>;
+    getVersionContent(commitOid: string, collection: string, slug: string): Promise<any>;
+}
+
+declare class BrowserEngine implements SyncEngine {
+    private fs;
+    private pfs;
+    private dir;
+    private contentDir;
+    private publicDir;
+    private gitProxyUrl;
+    private isInitializing;
+    private initialized;
+    private config?;
+    constructor();
+    init(config?: VibeEngineConfig): Promise<void>;
+    private resolveFilename;
+    read(collection: string, slug: string, options?: {
+        locale?: string;
+    }): Promise<any>;
+    write(collection: string, slug: string, data: any, options?: {
+        locale?: string;
+    }): Promise<void>;
+    delete(collection: string, slug: string, options?: {
+        locale?: string;
+    }): Promise<void>;
+    isDirty(collection: string, slug: string): Promise<boolean>;
+    revert(collection: string, slug: string): Promise<void>;
+    commit(message: string, author?: CommitAuthor): Promise<void>;
+    push(oauthToken: string): Promise<void>;
+    pull(): Promise<void>;
+    writeMedia(file: File, author?: CommitAuthor): Promise<string | {
+        url: string;
+        width?: number;
+        height?: number;
+        alt?: string;
+    }>;
+    pruneMedia(): Promise<{
+        deletedCount: number;
+        bytesFreed: number;
+    }>;
+    listMedia(): Promise<string[]>;
+    deleteMedia(filename: string): Promise<void>;
+    renameMedia(oldFilename: string, newFilename: string): Promise<void>;
+    getMediaUrl(relativePath: string): Promise<string>;
+    list(collection: string, options?: ListOptions): Promise<any>;
+    getHistory(collection: string, slug: string): Promise<HistoryEntry[]>;
+    getVersionContent(commitOid: string, collection: string, slug: string): Promise<any>;
+}
+
+declare class DevEngine implements SyncEngine {
+    private apiBase;
+    private config?;
+    init(config?: VibeEngineConfig): Promise<void>;
+    private fetchApi;
+    read<T = any>(collection: string, slug: string, options?: {
+        locale?: string;
+    }): Promise<T | null>;
+    write<T = any>(collection: string, slug: string, data: T, options?: {
+        locale?: string;
+    }): Promise<void>;
+    delete(collection: string, slug: string, options?: {
+        locale?: string;
+    }): Promise<void>;
+    isDirty(): Promise<boolean>;
+    revert(): Promise<void>;
+    commit(_message: string, _author?: CommitAuthor): Promise<void>;
+    push(): Promise<void>;
+    pull(): Promise<void>;
+    writeMedia(file: File, author?: CommitAuthor): Promise<any>;
+    listMedia(): Promise<string[]>;
+    deleteMedia(filename: string): Promise<void>;
+    renameMedia(oldFilename: string, newFilename: string): Promise<void>;
+    pruneMedia(): Promise<{
+        deletedCount: number;
+        bytesFreed: number;
+    }>;
+    getMediaUrl(relativePath: string): Promise<string>;
+    list(collection: string, options?: ListOptions): Promise<any>;
+    getHistory(_collection: string, _slug: string): Promise<HistoryEntry[]>;
+    getVersionContent(commitOid: string, collection: string, slug: string): Promise<any>;
+}
+
+/**
+ * Proxy guard: prevents using VibeEngine methods without a valid license.
+ * All function calls (except init) require `_licensed === true`, which is
+ * only set by `initVibeEngine()` after successful license validation.
+ */
+declare const VibeEngine: SyncEngine;
+/**
+ * Initialize the engine with license validation, then register collection schemas.
+ * Call this once at app startup (e.g. in EditProvider or AdminShell).
+ *
+ * @throws {Error} if the license key is missing, invalid, or expired
+ */
+declare function initVibeEngine(config: VibeEngineConfig & {
+    licenseKey?: string;
+}, collections?: Record<string, VibeCollection>, singletons?: Record<string, VibeCollection>): Promise<void>;
+declare function populate(document: any, refs: {
+    field: string;
+    collection: string;
+}[]): Promise<any>;
+
+export { type AuthProvider as A, BrowserEngine as B, DevEngine as D, NodeEngine as N, type VibeAccessRule as V, type WebhookConfig as W, type VibeBlockRegistration as a, type VibeCollection as b, type VibeConfig as c, VibeEngine as d, type VibeEvent as e, type VibeEventType as f, type VibeRole as g, type VibeUser as h, assertValidCollection as i, assertValidCommitOid as j, assertValidSlug as k, canEditCollection as l, defineConfig as m, getCollectionSchema as n, getCustomBlockComponent as o, initVibeEngine as p, populate as q, registerCollectionSchemas as r, registerCustomBlocks as s, resolveUserRole as t, sanitizeRedirectPath as u, validateCollection as v, validateCollectionData as w, validateCommitOid as x, validateSlug as y, vibeEvents as z };