@revealui/core 0.0.1-pre.4 → 0.2.1

package/dist/index.d.ts

@@ -1 +1,64 @@
-export * from "./exports/index.js";
+export { createRESTHandlers, handleRESTRequest } from './api/rest.js';
+export { anyone, authenticated } from './auth/access.js';
+export type { FloatingToolbarPluginProps, ImageNodeData, RichTextEditorProps, SerializedImageNode, ToolbarPluginProps, } from './client/index.js';
+export { $createImageNode, $isImageNode, AdminDashboard, APIError, APIErrorType, apiClient, CollectionList, clearAuthToken, DocumentForm, FloatingToolbarPlugin, generatePageMetadata, getAuthHeader, getAuthToken, ImageNode, ImageNodeComponent, ImagePlugin, ImageUploadButton, INSERT_IMAGE_COMMAND, NotFoundPage, OPEN_IMAGE_UPLOAD_COMMAND, RootLayout, RootPage, richTextEditorStyles, serializeConfig, setAuthToken, ToolbarPlugin, useRevealUI, withRevealUIAccess, } from './client/index.js';
+export { buildConfig } from './config/index.js';
+export { getRevealUI } from './config/runtime.js';
+export { deepMerge } from './config/utils.js';
+export type { UniversalPostgresAdapterConfig } from './database/universal-postgres.js';
+export { universalPostgresAdapter } from './database/universal-postgres.js';
+export { createRevealUI, createRevealUIAccessRule, createRevealUIBlock, createRevealUICollection, createRevealUIField, } from './factories/index.js';
+export { type FeatureFlags, getFeatures, getFeaturesForTier, getRequiredTier, isFeatureEnabled, } from './features.js';
+export { generateLicenseKey, getCurrentTier, getLicensePayload, getMaxSites, getMaxUsers, initializeLicense, isLicensed, type LicensePayload, type LicenseTier, resetLicenseState, validateLicenseKey, } from './license.js';
+export { getRevealUI as getRevealUINext, withRevealUI, } from './nextjs/index.js';
+export { formBuilderPlugin } from './plugins/form-builder.js';
+export { nestedDocsPlugin } from './plugins/nested-docs.js';
+export { redirectsPlugin } from './plugins/redirects.js';
+export { afterChangeTraverseFields, afterReadTraverseFields, beforeChangeTraverseFields, beforeValidateTraverseFields, buildWhereClause, checkDependencies, createRevealUIInstance, defaultLogger, extractWhereValues, flattenResult, getRelationshipFields, Logger, RevealUICollection, RevealUIGlobal, type RevealUILogger, type RichTextAdapter, relationshipPopulationPromise, validateRelationshipMetadata, withNullableJSONSchemaType, } from './revealui.js';
+export { BoldFeature, FixedToolbarFeature, HeadingFeature, ItalicFeature, LinkFeature, lexicalEditor, TreeViewFeature, UnderlineFeature, } from './richtext/index.js';
+export { vercelBlobStorage } from './storage/vercel-blob.js';
+export { LRUCache, type LRUCacheOptions } from './utils/cache.js';
+export { deepClone } from './utils/deep-clone.js';
+export { createApplicationErrorResponseData, createErrorResponseData, createSuccessResponseData, createValidationErrorResponseData, type ErrorResponseData, } from './utils/error-responses.js';
+export { ApplicationError, handleApiError, handleDatabaseError, ValidationError, } from './utils/errors.js';
+export { createLogger, type LogContext, type LogLevel, logger, } from './utils/logger.js';
+export { flattenFields, isJsonFieldType, isObject } from './utils/type-guards.js';
+export { type AccessArgs, type AccessFunction, type AccessResult, type AfterChangeHookArgs, type AfterReadHookArgs, applyPluginExtensions, assertValidSlug, type BeforeChangeHookArgs, type CollectionAccessConfig, type CollectionAfterChangeHook, type CollectionAfterReadHook, type CollectionBeforeChangeHook, type CollectionBeforeValidateHook, type CollectionConfig, type CollectionHooksConfig, type Config, ConfigValidationError, defineCollection, defineField, defineGlobal, type Field, type FieldAccessConfig, type FieldValidateArgs, fromCMSCollectionConfig, fromCMSGlobalConfig, type GlobalAccessConfig, type GlobalConfig, type GlobalHooksConfig, getCustomFieldType, getRevealUIExtensions, hasRevealUIExtensions, isValidFieldType, isValidSlug, mergeCollectionConfigs, mergeFields, registerCustomFieldType, registerPluginExtension, type SanitizedCollectionConfig, type SanitizedConfig, type SanitizedGlobalConfig, safeValidate, toCMSCollectionConfig, toCMSGlobalConfig, toSlug, validateWithErrors, type Where, } from '@revealui/contracts/cms';
+export type { Block, BlocksField, CheckboxField, DatabaseAdapter, DatabaseResult, FindArgs, JsonObject, OperationOptions, PaginatedDocs, Permission, Plugin, PluginOptions, PopulateType, RequestContext, RevealAfterChangeHook, RevealAfterReadHook, RevealBeforeChangeHook, RevealCollection, RevealCollectionConfig, RevealCollectionHooks, RevealConfig, RevealCreateOptions, RevealDataObject, RevealDeleteOptions, RevealDocument, RevealDocumentWithMeta, RevealFindOptions, RevealGlobal, RevealGlobalConfig, RevealHookContext, RevealOperator, RevealPaginatedResult, RevealRequest, RevealSelect, RevealSort, RevealUI, RevealUIAccessContext, RevealUIAccessResult, RevealUIAccessRule, RevealUICollectionConfig, RevealUIContext, RevealUIEnhancedField, RevealUIField, RevealUIFieldHook, RevealUIFieldType, RevealUIFieldValidator, RevealUIFilterResult, RevealUIFrameworkContext, RevealUIHookContext, RevealUIInstance, RevealUIPermission, RevealUITenant, RevealUIUser, RevealUIValidationRule, RevealUpdateOptions, RevealUser, RevealValue, RevealWhere, RichTextEditor, RichTextFeature, SelectType, StorageAdapter, TypeWithID, WhereClause, } from './types/index.js';
+export { serializeLexicalState } from './richtext/index.js';
+export type { Access, ArrayField, AuthConfig, ClientCollectionConfig, ClientConfig, CollectionAccess, CollectionAdminConfig, CollectionLabels, CustomComponent, CustomFieldTypeConfig, Document, EndpointHandler, EndpointHandlerArgs, FieldAccess, FieldAccessArgs, FieldAccessConfig as SchemaFieldAccessConfig, FieldAdminConfig, FieldHooksConfig, FieldOption, FieldType, GlobalAccess, GlobalAdminConfig, GlobalLabels, GlobalVersionsConfig, GroupField, PluginFieldExtension, RevealHandler, RevealUIAccessArgs, RevealUIBlock, RevealUIComponent, RevealUIDependencyCheckArgs, RevealUIExtensions, RevealUIRichTextAdapter, RevealUISchemaArgs, RevealUITraverseFieldsArgs, RevealUITraverseFieldsResult, SelectMode, TabDefinition, TextField, TypedFallbackLocale, UploadConfig, ValidationResult, VersionConfig, } from './types/index.js';
+/**
+ * ## Import Guide
+ *
+ * ### Base Types (from schema - single source of truth)
+ * For standard RevealUI CMS types that work everywhere:
+ * ```typescript
+ * import { CollectionConfig, GlobalConfig, Field } from '@revealui/core'
+ * // OR directly from schema:
+ * import { CollectionConfig, GlobalConfig, Field } from '@revealui/contracts/cms'
+ * ```
+ *
+ * ### Extended Types (RevealUI-specific)
+ * For RevealUI framework features (tenants, permissions, etc.):
+ * ```typescript
+ * import { RevealCollectionConfig, RevealGlobalConfig } from '@revealui/core'
+ * ```
+ *
+ * ### Helper Functions
+ * For typed config creation:
+ * ```typescript
+ * import { defineCollection, defineGlobal, defineField } from '@revealui/core'
+ *
+ * const Posts = defineCollection<Post>({
+ *   slug: 'posts',
+ *   fields: [...]
+ * })
+ * ```
+ *
+ * ### Validation
+ * For runtime config validation:
+ * ```typescript
+ * import { validateWithErrors, ConfigValidationError } from '@revealui/core'
+ * ```
+ */
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,33 +1,126 @@
-import { default as __internal } from "./__internal.js"
-import { default as abort } from "./abort.js"
-import { default as bin } from "./bin-entry.js"
-import { default as cli } from "./cli.js"
-import { default as client } from "./client.js"
-import { default as config } from "./config.js"
-import { default as helpers } from "./helpers.js"
-import { default as plugin } from "./plugin.js"
-import { default as prerender } from "./prerender.js"
-import { default as RenderErrorPage } from "./RenderErrorPage.js"
-import { default as router } from "./router.js"
-import { default as routing } from "./routing.js"
-import { default as server } from "./server.js"
-import { default as setup } from "./setup.js"
-import { default as types } from "./types.js"
-
-export {
-  __internal,
-  abort,
-  bin,
-  cli,
-  client,
-  config,
-  helpers,
-  plugin,
-  prerender,
-  RenderErrorPage,
-  router,
-  routing,
-  server,
-  setup,
-  types,
-}
+// Main RevealUI exports - re-export core (server) and client functionality
+// Export core (server-side) functionality - now directly in root after flattening
+// REST API
+export { createRESTHandlers, handleRESTRequest } from './api/rest.js';
+// Auth utilities
+export { anyone, authenticated } from './auth/access.js';
+// Export client (client-side) - but exclude RichTextEditor to avoid conflict with type
+// Consumers should import RichTextEditor component from '@revealui/core/richtext/client' directly
+export { $createImageNode, $isImageNode, 
+// Admin
+AdminDashboard, APIError, APIErrorType, 
+// Re-export admin utils
+apiClient, CollectionList, clearAuthToken, DocumentForm, FloatingToolbarPlugin, generatePageMetadata, getAuthHeader, getAuthToken, ImageNode, ImageNodeComponent, ImagePlugin, ImageUploadButton, INSERT_IMAGE_COMMAND, NotFoundPage, OPEN_IMAGE_UPLOAD_COMMAND, RootLayout, RootPage, 
+// Rich text (exclude RichTextEditor component - use richtext/client)
+richTextEditorStyles, serializeConfig, setAuthToken, 
+// UI
+ToolbarPlugin, 
+// Hooks
+useRevealUI, withRevealUIAccess, } from './client/index.js';
+// Configuration
+export { buildConfig } from './config/index.js';
+export { getRevealUI } from './config/runtime.js';
+export { deepMerge } from './config/utils.js';
+export { universalPostgresAdapter } from './database/universal-postgres.js';
+// Factory functions
+export { createRevealUI, createRevealUIAccessRule, createRevealUIBlock, createRevealUICollection, createRevealUIField, } from './factories/index.js';
+export { getFeatures, getFeaturesForTier, getRequiredTier, isFeatureEnabled, } from './features.js';
+// License and feature flags
+export { generateLicenseKey, getCurrentTier, getLicensePayload, getMaxSites, getMaxUsers, initializeLicense, isLicensed, resetLicenseState, validateLicenseKey, } from './license.js';
+// Next.js integration
+export { getRevealUI as getRevealUINext, withRevealUI, } from './nextjs/index.js';
+// Plugins
+export { formBuilderPlugin } from './plugins/form-builder.js';
+export { nestedDocsPlugin } from './plugins/nested-docs.js';
+export { redirectsPlugin } from './plugins/redirects.js';
+// Core RevealUI CMS implementation
+export { 
+// Field traversal utilities
+afterChangeTraverseFields, afterReadTraverseFields, beforeChangeTraverseFields, beforeValidateTraverseFields, 
+// Query utilities
+buildWhereClause, 
+// Utilities
+checkDependencies, 
+// Main factory function
+createRevealUIInstance, defaultLogger, extractWhereValues, flattenResult, 
+// Relationship utilities
+getRelationshipFields, 
+// Logger
+Logger, 
+// Collection and Global operations
+RevealUICollection, RevealUIGlobal, relationshipPopulationPromise, validateRelationshipMetadata, withNullableJSONSchemaType, } from './revealui.js';
+// Rich text editor
+export { BoldFeature, FixedToolbarFeature, HeadingFeature, ItalicFeature, LinkFeature, lexicalEditor, TreeViewFeature, UnderlineFeature, } from './richtext/index.js';
+// Storage adapters
+export { vercelBlobStorage } from './storage/vercel-blob.js';
+// Note: Logger class is exported from ./revealui.ts (instance/logger.js), not from utils/logger.js
+export { LRUCache } from './utils/cache.js';
+// Deep clone utility
+export { deepClone } from './utils/deep-clone.js';
+// Error response utilities (framework-agnostic)
+export { createApplicationErrorResponseData, createErrorResponseData, createSuccessResponseData, createValidationErrorResponseData, } from './utils/error-responses.js';
+export { ApplicationError, handleApiError, handleDatabaseError, ValidationError, } from './utils/errors.js';
+// Utilities
+export { createLogger, logger, } from './utils/logger.js';
+// Type guards
+export { flattenFields, isJsonFieldType, isObject } from './utils/type-guards.js';
+// =============================================================================
+// BASE TYPES FROM SCHEMA (Single Source of Truth)
+// =============================================================================
+// These are the authoritative types from @revealui/contracts/cms.
+// They are re-exported here for convenience.
+export { applyPluginExtensions, assertValidSlug, 
+// Validation utilities
+ConfigValidationError, 
+// Config helpers
+defineCollection, defineField, defineGlobal, 
+// Validation types
+// type FieldValidateFunction,
+fromCMSCollectionConfig, fromCMSGlobalConfig, getCustomFieldType, getRevealUIExtensions, 
+// RevealUI extensions
+hasRevealUIExtensions, isValidFieldType, isValidSlug, mergeCollectionConfigs, mergeFields, 
+// Extensibility
+registerCustomFieldType, registerPluginExtension, safeValidate, 
+// CMS compatibility
+toCMSCollectionConfig, toCMSGlobalConfig, toSlug, validateWithErrors, } from '@revealui/contracts/cms';
+// =============================================================================
+// ADDITIONAL TYPE EXPORTS
+// =============================================================================
+export { serializeLexicalState } from './richtext/index.js';
+// =============================================================================
+// TYPE DOCUMENTATION
+// =============================================================================
+/**
+ * ## Import Guide
+ *
+ * ### Base Types (from schema - single source of truth)
+ * For standard RevealUI CMS types that work everywhere:
+ * ```typescript
+ * import { CollectionConfig, GlobalConfig, Field } from '@revealui/core'
+ * // OR directly from schema:
+ * import { CollectionConfig, GlobalConfig, Field } from '@revealui/contracts/cms'
+ * ```
+ *
+ * ### Extended Types (RevealUI-specific)
+ * For RevealUI framework features (tenants, permissions, etc.):
+ * ```typescript
+ * import { RevealCollectionConfig, RevealGlobalConfig } from '@revealui/core'
+ * ```
+ *
+ * ### Helper Functions
+ * For typed config creation:
+ * ```typescript
+ * import { defineCollection, defineGlobal, defineField } from '@revealui/core'
+ *
+ * const Posts = defineCollection<Post>({
+ *   slug: 'posts',
+ *   fields: [...]
+ * })
+ * ```
+ *
+ * ### Validation
+ * For runtime config validation:
+ * ```typescript
+ * import { validateWithErrors, ConfigValidationError } from '@revealui/core'
+ * ```
+ */

package/dist/instance/RevealUIInstance.d.ts

@@ -0,0 +1,6 @@
+import type { RevealConfig, RevealUIInstance } from '../types/index.js';
+/**
+ * Creates a new RevealUI instance with collections, globals, and database connections
+ */
+export declare function createRevealUIInstance(config: RevealConfig): Promise<RevealUIInstance>;
+//# sourceMappingURL=RevealUIInstance.d.ts.map

package/dist/instance/RevealUIInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RevealUIInstance.d.ts","sourceRoot":"","sources":["../../src/instance/RevealUIInstance.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,YAAY,EAQZ,gBAAgB,EAGjB,MAAM,mBAAmB,CAAA;AAS1B;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgZ5F"}

package/dist/instance/RevealUIInstance.js

@@ -0,0 +1,306 @@
+import { randomBytes } from 'node:crypto';
+import bcrypt from 'bcryptjs';
+import { SignJWT } from 'jose';
+import { RevealUICollection } from '../collections/CollectionOperations.js';
+import { getDataLoader } from '../dataloader.js';
+import { afterRead } from '../fields/hooks/afterRead/index.js';
+import { RevealUIGlobal } from '../globals/GlobalOperations.js';
+import { isJsonFieldType } from '../utils/type-guards.js';
+import { createLogger } from './logger.js';
+import { create } from './methods/create.js';
+import { deleteMethod } from './methods/delete.js';
+import { find } from './methods/find.js';
+import { findByID } from './methods/findById.js';
+import { update } from './methods/update.js';
+/**
+ * Creates a new RevealUI instance with collections, globals, and database connections
+ */
+export async function createRevealUIInstance(config) {
+    const logger = createLogger();
+    // Database connection is lazy — only connect on first query.
+    // A single shared promise guards against concurrent init from multiple requests.
+    let dbConnected = false;
+    let dbInitPromise = null;
+    const ensureDbConnected = async () => {
+        if (dbConnected)
+            return;
+        if (!dbInitPromise && config.db) {
+            const db = config.db; // capture to satisfy narrowing inside async IIFE
+            dbInitPromise = (async () => {
+                await db.init?.();
+                // Queue table creation BEFORE connect()
+                // createTable() pushes promises to a queue that connect() will await
+                if (config.collections && db.createTable) {
+                    for (const collection of config.collections) {
+                        const fields = collection.fields || [];
+                        const tableFields = fields
+                            .filter((field) => field.name && !isJsonFieldType(field))
+                            .map((field) => ({
+                            name: field.name || '',
+                            type: field.type || 'text',
+                            required: field.required,
+                            unique: field.unique,
+                        }));
+                        db.createTable(collection.slug, tableFields);
+                    }
+                }
+                // Queue global table creation BEFORE connect()
+                if (config.globals && db.createGlobalTable) {
+                    for (const global of config.globals) {
+                        const fields = global.fields || [];
+                        const jsonTypes = ['array', 'group', 'blocks', 'richText'];
+                        const tableFields = fields
+                            .filter((field) => field.name && !jsonTypes.includes(field.type || ''))
+                            .map((field) => ({
+                            name: field.name || '',
+                            type: field.type || 'text',
+                            required: field.required,
+                            unique: field.unique,
+                        }));
+                        db.createGlobalTable(global.slug, tableFields);
+                    }
+                }
+                // Now connect() will wait for all queued table creation promises
+                await db.connect?.();
+                dbConnected = true;
+            })();
+        }
+        if (dbInitPromise) {
+            await dbInitPromise;
+        }
+    };
+    // Initialize collections and globals
+    const collections = {};
+    const globals = {};
+    // Initialize collections
+    if (config.collections) {
+        for (const collectionConfig of config.collections) {
+            collections[collectionConfig.slug] = new RevealUICollection(collectionConfig, config.db || null);
+        }
+    }
+    // Initialize globals
+    if (config.globals) {
+        for (const globalConfig of config.globals) {
+            globals[globalConfig.slug] = new RevealUIGlobal(globalConfig, config.db || null);
+        }
+    }
+    // Create a base request for DataLoader initialization
+    const baseReq = {
+        transactionID: null,
+        context: {},
+    };
+    const revealUIInstance = {
+        collections,
+        globals,
+        config,
+        db: config.db || null,
+        logger,
+        secret: config.secret || undefined,
+        async find(options) {
+            return find(revealUIInstance, ensureDbConnected, options);
+        },
+        async findByID(options) {
+            return findByID(revealUIInstance, ensureDbConnected, options);
+        },
+        async create(options) {
+            return create(revealUIInstance, ensureDbConnected, options);
+        },
+        async update(options) {
+            return update(revealUIInstance, ensureDbConnected, options);
+        },
+        async delete(options) {
+            return deleteMethod(revealUIInstance, ensureDbConnected, options);
+        },
+        async login(options) {
+            const { collection, data } = options;
+            if (!collections[collection]) {
+                throw new Error(`Collection '${collection}' not found`);
+            }
+            // Find user by email
+            const users = await collections[collection].find({
+                where: { email: { equals: data.email } },
+                limit: 1,
+            });
+            const user = users.docs[0];
+            if (!user) {
+                throw new Error('Invalid credentials');
+            }
+            // Verify password
+            const hashedPassword = user.password;
+            if (!hashedPassword || typeof hashedPassword !== 'string') {
+                throw new Error('Invalid credentials');
+            }
+            // Verify password against bcrypt hash
+            if (!hashedPassword.startsWith('$2')) {
+                // Reject plain-text passwords — they must be migrated first
+                throw new Error('Invalid credentials');
+            }
+            const isPasswordValid = await bcrypt.compare(data.password, hashedPassword);
+            if (!isPasswordValid) {
+                throw new Error('Invalid credentials');
+            }
+            // Generate JWT token with unique jti (JWT ID) for session fixation prevention
+            const secret = process.env.REVEALUI_SECRET;
+            if (!secret || secret.length < 32) {
+                throw new Error('REVEALUI_SECRET must be set to a secure random value (minimum 32 characters). ' +
+                    'Generate one with: openssl rand -base64 32');
+            }
+            const secretKey = new TextEncoder().encode(secret);
+            const token = await new SignJWT({
+                id: user.id,
+                email: user.email,
+                collection,
+            })
+                .setProtectedHeader({ alg: 'HS256' })
+                .setIssuedAt()
+                .setExpirationTime('7d')
+                .setJti(`${user.id}-${Date.now()}-${randomBytes(8).toString('hex')}`)
+                .sign(secretKey);
+            // Remove password from user object before returning
+            const userWithoutPassword = { ...user, password: undefined };
+            return { user: userWithoutPassword, token };
+        },
+        async findGlobal(options) {
+            await ensureDbConnected();
+            const { slug, depth = 0, draft = false, locale, fallbackLocale, overrideAccess = false, showHiddenFields = false, populate, req, } = options;
+            // Find global config
+            const globalConfig = config.globals?.find((g) => g.slug === slug);
+            if (!globalConfig) {
+                throw new Error(`Global '${slug}' not found`);
+            }
+            // Get or use existing global instance
+            if (!globals[slug]) {
+                throw new Error(`Global '${slug}' instance not initialized`);
+            }
+            // Use the global's find method to get the document
+            const doc = await globals[slug].find({ depth: 0 }); // Get base document first
+            if (!doc) {
+                return null;
+            }
+            // Apply afterRead hook for relationship population if depth > 0 and req provided
+            if (req && depth > 0) {
+                // RevealGlobalConfig extends GlobalConfig, which matches SanitizedGlobalConfig structure
+                const sanitizedConfig = {
+                    ...globalConfig,
+                    fields: globalConfig.fields,
+                    flattenedFields: globalConfig.fields,
+                    endpoints: globalConfig.endpoints === false ? undefined : globalConfig.endpoints,
+                };
+                return await afterRead({
+                    collection: null,
+                    global: sanitizedConfig,
+                    context: req.context || {},
+                    currentDepth: 1,
+                    depth,
+                    doc,
+                    draft,
+                    fallbackLocale: fallbackLocale || req.fallbackLocale || 'en',
+                    findMany: false,
+                    flattenLocales: true,
+                    locale: locale || req.locale || 'en',
+                    overrideAccess,
+                    populate,
+                    req,
+                    select: undefined,
+                    showHiddenFields,
+                });
+            }
+            return doc;
+        },
+        async updateGlobal(options) {
+            await ensureDbConnected();
+            const { slug } = options;
+            if (!globals[slug]) {
+                throw new Error(`Global '${slug}' not found`);
+            }
+            return globals[slug].update(options);
+        },
+        /**
+         * Manually populate relationships on documents
+         *
+         * Useful for:
+         * - Manual population after queries
+         * - AI context generation with relationships
+         * - Selective field population
+         * - Batch population for performance
+         *
+         * @example
+         * ```typescript
+         * // Populate single document
+         * const post = await revealui.findByID({ collection: 'posts', id: '123' })
+         * const populated = await revealui.populate('posts', post, { depth: 2 })
+         *
+         * // Populate multiple documents
+         * const posts = await revealui.find({ collection: 'posts' })
+         * const populated = await revealui.populate('posts', posts.docs, { depth: 1 })
+         * ```
+         */
+        async populate(collection, docs, options) {
+            await ensureDbConnected();
+            const { depth = 1, draft = false, locale = 'en', fallbackLocale = 'en', overrideAccess = false, showHiddenFields = false, req, } = options || {};
+            // Get collection config
+            const collectionConfig = config.collections?.find((c) => c.slug === collection);
+            if (!collectionConfig) {
+                throw new Error(`Collection '${collection}' not found`);
+            }
+            // Create a request context if not provided
+            const populateReq = req || {
+                ...baseReq,
+                locale,
+                fallbackLocale,
+                revealui: revealUIInstance,
+                dataLoader: getDataLoader(baseReq),
+            };
+            // Handle single document
+            if (!Array.isArray(docs)) {
+                return await afterRead({
+                    collection: collectionConfig,
+                    context: populateReq.context || {},
+                    currentDepth: 0,
+                    depth,
+                    doc: docs,
+                    draft,
+                    fallbackLocale,
+                    findMany: false,
+                    flattenLocales: true,
+                    global: null,
+                    locale,
+                    overrideAccess,
+                    populate: undefined,
+                    req: populateReq,
+                    select: undefined,
+                    showHiddenFields,
+                });
+            }
+            // Handle array of documents
+            return await Promise.all(docs.map(async (doc) => afterRead({
+                collection: collectionConfig,
+                context: populateReq.context || {},
+                currentDepth: 0,
+                depth,
+                doc,
+                draft,
+                fallbackLocale,
+                findMany: false,
+                flattenLocales: true,
+                global: null,
+                locale,
+                overrideAccess,
+                populate: undefined,
+                req: populateReq,
+                select: undefined,
+                showHiddenFields,
+            })));
+        },
+    };
+    // Run onInit hook if provided (skip during build to avoid database connections)
+    const isBuildTime = process.env.NEXT_PHASE === 'phase-production-build' ||
+        (process.env.NODE_ENV === 'production' && !process.env.RUNTIME_INIT);
+    if (config.onInit && !isBuildTime) {
+        await config.onInit(revealUIInstance);
+    }
+    // Initialize DataLoader for the base request
+    baseReq.revealui = revealUIInstance;
+    baseReq.dataLoader = getDataLoader(baseReq);
+    return revealUIInstance;
+}

package/dist/instance/index.d.ts

@@ -0,0 +1,3 @@
+export { createLogger, defaultLogger, Logger, type RevealUILogger, } from './logger.js';
+export { createRevealUIInstance } from './RevealUIInstance.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/instance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/instance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,MAAM,EACN,KAAK,cAAc,GACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/instance/index.js

@@ -0,0 +1,2 @@
+export { createLogger, defaultLogger, Logger, } from './logger.js';
+export { createRevealUIInstance } from './RevealUIInstance.js';

package/dist/instance/logger.d.ts

@@ -0,0 +1,31 @@
+/**
+ * RevealUI Logger
+ *
+ * Production-safe logging utility for RevealUI framework operations.
+ * Info/warn messages are no-ops in production to avoid console pollution.
+ */
+export interface RevealUILogger {
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    debug: (...args: unknown[]) => void;
+}
+/**
+ * Production-safe logger implementation
+ * Info/warn messages are completely silenced in production
+ */
+export declare class Logger implements RevealUILogger {
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+}
+/**
+ * Creates a new logger instance
+ */
+export declare function createLogger(): RevealUILogger;
+/**
+ * Default logger instance
+ */
+export declare const defaultLogger: RevealUILogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/instance/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/instance/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CACpC;AAED;;;GAGG;AACH,qBAAa,MAAO,YAAW,cAAc;IAC3C,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAO9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAO9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAKhC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,cAAc,CAE7C;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,cAA6B,CAAA"}

package/dist/instance/logger.js

@@ -0,0 +1,42 @@
+/**
+ * RevealUI Logger
+ *
+ * Production-safe logging utility for RevealUI framework operations.
+ * Info/warn messages are no-ops in production to avoid console pollution.
+ */
+/**
+ * Production-safe logger implementation
+ * Info/warn messages are completely silenced in production
+ */
+export class Logger {
+    info(...args) {
+        // Info messages are never logged in production
+        if (process.env.NODE_ENV !== 'production') {
+            console.log('[RevealUI]', ...args);
+        }
+    }
+    warn(...args) {
+        // Warning messages are never logged in production
+        if (process.env.NODE_ENV !== 'production') {
+            console.warn('[RevealUI]', ...args);
+        }
+    }
+    error(...args) {
+        console.error('[RevealUI]', ...args);
+    }
+    debug(...args) {
+        if (process.env.NODE_ENV !== 'production') {
+            console.debug('[RevealUI]', ...args);
+        }
+    }
+}
+/**
+ * Creates a new logger instance
+ */
+export function createLogger() {
+    return new Logger();
+}
+/**
+ * Default logger instance
+ */
+export const defaultLogger = new Logger();