@oxog/vld 1.4.0 → 2.0.1

package/dist/compat/emitter.js

@@ -0,0 +1,181 @@
+/**
+ * Event Emitter Implementation
+ *
+ * This module provides a type-safe event emitter,
+ * compatible with @oxog/emitter when available.
+ */
+/**
+ * Create a type-safe event emitter
+ */
+function createEmitter() {
+    const listeners = new Map();
+    const getListeners = (event) => {
+        if (!listeners.has(event)) {
+            listeners.set(event, []);
+        }
+        return listeners.get(event);
+    };
+    const sortListeners = (event) => {
+        const eventListeners = getListeners(event);
+        eventListeners.sort((a, b) => b.priority - a.priority);
+    };
+    const on = (event, handler, options = {}) => {
+        const entry = {
+            handler,
+            once: options.once ?? false,
+            priority: options.priority ?? 0
+        };
+        getListeners(event).push(entry);
+        sortListeners(event);
+        // Return unsubscribe function
+        return () => off(event, handler);
+    };
+    const once = (event, handler) => {
+        return on(event, handler, { once: true });
+    };
+    const off = (event, handler) => {
+        const eventListeners = listeners.get(event);
+        if (!eventListeners)
+            return;
+        const index = eventListeners.findIndex((entry) => entry.handler === handler);
+        if (index !== -1) {
+            eventListeners.splice(index, 1);
+        }
+    };
+    const emit = (event, payload) => {
+        const eventListeners = listeners.get(event);
+        if (!eventListeners || eventListeners.length === 0)
+            return;
+        // Create a copy to allow modifications during iteration
+        const listenersToCall = [...eventListeners];
+        for (const entry of listenersToCall) {
+            if (entry.once) {
+                off(event, entry.handler);
+            }
+            try {
+                entry.handler(payload);
+            }
+            catch (error) {
+                // Log error but don't stop other handlers
+                console.error(`Error in event handler for "${String(event)}":`, error);
+            }
+        }
+    };
+    const emitAsync = async (event, payload) => {
+        const eventListeners = listeners.get(event);
+        if (!eventListeners || eventListeners.length === 0)
+            return;
+        // Create a copy to allow modifications during iteration
+        const listenersToCall = [...eventListeners];
+        for (const entry of listenersToCall) {
+            if (entry.once) {
+                off(event, entry.handler);
+            }
+            try {
+                await entry.handler(payload);
+            }
+            catch (error) {
+                // Log error but don't stop other handlers
+                console.error(`Error in async event handler for "${String(event)}":`, error);
+            }
+        }
+    };
+    const removeAllListeners = (event) => {
+        if (event !== undefined) {
+            listeners.delete(event);
+        }
+        else {
+            listeners.clear();
+        }
+    };
+    const listenerCount = (event) => {
+        return listeners.get(event)?.length ?? 0;
+    };
+    const eventNames = () => {
+        return Array.from(listeners.keys()).filter((key) => {
+            const eventListeners = listeners.get(key);
+            return eventListeners !== undefined && eventListeners.length > 0;
+        });
+    };
+    return {
+        on,
+        once,
+        off,
+        emit,
+        emitAsync,
+        removeAllListeners,
+        listenerCount,
+        eventNames
+    };
+}
+/**
+ * Mixin to add event emitter capabilities to a class
+ */
+function withEmitter() {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return function (Base) {
+        return class extends Base {
+            constructor() {
+                super(...arguments);
+                /** @internal */
+                this._emitter = createEmitter();
+            }
+            on(event, handler, options) {
+                return this._emitter.on(event, handler, options);
+            }
+            once(event, handler) {
+                return this._emitter.once(event, handler);
+            }
+            off(event, handler) {
+                this._emitter.off(event, handler);
+            }
+            emit(event, payload) {
+                this._emitter.emit(event, payload);
+            }
+            async emitAsync(event, payload) {
+                await this._emitter.emitAsync(event, payload);
+            }
+        };
+    };
+}
+/**
+ * Create an event bus for global event handling
+ */
+function createEventBus() {
+    const emitter = createEmitter();
+    const createScope = () => {
+        const unsubscribers = [];
+        const scopedEmitter = {
+            on: (event, handler, options) => {
+                const unsubscribe = emitter.on(event, handler, options);
+                unsubscribers.push(unsubscribe);
+                return unsubscribe;
+            },
+            once: (event, handler) => {
+                const unsubscribe = emitter.once(event, handler);
+                unsubscribers.push(unsubscribe);
+                return unsubscribe;
+            },
+            off: emitter.off,
+            emit: emitter.emit,
+            emitAsync: emitter.emitAsync,
+            removeAllListeners: emitter.removeAllListeners,
+            listenerCount: emitter.listenerCount,
+            eventNames: emitter.eventNames,
+            dispose: () => {
+                for (const unsubscribe of unsubscribers) {
+                    unsubscribe();
+                }
+                unsubscribers.length = 0;
+            }
+        };
+        return scopedEmitter;
+    };
+    return {
+        ...emitter,
+        createScope
+    };
+}
+
+export { createEmitter, createEventBus, withEmitter };
+//# sourceMappingURL=emitter.js.map

package/dist/compat/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sources":["../../src/compat/emitter.ts"],"sourcesContent":["/**\r\n * Event Emitter Implementation\r\n *\r\n * This module provides a type-safe event emitter,\r\n * compatible with @oxog/emitter when available.\r\n */\r\n\r\n/**\r\n * Event map type - maps event names to their payload types\r\n */\r\nexport type EventMap = Record<string, unknown>;\r\n\r\n/**\r\n * Event handler function type\r\n */\r\nexport type EventHandler<T = unknown> = (payload: T) => void | Promise<void>;\r\n\r\n/**\r\n * Listener options\r\n */\r\nexport interface ListenerOptions {\r\n  /** Remove listener after first call */\r\n  once?: boolean;\r\n  /** Listener priority (higher = called first) */\r\n  priority?: number;\r\n}\r\n\r\n/**\r\n * Internal listener entry\r\n */\r\ninterface ListenerEntry<T = unknown> {\r\n  handler: EventHandler<T>;\r\n  once: boolean;\r\n  priority: number;\r\n}\r\n\r\n/**\r\n * Emitter interface\r\n */\r\nexport interface Emitter<TEvents extends EventMap = EventMap> {\r\n  /** Subscribe to an event */\r\n  on<K extends keyof TEvents>(\r\n    event: K,\r\n    handler: EventHandler<TEvents[K]>,\r\n    options?: ListenerOptions\r\n  ): () => void;\r\n\r\n  /** Subscribe to an event once */\r\n  once<K extends keyof TEvents>(\r\n    event: K,\r\n    handler: EventHandler<TEvents[K]>\r\n  ): () => void;\r\n\r\n  /** Unsubscribe from an event */\r\n  off<K extends keyof TEvents>(event: K, handler: EventHandler<TEvents[K]>): void;\r\n\r\n  /** Emit an event */\r\n  emit<K extends keyof TEvents>(event: K, payload: TEvents[K]): void;\r\n\r\n  /** Emit an event and wait for all handlers */\r\n  emitAsync<K extends keyof TEvents>(event: K, payload: TEvents[K]): Promise<void>;\r\n\r\n  /** Remove all listeners for an event or all events */\r\n  removeAllListeners<K extends keyof TEvents>(event?: K): void;\r\n\r\n  /** Get listener count for an event */\r\n  listenerCount<K extends keyof TEvents>(event: K): number;\r\n\r\n  /** Get all event names with listeners */\r\n  eventNames(): (keyof TEvents)[];\r\n}\r\n\r\n/**\r\n * Create a type-safe event emitter\r\n */\r\nexport function createEmitter<TEvents extends EventMap = EventMap>(): Emitter<TEvents> {\r\n  const listeners = new Map<keyof TEvents, ListenerEntry<unknown>[]>();\r\n\r\n  const getListeners = <K extends keyof TEvents>(event: K): ListenerEntry<TEvents[K]>[] => {\r\n    if (!listeners.has(event)) {\r\n      listeners.set(event, []);\r\n    }\r\n    return listeners.get(event) as ListenerEntry<TEvents[K]>[];\r\n  };\r\n\r\n  const sortListeners = <K extends keyof TEvents>(event: K): void => {\r\n    const eventListeners = getListeners(event);\r\n    eventListeners.sort((a, b) => b.priority - a.priority);\r\n  };\r\n\r\n  const on = <K extends keyof TEvents>(\r\n    event: K,\r\n    handler: EventHandler<TEvents[K]>,\r\n    options: ListenerOptions = {}\r\n  ): (() => void) => {\r\n    const entry: ListenerEntry<TEvents[K]> = {\r\n      handler,\r\n      once: options.once ?? false,\r\n      priority: options.priority ?? 0\r\n    };\r\n\r\n    getListeners(event).push(entry);\r\n    sortListeners(event);\r\n\r\n    // Return unsubscribe function\r\n    return () => off(event, handler);\r\n  };\r\n\r\n  const once = <K extends keyof TEvents>(\r\n    event: K,\r\n    handler: EventHandler<TEvents[K]>\r\n  ): (() => void) => {\r\n    return on(event, handler, { once: true });\r\n  };\r\n\r\n  const off = <K extends keyof TEvents>(\r\n    event: K,\r\n    handler: EventHandler<TEvents[K]>\r\n  ): void => {\r\n    const eventListeners = listeners.get(event);\r\n    if (!eventListeners) return;\r\n\r\n    const index = eventListeners.findIndex((entry) => entry.handler === handler);\r\n    if (index !== -1) {\r\n      eventListeners.splice(index, 1);\r\n    }\r\n  };\r\n\r\n  const emit = <K extends keyof TEvents>(event: K, payload: TEvents[K]): void => {\r\n    const eventListeners = listeners.get(event);\r\n    if (!eventListeners || eventListeners.length === 0) return;\r\n\r\n    // Create a copy to allow modifications during iteration\r\n    const listenersToCall = [...eventListeners];\r\n\r\n    for (const entry of listenersToCall) {\r\n      if (entry.once) {\r\n        off(event, entry.handler as EventHandler<TEvents[K]>);\r\n      }\r\n\r\n      try {\r\n        entry.handler(payload);\r\n      } catch (error) {\r\n        // Log error but don't stop other handlers\r\n        console.error(`Error in event handler for \"${String(event)}\":`, error);\r\n      }\r\n    }\r\n  };\r\n\r\n  const emitAsync = async <K extends keyof TEvents>(\r\n    event: K,\r\n    payload: TEvents[K]\r\n  ): Promise<void> => {\r\n    const eventListeners = listeners.get(event);\r\n    if (!eventListeners || eventListeners.length === 0) return;\r\n\r\n    // Create a copy to allow modifications during iteration\r\n    const listenersToCall = [...eventListeners];\r\n\r\n    for (const entry of listenersToCall) {\r\n      if (entry.once) {\r\n        off(event, entry.handler as EventHandler<TEvents[K]>);\r\n      }\r\n\r\n      try {\r\n        await entry.handler(payload);\r\n      } catch (error) {\r\n        // Log error but don't stop other handlers\r\n        console.error(`Error in async event handler for \"${String(event)}\":`, error);\r\n      }\r\n    }\r\n  };\r\n\r\n  const removeAllListeners = <K extends keyof TEvents>(event?: K): void => {\r\n    if (event !== undefined) {\r\n      listeners.delete(event);\r\n    } else {\r\n      listeners.clear();\r\n    }\r\n  };\r\n\r\n  const listenerCount = <K extends keyof TEvents>(event: K): number => {\r\n    return listeners.get(event)?.length ?? 0;\r\n  };\r\n\r\n  const eventNames = (): (keyof TEvents)[] => {\r\n    return Array.from(listeners.keys()).filter((key) => {\r\n      const eventListeners = listeners.get(key);\r\n      return eventListeners !== undefined && eventListeners.length > 0;\r\n    });\r\n  };\r\n\r\n  return {\r\n    on,\r\n    once,\r\n    off,\r\n    emit,\r\n    emitAsync,\r\n    removeAllListeners,\r\n    listenerCount,\r\n    eventNames\r\n  };\r\n}\r\n\r\n/**\r\n * Mixin to add event emitter capabilities to a class\r\n */\r\nexport function withEmitter<TEvents extends EventMap>() {\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  return function <TBase extends new (...args: any[]) => object>(Base: TBase) {\r\n    return class extends Base {\r\n      /** @internal */\r\n      _emitter = createEmitter<TEvents>();\r\n\r\n      on<K extends keyof TEvents>(\r\n        event: K,\r\n        handler: EventHandler<TEvents[K]>,\r\n        options?: ListenerOptions\r\n      ): () => void {\r\n        return this._emitter.on(event, handler, options);\r\n      }\r\n\r\n      once<K extends keyof TEvents>(event: K, handler: EventHandler<TEvents[K]>): () => void {\r\n        return this._emitter.once(event, handler);\r\n      }\r\n\r\n      off<K extends keyof TEvents>(event: K, handler: EventHandler<TEvents[K]>): void {\r\n        this._emitter.off(event, handler);\r\n      }\r\n\r\n      emit<K extends keyof TEvents>(event: K, payload: TEvents[K]): void {\r\n        this._emitter.emit(event, payload);\r\n      }\r\n\r\n      async emitAsync<K extends keyof TEvents>(\r\n        event: K,\r\n        payload: TEvents[K]\r\n      ): Promise<void> {\r\n        await this._emitter.emitAsync(event, payload);\r\n      }\r\n    };\r\n  };\r\n}\r\n\r\n/**\r\n * Create an event bus for global event handling\r\n */\r\nexport function createEventBus<TEvents extends EventMap>(): Emitter<TEvents> & {\r\n  /** Create a scoped emitter that auto-cleans up */\r\n  createScope(): Emitter<TEvents> & { dispose(): void };\r\n} {\r\n  const emitter = createEmitter<TEvents>();\r\n\r\n  const createScope = (): Emitter<TEvents> & { dispose(): void } => {\r\n    const unsubscribers: (() => void)[] = [];\r\n\r\n    const scopedEmitter: Emitter<TEvents> & { dispose(): void } = {\r\n      on: (event, handler, options) => {\r\n        const unsubscribe = emitter.on(event, handler, options);\r\n        unsubscribers.push(unsubscribe);\r\n        return unsubscribe;\r\n      },\r\n      once: (event, handler) => {\r\n        const unsubscribe = emitter.once(event, handler);\r\n        unsubscribers.push(unsubscribe);\r\n        return unsubscribe;\r\n      },\r\n      off: emitter.off,\r\n      emit: emitter.emit,\r\n      emitAsync: emitter.emitAsync,\r\n      removeAllListeners: emitter.removeAllListeners,\r\n      listenerCount: emitter.listenerCount,\r\n      eventNames: emitter.eventNames,\r\n      dispose: () => {\r\n        for (const unsubscribe of unsubscribers) {\r\n          unsubscribe();\r\n        }\r\n        unsubscribers.length = 0;\r\n      }\r\n    };\r\n\r\n    return scopedEmitter;\r\n  };\r\n\r\n  return {\r\n    ...emitter,\r\n    createScope\r\n  };\r\n}\r\n\r\nexport type { EventHandler as VldEventHandler };\r\n"],"names":[],"mappings":"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"}

package/dist/compat/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * VLD Compatibility Layer
+ *
+ * This module provides internal implementations of @oxog ecosystem features
+ * that can be replaced with actual @oxog packages when available.
+ *
+ * Features:
+ * - Result pattern (@oxog/types compatibility)
+ * - Event emitter (@oxog/emitter compatibility)
+ */
+export type { Result, VldResult } from './result';
+export { Ok, Err, success, failure, isOk, isErr, isResult, unwrap, unwrapOr, map, mapErr, flatMap, match, tryCatch, tryCatchAsync, all, fromNullable, ResultUtils } from './result';
+export type { EventMap, EventHandler, ListenerOptions, Emitter, VldEventHandler } from './emitter';
+export { createEmitter, createEventBus, withEmitter } from './emitter';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAElD,OAAO,EACL,EAAE,EACF,GAAG,EACH,OAAO,EACP,OAAO,EACP,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,GAAG,EACH,MAAM,EACN,OAAO,EACP,KAAK,EACL,QAAQ,EACR,aAAa,EACb,GAAG,EACH,YAAY,EACZ,WAAW,EACZ,MAAM,UAAU,CAAC;AAGlB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGnG,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/compat/result.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Result Pattern Implementation
+ *
+ * This module provides a Result type for functional error handling,
+ * compatible with @oxog/types when available.
+ */
+import type { VldError } from '../errors';
+/**
+ * Success result type
+ */
+export interface Ok<T> {
+    readonly success: true;
+    readonly data: T;
+    readonly value: T;
+    readonly error?: never;
+}
+/**
+ * Error result type
+ */
+export interface Err<E = Error> {
+    readonly success: false;
+    readonly error: E;
+    readonly data?: never;
+    readonly value?: never;
+}
+/**
+ * Result type - Either success with data or failure with error
+ */
+export type Result<T, E = Error> = Ok<T> | Err<E>;
+/**
+ * VLD-specific Result type with VldError
+ */
+export type VldResult<T> = Result<T, VldError>;
+/**
+ * Create a success result
+ */
+export declare function Ok<T>(data: T): Ok<T>;
+/**
+ * Create an error result
+ */
+export declare function Err<E = Error>(error: E): Err<E>;
+/**
+ * Create a success result (alias)
+ */
+export declare const success: typeof Ok;
+/**
+ * Create a failure result (alias)
+ */
+export declare const failure: typeof Err;
+/**
+ * Check if result is Ok
+ */
+export declare function isOk<T, E>(result: Result<T, E>): result is Ok<T>;
+/**
+ * Check if result is Err
+ */
+export declare function isErr<T, E>(result: Result<T, E>): result is Err<E>;
+/**
+ * Check if value is a Result
+ */
+export declare function isResult<T, E>(value: unknown): value is Result<T, E>;
+/**
+ * Unwrap a result, throwing the error if it's an Err
+ */
+export declare function unwrap<T, E extends Error>(result: Result<T, E>): T;
+/**
+ * Unwrap a result with a default value
+ */
+export declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
+/**
+ * Map over a successful result
+ */
+export declare function map<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E>;
+/**
+ * Map over an error result
+ */
+export declare function mapErr<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F>;
+/**
+ * Chain results (flatMap)
+ */
+export declare function flatMap<T, U, E>(result: Result<T, E>, fn: (value: T) => Result<U, E>): Result<U, E>;
+/**
+ * Pattern match on a result
+ */
+export declare function match<T, E, U>(result: Result<T, E>, handlers: {
+    ok: (value: T) => U;
+    err: (error: E) => U;
+}): U;
+/**
+ * Try to execute a function and wrap the result
+ */
+export declare function tryCatch<T>(fn: () => T): Result<T, Error>;
+/**
+ * Try to execute an async function and wrap the result
+ */
+export declare function tryCatchAsync<T>(fn: () => Promise<T>): Promise<Result<T, Error>>;
+/**
+ * Combine multiple results into a single result
+ * Returns Ok with array of values if all succeed, Err with first error otherwise
+ */
+export declare function all<T, E>(results: Result<T, E>[]): Result<T[], E>;
+/**
+ * Convert a nullable value to a Result
+ */
+export declare function fromNullable<T>(value: T | null | undefined, error?: Error): Result<T, Error>;
+/**
+ * Result utilities namespace
+ */
+export declare const ResultUtils: {
+    Ok: typeof Ok;
+    Err: typeof Err;
+    success: typeof Ok;
+    failure: typeof Err;
+    isOk: typeof isOk;
+    isErr: typeof isErr;
+    isResult: typeof isResult;
+    unwrap: typeof unwrap;
+    unwrapOr: typeof unwrapOr;
+    map: typeof map;
+    mapErr: typeof mapErr;
+    flatMap: typeof flatMap;
+    match: typeof match;
+    tryCatch: typeof tryCatch;
+    tryCatchAsync: typeof tryCatchAsync;
+    all: typeof all;
+    fromNullable: typeof fromNullable;
+};
+//# sourceMappingURL=result.d.ts.map

package/dist/compat/result.d.ts.map

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

package/dist/compat/result.js

@@ -0,0 +1,171 @@
+/**
+ * Result Pattern Implementation
+ *
+ * This module provides a Result type for functional error handling,
+ * compatible with @oxog/types when available.
+ */
+/**
+ * Create a success result
+ */
+function Ok(data) {
+    return { success: true, data, value: data };
+}
+/**
+ * Create an error result
+ */
+function Err(error) {
+    return { success: false, error };
+}
+/**
+ * Create a success result (alias)
+ */
+const success = Ok;
+/**
+ * Create a failure result (alias)
+ */
+const failure = Err;
+/**
+ * Check if result is Ok
+ */
+function isOk(result) {
+    return result.success === true;
+}
+/**
+ * Check if result is Err
+ */
+function isErr(result) {
+    return result.success === false;
+}
+/**
+ * Check if value is a Result
+ */
+function isResult(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'success' in value &&
+        typeof value.success === 'boolean');
+}
+/**
+ * Unwrap a result, throwing the error if it's an Err
+ */
+function unwrap(result) {
+    if (isOk(result)) {
+        return result.data;
+    }
+    throw result.error;
+}
+/**
+ * Unwrap a result with a default value
+ */
+function unwrapOr(result, defaultValue) {
+    if (isOk(result)) {
+        return result.data;
+    }
+    return defaultValue;
+}
+/**
+ * Map over a successful result
+ */
+function map(result, fn) {
+    if (isOk(result)) {
+        return Ok(fn(result.data));
+    }
+    return result;
+}
+/**
+ * Map over an error result
+ */
+function mapErr(result, fn) {
+    if (isErr(result)) {
+        return Err(fn(result.error));
+    }
+    return result;
+}
+/**
+ * Chain results (flatMap)
+ */
+function flatMap(result, fn) {
+    if (isOk(result)) {
+        return fn(result.data);
+    }
+    return result;
+}
+/**
+ * Pattern match on a result
+ */
+function match(result, handlers) {
+    if (isOk(result)) {
+        return handlers.ok(result.data);
+    }
+    return handlers.err(result.error);
+}
+/**
+ * Try to execute a function and wrap the result
+ */
+function tryCatch(fn) {
+    try {
+        return Ok(fn());
+    }
+    catch (error) {
+        return Err(error instanceof Error ? error : new Error(String(error)));
+    }
+}
+/**
+ * Try to execute an async function and wrap the result
+ */
+async function tryCatchAsync(fn) {
+    try {
+        return Ok(await fn());
+    }
+    catch (error) {
+        return Err(error instanceof Error ? error : new Error(String(error)));
+    }
+}
+/**
+ * Combine multiple results into a single result
+ * Returns Ok with array of values if all succeed, Err with first error otherwise
+ */
+function all(results) {
+    const values = [];
+    for (const result of results) {
+        if (isErr(result)) {
+            return result;
+        }
+        values.push(result.data);
+    }
+    return Ok(values);
+}
+/**
+ * Convert a nullable value to a Result
+ */
+function fromNullable(value, error = new Error('Value is null or undefined')) {
+    if (value === null || value === undefined) {
+        return Err(error);
+    }
+    return Ok(value);
+}
+/**
+ * Result utilities namespace
+ */
+const ResultUtils = {
+    Ok,
+    Err,
+    success,
+    failure,
+    isOk,
+    isErr,
+    isResult,
+    unwrap,
+    unwrapOr,
+    map,
+    mapErr,
+    flatMap,
+    match,
+    tryCatch,
+    tryCatchAsync,
+    all,
+    fromNullable
+};
+
+export { Err, Ok, ResultUtils, all, failure, flatMap, fromNullable, isErr, isOk, isResult, map, mapErr, match, success, tryCatch, tryCatchAsync, unwrap, unwrapOr };
+//# sourceMappingURL=result.js.map

package/dist/compat/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sources":["../../src/compat/result.ts"],"sourcesContent":["/**\r\n * Result Pattern Implementation\r\n *\r\n * This module provides a Result type for functional error handling,\r\n * compatible with @oxog/types when available.\r\n */\r\n\r\nimport type { VldError } from '../errors';\r\n\r\n/**\r\n * Success result type\r\n */\r\nexport interface Ok<T> {\r\n  readonly success: true;\r\n  readonly data: T;\r\n  readonly value: T; // Alias for @oxog/types compatibility\r\n  readonly error?: never;\r\n}\r\n\r\n/**\r\n * Error result type\r\n */\r\nexport interface Err<E = Error> {\r\n  readonly success: false;\r\n  readonly error: E;\r\n  readonly data?: never;\r\n  readonly value?: never;\r\n}\r\n\r\n/**\r\n * Result type - Either success with data or failure with error\r\n */\r\nexport type Result<T, E = Error> = Ok<T> | Err<E>;\r\n\r\n/**\r\n * VLD-specific Result type with VldError\r\n */\r\nexport type VldResult<T> = Result<T, VldError>;\r\n\r\n/**\r\n * Create a success result\r\n */\r\nexport function Ok<T>(data: T): Ok<T> {\r\n  return { success: true, data, value: data };\r\n}\r\n\r\n/**\r\n * Create an error result\r\n */\r\nexport function Err<E = Error>(error: E): Err<E> {\r\n  return { success: false, error };\r\n}\r\n\r\n/**\r\n * Create a success result (alias)\r\n */\r\nexport const success = Ok;\r\n\r\n/**\r\n * Create a failure result (alias)\r\n */\r\nexport const failure = Err;\r\n\r\n/**\r\n * Check if result is Ok\r\n */\r\nexport function isOk<T, E>(result: Result<T, E>): result is Ok<T> {\r\n  return result.success === true;\r\n}\r\n\r\n/**\r\n * Check if result is Err\r\n */\r\nexport function isErr<T, E>(result: Result<T, E>): result is Err<E> {\r\n  return result.success === false;\r\n}\r\n\r\n/**\r\n * Check if value is a Result\r\n */\r\nexport function isResult<T, E>(value: unknown): value is Result<T, E> {\r\n  return (\r\n    typeof value === 'object' &&\r\n    value !== null &&\r\n    'success' in value &&\r\n    typeof (value as Result<T, E>).success === 'boolean'\r\n  );\r\n}\r\n\r\n/**\r\n * Unwrap a result, throwing the error if it's an Err\r\n */\r\nexport function unwrap<T, E extends Error>(result: Result<T, E>): T {\r\n  if (isOk(result)) {\r\n    return result.data;\r\n  }\r\n  throw result.error;\r\n}\r\n\r\n/**\r\n * Unwrap a result with a default value\r\n */\r\nexport function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T {\r\n  if (isOk(result)) {\r\n    return result.data;\r\n  }\r\n  return defaultValue;\r\n}\r\n\r\n/**\r\n * Map over a successful result\r\n */\r\nexport function map<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E> {\r\n  if (isOk(result)) {\r\n    return Ok(fn(result.data));\r\n  }\r\n  return result as Err<E>;\r\n}\r\n\r\n/**\r\n * Map over an error result\r\n */\r\nexport function mapErr<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F> {\r\n  if (isErr(result)) {\r\n    return Err(fn(result.error));\r\n  }\r\n  return result as Ok<T>;\r\n}\r\n\r\n/**\r\n * Chain results (flatMap)\r\n */\r\nexport function flatMap<T, U, E>(\r\n  result: Result<T, E>,\r\n  fn: (value: T) => Result<U, E>\r\n): Result<U, E> {\r\n  if (isOk(result)) {\r\n    return fn(result.data);\r\n  }\r\n  return result as Err<E>;\r\n}\r\n\r\n/**\r\n * Pattern match on a result\r\n */\r\nexport function match<T, E, U>(\r\n  result: Result<T, E>,\r\n  handlers: {\r\n    ok: (value: T) => U;\r\n    err: (error: E) => U;\r\n  }\r\n): U {\r\n  if (isOk(result)) {\r\n    return handlers.ok(result.data);\r\n  }\r\n  return handlers.err(result.error);\r\n}\r\n\r\n/**\r\n * Try to execute a function and wrap the result\r\n */\r\nexport function tryCatch<T>(fn: () => T): Result<T, Error> {\r\n  try {\r\n    return Ok(fn());\r\n  } catch (error) {\r\n    return Err(error instanceof Error ? error : new Error(String(error)));\r\n  }\r\n}\r\n\r\n/**\r\n * Try to execute an async function and wrap the result\r\n */\r\nexport async function tryCatchAsync<T>(fn: () => Promise<T>): Promise<Result<T, Error>> {\r\n  try {\r\n    return Ok(await fn());\r\n  } catch (error) {\r\n    return Err(error instanceof Error ? error : new Error(String(error)));\r\n  }\r\n}\r\n\r\n/**\r\n * Combine multiple results into a single result\r\n * Returns Ok with array of values if all succeed, Err with first error otherwise\r\n */\r\nexport function all<T, E>(results: Result<T, E>[]): Result<T[], E> {\r\n  const values: T[] = [];\r\n\r\n  for (const result of results) {\r\n    if (isErr(result)) {\r\n      return result;\r\n    }\r\n    values.push(result.data);\r\n  }\r\n\r\n  return Ok(values);\r\n}\r\n\r\n/**\r\n * Convert a nullable value to a Result\r\n */\r\nexport function fromNullable<T>(\r\n  value: T | null | undefined,\r\n  error: Error = new Error('Value is null or undefined')\r\n): Result<T, Error> {\r\n  if (value === null || value === undefined) {\r\n    return Err(error);\r\n  }\r\n  return Ok(value);\r\n}\r\n\r\n/**\r\n * Result utilities namespace\r\n */\r\nexport const ResultUtils = {\r\n  Ok,\r\n  Err,\r\n  success,\r\n  failure,\r\n  isOk,\r\n  isErr,\r\n  isResult,\r\n  unwrap,\r\n  unwrapOr,\r\n  map,\r\n  mapErr,\r\n  flatMap,\r\n  match,\r\n  tryCatch,\r\n  tryCatchAsync,\r\n  all,\r\n  fromNullable\r\n};\r\n"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -1,3 +1,4 @@
+import { type Theme } from './pigment';
 export type VldErrorCode = 'invalid_type' | 'invalid_string' | 'string_too_small' | 'string_too_big' | 'invalid_email' | 'invalid_url' | 'invalid_uuid' | 'invalid_regex' | 'invalid_number' | 'too_small' | 'too_big' | 'not_integer' | 'not_finite' | 'not_safe' | 'invalid_boolean' | 'invalid_date' | 'invalid_array' | 'invalid_object' | 'unrecognized_keys' | 'invalid_union' | 'invalid_literal' | 'invalid_enum' | 'custom';
 export interface VldIssue {
     code: VldErrorCode;
@@ -16,6 +17,39 @@ export declare class VldError extends Error {
     constructor(issues: VldIssue[]);
     get firstError(): VldIssue | undefined;
     get formattedErrors(): string[];
+    /**
+     * Convert error to JSON representation
+     * Compatible with @oxog/types OxogError
+     */
+    toJSON(): VldErrorJSON;
+    /**
+     * Create VldError from JSON representation
+     */
+    static fromJSON(json: VldErrorJSON): VldError;
+    /**
+     * Check if a value is a VldError
+     */
+    static isVldError(value: unknown): value is VldError;
+}
+/**
+ * JSON representation of VldError
+ */
+export interface VldErrorJSON {
+    name: string;
+    message: string;
+    code: string;
+    issues: Array<{
+        code: string;
+        path: (string | number)[];
+        message: string;
+        expected?: string;
+        received?: string;
+        keys?: string[];
+        minimum?: number;
+        maximum?: number;
+        exact?: number;
+        inclusive?: boolean;
+    }>;
 }
 export interface VldErrorTree {
     errors: string[];
@@ -30,10 +64,33 @@ export interface VldFlattenedError {
  * Convert VldError to a nested tree structure
  */
 export declare function treeifyError(error: VldError): VldErrorTree;
+/**
+ * Prettify error options
+ */
+export interface PrettifyOptions {
+    /** Enable colored output */
+    colored?: boolean;
+    /** Custom theme for colors */
+    theme?: Theme;
+    /** Include error code in output */
+    includeCode?: boolean;
+    /** Include expected/received values */
+    includeDetails?: boolean;
+}
 /**
  * Convert VldError to human-readable string
  */
-export declare function prettifyError(error: VldError): string;
+export declare function prettifyError(error: VldError, options?: PrettifyOptions): string;
+/**
+ * Convert VldError to human-readable string with full colors
+ * Shorthand for prettifyError with colored: true
+ */
+export declare function prettifyErrorColored(error: VldError, options?: Omit<PrettifyOptions, 'colored'>): string;
+/**
+ * Convert VldError to plain text string (no colors)
+ * Shorthand for prettifyError with colored: false
+ */
+export declare function prettifyErrorPlain(error: VldError, options?: Omit<PrettifyOptions, 'colored'>): string;
 /**
  * Flatten VldError for simple form validation
  */

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GACpB,cAAc,GACd,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,aAAa,GACb,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,SAAS,GACT,aAAa,GACb,YAAY,GACZ,UAAU,GACV,iBAAiB,GACjB,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,QAAQ,CAAC;AAEb,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,MAAM,EAAE,QAAQ,EAAE,CAAC;gBAEvB,MAAM,EAAE,QAAQ,EAAE;IAe9B,IAAI,UAAU,IAAI,QAAQ,GAAG,SAAS,CAErC;IAED,IAAI,eAAe,IAAI,MAAM,EAAE,CAE9B;CACF;AAGD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1C,KAAK,CAAC,EAAE,CAAC,YAAY,GAAG,SAAS,CAAC,EAAE,CAAC;CACtC;AAGD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,YAAY,CAwD1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAwBrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,iBAAiB,CAiB/D;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EACzB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GACxB,QAAQ,CAOV;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMnD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}