@revealui/core 0.0.1-pre.3 → 0.2.0

package/dist/utils/logger-client.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Client-Safe Logger
+ *
+ * Production-safe logging utility that works in both client and server contexts.
+ * Does not depend on Node.js APIs (no async_hooks, no crypto).
+ * Info/warn messages are no-ops in production to avoid console pollution.
+ *
+ * NOTE: No 'use client' directive here. This is a plain utility module, not a
+ * React component. Adding 'use client' causes Next.js to create a reference
+ * proxy when imported from server code (API routes), stripping all methods.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogContext {
+    [key: string]: unknown;
+}
+export interface Logger {
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, context?: LogContext): void;
+}
+/**
+ * Create a client-safe logger instance
+ *
+ * @returns Logger instance safe for client-side use
+ */
+export declare function createLogger(): Logger;
+/**
+ * Default client-safe logger instance
+ */
+export declare const logger: Logger;
+//# sourceMappingURL=logger-client.d.ts.map

package/dist/utils/logger-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-client.d.ts","sourceRoot":"","sources":["../../src/utils/logger-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAClD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IACjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;CACnD;AAyCD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAiB,CAAA"}

package/dist/utils/logger-client.js

@@ -0,0 +1,55 @@
+/**
+ * Client-Safe Logger
+ *
+ * Production-safe logging utility that works in both client and server contexts.
+ * Does not depend on Node.js APIs (no async_hooks, no crypto).
+ * Info/warn messages are no-ops in production to avoid console pollution.
+ *
+ * NOTE: No 'use client' directive here. This is a plain utility module, not a
+ * React component. Adding 'use client' causes Next.js to create a reference
+ * proxy when imported from server code (API routes), stripping all methods.
+ */
+/**
+ * Client-safe logger implementation
+ * Simple console-based logging without Node.js dependencies
+ */
+class ClientLogger {
+    formatMessage(level, message, context) {
+        const timestamp = new Date().toISOString();
+        const prefix = `[${timestamp}] [RevealUI] [${level.toUpperCase()}]`;
+        if (context && Object.keys(context).length > 0) {
+            return `${prefix} ${message} ${JSON.stringify(context)}`;
+        }
+        return `${prefix} ${message}`;
+    }
+    debug(message, context) {
+        if (process.env.NODE_ENV !== 'production') {
+            console.debug(this.formatMessage('debug', message, context));
+        }
+    }
+    info(message, context) {
+        if (process.env.NODE_ENV !== 'production') {
+            console.info(this.formatMessage('info', message, context));
+        }
+    }
+    warn(message, context) {
+        if (process.env.NODE_ENV !== 'production') {
+            console.warn(this.formatMessage('warn', message, context));
+        }
+    }
+    error(message, context) {
+        console.error(this.formatMessage('error', message, context));
+    }
+}
+/**
+ * Create a client-safe logger instance
+ *
+ * @returns Logger instance safe for client-side use
+ */
+export function createLogger() {
+    return new ClientLogger();
+}
+/**
+ * Default client-safe logger instance
+ */
+export const logger = createLogger();

package/dist/utils/logger-server.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Server Logger Utility
+ *
+ * Server-side logging utility for RevealUI framework.
+ * Supports different log levels and structured output.
+ * Automatically includes request ID from request context when available.
+ *
+ * WARNING: This module uses Node.js APIs (async_hooks via request-context).
+ * For client-safe logging, use './logger-client.js' instead.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogContext {
+    [key: string]: unknown;
+}
+export interface Logger {
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, context?: LogContext): void;
+}
+/**
+ * Create a logger instance
+ *
+ * @param minLevel - Minimum log level to output (default: 'info')
+ * @returns Logger instance
+ */
+export declare function createLogger(minLevel?: LogLevel): Logger;
+/**
+ * Default logger instance
+ */
+export declare const logger: Logger;
+//# sourceMappingURL=logger-server.d.ts.map

package/dist/utils/logger-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-server.d.ts","sourceRoot":"","sources":["../../src/utils/logger-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAClD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IACjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;CACnD;AAsDD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAKxD;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAiB,CAAA"}

package/dist/utils/logger-server.js

@@ -0,0 +1,68 @@
+/**
+ * Server Logger Utility
+ *
+ * Server-side logging utility for RevealUI framework.
+ * Supports different log levels and structured output.
+ * Automatically includes request ID from request context when available.
+ *
+ * WARNING: This module uses Node.js APIs (async_hooks via request-context).
+ * For client-safe logging, use './logger-client.js' instead.
+ */
+import { getRequestId } from './request-context.js';
+class ConsoleLogger {
+    minLevel;
+    constructor(minLevel = 'info') {
+        this.minLevel = minLevel;
+    }
+    shouldLog(level) {
+        const levels = ['debug', 'info', 'warn', 'error'];
+        return levels.indexOf(level) >= levels.indexOf(this.minLevel);
+    }
+    formatMessage(level, message, context) {
+        const timestamp = new Date().toISOString();
+        const prefix = `[${timestamp}] [${level.toUpperCase()}]`;
+        // Automatically include request ID if available
+        const requestId = getRequestId();
+        const enrichedContext = requestId ? { requestId, ...context } : context;
+        if (enrichedContext && Object.keys(enrichedContext).length > 0) {
+            return `${prefix} ${message} ${JSON.stringify(enrichedContext)}`;
+        }
+        return `${prefix} ${message}`;
+    }
+    debug(message, context) {
+        if (process.env.NODE_ENV !== 'production') {
+            console.debug(this.formatMessage('debug', message, context));
+        }
+    }
+    info(message, context) {
+        if (process.env.NODE_ENV !== 'production') {
+            console.info(this.formatMessage('info', message, context));
+        }
+    }
+    warn(message, context) {
+        if (process.env.NODE_ENV !== 'production') {
+            console.warn(this.formatMessage('warn', message, context));
+        }
+    }
+    error(message, context) {
+        if (this.shouldLog('error')) {
+            console.error(this.formatMessage('error', message, context));
+        }
+    }
+}
+/**
+ * Create a logger instance
+ *
+ * @param minLevel - Minimum log level to output (default: 'info')
+ * @returns Logger instance
+ */
+export function createLogger(minLevel) {
+    // In production, can be extended to use structured logging services
+    // For now, use console-based logger
+    const level = minLevel || process.env.LOG_LEVEL || 'info';
+    return new ConsoleLogger(level);
+}
+/**
+ * Default logger instance
+ */
+export const logger = createLogger();

package/dist/utils/logger.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Logger Utility - Default Export
+ *
+ * Re-exports the client-safe logger implementation.
+ * This ensures that default imports get the client-safe version
+ * without Node.js dependencies (no async_hooks, no crypto).
+ *
+ * For server-side logging with request context:
+ *   import { logger } from '@revealui/core/server'
+ *   import { logger } from '@revealui/core/utils/logger/server'
+ */
+export type { LogContext, Logger, LogLevel } from './logger-client.js';
+export { createLogger, logger } from './logger-client.js';
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/utils/logger.js

@@ -0,0 +1,12 @@
+/**
+ * Logger Utility - Default Export
+ *
+ * Re-exports the client-safe logger implementation.
+ * This ensures that default imports get the client-safe version
+ * without Node.js dependencies (no async_hooks, no crypto).
+ *
+ * For server-side logging with request context:
+ *   import { logger } from '@revealui/core/server'
+ *   import { logger } from '@revealui/core/utils/logger/server'
+ */
+export { createLogger, logger } from './logger-client.js';

package/dist/utils/request-context.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Request Context Management
+ *
+ * Provides request ID generation and context propagation for distributed tracing.
+ * Request IDs enable tracking a single request across multiple services and logs.
+ *
+ * WARNING: This module uses Node.js-specific APIs (async_hooks, crypto).
+ * Do NOT import in client-side code or edge runtime.
+ */
+/**
+ * Request context data stored in AsyncLocalStorage
+ */
+export interface RequestContext {
+    /** Unique request identifier */
+    requestId: string;
+    /** Request start timestamp */
+    startTime: number;
+    /** User ID (if authenticated) */
+    userId?: string;
+    /** IP address */
+    ip?: string;
+    /** User agent */
+    userAgent?: string;
+    /** Request path */
+    path?: string;
+    /** Request method */
+    method?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Generate a new request ID
+ * Uses UUID v4 for guaranteed uniqueness
+ */
+export declare function generateRequestId(): string;
+/**
+ * Get the current request context
+ * Returns undefined if not in a request context
+ */
+export declare function getRequestContext(): RequestContext | undefined;
+/**
+ * Get the current request ID
+ * Returns undefined if not in a request context
+ */
+export declare function getRequestId(): string | undefined;
+/**
+ * Run a function within a request context
+ *
+ * @param context - Request context data
+ * @param fn - Function to run within the context
+ * @returns Result of the function
+ *
+ * @example
+ * ```typescript
+ * await runInRequestContext(
+ *   {
+ *     requestId: generateRequestId(),
+ *     startTime: Date.now(),
+ *     userId: 'user-123',
+ *     path: '/api/users',
+ *     method: 'GET',
+ *   },
+ *   async () => {
+ *     // All code here has access to request context
+ *     const requestId = getRequestId()
+ *     logger.info('Processing request', { requestId })
+ *   }
+ * )
+ * ```
+ */
+export declare function runInRequestContext<T>(context: RequestContext, fn: () => T): T;
+/**
+ * Update the current request context with additional data
+ *
+ * @param updates - Partial context updates to merge
+ *
+ * @example
+ * ```typescript
+ * updateRequestContext({ userId: 'user-123' })
+ * ```
+ */
+export declare function updateRequestContext(updates: Partial<RequestContext>): void;
+/**
+ * Extract request ID from various header formats
+ *
+ * Checks multiple common header names:
+ * - x-request-id (standard)
+ * - x-correlation-id (correlation pattern)
+ * - x-trace-id (OpenTelemetry)
+ * - request-id (simple)
+ *
+ * @param headers - Request headers (any format)
+ * @returns Request ID or undefined
+ */
+export declare function extractRequestId(headers: Record<string, string | string[] | undefined>): string | undefined;
+/**
+ * Create request context from HTTP request
+ *
+ * @param options - Request information
+ * @returns Request context
+ *
+ * @example
+ * ```typescript
+ * const context = createRequestContext({
+ *   headers: request.headers,
+ *   path: request.url,
+ *   method: request.method,
+ *   ip: request.ip,
+ * })
+ * ```
+ */
+export declare function createRequestContext(options: {
+    headers?: Record<string, string | string[] | undefined>;
+    path?: string;
+    method?: string;
+    ip?: string;
+    userId?: string;
+}): RequestContext;
+/**
+ * Get request duration in milliseconds
+ *
+ * @returns Duration in ms, or undefined if not in request context
+ */
+export declare function getRequestDuration(): number | undefined;
+/**
+ * Request context headers for propagating across services
+ *
+ * Use these when making HTTP requests to other services to maintain trace continuity
+ *
+ * @returns Headers object with request ID
+ *
+ * @example
+ * ```typescript
+ * const response = await fetch('https://api.example.com/users', {
+ *   headers: {
+ *     ...getRequestHeaders(),
+ *     'Authorization': 'Bearer token',
+ *   }
+ * })
+ * ```
+ */
+export declare function getRequestHeaders(): Record<string, string>;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/utils/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/utils/request-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IAEjB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAA;IAEjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,iBAAiB;IACjB,EAAE,CAAC,EAAE,MAAM,CAAA;IAEX,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAQD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAEjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAK3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,GAAG,SAAS,CAWpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,GAAG,cAAc,CAajB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAKvD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO1D"}

package/dist/utils/request-context.js

@@ -0,0 +1,168 @@
+/**
+ * Request Context Management
+ *
+ * Provides request ID generation and context propagation for distributed tracing.
+ * Request IDs enable tracking a single request across multiple services and logs.
+ *
+ * WARNING: This module uses Node.js-specific APIs (async_hooks, crypto).
+ * Do NOT import in client-side code or edge runtime.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { randomUUID } from 'node:crypto';
+/**
+ * AsyncLocalStorage for request context
+ * Provides request-scoped storage without passing context through every function
+ */
+const requestContextStorage = new AsyncLocalStorage();
+/**
+ * Generate a new request ID
+ * Uses UUID v4 for guaranteed uniqueness
+ */
+export function generateRequestId() {
+    return randomUUID();
+}
+/**
+ * Get the current request context
+ * Returns undefined if not in a request context
+ */
+export function getRequestContext() {
+    return requestContextStorage.getStore();
+}
+/**
+ * Get the current request ID
+ * Returns undefined if not in a request context
+ */
+export function getRequestId() {
+    return getRequestContext()?.requestId;
+}
+/**
+ * Run a function within a request context
+ *
+ * @param context - Request context data
+ * @param fn - Function to run within the context
+ * @returns Result of the function
+ *
+ * @example
+ * ```typescript
+ * await runInRequestContext(
+ *   {
+ *     requestId: generateRequestId(),
+ *     startTime: Date.now(),
+ *     userId: 'user-123',
+ *     path: '/api/users',
+ *     method: 'GET',
+ *   },
+ *   async () => {
+ *     // All code here has access to request context
+ *     const requestId = getRequestId()
+ *     logger.info('Processing request', { requestId })
+ *   }
+ * )
+ * ```
+ */
+export function runInRequestContext(context, fn) {
+    return requestContextStorage.run(context, fn);
+}
+/**
+ * Update the current request context with additional data
+ *
+ * @param updates - Partial context updates to merge
+ *
+ * @example
+ * ```typescript
+ * updateRequestContext({ userId: 'user-123' })
+ * ```
+ */
+export function updateRequestContext(updates) {
+    const current = getRequestContext();
+    if (current) {
+        Object.assign(current, updates);
+    }
+}
+/**
+ * Extract request ID from various header formats
+ *
+ * Checks multiple common header names:
+ * - x-request-id (standard)
+ * - x-correlation-id (correlation pattern)
+ * - x-trace-id (OpenTelemetry)
+ * - request-id (simple)
+ *
+ * @param headers - Request headers (any format)
+ * @returns Request ID or undefined
+ */
+export function extractRequestId(headers) {
+    const headerNames = ['x-request-id', 'x-correlation-id', 'x-trace-id', 'request-id'];
+    for (const name of headerNames) {
+        const value = headers[name];
+        if (value) {
+            return Array.isArray(value) ? value[0] : value;
+        }
+    }
+    return undefined;
+}
+/**
+ * Create request context from HTTP request
+ *
+ * @param options - Request information
+ * @returns Request context
+ *
+ * @example
+ * ```typescript
+ * const context = createRequestContext({
+ *   headers: request.headers,
+ *   path: request.url,
+ *   method: request.method,
+ *   ip: request.ip,
+ * })
+ * ```
+ */
+export function createRequestContext(options) {
+    // Try to extract existing request ID from headers, or generate new one
+    const requestId = options.headers ? extractRequestId(options.headers) : undefined;
+    return {
+        requestId: requestId || generateRequestId(),
+        startTime: Date.now(),
+        path: options.path,
+        method: options.method,
+        ip: options.ip,
+        userId: options.userId,
+        userAgent: options.headers?.['user-agent'],
+    };
+}
+/**
+ * Get request duration in milliseconds
+ *
+ * @returns Duration in ms, or undefined if not in request context
+ */
+export function getRequestDuration() {
+    const context = getRequestContext();
+    if (!context)
+        return undefined;
+    return Date.now() - context.startTime;
+}
+/**
+ * Request context headers for propagating across services
+ *
+ * Use these when making HTTP requests to other services to maintain trace continuity
+ *
+ * @returns Headers object with request ID
+ *
+ * @example
+ * ```typescript
+ * const response = await fetch('https://api.example.com/users', {
+ *   headers: {
+ *     ...getRequestHeaders(),
+ *     'Authorization': 'Bearer token',
+ *   }
+ * })
+ * ```
+ */
+export function getRequestHeaders() {
+    const requestId = getRequestId();
+    if (!requestId)
+        return {};
+    return {
+        'x-request-id': requestId,
+    };
+}

package/dist/utils/request-headers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Request Header Utilities
+ *
+ * Utilities for extracting headers from RevealRequest objects.
+ * Handles various header types (Headers, Map, plain object).
+ */
+import type { RevealRequest } from '../types/index.js';
+/**
+ * Extract authorization header from request
+ *
+ * @param req - RevealRequest object
+ * @returns Authorization header value or null if not found
+ */
+export declare function extractAuthHeader(req?: RevealRequest): string | null;
+//# sourceMappingURL=request-headers.d.ts.map

package/dist/utils/request-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-headers.d.ts","sourceRoot":"","sources":["../../src/utils/request-headers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEtD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAqBpE"}

package/dist/utils/request-headers.js

@@ -0,0 +1,31 @@
+/**
+ * Request Header Utilities
+ *
+ * Utilities for extracting headers from RevealRequest objects.
+ * Handles various header types (Headers, Map, plain object).
+ */
+/**
+ * Extract authorization header from request
+ *
+ * @param req - RevealRequest object
+ * @returns Authorization header value or null if not found
+ */
+export function extractAuthHeader(req) {
+    if (!req?.headers) {
+        return null;
+    }
+    let authHeader;
+    // Handle Headers object
+    if (req.headers instanceof Headers) {
+        authHeader = req.headers.get('authorization') || undefined;
+    }
+    // Handle Map object (used in tests) - type cast to avoid TS error
+    else if (req.headers instanceof Map) {
+        authHeader = req.headers.get('authorization') || undefined;
+    }
+    // Handle plain object with authorization property
+    else if (typeof req.headers === 'object' && 'authorization' in req.headers) {
+        authHeader = req.headers.authorization;
+    }
+    return authHeader || null;
+}

package/dist/utils/stripUnselectedFields.d.ts

@@ -0,0 +1,10 @@
+import type { Field, SelectType } from '../types/index.js';
+/**
+ * Strips unselected fields from a document based on select configuration
+ */
+export declare const stripUnselectedFields: ({ field, select, siblingDoc, }: {
+    field: Field;
+    select: SelectType;
+    siblingDoc: Record<string, unknown>;
+}) => void;
+//# sourceMappingURL=stripUnselectedFields.d.ts.map

package/dist/utils/stripUnselectedFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripUnselectedFields.d.ts","sourceRoot":"","sources":["../../src/utils/stripUnselectedFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE1D;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,gCAInC;IACD,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC,KAAG,IAgBH,CAAA"}

package/dist/utils/stripUnselectedFields.js

@@ -0,0 +1,20 @@
+/**
+ * Strips unselected fields from a document based on select configuration
+ */
+export const stripUnselectedFields = ({ field, select, siblingDoc, }) => {
+    if (!select || typeof select !== 'object')
+        return;
+    const fieldName = field.name || '';
+    if (!fieldName)
+        return;
+    const fieldValue = siblingDoc[fieldName];
+    // Only process if field value is an object (not primitive types)
+    if (fieldValue && typeof fieldValue === 'object' && !Array.isArray(fieldValue)) {
+        const fieldValueRecord = fieldValue;
+        for (const key of Object.keys(fieldValueRecord)) {
+            if (!(key in select)) {
+                Reflect.deleteProperty(fieldValueRecord, key);
+            }
+        }
+    }
+};

package/dist/utils/type-guards.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Type Guard Utilities
+ *
+ * Utilities for checking field types and JSON field detection.
+ * The Field interface already includes hasMany, so simple checks are sufficient.
+ */
+import type { Field } from '@revealui/contracts/cms';
+import type { RevealUIField } from '../types/extensions.js';
+/**
+ * Check if a field should be stored as JSON
+ *
+ * JSON fields include:
+ * - Complex types (array, group, blocks, richText)
+ * - Select fields with hasMany
+ * - Relationship fields with hasMany (stored as JSON array)
+ *
+ * Note: Field extends FieldStructure which has 'type' and 'hasMany' properties.
+ */
+export declare function isJsonFieldType(field: RevealUIField | Field): boolean;
+/**
+ * Flatten all named fields from a fields array, recursing into tabs and row containers.
+ * This ensures nested fields (e.g. inside a `tabs` field) are included when building
+ * the JSON field name set for INSERT/UPDATE queries.
+ */
+export declare function flattenFields(fields: (RevealUIField | Field)[]): (RevealUIField | Field)[];
+/**
+ * Type guard to check if a value is a plain object (not null, array, or Date)
+ *
+ * @param item - Value to check
+ * @returns True if value is a plain object
+ */
+export declare function isObject(item: unknown): item is Record<string, unknown>;
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/utils/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE3D;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,GAAG,OAAO,CAiBrE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,CAAC,aAAa,GAAG,KAAK,CAAC,EAAE,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,EAAE,CAgB1F;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEvE"}