@satoshibits/functional 1.0.3 → 1.1.0

package/dist/reader.mjs

@@ -0,0 +1,444 @@
+"use strict";
+/**
+ * @module reader
+ * @description Reader represents a computation with access to a shared environment/context.
+ * The Reader monad provides a way to compose functions that all depend on some shared
+ * configuration or dependency injection context, without having to pass it explicitly
+ * through every function call.
+ *
+ * @example
+ * ```typescript
+ * import { Reader } from './reader.mts';
+ *
+ * // basic usage
+ * type Config = { apiUrl: string; timeout: number };
+ *
+ * const getApiUrl: Reader<Config, string> = config => config.apiUrl;
+ * const getTimeout: Reader<Config, number> = config => config.timeout;
+ *
+ * // composing readers
+ * const buildRequest = Reader.chain((url: string) =>
+ *   Reader.map((timeout: number) => ({ url, timeout }))(getTimeout)
+ * )(getApiUrl);
+ *
+ * // running readers
+ * const config: Config = { apiUrl: 'https://api.example.com', timeout: 5000 };
+ * const request = Reader.run(config)(buildRequest);
+ * // => { url: 'https://api.example.com', timeout: 5000 }
+ * ```
+ *
+ * @category Core
+ * @since 2025-09-18
+ */
+/**
+ * Reader utility functions for working with Reader types.
+ * @description Provides a functional API for creating, transforming, and composing Readers.
+ * All functions are curried to support functional composition and partial application.
+ *
+ * @category Utilities
+ * @since 2025-09-18
+ */
+export var Reader = {
+    /**
+     * Creates a Reader that returns the given value, ignoring the environment.
+     * @description Factory function for creating Readers from values. The resulting
+     * Reader will always return the provided value regardless of the environment.
+     *
+     * @template R - The type of the environment
+     * @template A - The type of the value
+     * @param {A} value - The value to wrap in a Reader
+     * @returns {Reader<R, A>} A Reader that returns the value
+     *
+     * @category Constructors
+     * @example
+     * ```typescript
+     * const reader = Reader.of<Config, number>(42);
+     * Reader.run(config)(reader); // => 42
+     *
+     * // Useful for starting chains
+     * const result = Reader.run(config)(
+     *   Reader.chain((n: number) => Reader.of<Config, number>(n * 2))(
+     *     Reader.of<Config, number>(21)
+     *   )
+     * ); // => 42
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    of: function (value) { return function () { return value; }; },
+    /**
+     * Gets the current environment.
+     * @description Returns a Reader that provides access to the entire environment.
+     * This is the identity Reader for the environment type.
+     *
+     * @template R - The type of the environment
+     * @returns {Reader<R, R>} A Reader that returns the environment
+     *
+     * @category Environment
+     * @example
+     * ```typescript
+     * type Config = { port: number; host: string };
+     * const config: Config = { port: 3000, host: 'localhost' };
+     *
+     * const getConfig = Reader.ask<Config>();
+     * Reader.run(config)(getConfig); // => { port: 3000, host: 'localhost' }
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    ask: function () { return function (deps) { return deps; }; },
+    /**
+     * Gets a value derived from the environment.
+     * @description Projects a value from the environment using a selector function.
+     * Useful for extracting specific parts of the environment.
+     *
+     * @template R - The type of the environment
+     * @template A - The type of the extracted value
+     * @param {function(R): A} f - Function to extract value from environment
+     * @returns {Reader<R, A>} A Reader that returns the extracted value
+     *
+     * @category Environment
+     * @example
+     * ```typescript
+     * type Config = { db: { host: string; port: number } };
+     *
+     * const getDbHost = Reader.asks<Config, string>(config => config.db.host);
+     * const config: Config = { db: { host: 'localhost', port: 5432 } };
+     * Reader.run(config)(getDbHost); // => 'localhost'
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    asks: function (f) { return f; },
+    /**
+     * Transforms the value inside a Reader using the given function.
+     * @description Applies a pure function to the value produced by a Reader,
+     * creating a new Reader with the transformed value. This is the functor
+     * map operation for Reader types.
+     *
+     * @template R - The environment type
+     * @template A - The input type
+     * @template B - The output type
+     * @param {function(A): B} f - Function to transform the value
+     * @returns {function(Reader<R, A>): Reader<R, B>} A function that transforms Readers
+     *
+     * @category Transformations
+     * @example
+     * ```typescript
+     * type Config = { multiplier: number };
+     * const getValue: Reader<Config, number> = config => 10 * config.multiplier;
+     *
+     * const double = Reader.map((n: number) => n * 2);
+     * const doubled = double(getValue);
+     *
+     * const config: Config = { multiplier: 3 };
+     * Reader.run(config)(doubled); // => 60
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    map: function (f) { return function (reader) {
+        return function (deps) { return f(reader(deps)); };
+    }; },
+    /**
+     * Chains Reader-returning operations.
+     * @description Sequences two Readers where the second depends on the result
+     * of the first. This is the monadic bind operation for Reader types.
+     *
+     * @template R - The environment type
+     * @template A - The input type
+     * @template B - The output type
+     * @param {function(A): Reader<R, B>} f - Function that returns a new Reader
+     * @returns {function(Reader<R, A>): Reader<R, B>} A function that chains Readers
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * type Config = { baseUrl: string; apiKey: string };
+     *
+     * const getBaseUrl: Reader<Config, string> = config => config.baseUrl;
+     * const buildEndpoint = (base: string): Reader<Config, string> =>
+     *   config => `${base}/api?key=${config.apiKey}`;
+     *
+     * const getEndpoint = Reader.chain(buildEndpoint)(getBaseUrl);
+     *
+     * const config: Config = { baseUrl: 'https://api.com', apiKey: 'secret' };
+     * Reader.run(config)(getEndpoint); // => 'https://api.com/api?key=secret'
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    chain: function (f) { return function (reader) {
+        return function (deps) { return f(reader(deps))(deps); };
+    }; },
+    /**
+     * Alias for chain to match fp-ts naming.
+     * @description See {@link chain} for details.
+     *
+     * @category Combinators
+     * @since 2025-09-18
+     */
+    flatMap: function (f) { return function (reader) {
+        return function (deps) { return f(reader(deps))(deps); };
+    }; },
+    /**
+     * Applies a Reader of a function to a Reader of a value.
+     * @description Enables applying functions wrapped in Readers to values wrapped
+     * in Readers. This is the applicative apply operation for Reader types.
+     *
+     * @template R - The environment type
+     * @template A - The input type
+     * @template B - The output type
+     * @param {Reader<R, A>} readerValue - Reader containing a value
+     * @returns {function(Reader<R, function(A): B>): Reader<R, B>} A function that applies Reader functions
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * type Config = { x: number; y: number };
+     *
+     * const add = (a: number) => (b: number) => a + b;
+     * const getX: Reader<Config, number> = config => config.x;
+     * const getY: Reader<Config, number> = config => config.y;
+     *
+     * const sum = Reader.ap(getY)(
+     *   Reader.map(add)(getX)
+     * );
+     *
+     * const config: Config = { x: 5, y: 3 };
+     * Reader.run(config)(sum); // => 8
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    ap: function (readerValue) { return function (readerFn) {
+        return function (deps) { return readerFn(deps)(readerValue(deps)); };
+    }; },
+    /**
+     * Runs a Reader with the given environment.
+     * @description Executes a Reader by providing it with the required environment,
+     * returning the computed value.
+     *
+     * @template R - The type of the environment
+     * @template A - The type of the value
+     * @param {R} deps - The environment to provide
+     * @returns {function(Reader<R, A>): A} A function that runs Readers
+     *
+     * @category Execution
+     * @example
+     * ```typescript
+     * type Config = { name: string };
+     * const getName: Reader<Config, string> = config => config.name;
+     *
+     * const config: Config = { name: 'Alice' };
+     * const name = Reader.run(config)(getName); // => 'Alice'
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    run: function (deps) { return function (reader) { return reader(deps); }; },
+    /**
+     * Modifies the environment before running a Reader.
+     * @description Transforms the environment using a function before passing it
+     * to the Reader. This is contravariant mapping on the environment.
+     *
+     * @template R - The new environment type
+     * @template S - The original environment type
+     * @param {function(R): S} f - Function to transform the environment
+     * @returns {function(Reader<S, A>): Reader<R, A>} A function that adapts Readers
+     *
+     * @category Transformations
+     * @example
+     * ```typescript
+     * type AppConfig = { db: DbConfig; api: ApiConfig };
+     * type DbConfig = { host: string; port: number };
+     *
+     * const getDbHost: Reader<DbConfig, string> = config => config.host;
+     * const getAppDbHost = Reader.local<AppConfig, DbConfig>(
+     *   app => app.db
+     * )(getDbHost);
+     *
+     * const appConfig: AppConfig = {
+     *   db: { host: 'localhost', port: 5432 },
+     *   api: { url: 'https://api.com' }
+     * };
+     * Reader.run(appConfig)(getAppDbHost); // => 'localhost'
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    local: function (f) { return function (reader) {
+        return function (deps) { return reader(f(deps)); };
+    }; },
+    /**
+     * Converts an array of Readers into a Reader of an array.
+     * @description Sequences multiple Readers, collecting their results into an array.
+     *
+     * @template R - The environment type
+     * @template A - The type of values in the Readers
+     * @param {Reader<R, A>[]} readers - Array of Readers to sequence
+     * @returns {Reader<R, A[]>} A Reader containing an array of results
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * type Config = { x: number; y: number; z: number };
+     *
+     * const readers = [
+     *   (c: Config) => c.x,
+     *   (c: Config) => c.y,
+     *   (c: Config) => c.z
+     * ];
+     * const combined = Reader.sequence(readers);
+     *
+     * const config: Config = { x: 1, y: 2, z: 3 };
+     * Reader.run(config)(combined); // => [1, 2, 3]
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    sequence: function (readers) {
+        return function (deps) { return readers.map(function (reader) { return reader(deps); }); };
+    },
+    /**
+     * Maps a function returning a Reader over an array and sequences the results.
+     * @description Applies a Reader-returning function to each element of an array
+     * and collects all results.
+     *
+     * @template R - The environment type
+     * @template A - The input type
+     * @template B - The output type
+     * @param {function(A): Reader<R, B>} f - Function that returns a Reader
+     * @returns {function(A[]): Reader<R, B[]>} A function that traverses arrays with Readers
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * type Config = { multiplier: number };
+     *
+     * const multiplyBy = (n: number): Reader<Config, number> =>
+     *   config => n * config.multiplier;
+     *
+     * const multiplyAll = Reader.traverse(multiplyBy);
+     * const results = multiplyAll([1, 2, 3]);
+     *
+     * const config: Config = { multiplier: 10 };
+     * Reader.run(config)(results); // => [10, 20, 30]
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    traverse: function (f) { return function (as) {
+        return Reader.sequence(as.map(f));
+    }; },
+    /**
+     * Combines the results of a tuple of Readers into a Reader of a tuple.
+     * @description Takes multiple Readers and returns a Reader containing a tuple
+     * of their results.
+     *
+     * @template R - The environment type
+     * @template T - Tuple type of Readers
+     * @param {...T} readers - Readers to combine
+     * @returns {Reader<R, { [K in keyof T]: T[K] extends Reader<R, infer U> ? U : never }>} Reader of tuple
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * type Config = { name: string; age: number; active: boolean };
+     *
+     * const getName: Reader<Config, string> = c => c.name;
+     * const getAge: Reader<Config, number> = c => c.age;
+     * const getActive: Reader<Config, boolean> = c => c.active;
+     *
+     * const combined = Reader.sequenceT(getName, getAge, getActive);
+     *
+     * const config: Config = { name: 'Alice', age: 30, active: true };
+     * Reader.run(config)(combined); // => ['Alice', 30, true]
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    sequenceT: function () {
+        var readers = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            readers[_i] = arguments[_i];
+        }
+        return function (deps) { return readers.map(function (r) { return r(deps); }); };
+    },
+    /**
+     * Combines the results of a record of Readers into a Reader of a record.
+     * @description Takes an object with Reader values and returns a Reader containing
+     * an object with the results.
+     *
+     * @template R - The environment type
+     * @template S - Record type with Reader values
+     * @param {S} readers - Record of Readers to combine
+     * @returns {Reader<R, { [K in keyof S]: S[K] extends Reader<R, infer U> ? U : never }>} Reader of record
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * type Config = { user: string; host: string; port: number };
+     *
+     * const readers = {
+     *   username: (c: Config) => c.user,
+     *   server: (c: Config) => c.host,
+     *   portNumber: (c: Config) => c.port
+     * };
+     *
+     * const combined = Reader.sequenceS(readers);
+     *
+     * const config: Config = { user: 'admin', host: 'localhost', port: 3000 };
+     * Reader.run(config)(combined);
+     * // => { username: 'admin', server: 'localhost', portNumber: 3000 }
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    sequenceS: function (readers) {
+        return function (deps) {
+            var result = {};
+            for (var key in readers) {
+                if (Object.prototype.hasOwnProperty.call(readers, key)) {
+                    result[key] = readers[key](deps);
+                }
+            }
+            return result;
+        };
+    },
+    /**
+     * Executes a Reader for its side effects, discarding the result.
+     * @description Runs a Reader-returning function but preserves the original value.
+     * Useful for logging or other side effects where the result isn't needed.
+     *
+     * @template R - The environment type
+     * @template A - The type of the value
+     * @param {function(A): Reader<R, any>} f - Function that returns a Reader (result discarded)
+     * @returns {function(Reader<R, A>): Reader<R, A>} A function that executes side effects
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * type Config = { logger: (msg: string) => void };
+     *
+     * const log = (msg: string): Reader<Config, void> =>
+     *   config => config.logger(msg);
+     *
+     * const getValue: Reader<Config, number> = () => 42;
+     * const logged = Reader.chainFirst((n: number) => log(`Got: ${n}`))(getValue);
+     *
+     * const config: Config = { logger: console.log };
+     * Reader.run(config)(logged); // logs "Got: 42", returns 42
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    chainFirst: function (f) { return function (reader) {
+        return function (deps) {
+            var a = reader(deps);
+            f(a)(deps);
+            return a;
+        };
+    }; },
+};
+//# sourceMappingURL=reader.mjs.map

package/dist/reader.mjs.map

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

package/dist/result.d.mts

@@ -71,6 +71,16 @@ export type Result<T, E = string> = {
     success: false;
     error: E;
 };
+/**
+ * Do notation builder for Result types
+ * @internal
+ */
+export interface ResultDoBuilder<E = unknown> {
+    bind: <K extends string, T>(key: K, result: Result<T, E> | ((ctx: Record<string, unknown>) => Result<T, E>)) => ResultDoBuilder<E>;
+    map: <T>(f: (ctx: Record<string, unknown>) => T) => Result<T, E>;
+    flatMap: <T>(f: (ctx: Record<string, unknown>) => Result<T, E>) => Result<T, E>;
+    value: () => Result<Record<string, unknown>, E>;
+}
 /**
  * Result utility functions for working with Result types.
  * @description Provides a functional API for creating, transforming, and composing Results.
@@ -573,6 +583,192 @@ export declare const Result: {
      * @since 2025-07-03
      */
     fromThrowable: <T extends unknown[], U>(fn: (...args: T) => U) => (...args: T) => Result<U, Error>;
+    /**
+     * Maps a function returning a Result over an array and sequences the results.
+     * @description Applies a Result-returning function to each element of an array
+     * and collects all results. If any operation fails, returns the first error.
+     *
+     * @template T - The input type
+     * @template U - The output type
+     * @template E - The error type
+     * @param {function(T): Result<U, E>} f - Function that returns a Result
+     * @returns {function(T[]): Result<U[], E>} A function that traverses arrays with Results
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * const parseNumber = (s: string): Result<number, string> => {
+     *   const n = Number(s);
+     *   return isNaN(n) ? Result.err(`Not a number: ${s}`) : Result.ok(n);
+     * };
+     *
+     * const parseAll = Result.traverse(parseNumber);
+     * parseAll(['1', '2', '3']); // => { success: true, data: [1, 2, 3] }
+     * parseAll(['1', 'x', '3']); // => { success: false, error: 'Not a number: x' }
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    traverse: <T, U, E>(f: (t: T) => Result<U, E>) => (ts: T[]) => Result<U[], E>;
+    /**
+     * Applies a Result of a function to a Result of a value.
+     * @description Enables applying functions wrapped in Results to values wrapped
+     * in Results. If either Result is an error, returns that error. This is the
+     * applicative apply operation for Result types.
+     *
+     * @template T - The input type
+     * @template U - The output type
+     * @template E - The error type
+     * @param {Result<T, E>} resultValue - Result containing a value
+     * @returns {function(Result<function(T): U, E>): Result<U, E>} A function that applies Result functions
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * const add = (a: number) => (b: number) => a + b;
+     * const resultAdd = Result.ok(add);
+     * const result5 = Result.ok(5);
+     * const result3 = Result.ok(3);
+     *
+     * const sum = Result.ap(result3)(
+     *   Result.ap(result5)(
+     *     Result.map(add)(Result.ok(10))
+     *   )
+     * ); // => { success: true, data: 18 }
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    ap: <T, U, E>(resultValue: Result<T, E>) => (resultFn: Result<(t: T) => U, E>) => Result<U, E>;
+    /**
+     * Maps both the success and error values of a Result.
+     * @description Transforms both channels of a Result simultaneously. Useful for
+     * normalizing both success values and errors in a single operation.
+     *
+     * @template T - The input success type
+     * @template U - The output success type
+     * @template E - The input error type
+     * @template F - The output error type
+     * @param {function(T): U} f - Function to transform the success value
+     * @param {function(E): F} g - Function to transform the error value
+     * @returns {function(Result<T, E>): Result<U, F>} A function that transforms both channels
+     *
+     * @category Transformations
+     * @example
+     * ```typescript
+     * const transform = Result.bimap(
+     *   (n: number) => n.toString(),
+     *   (e: Error) => e.message
+     * );
+     *
+     * transform(Result.ok(42)); // => { success: true, data: '42' }
+     * transform(Result.err(new Error('fail'))); // => { success: false, error: 'fail' }
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    bimap: <T, U, E, F>(f: (t: T) => U, g: (e: E) => F) => (result: Result<T, E>) => Result<U, F>;
+    /**
+     * Executes a Result for its side effects, discarding the result.
+     * @description Runs a Result-returning function but preserves the original value.
+     * Useful for logging or other side effects where the result isn't needed.
+     *
+     * @template T - The type of the value
+     * @template E - The error type
+     * @param {function(T): Result<any, E>} f - Function that returns a Result (result discarded)
+     * @returns {function(Result<T, E>): Result<T, E>} A function that executes side effects
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * const log = (msg: string): Result<void, never> => {
+     *   console.log(msg);
+     *   return Result.ok(undefined);
+     * };
+     *
+     * const result = Result.chainFirst((n: number) => log(`Got: ${n}`))(
+     *   Result.ok(42)
+     * ); // logs "Got: 42", returns { success: true, data: 42 }
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    chainFirst: <T, E>(f: (t: T) => Result<unknown, E>) => (result: Result<T, E>) => Result<T, E>;
+    /**
+     * Combines the results of a tuple of Results into a Result of a tuple.
+     * @description Takes multiple Results and returns a Result containing a tuple
+     * of their values. If any Result is an error, returns the first error.
+     *
+     * @template T - Tuple type of Results
+     * @param {...T} results - Results to combine
+     * @returns {Result<{ [K in keyof T]: T[K] extends Result<infer U, any> ? U : never }, T[number] extends Result<any, infer E> ? E : never>} Result of tuple
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * const result1 = Result.ok(1);
+     * const result2 = Result.ok('hello');
+     * const result3 = Result.ok(true);
+     *
+     * const combined = Result.sequenceT(result1, result2, result3);
+     * // => { success: true, data: [1, 'hello', true] }
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    sequenceT: <T extends readonly Result<unknown, unknown>[]>(...results: T) => Result<{ [K in keyof T]: T[K] extends Result<infer U, unknown> ? U : never; }, T[number] extends Result<unknown, infer E> ? E : never>;
+    /**
+     * Combines the results of a record of Results into a Result of a record.
+     * @description Takes an object with Result values and returns a Result containing
+     * an object with the unwrapped values. If any Result is an error, returns the first error.
+     *
+     * @template R - Record type with Result values
+     * @param {R} results - Record of Results to combine
+     * @returns {Result<{ [K in keyof R]: R[K] extends Result<infer U, any> ? U : never }, R[keyof R] extends Result<any, infer E> ? E : never>} Result of record
+     *
+     * @category Combinators
+     * @example
+     * ```typescript
+     * const results = {
+     *   user: Result.ok({ name: 'Alice' }),
+     *   count: Result.ok(42),
+     *   enabled: Result.ok(true)
+     * };
+     *
+     * const combined = Result.sequenceS(results);
+     * // => { success: true, data: { user: { name: 'Alice' }, count: 42, enabled: true } }
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    sequenceS: <R extends Record<string, Result<unknown, unknown>>>(results: R) => Result<{ [K in keyof R]: R[K] extends Result<infer U, unknown> ? U : never; }, R[keyof R] extends Result<unknown, infer E> ? E : never>;
+    /**
+     * Do notation helper for Result types.
+     * @description Provides a way to write sequential Result operations in an
+     * imperative style, similar to async/await but for Result types.
+     *
+     * @template E - The error type
+     * @returns {object} Do notation builder
+     *
+     * @category Do Notation
+     * @example
+     * ```typescript
+     * const result = Result.Do<string>()
+     *   .bind('x', Result.ok(5))
+     *   .bind('y', Result.ok(3))
+     *   .map(({ x, y }) => x + y);
+     * // => { success: true, data: 8 }
+     *
+     * const withError = Result.Do<string>()
+     *   .bind('x', Result.ok(5))
+     *   .bind('y', Result.err<number, string>('error'))
+     *   .map(({ x, y }) => x + y);
+     * // => { success: false, error: 'error' }
+     * ```
+     *
+     * @since 2025-09-18
+     */
+    Do: <E = unknown>() => ResultDoBuilder<E>;
 };
 /**
  * Utility type guard for checking if a value is a Result.

package/dist/result.d.mts.map

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