/**
 * @since 2.0.0
 */
import type * as Brand from "./Brand.js"
import type * as Chunk from "./Chunk.js"
import type * as ConfigError from "./ConfigError.js"
import type * as Duration from "./Duration.js"
import type * as Effect from "./Effect.js"
import type * as Either from "./Either.js"
import type { LazyArg } from "./Function.js"
import type * as HashMap from "./HashMap.js"
import type * as HashSet from "./HashSet.js"
import * as internal from "./internal/config.js"
import type * as LogLevel from "./LogLevel.js"
import type * as Option from "./Option.js"
import type { Predicate, Refinement } from "./Predicate.js"
import type * as Redacted from "./Redacted.js"
import type * as Secret from "./Secret.js"
import type * as Types from "./Types.js"

/**
 * @since 2.0.0
 * @category symbols
 */
export const ConfigTypeId: unique symbol = internal.ConfigTypeId

/**
 * @since 2.0.0
 * @category symbols
 */
export type ConfigTypeId = typeof ConfigTypeId

/**
 * A `Config` describes the structure of some configuration data.
 *
 * @since 2.0.0
 * @category models
 */
export interface Config<out A> extends Config.Variance<A>, Effect.Effect<A, ConfigError.ConfigError> {}

/**
 * @since 2.0.0
 */
export declare namespace Config {
  /**
   * @since 2.0.0
   * @category models
   */
  export interface Variance<out A> {
    readonly [ConfigTypeId]: {
      readonly _A: Types.Covariant<A>
    }
  }

  /**
   * @since 2.5.0
   * @category models
   */
  export type Success<T extends Config<any>> = [T] extends [Config<infer _A>] ? _A : never

  /**
   * @since 2.0.0
   * @category models
   */
  export interface Primitive<out A> extends Config<A> {
    readonly description: string
    parse(text: string): Either.Either<A, ConfigError.ConfigError>
  }

  /**
   * Wraps a nested structure, converting all primitives to a `Config`.
   *
   * `Config.Wrap<{ key: string }>` becomes `{ key: Config<string> }`
   *
   * To create the resulting config, use the `unwrap` constructor.
   *
   * @since 2.0.0
   * @category models
   */
  export type Wrap<A> = [NonNullable<A>] extends [infer T] ? [IsPlainObject<T>] extends [true] ?
        | { readonly [K in keyof A]: Wrap<A[K]> }
        | Config<A>
    : Config<A>
    : Config<A>

  type IsPlainObject<A> = [A] extends [Record<string, any>]
    ? [keyof A] extends [never] ? false : [keyof A] extends [string] ? true : false
    : false
}

/**
 * @since 2.0.0
 * @category models
 */
export type LiteralValue = string | number | boolean | null | bigint

/**
 * Constructs a config from a tuple / struct / arguments of configs.
 *
 * @since 2.0.0
 * @category constructors
 */
export const all: <const Arg extends Iterable<Config<any>> | Record<string, Config<any>>>(
  arg: Arg
) => Config<
  [Arg] extends [ReadonlyArray<Config<any>>] ? {
      -readonly [K in keyof Arg]: [Arg[K]] extends [Config<infer A>] ? A : never
    }
    : [Arg] extends [Iterable<Config<infer A>>] ? Array<A>
    : [Arg] extends [Record<string, Config<any>>] ? {
        -readonly [K in keyof Arg]: [Arg[K]] extends [Config<infer A>] ? A : never
      }
    : never
> = internal.all

/**
 * Constructs a config for an array of values.
 *
 * @since 2.0.0
 * @category constructors
 */
export const array: <A>(config: Config<A>, name?: string) => Config<Array<A>> = internal.array

/**
 * Constructs a config for a boolean value.
 *
 * @since 2.0.0
 * @category constructors
 */
export const boolean: (name?: string) => Config<boolean> = internal.boolean

/**
 * Constructs a config for a network port [1, 65535].
 *
 * @since 3.16.0
 * @category constructors
 */
export const port: (name?: string) => Config<number> = internal.port

/**
 * Constructs a config for an URL value.
 *
 * @since 3.11.0
 * @category constructors
 */
export const url: (name?: string) => Config<URL> = internal.url

/**
 * Constructs a config for a sequence of values.
 *
 * @since 2.0.0
 * @category constructors
 */
export const chunk: <A>(config: Config<A>, name?: string) => Config<Chunk.Chunk<A>> = internal.chunk

/**
 * Constructs a config for a date value.
 *
 * @since 2.0.0
 * @category constructors
 */
export const date: (name?: string) => Config<Date> = internal.date

/**
 * Constructs a config that fails with the specified message.
 *
 * @since 2.0.0
 * @category constructors
 */
export const fail: (message: string) => Config<never> = internal.fail

/**
 * Constructs a config for a float value.
 *
 * @since 2.0.0
 * @category constructors
 */
export const number: (name?: string) => Config<number> = internal.number

/**
 * Constructs a config for a integer value.
 *
 * @since 2.0.0
 * @category constructors
 */
export const integer: (name?: string) => Config<number> = internal.integer

/**
 * Constructs a config for a literal value.
 *
 * **Example**
 *
 * ```ts
 * import { Config } from "effect"
 *
 * const config = Config.literal("http", "https")("PROTOCOL")
 * ```
 *
 * @since 2.0.0
 * @category constructors
 */
export const literal: <Literals extends ReadonlyArray<LiteralValue>>(...literals: Literals) => (
  name?: string
) => Config<Literals[number]> = internal.literal

/**
 * Constructs a config for a `LogLevel` value.
 *
 * @since 2.0.0
 * @category constructors
 */
export const logLevel: (name?: string) => Config<LogLevel.LogLevel> = internal.logLevel

/**
 * Constructs a config for a duration value.
 *
 * @since 2.5.0
 * @category constructors
 */
export const duration: (name?: string) => Config<Duration.Duration> = internal.duration

/**
 * This function returns `true` if the specified value is an `Config` value,
 * `false` otherwise.
 *
 * This function can be useful for checking the type of a value before
 * attempting to operate on it as an `Config` value. For example, you could
 * use `isConfig` to check the type of a value before using it as an
 * argument to a function that expects an `Config` value.
 *
 * @since 2.0.0
 * @category refinements
 */
export const isConfig: (u: unknown) => u is Config<unknown> = internal.isConfig

/**
 * Returns a  config whose structure is the same as this one, but which produces
 * a different value, constructed using the specified function.
 *
 * @since 2.0.0
 * @category mapping
 */
export const map: {
  /**
   * Returns a  config whose structure is the same as this one, but which produces
   * a different value, constructed using the specified function.
   *
   * @since 2.0.0
   * @category mapping
   */
  <A, B>(f: (a: A) => B): (self: Config<A>) => Config<B>
  /**
   * Returns a  config whose structure is the same as this one, but which produces
   * a different value, constructed using the specified function.
   *
   * @since 2.0.0
   * @category mapping
   */
  <A, B>(self: Config<A>, f: (a: A) => B): Config<B>
} = internal.map

/**
 * Returns a config whose structure is the same as this one, but which may
 * produce a different value, constructed using the specified function, which
 * may throw exceptions that will be translated into validation errors.
 *
 * @since 2.0.0
 * @category utils
 */
export const mapAttempt: {
  /**
   * Returns a config whose structure is the same as this one, but which may
   * produce a different value, constructed using the specified function, which
   * may throw exceptions that will be translated into validation errors.
   *
   * @since 2.0.0
   * @category utils
   */
  <A, B>(f: (a: A) => B): (self: Config<A>) => Config<B>
  /**
   * Returns a config whose structure is the same as this one, but which may
   * produce a different value, constructed using the specified function, which
   * may throw exceptions that will be translated into validation errors.
   *
   * @since 2.0.0
   * @category utils
   */
  <A, B>(self: Config<A>, f: (a: A) => B): Config<B>
} = internal.mapAttempt

/**
 * Returns a new config whose structure is the samea as this one, but which
 * may produce a different value, constructed using the specified fallible
 * function.
 *
 * @since 2.0.0
 * @category utils
 */
export const mapOrFail: {
  /**
   * Returns a new config whose structure is the samea as this one, but which
   * may produce a different value, constructed using the specified fallible
   * function.
   *
   * @since 2.0.0
   * @category utils
   */
  <A, B>(f: (a: A) => Either.Either<B, ConfigError.ConfigError>): (self: Config<A>) => Config<B>
  /**
   * Returns a new config whose structure is the samea as this one, but which
   * may produce a different value, constructed using the specified fallible
   * function.
   *
   * @since 2.0.0
   * @category utils
   */
  <A, B>(self: Config<A>, f: (a: A) => Either.Either<B, ConfigError.ConfigError>): Config<B>
} = internal.mapOrFail

/**
 * Returns a config that has this configuration nested as a property of the
 * specified name.
 *
 * @since 2.0.0
 * @category utils
 */
export const nested: {
  /**
   * Returns a config that has this configuration nested as a property of the
   * specified name.
   *
   * @since 2.0.0
   * @category utils
   */
  (name: string): <A>(self: Config<A>) => Config<A>
  /**
   * Returns a config that has this configuration nested as a property of the
   * specified name.
   *
   * @since 2.0.0
   * @category utils
   */
  <A>(self: Config<A>, name: string): Config<A>
} = internal.nested

/**
 * Returns a config whose structure is preferentially described by this
 * config, but which falls back to the specified config if there is an issue
 * reading from this config.
 *
 * @since 2.0.0
 * @category utils
 */
export const orElse: {
  /**
   * Returns a config whose structure is preferentially described by this
   * config, but which falls back to the specified config if there is an issue
   * reading from this config.
   *
   * @since 2.0.0
   * @category utils
   */
  <A2>(that: LazyArg<Config<A2>>): <A>(self: Config<A>) => Config<A2 | A>
  /**
   * Returns a config whose structure is preferentially described by this
   * config, but which falls back to the specified config if there is an issue
   * reading from this config.
   *
   * @since 2.0.0
   * @category utils
   */
  <A, A2>(self: Config<A>, that: LazyArg<Config<A2>>): Config<A | A2>
} = internal.orElse

/**
 * Returns configuration which reads from this configuration, but which falls
 * back to the specified configuration if reading from this configuration
 * fails with an error satisfying the specified predicate.
 *
 * @since 2.0.0
 * @category utils
 */
export const orElseIf: {
  /**
   * Returns configuration which reads from this configuration, but which falls
   * back to the specified configuration if reading from this configuration
   * fails with an error satisfying the specified predicate.
   *
   * @since 2.0.0
   * @category utils
   */
  <A2>(
   options: {
     readonly if: Predicate<ConfigError.ConfigError>
     readonly orElse: LazyArg<Config<A2>>
   }
  ): <A>(self: Config<A>) => Config<A | A2>
  /**
   * Returns configuration which reads from this configuration, but which falls
   * back to the specified configuration if reading from this configuration
   * fails with an error satisfying the specified predicate.
   *
   * @since 2.0.0
   * @category utils
   */
  <A, A2>(
   self: Config<A>,
   options: {
     readonly if: Predicate<ConfigError.ConfigError>
     readonly orElse: LazyArg<Config<A2>>
   }
  ): Config<A | A2>
} = internal.orElseIf

/**
 * Returns an optional version of this config, which will be `None` if the
 * data is missing from configuration, and `Some` otherwise.
 *
 * @since 2.0.0
 * @category utils
 */
export const option: <A>(self: Config<A>) => Config<Option.Option<A>> = internal.option

/**
 * Constructs a new primitive config.
 *
 * @since 2.0.0
 * @category constructors
 */
export const primitive: <A>(
  description: string,
  parse: (text: string) => Either.Either<A, ConfigError.ConfigError>
) => Config<A> = internal.primitive

/**
 * Returns a config that describes a sequence of values, each of which has the
 * structure of this config.
 *
 * @since 2.0.0
 * @category utils
 */
export const repeat: <A>(self: Config<A>) => Config<Array<A>> = internal.repeat

/**
 * Constructs a config for a secret value.
 *
 * @since 2.0.0
 * @category constructors
 * @deprecated
 */
export const secret: (name?: string) => Config<Secret.Secret> = internal.secret

/**
 * Constructs a config for a redacted value.
 *
 * @since 2.0.0
 * @category constructors
 */
export const redacted: {
  /**
   * Constructs a config for a redacted value.
   *
   * @since 2.0.0
   * @category constructors
   */
  (name?: string): Config<Redacted.Redacted>
  /**
   * Constructs a config for a redacted value.
   *
   * @since 2.0.0
   * @category constructors
   */
  <A>(config: Config<A>): Config<Redacted.Redacted<A>>
} = internal.redacted

/**
 * Constructs a config for a branded value.
 *
 * @since 3.16.0
 * @category constructors
 */
export const branded: {
  /**
   * Constructs a config for a branded value.
   *
   * @since 3.16.0
   * @category constructors
   */
  <A, B extends Brand.Branded<A, any>>(constructor: Brand.Brand.Constructor<B>): (config: Config<A>) => Config<B>
  /**
   * Constructs a config for a branded value.
   *
   * @since 3.16.0
   * @category constructors
   */
  <B extends Brand.Branded<string, any>>(name: string | undefined, constructor: Brand.Brand.Constructor<B>): Config<B>
  /**
   * Constructs a config for a branded value.
   *
   * @since 3.16.0
   * @category constructors
   */
  <A, B extends Brand.Branded<A, any>>(config: Config<A>, constructor: Brand.Brand.Constructor<B>): Config<B>
} = internal.branded

/**
 * Constructs a config for a sequence of values.
 *
 * @since 2.0.0
 * @category constructors
 */
export const hashSet: <A>(config: Config<A>, name?: string) => Config<HashSet.HashSet<A>> = internal.hashSet

/**
 * Constructs a config for a string value.
 *
 * @since 2.0.0
 * @category constructors
 */
export const string: (name?: string) => Config<string> = internal.string

/**
 * Constructs a config for a non-empty string value.
 *
 * @since 3.7.0
 * @category constructors
 */
export const nonEmptyString: (name?: string) => Config<string> = internal.nonEmptyString

/**
 * Constructs a config which contains the specified value.
 *
 * @since 2.0.0
 * @category constructors
 */
export const succeed: <A>(value: A) => Config<A> = internal.succeed

/**
 * Lazily constructs a config.
 *
 * @since 2.0.0
 * @category constructors
 */
export const suspend: <A>(config: LazyArg<Config<A>>) => Config<A> = internal.suspend

/**
 * Constructs a config which contains the specified lazy value.
 *
 * @since 2.0.0
 * @category constructors
 */
export const sync: <A>(value: LazyArg<A>) => Config<A> = internal.sync

/**
 * Constructs a config for a sequence of values.
 *
 * @since 2.0.0
 * @category constructors
 */
export const hashMap: <A>(config: Config<A>, name?: string) => Config<HashMap.HashMap<string, A>> = internal.hashMap

/**
 * Constructs a config from some configuration wrapped with the `Wrap<A>` utility type.
 *
 * For example:
 *
 * ```
 * import { Config, unwrap } from "./Config"
 *
 * interface Options { key: string }
 *
 * const makeConfig = (config: Config.Wrap<Options>): Config<Options> => unwrap(config)
 * ```
 *
 * @since 2.0.0
 * @category constructors
 */
export const unwrap: <A>(wrapped: Config.Wrap<A>) => Config<A> = internal.unwrap

/**
 * Returns a config that describes the same structure as this one, but which
 * performs validation during loading.
 *
 * @since 2.0.0
 * @category utils
 */
export const validate: {
  /**
   * Returns a config that describes the same structure as this one, but which
   * performs validation during loading.
   *
   * @since 2.0.0
   * @category utils
   */
  <A, B extends A>(
   options: {
     readonly message: string
     readonly validation: Refinement<A, B>
   }
  ): (self: Config<A>) => Config<B>
  /**
   * Returns a config that describes the same structure as this one, but which
   * performs validation during loading.
   *
   * @since 2.0.0
   * @category utils
   */
  <A>(
   options: {
     readonly message: string
     readonly validation: Predicate<A>
   }
  ): (self: Config<A>) => Config<A>
  /**
   * Returns a config that describes the same structure as this one, but which
   * performs validation during loading.
   *
   * @since 2.0.0
   * @category utils
   */
  <A, B extends A>(
   self: Config<A>,
   options: {
     readonly message: string
     readonly validation: Refinement<A, B>
   }
  ): Config<B>
  /**
   * Returns a config that describes the same structure as this one, but which
   * performs validation during loading.
   *
   * @since 2.0.0
   * @category utils
   */
  <A>(
   self: Config<A>,
   options: {
     readonly message: string
     readonly validation: Predicate<A>
   }
  ): Config<A>
} = internal.validate

/**
 * Returns a config that describes the same structure as this one, but has the
 * specified default value in case the information cannot be found.
 *
 * @since 2.0.0
 * @category utils
 */
export const withDefault: {
  /**
   * Returns a config that describes the same structure as this one, but has the
   * specified default value in case the information cannot be found.
   *
   * @since 2.0.0
   * @category utils
   */
  <const A2>(def: A2): <A>(self: Config<A>) => Config<A2 | A>
  /**
   * Returns a config that describes the same structure as this one, but has the
   * specified default value in case the information cannot be found.
   *
   * @since 2.0.0
   * @category utils
   */
  <A, const A2>(self: Config<A>, def: A2): Config<A | A2>
} = internal.withDefault

/**
 * Adds a description to this configuration, which is intended for humans.
 *
 * @since 2.0.0
 * @category utils
 */
export const withDescription: {
  /**
   * Adds a description to this configuration, which is intended for humans.
   *
   * @since 2.0.0
   * @category utils
   */
  (description: string): <A>(self: Config<A>) => Config<A>
  /**
   * Adds a description to this configuration, which is intended for humans.
   *
   * @since 2.0.0
   * @category utils
   */
  <A>(self: Config<A>, description: string): Config<A>
} = internal.withDescription

/**
 * Returns a config that is the composition of this config and the specified
 * config.
 *
 * @since 2.0.0
 * @category zipping
 */
export const zip: {
  /**
   * Returns a config that is the composition of this config and the specified
   * config.
   *
   * @since 2.0.0
   * @category zipping
   */
  <B>(that: Config<B>): <A>(self: Config<A>) => Config<[A, B]>
  /**
   * Returns a config that is the composition of this config and the specified
   * config.
   *
   * @since 2.0.0
   * @category zipping
   */
  <A, B>(self: Config<A>, that: Config<B>): Config<[A, B]>
} = internal.zip

/**
 * Returns a config that is the composes this config and the specified config
 * using the provided function.
 *
 * @since 2.0.0
 * @category zipping
 */
export const zipWith: {
  /**
   * Returns a config that is the composes this config and the specified config
   * using the provided function.
   *
   * @since 2.0.0
   * @category zipping
   */
  <B, A, C>(that: Config<B>, f: (a: A, b: B) => C): (self: Config<A>) => Config<C>
  /**
   * Returns a config that is the composes this config and the specified config
   * using the provided function.
   *
   * @since 2.0.0
   * @category zipping
   */
  <A, B, C>(self: Config<A>, that: Config<B>, f: (a: A, b: B) => C): Config<C>
} = internal.zipWith