effect 4.0.0-beta.70 → 4.0.0-beta.72

package/dist/unstable/http/Url.d.ts

@@ -1,17 +1,33 @@
 /**
- * Utilities for parsing and immutably updating HTTP URLs.
+ * Immutable helpers for parsing and editing platform `URL` values.
  *
- * This module works with the platform `URL` type used by HTTP clients and
- * servers, adding safe constructors and pipeable setters for common workflows
- * such as resolving request targets against a base URL, changing credentials,
- * host, path, protocol, query, and hash components, and reading or rewriting
- * query parameters through `UrlParams`.
+ * This module keeps the WHATWG `URL` object as the URL representation used by
+ * HTTP clients and servers, then adds safe parsing and pipeable setters for
+ * credentials, host, path, protocol, query, and hash components. Query strings
+ * can be read, replaced, or transformed through `UrlParams` so repeated keys and
+ * key/value encoding stay explicit.
  *
- * Parsing and serialization follow the platform WHATWG `URL` behavior. Relative
- * inputs need an explicit base, assigned components may be normalized or
- * percent-encoded by `URL`, and query strings should usually be handled through
- * `UrlParams` when preserving repeated keys or applying key/value encoding is
- * important.
+ * **Mental model**
+ *
+ * `fromString` returns a `Result` instead of throwing when URL construction
+ * fails. Setters never mutate the original `URL`; each one clones the input and
+ * assigns the requested component on the clone. Use `mutate` when several
+ * component assignments should happen on the same clone.
+ *
+ * **Common tasks**
+ *
+ * - Parse absolute URLs, or resolve relative URL strings against a base URL.
+ * - Pipe setters to adjust host, protocol, path, credentials, search, or hash.
+ * - Extract query parameters with `urlParams`.
+ * - Replace or transform query parameters with `setUrlParams` and
+ *   `modifyUrlParams`.
+ *
+ * **Gotchas**
+ *
+ * Relative input needs an explicit base. Component assignment and serialization
+ * follow platform `URL` rules, so values may be normalized or percent-encoded.
+ * `setPassword` accepts `Redacted` input, but the resulting `URL` still contains
+ * the actual credential and should be treated as sensitive when serialized.
  *
  * @since 4.0.0
  */
@@ -20,7 +36,7 @@ import * as Redacted from "../../Redacted.ts";
 import * as Result from "../../Result.ts";
 import * as UrlParams from "./UrlParams.ts";
 /**
- * Parses a URL string into a `URL` object, returning an `Result` type for safe
+ * Parses a URL string safely into a `URL` object, returning a `Result` type for
  * error handling.
  *
  * **Details**
@@ -71,7 +87,7 @@ import * as UrlParams from "./UrlParams.ts";
  */
 export declare const fromString: {
     /**
-     * Parses a URL string into a `URL` object, returning an `Result` type for safe
+     * Parses a URL string safely into a `URL` object, returning a `Result` type for
      * error handling.
      *
      * **Details**
@@ -123,8 +139,7 @@ export declare const fromString: {
     (url: string, base?: string | URL | undefined): Result.Result<URL, Cause.IllegalArgumentError>;
 };
 /**
- * This function clones the original `URL` object and applies a callback to the
- * clone, allowing multiple updates at once.
+ * Updates a cloned `URL` with a callback, allowing multiple changes at once.
  *
  * **Example** (Mutating URL credentials)
  *
@@ -142,13 +157,12 @@ export declare const fromString: {
  * // Output: Mutated: https://user:pass@example.com/
  * ```
  *
- * @category Modifiers
+ * @category modifiers
  * @since 4.0.0
  */
 export declare const mutate: {
     /**
-     * This function clones the original `URL` object and applies a callback to the
-     * clone, allowing multiple updates at once.
+     * Updates a cloned `URL` with a callback, allowing multiple changes at once.
      *
      * **Example** (Mutating URL credentials)
      *
@@ -166,13 +180,12 @@ export declare const mutate: {
      * // Output: Mutated: https://user:pass@example.com/
      * ```
      *
-     * @category Modifiers
+     * @category modifiers
      * @since 4.0.0
      */
     (f: (url: URL) => void): (self: URL) => URL;
     /**
-     * This function clones the original `URL` object and applies a callback to the
-     * clone, allowing multiple updates at once.
+     * Updates a cloned `URL` with a callback, allowing multiple changes at once.
      *
      * **Example** (Mutating URL credentials)
      *
@@ -190,7 +203,7 @@ export declare const mutate: {
      * // Output: Mutated: https://user:pass@example.com/
      * ```
      *
-     * @category Modifiers
+     * @category modifiers
      * @since 4.0.0
      */
     (self: URL, f: (url: URL) => void): URL;
@@ -534,7 +547,7 @@ export declare const setUrlParams: {
  */
 export declare const urlParams: (url: URL) => UrlParams.UrlParams;
 /**
- * Reads, modifies, and updates the query parameters of a URL.
+ * Reads the query parameters of a URL, modifies them, and updates the URL.
  *
  * **Details**
  *
@@ -556,12 +569,12 @@ export declare const urlParams: (url: URL) => UrlParams.UrlParams;
  * // Output: https://example.com/?foo=bar&key=value
  * ```
  *
- * @category Modifiers
+ * @category modifiers
  * @since 4.0.0
  */
 export declare const modifyUrlParams: {
     /**
-     * Reads, modifies, and updates the query parameters of a URL.
+     * Reads the query parameters of a URL, modifies them, and updates the URL.
      *
      * **Details**
      *
@@ -583,12 +596,12 @@ export declare const modifyUrlParams: {
      * // Output: https://example.com/?foo=bar&key=value
      * ```
      *
-     * @category Modifiers
+     * @category modifiers
      * @since 4.0.0
      */
     (f: (urlParams: UrlParams.UrlParams) => UrlParams.UrlParams): (url: URL) => URL;
     /**
-     * Reads, modifies, and updates the query parameters of a URL.
+     * Reads the query parameters of a URL, modifies them, and updates the URL.
      *
      * **Details**
      *
@@ -610,7 +623,7 @@ export declare const modifyUrlParams: {
      * // Output: https://example.com/?foo=bar&key=value
      * ```
      *
-     * @category Modifiers
+     * @category modifiers
      * @since 4.0.0
      */
     (url: URL, f: (urlParams: UrlParams.UrlParams) => UrlParams.UrlParams): URL;

package/dist/unstable/http/Url.d.ts.map

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

package/dist/unstable/http/Url.js

@@ -1,17 +1,33 @@
 /**
- * Utilities for parsing and immutably updating HTTP URLs.
+ * Immutable helpers for parsing and editing platform `URL` values.
  *
- * This module works with the platform `URL` type used by HTTP clients and
- * servers, adding safe constructors and pipeable setters for common workflows
- * such as resolving request targets against a base URL, changing credentials,
- * host, path, protocol, query, and hash components, and reading or rewriting
- * query parameters through `UrlParams`.
+ * This module keeps the WHATWG `URL` object as the URL representation used by
+ * HTTP clients and servers, then adds safe parsing and pipeable setters for
+ * credentials, host, path, protocol, query, and hash components. Query strings
+ * can be read, replaced, or transformed through `UrlParams` so repeated keys and
+ * key/value encoding stay explicit.
  *
- * Parsing and serialization follow the platform WHATWG `URL` behavior. Relative
- * inputs need an explicit base, assigned components may be normalized or
- * percent-encoded by `URL`, and query strings should usually be handled through
- * `UrlParams` when preserving repeated keys or applying key/value encoding is
- * important.
+ * **Mental model**
+ *
+ * `fromString` returns a `Result` instead of throwing when URL construction
+ * fails. Setters never mutate the original `URL`; each one clones the input and
+ * assigns the requested component on the clone. Use `mutate` when several
+ * component assignments should happen on the same clone.
+ *
+ * **Common tasks**
+ *
+ * - Parse absolute URLs, or resolve relative URL strings against a base URL.
+ * - Pipe setters to adjust host, protocol, path, credentials, search, or hash.
+ * - Extract query parameters with `urlParams`.
+ * - Replace or transform query parameters with `setUrlParams` and
+ *   `modifyUrlParams`.
+ *
+ * **Gotchas**
+ *
+ * Relative input needs an explicit base. Component assignment and serialization
+ * follow platform `URL` rules, so values may be normalized or percent-encoded.
+ * `setPassword` accepts `Redacted` input, but the resulting `URL` still contains
+ * the actual credential and should be treated as sensitive when serialized.
  *
  * @since 4.0.0
  */
@@ -21,7 +37,7 @@ import * as Redacted from "../../Redacted.js";
 import * as Result from "../../Result.js";
 import * as UrlParams from "./UrlParams.js";
 /**
- * Parses a URL string into a `URL` object, returning an `Result` type for safe
+ * Parses a URL string safely into a `URL` object, returning a `Result` type for
  * error handling.
  *
  * **Details**
@@ -75,8 +91,7 @@ export const fromString = (url, base) => Result.try({
   catch: () => new Cause.IllegalArgumentError(`Invalid URL: "${url}"${base !== undefined ? ` with base "${base}"` : ""}`)
 });
 /**
- * This function clones the original `URL` object and applies a callback to the
- * clone, allowing multiple updates at once.
+ * Updates a cloned `URL` with a callback, allowing multiple changes at once.
  *
  * **Example** (Mutating URL credentials)
  *
@@ -94,7 +109,7 @@ export const fromString = (url, base) => Result.try({
  * // Output: Mutated: https://user:pass@example.com/
  * ```
  *
- * @category Modifiers
+ * @category modifiers
  * @since 4.0.0
  */
 export const mutate = /*#__PURE__*/dual(2, (self, f) => {
@@ -238,7 +253,7 @@ export const setUrlParams = /*#__PURE__*/dual(2, (url, searchParams) => mutate(u
  */
 export const urlParams = url => UrlParams.fromInput(url.searchParams);
 /**
- * Reads, modifies, and updates the query parameters of a URL.
+ * Reads the query parameters of a URL, modifies them, and updates the URL.
  *
  * **Details**
  *
@@ -260,7 +275,7 @@ export const urlParams = url => UrlParams.fromInput(url.searchParams);
  * // Output: https://example.com/?foo=bar&key=value
  * ```
  *
- * @category Modifiers
+ * @category modifiers
  * @since 4.0.0
  */
 export const modifyUrlParams = /*#__PURE__*/dual(2, (url, f) => mutate(url, url => {

package/dist/unstable/http/Url.js.map

@@ -1 +1 @@
-{"version":3,"file":"Url.js","names":["Cause","dual","Redacted","Result","UrlParams","fromString","url","base","try","URL","catch","IllegalArgumentError","undefined","mutate","self","f","copy","immutableURLSetter","property","value","setHash","setHost","setHostname","setHref","setPassword","password","setPathname","setPort","setProtocol","setSearch","setUsername","setUrlParams","searchParams","search","toString","urlParams","fromInput","modifyUrlParams","params"],"sources":["../../../src/unstable/http/Url.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Url.js","names":["Cause","dual","Redacted","Result","UrlParams","fromString","url","base","try","URL","catch","IllegalArgumentError","undefined","mutate","self","f","copy","immutableURLSetter","property","value","setHash","setHost","setHostname","setHref","setPassword","password","setPathname","setPort","setProtocol","setSearch","setUsername","setUrlParams","searchParams","search","toString","urlParams","fromInput","modifyUrlParams","params"],"sources":["../../../src/unstable/http/Url.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/http/UrlParams.d.ts

@@ -1,23 +1,38 @@
 /**
- * Utilities for representing, transforming, and serializing URL query
- * parameters.
+ * Immutable URL query parameters represented as ordered string pairs.
+ *
+ * This module is the shared query-parameter model for HTTP client request
+ * queries, URL-encoded form bodies, and server-side decoding. A `UrlParams`
+ * value can be built from records, iterables, or native `URLSearchParams`, then
+ * inspected, appended, replaced, removed, serialized, converted to a `URL`, or
+ * decoded with schemas.
+ *
+ * **Mental model**
+ *
+ * The core representation is a list of `[key, value]` string pairs. Duplicate
+ * keys and pair order are preserved by `make`, `fromInput`, iteration, and
+ * append-style operations. Record input is a convenience layer: primitive values
+ * become strings, arrays become repeated parameters, nested records use bracket
+ * notation, and `undefined` fields are skipped.
+ *
+ * **Common tasks**
+ *
+ * - Build query parameters from plain records, tuples, or `URLSearchParams`.
+ * - Read the first, last, or all values for a key.
+ * - Replace, append, transform, or remove keys without mutating the original.
+ * - Serialize a query string, merge parameters into a URL, or decode records and
+ *   JSON fields with schemas.
+ *
+ * **Gotchas**
  *
- * This module provides an immutable `UrlParams` collection backed by ordered
- * string key-value pairs. It is used for HTTP client request queries,
- * URL-encoded form bodies, and server-side decoding workflows where query
- * parameters need to be built from records, iterables, or native
- * `URLSearchParams`, then inspected, appended, replaced, removed, converted to a
- * URL, or decoded with schemas.
- *
- * Duplicate keys are preserved by the core representation and by append-style
- * operations; use `getAll` when all values matter, and note that `set` and
- * `setAll` replace existing values for matching keys. Serialization through
- * `toString` and `makeUrl` delegates to the platform `URLSearchParams` / `URL`
- * implementations, so provide decoded strings rather than pre-encoded query
- * fragments. Record-based and schema-based conversions intentionally collapse
- * repeated keys into string arrays and do not preserve the full global pair
- * ordering; `schemaJsonField` reads the first matching value for the selected
- * field.
+ * Use `getAll` when every duplicate value matters. `set` and `setAll` replace
+ * existing values for matching keys, while `append` and `appendAll` preserve
+ * them. Serialization through `toString` and `makeUrl` delegates to the platform
+ * `URLSearchParams` / `URL` implementations, so pass decoded strings rather
+ * than pre-encoded query fragments. Record-based and schema-based conversions
+ * collapse repeated keys into string arrays and do not preserve the full global
+ * pair ordering; `schemaJsonField` reads the first matching value for the
+ * selected field.
  *
  * @since 4.0.0
  */
@@ -121,14 +136,14 @@ export declare const make: (params: ReadonlyArray<readonly [string, string]>) =>
  */
 export declare const fromInput: (input: Input) => UrlParams;
 /**
- * Order-sensitive equivalence for `UrlParams`.
+ * Provides an order-sensitive `Equivalence` instance for `UrlParams`.
  *
  * **Details**
  *
  * Two values are equivalent when they contain the same key-value pairs in the same
  * order.
  *
- * @category Equivalence
+ * @category instances
  * @since 4.0.0
  */
 export declare const Equivalence: Equ.Equivalence<UrlParams>;
@@ -193,7 +208,7 @@ export declare const getAll: {
     (self: UrlParams, key: string): ReadonlyArray<string>;
 };
 /**
- * Returns the first value for a query parameter key.
+ * Returns the first value for a query parameter key safely.
  *
  * **Details**
  *
@@ -204,7 +219,7 @@ export declare const getAll: {
  */
 export declare const getFirst: {
     /**
-     * Returns the first value for a query parameter key.
+     * Returns the first value for a query parameter key safely.
      *
      * **Details**
      *
@@ -215,7 +230,7 @@ export declare const getFirst: {
      */
     (key: string): (self: UrlParams) => Option.Option<string>;
     /**
-     * Returns the first value for a query parameter key.
+     * Returns the first value for a query parameter key safely.
      *
      * **Details**
      *
@@ -227,7 +242,7 @@ export declare const getFirst: {
     (self: UrlParams, key: string): Option.Option<string>;
 };
 /**
- * Returns the last value for a query parameter key.
+ * Returns the last value for a query parameter key safely.
  *
  * **Details**
  *
@@ -238,7 +253,7 @@ export declare const getFirst: {
  */
 export declare const getLast: {
     /**
-     * Returns the last value for a query parameter key.
+     * Returns the last value for a query parameter key safely.
      *
      * **Details**
      *
@@ -249,7 +264,7 @@ export declare const getLast: {
      */
     (key: string): (self: UrlParams) => Option.Option<string>;
     /**
-     * Returns the last value for a query parameter key.
+     * Returns the last value for a query parameter key safely.
      *
      * **Details**
      *
@@ -460,7 +475,7 @@ export declare class UrlParamsError extends UrlParamsError_base<{
 }> {
 }
 /**
- * Creates a `URL` by appending `UrlParams` and an optional hash to a URL string.
+ * Creates a `URL` safely by appending `UrlParams` and an optional hash to a URL string.
  *
  * **Details**
  *
@@ -528,7 +543,7 @@ export declare const toReadonlyRecord: (self: UrlParams) => ReadonlyRecord<strin
 export interface schemaJsonField extends Schema.decodeTo<Schema.UnknownFromJsonString, UrlParamsSchema> {
 }
 /**
- * Extract a JSON value from the first occurrence of the given `field` in the
+ * Extracts a JSON value from the first occurrence of the given `field` in the
  * `UrlParams`.
  *
  * **Example** (Decoding JSON parameter fields)

package/dist/unstable/http/UrlParams.d.ts.map

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

package/dist/unstable/http/UrlParams.js

@@ -1,23 +1,38 @@
 /**
- * Utilities for representing, transforming, and serializing URL query
- * parameters.
- *
- * This module provides an immutable `UrlParams` collection backed by ordered
- * string key-value pairs. It is used for HTTP client request queries,
- * URL-encoded form bodies, and server-side decoding workflows where query
- * parameters need to be built from records, iterables, or native
- * `URLSearchParams`, then inspected, appended, replaced, removed, converted to a
- * URL, or decoded with schemas.
- *
- * Duplicate keys are preserved by the core representation and by append-style
- * operations; use `getAll` when all values matter, and note that `set` and
- * `setAll` replace existing values for matching keys. Serialization through
- * `toString` and `makeUrl` delegates to the platform `URLSearchParams` / `URL`
- * implementations, so provide decoded strings rather than pre-encoded query
- * fragments. Record-based and schema-based conversions intentionally collapse
- * repeated keys into string arrays and do not preserve the full global pair
- * ordering; `schemaJsonField` reads the first matching value for the selected
- * field.
+ * Immutable URL query parameters represented as ordered string pairs.
+ *
+ * This module is the shared query-parameter model for HTTP client request
+ * queries, URL-encoded form bodies, and server-side decoding. A `UrlParams`
+ * value can be built from records, iterables, or native `URLSearchParams`, then
+ * inspected, appended, replaced, removed, serialized, converted to a `URL`, or
+ * decoded with schemas.
+ *
+ * **Mental model**
+ *
+ * The core representation is a list of `[key, value]` string pairs. Duplicate
+ * keys and pair order are preserved by `make`, `fromInput`, iteration, and
+ * append-style operations. Record input is a convenience layer: primitive values
+ * become strings, arrays become repeated parameters, nested records use bracket
+ * notation, and `undefined` fields are skipped.
+ *
+ * **Common tasks**
+ *
+ * - Build query parameters from plain records, tuples, or `URLSearchParams`.
+ * - Read the first, last, or all values for a key.
+ * - Replace, append, transform, or remove keys without mutating the original.
+ * - Serialize a query string, merge parameters into a URL, or decode records and
+ *   JSON fields with schemas.
+ *
+ * **Gotchas**
+ *
+ * Use `getAll` when every duplicate value matters. `set` and `setAll` replace
+ * existing values for matching keys, while `append` and `appendAll` preserve
+ * them. Serialization through `toString` and `makeUrl` delegates to the platform
+ * `URLSearchParams` / `URL` implementations, so pass decoded strings rather
+ * than pre-encoded query fragments. Record-based and schema-based conversions
+ * collapse repeated keys into string arrays and do not preserve the full global
+ * pair ordering; `schemaJsonField` reads the first matching value for the
+ * selected field.
  *
  * @since 4.0.0
  */
@@ -124,14 +139,14 @@ const fromInputNested = input => {
   return out;
 };
 /**
- * Order-sensitive equivalence for `UrlParams`.
+ * Provides an order-sensitive `Equivalence` instance for `UrlParams`.
  *
  * **Details**
  *
  * Two values are equivalent when they contain the same key-value pairs in the same
  * order.
  *
- * @category Equivalence
+ * @category instances
  * @since 4.0.0
  */
 export const Equivalence = /*#__PURE__*/Equ.make((a, b) => arrayEquivalence(a.params, b.params));
@@ -187,7 +202,7 @@ export const getAll = /*#__PURE__*/dual(2, (self, key) => Arr.reduce(self.params
   return acc;
 }));
 /**
- * Returns the first value for a query parameter key.
+ * Returns the first value for a query parameter key safely.
  *
  * **Details**
  *
@@ -198,7 +213,7 @@ export const getAll = /*#__PURE__*/dual(2, (self, key) => Arr.reduce(self.params
  */
 export const getFirst = /*#__PURE__*/dual(2, (self, key) => Arr.findFirst(self.params, ([k]) => k === key).pipe(Option.map(([, value]) => value)));
 /**
- * Returns the last value for a query parameter key.
+ * Returns the last value for a query parameter key safely.
  *
  * **Details**
  *
@@ -288,7 +303,7 @@ export const remove = /*#__PURE__*/dual(2, (self, key) => transform(self, Arr.fi
  */
 export class UrlParamsError extends /*#__PURE__*/Data.TaggedError("UrlParamsError") {}
 /**
- * Creates a `URL` by appending `UrlParams` and an optional hash to a URL string.
+ * Creates a `URL` safely by appending `UrlParams` and an optional hash to a URL string.
  *
  * **Details**
  *
@@ -385,7 +400,7 @@ export const toRecord = self => {
  */
 export const toReadonlyRecord = toRecord;
 /**
- * Extract a JSON value from the first occurrence of the given `field` in the
+ * Extracts a JSON value from the first occurrence of the given `field` in the
  * `UrlParams`.
  *
  * **Example** (Decoding JSON parameter fields)

package/dist/unstable/http/UrlParams.js.map

@@ -1 +1 @@
-{"version":3,"file":"UrlParams.js","names":["Arr","Data","Effect","Equal","Equ","dual","Hash","PipeInspectableProto","Option","hasProperty","Result","Schema","Issue","Transformation","Tuple","TypeId","isUrlParams","u","Proto","Symbol","iterator","params","toJSON","_id","Object","fromEntries","symbol","that","Equivalence","array","flat","make","self","create","fromInput","input","parsed","fromInputNested","out","i","length","Array","isArray","keys","value","push","slice","join","entries","fromIterable","key","undefined","String","nested","k","v","a","b","arrayEquivalence","makeEquivalence","strictEqual","UrlParamsSchema","declare","typeConstructor","_tag","generation","runtime","Type","Encoded","importDeclaration","expected","toEquivalence","toCodec","link","transform","decode","encode","empty","getAll","reduce","acc","getFirst","findFirst","pipe","map","getLast","findLast","set","append","filter","f","setAll","Set","add","has","appendAll","remove","UrlParamsError","TaggedError","makeUrl","url","hash","urlInstance","URL","baseUrl","searchParams","succeed","e","fail","cause","toString","URLSearchParams","globalThis","location","origin","pathname","toRecord","curr","toReadonlyRecord","schemaJsonField","field","decodeTo","UnknownFromJsonString","transformOrFail","match","onNone","Pointer","MissingKey","onSome","schemaRecord","Record","Union","NonEmptyArray"],"sources":["../../../src/unstable/http/UrlParams.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"UrlParams.js","names":["Arr","Data","Effect","Equal","Equ","dual","Hash","PipeInspectableProto","Option","hasProperty","Result","Schema","Issue","Transformation","Tuple","TypeId","isUrlParams","u","Proto","Symbol","iterator","params","toJSON","_id","Object","fromEntries","symbol","that","Equivalence","array","flat","make","self","create","fromInput","input","parsed","fromInputNested","out","i","length","Array","isArray","keys","value","push","slice","join","entries","fromIterable","key","undefined","String","nested","k","v","a","b","arrayEquivalence","makeEquivalence","strictEqual","UrlParamsSchema","declare","typeConstructor","_tag","generation","runtime","Type","Encoded","importDeclaration","expected","toEquivalence","toCodec","link","transform","decode","encode","empty","getAll","reduce","acc","getFirst","findFirst","pipe","map","getLast","findLast","set","append","filter","f","setAll","Set","add","has","appendAll","remove","UrlParamsError","TaggedError","makeUrl","url","hash","urlInstance","URL","baseUrl","searchParams","succeed","e","fail","cause","toString","URLSearchParams","globalThis","location","origin","pathname","toRecord","curr","toReadonlyRecord","schemaJsonField","field","decodeTo","UnknownFromJsonString","transformOrFail","match","onNone","Pointer","MissingKey","onSome","schemaRecord","Record","Union","NonEmptyArray"],"sources":["../../../src/unstable/http/UrlParams.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}