@shirudo/ddd-kit 0.9.8 → 0.10.0

package/dist/result.d.ts

@@ -0,0 +1,204 @@
+import { R as Result } from './result-jCwPSjFa.js';
+export { E as Err, O as Ok, a as andThen, e as err, i as isErr, b as isOk, m as map, c as mapErr, d as match, f as matchAsync, g as matchResult, o as ok, p as pipe, t as tryCatch, h as tryCatchAsync, u as unwrapOr, j as unwrapOrElse } from './result-jCwPSjFa.js';
+
+/**
+ * Base class for Result with method chaining support.
+ * Provides common methods for both Ok and Err classes.
+ */
+declare abstract class ResultBase<T, E> {
+    protected readonly _result: Result<T, E>;
+    protected constructor(result: Result<T, E>);
+    /**
+     * Returns the value if Ok, otherwise throws an error.
+     * If error is an Error instance, throws it directly.
+     * Otherwise, wraps the error in a new Error.
+     *
+     * @throws Error if the result is Err
+     */
+    unwrap(): T;
+    /**
+     * Returns the value if Ok, otherwise returns the default value.
+     */
+    unwrapOr(defaultValue: T): T;
+    /**
+     * Returns the value if Ok, otherwise computes default from error.
+     */
+    unwrapOrElse(fn: (error: E) => T): T;
+    /**
+     * Pattern matching for Result.
+     * Applies one function if Ok, another if Err.
+     *
+     * @example
+     * ```typescript
+     * outcome.match(
+     *   value => `Success: ${value}`,
+     *   error => `Error: ${error}`
+     * );
+     * ```
+     *
+     * @example Using object syntax
+     * ```typescript
+     * outcome.match({
+     *   ok: value => `Success: ${value}`,
+     *   err: error => `Error: ${error}`
+     * });
+     * ```
+     */
+    match<R>(onOk: (value: T) => R, onErr: (error: E) => R): R;
+    match<R>(handlers: {
+        ok: (value: T) => R;
+        err: (error: E) => R;
+    }): R;
+    /**
+     * Async pattern matching for Result.
+     * Applies one async function if Ok, another if Err.
+     *
+     * @example
+     * ```typescript
+     * await outcome.matchAsync(
+     *   async (value) => `Success: ${value}`,
+     *   async (error) => `Error: ${error}`
+     * );
+     * ```
+     *
+     * @example Using object syntax
+     * ```typescript
+     * await outcome.matchAsync({
+     *   ok: async (value) => `Success: ${value}`,
+     *   err: async (error) => `Error: ${error}`
+     * });
+     * ```
+     */
+    matchAsync<R>(onOk: (value: T) => Promise<R>, onErr: (error: E) => Promise<R>): Promise<R>;
+    matchAsync<R>(handlers: {
+        ok: (value: T) => Promise<R>;
+        err: (error: E) => Promise<R>;
+    }): Promise<R>;
+    /**
+     * Type guard to check if the result is Ok.
+     */
+    isOk(): this is Success<T>;
+    /**
+     * Type guard to check if the result is Err.
+     */
+    isErr(): this is Erroneous<E>;
+    /**
+     * Gets the underlying Result value.
+     */
+    get result(): Result<T, E>;
+}
+/**
+ * Class representing a successful result with method chaining support.
+ * Use this for class-based API with method chaining.
+ *
+ * @example
+ * ```typescript
+ * const okResult = Ok(1);
+ * const doubled = okResult.map(x => x * 2).unwrap(); // 2
+ *
+ * const chained = Ok(5)
+ *   .andThen(x => Ok(x * 2))
+ *   .map(x => x + 1)
+ *   .unwrap(); // 11
+ * ```
+ */
+declare class Success<T> extends ResultBase<T, never> {
+    constructor(value: T);
+    /**
+     * Factory function to create an Ok instance.
+     * Can be called with or without `new`.
+     */
+    static of<T>(value: T): Success<T>;
+    /**
+     * Chains Result operations (flatMap/bind).
+     * If the result is Ok, applies the function to the value.
+     * If Err, returns the error unchanged.
+     */
+    andThen<U, E>(fn: (value: T) => Result<U, E>): Success<U> | Erroneous<E>;
+    /**
+     * Transforms the Ok value using a function.
+     * If the result is Err, returns the error unchanged.
+     */
+    map<U>(fn: (value: T) => U): Success<U>;
+    /**
+     * Transforms the Err value using a function.
+     * If the result is Ok, returns the value unchanged.
+     */
+    mapErr<F>(_fn: (error: never) => F): Success<T>;
+}
+
+/**
+ * Class representing an erroneous result with method chaining support.
+ * Use this for class-based API with method chaining.
+ *
+ * @example
+ * ```typescript
+ * const errResult = Err(new Error("error"));
+ * errResult.map(x => x * 2).unwrap(); // throws Error("error")
+ *
+ * const mapped = Err("original")
+ *   .mapErr(e => `Error: ${e}`)
+ *   .unwrap(); // throws Error("Error: original")
+ * ```
+ */
+declare class Erroneous<E> extends ResultBase<never, E> {
+    constructor(error: E);
+    /**
+     * Factory function to create an Err instance.
+     * Can be called with or without `new`.
+     */
+    static of<E>(error: E): Erroneous<E>;
+    /**
+     * Chains Result operations (flatMap/bind).
+     * If the result is Ok, applies the function to the value.
+     * If Err, returns the error unchanged.
+     */
+    andThen<U>(_fn: (value: never) => Result<U, E>): Erroneous<E>;
+    /**
+     * Transforms the Ok value using a function.
+     * If the result is Err, returns the error unchanged.
+     */
+    map<U>(_fn: (value: never) => U): Erroneous<E>;
+    /**
+     * Transforms the Err value using a function.
+     * If the result is Ok, returns the value unchanged.
+     */
+    mapErr<F>(fn: (error: E) => F): Erroneous<F>;
+}
+
+/**
+ * Class-based API for Result with method chaining support.
+ * Provides an object-oriented alternative to the functional Result type.
+ * Use `Outcome.from()` to wrap an existing Result, or `Outcome.ok()` / `Outcome.err()` to create new instances.
+ *
+ * @example
+ * ```typescript
+ * // Wrap an existing Result
+ * const result = Outcome.from(ok(1));
+ * const doubled = result.map(x => x * 2).unwrap(); // 2
+ *
+ * // Create directly
+ * const outcome = Outcome.ok(42);
+ * const value = outcome.map(x => x + 1).unwrap(); // 43
+ * ```
+ */
+declare class Outcome<T, E> extends ResultBase<T, E> {
+    private constructor();
+    /**
+     * Creates an Outcome from an Ok value.
+     */
+    static ok<T>(value: T): Success<T>;
+    /**
+     * Creates an Outcome from an Err value.
+     */
+    static err<E>(error: E): Erroneous<E>;
+    /**
+     * Creates an Outcome from a Result.
+     */
+    static from<T, E>(result: Result<T, E>): Outcome<T, E>;
+    andThen<U>(fn: (value: T) => Result<U, E>): Outcome<U, E>;
+    map<U>(fn: (value: T) => U): Outcome<U, E>;
+    mapErr<F>(fn: (error: E) => F): Outcome<T, F>;
+}
+
+export { Erroneous, Outcome, Result, Success };

package/dist/result.js

@@ -0,0 +1,2 @@
+var x=Object.defineProperty;var o=(e,r)=>x(e,"name",{value:r,configurable:true});function n(e){return {ok:true,value:e}}o(n,"ok");function u(e){return {ok:false,error:e}}o(u,"err");function p(e){return e.ok===true}o(p,"isOk");function f(e){return e.ok===false}o(f,"isErr");function i(e,r){return e.ok?r(e.value):e}o(i,"andThen");function c(e,r){return e.ok?n(r(e.value)):e}o(c,"map");function T(e,r){return e.ok?e:u(r(e.error))}o(T,"mapErr");function m(e,r){return e.ok?e.value:r}o(m,"unwrapOr");function h(e,r){return e.ok?e.value:r(e.error)}o(h,"unwrapOrElse");function a(e,r,t){return typeof r=="function"?e.ok?r(e.value):t(e.error):e.ok?r.ok(e.value):r.err(e.error)}o(a,"match");async function l(e,r,t){return typeof r=="function"?e.ok?r(e.value):t(e.error):e.ok?r.ok(e.value):r.err(e.error)}o(l,"matchAsync");function U(e,r,t){return typeof r=="function"?e.ok?r(e.value):t(e.error):e.ok?r.ok(e.value):r.err(e.error)}o(U,"matchResult");function y(e,...r){let t=e;for(let k of r)if(t=k(t),!t.ok)return t;return t}o(y,"pipe");function w(e,r){try{return n(e())}catch(t){return u(r?r(t):t instanceof Error?t:new Error(String(t)))}}o(w,"tryCatch");async function F(e,r){try{let t=await e();return n(t)}catch(t){return u(r?r(t):t instanceof Error?t:new Error(String(t)))}}o(F,"tryCatchAsync");var s=class{static{o(this,"ResultBase");}_result;constructor(r){this._result=r;}unwrap(){if(this._result.ok)return this._result.value;throw this._result.error instanceof Error?this._result.error:new Error(String(this._result.error))}unwrapOr(r){return m(this._result,r)}unwrapOrElse(r){return h(this._result,r)}match(r,t){return typeof r=="function"?a(this._result,r,t):a(this._result,r)}async matchAsync(r,t){return typeof r=="function"?l(this._result,r,t):l(this._result,r)}isOk(){return p(this._result)}isErr(){return f(this._result)}get result(){return this._result}},R=class e extends s{static{o(this,"Success");}constructor(r){super(n(r));}static of(r){return new e(r)}andThen(r){let t=i(this._result,r);return t.ok?new e(t.value):new E(t.error)}map(r){let t=c(this._result,r);if(t.ok)return new e(t.value);throw new Error("Unexpected error in Success.map")}mapErr(r){return this}};var E=class e extends s{static{o(this,"Erroneous");}constructor(r){super(u(r));}static of(r){return new e(r)}andThen(r){return this}map(r){return this}mapErr(r){let t=T(this._result,r);if(!t.ok)return new e(t.error);throw new Error("Unexpected ok in Erroneous.mapErr")}};var v=class e extends s{static{o(this,"Outcome");}constructor(r){super(r);}static ok(r){return new R(r)}static err(r){return new E(r)}static from(r){return new e(r)}andThen(r){return e.from(i(this._result,r))}map(r){return e.from(c(this._result,r))}mapErr(r){return e.from(T(this._result,r))}};export{E as Erroneous,v as Outcome,R as Success,i as andThen,u as err,f as isErr,p as isOk,c as map,T as mapErr,a as match,l as matchAsync,U as matchResult,n as ok,y as pipe,w as tryCatch,F as tryCatchAsync,m as unwrapOr,h as unwrapOrElse};//# sourceMappingURL=result.js.map
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/result/result.ts","../src/core/result/outcome.ts"],"names":["ok","value","__name","err","error","isOk","result","isErr","andThen","fn","map","mapErr","unwrapOr","defaultValue","unwrapOrElse","match","onOkOrHandlers","onErr","matchAsync","matchResult","pipe","initial","fns","current","tryCatch","errorMapper","tryCatchAsync","ResultBase","Success","_Success","Erroneous","_fn","_Erroneous","Outcome","_Outcome"],"mappings":"AA+BO,IAAA,CAAA,CAAA,MAAA,CAAA,cAAA,CAAA,IAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CAAA,CAAA,CAAA,CAAA,MAAA,CAAA,CAAA,KAAA,CAAA,CAAA,CAAA,YAAA,CAAA,IAAA,CAAA,CAAA,CAAA,SAASA,EAAMC,CAAAA,CAAkB,CACvC,OAAO,CAAE,EAAA,CAAI,KAAM,KAAA,CAAOA,CAAW,CACtC,CAFgBC,EAAAF,CAAAA,CAAA,IAAA,CAAA,CA+BT,SAASG,CAAAA,CAAOC,CAAAA,CAAmB,CACzC,OAAO,CAAE,EAAA,CAAI,KAAA,CAAO,MAAOA,CAAW,CACvC,CAFgBF,CAAAA,CAAAC,CAAAA,CAAA,OAoBT,SAASE,CAAAA,CAAWC,EAAuC,CACjE,OAAOA,EAAO,EAAA,GAAO,IACtB,CAFgBJ,CAAAA,CAAAG,CAAAA,CAAA,QAoBT,SAASE,CAAAA,CAAYD,CAAAA,CAAwC,CACnE,OAAOA,CAAAA,CAAO,EAAA,GAAO,KACtB,CAFgBJ,CAAAA,CAAAK,EAAA,OAAA,CAAA,CAqBT,SAASC,CAAAA,CACfF,CAAAA,CACAG,EACe,CACf,OAAIH,EAAO,EAAA,CACHG,CAAAA,CAAGH,EAAO,KAAK,CAAA,CAEhBA,CACR,CARgBJ,EAAAM,CAAAA,CAAA,SAAA,CAAA,CAwBT,SAASE,CAAAA,CACfJ,CAAAA,CACAG,EACe,CACf,OAAIH,EAAO,EAAA,CACHN,CAAAA,CAAGS,EAAGH,CAAAA,CAAO,KAAK,CAAC,CAAA,CAEpBA,CACR,CARgBJ,CAAAA,CAAAQ,CAAAA,CAAA,KAAA,CAAA,CAwBT,SAASC,EACfL,CAAAA,CACAG,CAAAA,CACe,CACf,OAAIH,CAAAA,CAAO,GACHA,CAAAA,CAEDH,CAAAA,CAAIM,CAAAA,CAAGH,CAAAA,CAAO,KAAK,CAAC,CAC5B,CARgBJ,CAAAA,CAAAS,CAAAA,CAAA,UAuBT,SAASC,CAAAA,CAAeN,CAAAA,CAAsBO,CAAAA,CAAoB,CACxE,OAAOP,CAAAA,CAAO,GAAKA,CAAAA,CAAO,KAAA,CAAQO,CACnC,CAFgBX,CAAAA,CAAAU,EAAA,UAAA,CAAA,CAiBT,SAASE,EACfR,CAAAA,CACAG,CAAAA,CACI,CACJ,OAAOH,CAAAA,CAAO,GAAKA,CAAAA,CAAO,KAAA,CAAQG,CAAAA,CAAGH,CAAAA,CAAO,KAAK,CAClD,CALgBJ,EAAAY,CAAAA,CAAA,cAAA,CAAA,CAyCT,SAASC,CAAAA,CACfT,CAAAA,CACAU,CAAAA,CACAC,CAAAA,CACI,CACJ,OAAI,OAAOD,GAAmB,UAAA,CAEtBV,CAAAA,CAAO,GAAKU,CAAAA,CAAeV,CAAAA,CAAO,KAAK,CAAA,CAAIW,EAAOX,CAAAA,CAAO,KAAK,EAG/DA,CAAAA,CAAO,EAAA,CACXU,EAAe,EAAA,CAAGV,CAAAA,CAAO,KAAK,CAAA,CAC9BU,CAAAA,CAAe,IAAIV,CAAAA,CAAO,KAAK,CACnC,CAbgBJ,CAAAA,CAAAa,EAAA,OAAA,CAAA,CAkDhB,eAAsBG,CAAAA,CACrBZ,CAAAA,CACAU,EAGAC,CAAAA,CACa,CACb,OAAI,OAAOD,CAAAA,EAAmB,WAEtBV,CAAAA,CAAO,EAAA,CACXU,CAAAA,CAAeV,CAAAA,CAAO,KAAK,CAAA,CAC3BW,CAAAA,CAAOX,EAAO,KAAK,CAAA,CAGhBA,EAAO,EAAA,CACXU,CAAAA,CAAe,EAAA,CAAGV,CAAAA,CAAO,KAAK,CAAA,CAC9BU,CAAAA,CAAe,IAAIV,CAAAA,CAAO,KAAK,CACnC,CAjBsBJ,CAAAA,CAAAgB,EAAA,YAAA,CAAA,CAiDf,SAASC,EACfb,CAAAA,CACAU,CAAAA,CAGAC,EACe,CACf,OAAI,OAAOD,CAAAA,EAAmB,UAAA,CACtBV,CAAAA,CAAO,EAAA,CAAKU,EAAeV,CAAAA,CAAO,KAAK,EAAIW,CAAAA,CAAOX,CAAAA,CAAO,KAAK,CAAA,CAE/DA,CAAAA,CAAO,EAAA,CACXU,CAAAA,CAAe,GAAGV,CAAAA,CAAO,KAAK,EAC9BU,CAAAA,CAAe,GAAA,CAAIV,EAAO,KAAK,CACnC,CAbgBJ,CAAAA,CAAAiB,EAAA,aAAA,CAAA,CAmDT,SAASC,EACfC,CAAAA,CAAAA,GACGC,CAAAA,CACY,CACf,IAAIC,CAAAA,CAAUF,EACd,IAAA,IAAWZ,CAAAA,IAAMa,EAEhB,GADAC,CAAAA,CAAUd,EAAGc,CAAO,CAAA,CAChB,CAACA,CAAAA,CAAQ,EAAA,CACZ,OAAOA,CAAAA,CAGT,OAAOA,CACR,CAZgBrB,EAAAkB,CAAAA,CAAA,MAAA,CAAA,CA+CT,SAASI,CAAAA,CACff,CAAAA,CACAgB,CAAAA,CACe,CACf,GAAI,CACH,OAAOzB,EAAGS,CAAAA,EAAI,CACf,CAAA,MAASL,CAAAA,CAAO,CACf,OACQD,EADJsB,CAAAA,CACQA,CAAAA,CAAYrB,CAAK,CAAA,CAEjBA,CAAAA,YAAiB,MAAQA,CAAAA,CAAQ,IAAI,MAAM,MAAA,CAAOA,CAAK,CAAC,CAFtC,CAG/B,CACD,CAZgBF,CAAAA,CAAAsB,EAAA,UAAA,CAAA,CAuChB,eAAsBE,CAAAA,CACrBjB,CAAAA,CACAgB,EACwB,CACxB,GAAI,CACH,IAAMxB,CAAAA,CAAQ,MAAMQ,CAAAA,EAAG,CACvB,OAAOT,CAAAA,CAAGC,CAAK,CAChB,CAAA,MAASG,EAAO,CACf,OACQD,EADJsB,CAAAA,CACQA,CAAAA,CAAYrB,CAAK,CAAA,CAEjBA,aAAiB,KAAA,CAAQA,CAAAA,CAAQ,IAAI,KAAA,CAAM,MAAA,CAAOA,CAAK,CAAC,CAFtC,CAG/B,CACD,CAbsBF,EAAAwB,CAAAA,CAAA,eAAA,CAAA,KCrdPC,CAAAA,CAAf,KAAgC,CAnBhC,OAmBgCzB,CAAAA,CAAA,IAAA,CAAA,YAAA,EAAA,CACZ,QAET,WAAA,CAAYI,CAAAA,CAAsB,CAC3C,IAAA,CAAK,OAAA,CAAUA,EAChB,CASA,MAAA,EAAY,CACX,GAAI,KAAK,OAAA,CAAQ,EAAA,CAChB,OAAO,IAAA,CAAK,OAAA,CAAQ,MAErB,MAAI,IAAA,CAAK,OAAA,CAAQ,KAAA,YAAiB,MAC3B,IAAA,CAAK,OAAA,CAAQ,MAEd,IAAI,KAAA,CAAM,OAAO,IAAA,CAAK,OAAA,CAAQ,KAAK,CAAC,CAC3C,CAKA,QAAA,CAASO,CAAAA,CAAoB,CAC5B,OAAOD,CAAAA,CAAS,KAAK,OAAA,CAASC,CAAY,CAC3C,CAKA,aAAaJ,CAAAA,CAAwB,CACpC,OAAOK,CAAAA,CAAa,IAAA,CAAK,QAASL,CAAE,CACrC,CA6BA,KAAA,CACCO,EACAC,CAAAA,CACI,CACJ,OAAI,OAAOD,CAAAA,EAAmB,WACtBD,CAAAA,CAAM,IAAA,CAAK,OAAA,CAASC,CAAAA,CAAgBC,CAAM,CAAA,CAE3CF,CAAAA,CAAM,KAAK,OAAA,CAASC,CAAc,CAC1C,CA6BA,MAAM,WACLA,CAAAA,CAGAC,CAAAA,CACa,CACb,OAAI,OAAOD,GAAmB,UAAA,CACtBE,CAAAA,CAAW,KAAK,OAAA,CAASF,CAAAA,CAAgBC,CAAM,CAAA,CAEhDC,EAAW,IAAA,CAAK,OAAA,CAASF,CAAc,CAC/C,CAKA,MAA2B,CAC1B,OAAOX,CAAAA,CAAK,IAAA,CAAK,OAAO,CACzB,CAKA,OAA8B,CAC7B,OAAOE,EAAM,IAAA,CAAK,OAAO,CAC1B,CAKA,IAAI,MAAA,EAAuB,CAC1B,OAAO,IAAA,CAAK,OACb,CACD,CAAA,CAiBMqB,CAAAA,CAAN,MAAMC,CAAAA,SAAmBF,CAAqB,CA1K9C,OA0K8CzB,EAAA,IAAA,CAAA,SAAA,EAAA,CAC7C,WAAA,CAAYD,EAAU,CACrB,KAAA,CAAMD,CAAAA,CAAGC,CAAK,CAAC,EAChB,CAMA,OAAO,EAAA,CAAMA,CAAAA,CAAsB,CAClC,OAAO,IAAI4B,CAAAA,CAAQ5B,CAAK,CACzB,CAOA,OAAA,CAAcQ,EAA2D,CACxE,IAAMH,EAASE,CAAAA,CAAQ,IAAA,CAAK,OAAA,CAASC,CAAE,EACvC,OAAIH,CAAAA,CAAO,GACH,IAAIuB,CAAAA,CAAQvB,EAAO,KAAK,CAAA,CAEzB,IAAIwB,CAAAA,CAAUxB,CAAAA,CAAO,KAAK,CAClC,CAMA,IAAOG,CAAAA,CAAiC,CACvC,IAAMH,CAAAA,CAASI,CAAAA,CAAI,IAAA,CAAK,OAAA,CAASD,CAAE,CAAA,CACnC,GAAIH,EAAO,EAAA,CACV,OAAO,IAAIuB,CAAAA,CAAQvB,CAAAA,CAAO,KAAK,CAAA,CAGhC,MAAM,IAAI,KAAA,CAAM,iCAAiC,CAClD,CAMA,OAAUyB,CAAAA,CAAsC,CAC/C,OAAO,IACR,CACD,EAkBA,IAAMD,EAAN,MAAME,CAAAA,SAAqBL,CAAqB,CA1OhD,OA0OgDzB,CAAAA,CAAA,IAAA,CAAA,WAAA,EAAA,CAC/C,YAAYE,CAAAA,CAAU,CACrB,MAAMD,CAAAA,CAAIC,CAAK,CAAC,EACjB,CAMA,OAAO,EAAA,CAAMA,EAAwB,CACpC,OAAO,IAAI4B,CAAAA,CAAU5B,CAAK,CAC3B,CAOA,OAAA,CAAW2B,CAAAA,CAAmD,CAC7D,OAAO,IACR,CAMA,IAAOA,CAAAA,CAAwC,CAC9C,OAAO,IACR,CAMA,MAAA,CAAUtB,CAAAA,CAAmC,CAC5C,IAAMH,CAAAA,CAASK,EAAO,IAAA,CAAK,OAAA,CAASF,CAAE,CAAA,CACtC,GAAI,CAACH,CAAAA,CAAO,EAAA,CACX,OAAO,IAAI0B,CAAAA,CAAU1B,EAAO,KAAK,CAAA,CAGlC,MAAM,IAAI,KAAA,CAAM,mCAAmC,CACpD,CACD,EAsCO,IAAM2B,EAAN,MAAMC,CAAAA,SAAsBP,CAAiB,CA1TpD,OA0ToDzB,CAAAA,CAAA,iBAC3C,WAAA,CAAYI,CAAAA,CAAsB,CACzC,KAAA,CAAMA,CAAM,EACb,CAKA,OAAO,EAAA,CAAML,CAAAA,CAAsB,CAClC,OAAO,IAAI2B,EAAQ3B,CAAK,CACzB,CAKA,OAAO,GAAA,CAAOG,EAAwB,CACrC,OAAO,IAAI0B,CAAAA,CAAU1B,CAAK,CAC3B,CAKA,OAAO,KAAWE,CAAAA,CAAqC,CACtD,OAAO,IAAI4B,EAAQ5B,CAAM,CAC1B,CAEA,OAAA,CAAWG,CAAAA,CAA+C,CACzD,OAAOyB,CAAAA,CAAQ,KAAK1B,CAAAA,CAAQ,IAAA,CAAK,QAASC,CAAE,CAAC,CAC9C,CAEA,GAAA,CAAOA,EAAoC,CAC1C,OAAOyB,CAAAA,CAAQ,IAAA,CAAKxB,EAAI,IAAA,CAAK,OAAA,CAASD,CAAE,CAAC,CAC1C,CAEA,MAAA,CAAUA,CAAAA,CAAoC,CAC7C,OAAOyB,CAAAA,CAAQ,KAAKvB,CAAAA,CAAO,IAAA,CAAK,QAASF,CAAE,CAAC,CAC7C,CACD","file":"result.js","sourcesContent":["export type Ok<T> = { ok: true; value: T };\nexport type Err<E> = { ok: false; error: E };\nexport type Result<T, E> = Ok<T> | Err<E>;\n\n/**\n * Creates an Ok result with a value.\n *\n * @param value - The success value\n * @returns An Ok result containing the value\n *\n * @example\n * ```typescript\n * const result = ok(42);\n * // result is Ok<number>\n * ```\n */\nexport function ok<T>(value: T): Ok<T>;\n\n/**\n * Creates an Ok result with void (no value).\n *\n * @returns An Ok<void> result\n *\n * @example\n * ```typescript\n * const result = ok();\n * // result is Ok<void>\n * ```\n */\nexport function ok(): Ok<void>;\n\nexport function ok<T>(value?: T): Ok<T> {\n\treturn { ok: true, value: value as T };\n}\n\n/**\n * Creates an Err result with an error.\n *\n * @param error - The error value\n * @returns An Err result containing the error\n *\n * @example\n * ```typescript\n * const result = err(\"Something went wrong\");\n * // result is Err<string>\n * ```\n */\nexport function err<E>(error: E): Err<E>;\n\n/**\n * Creates an Err result with void (no error value).\n *\n * @returns An Err<void> result\n *\n * @example\n * ```typescript\n * const result = err();\n * // result is Err<void>\n * ```\n */\nexport function err(): Err<void>;\n\nexport function err<E>(error?: E): Err<E> {\n\treturn { ok: false, error: error as E };\n}\n\n/**\n * Type guard to check if a Result is Ok.\n * Narrows the type to Ok<T> when returning true.\n *\n * @param result - The result to check\n * @returns true if the result is Ok, false otherwise\n *\n * @example\n * ```typescript\n * const result = voWithValidation(data, validator);\n * if (isOk(result)) {\n *   // TypeScript knows result is Ok<VO<T>>\n *   console.log(result.value);\n * }\n * ```\n */\nexport function isOk<T, E>(result: Result<T, E>): result is Ok<T> {\n\treturn result.ok === true;\n}\n\n/**\n * Type guard to check if a Result is Err.\n * Narrows the type to Err<E> when returning true.\n *\n * @param result - The result to check\n * @returns true if the result is Err, false otherwise\n *\n * @example\n * ```typescript\n * const result = voWithValidation(data, validator);\n * if (isErr(result)) {\n *   // TypeScript knows result is Err<string>\n *   console.error(result.error);\n * }\n * ```\n */\nexport function isErr<T, E>(result: Result<T, E>): result is Err<E> {\n\treturn result.ok === false;\n}\n\n/**\n * Chains Result operations (flatMap/bind).\n * If the result is Ok, applies the function to the value.\n * If Err, returns the error unchanged.\n *\n * @param result - The result to chain\n * @param fn - Function that takes the Ok value and returns a new Result\n * @returns A new Result\n *\n * @example\n * ```typescript\n * const result = validateUserId(\"123\")\n *   .andThen(userId => validateEmail(\"test@example.com\")\n *     .map(email => ({ id: userId, email }))\n *   );\n * ```\n */\nexport function andThen<T, E, U>(\n\tresult: Result<T, E>,\n\tfn: (value: T) => Result<U, E>,\n): Result<U, E> {\n\tif (result.ok) {\n\t\treturn fn(result.value);\n\t}\n\treturn result;\n}\n\n/**\n * Transforms the Ok value using a function.\n * If the result is Err, returns the error unchanged.\n *\n * @param result - The result to transform\n * @param fn - Function to transform the Ok value\n * @returns A new Result with transformed value\n *\n * @example\n * ```typescript\n * const result = ok(5);\n * const doubled = map(result, x => x * 2); // Ok<10>\n * ```\n */\nexport function map<T, E, U>(\n\tresult: Result<T, E>,\n\tfn: (value: T) => U,\n): Result<U, E> {\n\tif (result.ok) {\n\t\treturn ok(fn(result.value));\n\t}\n\treturn result;\n}\n\n/**\n * Transforms the Err value using a function.\n * If the result is Ok, returns the value unchanged.\n *\n * @param result - The result to transform\n * @param fn - Function to transform the Err value\n * @returns A new Result with transformed error\n *\n * @example\n * ```typescript\n * const result = err(\"not found\");\n * const mapped = mapErr(result, e => `Error: ${e}`); // Err<\"Error: not found\">\n * ```\n */\nexport function mapErr<T, E, F>(\n\tresult: Result<T, E>,\n\tfn: (error: E) => F,\n): Result<T, F> {\n\tif (result.ok) {\n\t\treturn result;\n\t}\n\treturn err(fn(result.error));\n}\n\n/**\n * Returns the value if Ok, otherwise returns the default value.\n *\n * @param result - The result to unwrap\n * @param defaultValue - Default value to return if Err\n * @returns The Ok value or the default value\n *\n * @example\n * ```typescript\n * const result = validateUserId(\"123\");\n * const userId = unwrapOr(result, \"default-id\");\n * ```\n */\nexport function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T {\n\treturn result.ok ? result.value : defaultValue;\n}\n\n/**\n * Returns the value if Ok, otherwise computes default from error.\n *\n * @param result - The result to unwrap\n * @param fn - Function to compute default from error\n * @returns The Ok value or computed default\n *\n * @example\n * ```typescript\n * const result = validateUserId(\"\");\n * const userId = unwrapOrElse(result, err => `fallback-${Date.now()}`);\n * ```\n */\nexport function unwrapOrElse<T, E>(\n\tresult: Result<T, E>,\n\tfn: (error: E) => T,\n): T {\n\treturn result.ok ? result.value : fn(result.error);\n}\n\n/**\n * Pattern matching for Result.\n * Applies one function if Ok, another if Err.\n *\n * @param result - The result to match\n * @param onOk - Function to apply if Ok\n * @param onErr - Function to apply if Err\n * @returns The result of applying the appropriate function\n *\n * @example\n * ```typescript\n * const message = match(result,\n *   value => `Success: ${value}`,\n *   error => `Error: ${error}`\n * );\n * ```\n *\n * @example Using object syntax\n * ```typescript\n * const message = match(result, {\n *   ok: value => `Success: ${value}`,\n *   err: error => `Error: ${error}`\n * });\n * ```\n */\nexport function match<T, E, R>(\n\tresult: Result<T, E>,\n\tonOk: (value: T) => R,\n\tonErr: (error: E) => R,\n): R;\nexport function match<T, E, R>(\n\tresult: Result<T, E>,\n\thandlers: { ok: (value: T) => R; err: (error: E) => R },\n): R;\nexport function match<T, E, R>(\n\tresult: Result<T, E>,\n\tonOkOrHandlers: ((value: T) => R) | { ok: (value: T) => R; err: (error: E) => R },\n\tonErr?: (error: E) => R,\n): R {\n\tif (typeof onOkOrHandlers === \"function\") {\n\t\t// Function syntax: match(result, onOk, onErr)\n\t\treturn result.ok ? onOkOrHandlers(result.value) : onErr!(result.error);\n\t}\n\t// Object syntax: match(result, { ok: ..., err: ... })\n\treturn result.ok\n\t\t? onOkOrHandlers.ok(result.value)\n\t\t: onOkOrHandlers.err(result.error);\n}\n\n/**\n * Async pattern matching for Result.\n * Applies one async function if Ok, another if Err.\n * Both handlers must return Promises.\n *\n * @param result - The result to match\n * @param onOk - Async function to apply if Ok\n * @param onErr - Async function to apply if Err\n * @returns Promise resolving to the result of applying the appropriate function\n *\n * @example\n * ```typescript\n * const message = await matchAsync(result,\n *   async (value) => `Success: ${value}`,\n *   async (error) => `Error: ${error}`\n * );\n * ```\n *\n * @example Using object syntax\n * ```typescript\n * const message = await matchAsync(result, {\n *   ok: async (value) => `Success: ${value}`,\n *   err: async (error) => `Error: ${error}`\n * });\n * ```\n */\nexport async function matchAsync<T, E, R>(\n\tresult: Result<T, E>,\n\tonOk: (value: T) => Promise<R>,\n\tonErr: (error: E) => Promise<R>,\n): Promise<R>;\nexport async function matchAsync<T, E, R>(\n\tresult: Result<T, E>,\n\thandlers: { ok: (value: T) => Promise<R>; err: (error: E) => Promise<R> },\n): Promise<R>;\nexport async function matchAsync<T, E, R>(\n\tresult: Result<T, E>,\n\tonOkOrHandlers:\n\t\t| ((value: T) => Promise<R>)\n\t\t| { ok: (value: T) => Promise<R>; err: (error: E) => Promise<R> },\n\tonErr?: (error: E) => Promise<R>,\n): Promise<R> {\n\tif (typeof onOkOrHandlers === \"function\") {\n\t\t// Function syntax: matchAsync(result, onOk, onErr)\n\t\treturn result.ok\n\t\t\t? onOkOrHandlers(result.value)\n\t\t\t: onErr!(result.error);\n\t}\n\t// Object syntax: matchAsync(result, { ok: ..., err: ... })\n\treturn result.ok\n\t\t? onOkOrHandlers.ok(result.value)\n\t\t: onOkOrHandlers.err(result.error);\n}\n\n/**\n * Pattern matching for Result that returns a Result.\n * Both handlers must return a Result, allowing you to transform\n * both the success and error cases while staying in Result context.\n *\n * @param result - The result to match\n * @param handlers - Object with ok and err handlers, both returning Result\n * @returns A new Result from the appropriate handler\n *\n * @example\n * ```typescript\n * const result = await fetchUser(id);\n * return matchResult(result, {\n *   ok: (user) => ok(transformUser(user)),\n *   err: (error) => err(mapToAppError(error))\n * });\n * ```\n */\nexport function matchResult<T, E, U, F>(\n\tresult: Result<T, E>,\n\thandlers: {\n\t\tok: (value: T) => Result<U, F>;\n\t\terr: (error: E) => Result<U, F>;\n\t},\n): Result<U, F>;\nexport function matchResult<T, E, U, F>(\n\tresult: Result<T, E>,\n\tonOk: (value: T) => Result<U, F>,\n\tonErr: (error: E) => Result<U, F>,\n): Result<U, F>;\nexport function matchResult<T, E, U, F>(\n\tresult: Result<T, E>,\n\tonOkOrHandlers:\n\t\t| ((value: T) => Result<U, F>)\n\t\t| { ok: (value: T) => Result<U, F>; err: (error: E) => Result<U, F> },\n\tonErr?: (error: E) => Result<U, F>,\n): Result<U, F> {\n\tif (typeof onOkOrHandlers === \"function\") {\n\t\treturn result.ok ? onOkOrHandlers(result.value) : onErr!(result.error);\n\t}\n\treturn result.ok\n\t\t? onOkOrHandlers.ok(result.value)\n\t\t: onOkOrHandlers.err(result.error);\n}\n\n/**\n * Pipes a Result through multiple operations.\n * Each function receives the previous Result and returns a new Result.\n * Stops on first error.\n *\n * @param initial - The initial Result value\n * @param fns - Array of functions that take the previous Result and return a new Result\n * @returns The final Result after all operations\n *\n * @example\n * ```typescript\n * // Instead of nested andThen calls:\n * andThen(\n *   updateCountryCode(code),\n *   () => andThen(updateCurrencyCode(currency), () => updateLanguageCode(lang))\n * )\n *\n * // Use pipe (cleaner and more readable):\n * pipe(\n *   updateCountryCode(code),\n *   () => updateCurrencyCode(currency),\n *   () => updateLanguageCode(lang)\n * )\n * ```\n *\n * @example With void results\n * ```typescript\n * setInitialData(initialData: JobConfigProps[\"initialData\"]): Result<void, JobDomainError> {\n *   return pipe(\n *     this.updateCountryCode(initialData.countryCode),\n *     () => this.updateCurrencyCode(initialData.currencyCode),\n *     () => this.updateLanguageCode(initialData.languageCode)\n *   );\n * }\n * ```\n */\nexport function pipe<T, E>(\n\tinitial: Result<T, E>,\n\t...fns: Array<(prev: Result<T, E>) => Result<T, E>>\n): Result<T, E> {\n\tlet current = initial;\n\tfor (const fn of fns) {\n\t\tcurrent = fn(current);\n\t\tif (!current.ok) {\n\t\t\treturn current;\n\t\t}\n\t}\n\treturn current;\n}\n\n/**\n * Wraps a function that may throw exceptions into a Result type.\n * Catches any thrown exceptions and converts them to Err results.\n *\n * @param fn - Function that may throw exceptions\n * @param errorMapper - Optional function to transform the caught error\n * @returns A Result containing the function's return value or error\n *\n * @example\n * ```typescript\n * function riskyOperation(): string {\n *   if (Math.random() > 0.5) {\n *     throw new Error(\"Something went wrong\");\n *   }\n *   return \"success\";\n * }\n *\n * const result = tryCatch(() => riskyOperation());\n * if (result.ok) {\n *   console.log(result.value); // \"success\"\n * } else {\n *   console.error(result.error.message); // \"Something went wrong\"\n * }\n * ```\n *\n * @example With custom error mapper\n * ```typescript\n * const result = tryCatch(\n *   () => riskyOperation(),\n *   (error) => `Custom: ${error instanceof Error ? error.message : String(error)}`\n * );\n * ```\n */\nexport function tryCatch<T, E = Error>(\n\tfn: () => T,\n\terrorMapper?: (error: unknown) => E,\n): Result<T, E> {\n\ttry {\n\t\treturn ok(fn());\n\t} catch (error) {\n\t\tif (errorMapper) {\n\t\t\treturn err(errorMapper(error));\n\t\t}\n\t\treturn err((error instanceof Error ? error : new Error(String(error))) as E);\n\t}\n}\n\n/**\n * Wraps an async function that may throw exceptions into a Promise<Result>.\n * Catches any thrown exceptions and converts them to Err results.\n *\n * @param fn - Async function that may throw exceptions\n * @param errorMapper - Optional function to transform the caught error\n * @returns A Promise resolving to a Result containing the function's return value or error\n *\n * @example\n * ```typescript\n * async function riskyAsyncOperation(): Promise<string> {\n *   if (Math.random() > 0.5) {\n *     throw new Error(\"Something went wrong\");\n *   }\n *   return \"success\";\n * }\n *\n * const result = await tryCatchAsync(() => riskyAsyncOperation());\n * if (result.ok) {\n *   console.log(result.value); // \"success\"\n * } else {\n *   console.error(result.error.message); // \"Something went wrong\"\n * }\n * ```\n */\nexport async function tryCatchAsync<T, E = Error>(\n\tfn: () => Promise<T>,\n\terrorMapper?: (error: unknown) => E,\n): Promise<Result<T, E>> {\n\ttry {\n\t\tconst value = await fn();\n\t\treturn ok(value);\n\t} catch (error) {\n\t\tif (errorMapper) {\n\t\t\treturn err(errorMapper(error));\n\t\t}\n\t\treturn err((error instanceof Error ? error : new Error(String(error))) as E);\n\t}\n}\n\n","import {\n    andThen,\n    err,\n    isErr,\n    isOk,\n    map,\n    mapErr,\n    match,\n    matchAsync,\n    ok,\n    type Result,\n    unwrapOr,\n    unwrapOrElse,\n} from \"./result\";\n\n/**\n * Base class for Result with method chaining support.\n * Provides common methods for both Ok and Err classes.\n */\nabstract class ResultBase<T, E> {\n\tprotected readonly _result: Result<T, E>;\n\n\tprotected constructor(result: Result<T, E>) {\n\t\tthis._result = result;\n\t}\n\n\t/**\n\t * Returns the value if Ok, otherwise throws an error.\n\t * If error is an Error instance, throws it directly.\n\t * Otherwise, wraps the error in a new Error.\n\t *\n\t * @throws Error if the result is Err\n\t */\n\tunwrap(): T {\n\t\tif (this._result.ok) {\n\t\t\treturn this._result.value;\n\t\t}\n\t\tif (this._result.error instanceof Error) {\n\t\t\tthrow this._result.error;\n\t\t}\n\t\tthrow new Error(String(this._result.error));\n\t}\n\n\t/**\n\t * Returns the value if Ok, otherwise returns the default value.\n\t */\n\tunwrapOr(defaultValue: T): T {\n\t\treturn unwrapOr(this._result, defaultValue);\n\t}\n\n\t/**\n\t * Returns the value if Ok, otherwise computes default from error.\n\t */\n\tunwrapOrElse(fn: (error: E) => T): T {\n\t\treturn unwrapOrElse(this._result, fn);\n\t}\n\n\t/**\n\t * Pattern matching for Result.\n\t * Applies one function if Ok, another if Err.\n\t *\n\t * @example\n\t * ```typescript\n\t * outcome.match(\n\t *   value => `Success: ${value}`,\n\t *   error => `Error: ${error}`\n\t * );\n\t * ```\n\t *\n\t * @example Using object syntax\n\t * ```typescript\n\t * outcome.match({\n\t *   ok: value => `Success: ${value}`,\n\t *   err: error => `Error: ${error}`\n\t * });\n\t * ```\n\t */\n\tmatch<R>(\n\t\tonOk: (value: T) => R,\n\t\tonErr: (error: E) => R,\n\t): R;\n\tmatch<R>(\n\t\thandlers: { ok: (value: T) => R; err: (error: E) => R },\n\t): R;\n\tmatch<R>(\n\t\tonOkOrHandlers: ((value: T) => R) | { ok: (value: T) => R; err: (error: E) => R },\n\t\tonErr?: (error: E) => R,\n\t): R {\n\t\tif (typeof onOkOrHandlers === \"function\") {\n\t\t\treturn match(this._result, onOkOrHandlers, onErr!);\n\t\t}\n\t\treturn match(this._result, onOkOrHandlers);\n\t}\n\n\t/**\n\t * Async pattern matching for Result.\n\t * Applies one async function if Ok, another if Err.\n\t *\n\t * @example\n\t * ```typescript\n\t * await outcome.matchAsync(\n\t *   async (value) => `Success: ${value}`,\n\t *   async (error) => `Error: ${error}`\n\t * );\n\t * ```\n\t *\n\t * @example Using object syntax\n\t * ```typescript\n\t * await outcome.matchAsync({\n\t *   ok: async (value) => `Success: ${value}`,\n\t *   err: async (error) => `Error: ${error}`\n\t * });\n\t * ```\n\t */\n\tmatchAsync<R>(\n\t\tonOk: (value: T) => Promise<R>,\n\t\tonErr: (error: E) => Promise<R>,\n\t): Promise<R>;\n\tmatchAsync<R>(\n\t\thandlers: { ok: (value: T) => Promise<R>; err: (error: E) => Promise<R> },\n\t): Promise<R>;\n\tasync matchAsync<R>(\n\t\tonOkOrHandlers:\n\t\t\t| ((value: T) => Promise<R>)\n\t\t\t| { ok: (value: T) => Promise<R>; err: (error: E) => Promise<R> },\n\t\tonErr?: (error: E) => Promise<R>,\n\t): Promise<R> {\n\t\tif (typeof onOkOrHandlers === \"function\") {\n\t\t\treturn matchAsync(this._result, onOkOrHandlers, onErr!);\n\t\t}\n\t\treturn matchAsync(this._result, onOkOrHandlers);\n\t}\n\n\t/**\n\t * Type guard to check if the result is Ok.\n\t */\n\tisOk(): this is Success<T> {\n\t\treturn isOk(this._result);\n\t}\n\n\t/**\n\t * Type guard to check if the result is Err.\n\t */\n\tisErr(): this is Erroneous<E> {\n\t\treturn isErr(this._result);\n\t}\n\n\t/**\n\t * Gets the underlying Result value.\n\t */\n\tget result(): Result<T, E> {\n\t\treturn this._result;\n\t}\n}\n\n/**\n * Class representing a successful result with method chaining support.\n * Use this for class-based API with method chaining.\n *\n * @example\n * ```typescript\n * const okResult = Ok(1);\n * const doubled = okResult.map(x => x * 2).unwrap(); // 2\n *\n * const chained = Ok(5)\n *   .andThen(x => Ok(x * 2))\n *   .map(x => x + 1)\n *   .unwrap(); // 11\n * ```\n */\nclass Success<T> extends ResultBase<T, never> {\n\tconstructor(value: T) {\n\t\tsuper(ok(value));\n\t}\n\n\t/**\n\t * Factory function to create an Ok instance.\n\t * Can be called with or without `new`.\n\t */\n\tstatic of<T>(value: T): Success<T> {\n\t\treturn new Success(value);\n\t}\n\n\t/**\n\t * Chains Result operations (flatMap/bind).\n\t * If the result is Ok, applies the function to the value.\n\t * If Err, returns the error unchanged.\n\t */\n\tandThen<U, E>(fn: (value: T) => Result<U, E>): Success<U> | Erroneous<E> {\n\t\tconst result = andThen(this._result, fn);\n\t\tif (result.ok) {\n\t\t\treturn new Success(result.value);\n\t\t}\n\t\treturn new Erroneous(result.error);\n\t}\n\n\t/**\n\t * Transforms the Ok value using a function.\n\t * If the result is Err, returns the error unchanged.\n\t */\n\tmap<U>(fn: (value: T) => U): Success<U> {\n\t\tconst result = map(this._result, fn);\n\t\tif (result.ok) {\n\t\t\treturn new Success(result.value);\n\t\t}\n\t\t// This should never happen for Success, but TypeScript needs it\n\t\tthrow new Error(\"Unexpected error in Success.map\");\n\t}\n\n\t/**\n\t * Transforms the Err value using a function.\n\t * If the result is Ok, returns the value unchanged.\n\t */\n\tmapErr<F>(_fn: (error: never) => F): Success<T> {\n\t\treturn this;\n\t}\n}\n\nexport { Success };\n\n/**\n * Class representing an erroneous result with method chaining support.\n * Use this for class-based API with method chaining.\n *\n * @example\n * ```typescript\n * const errResult = Err(new Error(\"error\"));\n * errResult.map(x => x * 2).unwrap(); // throws Error(\"error\")\n *\n * const mapped = Err(\"original\")\n *   .mapErr(e => `Error: ${e}`)\n *   .unwrap(); // throws Error(\"Error: original\")\n * ```\n */\nclass Erroneous<E> extends ResultBase<never, E> {\n\tconstructor(error: E) {\n\t\tsuper(err(error));\n\t}\n\n\t/**\n\t * Factory function to create an Err instance.\n\t * Can be called with or without `new`.\n\t */\n\tstatic of<E>(error: E): Erroneous<E> {\n\t\treturn new Erroneous(error);\n\t}\n\n\t/**\n\t * Chains Result operations (flatMap/bind).\n\t * If the result is Ok, applies the function to the value.\n\t * If Err, returns the error unchanged.\n\t */\n\tandThen<U>(_fn: (value: never) => Result<U, E>): Erroneous<E> {\n\t\treturn this;\n\t}\n\n\t/**\n\t * Transforms the Ok value using a function.\n\t * If the result is Err, returns the error unchanged.\n\t */\n\tmap<U>(_fn: (value: never) => U): Erroneous<E> {\n\t\treturn this;\n\t}\n\n\t/**\n\t * Transforms the Err value using a function.\n\t * If the result is Ok, returns the value unchanged.\n\t */\n\tmapErr<F>(fn: (error: E) => F): Erroneous<F> {\n\t\tconst result = mapErr(this._result, fn);\n\t\tif (!result.ok) {\n\t\t\treturn new Erroneous(result.error);\n\t\t}\n\t\t// This should never happen for Erroneous, but TypeScript needs it\n\t\tthrow new Error(\"Unexpected ok in Erroneous.mapErr\");\n\t}\n}\n\nexport { Erroneous };\n\n/**\n * Factory functions for creating Ok and Err instances.\n * These can be called without `new` for a more functional style.\n *\n * @example\n * ```typescript\n * const okResult = Ok(1);\n * const errResult = Err(\"error\");\n * ```\n */\nexport function Ok<T>(value: T): Success<T> {\n\treturn new Success(value);\n}\n\nexport function Err<E>(error: E): Erroneous<E> {\n\treturn new Erroneous(error);\n}\n\n/**\n * Class-based API for Result with method chaining support.\n * Provides an object-oriented alternative to the functional Result type.\n * Use `Outcome.from()` to wrap an existing Result, or `Outcome.ok()` / `Outcome.err()` to create new instances.\n *\n * @example\n * ```typescript\n * // Wrap an existing Result\n * const result = Outcome.from(ok(1));\n * const doubled = result.map(x => x * 2).unwrap(); // 2\n *\n * // Create directly\n * const outcome = Outcome.ok(42);\n * const value = outcome.map(x => x + 1).unwrap(); // 43\n * ```\n */\nexport class Outcome<T, E> extends ResultBase<T, E> {\n\tprivate constructor(result: Result<T, E>) {\n\t\tsuper(result);\n\t}\n\n\t/**\n\t * Creates an Outcome from an Ok value.\n\t */\n\tstatic ok<T>(value: T): Success<T> {\n\t\treturn new Success(value);\n\t}\n\n\t/**\n\t * Creates an Outcome from an Err value.\n\t */\n\tstatic err<E>(error: E): Erroneous<E> {\n\t\treturn new Erroneous(error);\n\t}\n\n\t/**\n\t * Creates an Outcome from a Result.\n\t */\n\tstatic from<T, E>(result: Result<T, E>): Outcome<T, E> {\n\t\treturn new Outcome(result);\n\t}\n\n\tandThen<U>(fn: (value: T) => Result<U, E>): Outcome<U, E> {\n\t\treturn Outcome.from(andThen(this._result, fn));\n\t}\n\n\tmap<U>(fn: (value: T) => U): Outcome<U, E> {\n\t\treturn Outcome.from(map(this._result, fn));\n\t}\n\n\tmapErr<F>(fn: (error: E) => F): Outcome<T, F> {\n\t\treturn Outcome.from(mapErr(this._result, fn));\n\t}\n}\n\n"]}

package/dist/utils-array.d.ts

@@ -0,0 +1,47 @@
+export { a as DeepEqualExceptOptions, D as DeepOmitOptions, K as Key, P as PathSegment, b as deepEqualExcept, d as deepOmit } from './deep-equal-except-C8yoSk4L.js';
+
+/**
+ * Performs a deep equality check between two values.
+ *
+ * This function compares values recursively, handling:
+ * - Primitives (with special handling for NaN)
+ * - Arrays (nested arrays supported)
+ * - Objects (plain objects and class instances)
+ * - TypedArrays (Uint8Array, Int32Array, etc.)
+ * - DataView
+ * - Maps and Sets
+ * - Dates and RegExp
+ * - Wrapper objects (Boolean, Number, String)
+ * - Circular references (detected and handled)
+ *
+ * @param a - The first value to compare
+ * @param b - The second value to compare
+ * @returns `true` if the values are deeply equal, `false` otherwise
+ *
+ * @example
+ * ```ts
+ * deepEqual([1, 2, 3], [1, 2, 3]); // true
+ * deepEqual({ a: 1, b: [2, 3] }, { a: 1, b: [2, 3] }); // true
+ * deepEqual(NaN, NaN); // true
+ * deepEqual([1, 2], [1, 2, 3]); // false
+ * ```
+ */
+declare function deepEqual(a: unknown, b: unknown): boolean;
+
+/**
+ * Checks if an object is a built-in JavaScript type that should be treated atomically.
+ * This function automatically detects built-ins without requiring manual maintenance.
+ *
+ * Detection strategy:
+ * 1. TypedArrays: Check if tag ends with "Array]" (covers all current and future TypedArrays)
+ * 2. ArrayBuffer views: Use ArrayBuffer.isView() (covers DataView and all TypedArrays)
+ * 3. Built-in constructors: Check if constructor exists in global scope and matches known patterns
+ * 4. Tag-based: Fallback to tag matching for known built-ins
+ *
+ * @param obj - The object to check
+ * @param tag - The result of `Object.prototype.toString.call(obj)`
+ * @returns `true` if the object is a built-in type, `false` otherwise
+ */
+declare function isBuiltInObject(obj: object, tag: string): boolean;
+
+export { deepEqual, isBuiltInObject };

package/dist/utils-array.js

@@ -0,0 +1,2 @@
+var K=Object.defineProperty;var l=(t,o)=>K(t,"name",{value:o,configurable:true});function j(t,o){if(o.endsWith("Array]")||ArrayBuffer.isView(t)||o==="[object ArrayBuffer]"||o==="[object SharedArrayBuffer]")return  true;let n=t.constructor;if(n&&typeof n=="function"){let y=n.name;if(y&&typeof globalThis<"u"&&y in globalThis&&globalThis[y]===n){let e=Object.getPrototypeOf(t);if(e!==Object.prototype&&e!==null)return  true}}return new Set(["[object Date]","[object RegExp]","[object Map]","[object Set]","[object WeakMap]","[object WeakSet]","[object Promise]","[object Error]","[object Boolean]","[object Number]","[object String]"]).has(o)}l(j,"isBuiltInObject");var d=Object.prototype,O=d.toString,P=d.hasOwnProperty;function x(t,o){return m(t,o,new WeakMap)}l(x,"deepEqual");function m(t,o,n){if(t===o)return  true;let i=typeof t,y=typeof o;if(i!=="object"||t===null||y!=="object"||o===null)return i==="number"&&y==="number"?Number.isNaN(t)&&Number.isNaN(o):false;let e=t,r=o,g=n.get(e);if(g!==void 0)return g===r;if(n.set(e,r),ArrayBuffer.isView(e)||ArrayBuffer.isView(r)){if(!ArrayBuffer.isView(e)||!ArrayBuffer.isView(r))return  false;let a=O.call(e),c=O.call(r);if(a!==c)return  false;if(a==="[object DataView]"){let p=e,h=r;if(p.byteLength!==h.byteLength)return  false;let S=p.byteLength;for(let k=0;k<S;k++)if(p.getUint8(k)!==h.getUint8(k))return  false;return  true}let s=e,f=r,u=s.length;if(u!==f.length)return  false;for(let p=0;p<u;p++)if(s[p]!==f[p])return  false;return  true}let b=O.call(e),w=O.call(r);if(b!==w)return  false;switch(b){case "[object Array]":{let a=e,c=r,s=a.length;if(s!==c.length)return  false;for(let f=0;f<s;f++)if(!m(a[f],c[f],n))return  false;return  true}case "[object Map]":{let a=e,c=r;if(a.size!==c.size)return  false;for(let[s,f]of a){if(!c.has(s))return  false;let u=c.get(s);if(!m(f,u,n))return  false}return  true}case "[object Set]":{let a=e,c=r;if(a.size!==c.size)return  false;for(let s of a)if(!c.has(s))return  false;return  true}case "[object Date]":{let a=e.getTime(),c=r.getTime();return a===c}case "[object RegExp]":{let a=e,c=r;return a.source===c.source&&a.flags===c.flags}case "[object Boolean]":case "[object Number]":case "[object String]":return e.valueOf()===r.valueOf();default:{if(j(e,b)&&j(r,w))return e===r;let a=Object.keys(e),c=Object.keys(r),s=Object.getOwnPropertySymbols(e),f=Object.getOwnPropertySymbols(r);if(a.length!==c.length||s.length!==f.length)return  false;for(let u of a)if(!P.call(r,u))return  false;for(let u of s)if(!Object.getOwnPropertySymbols(r).includes(u))return  false;for(let u of a)if(!m(e[u],r[u],n))return  false;for(let u of s)if(!m(e[u],r[u],n))return  false;return  true}}}l(m,"deepEqualInner");function A(t,o){return B(t,o,[],new WeakMap)}l(A,"deepOmit");function B(t,o,n,i){if(t===null||typeof t!=="object")return t;let e=t,r=i.get(e);if(r!==void 0)return r;let g=Object.prototype.toString.call(e);if(g==="[object Array]"){let s=e,f=new Array(s.length);i.set(e,f);for(let u=0;u<s.length;u++)n.push(u),f[u]=B(s[u],o,n,i),n.pop();return f}if(j(e,g))return t;let b=Object.create(Object.getPrototypeOf(e));i.set(e,b);let w=Object.keys(e),a=Object.getOwnPropertySymbols(e),c=[...w,...a];for(let s of c)D(s,n,o)||(n.push(s),b[s]=B(e[s],o,n,i),n.pop());return b}l(B,"omitInternal");function D(t,o,n){return !!(n.ignoreKeys?.includes(t)||n.ignoreKeyPredicate?.(t,o))}l(D,"shouldIgnoreKey");function U(t,o,n){let i=A(t,n),y=A(o,n);return x(i,y)}l(U,"deepEqualExcept");export{x as deepEqual,U as deepEqualExcept,A as deepOmit,j as isBuiltInObject};//# sourceMappingURL=utils-array.js.map
+//# sourceMappingURL=utils-array.js.map

package/dist/utils-array.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/array/is-built-in.ts","../src/utils/array/deep-equal.ts","../src/utils/array/deep-omit.ts","../src/utils/array/deep-equal-except.ts"],"names":["isBuiltInObject","obj","tag","objConstructor","constructorName","proto","__name","objProto","objToString","objHasOwn","deepEqual","a","b","deepEqualInner","visited","typeA","typeB","objA","objB","cached","tagA","tagB","viewA","viewB","len","i","arrA","arrB","mapA","mapB","key","valA","valB","setA","setB","value","timeA","timeB","regA","regB","stringKeysA","stringKeysB","symbolKeysA","symbolKeysB","deepOmit","options","omitInternal","path","arr","clone","stringKeys","symbolKeys","keys","shouldIgnoreKey","deepEqualExcept","prunedA","prunedB"],"mappings":"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","file":"utils-array.js","sourcesContent":["/**\n * Checks if an object is a built-in JavaScript type that should be treated atomically.\n * This function automatically detects built-ins without requiring manual maintenance.\n *\n * Detection strategy:\n * 1. TypedArrays: Check if tag ends with \"Array]\" (covers all current and future TypedArrays)\n * 2. ArrayBuffer views: Use ArrayBuffer.isView() (covers DataView and all TypedArrays)\n * 3. Built-in constructors: Check if constructor exists in global scope and matches known patterns\n * 4. Tag-based: Fallback to tag matching for known built-ins\n *\n * @param obj - The object to check\n * @param tag - The result of `Object.prototype.toString.call(obj)`\n * @returns `true` if the object is a built-in type, `false` otherwise\n */\nexport function isBuiltInObject(obj: object, tag: string): boolean {\n\t// 1. TypedArrays: all end with \"Array]\" - future-proof for new TypedArrays\n\tif (tag.endsWith(\"Array]\")) {\n\t\treturn true;\n\t}\n\n\t// 2. ArrayBuffer views: covers DataView and all TypedArrays (future-proof)\n\tif (ArrayBuffer.isView(obj)) {\n\t\treturn true;\n\t}\n\n\t// 3. ArrayBuffer and SharedArrayBuffer\n\tif (tag === \"[object ArrayBuffer]\" || tag === \"[object SharedArrayBuffer]\") {\n\t\treturn true;\n\t}\n\n\t// 4. Check if constructor exists in global scope (future-proof for new globals)\n\tconst objConstructor = (obj as { constructor?: unknown }).constructor;\n\tif (objConstructor && typeof objConstructor === \"function\") {\n\t\tconst constructorName = objConstructor.name;\n\t\t// Check if it's a known global constructor\n\t\t// This covers: Date, RegExp, Map, Set, WeakMap, WeakSet, Promise, Error, etc.\n\t\tif (\n\t\t\tconstructorName &&\n\t\t\ttypeof globalThis !== \"undefined\" &&\n\t\t\tconstructorName in globalThis &&\n\t\t\t(globalThis as Record<string, unknown>)[constructorName] === objConstructor\n\t\t) {\n\t\t\t// Additional check: ensure it's not a user-defined class with same name\n\t\t\t// Built-ins typically have non-enumerable properties and specific prototypes\n\t\t\tconst proto = Object.getPrototypeOf(obj);\n\t\t\tif (proto !== Object.prototype && proto !== null) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\t}\n\n\t// 5. Tag-based fallback for known built-ins (covers edge cases)\n\tconst knownBuiltInTags = new Set([\n\t\t\"[object Date]\",\n\t\t\"[object RegExp]\",\n\t\t\"[object Map]\",\n\t\t\"[object Set]\",\n\t\t\"[object WeakMap]\",\n\t\t\"[object WeakSet]\",\n\t\t\"[object Promise]\",\n\t\t\"[object Error]\",\n\t\t\"[object Boolean]\",\n\t\t\"[object Number]\",\n\t\t\"[object String]\",\n\t]);\n\n\treturn knownBuiltInTags.has(tag);\n}\n\n","import { isBuiltInObject } from \"./is-built-in\";\n\nconst objProto = Object.prototype;\nconst objToString = objProto.toString;\nconst objHasOwn = objProto.hasOwnProperty;\n\n/**\n * Performs a deep equality check between two values.\n *\n * This function compares values recursively, handling:\n * - Primitives (with special handling for NaN)\n * - Arrays (nested arrays supported)\n * - Objects (plain objects and class instances)\n * - TypedArrays (Uint8Array, Int32Array, etc.)\n * - DataView\n * - Maps and Sets\n * - Dates and RegExp\n * - Wrapper objects (Boolean, Number, String)\n * - Circular references (detected and handled)\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if the values are deeply equal, `false` otherwise\n *\n * @example\n * ```ts\n * deepEqual([1, 2, 3], [1, 2, 3]); // true\n * deepEqual({ a: 1, b: [2, 3] }, { a: 1, b: [2, 3] }); // true\n * deepEqual(NaN, NaN); // true\n * deepEqual([1, 2], [1, 2, 3]); // false\n * ```\n */\nexport function deepEqual(a: unknown, b: unknown): boolean {\n\treturn deepEqualInner(a, b, new WeakMap<object, object>());\n}\n\n/**\n * Internal recursive function for deep equality comparison.\n * Tracks visited objects to detect and handle circular references.\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @param visited - WeakMap to track visited object pairs and detect cycles\n * @returns `true` if the values are deeply equal, `false` otherwise\n * @internal\n */\nfunction deepEqualInner(\n\ta: unknown,\n\tb: unknown,\n\tvisited: WeakMap<object, object>\n): boolean {\n\t// 1. Fast path: reference equality\n\tif (a === b) return true;\n\n\tconst typeA = typeof a;\n\tconst typeB = typeof b;\n\n\t// 2. If one is not an object → primitive / function\n\tif (typeA !== \"object\" || a === null || typeB !== \"object\" || b === null) {\n\t\t// Special case: NaN should be equal\n\t\tif (typeA === \"number\" && typeB === \"number\") {\n\t\t\treturn Number.isNaN(a as number) && Number.isNaN(b as number);\n\t\t}\n\t\t// Everything else is directly unequal with !== (including functions)\n\t\treturn false;\n\t}\n\n\t// From here on: both are non-null objects\n\n\tconst objA = a as object;\n\tconst objB = b as object;\n\n\t// 3. Cycles: already seen pair?\n\tconst cached = visited.get(objA);\n\tif (cached !== undefined) {\n\t\t// If we already paired this A with a different B → unequal\n\t\treturn cached === objB;\n\t}\n\tvisited.set(objA, objB);\n\n\t// 4. Handle Typed Arrays / DataView first\n\tif (ArrayBuffer.isView(objA) || ArrayBuffer.isView(objB)) {\n\t\tif (!ArrayBuffer.isView(objA) || !ArrayBuffer.isView(objB)) return false;\n\n\t\tconst tagA = objToString.call(objA);\n\t\tconst tagB = objToString.call(objB);\n\t\tif (tagA !== tagB) return false;\n\n\t\t// DataView: compare byte by byte\n\t\tif (tagA === \"[object DataView]\") {\n\t\t\tconst viewA = objA as DataView;\n\t\t\tconst viewB = objB as DataView;\n\t\t\tif (viewA.byteLength !== viewB.byteLength) return false;\n\n\t\t\tconst len = viewA.byteLength;\n\t\t\tfor (let i = 0; i < len; i++) {\n\t\t\t\tif (viewA.getUint8(i) !== viewB.getUint8(i)) return false;\n\t\t\t}\n\t\t\treturn true;\n\t\t}\n\n\t\t// Typed Arrays: element by element\n\t\tconst arrA = objA as unknown as ArrayLike<unknown>;\n\t\tconst arrB = objB as unknown as ArrayLike<unknown>;\n\n\t\tconst len = arrA.length;\n\t\tif (len !== arrB.length) return false;\n\n\t\tfor (let i = 0; i < len; i++) {\n\t\t\tif ((arrA as any)[i] !== (arrB as any)[i]) return false;\n\t\t}\n\t\treturn true;\n\t}\n\n\t// 5. Tag-based type detection (robust across realms)\n\tconst tagA = objToString.call(objA);\n\tconst tagB = objToString.call(objB);\n\tif (tagA !== tagB) return false;\n\n\tswitch (tagA) {\n\t\tcase \"[object Array]\": {\n\t\t\tconst arrA = objA as unknown[];\n\t\t\tconst arrB = objB as unknown[];\n\t\t\tconst len = arrA.length;\n\t\t\tif (len !== arrB.length) return false;\n\n\t\t\tfor (let i = 0; i < len; i++) {\n\t\t\t\tif (!deepEqualInner(arrA[i], arrB[i], visited)) return false;\n\t\t\t}\n\t\t\treturn true;\n\t\t}\n\n\t\tcase \"[object Map]\": {\n\t\t\tconst mapA = objA as Map<unknown, unknown>;\n\t\t\tconst mapB = objB as Map<unknown, unknown>;\n\n\t\t\tif (mapA.size !== mapB.size) return false;\n\n\t\t\tfor (const [key, valA] of mapA) {\n\t\t\t\t// Map keys according to JS semantics: reference / SameValueZero\n\t\t\t\tif (!mapB.has(key)) return false;\n\t\t\t\tconst valB = mapB.get(key);\n\t\t\t\tif (!deepEqualInner(valA, valB, visited)) return false;\n\t\t\t}\n\t\t\treturn true;\n\t\t}\n\n\t\tcase \"[object Set]\": {\n\t\t\tconst setA = objA as Set<unknown>;\n\t\t\tconst setB = objB as Set<unknown>;\n\n\t\t\tif (setA.size !== setB.size) return false;\n\n\t\t\t// Set elements: same reference (JS semantics)\n\t\t\tfor (const value of setA) {\n\t\t\t\tif (!setB.has(value)) return false;\n\t\t\t}\n\t\t\treturn true;\n\t\t}\n\n\t\tcase \"[object Date]\": {\n\t\t\tconst timeA = (objA as Date).getTime();\n\t\t\tconst timeB = (objB as Date).getTime();\n\t\t\treturn timeA === timeB;\n\t\t}\n\n\t\tcase \"[object RegExp]\": {\n\t\t\tconst regA = objA as RegExp;\n\t\t\tconst regB = objB as RegExp;\n\t\t\treturn regA.source === regB.source && regA.flags === regB.flags;\n\t\t}\n\n\t\tcase \"[object Boolean]\":\n\t\tcase \"[object Number]\":\n\t\tcase \"[object String]\": {\n\t\t\t// Wrapper objects (new Boolean/Number/String)\n\t\t\treturn (objA as any).valueOf() === (objB as any).valueOf();\n\t\t}\n\n\t\tdefault: {\n\t\t\t// 6. Check if this is an unhandled built-in type (future-proof)\n\t\t\t// If both are built-ins but not handled above, they should be compared by reference\n\t\t\t// (since we don't know their internal structure)\n\t\t\tif (isBuiltInObject(objA, tagA) && isBuiltInObject(objB, tagB)) {\n\t\t\t\t// Unhandled built-in types: compare by reference as fallback\n\t\t\t\t// This ensures new built-ins don't fall through to plain object comparison\n\t\t\t\treturn objA === objB;\n\t\t\t}\n\n\t\t\t// 7. Fallback: plain / custom objects → compare own enumerable keys + values\n\t\t\tconst stringKeysA = Object.keys(objA as any);\n\t\t\tconst stringKeysB = Object.keys(objB as any);\n\t\t\tconst symbolKeysA = Object.getOwnPropertySymbols(objA as any);\n\t\t\tconst symbolKeysB = Object.getOwnPropertySymbols(objB as any);\n\n\t\t\t// Compare string keys count\n\t\t\tif (stringKeysA.length !== stringKeysB.length) return false;\n\t\t\t// Compare symbol keys count\n\t\t\tif (symbolKeysA.length !== symbolKeysB.length) return false;\n\n\t\t\t// Check all string keys exist in both objects\n\t\t\tfor (const key of stringKeysA) {\n\t\t\t\tif (!objHasOwn.call(objB, key)) return false;\n\t\t\t}\n\n\t\t\t// Check all symbol keys exist in both objects\n\t\t\tfor (const key of symbolKeysA) {\n\t\t\t\tif (!Object.getOwnPropertySymbols(objB as any).includes(key)) return false;\n\t\t\t}\n\n\t\t\t// Compare string key values\n\t\t\tfor (const key of stringKeysA) {\n\t\t\t\tif (!deepEqualInner((objA as any)[key], (objB as any)[key], visited)) {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Compare symbol key values\n\t\t\tfor (const key of symbolKeysA) {\n\t\t\t\tif (!deepEqualInner((objA as any)[key], (objB as any)[key], visited)) {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn true;\n\t\t}\n\t}\n}\n","import { isBuiltInObject } from \"./is-built-in\";\n\nexport type Key = string | symbol;\nexport type PathSegment = string | number | symbol;\n\nexport interface DeepOmitOptions {\n\t/**\n\t * Keys to ignore everywhere in the object tree.\n\t * Only applies to object properties, not Map/Set/TypedArray contents.\n\t */\n\treadonly ignoreKeys?: readonly Key[];\n\n\t/**\n\t * Fine-grained control: Key + path (without current key).\n\t * Example path: [\"user\", \"meta\", 0, \"data\"]\n\t */\n\treadonly ignoreKeyPredicate?: (\n\t\tkey: Key,\n\t\tpath: readonly PathSegment[],\n\t) => boolean;\n}\n\n/**\n * Creates a deep copy of `value` with certain keys removed according to the provided rules.\n *\n * This function recursively traverses the object tree and removes keys that match\n * the criteria specified in `options`. Built-in types (Date, Map, Set, TypedArrays, etc.)\n * are treated atomically and not modified.\n *\n * @param value - The value to create a deep copy from\n * @param options - Options specifying which keys to ignore\n * @returns A deep copy of `value` with specified keys removed\n *\n * @example\n * ```ts\n * const obj = { a: 1, b: { c: 2, d: 3 } };\n * const result = deepOmit(obj, { ignoreKeys: ['d'] });\n * // result: { a: 1, b: { c: 2 } }\n * ```\n */\nexport function deepOmit<T>(value: T, options: DeepOmitOptions): T {\n\tconst visited = new WeakMap<object, unknown>();\n\treturn omitInternal(value, options, [], visited) as T;\n}\n\nfunction omitInternal(\n\tvalue: unknown,\n\toptions: DeepOmitOptions,\n\tpath: PathSegment[],\n\tvisited: WeakMap<object, unknown>,\n): unknown {\n\tif (value === null) return value;\n\tconst type = typeof value;\n\n\t// Primitives and functions are passed through unchanged\n\tif (type !== \"object\") return value;\n\n\tconst obj = value as object;\n\n\t// Cycles: return cached value if already visited\n\tconst cached = visited.get(obj);\n\tif (cached !== undefined) {\n\t\treturn cached;\n\t}\n\n\tconst tag = Object.prototype.toString.call(obj);\n\n\t// Arrays: recursively process elements\n\tif (tag === \"[object Array]\") {\n\t\tconst arr = obj as unknown[];\n\t\tconst clone: unknown[] = new Array(arr.length);\n\t\tvisited.set(obj, clone);\n\n\t\tfor (let i = 0; i < arr.length; i++) {\n\t\t\tpath.push(i);\n\t\t\tclone[i] = omitInternal(arr[i], options, path, visited);\n\t\t\tpath.pop();\n\t\t}\n\t\treturn clone;\n\t}\n\n\t// Built-ins: treat atomically, no key filtering inside\n\t// Future-proof detection: check if object is a built-in type\n\tif (isBuiltInObject(obj, tag)) {\n\t\treturn value;\n\t}\n\n\t// Plain / Custom Objects: filter keys, recursively process values\n\tconst clone = Object.create(Object.getPrototypeOf(obj));\n\tvisited.set(obj, clone);\n\n\tconst stringKeys = Object.keys(obj);\n\tconst symbolKeys = Object.getOwnPropertySymbols(obj);\n\tconst keys: Key[] = [...stringKeys, ...symbolKeys];\n\n\tfor (const key of keys) {\n\t\tif (shouldIgnoreKey(key, path, options)) continue;\n\n\t\tpath.push(key);\n\t\t(clone as Record<PropertyKey, unknown>)[key] = omitInternal(\n\t\t\t(obj as Record<PropertyKey, unknown>)[key],\n\t\t\toptions,\n\t\t\tpath,\n\t\t\tvisited,\n\t\t);\n\t\tpath.pop();\n\t}\n\n\treturn clone;\n}\n\nfunction shouldIgnoreKey(\n\tkey: Key,\n\tpath: readonly PathSegment[],\n\toptions: DeepOmitOptions,\n): boolean {\n\tif (options.ignoreKeys?.includes(key)) {\n\t\treturn true;\n\t}\n\tif (options.ignoreKeyPredicate?.(key, path)) {\n\t\treturn true;\n\t}\n\treturn false;\n}\n","import { deepEqual } from \"./deep-equal\";\nimport { type DeepOmitOptions, deepOmit } from \"./deep-omit\";\n\nexport type DeepEqualExceptOptions = DeepOmitOptions;\n\n/**\n * Performs a deep equality comparison between two values after omitting specified keys.\n * \n * This function first removes the specified keys from both values using `deepOmit`,\n * then performs a deep equality check using `deepEqual`.\n * \n * @param a - The first value to compare\n * @param b - The second value to compare\n * @param options - Options specifying which keys to omit before comparison\n * @returns `true` if the values are deeply equal after omitting specified keys, `false` otherwise\n * \n * @example\n * ```ts\n * const obj1 = { id: 1, name: \"Alice\", updatedAt: \"2024-01-01\" };\n * const obj2 = { id: 2, name: \"Alice\", updatedAt: \"2024-01-02\" };\n * \n * deepEqualExcept(obj1, obj2, { ignoreKeys: [\"id\", \"updatedAt\"] }); // true\n * ```\n */\nexport function deepEqualExcept(\n\ta: unknown,\n\tb: unknown,\n\toptions: DeepEqualExceptOptions,\n): boolean {\n\tconst prunedA = deepOmit(a, options);\n\tconst prunedB = deepOmit(b, options);\n\treturn deepEqual(prunedA, prunedB);\n}\n"]}

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/utils.js

@@ -0,0 +1,2 @@
+//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"utils.js"}

package/package.json

@@ -1,11 +1,11 @@
 {
 	"name": "@shirudo/ddd-kit",
-	"version": "0.9.8",
+	"version": "0.10.0",
 	"description": "Composable TypeScript toolkit for tactical DDD",
 	"type": "module",
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/shi-rudo/ddd-kit-ts.git"
+		"url": "git+https://github.com/shi-rudo/ddd-kit-ts.git"
 	},
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -63,4 +63,4 @@
 	"bugs": {
 		"url": "https://github.com/shi-rudo/ddd-kit-ts/issues"
 	}
-}
+}