mcard-js 2.1.12 → 2.1.13

package/dist/monads/IO.d.ts

@@ -0,0 +1,38 @@
+/**
+ * IO Monad - Defers side effects until execution
+ *
+ * Enables pure functional composition of effectful operations
+ */
+export declare class IO<T> {
+    private readonly effect;
+    private constructor();
+    /**
+     * Create an IO from an effect (lazy evaluation)
+     */
+    static of<T>(effect: () => T | Promise<T>): IO<T>;
+    /**
+     * Lift a pure value into IO
+     */
+    static pure<T>(value: T): IO<T>;
+    /**
+     * Monadic bind - chain IO operations
+     */
+    bind<U>(fn: (value: T) => IO<U>): IO<U>;
+    /**
+     * Map a function over the result
+     */
+    map<U>(fn: (value: T) => U): IO<U>;
+    /**
+     * Execute the IO and get the result
+     */
+    run(): Promise<T>;
+    /**
+     * Run multiple IOs in sequence
+     */
+    static sequence<T>(ios: IO<T>[]): IO<T[]>;
+    /**
+     * Run multiple IOs in parallel
+     */
+    static parallel<T>(ios: IO<T>[]): IO<T[]>;
+}
+//# sourceMappingURL=IO.d.ts.map

package/dist/monads/IO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IO.d.ts","sourceRoot":"","sources":["../../src/monads/IO.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,EAAE,CAAC,CAAC;IACO,OAAO,CAAC,QAAQ,CAAC,MAAM;IAA3C,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAIjD;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAI/B;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAOvC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAOlC;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC;IAIvB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IAUzC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;CAG5C"}

package/dist/monads/IO.js

@@ -0,0 +1,66 @@
+/**
+ * IO Monad - Defers side effects until execution
+ *
+ * Enables pure functional composition of effectful operations
+ */
+export class IO {
+    effect;
+    constructor(effect) {
+        this.effect = effect;
+    }
+    /**
+     * Create an IO from an effect (lazy evaluation)
+     */
+    static of(effect) {
+        return new IO(effect);
+    }
+    /**
+     * Lift a pure value into IO
+     */
+    static pure(value) {
+        return new IO(() => value);
+    }
+    /**
+     * Monadic bind - chain IO operations
+     */
+    bind(fn) {
+        return new IO(async () => {
+            const result = await this.run();
+            return fn(result).run();
+        });
+    }
+    /**
+     * Map a function over the result
+     */
+    map(fn) {
+        return new IO(async () => {
+            const result = await this.run();
+            return fn(result);
+        });
+    }
+    /**
+     * Execute the IO and get the result
+     */
+    async run() {
+        return this.effect();
+    }
+    /**
+     * Run multiple IOs in sequence
+     */
+    static sequence(ios) {
+        return new IO(async () => {
+            const results = [];
+            for (const io of ios) {
+                results.push(await io.run());
+            }
+            return results;
+        });
+    }
+    /**
+     * Run multiple IOs in parallel
+     */
+    static parallel(ios) {
+        return new IO(() => Promise.all(ios.map(io => io.run())));
+    }
+}
+//# sourceMappingURL=IO.js.map

package/dist/monads/IO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IO.js","sourceRoot":"","sources":["../../src/monads/IO.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,EAAE;IAC0B;IAArC,YAAqC,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;IAAI,CAAC;IAEtE;;OAEG;IACH,MAAM,CAAC,EAAE,CAAI,MAA4B;QACrC,OAAO,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAI,KAAQ;QACnB,OAAO,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI,CAAI,EAAuB;QAC3B,OAAO,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE;YACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,EAAmB;QACtB,OAAO,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE;YACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG;QACL,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAI,GAAY;QAC3B,OAAO,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE;YACrB,MAAM,OAAO,GAAQ,EAAE,CAAC;YACxB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;gBACnB,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,OAAO,CAAC;QACnB,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAI,GAAY;QAC3B,OAAO,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;CACJ"}

package/dist/monads/Maybe.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Maybe Monad - Represents optional values
+ *
+ * Enables functional composition with .bind() chaining
+ * Just(value) = has value, Nothing = no value
+ */
+export declare class Maybe<T> {
+    private readonly _value;
+    private readonly _isNothing;
+    private constructor();
+    /**
+     * Create a Just (has value)
+     */
+    static just<T>(value: T): Maybe<T>;
+    /**
+     * Create a Nothing (no value)
+     */
+    static nothing<T>(): Maybe<T>;
+    /**
+     * Check if this is Nothing
+     */
+    get isNothing(): boolean;
+    /**
+     * Check if this is Just
+     */
+    get isJust(): boolean;
+    /**
+     * Get the value (throws if Nothing)
+     */
+    get value(): T;
+    /**
+     * Monadic bind - chain operations
+     * Short-circuits on Nothing
+     */
+    bind<U>(fn: (value: T) => Maybe<U>): Maybe<U>;
+    /**
+     * Map a function over the value
+     */
+    map<U>(fn: (value: T) => U): Maybe<U>;
+    /**
+     * Get value or default
+     */
+    getOrElse(defaultValue: T): T;
+}
+//# sourceMappingURL=Maybe.d.ts.map

package/dist/monads/Maybe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Maybe.d.ts","sourceRoot":"","sources":["../../src/monads/Maybe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,KAAK,CAAC,CAAC;IAEZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAF/B,OAAO;IAKP;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAIlC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC;IAI7B;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,CAAC,CAKb;IAED;;;OAGG;IACH,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAO7C;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAOrC;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC;CAGhC"}

package/dist/monads/Maybe.js

@@ -0,0 +1,73 @@
+/**
+ * Maybe Monad - Represents optional values
+ *
+ * Enables functional composition with .bind() chaining
+ * Just(value) = has value, Nothing = no value
+ */
+export class Maybe {
+    _value;
+    _isNothing;
+    constructor(_value, _isNothing) {
+        this._value = _value;
+        this._isNothing = _isNothing;
+    }
+    /**
+     * Create a Just (has value)
+     */
+    static just(value) {
+        return new Maybe(value, false);
+    }
+    /**
+     * Create a Nothing (no value)
+     */
+    static nothing() {
+        return new Maybe(null, true);
+    }
+    /**
+     * Check if this is Nothing
+     */
+    get isNothing() {
+        return this._isNothing;
+    }
+    /**
+     * Check if this is Just
+     */
+    get isJust() {
+        return !this._isNothing;
+    }
+    /**
+     * Get the value (throws if Nothing)
+     */
+    get value() {
+        if (this._isNothing) {
+            throw new Error('Cannot get value from Nothing');
+        }
+        return this._value;
+    }
+    /**
+     * Monadic bind - chain operations
+     * Short-circuits on Nothing
+     */
+    bind(fn) {
+        if (this._isNothing) {
+            return Maybe.nothing();
+        }
+        return fn(this._value);
+    }
+    /**
+     * Map a function over the value
+     */
+    map(fn) {
+        if (this._isNothing) {
+            return Maybe.nothing();
+        }
+        return Maybe.just(fn(this._value));
+    }
+    /**
+     * Get value or default
+     */
+    getOrElse(defaultValue) {
+        return this._isNothing ? defaultValue : this._value;
+    }
+}
+//# sourceMappingURL=Maybe.js.map

package/dist/monads/Maybe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Maybe.js","sourceRoot":"","sources":["../../src/monads/Maybe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,KAAK;IAEO;IACA;IAFrB,YACqB,MAAgB,EAChB,UAAmB;QADnB,WAAM,GAAN,MAAM,CAAU;QAChB,eAAU,GAAV,UAAU,CAAS;IACpC,CAAC;IAEL;;OAEG;IACH,MAAM,CAAC,IAAI,CAAI,KAAQ;QACnB,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO;QACV,OAAO,IAAI,KAAK,CAAI,IAAI,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACN,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACL,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,IAAI,CAAC,MAAW,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,IAAI,CAAI,EAA0B;QAC9B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC,OAAO,EAAK,CAAC;QAC9B,CAAC;QACD,OAAO,EAAE,CAAC,IAAI,CAAC,MAAW,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,EAAmB;QACtB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC,OAAO,EAAK,CAAC;QAC9B,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAW,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,YAAe;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAE,IAAI,CAAC,MAAY,CAAC;IAC/D,CAAC;CACJ"}

package/dist/monads/Reader.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Reader Monad - Dependency Injection
+ * COMPUTATION which reads from a shared environment
+ */
+export declare class Reader<E, T> {
+    private readonly run;
+    constructor(run: (env: E) => T);
+    /**
+     * Lift a pure value into Reader
+     */
+    static pure<E, T>(value: T): Reader<E, T>;
+    /**
+     * Get the environment
+     */
+    static ask<E>(): Reader<E, E>;
+    /**
+     * Monadic bind (flatMap)
+     */
+    bind<U>(fn: (value: T) => Reader<E, U>): Reader<E, U>;
+    /**
+     * Map over the result
+     */
+    map<U>(fn: (value: T) => U): Reader<E, U>;
+    /**
+     * Execute the Reader logic with an environment
+     */
+    evaluate(env: E): T;
+}
+//# sourceMappingURL=Reader.d.ts.map

package/dist/monads/Reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reader.d.ts","sourceRoot":"","sources":["../../src/monads/Reader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,MAAM,CAAC,CAAC,EAAE,CAAC;IACR,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC;IAE/C;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAIzC;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAI7B;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAOrD;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAIzC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC;CAGtB"}

package/dist/monads/Reader.js

@@ -0,0 +1,44 @@
+/**
+ * Reader Monad - Dependency Injection
+ * COMPUTATION which reads from a shared environment
+ */
+export class Reader {
+    run;
+    constructor(run) {
+        this.run = run;
+    }
+    /**
+     * Lift a pure value into Reader
+     */
+    static pure(value) {
+        return new Reader(_ => value);
+    }
+    /**
+     * Get the environment
+     */
+    static ask() {
+        return new Reader(env => env);
+    }
+    /**
+     * Monadic bind (flatMap)
+     */
+    bind(fn) {
+        return new Reader(env => {
+            const value = this.run(env);
+            return fn(value).run(env);
+        });
+    }
+    /**
+     * Map over the result
+     */
+    map(fn) {
+        return this.bind(value => Reader.pure(fn(value)));
+    }
+    /**
+     * Execute the Reader logic with an environment
+     */
+    evaluate(env) {
+        return this.run(env);
+    }
+}
+//# sourceMappingURL=Reader.js.map

package/dist/monads/Reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reader.js","sourceRoot":"","sources":["../../src/monads/Reader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,MAAM;IACc;IAA7B,YAA6B,GAAkB;QAAlB,QAAG,GAAH,GAAG,CAAe;IAAI,CAAC;IAEpD;;OAEG;IACH,MAAM,CAAC,IAAI,CAAO,KAAQ;QACtB,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG;QACN,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,IAAI,CAAI,EAA8B;QAClC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE;YACpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,EAAmB;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,GAAM;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;CACJ"}

package/dist/monads/State.d.ts

@@ -0,0 +1,33 @@
+/**
+ * State Monad - State Management
+ * Encapsulates state transitions
+ */
+export declare class State<S, T> {
+    private readonly run;
+    constructor(run: (state: S) => [T, S]);
+    /**
+     * Lift pure value
+     */
+    static pure<S, T>(value: T): State<S, T>;
+    /**
+     * Get current state
+     */
+    static get<S>(): State<S, S>;
+    /**
+     * Set new state
+     */
+    static put<S>(newState: S): State<S, void>;
+    /**
+     * Monadic bind
+     */
+    bind<U>(fn: (value: T) => State<S, U>): State<S, U>;
+    /**
+     * Map
+     */
+    map<U>(fn: (value: T) => U): State<S, U>;
+    /**
+     * Execute state transition
+     */
+    evaluate(initialState: S): [T, S];
+}
+//# sourceMappingURL=State.d.ts.map

package/dist/monads/State.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"State.d.ts","sourceRoot":"","sources":["../../src/monads/State.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,KAAK,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAEtD;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAIxC;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAI5B;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;IAI1C;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAOnD;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAIxC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;CAGpC"}

package/dist/monads/State.js

@@ -0,0 +1,50 @@
+/**
+ * State Monad - State Management
+ * Encapsulates state transitions
+ */
+export class State {
+    run;
+    constructor(run) {
+        this.run = run;
+    }
+    /**
+     * Lift pure value
+     */
+    static pure(value) {
+        return new State(state => [value, state]);
+    }
+    /**
+     * Get current state
+     */
+    static get() {
+        return new State(state => [state, state]);
+    }
+    /**
+     * Set new state
+     */
+    static put(newState) {
+        return new State(_ => [undefined, newState]);
+    }
+    /**
+     * Monadic bind
+     */
+    bind(fn) {
+        return new State(state => {
+            const [val, newState] = this.run(state);
+            return fn(val).run(newState);
+        });
+    }
+    /**
+     * Map
+     */
+    map(fn) {
+        return this.bind(val => State.pure(fn(val)));
+    }
+    /**
+     * Execute state transition
+     */
+    evaluate(initialState) {
+        return this.run(initialState);
+    }
+}
+//# sourceMappingURL=State.js.map

package/dist/monads/State.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"State.js","sourceRoot":"","sources":["../../src/monads/State.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,KAAK;IACe;IAA7B,YAA6B,GAAyB;QAAzB,QAAG,GAAH,GAAG,CAAsB;IAAI,CAAC;IAE3D;;OAEG;IACH,MAAM,CAAC,IAAI,CAAO,KAAQ;QACtB,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG;QACN,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAI,QAAW;QACrB,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,IAAI,CAAI,EAA6B;QACjC,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE;YACrB,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACxC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,EAAmB;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,YAAe;QACpB,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;CACJ"}

package/dist/monads/Writer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Writer Monad - Logging Side-Effects
+ * Aggregates logs alongside computation values
+ */
+export declare class Writer<L, T> {
+    private readonly run;
+    constructor(run: () => [T, L[]]);
+    /**
+     * Lift a pure value into Writer (empty log)
+     */
+    static pure<L, T>(value: T): Writer<L, T>;
+    /**
+     * Write to log
+     */
+    static tell<L>(log: L[]): Writer<L, void>;
+    /**
+     * Monadic bind
+     */
+    bind<U>(fn: (value: T) => Writer<L, U>): Writer<L, U>;
+    /**
+     * Map
+     */
+    map<U>(fn: (value: T) => U): Writer<L, U>;
+    /**
+     * Run the writer
+     */
+    evaluate(): [T, L[]];
+}
+//# sourceMappingURL=Writer.d.ts.map

package/dist/monads/Writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Writer.d.ts","sourceRoot":"","sources":["../../src/monads/Writer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,MAAM,CAAC,CAAC,EAAE,CAAC;IACR,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAEhD;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAIzC;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC;IAIzC;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IASrD;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAIzC;;OAEG;IACH,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;CAGvB"}

package/dist/monads/Writer.js

@@ -0,0 +1,46 @@
+/**
+ * Writer Monad - Logging Side-Effects
+ * Aggregates logs alongside computation values
+ */
+export class Writer {
+    run;
+    constructor(run) {
+        this.run = run;
+    }
+    /**
+     * Lift a pure value into Writer (empty log)
+     */
+    static pure(value) {
+        return new Writer(() => [value, []]);
+    }
+    /**
+     * Write to log
+     */
+    static tell(log) {
+        return new Writer(() => [undefined, log]);
+    }
+    /**
+     * Monadic bind
+     */
+    bind(fn) {
+        return new Writer(() => {
+            const [val1, log1] = this.run();
+            const writer2 = fn(val1);
+            const [val2, log2] = writer2.evaluate();
+            return [val2, [...log1, ...log2]];
+        });
+    }
+    /**
+     * Map
+     */
+    map(fn) {
+        return this.bind(val => Writer.pure(fn(val)));
+    }
+    /**
+     * Run the writer
+     */
+    evaluate() {
+        return this.run();
+    }
+}
+//# sourceMappingURL=Writer.js.map

package/dist/monads/Writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Writer.js","sourceRoot":"","sources":["../../src/monads/Writer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,MAAM;IACc;IAA7B,YAA6B,GAAmB;QAAnB,QAAG,GAAH,GAAG,CAAgB;IAAI,CAAC;IAErD;;OAEG;IACH,MAAM,CAAC,IAAI,CAAO,KAAQ;QACtB,OAAO,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAI,GAAQ;QACnB,OAAO,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,IAAI,CAAI,EAA8B;QAClC,OAAO,IAAI,MAAM,CAAC,GAAG,EAAE;YACnB,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACzB,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;YACxC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,EAAmB;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,CAAC;CACJ"}

package/dist/ptr/FaroSidecar.d.ts

@@ -0,0 +1,56 @@
+import { Faro } from '@grafana/faro-web-sdk';
+/**
+ * Configuration for the Faro Observability Sidecar
+ */
+export interface FaroSidecarConfig {
+    url: string;
+    apiKey?: string;
+    appName: string;
+    appVersion: string;
+    enableTracing?: boolean;
+    namespace?: string;
+    additionalInstrumentations?: any[];
+}
+/**
+ * FaroSidecar - Integrates Grafana Faro for Frontend Observability
+ *
+ * Acts as an observability sidecar for the PTR, capturing:
+ * - Logs
+ * - Errors
+ * - Web Vitals
+ * - Traces (OpenTelemetry)
+ * - User Sessions
+ */
+export declare class FaroSidecar {
+    private static instance;
+    private faro;
+    private constructor();
+    /**
+     * Get the singleton instance of FaroSidecar
+     */
+    static getInstance(): FaroSidecar;
+    /**
+     * Initialize the Faro SDK
+     *
+     * @param config Configuration options
+     * @returns The initialized Faro instance or null if not in a browser environment
+     */
+    initialize(config: FaroSidecarConfig): Faro | null;
+    /**
+     * Get the underlying Faro instance
+     */
+    getFaro(): Faro | null;
+    /**
+     * Manually push an error to Faro
+     */
+    pushError(error: Error, context?: Record<string, any>): void;
+    /**
+     * Manually push a log message to Faro
+     */
+    pushLog(message: string, context?: Record<string, any>): void;
+    /**
+     * Push a custom event
+     */
+    pushEvent(name: string, attributes?: Record<string, string>): void;
+}
+//# sourceMappingURL=FaroSidecar.d.ts.map

package/dist/ptr/FaroSidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FaroSidecar.d.ts","sourceRoot":"","sources":["../../src/ptr/FaroSidecar.ts"],"names":[],"mappings":"AACA,OAAO,EAGH,IAAI,EACP,MAAM,uBAAuB,CAAC;AAG/B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B,CAAC,EAAE,GAAG,EAAE,CAAC;CACtC;AAED;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IACnD,OAAO,CAAC,IAAI,CAAqB;IAEjC,OAAO;IAEP;;OAEG;WACW,WAAW,IAAI,WAAW;IAOxC;;;;;OAKG;IACI,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI;IAuDzD;;OAEG;IACI,OAAO,IAAI,IAAI,GAAG,IAAI;IAI7B;;OAEG;IACI,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAMnE;;OAEG;IACI,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAMpE;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAK5E"}

package/dist/ptr/FaroSidecar.js

@@ -0,0 +1,102 @@
+import { initializeFaro, getWebInstrumentations } from '@grafana/faro-web-sdk';
+import { TracingInstrumentation } from '@grafana/faro-web-tracing';
+/**
+ * FaroSidecar - Integrates Grafana Faro for Frontend Observability
+ *
+ * Acts as an observability sidecar for the PTR, capturing:
+ * - Logs
+ * - Errors
+ * - Web Vitals
+ * - Traces (OpenTelemetry)
+ * - User Sessions
+ */
+export class FaroSidecar {
+    static instance = null;
+    faro = null;
+    constructor() { }
+    /**
+     * Get the singleton instance of FaroSidecar
+     */
+    static getInstance() {
+        if (!FaroSidecar.instance) {
+            FaroSidecar.instance = new FaroSidecar();
+        }
+        return FaroSidecar.instance;
+    }
+    /**
+     * Initialize the Faro SDK
+     *
+     * @param config Configuration options
+     * @returns The initialized Faro instance or null if not in a browser environment
+     */
+    initialize(config) {
+        // Ensure we are in a browser environment
+        if (typeof window === 'undefined') {
+            console.warn('[FaroSidecar] Not initializing Grafana Faro: Non-browser environment detected.');
+            return null;
+        }
+        if (this.faro) {
+            console.warn('[FaroSidecar] Grafana Faro is already initialized.');
+            return this.faro;
+        }
+        const { url, apiKey, appName, appVersion, enableTracing = true, namespace = 'ptr_runtime', additionalInstrumentations = [] } = config;
+        const instrumentations = [
+            ...getWebInstrumentations(),
+            ...additionalInstrumentations
+        ];
+        if (enableTracing) {
+            instrumentations.push(new TracingInstrumentation());
+        }
+        const faroOptions = {
+            url,
+            apiKey,
+            app: {
+                name: appName,
+                version: appVersion,
+                namespace
+            },
+            instrumentations,
+        };
+        try {
+            this.faro = initializeFaro(faroOptions);
+            console.log(`[FaroSidecar] Grafana Faro initialized for ${appName}@${appVersion}`);
+            // Auto-push a session start log
+            this.faro.api.pushLog([`PTR Observability Sidecar started for ${appName}`]);
+        }
+        catch (error) {
+            console.error('[FaroSidecar] Failed to initialize Grafana Faro:', error);
+        }
+        return this.faro;
+    }
+    /**
+     * Get the underlying Faro instance
+     */
+    getFaro() {
+        return this.faro;
+    }
+    /**
+     * Manually push an error to Faro
+     */
+    pushError(error, context) {
+        if (this.faro) {
+            this.faro.api.pushError(error, { context });
+        }
+    }
+    /**
+     * Manually push a log message to Faro
+     */
+    pushLog(message, context) {
+        if (this.faro) {
+            this.faro.api.pushLog([message], { context });
+        }
+    }
+    /**
+     * Push a custom event
+     */
+    pushEvent(name, attributes) {
+        if (this.faro) {
+            this.faro.api.pushEvent(name, attributes);
+        }
+    }
+}
+//# sourceMappingURL=FaroSidecar.js.map

package/dist/ptr/FaroSidecar.js.map

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