@bessemer/cornerstone 0.5.109 → 0.5.110

package/dist/net/uri.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/net/uri.ts"],"sourcesContent":["import { NominalType, TaggedType } from '@bessemer/cornerstone/types'\nimport * as Strings from '@bessemer/cornerstone/string'\nimport { StringSplitResult } from '@bessemer/cornerstone/string'\nimport * as Objects from '@bessemer/cornerstone/object'\nimport * as Arrays from '@bessemer/cornerstone/array'\nimport * as ResourceKeys from '@bessemer/cornerstone/resource-key'\nimport * as Results from '@bessemer/cornerstone/result'\nimport { Result, success } from '@bessemer/cornerstone/result'\nimport * as ErrorEvents from '@bessemer/cornerstone/error/error-event'\nimport { ErrorEvent } from '@bessemer/cornerstone/error/error-event'\nimport { structuredTransform } from '@bessemer/cornerstone/zod-util'\nimport Zod from 'zod'\nimport * as IpV6Addresses from '@bessemer/cornerstone/net/ipv6-address'\nimport { ValueOf } from 'type-fest'\nimport * as Equalitors from '@bessemer/cornerstone/equalitor'\nimport { Equalitor } from '@bessemer/cornerstone/equalitor'\nimport * as UriHostNames from '@bessemer/cornerstone/net/uri-host-name'\nimport { UriHostName } from '@bessemer/cornerstone/net/uri-host-name'\n\nexport type UriString = TaggedType<string, 'UriString'>\nexport type UriComponent = string\n\nexport type UriScheme = string\n\nexport type UriAuthentication = {\n  principal: string\n  password: string | null\n}\n\nexport type UriHost = {\n  value: UriHostName\n  port: number | null\n}\n\nexport interface UriLocation {\n  path: string | null\n  query: string | null\n  fragment: string | null\n}\n\nexport const Namespace = ResourceKeys.createNamespace('uri')\nexport const UrlNamespace = ResourceKeys.createNamespace('url')\nexport const EqualBy: Equalitor<Uri> = Equalitors.deepNatural()\n\nexport type UriLiteral = NominalType<string, typeof Namespace>\n\nexport interface UriStructure {\n  _type: typeof Namespace | typeof UrlNamespace\n  scheme: UriScheme | null\n  host: UriHost | null\n  authentication: UriAuthentication | null\n  location: UriLocation\n}\n\nexport interface Uri extends UriStructure {\n  href: UriLiteral\n}\n\ntype UriBuilderAuthentication =\n  | {\n      principal: string\n      password?: string | null\n    }\n  | string\n\ntype UriBuilderHost =\n  | {\n      value: string\n      port?: number | null\n    }\n  | string\n\ntype UriBuilderLocation =\n  | {\n      path?: string | null\n      query?: string | null\n      fragment?: string | null\n    }\n  | string\n\nexport type UriBuilder = {\n  scheme?: string | null | undefined\n  authentication?: UriBuilderAuthentication | null | undefined\n  host?: UriBuilderHost | null | undefined\n  location?: UriBuilderLocation | null | undefined\n}\n\nexport type UriLike = Uri | UriLiteral | UriBuilder\n\n/**\n * Parses a string into a Uri object, handling all URI components including scheme,\n * authority (host and authentication), and location (path, query, fragment).\n * Returns a Result containing either the parsed Uri or an ErrorEvent on failure.\n *\n * **Example**\n *\n * ```ts\n * import { Uris } from \"@bessemer/cornerstone\"\n *\n * // Parse a complete HTTPS URI\n * const result = Uris.parseString('https://user:pass@example.com:8080/api/v1?q=test#section')\n * if (result.isSuccess) {\n *   console.log(result.value.scheme) // 'https'\n *   console.log(result.value.host?.value) // 'example.com'\n *   console.log(result.value.authentication?.principal) // 'user'\n * }\n *\n * // Parse a simple URI without authority\n * const urnResult = Uris.parseString('urn:isbn:0451450523')\n * if (urnResult.isSuccess) {\n *   console.log(urnResult.value.scheme) // 'urn'\n *   console.log(urnResult.value.location.path) // 'isbn:0451450523'\n * }\n * ```\n *\n * @category parsing\n */\nexport const parseString = (value: string): Result<Uri, ErrorEvent> => {\n  // JOHN we want to improve the syntax burden of handling a series of Result objects like this\n  if (Strings.isBlank(value)) {\n    return Results.failure(\n      ErrorEvents.required({\n        namespace: Namespace,\n        message: `[${Namespace}]: Unable to parse Uri from empty string.`,\n      })\n    )\n  }\n\n  const schemeResult = parseSchemePart(value)\n  if (!schemeResult.isSuccess) {\n    return Results.failure(\n      ErrorEvents.invalidValue(value, {\n        namespace: Namespace,\n        message: `[${Namespace}]: Unable to parse Uri from string: [${value}]`,\n        causes: schemeResult.value.causes,\n      })\n    )\n  }\n\n  const [scheme, rest1] = schemeResult.value\n\n  const authorityPartResult = parseAuthorityPart(rest1)\n  if (!authorityPartResult.isSuccess) {\n    return Results.failure(\n      ErrorEvents.invalidValue(value, {\n        namespace: Namespace,\n        message: `[${Namespace}]: Unable to parse Uri from string: [${value}]`,\n        causes: authorityPartResult.value.causes,\n      })\n    )\n  }\n  const [authority, rest2] = authorityPartResult.value\n\n  const location = parseLocation(rest2)\n\n  const structure: UriStructure = {\n    _type: Namespace,\n    scheme,\n    host: authority.host,\n    authentication: authority.authentication,\n    location,\n  }\n\n  return Results.success({\n    ...structure,\n    href: formatInternal(structure),\n  })\n}\n\n/**\n * Converts various URI-like inputs into a Uri object. Handles Uri instances,\n * string literals, and builder objects, returning them as-is when already a Uri\n * or converting them appropriately.\n *\n * **Example**\n *\n * ```ts\n * import { Uris } from \"@bessemer/cornerstone\"\n *\n * // String literal parsed into Uri\n * const fromString = Uris.from('https://api.example.com/v1')\n * console.log(fromString.scheme) // 'https'\n * console.log(fromString.host?.value) // 'api.example.com'\n *\n * // Builder object converted to Uri\n * const fromBuilder = Uris.from({\n *   scheme: 'https',\n *   host: { value: 'example.com', port: 8080 },\n *   location: { path: '/api' }\n * })\n * console.log(fromBuilder.host?.port) // 8080\n *\n * @category conversion\n */\nexport function from(value: UriLike | string): Uri\nexport function from(value: UriLike | string | null): Uri | null\nexport function from(value: UriLike | string | undefined): Uri | undefined\nexport function from(value: UriLike | string | null | undefined): Uri | null | undefined\nexport function from(value: UriLike | string | null | undefined): Uri | null | undefined {\n  if (Objects.isNil(value)) {\n    return value\n  }\n  if (isUri(value)) {\n    return value\n  }\n  if (Strings.isString(value)) {\n    return ErrorEvents.unpackResult(parseString(value))\n  }\n\n  return build(value as UriBuilder)\n}\n\n/**\n * Converts various URI-like inputs into a normalized string literal representation.\n * Takes any URI-like value and returns its canonical string form\n *\n * **Example**\n *\n * ```ts\n * import { Uris } from \"@bessemer/cornerstone\"\n *\n * // Convert Uri instance to string literal\n * const uri = Uris.build({ scheme: 'https', host: 'example.com', location: { path: '/api' } })\n * const literal = Uris.toLiteral(uri)\n * console.log(literal) // \"https://example.com/api\"\n *\n * // Convert builder object to string literal\n * const fromBuilder = Uris.toLiteral({\n *   scheme: 'https',\n *   host: { value: 'api.example.com', port: 8080 },\n *   authentication: { principal: 'user', password: 'pass' },\n *   location: { path: '/v1', parameters: { q: 'search' } }\n * })\n * console.log(fromBuilder) // \"https://user:pass@api.example.com:8080/v1?q=search\"\n * ```\n *\n * @category serialization\n */\nexport function toLiteral(likeValue: UriLike): UriLiteral\nexport function toLiteral(likeValue: UriLike | null): UriLiteral | null\nexport function toLiteral(likeValue: UriLike | undefined): UriLiteral | undefined\nexport function toLiteral(likeValue: UriLike | null | undefined): UriLiteral | null | undefined\nexport function toLiteral(likeValue: UriLike | null | undefined): UriLiteral | null | undefined {\n  if (Objects.isNil(likeValue)) {\n    return likeValue\n  }\n\n  const value = from(likeValue)\n  return format(value) as UriLiteral\n}\n\nexport const SchemaLiteral = structuredTransform(Zod.string(), (it: string) => parseString(it).map((it) => toLiteral(it)))\n// JOHN need a schema for the object version...\n// export const SchemaInstance = structuredTransform(Zod.string(), parseString)\n\n/**\n * Tests if the provided value is a Uri.\n *\n * **Example**\n *\n * ```ts\n * import { Uris } from \"@bessemer/cornerstone\"\n *\n * // Check if unknown value is a Uri\n * function processValue(value: unknown) {\n *   if (Uris.isUri(value)) {\n *     console.log(value.scheme) // Type-safe access\n *     console.log(value.location.path)\n *   }\n * }\n * ```\n *\n * @category type-guards\n */\nexport const isUri = (value: unknown): value is Uri => {\n  if (!Objects.isObject(value)) {\n    return false\n  }\n\n  const uriValue = value as any as Uri\n  return uriValue._type === Namespace || uriValue._type === UrlNamespace\n}\n\n/**\n * Merges an existing URI with partial changes to create a new URI instance.\n * Allows selective updates without replacing the entire URI.\n *\n * **Example**\n *\n * ```ts\n * import { Uris } from \"@bessemer/cornerstone\"\n *\n * // Start with a base URI\n * const baseUri = Uris.build({\n *   scheme: 'https',\n *   host: { value: 'api.example.com', port: 443 },\n *   authentication: { principal: 'user', password: 'pass' },\n *   location: { path: '/v1', parameters: { format: 'json' } }\n * })\n *\n * // Change just the host and add query parameter\n * const updatedUri = Uris.merge(baseUri, {\n *   host: { value: 'api.production.com' }, // Port preserved from original\n *   location: {\n *     parameters: { version: '2.0' } // Merges with existing parameters\n *   }\n * })\n *\n * console.log(updatedUri.host?.value) // 'api.production.com'\n * console.log(updatedUri.host?.port) // 443 (preserved)\n * console.log(updatedUri.location.parameters) // { format: 'json', version: '2.0' }\n * ```\n *\n * @category transformation\n */\nexport const merge = (element: UriLike, builder: UriBuilder): Uri => {\n  const uri = from(element)\n\n  let location: UriBuilderLocation | null | undefined\n  if (Strings.isString(builder.location) || Objects.isNull(builder.location)) {\n    location = builder.location\n  } else {\n    location = { ...uri.location, ...(builder.location ?? {}) }\n  }\n\n  const uriBuilder: UriBuilder = {\n    scheme: Objects.isUndefined(builder.scheme) ? uri.scheme : builder.scheme,\n    host: Objects.isUndefined(builder.host) ? uri.host : builder.host,\n    authentication: Objects.isUndefined(builder.authentication) ? uri.authentication : builder.authentication,\n    location,\n  }\n\n  return from(uriBuilder)\n}\n\nconst parseSchemePart = (url: UriComponent): Result<[UriScheme | null, UriComponent], ErrorEvent> => {\n  // Search for the colon or double slash\n  const schemeMatch = Strings.splitFirst(url, /(\\/\\/|:)/)\n\n  // If we don't find either, or we hit the double slash before finding a colon, there is no scheme\n  if (Objects.isNil(schemeMatch.selection) || schemeMatch.separator === '//') {\n    return Results.success([null, url])\n  }\n\n  // This means the string started with :, so no protocol\n  if (Strings.isEmpty(schemeMatch.selection)) {\n    return Results.success([null, ':' + schemeMatch.rest])\n  } else {\n    const schemeResult = parseScheme(schemeMatch.selection)\n    if (!schemeResult.isSuccess) {\n      return schemeResult\n    }\n\n    return Results.success([schemeResult.value, schemeMatch.rest])\n  }\n}\n\nconst parseScheme = (scheme: UriComponent): Result<UriScheme, ErrorEvent> => {\n  // RFC 3986: scheme = ALPHA *( ALPHA / DIGIT / \"+\" / \"-\" / \".\" )\n  const schemeRegex = /^[a-zA-Z][a-zA-Z0-9+.-]*$/\n  if (!schemeRegex.test(scheme)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(scheme, {\n        namespace: Namespace,\n        message: `[${Namespace}]: Invalid characters in Scheme.`,\n      })\n    )\n  }\n\n  return Results.success(scheme)\n}\n\nconst parseAuthorityPart = (\n  initialUrl: UriComponent\n): Result<[{ host: UriHost | null; authentication: UriAuthentication | null }, UriComponent], ErrorEvent> => {\n  if (!initialUrl.startsWith('//')) {\n    return success([{ host: null, authentication: null }, initialUrl])\n  }\n\n  const url = Strings.removeStart(initialUrl, '//')\n\n  const authenticationPartResult = parseAuthenticationPart(url)\n  if (!authenticationPartResult.isSuccess) {\n    return authenticationPartResult\n  }\n  const [authentication, rest1] = authenticationPartResult.value\n\n  const hostPartResult = parseHostPart(rest1)\n  if (!hostPartResult.isSuccess) {\n    return hostPartResult\n  }\n  const [host, rest2] = hostPartResult.value\n\n  return success([{ host, authentication }, rest2])\n}\n\nconst parseAuthenticationPart = (url: UriComponent): Result<[UriAuthentication | null, UriComponent], ErrorEvent> => {\n  let targetPart = url\n  const queryMatch = Strings.splitFirst(targetPart, '?')\n  const fragmentMatch = Strings.splitFirst(targetPart, '#')\n  if (Objects.isPresent(queryMatch.selection)) {\n    targetPart = queryMatch.selection\n  } else if (Objects.isPresent(fragmentMatch.selection)) {\n    targetPart = fragmentMatch.selection\n  }\n\n  const { selection: authentication } = Strings.splitFirst(targetPart, '@')\n\n  // If there is no @, then we don't have an authentication\n  if (Objects.isNil(authentication)) {\n    return Results.success([null, url])\n  }\n\n  const { rest } = Strings.splitFirst(url, '@')\n\n  const authenticationParseResult = parseAuthentication(authentication)\n  if (!authenticationParseResult.isSuccess) {\n    return authenticationParseResult\n  }\n\n  return Results.success([authenticationParseResult.value, rest])\n}\n\nconst parseAuthentication = (authentication: UriComponent): Result<UriAuthentication, ErrorEvent> => {\n  const { selection: principal, rest: authenticationRest } = Strings.splitFirst(authentication, ':')\n\n  // If there isn't a colon, then there is no password but there is a username\n  if (Objects.isNil(principal)) {\n    if (!isAuthenticationComponentValid(authenticationRest)) {\n      return Results.failure(\n        ErrorEvents.invalidValue(authenticationRest, {\n          namespace: Namespace,\n          message: `[${Namespace}]: Invalid characters for UriAuthentication in principal string: [${authenticationRest}]`,\n        })\n      )\n    }\n\n    return Results.success({ principal: decode(authenticationRest), password: null })\n  }\n\n  // The authentication section started with a :, don't know what to make of this... password but no username?\n  if (Strings.isEmpty(principal)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(authentication, {\n        namespace: Namespace,\n        message: `[${Namespace}]: Unable to parse UriAuthentication from authentication string: [${authentication}]`,\n      })\n    )\n  }\n\n  if (!isAuthenticationComponentValid(principal)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(principal, {\n        namespace: Namespace,\n        message: `[${Namespace}]: Invalid characters for UriAuthentication in principal string: [${principal}]`,\n      })\n    )\n  }\n\n  if (!isAuthenticationComponentValid(authenticationRest)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(authenticationRest, {\n        namespace: Namespace,\n        message: `[${Namespace}]: Invalid characters for UriAuthentication in password string: [${authenticationRest}]`,\n      })\n    )\n  }\n\n  // Otherwise, we have both, so return the complete authentication object and the rest\n  return Results.success({ principal: decode(principal), password: decode(authenticationRest) })\n}\n\nconst isAuthenticationComponentValid = (component: UriComponent): boolean => {\n  const userinfoRegex = /^[A-Za-z0-9\\-._~!$&'()*+,;=%]*$/\n\n  if (component.includes('%')) {\n    const percentEncodingRegex = /%[0-9A-Fa-f]{2}/g\n    const percentMatches = component.match(/%/g) || []\n    const validEncodingMatches = component.match(percentEncodingRegex) || []\n\n    if (percentMatches.length !== validEncodingMatches.length) {\n      return false\n    }\n  }\n\n  return userinfoRegex.test(component)\n}\n\nconst parseHostPart = (url: UriComponent): Result<[UriHost | null, UriComponent], ErrorEvent> => {\n  // Check if the host is starting with reserved characters, if so we should just bail on trying to parse\n  if (url.startsWith('?') || url.startsWith('#')) {\n    return Results.success([null, url])\n  }\n\n  // Lets grab everything to the left of the first / ? or #, this is the remainder of our authority (if any)\n  const urlMatch = Strings.splitFirst(url, /[\\/?#]/)\n  let host = urlMatch.rest\n  let rest = ''\n\n  if (Objects.isPresent(urlMatch.selection)) {\n    host = urlMatch.selection\n    rest = urlMatch.separator + urlMatch.rest\n  }\n\n  if (Strings.isEmpty(host)) {\n    return Results.success([null, rest])\n  }\n\n  const parseHostResult = parseHost(host)\n  if (!parseHostResult.isSuccess) {\n    return parseHostResult\n  }\n\n  return Results.success([parseHostResult.value, rest])\n}\n\nconst parseHost = (host: UriComponent): Result<UriHost, ErrorEvent> => {\n  // Try to see if we have an ipv6 address like the form [2001:db8::7] and handle it\n  if (host.startsWith('[')) {\n    const ipMatch = Strings.splitFirst(Strings.removeStart(host, '['), ']')\n\n    if (Objects.isPresent(ipMatch.selection)) {\n      const ipV6Result = IpV6Addresses.parseString(ipMatch.selection)\n      if (!ipV6Result.isSuccess) {\n        return ipV6Result\n      }\n\n      const portMatch = Strings.splitFirst(ipMatch.rest, ':')\n      if (Objects.isPresent(portMatch.selection) && Strings.isEmpty(portMatch.selection)) {\n        if (!Strings.isNumber(portMatch.rest)) {\n          return Results.failure(ErrorEvents.invalidValue(host, { namespace: Namespace, message: `[${Namespace}]: Unable to parse Host: [${host}]` }))\n        }\n\n        return Results.success({ value: `[${ipMatch.selection}]` as UriHostName, port: Number(portMatch.rest) })\n      } else {\n        return Results.success({ value: `[${ipMatch.selection}]` as UriHostName, port: null })\n      }\n    }\n  }\n\n  let hostMatch: StringSplitResult = Strings.splitFirst(host, ':')\n\n  // We have no :, which means no port, so treat the rest as the hostname\n  if (Objects.isNil(hostMatch.selection)) {\n    const hostNameResult = UriHostNames.parseString(hostMatch.rest)\n    if (!hostNameResult.isSuccess) {\n      return Results.failure(\n        ErrorEvents.invalidValue(host, {\n          namespace: Namespace,\n          message: `[${Namespace}]: Unable to parse Host from host string: [${host}]`,\n          causes: hostNameResult.value.causes,\n        })\n      )\n    }\n\n    return Results.success({ value: hostNameResult.value, port: null })\n  }\n\n  // The host started with a :, this is odd\n  if (Strings.isEmpty(hostMatch.selection)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(host, { namespace: Namespace, message: `[${Namespace}]: Unable to parse Host from host string: [${host}]` })\n    )\n  }\n\n  const hostName = hostMatch.selection\n\n  if (!Strings.isNumber(hostMatch.rest)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(host, { namespace: Namespace, message: `[${Namespace}]: Unable to parse Host from host string: [${host}]` })\n    )\n  }\n\n  // Otherwise, we have both, so return the complete authentication object and the rest\n  const hostNameResult = UriHostNames.parseString(hostName)\n  if (!hostNameResult.isSuccess) {\n    return Results.failure(\n      ErrorEvents.invalidValue(host, {\n        namespace: Namespace,\n        message: `[${Namespace}]: Unable to parse Host from host string: [${host}]`,\n        causes: hostNameResult.value.causes,\n      })\n    )\n  }\n\n  return Results.success({ value: hostNameResult.value, port: Number(hostMatch.rest) })\n}\n\nconst parseLocation = (url: UriComponent): UriLocation => {\n  const location: UriLocation = { path: null, query: null, fragment: null }\n\n  // Lets see if we have a fragment and parse it off the end\n  const fragmentMatch = Strings.splitFirst(url, '#')\n  if (Objects.isPresent(fragmentMatch.selection) && !Strings.isEmpty(fragmentMatch.rest)) {\n    location.fragment = encodeWhitespace(fragmentMatch.rest)\n  }\n\n  // Lets see if we have a query string and parse it off the remainder\n  const queryMatch = Strings.splitFirst(fragmentMatch.selection ?? fragmentMatch.rest, '?')\n  if (Objects.isPresent(queryMatch.selection) && !Strings.isEmpty(queryMatch.rest)) {\n    location.query = encodeWhitespace(queryMatch.rest)\n  }\n\n  const path = Strings.emptyToNull(queryMatch.selection ?? queryMatch.rest)\n  if (Objects.isPresent(path)) {\n    location.path = encodeWhitespace(path)\n  }\n  return location\n}\n\nconst build = (builder: UriBuilder): Uri => {\n  const scheme = Objects.isPresent(builder.scheme) ? ErrorEvents.unpackResult(parseScheme(builder.scheme)) : null\n  let host: UriHost | null = null\n  let authentication: UriAuthentication | null = null\n\n  if (Objects.isPresent(builder.host)) {\n    if (Strings.isString(builder.host)) {\n      host = ErrorEvents.unpackResult(parseHost(builder.host))\n    } else {\n      host = {\n        value: UriHostNames.from(builder.host.value),\n        port: builder.host.port ?? null,\n      }\n    }\n\n    if (Objects.isPresent(builder.authentication)) {\n      if (Strings.isString(builder.authentication)) {\n        authentication = ErrorEvents.unpackResult(parseAuthentication(builder.authentication))\n      } else {\n        authentication = {\n          principal: builder.authentication.principal,\n          password: builder.authentication.password ?? null,\n        }\n      }\n    }\n  }\n\n  let location: UriLocation = {\n    path: null,\n    query: null,\n    fragment: null,\n  }\n\n  if (Objects.isPresent(builder.location)) {\n    if (Strings.isString(builder.location)) {\n      let locationString = builder.location\n      if (Objects.isPresent(builder.host) && !locationString.startsWith('/') && !locationString.startsWith('?') && !locationString.startsWith('#')) {\n        locationString = '/' + locationString\n      }\n\n      location = parseLocation(locationString)\n    } else {\n      let path = builder.location.path ?? null\n      if (Objects.isPresent(path) && !path.startsWith('/') && Objects.isPresent(builder.host)) {\n        path = '/' + path\n      }\n\n      location = {\n        path: Objects.isPresent(path) ? encodeWhitespace(path) : null,\n        query: Objects.isPresent(builder.location.query) ? encodeWhitespace(builder.location.query) : null,\n        fragment: Objects.isPresent(builder.location.fragment) ? encodeWhitespace(builder.location.fragment) : null,\n      }\n    }\n  }\n\n  const structure: UriStructure = {\n    _type: Namespace,\n    scheme,\n    host,\n    authentication,\n    location,\n  }\n\n  return {\n    ...structure,\n    href: formatInternal(structure),\n  }\n}\n\nexport const UriComponentType = {\n  Scheme: 'Scheme',\n  Authentication: 'Authentication',\n  Host: 'Host',\n  Location: 'Location',\n  Path: 'Path',\n  Query: 'Query',\n  Fragment: 'Fragment',\n} as const\n\nexport type UriComponentType = ValueOf<typeof UriComponentType>\n\n/**\n * Converts a URI object into its string representation, with optional exclusion of specific URI components.\n *\n * **Example**\n *\n * ```ts\n * import { Uris, UriComponentType } from \"@bessemer/cornerstone\"\n *\n * const uri = Uris.build({\n *   scheme: 'https',\n *   authentication: { principal: 'user', password: 'secret' },\n *   host: { value: 'api.example.com', port: 8080 },\n *   location: { path: '/v1/data', parameters: { format: 'json' }, fragment: 'results' }\n * })\n *\n * // Format complete URI\n * const fullUri = Uris.format(uri)\n * console.log(fullUri) // \"https://user:secret@api.example.com:8080/v1/data?format=json#results\"\n *\n * // Exclude authentication for public sharing\n * const publicUri = Uris.format(uri, [UriComponentType.Authentication])\n * console.log(publicUri) // \"https://api.example.com:8080/v1/data?format=json#results\"\n *\n * // Format path-only URI\n * const pathOnly = Uris.format(uri, [\n *   UriComponentType.Scheme,\n *   UriComponentType.Host,\n *   UriComponentType.Authentication\n * ])\n * console.log(pathOnly) // \"/v1/data?format=json#results\"\n * ```\n *\n * @category serialization\n */\nexport const format = (uriLike: UriLike, excludedUriComponents: Array<UriComponentType> = []): UriLiteral => {\n  return formatInternal(from(uriLike), excludedUriComponents)\n}\n\nconst formatInternal = (uri: UriStructure, excludedUriComponents: Array<UriComponentType> = []): UriLiteral => {\n  let urlString = ''\n  if (Objects.isPresent(uri.scheme) && !Arrays.contains(excludedUriComponents, UriComponentType.Scheme)) {\n    urlString = urlString + uri.scheme + ':'\n  }\n\n  if (Objects.isPresent(uri.host) && !Arrays.contains(excludedUriComponents, UriComponentType.Host)) {\n    urlString = urlString + '//'\n\n    if (Objects.isPresent(uri.authentication) && !Arrays.contains(excludedUriComponents, UriComponentType.Authentication)) {\n      urlString = urlString + encode(uri.authentication.principal)\n\n      if (Objects.isPresent(uri.authentication.password)) {\n        urlString = urlString + ':' + encode(uri.authentication.password)\n      }\n\n      urlString = urlString + '@'\n    }\n\n    urlString = urlString + uri.host.value\n    if (Objects.isPresent(uri.host.port)) {\n      urlString = urlString + ':' + uri.host.port\n    }\n  }\n\n  if (!Arrays.contains(excludedUriComponents, UriComponentType.Location)) {\n    urlString = urlString + formatLocation(uri.location, excludedUriComponents)\n  }\n\n  return urlString as UriLiteral\n}\n\nconst formatLocation = (location: UriLocation, excludedUriComponents: Array<UriComponentType> = []): string => {\n  let urlString = ''\n\n  if (Objects.isPresent(location.path) && !Arrays.contains(excludedUriComponents, UriComponentType.Path)) {\n    urlString = urlString + location.path\n  }\n\n  if (Objects.isPresent(location.query) && !Arrays.contains(excludedUriComponents, UriComponentType.Query)) {\n    urlString = urlString + '?' + location.query\n  }\n\n  if (Objects.isPresent(location.fragment) && !Arrays.contains(excludedUriComponents, UriComponentType.Fragment)) {\n    urlString = urlString + '#' + location.fragment\n  }\n\n  return urlString\n}\n\nconst encodeWhitespace = (uriComponent: UriComponent) => {\n  return uriComponent.replaceAll(' ', '%20')\n}\n\nexport const encode = (uriComponent: UriComponent) => {\n  return encodeURIComponent(uriComponent)\n}\n\nexport const decode = (uriComponent: UriComponent) => {\n  return decodeURIComponent(uriComponent)\n}\n"],"mappings":";AACA,YAAY,aAAa;AAEzB,YAAY,aAAa;AACzB,YAAY,YAAY;AACxB,YAAY,kBAAkB;AAC9B,YAAY,aAAa;AACzB,SAAiB,WAAAA,gBAAe;AAChC,YAAY,iBAAiB;AAE7B,SAAS,2BAA2B;AACpC,OAAO,SAAS;AAChB,YAAY,mBAAmB;AAE/B,YAAY,gBAAgB;AAE5B,YAAY,kBAAkB;AAwBvB,IAAM,YAAyB,6BAAgB,KAAK;AACpD,IAAM,eAA4B,6BAAgB,KAAK;AACvD,IAAM,UAAqC,uBAAY;AA2EvD,IAAMC,eAAc,CAAC,UAA2C;AAErE,MAAY,gBAAQ,KAAK,GAAG;AAC1B,WAAe;AAAA,MACD,qBAAS;AAAA,QACnB,WAAW;AAAA,QACX,SAAS,IAAI,SAAS;AAAA,MACxB,CAAC;AAAA,IACH;AAAA,EACF;AAEA,QAAM,eAAe,gBAAgB,KAAK;AAC1C,MAAI,CAAC,aAAa,WAAW;AAC3B,WAAe;AAAA,MACD,yBAAa,OAAO;AAAA,QAC9B,WAAW;AAAA,QACX,SAAS,IAAI,SAAS,wCAAwC,KAAK;AAAA,QACnE,QAAQ,aAAa,MAAM;AAAA,MAC7B,CAAC;AAAA,IACH;AAAA,EACF;AAEA,QAAM,CAAC,QAAQ,KAAK,IAAI,aAAa;AAErC,QAAM,sBAAsB,mBAAmB,KAAK;AACpD,MAAI,CAAC,oBAAoB,WAAW;AAClC,WAAe;AAAA,MACD,yBAAa,OAAO;AAAA,QAC9B,WAAW;AAAA,QACX,SAAS,IAAI,SAAS,wCAAwC,KAAK;AAAA,QACnE,QAAQ,oBAAoB,MAAM;AAAA,MACpC,CAAC;AAAA,IACH;AAAA,EACF;AACA,QAAM,CAAC,WAAW,KAAK,IAAI,oBAAoB;AAE/C,QAAM,WAAW,cAAc,KAAK;AAEpC,QAAM,YAA0B;AAAA,IAC9B,OAAO;AAAA,IACP;AAAA,IACA,MAAM,UAAU;AAAA,IAChB,gBAAgB,UAAU;AAAA,IAC1B;AAAA,EACF;AAEA,SAAe,gBAAQ;AAAA,IACrB,GAAG;AAAA,IACH,MAAM,eAAe,SAAS;AAAA,EAChC,CAAC;AACH;AA+BO,SAASC,MAAK,OAAoE;AACvF,MAAY,cAAM,KAAK,GAAG;AACxB,WAAO;AAAA,EACT;AACA,MAAI,MAAM,KAAK,GAAG;AAChB,WAAO;AAAA,EACT;AACA,MAAY,iBAAS,KAAK,GAAG;AAC3B,WAAmB,yBAAaD,aAAY,KAAK,CAAC;AAAA,EACpD;AAEA,SAAO,MAAM,KAAmB;AAClC;AAgCO,SAAS,UAAU,WAAsE;AAC9F,MAAY,cAAM,SAAS,GAAG;AAC5B,WAAO;AAAA,EACT;AAEA,QAAM,QAAQC,MAAK,SAAS;AAC5B,SAAO,OAAO,KAAK;AACrB;AAEO,IAAM,gBAAgB,oBAAoB,IAAI,OAAO,GAAG,CAAC,OAAeD,aAAY,EAAE,EAAE,IAAI,CAACE,QAAO,UAAUA,GAAE,CAAC,CAAC;AAuBlH,IAAM,QAAQ,CAAC,UAAiC;AACrD,MAAI,CAAS,iBAAS,KAAK,GAAG;AAC5B,WAAO;AAAA,EACT;AAEA,QAAM,WAAW;AACjB,SAAO,SAAS,UAAU,aAAa,SAAS,UAAU;AAC5D;AAkCO,IAAM,QAAQ,CAAC,SAAkB,YAA6B;AACnE,QAAM,MAAMD,MAAK,OAAO;AAExB,MAAI;AACJ,MAAY,iBAAS,QAAQ,QAAQ,KAAa,eAAO,QAAQ,QAAQ,GAAG;AAC1E,eAAW,QAAQ;AAAA,EACrB,OAAO;AACL,eAAW,EAAE,GAAG,IAAI,UAAU,GAAI,QAAQ,YAAY,CAAC,EAAG;AAAA,EAC5D;AAEA,QAAM,aAAyB;AAAA,IAC7B,QAAgB,oBAAY,QAAQ,MAAM,IAAI,IAAI,SAAS,QAAQ;AAAA,IACnE,MAAc,oBAAY,QAAQ,IAAI,IAAI,IAAI,OAAO,QAAQ;AAAA,IAC7D,gBAAwB,oBAAY,QAAQ,cAAc,IAAI,IAAI,iBAAiB,QAAQ;AAAA,IAC3F;AAAA,EACF;AAEA,SAAOA,MAAK,UAAU;AACxB;AAEA,IAAM,kBAAkB,CAAC,QAA4E;AAEnG,QAAM,cAAsB,mBAAW,KAAK,UAAU;AAGtD,MAAY,cAAM,YAAY,SAAS,KAAK,YAAY,cAAc,MAAM;AAC1E,WAAe,gBAAQ,CAAC,MAAM,GAAG,CAAC;AAAA,EACpC;AAGA,MAAY,gBAAQ,YAAY,SAAS,GAAG;AAC1C,WAAe,gBAAQ,CAAC,MAAM,MAAM,YAAY,IAAI,CAAC;AAAA,EACvD,OAAO;AACL,UAAM,eAAe,YAAY,YAAY,SAAS;AACtD,QAAI,CAAC,aAAa,WAAW;AAC3B,aAAO;AAAA,IACT;AAEA,WAAe,gBAAQ,CAAC,aAAa,OAAO,YAAY,IAAI,CAAC;AAAA,EAC/D;AACF;AAEA,IAAM,cAAc,CAAC,WAAwD;AAE3E,QAAM,cAAc;AACpB,MAAI,CAAC,YAAY,KAAK,MAAM,GAAG;AAC7B,WAAe;AAAA,MACD,yBAAa,QAAQ;AAAA,QAC/B,WAAW;AAAA,QACX,SAAS,IAAI,SAAS;AAAA,MACxB,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAe,gBAAQ,MAAM;AAC/B;AAEA,IAAM,qBAAqB,CACzB,eAC2G;AAC3G,MAAI,CAAC,WAAW,WAAW,IAAI,GAAG;AAChC,WAAOF,SAAQ,CAAC,EAAE,MAAM,MAAM,gBAAgB,KAAK,GAAG,UAAU,CAAC;AAAA,EACnE;AAEA,QAAM,MAAc,oBAAY,YAAY,IAAI;AAEhD,QAAM,2BAA2B,wBAAwB,GAAG;AAC5D,MAAI,CAAC,yBAAyB,WAAW;AACvC,WAAO;AAAA,EACT;AACA,QAAM,CAAC,gBAAgB,KAAK,IAAI,yBAAyB;AAEzD,QAAM,iBAAiB,cAAc,KAAK;AAC1C,MAAI,CAAC,eAAe,WAAW;AAC7B,WAAO;AAAA,EACT;AACA,QAAM,CAAC,MAAM,KAAK,IAAI,eAAe;AAErC,SAAOA,SAAQ,CAAC,EAAE,MAAM,eAAe,GAAG,KAAK,CAAC;AAClD;AAEA,IAAM,0BAA0B,CAAC,QAAoF;AACnH,MAAI,aAAa;AACjB,QAAM,aAAqB,mBAAW,YAAY,GAAG;AACrD,QAAM,gBAAwB,mBAAW,YAAY,GAAG;AACxD,MAAY,kBAAU,WAAW,SAAS,GAAG;AAC3C,iBAAa,WAAW;AAAA,EAC1B,WAAmB,kBAAU,cAAc,SAAS,GAAG;AACrD,iBAAa,cAAc;AAAA,EAC7B;AAEA,QAAM,EAAE,WAAW,eAAe,IAAY,mBAAW,YAAY,GAAG;AAGxE,MAAY,cAAM,cAAc,GAAG;AACjC,WAAe,gBAAQ,CAAC,MAAM,GAAG,CAAC;AAAA,EACpC;AAEA,QAAM,EAAE,KAAK,IAAY,mBAAW,KAAK,GAAG;AAE5C,QAAM,4BAA4B,oBAAoB,cAAc;AACpE,MAAI,CAAC,0BAA0B,WAAW;AACxC,WAAO;AAAA,EACT;AAEA,SAAe,gBAAQ,CAAC,0BAA0B,OAAO,IAAI,CAAC;AAChE;AAEA,IAAM,sBAAsB,CAAC,mBAAwE;AACnG,QAAM,EAAE,WAAW,WAAW,MAAM,mBAAmB,IAAY,mBAAW,gBAAgB,GAAG;AAGjG,MAAY,cAAM,SAAS,GAAG;AAC5B,QAAI,CAAC,+BAA+B,kBAAkB,GAAG;AACvD,aAAe;AAAA,QACD,yBAAa,oBAAoB;AAAA,UAC3C,WAAW;AAAA,UACX,SAAS,IAAI,SAAS,qEAAqE,kBAAkB;AAAA,QAC/G,CAAC;AAAA,MACH;AAAA,IACF;AAEA,WAAe,gBAAQ,EAAE,WAAW,OAAO,kBAAkB,GAAG,UAAU,KAAK,CAAC;AAAA,EAClF;AAGA,MAAY,gBAAQ,SAAS,GAAG;AAC9B,WAAe;AAAA,MACD,yBAAa,gBAAgB;AAAA,QACvC,WAAW;AAAA,QACX,SAAS,IAAI,SAAS,qEAAqE,cAAc;AAAA,MAC3G,CAAC;AAAA,IACH;AAAA,EACF;AAEA,MAAI,CAAC,+BAA+B,SAAS,GAAG;AAC9C,WAAe;AAAA,MACD,yBAAa,WAAW;AAAA,QAClC,WAAW;AAAA,QACX,SAAS,IAAI,SAAS,qEAAqE,SAAS;AAAA,MACtG,CAAC;AAAA,IACH;AAAA,EACF;AAEA,MAAI,CAAC,+BAA+B,kBAAkB,GAAG;AACvD,WAAe;AAAA,MACD,yBAAa,oBAAoB;AAAA,QAC3C,WAAW;AAAA,QACX,SAAS,IAAI,SAAS,oEAAoE,kBAAkB;AAAA,MAC9G,CAAC;AAAA,IACH;AAAA,EACF;AAGA,SAAe,gBAAQ,EAAE,WAAW,OAAO,SAAS,GAAG,UAAU,OAAO,kBAAkB,EAAE,CAAC;AAC/F;AAEA,IAAM,iCAAiC,CAAC,cAAqC;AAC3E,QAAM,gBAAgB;AAEtB,MAAI,UAAU,SAAS,GAAG,GAAG;AAC3B,UAAM,uBAAuB;AAC7B,UAAM,iBAAiB,UAAU,MAAM,IAAI,KAAK,CAAC;AACjD,UAAM,uBAAuB,UAAU,MAAM,oBAAoB,KAAK,CAAC;AAEvE,QAAI,eAAe,WAAW,qBAAqB,QAAQ;AACzD,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO,cAAc,KAAK,SAAS;AACrC;AAEA,IAAM,gBAAgB,CAAC,QAA0E;AAE/F,MAAI,IAAI,WAAW,GAAG,KAAK,IAAI,WAAW,GAAG,GAAG;AAC9C,WAAe,gBAAQ,CAAC,MAAM,GAAG,CAAC;AAAA,EACpC;AAGA,QAAM,WAAmB,mBAAW,KAAK,QAAQ;AACjD,MAAI,OAAO,SAAS;AACpB,MAAI,OAAO;AAEX,MAAY,kBAAU,SAAS,SAAS,GAAG;AACzC,WAAO,SAAS;AAChB,WAAO,SAAS,YAAY,SAAS;AAAA,EACvC;AAEA,MAAY,gBAAQ,IAAI,GAAG;AACzB,WAAe,gBAAQ,CAAC,MAAM,IAAI,CAAC;AAAA,EACrC;AAEA,QAAM,kBAAkB,UAAU,IAAI;AACtC,MAAI,CAAC,gBAAgB,WAAW;AAC9B,WAAO;AAAA,EACT;AAEA,SAAe,gBAAQ,CAAC,gBAAgB,OAAO,IAAI,CAAC;AACtD;AAEA,IAAM,YAAY,CAAC,SAAoD;AAErE,MAAI,KAAK,WAAW,GAAG,GAAG;AACxB,UAAM,UAAkB,mBAAmB,oBAAY,MAAM,GAAG,GAAG,GAAG;AAEtE,QAAY,kBAAU,QAAQ,SAAS,GAAG;AACxC,YAAM,aAA2B,0BAAY,QAAQ,SAAS;AAC9D,UAAI,CAAC,WAAW,WAAW;AACzB,eAAO;AAAA,MACT;AAEA,YAAM,YAAoB,mBAAW,QAAQ,MAAM,GAAG;AACtD,UAAY,kBAAU,UAAU,SAAS,KAAa,gBAAQ,UAAU,SAAS,GAAG;AAClF,YAAI,CAAS,iBAAS,UAAU,IAAI,GAAG;AACrC,iBAAe,gBAAoB,yBAAa,MAAM,EAAE,WAAW,WAAW,SAAS,IAAI,SAAS,6BAA6B,IAAI,IAAI,CAAC,CAAC;AAAA,QAC7I;AAEA,eAAe,gBAAQ,EAAE,OAAO,IAAI,QAAQ,SAAS,KAAoB,MAAM,OAAO,UAAU,IAAI,EAAE,CAAC;AAAA,MACzG,OAAO;AACL,eAAe,gBAAQ,EAAE,OAAO,IAAI,QAAQ,SAAS,KAAoB,MAAM,KAAK,CAAC;AAAA,MACvF;AAAA,IACF;AAAA,EACF;AAEA,MAAI,YAAuC,mBAAW,MAAM,GAAG;AAG/D,MAAY,cAAM,UAAU,SAAS,GAAG;AACtC,UAAMI,kBAA8B,yBAAY,UAAU,IAAI;AAC9D,QAAI,CAACA,gBAAe,WAAW;AAC7B,aAAe;AAAA,QACD,yBAAa,MAAM;AAAA,UAC7B,WAAW;AAAA,UACX,SAAS,IAAI,SAAS,8CAA8C,IAAI;AAAA,UACxE,QAAQA,gBAAe,MAAM;AAAA,QAC/B,CAAC;AAAA,MACH;AAAA,IACF;AAEA,WAAe,gBAAQ,EAAE,OAAOA,gBAAe,OAAO,MAAM,KAAK,CAAC;AAAA,EACpE;AAGA,MAAY,gBAAQ,UAAU,SAAS,GAAG;AACxC,WAAe;AAAA,MACD,yBAAa,MAAM,EAAE,WAAW,WAAW,SAAS,IAAI,SAAS,8CAA8C,IAAI,IAAI,CAAC;AAAA,IACtI;AAAA,EACF;AAEA,QAAM,WAAW,UAAU;AAE3B,MAAI,CAAS,iBAAS,UAAU,IAAI,GAAG;AACrC,WAAe;AAAA,MACD,yBAAa,MAAM,EAAE,WAAW,WAAW,SAAS,IAAI,SAAS,8CAA8C,IAAI,IAAI,CAAC;AAAA,IACtI;AAAA,EACF;AAGA,QAAM,iBAA8B,yBAAY,QAAQ;AACxD,MAAI,CAAC,eAAe,WAAW;AAC7B,WAAe;AAAA,MACD,yBAAa,MAAM;AAAA,QAC7B,WAAW;AAAA,QACX,SAAS,IAAI,SAAS,8CAA8C,IAAI;AAAA,QACxE,QAAQ,eAAe,MAAM;AAAA,MAC/B,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAe,gBAAQ,EAAE,OAAO,eAAe,OAAO,MAAM,OAAO,UAAU,IAAI,EAAE,CAAC;AACtF;AAEA,IAAM,gBAAgB,CAAC,QAAmC;AACxD,QAAM,WAAwB,EAAE,MAAM,MAAM,OAAO,MAAM,UAAU,KAAK;AAGxE,QAAM,gBAAwB,mBAAW,KAAK,GAAG;AACjD,MAAY,kBAAU,cAAc,SAAS,KAAK,CAAS,gBAAQ,cAAc,IAAI,GAAG;AACtF,aAAS,WAAW,iBAAiB,cAAc,IAAI;AAAA,EACzD;AAGA,QAAM,aAAqB,mBAAW,cAAc,aAAa,cAAc,MAAM,GAAG;AACxF,MAAY,kBAAU,WAAW,SAAS,KAAK,CAAS,gBAAQ,WAAW,IAAI,GAAG;AAChF,aAAS,QAAQ,iBAAiB,WAAW,IAAI;AAAA,EACnD;AAEA,QAAM,OAAe,oBAAY,WAAW,aAAa,WAAW,IAAI;AACxE,MAAY,kBAAU,IAAI,GAAG;AAC3B,aAAS,OAAO,iBAAiB,IAAI;AAAA,EACvC;AACA,SAAO;AACT;AAEA,IAAM,QAAQ,CAAC,YAA6B;AAC1C,QAAM,SAAiB,kBAAU,QAAQ,MAAM,IAAgB,yBAAa,YAAY,QAAQ,MAAM,CAAC,IAAI;AAC3G,MAAI,OAAuB;AAC3B,MAAI,iBAA2C;AAE/C,MAAY,kBAAU,QAAQ,IAAI,GAAG;AACnC,QAAY,iBAAS,QAAQ,IAAI,GAAG;AAClC,aAAmB,yBAAa,UAAU,QAAQ,IAAI,CAAC;AAAA,IACzD,OAAO;AACL,aAAO;AAAA,QACL,OAAoB,kBAAK,QAAQ,KAAK,KAAK;AAAA,QAC3C,MAAM,QAAQ,KAAK,QAAQ;AAAA,MAC7B;AAAA,IACF;AAEA,QAAY,kBAAU,QAAQ,cAAc,GAAG;AAC7C,UAAY,iBAAS,QAAQ,cAAc,GAAG;AAC5C,yBAA6B,yBAAa,oBAAoB,QAAQ,cAAc,CAAC;AAAA,MACvF,OAAO;AACL,yBAAiB;AAAA,UACf,WAAW,QAAQ,eAAe;AAAA,UAClC,UAAU,QAAQ,eAAe,YAAY;AAAA,QAC/C;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,MAAI,WAAwB;AAAA,IAC1B,MAAM;AAAA,IACN,OAAO;AAAA,IACP,UAAU;AAAA,EACZ;AAEA,MAAY,kBAAU,QAAQ,QAAQ,GAAG;AACvC,QAAY,iBAAS,QAAQ,QAAQ,GAAG;AACtC,UAAI,iBAAiB,QAAQ;AAC7B,UAAY,kBAAU,QAAQ,IAAI,KAAK,CAAC,eAAe,WAAW,GAAG,KAAK,CAAC,eAAe,WAAW,GAAG,KAAK,CAAC,eAAe,WAAW,GAAG,GAAG;AAC5I,yBAAiB,MAAM;AAAA,MACzB;AAEA,iBAAW,cAAc,cAAc;AAAA,IACzC,OAAO;AACL,UAAI,OAAO,QAAQ,SAAS,QAAQ;AACpC,UAAY,kBAAU,IAAI,KAAK,CAAC,KAAK,WAAW,GAAG,KAAa,kBAAU,QAAQ,IAAI,GAAG;AACvF,eAAO,MAAM;AAAA,MACf;AAEA,iBAAW;AAAA,QACT,MAAc,kBAAU,IAAI,IAAI,iBAAiB,IAAI,IAAI;AAAA,QACzD,OAAe,kBAAU,QAAQ,SAAS,KAAK,IAAI,iBAAiB,QAAQ,SAAS,KAAK,IAAI;AAAA,QAC9F,UAAkB,kBAAU,QAAQ,SAAS,QAAQ,IAAI,iBAAiB,QAAQ,SAAS,QAAQ,IAAI;AAAA,MACzG;AAAA,IACF;AAAA,EACF;AAEA,QAAM,YAA0B;AAAA,IAC9B,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,MAAM,eAAe,SAAS;AAAA,EAChC;AACF;AAEO,IAAM,mBAAmB;AAAA,EAC9B,QAAQ;AAAA,EACR,gBAAgB;AAAA,EAChB,MAAM;AAAA,EACN,UAAU;AAAA,EACV,MAAM;AAAA,EACN,OAAO;AAAA,EACP,UAAU;AACZ;AAsCO,IAAM,SAAS,CAAC,SAAkB,wBAAiD,CAAC,MAAkB;AAC3G,SAAO,eAAeF,MAAK,OAAO,GAAG,qBAAqB;AAC5D;AAEA,IAAM,iBAAiB,CAAC,KAAmB,wBAAiD,CAAC,MAAkB;AAC7G,MAAI,YAAY;AAChB,MAAY,kBAAU,IAAI,MAAM,KAAK,CAAQ,gBAAS,uBAAuB,iBAAiB,MAAM,GAAG;AACrG,gBAAY,YAAY,IAAI,SAAS;AAAA,EACvC;AAEA,MAAY,kBAAU,IAAI,IAAI,KAAK,CAAQ,gBAAS,uBAAuB,iBAAiB,IAAI,GAAG;AACjG,gBAAY,YAAY;AAExB,QAAY,kBAAU,IAAI,cAAc,KAAK,CAAQ,gBAAS,uBAAuB,iBAAiB,cAAc,GAAG;AACrH,kBAAY,YAAY,OAAO,IAAI,eAAe,SAAS;AAE3D,UAAY,kBAAU,IAAI,eAAe,QAAQ,GAAG;AAClD,oBAAY,YAAY,MAAM,OAAO,IAAI,eAAe,QAAQ;AAAA,MAClE;AAEA,kBAAY,YAAY;AAAA,IAC1B;AAEA,gBAAY,YAAY,IAAI,KAAK;AACjC,QAAY,kBAAU,IAAI,KAAK,IAAI,GAAG;AACpC,kBAAY,YAAY,MAAM,IAAI,KAAK;AAAA,IACzC;AAAA,EACF;AAEA,MAAI,CAAQ,gBAAS,uBAAuB,iBAAiB,QAAQ,GAAG;AACtE,gBAAY,YAAY,eAAe,IAAI,UAAU,qBAAqB;AAAA,EAC5E;AAEA,SAAO;AACT;AAEA,IAAM,iBAAiB,CAAC,UAAuB,wBAAiD,CAAC,MAAc;AAC7G,MAAI,YAAY;AAEhB,MAAY,kBAAU,SAAS,IAAI,KAAK,CAAQ,gBAAS,uBAAuB,iBAAiB,IAAI,GAAG;AACtG,gBAAY,YAAY,SAAS;AAAA,EACnC;AAEA,MAAY,kBAAU,SAAS,KAAK,KAAK,CAAQ,gBAAS,uBAAuB,iBAAiB,KAAK,GAAG;AACxG,gBAAY,YAAY,MAAM,SAAS;AAAA,EACzC;AAEA,MAAY,kBAAU,SAAS,QAAQ,KAAK,CAAQ,gBAAS,uBAAuB,iBAAiB,QAAQ,GAAG;AAC9G,gBAAY,YAAY,MAAM,SAAS;AAAA,EACzC;AAEA,SAAO;AACT;AAEA,IAAM,mBAAmB,CAAC,iBAA+B;AACvD,SAAO,aAAa,WAAW,KAAK,KAAK;AAC3C;AAEO,IAAM,SAAS,CAAC,iBAA+B;AACpD,SAAO,mBAAmB,YAAY;AACxC;AAEO,IAAM,SAAS,CAAC,iBAA+B;AACpD,SAAO,mBAAmB,YAAY;AACxC;","names":["success","parseString","from","it","hostNameResult"]}
+{"version":3,"sources":["../../src/net/uri.ts"],"sourcesContent":["import { NominalType, TaggedType } from '@bessemer/cornerstone/types'\nimport * as Strings from '@bessemer/cornerstone/string'\nimport { StringSplitResult } from '@bessemer/cornerstone/string'\nimport * as Objects from '@bessemer/cornerstone/object'\nimport * as Arrays from '@bessemer/cornerstone/array'\nimport * as ResourceKeys from '@bessemer/cornerstone/resource-key'\nimport * as Results from '@bessemer/cornerstone/result'\nimport { Result } from '@bessemer/cornerstone/result'\nimport * as ErrorEvents from '@bessemer/cornerstone/error/error-event'\nimport { ErrorEvent } from '@bessemer/cornerstone/error/error-event'\nimport { structuredTransform } from '@bessemer/cornerstone/zod-util'\nimport Zod from 'zod'\nimport * as IpV6Addresses from '@bessemer/cornerstone/net/ipv6-address'\nimport { ValueOf } from 'type-fest'\nimport * as Equalitors from '@bessemer/cornerstone/equalitor'\nimport { Equalitor } from '@bessemer/cornerstone/equalitor'\nimport * as UriHostNames from '@bessemer/cornerstone/net/uri-host-name'\nimport { UriHostName } from '@bessemer/cornerstone/net/uri-host-name'\n\nexport type UriString = TaggedType<string, 'UriString'>\nexport type UriComponent = string\n\nexport type UriScheme = string\n\nexport type UriAuthentication = {\n  principal: string\n  password: string | null\n}\n\nexport type UriHost = {\n  value: UriHostName\n  port: number | null\n}\n\nexport interface UriLocation {\n  path: string | null\n  query: string | null\n  fragment: string | null\n}\n\nexport const Namespace = ResourceKeys.createNamespace('uri')\nexport const UrlNamespace = ResourceKeys.createNamespace('url')\nexport const EqualBy: Equalitor<Uri> = Equalitors.deepNatural()\n\nexport type UriLiteral = NominalType<string, typeof Namespace>\n\nexport interface UriStructure {\n  _type: typeof Namespace | typeof UrlNamespace\n  scheme: UriScheme | null\n  host: UriHost | null\n  authentication: UriAuthentication | null\n  location: UriLocation\n}\n\nexport interface Uri extends UriStructure {\n  href: UriLiteral\n}\n\ntype UriBuilderAuthentication =\n  | {\n      principal: string\n      password?: string | null\n    }\n  | string\n\ntype UriBuilderHost =\n  | {\n      value: string\n      port?: number | null\n    }\n  | string\n\ntype UriBuilderLocation =\n  | {\n      path?: string | null\n      query?: string | null\n      fragment?: string | null\n    }\n  | string\n\nexport type UriBuilder = {\n  scheme?: string | null | undefined\n  authentication?: UriBuilderAuthentication | null | undefined\n  host?: UriBuilderHost | null | undefined\n  location?: UriBuilderLocation | null | undefined\n}\n\nexport type UriLike = Uri | UriLiteral | UriBuilder\n\n/**\n * Parses a string into a Uri object, handling all URI components including scheme,\n * authority (host and authentication), and location (path, query, fragment).\n * Returns a Result containing either the parsed Uri or an ErrorEvent on failure.\n *\n * **Example**\n *\n * ```ts\n * import { Uris } from \"@bessemer/cornerstone\"\n *\n * // Parse a complete HTTPS URI\n * const result = Uris.parseString('https://user:pass@example.com:8080/api/v1?q=test#section')\n * if (result.isSuccess) {\n *   console.log(result.value.scheme) // 'https'\n *   console.log(result.value.host?.value) // 'example.com'\n *   console.log(result.value.authentication?.principal) // 'user'\n * }\n *\n * // Parse a simple URI without authority\n * const urnResult = Uris.parseString('urn:isbn:0451450523')\n * if (urnResult.isSuccess) {\n *   console.log(urnResult.value.scheme) // 'urn'\n *   console.log(urnResult.value.location.path) // 'isbn:0451450523'\n * }\n * ```\n *\n * @category parsing\n */\nexport const parseString = (value: string, mode: UriParseMode = UriParseMode.Strict): Result<Uri, ErrorEvent> => {\n  // JOHN we want to improve the syntax burden of handling a series of Result objects like this\n  if (Strings.isBlank(value)) {\n    return Results.success(empty())\n  }\n\n  const schemeResult = parseSchemePart(value)\n  if (Results.isFailure(schemeResult)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(value, {\n        namespace: Namespace,\n        message: `[${Namespace}]: Unable to parse Uri from string: [${value}]`,\n        causes: schemeResult.value.causes,\n      })\n    )\n  }\n\n  const [scheme, rest1] = schemeResult\n\n  const authorityPartResult = parseAuthorityPart(rest1, mode)\n  if (Results.isFailure(authorityPartResult)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(value, {\n        namespace: Namespace,\n        message: `[${Namespace}]: Unable to parse Uri from string: [${value}]`,\n        causes: authorityPartResult.value.causes,\n      })\n    )\n  }\n  const [authority, rest2] = authorityPartResult\n\n  const location = parseLocation(rest2)\n\n  const structure: UriStructure = {\n    _type: Namespace,\n    scheme,\n    host: authority.host,\n    authentication: authority.authentication,\n    location,\n  }\n\n  return Results.success({\n    ...structure,\n    href: formatInternal(structure),\n  })\n}\n\nexport const UriParseMode = {\n  // Normal href-style url parsing\n  Strict: 'strict',\n  // Will parse 'www.google.com' as a hostname rather than a path, but loses support for relative urls\n  Permissive: 'permissive',\n} as const\nexport type UriParseMode = ValueOf<typeof UriParseMode>\n\n/**\n * Converts various URI-like inputs into a Uri object. Handles Uri instances,\n * string literals, and builder objects, returning them as-is when already a Uri\n * or converting them appropriately.\n *\n * **Example**\n *\n * ```ts\n * import { Uris } from \"@bessemer/cornerstone\"\n *\n * // String literal parsed into Uri\n * const fromString = Uris.from('https://api.example.com/v1')\n * console.log(fromString.scheme) // 'https'\n * console.log(fromString.host?.value) // 'api.example.com'\n *\n * // Builder object converted to Uri\n * const fromBuilder = Uris.from({\n *   scheme: 'https',\n *   host: { value: 'example.com', port: 8080 },\n *   location: { path: '/api' }\n * })\n * console.log(fromBuilder.host?.port) // 8080\n *\n * @category conversion\n */\nexport function from(value: UriLike | string): Uri\nexport function from(value: UriLike | string | null): Uri | null\nexport function from(value: UriLike | string | undefined): Uri | undefined\nexport function from(value: UriLike | string | null | undefined): Uri | null | undefined\nexport function from(value: UriLike | string | null | undefined): Uri | null | undefined {\n  if (Objects.isNil(value)) {\n    return value\n  }\n  if (isUri(value)) {\n    return value\n  }\n  if (Strings.isString(value)) {\n    return ErrorEvents.unpackResult(parseString(value))\n  }\n\n  return build(value as UriBuilder)\n}\n\n/**\n * Converts various URI-like inputs into a normalized string literal representation.\n * Takes any URI-like value and returns its canonical string form\n *\n * **Example**\n *\n * ```ts\n * import { Uris } from \"@bessemer/cornerstone\"\n *\n * // Convert Uri instance to string literal\n * const uri = Uris.build({ scheme: 'https', host: 'example.com', location: { path: '/api' } })\n * const literal = Uris.toLiteral(uri)\n * console.log(literal) // \"https://example.com/api\"\n *\n * // Convert builder object to string literal\n * const fromBuilder = Uris.toLiteral({\n *   scheme: 'https',\n *   host: { value: 'api.example.com', port: 8080 },\n *   authentication: { principal: 'user', password: 'pass' },\n *   location: { path: '/v1', parameters: { q: 'search' } }\n * })\n * console.log(fromBuilder) // \"https://user:pass@api.example.com:8080/v1?q=search\"\n * ```\n *\n * @category serialization\n */\nexport function toLiteral(likeValue: UriLike): UriLiteral\nexport function toLiteral(likeValue: UriLike | null): UriLiteral | null\nexport function toLiteral(likeValue: UriLike | undefined): UriLiteral | undefined\nexport function toLiteral(likeValue: UriLike | null | undefined): UriLiteral | null | undefined\nexport function toLiteral(likeValue: UriLike | null | undefined): UriLiteral | null | undefined {\n  if (Objects.isNil(likeValue)) {\n    return likeValue\n  }\n\n  const value = from(likeValue)\n  return format(value) as UriLiteral\n}\n\nexport const SchemaLiteral = structuredTransform(Zod.string(), (it: string) => Results.map(parseString(it), (it) => toLiteral(it)))\n// JOHN need a schema for the object version...\n// export const SchemaInstance = structuredTransform(Zod.string(), parseString)\n\nexport const empty = (): Uri => {\n  return {\n    _type: Namespace,\n    href: '' as UriLiteral,\n    scheme: null,\n    authentication: null,\n    host: null,\n    location: {\n      path: null,\n      query: null,\n      fragment: null,\n    },\n  }\n}\n\n/**\n * Tests if the provided value is a Uri.\n *\n * **Example**\n *\n * ```ts\n * import { Uris } from \"@bessemer/cornerstone\"\n *\n * // Check if unknown value is a Uri\n * function processValue(value: unknown) {\n *   if (Uris.isUri(value)) {\n *     console.log(value.scheme) // Type-safe access\n *     console.log(value.location.path)\n *   }\n * }\n * ```\n *\n * @category type-guards\n */\nexport const isUri = (value: unknown): value is Uri => {\n  if (!Objects.isObject(value)) {\n    return false\n  }\n\n  const uriValue = value as any as Uri\n  return uriValue._type === Namespace || uriValue._type === UrlNamespace\n}\n\n/**\n * Updates an existing URI with partial changes to create a new URI instance.\n * Allows selective updates without replacing the entire URI.\n *\n * **Example**\n *\n * ```ts\n * import { Uris } from \"@bessemer/cornerstone\"\n *\n * // Start with a base URI\n * const baseUri = Uris.build({\n *   scheme: 'https',\n *   host: { value: 'api.example.com', port: 443 },\n *   authentication: { principal: 'user', password: 'pass' },\n *   location: { path: '/v1', parameters: { format: 'json' } }\n * })\n *\n * // Change just the host and add query parameter\n * const updatedUri = Uris.update(baseUri, {\n *   host: { value: 'api.production.com' }, // Port preserved from original\n *   location: {\n *     parameters: { version: '2.0' } // Merges with existing parameters\n *   }\n * })\n *\n * console.log(updatedUri.host?.value) // 'api.production.com'\n * console.log(updatedUri.host?.port) // 443 (preserved)\n * console.log(updatedUri.location.parameters) // { format: 'json', version: '2.0' }\n * ```\n *\n * @category transformation\n */\nexport const update = (element: UriLike, builder: UriBuilder): Uri => {\n  const uri = from(element)\n\n  let location: UriBuilderLocation | null | undefined\n  if (Strings.isString(builder.location) || Objects.isNull(builder.location)) {\n    location = builder.location\n  } else {\n    location = {\n      path: Objects.isUndefined(builder.location?.path) ? uri.location.path : builder.location?.path,\n      query: Objects.isUndefined(builder.location?.query) ? uri.location.query : builder.location?.query,\n      fragment: Objects.isUndefined(builder.location?.fragment) ? uri.location.fragment : builder.location?.fragment,\n    }\n  }\n\n  const uriBuilder: UriBuilder = {\n    scheme: Objects.isUndefined(builder.scheme) ? uri.scheme : builder.scheme,\n    host: Objects.isUndefined(builder.host) ? uri.host : builder.host,\n    authentication: Objects.isUndefined(builder.authentication) ? uri.authentication : builder.authentication,\n    location,\n  }\n\n  return from(uriBuilder)\n}\n\nexport const merge = (...uris: Array<UriLike>): Uri => {\n  if (uris.length === 0) {\n    return empty()\n  }\n  if (uris.length === 1) {\n    return from(uris[0]!)\n  }\n\n  return uris.reduce<Uri>((aggregate, next) => {\n    const nextUri = from(next)\n\n    const builder: UriBuilder = {\n      scheme: nextUri.scheme ?? undefined,\n      host: nextUri.host ?? undefined,\n      authentication: nextUri.authentication ?? undefined,\n      location: {\n        path: nextUri.location.path ?? undefined,\n        query: nextUri.location.query ?? undefined,\n        fragment: nextUri.location.fragment ?? undefined,\n      },\n    }\n\n    const uri = update(aggregate, builder)\n    return uri\n  }, from(uris[0]!))\n}\n\nconst parseSchemePart = (url: UriComponent): Result<[UriScheme | null, UriComponent], ErrorEvent> => {\n  // Search for the colon or double slash\n  const schemeMatch = Strings.splitFirst(url, /(\\/\\/|:)/)\n\n  // If we don't find either, or we hit the double slash before finding a colon, there is no scheme\n  if (Objects.isNil(schemeMatch.selection) || schemeMatch.separator === '//') {\n    return Results.success([null, url])\n  }\n\n  // This means the string started with :, so no protocol\n  if (Strings.isEmpty(schemeMatch.selection)) {\n    return Results.success([null, ':' + schemeMatch.rest])\n  } else {\n    const schemeResult = parseScheme(schemeMatch.selection)\n    if (Results.isFailure(schemeResult)) {\n      return schemeResult\n    }\n\n    return Results.success([schemeResult, schemeMatch.rest])\n  }\n}\n\nconst parseScheme = (scheme: UriComponent): Result<UriScheme, ErrorEvent> => {\n  // RFC 3986: scheme = ALPHA *( ALPHA / DIGIT / \"+\" / \"-\" / \".\" )\n  const schemeRegex = /^[a-zA-Z][a-zA-Z0-9+.-]*$/\n  if (!schemeRegex.test(scheme)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(scheme, {\n        namespace: Namespace,\n        message: `[${Namespace}]: Invalid characters in Scheme.`,\n      })\n    )\n  }\n\n  return Results.success(scheme)\n}\n\nconst parseAuthorityPart = (\n  initialUrl: UriComponent,\n  mode: UriParseMode\n): Result<[{ host: UriHost | null; authentication: UriAuthentication | null }, UriComponent], ErrorEvent> => {\n  if (mode === UriParseMode.Strict && !initialUrl.startsWith('//')) {\n    return Results.success([{ host: null, authentication: null }, initialUrl])\n  }\n  if (mode === UriParseMode.Permissive && initialUrl.startsWith('/')) {\n    return Results.success([{ host: null, authentication: null }, initialUrl])\n  }\n\n  const url = Strings.removeStart(initialUrl, '//')\n\n  const authenticationPartResult = parseAuthenticationPart(url)\n  if (Results.isFailure(authenticationPartResult)) {\n    return authenticationPartResult\n  }\n  const [authentication, rest1] = authenticationPartResult\n\n  const hostPartResult = parseHostPart(rest1)\n  if (Results.isFailure(hostPartResult)) {\n    return hostPartResult\n  }\n  const [host, rest2] = hostPartResult\n\n  return Results.success([{ host, authentication }, rest2])\n}\n\nconst parseAuthenticationPart = (url: UriComponent): Result<[UriAuthentication | null, UriComponent], ErrorEvent> => {\n  let targetPart = url\n  const queryMatch = Strings.splitFirst(targetPart, '?')\n  const fragmentMatch = Strings.splitFirst(targetPart, '#')\n  if (Objects.isPresent(queryMatch.selection)) {\n    targetPart = queryMatch.selection\n  } else if (Objects.isPresent(fragmentMatch.selection)) {\n    targetPart = fragmentMatch.selection\n  }\n\n  const { selection: authentication } = Strings.splitFirst(targetPart, '@')\n\n  // If there is no @, then we don't have an authentication\n  if (Objects.isNil(authentication)) {\n    return Results.success([null, url])\n  }\n\n  const { rest } = Strings.splitFirst(url, '@')\n\n  const authenticationParseResult = parseAuthentication(authentication)\n  if (Results.isFailure(authenticationParseResult)) {\n    return authenticationParseResult\n  }\n\n  return Results.success([authenticationParseResult, rest])\n}\n\nconst parseAuthentication = (authentication: UriComponent): Result<UriAuthentication, ErrorEvent> => {\n  const { selection: principal, rest: authenticationRest } = Strings.splitFirst(authentication, ':')\n\n  // If there isn't a colon, then there is no password but there is a username\n  if (Objects.isNil(principal)) {\n    if (!isAuthenticationComponentValid(authenticationRest)) {\n      return Results.failure(\n        ErrorEvents.invalidValue(authenticationRest, {\n          namespace: Namespace,\n          message: `[${Namespace}]: Invalid characters for UriAuthentication in principal string: [${authenticationRest}]`,\n        })\n      )\n    }\n\n    return Results.success({ principal: decode(authenticationRest), password: null })\n  }\n\n  // The authentication section started with a :, don't know what to make of this... password but no username?\n  if (Strings.isEmpty(principal)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(authentication, {\n        namespace: Namespace,\n        message: `[${Namespace}]: Unable to parse UriAuthentication from authentication string: [${authentication}]`,\n      })\n    )\n  }\n\n  if (!isAuthenticationComponentValid(principal)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(principal, {\n        namespace: Namespace,\n        message: `[${Namespace}]: Invalid characters for UriAuthentication in principal string: [${principal}]`,\n      })\n    )\n  }\n\n  if (!isAuthenticationComponentValid(authenticationRest)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(authenticationRest, {\n        namespace: Namespace,\n        message: `[${Namespace}]: Invalid characters for UriAuthentication in password string: [${authenticationRest}]`,\n      })\n    )\n  }\n\n  // Otherwise, we have both, so return the complete authentication object and the rest\n  return Results.success({ principal: decode(principal), password: decode(authenticationRest) })\n}\n\nconst isAuthenticationComponentValid = (component: UriComponent): boolean => {\n  const userinfoRegex = /^[A-Za-z0-9\\-._~!$&'()*+,;=%]*$/\n\n  if (component.includes('%')) {\n    const percentEncodingRegex = /%[0-9A-Fa-f]{2}/g\n    const percentMatches = component.match(/%/g) || []\n    const validEncodingMatches = component.match(percentEncodingRegex) || []\n\n    if (percentMatches.length !== validEncodingMatches.length) {\n      return false\n    }\n  }\n\n  return userinfoRegex.test(component)\n}\n\nconst parseHostPart = (url: UriComponent): Result<[UriHost | null, UriComponent], ErrorEvent> => {\n  // Check if the host is starting with reserved characters, if so we should just bail on trying to parse\n  if (url.startsWith('?') || url.startsWith('#')) {\n    return Results.success([null, url])\n  }\n\n  // Lets grab everything to the left of the first / ? or #, this is the remainder of our authority (if any)\n  const urlMatch = Strings.splitFirst(url, /[\\/?#]/)\n  let host = urlMatch.rest\n  let rest = ''\n\n  if (Objects.isPresent(urlMatch.selection)) {\n    host = urlMatch.selection\n    rest = urlMatch.separator + urlMatch.rest\n  }\n\n  if (Strings.isEmpty(host)) {\n    return Results.success([null, rest])\n  }\n\n  const parseHostResult = parseHost(host)\n  if (Results.isFailure(parseHostResult)) {\n    return parseHostResult\n  }\n\n  return Results.success([parseHostResult, rest])\n}\n\nconst parseHost = (host: UriComponent): Result<UriHost, ErrorEvent> => {\n  // Try to see if we have an ipv6 address like the form [2001:db8::7] and handle it\n  if (host.startsWith('[')) {\n    const ipMatch = Strings.splitFirst(Strings.removeStart(host, '['), ']')\n\n    if (Objects.isPresent(ipMatch.selection)) {\n      const ipV6Result = IpV6Addresses.parseString(ipMatch.selection)\n      if (Results.isFailure(ipV6Result)) {\n        return ipV6Result\n      }\n\n      const portMatch = Strings.splitFirst(ipMatch.rest, ':')\n      if (Objects.isPresent(portMatch.selection) && Strings.isEmpty(portMatch.selection)) {\n        if (!Strings.isNumber(portMatch.rest)) {\n          return Results.failure(ErrorEvents.invalidValue(host, { namespace: Namespace, message: `[${Namespace}]: Unable to parse Host: [${host}]` }))\n        }\n\n        return Results.success({ value: `[${ipMatch.selection}]` as UriHostName, port: Number(portMatch.rest) })\n      } else {\n        return Results.success({ value: `[${ipMatch.selection}]` as UriHostName, port: null })\n      }\n    }\n  }\n\n  let hostMatch: StringSplitResult = Strings.splitFirst(host, ':')\n\n  // We have no :, which means no port, so treat the rest as the hostname\n  if (Objects.isNil(hostMatch.selection)) {\n    const hostNameResult = UriHostNames.parseString(hostMatch.rest)\n    if (Results.isFailure(hostNameResult)) {\n      return Results.failure(\n        ErrorEvents.invalidValue(host, {\n          namespace: Namespace,\n          message: `[${Namespace}]: Unable to parse Host from host string: [${host}]`,\n          causes: hostNameResult.value.causes,\n        })\n      )\n    }\n\n    return Results.success({ value: hostNameResult, port: null })\n  }\n\n  // The host started with a :, this is odd\n  if (Strings.isEmpty(hostMatch.selection)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(host, { namespace: Namespace, message: `[${Namespace}]: Unable to parse Host from host string: [${host}]` })\n    )\n  }\n\n  const hostName = hostMatch.selection\n\n  if (!Strings.isNumber(hostMatch.rest)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(host, { namespace: Namespace, message: `[${Namespace}]: Unable to parse Host from host string: [${host}]` })\n    )\n  }\n\n  // Otherwise, we have both, so return the complete authentication object and the rest\n  const hostNameResult = UriHostNames.parseString(hostName)\n  if (Results.isFailure(hostNameResult)) {\n    return Results.failure(\n      ErrorEvents.invalidValue(host, {\n        namespace: Namespace,\n        message: `[${Namespace}]: Unable to parse Host from host string: [${host}]`,\n        causes: hostNameResult.value.causes,\n      })\n    )\n  }\n\n  return Results.success({ value: hostNameResult, port: Number(hostMatch.rest) })\n}\n\nconst parseLocation = (url: UriComponent): UriLocation => {\n  const location: UriLocation = { path: null, query: null, fragment: null }\n\n  // Lets see if we have a fragment and parse it off the end\n  const fragmentMatch = Strings.splitFirst(url, '#')\n  if (Objects.isPresent(fragmentMatch.selection) && !Strings.isEmpty(fragmentMatch.rest)) {\n    location.fragment = encodeWhitespace(fragmentMatch.rest)\n  }\n\n  // Lets see if we have a query string and parse it off the remainder\n  const queryMatch = Strings.splitFirst(fragmentMatch.selection ?? fragmentMatch.rest, '?')\n  if (Objects.isPresent(queryMatch.selection) && !Strings.isEmpty(queryMatch.rest)) {\n    location.query = encodeWhitespace(queryMatch.rest)\n  }\n\n  const path = Strings.emptyToNull(queryMatch.selection ?? queryMatch.rest)\n  if (Objects.isPresent(path)) {\n    location.path = encodeWhitespace(path)\n  }\n  return location\n}\n\nconst build = (builder: UriBuilder): Uri => {\n  const scheme = Objects.isPresent(builder.scheme) ? ErrorEvents.unpackResult(parseScheme(builder.scheme)) : null\n  let host: UriHost | null = null\n  let authentication: UriAuthentication | null = null\n\n  if (Objects.isPresent(builder.host)) {\n    if (Strings.isString(builder.host)) {\n      host = ErrorEvents.unpackResult(parseHost(builder.host))\n    } else {\n      host = {\n        value: UriHostNames.from(builder.host.value),\n        port: builder.host.port ?? null,\n      }\n    }\n\n    if (Objects.isPresent(builder.authentication)) {\n      if (Strings.isString(builder.authentication)) {\n        authentication = ErrorEvents.unpackResult(parseAuthentication(builder.authentication))\n      } else {\n        authentication = {\n          principal: builder.authentication.principal,\n          password: builder.authentication.password ?? null,\n        }\n      }\n    }\n  }\n\n  let location: UriLocation = {\n    path: null,\n    query: null,\n    fragment: null,\n  }\n\n  if (Objects.isPresent(builder.location)) {\n    if (Strings.isString(builder.location)) {\n      let locationString = builder.location\n      if (Objects.isPresent(builder.host) && !locationString.startsWith('/') && !locationString.startsWith('?') && !locationString.startsWith('#')) {\n        locationString = '/' + locationString\n      }\n\n      location = parseLocation(locationString)\n    } else {\n      let path = builder.location.path ?? null\n      if (Objects.isPresent(path) && !path.startsWith('/') && Objects.isPresent(builder.host)) {\n        path = '/' + path\n      }\n\n      location = {\n        path: Objects.isPresent(path) ? encodeWhitespace(path) : null,\n        query: Objects.isPresent(builder.location.query) ? encodeWhitespace(builder.location.query) : null,\n        fragment: Objects.isPresent(builder.location.fragment) ? encodeWhitespace(builder.location.fragment) : null,\n      }\n    }\n  }\n\n  const structure: UriStructure = {\n    _type: Namespace,\n    scheme,\n    host,\n    authentication,\n    location,\n  }\n\n  return {\n    ...structure,\n    href: formatInternal(structure),\n  }\n}\n\nexport const UriComponentType = {\n  Scheme: 'Scheme',\n  Authentication: 'Authentication',\n  Host: 'Host',\n  Location: 'Location',\n  Path: 'Path',\n  Query: 'Query',\n  Fragment: 'Fragment',\n} as const\n\nexport type UriComponentType = ValueOf<typeof UriComponentType>\n\n/**\n * Converts a URI object into its string representation, with optional exclusion of specific URI components.\n *\n * **Example**\n *\n * ```ts\n * import { Uris, UriComponentType } from \"@bessemer/cornerstone\"\n *\n * const uri = Uris.build({\n *   scheme: 'https',\n *   authentication: { principal: 'user', password: 'secret' },\n *   host: { value: 'api.example.com', port: 8080 },\n *   location: { path: '/v1/data', parameters: { format: 'json' }, fragment: 'results' }\n * })\n *\n * // Format complete URI\n * const fullUri = Uris.format(uri)\n * console.log(fullUri) // \"https://user:secret@api.example.com:8080/v1/data?format=json#results\"\n *\n * // Exclude authentication for public sharing\n * const publicUri = Uris.format(uri, [UriComponentType.Authentication])\n * console.log(publicUri) // \"https://api.example.com:8080/v1/data?format=json#results\"\n *\n * // Format path-only URI\n * const pathOnly = Uris.format(uri, [\n *   UriComponentType.Scheme,\n *   UriComponentType.Host,\n *   UriComponentType.Authentication\n * ])\n * console.log(pathOnly) // \"/v1/data?format=json#results\"\n * ```\n *\n * @category serialization\n */\nexport const format = (uriLike: UriLike, excludedUriComponents: Array<UriComponentType> = []): UriLiteral => {\n  return formatInternal(from(uriLike), excludedUriComponents)\n}\n\nexport const isComplete = (uri: Uri): boolean => {\n  return Objects.isPresent(uri.scheme) && Objects.isPresent(uri.host)\n}\n\nconst formatInternal = (uri: UriStructure, excludedUriComponents: Array<UriComponentType> = []): UriLiteral => {\n  let urlString = ''\n  if (Objects.isPresent(uri.scheme) && !Arrays.contains(excludedUriComponents, UriComponentType.Scheme)) {\n    urlString = urlString + uri.scheme + ':'\n  }\n\n  if (Objects.isPresent(uri.host) && !Arrays.contains(excludedUriComponents, UriComponentType.Host)) {\n    urlString = urlString + '//'\n\n    if (Objects.isPresent(uri.authentication) && !Arrays.contains(excludedUriComponents, UriComponentType.Authentication)) {\n      urlString = urlString + encode(uri.authentication.principal)\n\n      if (Objects.isPresent(uri.authentication.password)) {\n        urlString = urlString + ':' + encode(uri.authentication.password)\n      }\n\n      urlString = urlString + '@'\n    }\n\n    urlString = urlString + uri.host.value\n    if (Objects.isPresent(uri.host.port)) {\n      urlString = urlString + ':' + uri.host.port\n    }\n  }\n\n  if (!Arrays.contains(excludedUriComponents, UriComponentType.Location)) {\n    urlString = urlString + formatLocation(uri.location, excludedUriComponents)\n  }\n\n  return urlString as UriLiteral\n}\n\nconst formatLocation = (location: UriLocation, excludedUriComponents: Array<UriComponentType> = []): string => {\n  let urlString = ''\n\n  if (Objects.isPresent(location.path) && !Arrays.contains(excludedUriComponents, UriComponentType.Path)) {\n    urlString = urlString + location.path\n  }\n\n  if (Objects.isPresent(location.query) && !Arrays.contains(excludedUriComponents, UriComponentType.Query)) {\n    urlString = urlString + '?' + location.query\n  }\n\n  if (Objects.isPresent(location.fragment) && !Arrays.contains(excludedUriComponents, UriComponentType.Fragment)) {\n    urlString = urlString + '#' + location.fragment\n  }\n\n  return urlString\n}\n\nconst encodeWhitespace = (uriComponent: UriComponent) => {\n  return uriComponent.replaceAll(' ', '%20')\n}\n\nexport const encode = (uriComponent: UriComponent) => {\n  return encodeURIComponent(uriComponent)\n}\n\nexport const decode = (uriComponent: UriComponent) => {\n  return decodeURIComponent(uriComponent)\n}\n"],"mappings":";AACA,YAAY,aAAa;AAEzB,YAAY,aAAa;AACzB,YAAY,YAAY;AACxB,YAAY,kBAAkB;AAC9B,YAAY,aAAa;AAEzB,YAAY,iBAAiB;AAE7B,SAAS,2BAA2B;AACpC,OAAO,SAAS;AAChB,YAAY,mBAAmB;AAE/B,YAAY,gBAAgB;AAE5B,YAAY,kBAAkB;AAwBvB,IAAM,YAAyB,6BAAgB,KAAK;AACpD,IAAM,eAA4B,6BAAgB,KAAK;AACvD,IAAM,UAAqC,uBAAY;AA2EvD,IAAMA,eAAc,CAAC,OAAe,OAAqB,aAAa,WAAoC;AAE/G,MAAY,gBAAQ,KAAK,GAAG;AAC1B,WAAe,gBAAQ,MAAM,CAAC;AAAA,EAChC;AAEA,QAAM,eAAe,gBAAgB,KAAK;AAC1C,MAAY,kBAAU,YAAY,GAAG;AACnC,WAAe;AAAA,MACD,yBAAa,OAAO;AAAA,QAC9B,WAAW;AAAA,QACX,SAAS,IAAI,SAAS,wCAAwC,KAAK;AAAA,QACnE,QAAQ,aAAa,MAAM;AAAA,MAC7B,CAAC;AAAA,IACH;AAAA,EACF;AAEA,QAAM,CAAC,QAAQ,KAAK,IAAI;AAExB,QAAM,sBAAsB,mBAAmB,OAAO,IAAI;AAC1D,MAAY,kBAAU,mBAAmB,GAAG;AAC1C,WAAe;AAAA,MACD,yBAAa,OAAO;AAAA,QAC9B,WAAW;AAAA,QACX,SAAS,IAAI,SAAS,wCAAwC,KAAK;AAAA,QACnE,QAAQ,oBAAoB,MAAM;AAAA,MACpC,CAAC;AAAA,IACH;AAAA,EACF;AACA,QAAM,CAAC,WAAW,KAAK,IAAI;AAE3B,QAAM,WAAW,cAAc,KAAK;AAEpC,QAAM,YAA0B;AAAA,IAC9B,OAAO;AAAA,IACP;AAAA,IACA,MAAM,UAAU;AAAA,IAChB,gBAAgB,UAAU;AAAA,IAC1B;AAAA,EACF;AAEA,SAAe,gBAAQ;AAAA,IACrB,GAAG;AAAA,IACH,MAAM,eAAe,SAAS;AAAA,EAChC,CAAC;AACH;AAEO,IAAM,eAAe;AAAA;AAAA,EAE1B,QAAQ;AAAA;AAAA,EAER,YAAY;AACd;AAgCO,SAASC,MAAK,OAAoE;AACvF,MAAY,cAAM,KAAK,GAAG;AACxB,WAAO;AAAA,EACT;AACA,MAAI,MAAM,KAAK,GAAG;AAChB,WAAO;AAAA,EACT;AACA,MAAY,iBAAS,KAAK,GAAG;AAC3B,WAAmB,yBAAaD,aAAY,KAAK,CAAC;AAAA,EACpD;AAEA,SAAO,MAAM,KAAmB;AAClC;AAgCO,SAAS,UAAU,WAAsE;AAC9F,MAAY,cAAM,SAAS,GAAG;AAC5B,WAAO;AAAA,EACT;AAEA,QAAM,QAAQC,MAAK,SAAS;AAC5B,SAAO,OAAO,KAAK;AACrB;AAEO,IAAM,gBAAgB,oBAAoB,IAAI,OAAO,GAAG,CAAC,OAAuB,YAAID,aAAY,EAAE,GAAG,CAACE,QAAO,UAAUA,GAAE,CAAC,CAAC;AAI3H,IAAM,QAAQ,MAAW;AAC9B,SAAO;AAAA,IACL,OAAO;AAAA,IACP,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,gBAAgB;AAAA,IAChB,MAAM;AAAA,IACN,UAAU;AAAA,MACR,MAAM;AAAA,MACN,OAAO;AAAA,MACP,UAAU;AAAA,IACZ;AAAA,EACF;AACF;AAqBO,IAAM,QAAQ,CAAC,UAAiC;AACrD,MAAI,CAAS,iBAAS,KAAK,GAAG;AAC5B,WAAO;AAAA,EACT;AAEA,QAAM,WAAW;AACjB,SAAO,SAAS,UAAU,aAAa,SAAS,UAAU;AAC5D;AAkCO,IAAM,SAAS,CAAC,SAAkB,YAA6B;AACpE,QAAM,MAAMD,MAAK,OAAO;AAExB,MAAI;AACJ,MAAY,iBAAS,QAAQ,QAAQ,KAAa,eAAO,QAAQ,QAAQ,GAAG;AAC1E,eAAW,QAAQ;AAAA,EACrB,OAAO;AACL,eAAW;AAAA,MACT,MAAc,oBAAY,QAAQ,UAAU,IAAI,IAAI,IAAI,SAAS,OAAO,QAAQ,UAAU;AAAA,MAC1F,OAAe,oBAAY,QAAQ,UAAU,KAAK,IAAI,IAAI,SAAS,QAAQ,QAAQ,UAAU;AAAA,MAC7F,UAAkB,oBAAY,QAAQ,UAAU,QAAQ,IAAI,IAAI,SAAS,WAAW,QAAQ,UAAU;AAAA,IACxG;AAAA,EACF;AAEA,QAAM,aAAyB;AAAA,IAC7B,QAAgB,oBAAY,QAAQ,MAAM,IAAI,IAAI,SAAS,QAAQ;AAAA,IACnE,MAAc,oBAAY,QAAQ,IAAI,IAAI,IAAI,OAAO,QAAQ;AAAA,IAC7D,gBAAwB,oBAAY,QAAQ,cAAc,IAAI,IAAI,iBAAiB,QAAQ;AAAA,IAC3F;AAAA,EACF;AAEA,SAAOA,MAAK,UAAU;AACxB;AAEO,IAAM,QAAQ,IAAI,SAA8B;AACrD,MAAI,KAAK,WAAW,GAAG;AACrB,WAAO,MAAM;AAAA,EACf;AACA,MAAI,KAAK,WAAW,GAAG;AACrB,WAAOA,MAAK,KAAK,CAAC,CAAE;AAAA,EACtB;AAEA,SAAO,KAAK,OAAY,CAAC,WAAW,SAAS;AAC3C,UAAM,UAAUA,MAAK,IAAI;AAEzB,UAAM,UAAsB;AAAA,MAC1B,QAAQ,QAAQ,UAAU;AAAA,MAC1B,MAAM,QAAQ,QAAQ;AAAA,MACtB,gBAAgB,QAAQ,kBAAkB;AAAA,MAC1C,UAAU;AAAA,QACR,MAAM,QAAQ,SAAS,QAAQ;AAAA,QAC/B,OAAO,QAAQ,SAAS,SAAS;AAAA,QACjC,UAAU,QAAQ,SAAS,YAAY;AAAA,MACzC;AAAA,IACF;AAEA,UAAM,MAAM,OAAO,WAAW,OAAO;AACrC,WAAO;AAAA,EACT,GAAGA,MAAK,KAAK,CAAC,CAAE,CAAC;AACnB;AAEA,IAAM,kBAAkB,CAAC,QAA4E;AAEnG,QAAM,cAAsB,mBAAW,KAAK,UAAU;AAGtD,MAAY,cAAM,YAAY,SAAS,KAAK,YAAY,cAAc,MAAM;AAC1E,WAAe,gBAAQ,CAAC,MAAM,GAAG,CAAC;AAAA,EACpC;AAGA,MAAY,gBAAQ,YAAY,SAAS,GAAG;AAC1C,WAAe,gBAAQ,CAAC,MAAM,MAAM,YAAY,IAAI,CAAC;AAAA,EACvD,OAAO;AACL,UAAM,eAAe,YAAY,YAAY,SAAS;AACtD,QAAY,kBAAU,YAAY,GAAG;AACnC,aAAO;AAAA,IACT;AAEA,WAAe,gBAAQ,CAAC,cAAc,YAAY,IAAI,CAAC;AAAA,EACzD;AACF;AAEA,IAAM,cAAc,CAAC,WAAwD;AAE3E,QAAM,cAAc;AACpB,MAAI,CAAC,YAAY,KAAK,MAAM,GAAG;AAC7B,WAAe;AAAA,MACD,yBAAa,QAAQ;AAAA,QAC/B,WAAW;AAAA,QACX,SAAS,IAAI,SAAS;AAAA,MACxB,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAe,gBAAQ,MAAM;AAC/B;AAEA,IAAM,qBAAqB,CACzB,YACA,SAC2G;AAC3G,MAAI,SAAS,aAAa,UAAU,CAAC,WAAW,WAAW,IAAI,GAAG;AAChE,WAAe,gBAAQ,CAAC,EAAE,MAAM,MAAM,gBAAgB,KAAK,GAAG,UAAU,CAAC;AAAA,EAC3E;AACA,MAAI,SAAS,aAAa,cAAc,WAAW,WAAW,GAAG,GAAG;AAClE,WAAe,gBAAQ,CAAC,EAAE,MAAM,MAAM,gBAAgB,KAAK,GAAG,UAAU,CAAC;AAAA,EAC3E;AAEA,QAAM,MAAc,oBAAY,YAAY,IAAI;AAEhD,QAAM,2BAA2B,wBAAwB,GAAG;AAC5D,MAAY,kBAAU,wBAAwB,GAAG;AAC/C,WAAO;AAAA,EACT;AACA,QAAM,CAAC,gBAAgB,KAAK,IAAI;AAEhC,QAAM,iBAAiB,cAAc,KAAK;AAC1C,MAAY,kBAAU,cAAc,GAAG;AACrC,WAAO;AAAA,EACT;AACA,QAAM,CAAC,MAAM,KAAK,IAAI;AAEtB,SAAe,gBAAQ,CAAC,EAAE,MAAM,eAAe,GAAG,KAAK,CAAC;AAC1D;AAEA,IAAM,0BAA0B,CAAC,QAAoF;AACnH,MAAI,aAAa;AACjB,QAAM,aAAqB,mBAAW,YAAY,GAAG;AACrD,QAAM,gBAAwB,mBAAW,YAAY,GAAG;AACxD,MAAY,kBAAU,WAAW,SAAS,GAAG;AAC3C,iBAAa,WAAW;AAAA,EAC1B,WAAmB,kBAAU,cAAc,SAAS,GAAG;AACrD,iBAAa,cAAc;AAAA,EAC7B;AAEA,QAAM,EAAE,WAAW,eAAe,IAAY,mBAAW,YAAY,GAAG;AAGxE,MAAY,cAAM,cAAc,GAAG;AACjC,WAAe,gBAAQ,CAAC,MAAM,GAAG,CAAC;AAAA,EACpC;AAEA,QAAM,EAAE,KAAK,IAAY,mBAAW,KAAK,GAAG;AAE5C,QAAM,4BAA4B,oBAAoB,cAAc;AACpE,MAAY,kBAAU,yBAAyB,GAAG;AAChD,WAAO;AAAA,EACT;AAEA,SAAe,gBAAQ,CAAC,2BAA2B,IAAI,CAAC;AAC1D;AAEA,IAAM,sBAAsB,CAAC,mBAAwE;AACnG,QAAM,EAAE,WAAW,WAAW,MAAM,mBAAmB,IAAY,mBAAW,gBAAgB,GAAG;AAGjG,MAAY,cAAM,SAAS,GAAG;AAC5B,QAAI,CAAC,+BAA+B,kBAAkB,GAAG;AACvD,aAAe;AAAA,QACD,yBAAa,oBAAoB;AAAA,UAC3C,WAAW;AAAA,UACX,SAAS,IAAI,SAAS,qEAAqE,kBAAkB;AAAA,QAC/G,CAAC;AAAA,MACH;AAAA,IACF;AAEA,WAAe,gBAAQ,EAAE,WAAW,OAAO,kBAAkB,GAAG,UAAU,KAAK,CAAC;AAAA,EAClF;AAGA,MAAY,gBAAQ,SAAS,GAAG;AAC9B,WAAe;AAAA,MACD,yBAAa,gBAAgB;AAAA,QACvC,WAAW;AAAA,QACX,SAAS,IAAI,SAAS,qEAAqE,cAAc;AAAA,MAC3G,CAAC;AAAA,IACH;AAAA,EACF;AAEA,MAAI,CAAC,+BAA+B,SAAS,GAAG;AAC9C,WAAe;AAAA,MACD,yBAAa,WAAW;AAAA,QAClC,WAAW;AAAA,QACX,SAAS,IAAI,SAAS,qEAAqE,SAAS;AAAA,MACtG,CAAC;AAAA,IACH;AAAA,EACF;AAEA,MAAI,CAAC,+BAA+B,kBAAkB,GAAG;AACvD,WAAe;AAAA,MACD,yBAAa,oBAAoB;AAAA,QAC3C,WAAW;AAAA,QACX,SAAS,IAAI,SAAS,oEAAoE,kBAAkB;AAAA,MAC9G,CAAC;AAAA,IACH;AAAA,EACF;AAGA,SAAe,gBAAQ,EAAE,WAAW,OAAO,SAAS,GAAG,UAAU,OAAO,kBAAkB,EAAE,CAAC;AAC/F;AAEA,IAAM,iCAAiC,CAAC,cAAqC;AAC3E,QAAM,gBAAgB;AAEtB,MAAI,UAAU,SAAS,GAAG,GAAG;AAC3B,UAAM,uBAAuB;AAC7B,UAAM,iBAAiB,UAAU,MAAM,IAAI,KAAK,CAAC;AACjD,UAAM,uBAAuB,UAAU,MAAM,oBAAoB,KAAK,CAAC;AAEvE,QAAI,eAAe,WAAW,qBAAqB,QAAQ;AACzD,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO,cAAc,KAAK,SAAS;AACrC;AAEA,IAAM,gBAAgB,CAAC,QAA0E;AAE/F,MAAI,IAAI,WAAW,GAAG,KAAK,IAAI,WAAW,GAAG,GAAG;AAC9C,WAAe,gBAAQ,CAAC,MAAM,GAAG,CAAC;AAAA,EACpC;AAGA,QAAM,WAAmB,mBAAW,KAAK,QAAQ;AACjD,MAAI,OAAO,SAAS;AACpB,MAAI,OAAO;AAEX,MAAY,kBAAU,SAAS,SAAS,GAAG;AACzC,WAAO,SAAS;AAChB,WAAO,SAAS,YAAY,SAAS;AAAA,EACvC;AAEA,MAAY,gBAAQ,IAAI,GAAG;AACzB,WAAe,gBAAQ,CAAC,MAAM,IAAI,CAAC;AAAA,EACrC;AAEA,QAAM,kBAAkB,UAAU,IAAI;AACtC,MAAY,kBAAU,eAAe,GAAG;AACtC,WAAO;AAAA,EACT;AAEA,SAAe,gBAAQ,CAAC,iBAAiB,IAAI,CAAC;AAChD;AAEA,IAAM,YAAY,CAAC,SAAoD;AAErE,MAAI,KAAK,WAAW,GAAG,GAAG;AACxB,UAAM,UAAkB,mBAAmB,oBAAY,MAAM,GAAG,GAAG,GAAG;AAEtE,QAAY,kBAAU,QAAQ,SAAS,GAAG;AACxC,YAAM,aAA2B,0BAAY,QAAQ,SAAS;AAC9D,UAAY,kBAAU,UAAU,GAAG;AACjC,eAAO;AAAA,MACT;AAEA,YAAM,YAAoB,mBAAW,QAAQ,MAAM,GAAG;AACtD,UAAY,kBAAU,UAAU,SAAS,KAAa,gBAAQ,UAAU,SAAS,GAAG;AAClF,YAAI,CAAS,iBAAS,UAAU,IAAI,GAAG;AACrC,iBAAe,gBAAoB,yBAAa,MAAM,EAAE,WAAW,WAAW,SAAS,IAAI,SAAS,6BAA6B,IAAI,IAAI,CAAC,CAAC;AAAA,QAC7I;AAEA,eAAe,gBAAQ,EAAE,OAAO,IAAI,QAAQ,SAAS,KAAoB,MAAM,OAAO,UAAU,IAAI,EAAE,CAAC;AAAA,MACzG,OAAO;AACL,eAAe,gBAAQ,EAAE,OAAO,IAAI,QAAQ,SAAS,KAAoB,MAAM,KAAK,CAAC;AAAA,MACvF;AAAA,IACF;AAAA,EACF;AAEA,MAAI,YAAuC,mBAAW,MAAM,GAAG;AAG/D,MAAY,cAAM,UAAU,SAAS,GAAG;AACtC,UAAME,kBAA8B,yBAAY,UAAU,IAAI;AAC9D,QAAY,kBAAUA,eAAc,GAAG;AACrC,aAAe;AAAA,QACD,yBAAa,MAAM;AAAA,UAC7B,WAAW;AAAA,UACX,SAAS,IAAI,SAAS,8CAA8C,IAAI;AAAA,UACxE,QAAQA,gBAAe,MAAM;AAAA,QAC/B,CAAC;AAAA,MACH;AAAA,IACF;AAEA,WAAe,gBAAQ,EAAE,OAAOA,iBAAgB,MAAM,KAAK,CAAC;AAAA,EAC9D;AAGA,MAAY,gBAAQ,UAAU,SAAS,GAAG;AACxC,WAAe;AAAA,MACD,yBAAa,MAAM,EAAE,WAAW,WAAW,SAAS,IAAI,SAAS,8CAA8C,IAAI,IAAI,CAAC;AAAA,IACtI;AAAA,EACF;AAEA,QAAM,WAAW,UAAU;AAE3B,MAAI,CAAS,iBAAS,UAAU,IAAI,GAAG;AACrC,WAAe;AAAA,MACD,yBAAa,MAAM,EAAE,WAAW,WAAW,SAAS,IAAI,SAAS,8CAA8C,IAAI,IAAI,CAAC;AAAA,IACtI;AAAA,EACF;AAGA,QAAM,iBAA8B,yBAAY,QAAQ;AACxD,MAAY,kBAAU,cAAc,GAAG;AACrC,WAAe;AAAA,MACD,yBAAa,MAAM;AAAA,QAC7B,WAAW;AAAA,QACX,SAAS,IAAI,SAAS,8CAA8C,IAAI;AAAA,QACxE,QAAQ,eAAe,MAAM;AAAA,MAC/B,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAe,gBAAQ,EAAE,OAAO,gBAAgB,MAAM,OAAO,UAAU,IAAI,EAAE,CAAC;AAChF;AAEA,IAAM,gBAAgB,CAAC,QAAmC;AACxD,QAAM,WAAwB,EAAE,MAAM,MAAM,OAAO,MAAM,UAAU,KAAK;AAGxE,QAAM,gBAAwB,mBAAW,KAAK,GAAG;AACjD,MAAY,kBAAU,cAAc,SAAS,KAAK,CAAS,gBAAQ,cAAc,IAAI,GAAG;AACtF,aAAS,WAAW,iBAAiB,cAAc,IAAI;AAAA,EACzD;AAGA,QAAM,aAAqB,mBAAW,cAAc,aAAa,cAAc,MAAM,GAAG;AACxF,MAAY,kBAAU,WAAW,SAAS,KAAK,CAAS,gBAAQ,WAAW,IAAI,GAAG;AAChF,aAAS,QAAQ,iBAAiB,WAAW,IAAI;AAAA,EACnD;AAEA,QAAM,OAAe,oBAAY,WAAW,aAAa,WAAW,IAAI;AACxE,MAAY,kBAAU,IAAI,GAAG;AAC3B,aAAS,OAAO,iBAAiB,IAAI;AAAA,EACvC;AACA,SAAO;AACT;AAEA,IAAM,QAAQ,CAAC,YAA6B;AAC1C,QAAM,SAAiB,kBAAU,QAAQ,MAAM,IAAgB,yBAAa,YAAY,QAAQ,MAAM,CAAC,IAAI;AAC3G,MAAI,OAAuB;AAC3B,MAAI,iBAA2C;AAE/C,MAAY,kBAAU,QAAQ,IAAI,GAAG;AACnC,QAAY,iBAAS,QAAQ,IAAI,GAAG;AAClC,aAAmB,yBAAa,UAAU,QAAQ,IAAI,CAAC;AAAA,IACzD,OAAO;AACL,aAAO;AAAA,QACL,OAAoB,kBAAK,QAAQ,KAAK,KAAK;AAAA,QAC3C,MAAM,QAAQ,KAAK,QAAQ;AAAA,MAC7B;AAAA,IACF;AAEA,QAAY,kBAAU,QAAQ,cAAc,GAAG;AAC7C,UAAY,iBAAS,QAAQ,cAAc,GAAG;AAC5C,yBAA6B,yBAAa,oBAAoB,QAAQ,cAAc,CAAC;AAAA,MACvF,OAAO;AACL,yBAAiB;AAAA,UACf,WAAW,QAAQ,eAAe;AAAA,UAClC,UAAU,QAAQ,eAAe,YAAY;AAAA,QAC/C;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,MAAI,WAAwB;AAAA,IAC1B,MAAM;AAAA,IACN,OAAO;AAAA,IACP,UAAU;AAAA,EACZ;AAEA,MAAY,kBAAU,QAAQ,QAAQ,GAAG;AACvC,QAAY,iBAAS,QAAQ,QAAQ,GAAG;AACtC,UAAI,iBAAiB,QAAQ;AAC7B,UAAY,kBAAU,QAAQ,IAAI,KAAK,CAAC,eAAe,WAAW,GAAG,KAAK,CAAC,eAAe,WAAW,GAAG,KAAK,CAAC,eAAe,WAAW,GAAG,GAAG;AAC5I,yBAAiB,MAAM;AAAA,MACzB;AAEA,iBAAW,cAAc,cAAc;AAAA,IACzC,OAAO;AACL,UAAI,OAAO,QAAQ,SAAS,QAAQ;AACpC,UAAY,kBAAU,IAAI,KAAK,CAAC,KAAK,WAAW,GAAG,KAAa,kBAAU,QAAQ,IAAI,GAAG;AACvF,eAAO,MAAM;AAAA,MACf;AAEA,iBAAW;AAAA,QACT,MAAc,kBAAU,IAAI,IAAI,iBAAiB,IAAI,IAAI;AAAA,QACzD,OAAe,kBAAU,QAAQ,SAAS,KAAK,IAAI,iBAAiB,QAAQ,SAAS,KAAK,IAAI;AAAA,QAC9F,UAAkB,kBAAU,QAAQ,SAAS,QAAQ,IAAI,iBAAiB,QAAQ,SAAS,QAAQ,IAAI;AAAA,MACzG;AAAA,IACF;AAAA,EACF;AAEA,QAAM,YAA0B;AAAA,IAC9B,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,MAAM,eAAe,SAAS;AAAA,EAChC;AACF;AAEO,IAAM,mBAAmB;AAAA,EAC9B,QAAQ;AAAA,EACR,gBAAgB;AAAA,EAChB,MAAM;AAAA,EACN,UAAU;AAAA,EACV,MAAM;AAAA,EACN,OAAO;AAAA,EACP,UAAU;AACZ;AAsCO,IAAM,SAAS,CAAC,SAAkB,wBAAiD,CAAC,MAAkB;AAC3G,SAAO,eAAeF,MAAK,OAAO,GAAG,qBAAqB;AAC5D;AAEO,IAAM,aAAa,CAAC,QAAsB;AAC/C,SAAe,kBAAU,IAAI,MAAM,KAAa,kBAAU,IAAI,IAAI;AACpE;AAEA,IAAM,iBAAiB,CAAC,KAAmB,wBAAiD,CAAC,MAAkB;AAC7G,MAAI,YAAY;AAChB,MAAY,kBAAU,IAAI,MAAM,KAAK,CAAQ,gBAAS,uBAAuB,iBAAiB,MAAM,GAAG;AACrG,gBAAY,YAAY,IAAI,SAAS;AAAA,EACvC;AAEA,MAAY,kBAAU,IAAI,IAAI,KAAK,CAAQ,gBAAS,uBAAuB,iBAAiB,IAAI,GAAG;AACjG,gBAAY,YAAY;AAExB,QAAY,kBAAU,IAAI,cAAc,KAAK,CAAQ,gBAAS,uBAAuB,iBAAiB,cAAc,GAAG;AACrH,kBAAY,YAAY,OAAO,IAAI,eAAe,SAAS;AAE3D,UAAY,kBAAU,IAAI,eAAe,QAAQ,GAAG;AAClD,oBAAY,YAAY,MAAM,OAAO,IAAI,eAAe,QAAQ;AAAA,MAClE;AAEA,kBAAY,YAAY;AAAA,IAC1B;AAEA,gBAAY,YAAY,IAAI,KAAK;AACjC,QAAY,kBAAU,IAAI,KAAK,IAAI,GAAG;AACpC,kBAAY,YAAY,MAAM,IAAI,KAAK;AAAA,IACzC;AAAA,EACF;AAEA,MAAI,CAAQ,gBAAS,uBAAuB,iBAAiB,QAAQ,GAAG;AACtE,gBAAY,YAAY,eAAe,IAAI,UAAU,qBAAqB;AAAA,EAC5E;AAEA,SAAO;AACT;AAEA,IAAM,iBAAiB,CAAC,UAAuB,wBAAiD,CAAC,MAAc;AAC7G,MAAI,YAAY;AAEhB,MAAY,kBAAU,SAAS,IAAI,KAAK,CAAQ,gBAAS,uBAAuB,iBAAiB,IAAI,GAAG;AACtG,gBAAY,YAAY,SAAS;AAAA,EACnC;AAEA,MAAY,kBAAU,SAAS,KAAK,KAAK,CAAQ,gBAAS,uBAAuB,iBAAiB,KAAK,GAAG;AACxG,gBAAY,YAAY,MAAM,SAAS;AAAA,EACzC;AAEA,MAAY,kBAAU,SAAS,QAAQ,KAAK,CAAQ,gBAAS,uBAAuB,iBAAiB,QAAQ,GAAG;AAC9G,gBAAY,YAAY,MAAM,SAAS;AAAA,EACzC;AAEA,SAAO;AACT;AAEA,IAAM,mBAAmB,CAAC,iBAA+B;AACvD,SAAO,aAAa,WAAW,KAAK,KAAK;AAC3C;AAEO,IAAM,SAAS,CAAC,iBAA+B;AACpD,SAAO,mBAAmB,YAAY;AACxC;AAEO,IAAM,SAAS,CAAC,iBAA+B;AACpD,SAAO,mBAAmB,YAAY;AACxC;","names":["parseString","from","it","hostNameResult"]}

package/dist/net/url.d.ts

@@ -1,6 +1,6 @@
 import { Dictionary, NominalType } from '@bessemer/cornerstone/types';
 import * as Uris from '@bessemer/cornerstone/net/uri';
-import { Uri, UriBuilder, UriComponent, UriLiteral, UriLocation } from '@bessemer/cornerstone/net/uri';
+import { Uri, UriBuilder, UriComponent, UriLiteral, UriLocation, UriParseMode } from '@bessemer/cornerstone/net/uri';
 import { Result } from '@bessemer/cornerstone/result';
 import { ErrorEvent } from '@bessemer/cornerstone/error/error-event';
 import Zod from 'zod';
@@ -10,7 +10,6 @@ export declare const encode: (uriComponent: UriComponent) => string;
 export declare const decode: (uriComponent: UriComponent) => string;
 export type UrlLiteral = NominalType<UriLiteral, typeof Namespace>;
 export interface UrlLocation extends UriLocation {
-    relative: boolean;
     pathSegments: Array<string>;
     parameters: Dictionary<string | Array<string>>;
 }
@@ -18,6 +17,7 @@ export interface Url extends Uri {
     _type: typeof Namespace;
     location: UrlLocation;
     href: UrlLiteral;
+    relative: boolean;
 }
 export declare const Namespace: import("../resource-key").ResourceNamespace<"url">;
 export declare const EqualBy: Equalitor<Url>;
@@ -25,7 +25,6 @@ type UrlBuilderPathPart = MergeExclusive<{
     path?: string | null;
 }, {
     pathSegments?: Array<string>;
-    relative?: boolean;
 }>;
 type UrlBuilderQueryPart = MergeExclusive<{
     query?: string | null;
@@ -37,9 +36,10 @@ type UrlBuilderLocationPart = UrlBuilderPathPart & UrlBuilderQueryPart & {
 };
 export type UrlBuilder = UriBuilder & {
     location?: UrlBuilderLocationPart | null | undefined;
+    relative?: boolean;
 };
-export type UrlLike = Url | Uri | UriLiteral | UrlLiteral | UrlBuilder;
-export declare const parseString: (value: string) => Result<Url, ErrorEvent>;
+export type UrlLike = Url | Uri | UrlBuilder | UriLiteral | UrlLiteral;
+export declare const parseString: (value: string, mode?: UriParseMode) => Result<Url, ErrorEvent>;
 export declare function from(value: UrlLike | string): Url;
 export declare function from(value: UrlLike | string | null): Url | null;
 export declare function from(value: UrlLike | string | undefined): Url | undefined;
@@ -49,9 +49,12 @@ export declare function toLiteral(likeValue: UrlLike | null): UrlLiteral | null;
 export declare function toLiteral(likeValue: UrlLike | undefined): UrlLiteral | undefined;
 export declare function toLiteral(likeValue: UrlLike | null | undefined): UrlLiteral | null | undefined;
 export declare const SchemaLiteral: Zod.ZodPipe<Zod.ZodString, Zod.ZodTransform<UrlLiteral, string>>;
+export declare const empty: () => Url;
 export declare const isUrl: (value: unknown) => value is Url;
-export declare const merge: (element: UrlLike, builder: UrlBuilder) => Url;
+export declare const update: (element: UrlLike, builder: UrlBuilder) => Url;
+export declare const navigate: (base: UrlLike, next: UrlLike) => Url;
 export declare const format: (uriLike: Uris.UriLike, excludedUriComponents?: Array<Uris.UriComponentType>) => UriLiteral;
+export declare const isComplete: (uri: Uri) => boolean;
 export declare const getParameter: (url: UrlLike, name: string) => string | undefined;
 export declare const getJsonParameter: <T>(url: UrlLike, name: string) => T | undefined;
 export {};

package/dist/net/url.d.ts.map

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

package/dist/net/url.js

@@ -1,6 +1,7 @@
 // src/net/url.ts
 import * as Uris from "@bessemer/cornerstone/net/uri";
-import { success } from "@bessemer/cornerstone/result";
+import { UriParseMode } from "@bessemer/cornerstone/net/uri";
+import * as Results from "@bessemer/cornerstone/result";
 import { unpackResult } from "@bessemer/cornerstone/error/error-event";
 import * as Strings from "@bessemer/cornerstone/string";
 import * as Arrays from "@bessemer/cornerstone/array";
@@ -13,12 +14,8 @@ var encode2 = Uris.encode;
 var decode2 = Uris.decode;
 var Namespace = Uris.UrlNamespace;
 var EqualBy = Equalitors.deepNatural();
-var parseString2 = (value) => {
-  const result = Uris.parseString(value);
-  if (!result.isSuccess) {
-    return result;
-  }
-  return success(fromUri(result.value));
+var parseString2 = (value, mode = UriParseMode.Strict) => {
+  return Results.map(Uris.parseString(value, mode), (it) => Results.success(fromUri(it)));
 };
 function from2(value) {
   if (Objects.isNil(value)) {
@@ -42,7 +39,21 @@ function toLiteral(likeValue) {
   const value = from2(likeValue);
   return format2(value);
 }
-var SchemaLiteral = structuredTransform(Zod.string(), (it) => parseString2(it).map((it2) => toLiteral(it2)));
+var SchemaLiteral = structuredTransform(Zod.string(), (it) => Results.map(parseString2(it), (it2) => toLiteral(it2)));
+var empty2 = () => {
+  const result = Uris.empty();
+  return {
+    ...result,
+    _type: Namespace,
+    href: result.href,
+    location: {
+      ...result.location,
+      pathSegments: [],
+      parameters: {}
+    },
+    relative: true
+  };
+};
 var isUrl = (value) => {
   if (!Objects.isObject(value)) {
     return false;
@@ -50,8 +61,9 @@ var isUrl = (value) => {
   const uriValue = value;
   return uriValue._type === Namespace;
 };
-var merge = (element, builder) => {
+var update = (element, builder) => {
   const url = from2(element);
+  const buildRelative = builder.relative === true;
   let location;
   if (Strings.isString(builder.location) || Objects.isNull(builder.location)) {
     location = builder.location;
@@ -65,16 +77,35 @@ var merge = (element, builder) => {
     };
   }
   const uriBuilder = {
-    scheme: Objects.isUndefined(builder.scheme) ? url.scheme : builder.scheme,
-    host: Objects.isUndefined(builder.host) ? url.host : builder.host,
-    authentication: Objects.isUndefined(builder.authentication) ? url.authentication : builder.authentication,
-    location
+    scheme: Objects.isUndefined(builder.scheme) && !buildRelative ? url.scheme : builder.scheme,
+    host: Objects.isUndefined(builder.host) && !buildRelative ? url.host : builder.host,
+    authentication: Objects.isUndefined(builder.authentication) && !buildRelative ? url.authentication : builder.authentication,
+    location,
+    relative: buildRelative
   };
   return from2(uriBuilder);
 };
+var navigate = (base, next) => {
+  const baseUrl = from2(base);
+  const nextUrl = from2(next);
+  const isOnlyFragment = nextUrl.relative && Objects.isNil(nextUrl.location.path) && Objects.isNil(nextUrl.location.query);
+  const builder = {
+    scheme: nextUrl.scheme ?? void 0,
+    host: nextUrl.host ?? void 0,
+    authentication: Objects.isPresent(nextUrl.host) ? nextUrl.authentication : void 0,
+    location: {
+      pathSegments: nextUrl.relative ? [...baseUrl.location.pathSegments, ...nextUrl.location.pathSegments] : nextUrl.location.pathSegments,
+      query: isOnlyFragment ? void 0 : nextUrl.location.query,
+      fragment: nextUrl.location.fragment
+    }
+  };
+  const uri = update(baseUrl, builder);
+  return uri;
+};
 var format2 = Uris.format;
+var isComplete2 = Uris.isComplete;
 var build = (builder) => {
-  if ((builder.location?.relative ?? false) && Objects.isPresent(builder.host)) {
+  if ((builder.relative ?? false) && Objects.isPresent(builder.host)) {
     throw new Error(`[${Namespace}]: Unable to construct a relative url with a non-null host: ${builder}`);
   }
   const uriBuilder = convertUrlBuilderToUriBuilder(builder);
@@ -86,13 +117,16 @@ var convertUrlBuilderToUriBuilder = (builder) => {
     if (Objects.isNil(builder.host)) {
       return {
         ...builder,
-        location: { path: "/" }
+        location: { path: builder.relative === true ? "" : "/" }
       };
     }
     return builder;
   }
-  const relative = builder.location.relative ?? false;
-  let path = builder.location.path;
+  if (Strings.isString(builder.location)) {
+    return builder;
+  }
+  const relative = builder.relative ?? false;
+  let path = relative ? Strings.removeStart(builder.location.path ?? "", "/") : builder.location.path;
   if (Objects.isPresent(builder.location.pathSegments)) {
     path = formatPathSegments(builder.location.pathSegments, Objects.isPresent(builder.host), relative);
   }
@@ -145,13 +179,13 @@ var fromUri = (uri) => {
     _type: Namespace,
     location: {
       path: formatPathSegments(pathSegments, Objects.isPresent(uri.host), relative),
-      relative,
       pathSegments,
       query: formatQueryParameters(parameters),
       parameters,
       fragment: uri.location.fragment
     },
-    href: uri.href
+    href: uri.href,
+    relative
   };
   url.href = format2(url);
   return url;
@@ -198,14 +232,17 @@ export {
   Namespace,
   SchemaLiteral,
   decode2 as decode,
+  empty2 as empty,
   encode2 as encode,
   format2 as format,
   from2 as from,
   getJsonParameter,
   getParameter,
+  isComplete2 as isComplete,
   isUrl,
-  merge,
+  navigate,
   parseString2 as parseString,
-  toLiteral
+  toLiteral,
+  update
 };
 //# sourceMappingURL=url.js.map

package/dist/net/url.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/net/url.ts"],"sourcesContent":["import { Dictionary, NominalType } from '@bessemer/cornerstone/types'\nimport * as Uris from '@bessemer/cornerstone/net/uri'\nimport { Uri, UriBuilder, UriComponent, UriLiteral, UriLocation } from '@bessemer/cornerstone/net/uri'\nimport { Result, success } from '@bessemer/cornerstone/result'\nimport { ErrorEvent, unpackResult } from '@bessemer/cornerstone/error/error-event'\nimport * as Strings from '@bessemer/cornerstone/string'\nimport * as Arrays from '@bessemer/cornerstone/array'\nimport { first, isEmpty } from '@bessemer/cornerstone/array'\nimport { structuredTransform } from '@bessemer/cornerstone/zod-util'\nimport Zod from 'zod'\nimport * as Equalitors from '@bessemer/cornerstone/equalitor'\nimport { Equalitor } from '@bessemer/cornerstone/equalitor'\nimport { MergeExclusive } from 'type-fest'\nimport * as Objects from '@bessemer/cornerstone/object'\n\nexport const encode = Uris.encode\n\nexport const decode = Uris.decode\n\nexport type UrlLiteral = NominalType<UriLiteral, typeof Namespace>\n\nexport interface UrlLocation extends UriLocation {\n  relative: boolean\n  pathSegments: Array<string>\n  parameters: Dictionary<string | Array<string>>\n}\n\nexport interface Url extends Uri {\n  _type: typeof Namespace\n  location: UrlLocation\n  href: UrlLiteral\n}\n\nexport const Namespace = Uris.UrlNamespace\nexport const EqualBy: Equalitor<Url> = Equalitors.deepNatural()\n\ntype UrlBuilderPathPart = MergeExclusive<{ path?: string | null }, { pathSegments?: Array<string>; relative?: boolean }>\ntype UrlBuilderQueryPart = MergeExclusive<{ query?: string | null }, { parameters?: Dictionary<string | Array<string>> }>\ntype UrlBuilderLocationPart = UrlBuilderPathPart &\n  UrlBuilderQueryPart & {\n    fragment?: string | null\n  }\n\nexport type UrlBuilder = UriBuilder & {\n  location?: UrlBuilderLocationPart | null | undefined\n}\n\nexport type UrlLike = Url | Uri | UriLiteral | UrlLiteral | UrlBuilder\n\nexport const parseString = (value: string): Result<Url, ErrorEvent> => {\n  const result = Uris.parseString(value)\n  if (!result.isSuccess) {\n    return result\n  }\n\n  return success(fromUri(result.value))\n}\n\nexport function from(value: UrlLike | string): Url\nexport function from(value: UrlLike | string | null): Url | null\nexport function from(value: UrlLike | string | undefined): Url | undefined\nexport function from(value: UrlLike | string | null | undefined): Url | null | undefined\nexport function from(value: UrlLike | string | null | undefined): Url | null | undefined {\n  if (Objects.isNil(value)) {\n    return value\n  }\n  if (isUrl(value)) {\n    return value\n  }\n  if (Uris.isUri(value)) {\n    return fromUri(value)\n  }\n  if (Strings.isString(value)) {\n    return unpackResult(parseString(value))\n  }\n\n  return build(value as UrlBuilder)\n}\n\nexport function toLiteral(likeValue: UrlLike): UrlLiteral\nexport function toLiteral(likeValue: UrlLike | null): UrlLiteral | null\nexport function toLiteral(likeValue: UrlLike | undefined): UrlLiteral | undefined\nexport function toLiteral(likeValue: UrlLike | null | undefined): UrlLiteral | null | undefined\nexport function toLiteral(likeValue: UrlLike | null | undefined): UrlLiteral | null | undefined {\n  if (Objects.isNil(likeValue)) {\n    return likeValue\n  }\n\n  const value = from(likeValue)\n  return format(value) as UrlLiteral\n}\n\nexport const SchemaLiteral = structuredTransform(Zod.string(), (it: string) => parseString(it).map((it) => toLiteral(it)))\n// JOHN need a schema for the object version...\n// export const SchemaInstance = structuredTransform(Zod.string(), parseString)\n\nexport const isUrl = (value: unknown): value is Url => {\n  if (!Objects.isObject(value)) {\n    return false\n  }\n\n  const uriValue = value as any as Url\n  return uriValue._type === Namespace\n}\n\nexport const merge = (element: UrlLike, builder: UrlBuilder): Url => {\n  const url = from(element)\n\n  let location: UrlBuilderLocationPart | null | undefined\n  if (Strings.isString(builder.location) || Objects.isNull(builder.location)) {\n    location = builder.location\n  } else {\n    const usePathSegments = !Objects.isUndefined(builder.location?.pathSegments)\n    const useParameters = !Objects.isUndefined(builder.location?.parameters)\n\n    location = {\n      ...(usePathSegments\n        ? { pathSegments: builder.location?.pathSegments }\n        : { path: Objects.isUndefined(builder.location?.path) ? url.location.path : builder.location.path }),\n      ...(useParameters\n        ? { parameters: builder.location?.parameters }\n        : { query: Objects.isUndefined(builder.location?.query) ? url.location.query : builder.location.query }),\n      fragment: Objects.isUndefined(builder.location?.fragment) ? url.location.fragment : builder.location.fragment,\n    }\n  }\n\n  const uriBuilder: UriBuilder = {\n    scheme: Objects.isUndefined(builder.scheme) ? url.scheme : builder.scheme,\n    host: Objects.isUndefined(builder.host) ? url.host : builder.host,\n    authentication: Objects.isUndefined(builder.authentication) ? url.authentication : builder.authentication,\n    location,\n  }\n\n  return from(uriBuilder)\n}\n\nexport const format = Uris.format\n\nconst build = (builder: UrlBuilder): Url => {\n  if ((builder.location?.relative ?? false) && Objects.isPresent(builder.host)) {\n    throw new Error(`[${Namespace}]: Unable to construct a relative url with a non-null host: ${builder}`)\n  }\n\n  const uriBuilder = convertUrlBuilderToUriBuilder(builder)\n  const uri = Uris.from(uriBuilder)\n  return fromUri(uri)\n}\n\nconst convertUrlBuilderToUriBuilder = (builder: UrlBuilder): UriBuilder => {\n  if (Objects.isNil(builder.location)) {\n    if (Objects.isNil(builder.host)) {\n      return {\n        ...builder,\n        location: { path: '/' },\n      }\n    }\n\n    return builder\n  }\n\n  const relative = builder.location.relative ?? false\n\n  let path = builder.location.path\n  if (Objects.isPresent(builder.location.pathSegments)) {\n    path = formatPathSegments(builder.location.pathSegments, Objects.isPresent(builder.host), relative)\n  }\n\n  let query = builder.location.query\n  if (Objects.isPresent(builder.location.parameters)) {\n    query = formatQueryParameters(builder.location.parameters)\n  }\n\n  return {\n    ...builder,\n    location: { path, query, fragment: builder.location.fragment },\n  }\n}\n\nconst fromUri = (uri: Uri): Url => {\n  let relative: boolean = false\n  let pathSegments: Array<string> = []\n  const parameters: Dictionary<string | Array<string>> = {}\n\n  if (Objects.isPresent(uri.location.path)) {\n    if (!uri.location.path.startsWith('/')) {\n      relative = true\n    }\n\n    pathSegments = Strings.removeStart(uri.location.path, '/')\n      .split('/')\n      .filter((it) => !Strings.isBlank(it))\n      .map((urlPathPart) => decode(urlPathPart))\n  } else {\n    if (Objects.isNil(uri.host)) {\n      relative = true\n    }\n  }\n\n  if (Objects.isPresent(uri.location.query)) {\n    uri.location.query.split('&').forEach((parameterPair) => {\n      let splitParameters = parameterPair.split('=')\n\n      if (!Strings.isBlank(first(splitParameters))) {\n        let key = decode(splitParameters[0]!)\n        let value = ''\n        if (splitParameters.length === 2) {\n          value = splitParameters[1]!\n        }\n        if (Objects.isNil(parameters[key])) {\n          parameters[key] = decode(value)\n        } else if (!Array.isArray(parameters[key])) {\n          let paramList = [parameters[key]]\n          paramList.push(decode(value))\n          parameters[key] = paramList\n        } else {\n          parameters[key].push(decode(value))\n        }\n      }\n    })\n  }\n\n  const url: Url = {\n    ...uri,\n    _type: Namespace,\n    location: {\n      path: formatPathSegments(pathSegments, Objects.isPresent(uri.host), relative),\n      relative,\n      pathSegments,\n      query: formatQueryParameters(parameters),\n      parameters,\n      fragment: uri.location.fragment,\n    },\n    href: uri.href as UrlLiteral,\n  }\n\n  url.href = format(url) as UrlLiteral\n  return url\n}\n\nconst formatPathSegments = (pathSegments: Array<string>, hasHost: boolean, relative: boolean): UriComponent | null => {\n  if (Arrays.isEmpty(pathSegments)) {\n    if (!hasHost && !relative) {\n      return '/'\n    } else {\n      return null\n    }\n  }\n\n  return (relative ? '' : '/') + pathSegments.map((it) => encode(it)).join('/')\n}\n\nconst formatQueryParameters = (parameters: Dictionary<string | Array<string>>): UriComponent | null => {\n  const parameterEntries = Object.entries(parameters)\n  if (isEmpty(parameterEntries)) {\n    return null\n  }\n\n  return Object.entries(parameters)\n    .flatMap(([key, value]) => {\n      if (Array.isArray(value)) {\n        return value.map((it) => `${encode(key)}=${encode(it)}`)\n      } else {\n        return [`${encode(key)}=${encode(value)}`]\n      }\n    })\n    .join('&')\n}\n\n// JOHN I don't know about these two methods...\nexport const getParameter = (url: UrlLike, name: string): string | undefined => {\n  const parameter = from(url).location.parameters[name]\n  if (Objects.isNil(parameter)) {\n    return undefined\n  }\n\n  if (Array.isArray(parameter)) {\n    throw new Error(`Expected a single parameter value but found multiple for parameter: ${name}`)\n  }\n\n  return parameter\n}\n\nexport const getJsonParameter = <T>(url: UrlLike, name: string): T | undefined => {\n  const value = getParameter(url, name)\n  return Objects.isPresent(value) ? JSON.parse(value) : undefined\n}\n"],"mappings":"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","names":["isEmpty","encode","decode","parseString","from","format","it"]}
+{"version":3,"sources":["../../src/net/url.ts"],"sourcesContent":["import { Dictionary, NominalType } from '@bessemer/cornerstone/types'\nimport * as Uris from '@bessemer/cornerstone/net/uri'\nimport { Uri, UriBuilder, UriComponent, UriLiteral, UriLocation, UriParseMode } from '@bessemer/cornerstone/net/uri'\nimport * as Results from '@bessemer/cornerstone/result'\nimport { Result } from '@bessemer/cornerstone/result'\nimport { ErrorEvent, unpackResult } from '@bessemer/cornerstone/error/error-event'\nimport * as Strings from '@bessemer/cornerstone/string'\nimport * as Arrays from '@bessemer/cornerstone/array'\nimport { first, isEmpty } from '@bessemer/cornerstone/array'\nimport { structuredTransform } from '@bessemer/cornerstone/zod-util'\nimport Zod from 'zod'\nimport * as Equalitors from '@bessemer/cornerstone/equalitor'\nimport { Equalitor } from '@bessemer/cornerstone/equalitor'\nimport { MergeExclusive } from 'type-fest'\nimport * as Objects from '@bessemer/cornerstone/object'\n\nexport const encode = Uris.encode\n\nexport const decode = Uris.decode\n\nexport type UrlLiteral = NominalType<UriLiteral, typeof Namespace>\n\nexport interface UrlLocation extends UriLocation {\n  pathSegments: Array<string>\n  parameters: Dictionary<string | Array<string>>\n}\n\nexport interface Url extends Uri {\n  _type: typeof Namespace\n  location: UrlLocation\n  href: UrlLiteral\n  relative: boolean\n}\n\nexport const Namespace = Uris.UrlNamespace\nexport const EqualBy: Equalitor<Url> = Equalitors.deepNatural()\n\ntype UrlBuilderPathPart = MergeExclusive<{ path?: string | null }, { pathSegments?: Array<string> }>\ntype UrlBuilderQueryPart = MergeExclusive<{ query?: string | null }, { parameters?: Dictionary<string | Array<string>> }>\ntype UrlBuilderLocationPart = UrlBuilderPathPart &\n  UrlBuilderQueryPart & {\n    fragment?: string | null\n  }\n\nexport type UrlBuilder = UriBuilder & {\n  location?: UrlBuilderLocationPart | null | undefined\n  relative?: boolean\n}\n\nexport type UrlLike = Url | Uri | UrlBuilder | UriLiteral | UrlLiteral\n\nexport const parseString = (value: string, mode: UriParseMode = UriParseMode.Strict): Result<Url, ErrorEvent> => {\n  return Results.map(Uris.parseString(value, mode), (it) => Results.success(fromUri(it)))\n}\n\nexport function from(value: UrlLike | string): Url\nexport function from(value: UrlLike | string | null): Url | null\nexport function from(value: UrlLike | string | undefined): Url | undefined\nexport function from(value: UrlLike | string | null | undefined): Url | null | undefined\nexport function from(value: UrlLike | string | null | undefined): Url | null | undefined {\n  if (Objects.isNil(value)) {\n    return value\n  }\n  if (isUrl(value)) {\n    return value\n  }\n  if (Uris.isUri(value)) {\n    return fromUri(value)\n  }\n  if (Strings.isString(value)) {\n    return unpackResult(parseString(value))\n  }\n\n  return build(value as UrlBuilder)\n}\n\nexport function toLiteral(likeValue: UrlLike): UrlLiteral\nexport function toLiteral(likeValue: UrlLike | null): UrlLiteral | null\nexport function toLiteral(likeValue: UrlLike | undefined): UrlLiteral | undefined\nexport function toLiteral(likeValue: UrlLike | null | undefined): UrlLiteral | null | undefined\nexport function toLiteral(likeValue: UrlLike | null | undefined): UrlLiteral | null | undefined {\n  if (Objects.isNil(likeValue)) {\n    return likeValue\n  }\n\n  const value = from(likeValue)\n  return format(value) as UrlLiteral\n}\n\nexport const SchemaLiteral = structuredTransform(Zod.string(), (it: string) => Results.map(parseString(it), (it) => toLiteral(it)))\n// JOHN need a schema for the object version...\n// export const SchemaInstance = structuredTransform(Zod.string(), parseString)\n\nexport const empty = (): Url => {\n  const result = Uris.empty()\n\n  return {\n    ...result,\n    _type: Namespace,\n    href: result.href as UrlLiteral,\n    location: {\n      ...result.location,\n      pathSegments: [],\n      parameters: {},\n    },\n    relative: true,\n  }\n}\n\nexport const isUrl = (value: unknown): value is Url => {\n  if (!Objects.isObject(value)) {\n    return false\n  }\n\n  const uriValue = value as any as Url\n  return uriValue._type === Namespace\n}\n\nexport const update = (element: UrlLike, builder: UrlBuilder): Url => {\n  const url = from(element)\n\n  const buildRelative = builder.relative === true\n\n  let location: UrlBuilderLocationPart | null | undefined\n  if (Strings.isString(builder.location) || Objects.isNull(builder.location)) {\n    location = builder.location\n  } else {\n    const usePathSegments = !Objects.isUndefined(builder.location?.pathSegments)\n    const useParameters = !Objects.isUndefined(builder.location?.parameters)\n\n    location = {\n      ...(usePathSegments\n        ? { pathSegments: builder.location?.pathSegments }\n        : { path: Objects.isUndefined(builder.location?.path) ? url.location.path : builder.location.path }),\n      ...(useParameters\n        ? { parameters: builder.location?.parameters }\n        : { query: Objects.isUndefined(builder.location?.query) ? url.location.query : builder.location.query }),\n      fragment: Objects.isUndefined(builder.location?.fragment) ? url.location.fragment : builder.location.fragment,\n    }\n  }\n\n  const uriBuilder: UrlBuilder = {\n    scheme: Objects.isUndefined(builder.scheme) && !buildRelative ? url.scheme : builder.scheme,\n    host: Objects.isUndefined(builder.host) && !buildRelative ? url.host : builder.host,\n    authentication: Objects.isUndefined(builder.authentication) && !buildRelative ? url.authentication : builder.authentication,\n    location,\n    relative: buildRelative,\n  }\n\n  return from(uriBuilder)\n}\n\nexport const navigate = (base: UrlLike, next: UrlLike): Url => {\n  const baseUrl = from(base)\n  const nextUrl = from(next)\n\n  const isOnlyFragment = nextUrl.relative && Objects.isNil(nextUrl.location.path) && Objects.isNil(nextUrl.location.query)\n\n  const builder: UrlBuilder = {\n    scheme: nextUrl.scheme ?? undefined,\n    host: nextUrl.host ?? undefined,\n    authentication: Objects.isPresent(nextUrl.host) ? nextUrl.authentication : undefined,\n    location: {\n      pathSegments: nextUrl.relative ? [...baseUrl.location.pathSegments, ...nextUrl.location.pathSegments] : nextUrl.location.pathSegments,\n      query: isOnlyFragment ? undefined : nextUrl.location.query,\n      fragment: nextUrl.location.fragment,\n    },\n  }\n\n  const uri = update(baseUrl, builder)\n  return uri\n}\n\nexport const format = Uris.format\nexport const isComplete = Uris.isComplete\n\nconst build = (builder: UrlBuilder): Url => {\n  if ((builder.relative ?? false) && Objects.isPresent(builder.host)) {\n    throw new Error(`[${Namespace}]: Unable to construct a relative url with a non-null host: ${builder}`)\n  }\n\n  const uriBuilder = convertUrlBuilderToUriBuilder(builder)\n  const uri = Uris.from(uriBuilder)\n  return fromUri(uri)\n}\n\nconst convertUrlBuilderToUriBuilder = (builder: UrlBuilder): UriBuilder => {\n  if (Objects.isNil(builder.location)) {\n    if (Objects.isNil(builder.host)) {\n      return {\n        ...builder,\n        location: { path: builder.relative === true ? '' : '/' },\n      }\n    }\n\n    return builder\n  }\n\n  if (Strings.isString(builder.location)) {\n    return builder\n  }\n\n  const relative = builder.relative ?? false\n  let path = relative ? Strings.removeStart(builder.location.path ?? '', '/') : builder.location.path\n  if (Objects.isPresent(builder.location.pathSegments)) {\n    path = formatPathSegments(builder.location.pathSegments, Objects.isPresent(builder.host), relative)\n  }\n\n  let query = builder.location.query\n  if (Objects.isPresent(builder.location.parameters)) {\n    query = formatQueryParameters(builder.location.parameters)\n  }\n\n  return {\n    ...builder,\n    location: { path, query, fragment: builder.location.fragment },\n  }\n}\n\nconst fromUri = (uri: Uri): Url => {\n  let relative: boolean = false\n  let pathSegments: Array<string> = []\n  const parameters: Dictionary<string | Array<string>> = {}\n\n  if (Objects.isPresent(uri.location.path)) {\n    if (!uri.location.path.startsWith('/')) {\n      relative = true\n    }\n\n    pathSegments = Strings.removeStart(uri.location.path, '/')\n      .split('/')\n      .filter((it) => !Strings.isBlank(it))\n      .map((urlPathPart) => decode(urlPathPart))\n  } else {\n    if (Objects.isNil(uri.host)) {\n      relative = true\n    }\n  }\n\n  if (Objects.isPresent(uri.location.query)) {\n    uri.location.query.split('&').forEach((parameterPair) => {\n      let splitParameters = parameterPair.split('=')\n\n      if (!Strings.isBlank(first(splitParameters))) {\n        let key = decode(splitParameters[0]!)\n        let value = ''\n        if (splitParameters.length === 2) {\n          value = splitParameters[1]!\n        }\n        if (Objects.isNil(parameters[key])) {\n          parameters[key] = decode(value)\n        } else if (!Array.isArray(parameters[key])) {\n          let paramList = [parameters[key]]\n          paramList.push(decode(value))\n          parameters[key] = paramList\n        } else {\n          parameters[key].push(decode(value))\n        }\n      }\n    })\n  }\n\n  const url: Url = {\n    ...uri,\n    _type: Namespace,\n    location: {\n      path: formatPathSegments(pathSegments, Objects.isPresent(uri.host), relative),\n      pathSegments,\n      query: formatQueryParameters(parameters),\n      parameters,\n      fragment: uri.location.fragment,\n    },\n    href: uri.href as UrlLiteral,\n    relative,\n  }\n\n  url.href = format(url) as UrlLiteral\n  return url\n}\n\nconst formatPathSegments = (pathSegments: Array<string>, hasHost: boolean, relative: boolean): UriComponent | null => {\n  if (Arrays.isEmpty(pathSegments)) {\n    if (!hasHost && !relative) {\n      return '/'\n    } else {\n      return null\n    }\n  }\n\n  return (relative ? '' : '/') + pathSegments.map((it) => encode(it)).join('/')\n}\n\nconst formatQueryParameters = (parameters: Dictionary<string | Array<string>>): UriComponent | null => {\n  const parameterEntries = Object.entries(parameters)\n  if (isEmpty(parameterEntries)) {\n    return null\n  }\n\n  return Object.entries(parameters)\n    .flatMap(([key, value]) => {\n      if (Array.isArray(value)) {\n        return value.map((it) => `${encode(key)}=${encode(it)}`)\n      } else {\n        return [`${encode(key)}=${encode(value)}`]\n      }\n    })\n    .join('&')\n}\n\n// JOHN I don't know about these two methods...\nexport const getParameter = (url: UrlLike, name: string): string | undefined => {\n  const parameter = from(url).location.parameters[name]\n  if (Objects.isNil(parameter)) {\n    return undefined\n  }\n\n  if (Array.isArray(parameter)) {\n    throw new Error(`Expected a single parameter value but found multiple for parameter: ${name}`)\n  }\n\n  return parameter\n}\n\nexport const getJsonParameter = <T>(url: UrlLike, name: string): T | undefined => {\n  const value = getParameter(url, name)\n  return Objects.isPresent(value) ? JSON.parse(value) : undefined\n}\n"],"mappings":"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","names":["isEmpty","encode","decode","parseString","from","format","it","empty","isComplete"]}

package/dist/object/object-diff.d.ts.map

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

package/dist/object/object-diff.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/object/object-diff.ts"],"sourcesContent":["import { ObjectPath } from '@bessemer/cornerstone/object/object-path'\nimport { ConstrainTypePath, ObjectPathType, TypePathGet, TypePathType } from '@bessemer/cornerstone/object/type-path-type'\nimport { matches as typePathMatches, TypePath } from '@bessemer/cornerstone/object/type-path'\n\nexport enum ObjectDiffType {\n  Add = 'Add',\n  Remove = 'Remove',\n  Update = 'Update',\n  Move = 'Move',\n}\n\nexport type AddObjectDiff<N, T extends TypePathType> = {\n  type: ObjectDiffType.Add\n  path: ObjectPath<T>\n  value: TypePathGet<T, N>\n}\n\nexport type RemoveObjectDiff<N, T extends TypePathType> = {\n  type: ObjectDiffType.Remove\n  path: ObjectPath<T>\n  originalValue: TypePathGet<T, N>\n}\n\nexport type UpdateObjectDiff<N, T extends TypePathType> = {\n  type: ObjectDiffType.Update\n  path: ObjectPath<T>\n  value: TypePathGet<T, N>\n  originalValue: TypePathGet<T, N>\n}\n\nexport type MoveObjectDiff<N, T extends TypePathType> = {\n  type: ObjectDiffType.Move\n  path: ObjectPath<T>\n  value: TypePathGet<T, N>\n  position: number\n  originalPosition: number\n}\n\nexport type ObjectDiffEntry<N, T extends TypePathType = TypePathType> =\n  | AddObjectDiff<N, T>\n  | RemoveObjectDiff<N, T>\n  | UpdateObjectDiff<N, T>\n  | MoveObjectDiff<N, T>\n\nexport type ObjectDiff<N> = Array<ObjectDiffEntry<N>>\n\nexport const add =\n  <N>() =>\n  <T extends ObjectPathType>(path: ObjectPath<ConstrainTypePath<T, N>>, value: TypePathGet<T, N>): AddObjectDiff<N, T> => {\n    return { type: ObjectDiffType.Add, path, value }\n  }\n\nexport const remove =\n  <N>() =>\n  <T extends ObjectPathType>(path: ObjectPath<ConstrainTypePath<T, N>>, originalValue: TypePathGet<T, N>): RemoveObjectDiff<N, T> => {\n    return { type: ObjectDiffType.Remove, path, originalValue }\n  }\n\nexport const update =\n  <N>() =>\n  <T extends ObjectPathType>(\n    path: ObjectPath<ConstrainTypePath<T, N>>,\n    value: TypePathGet<T, N>,\n    originalValue: TypePathGet<T, N>\n  ): UpdateObjectDiff<N, T> => {\n    return { type: ObjectDiffType.Update, path, value, originalValue }\n  }\n\nexport const matchesPath = <N, MatchingPath extends TypePathType>(\n  diff: ObjectDiffEntry<N>,\n  path: TypePath<MatchingPath>\n): diff is ObjectDiffEntry<N, MatchingPath> => {\n  return typePathMatches(diff.path, path)\n}\n"],"mappings":";AAEA,SAAS,WAAW,uBAAiC;AAE9C,IAAK,iBAAL,kBAAKA,oBAAL;AACL,EAAAA,gBAAA,SAAM;AACN,EAAAA,gBAAA,YAAS;AACT,EAAAA,gBAAA,YAAS;AACT,EAAAA,gBAAA,UAAO;AAJG,SAAAA;AAAA,GAAA;AA0CL,IAAM,MACX,MACA,CAA2B,MAA2C,UAAkD;AACtH,SAAO,EAAE,MAAM,iBAAoB,MAAM,MAAM;AACjD;AAEK,IAAM,SACX,MACA,CAA2B,MAA2C,kBAA6D;AACjI,SAAO,EAAE,MAAM,uBAAuB,MAAM,cAAc;AAC5D;AAEK,IAAM,SACX,MACA,CACE,MACA,OACA,kBAC2B;AAC3B,SAAO,EAAE,MAAM,uBAAuB,MAAM,OAAO,cAAc;AACnE;AAEK,IAAM,cAAc,CACzB,MACA,SAC6C;AAC7C,SAAO,gBAAgB,KAAK,MAAM,IAAI;AACxC;","names":["ObjectDiffType"]}
+{"version":3,"sources":["../../src/object/object-diff.ts"],"sourcesContent":["import { ObjectPath } from '@bessemer/cornerstone/object/object-path'\nimport { ConstrainTypePath, ObjectPathType, TypePathGet, TypePathType } from '@bessemer/cornerstone/object/type-path-type'\nimport { matches as typePathMatches, TypePath } from '@bessemer/cornerstone/object/type-path'\n\n// JOHN CHECK JSON PATCH INSTEAD!!! https://jsonpatch.com/\n\nexport enum ObjectDiffType {\n  Add = 'Add',\n  Remove = 'Remove',\n  Update = 'Update',\n  Move = 'Move',\n}\n\nexport type AddObjectDiff<N, T extends TypePathType> = {\n  type: ObjectDiffType.Add\n  path: ObjectPath<T>\n  value: TypePathGet<T, N>\n}\n\nexport type RemoveObjectDiff<N, T extends TypePathType> = {\n  type: ObjectDiffType.Remove\n  path: ObjectPath<T>\n  originalValue: TypePathGet<T, N>\n}\n\nexport type UpdateObjectDiff<N, T extends TypePathType> = {\n  type: ObjectDiffType.Update\n  path: ObjectPath<T>\n  value: TypePathGet<T, N>\n  originalValue: TypePathGet<T, N>\n}\n\nexport type MoveObjectDiff<N, T extends TypePathType> = {\n  type: ObjectDiffType.Move\n  path: ObjectPath<T>\n  value: TypePathGet<T, N>\n  position: number\n  originalPosition: number\n}\n\nexport type ObjectDiffEntry<N, T extends TypePathType = TypePathType> =\n  | AddObjectDiff<N, T>\n  | RemoveObjectDiff<N, T>\n  | UpdateObjectDiff<N, T>\n  | MoveObjectDiff<N, T>\n\nexport type ObjectDiff<N> = Array<ObjectDiffEntry<N>>\n\nexport const add =\n  <N>() =>\n  <T extends ObjectPathType>(path: ObjectPath<ConstrainTypePath<T, N>>, value: TypePathGet<T, N>): AddObjectDiff<N, T> => {\n    return { type: ObjectDiffType.Add, path, value }\n  }\n\nexport const remove =\n  <N>() =>\n  <T extends ObjectPathType>(path: ObjectPath<ConstrainTypePath<T, N>>, originalValue: TypePathGet<T, N>): RemoveObjectDiff<N, T> => {\n    return { type: ObjectDiffType.Remove, path, originalValue }\n  }\n\nexport const update =\n  <N>() =>\n  <T extends ObjectPathType>(\n    path: ObjectPath<ConstrainTypePath<T, N>>,\n    value: TypePathGet<T, N>,\n    originalValue: TypePathGet<T, N>\n  ): UpdateObjectDiff<N, T> => {\n    return { type: ObjectDiffType.Update, path, value, originalValue }\n  }\n\nexport const matchesPath = <N, MatchingPath extends TypePathType>(\n  diff: ObjectDiffEntry<N>,\n  path: TypePath<MatchingPath>\n): diff is ObjectDiffEntry<N, MatchingPath> => {\n  return typePathMatches(diff.path, path)\n}\n"],"mappings":";AAEA,SAAS,WAAW,uBAAiC;AAI9C,IAAK,iBAAL,kBAAKA,oBAAL;AACL,EAAAA,gBAAA,SAAM;AACN,EAAAA,gBAAA,YAAS;AACT,EAAAA,gBAAA,YAAS;AACT,EAAAA,gBAAA,UAAO;AAJG,SAAAA;AAAA,GAAA;AA0CL,IAAM,MACX,MACA,CAA2B,MAA2C,UAAkD;AACtH,SAAO,EAAE,MAAM,iBAAoB,MAAM,MAAM;AACjD;AAEK,IAAM,SACX,MACA,CAA2B,MAA2C,kBAA6D;AACjI,SAAO,EAAE,MAAM,uBAAuB,MAAM,cAAc;AAC5D;AAEK,IAAM,SACX,MACA,CACE,MACA,OACA,kBAC2B;AAC3B,SAAO,EAAE,MAAM,uBAAuB,MAAM,OAAO,cAAc;AACnE;AAEK,IAAM,cAAc,CACzB,MACA,SAC6C;AAC7C,SAAO,gBAAgB,KAAK,MAAM,IAAI;AACxC;","names":["ObjectDiffType"]}

package/dist/object/type-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-path.d.ts","sourceRoot":"","sources":["../../src/object/type-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAExD,OAAO,GAAG,MAAM,KAAK,CAAA;AACrB,OAAO,EAEL,aAAa,EAEb,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EACjB,MAAM,6CAA6C,CAAA;AAIpD,OAAO,EAAW,MAAM,EAAW,MAAM,8BAA8B,CAAA;AAGvE,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI,UAAU,CAAC,oBAAoB,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAA;AAE/G,eAAO,MAAM,EAAE,GAAI,CAAC,SAAS,oBAAoB,EAAE,OAAO,CAAC,KAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAEtF,CAAA;AAKD,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,EAAE,MAAM,CAAC,KAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAmEzE,CAAA;AAED,eAAO,MAAM,MAAM,+IAMjB,CAAA;AAEF,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,YAAY,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAgClG,CAAA;AAsDD,eAAO,MAAM,kBAAkB,GAAI,UAAU,gBAAgB,KAAG,QAAQ,IAAI,gBAE3E,CAAA;AAED,eAAO,MAAM,OAAO,GAAI,YAAY,SAAS,YAAY,EACvD,YAAY,QAAQ,EACpB,cAAc,QAAQ,CAAC,YAAY,CAAC,KACnC,UAAU,IAAI,QAAQ,CAAC,YAAY,CA8CrC,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,YAAY,QAAQ,EAAE,kBAAkB,QAAQ,KAAG,MAAM,CAAC,QAAQ,CA0D9F,CAAA;AAGD,eAAO,MAAM,SAAS,GAAI,UAAU,SAAS,YAAY,EAAE,gBAAgB,SAAS,YAAY,EAC9F,YAAY,QAAQ,CAAC,UAAU,CAAC,EAChC,kBAAkB,QAAQ,CAAC,gBAAgB,CAAC,KAC3C,QAOF,CAAA"}
+{"version":3,"file":"type-path.d.ts","sourceRoot":"","sources":["../../src/object/type-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAExD,OAAO,GAAG,MAAM,KAAK,CAAA;AACrB,OAAO,EAEL,aAAa,EAEb,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EACjB,MAAM,6CAA6C,CAAA;AAKpD,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAGrD,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI,UAAU,CAAC,oBAAoB,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAA;AAE/G,eAAO,MAAM,EAAE,GAAI,CAAC,SAAS,oBAAoB,EAAE,OAAO,CAAC,KAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAEtF,CAAA;AAKD,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,EAAE,MAAM,CAAC,KAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAmEzE,CAAA;AAED,eAAO,MAAM,MAAM,+IAMjB,CAAA;AAEF,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,YAAY,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAgClG,CAAA;AAsDD,eAAO,MAAM,kBAAkB,GAAI,UAAU,gBAAgB,KAAG,QAAQ,IAAI,gBAE3E,CAAA;AAED,eAAO,MAAM,OAAO,GAAI,YAAY,SAAS,YAAY,EACvD,YAAY,QAAQ,EACpB,cAAc,QAAQ,CAAC,YAAY,CAAC,KACnC,UAAU,IAAI,QAAQ,CAAC,YAAY,CA8CrC,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,YAAY,QAAQ,EAAE,kBAAkB,QAAQ,KAAG,MAAM,CAAC,QAAQ,CA0D9F,CAAA;AAGD,eAAO,MAAM,SAAS,GAAI,UAAU,SAAS,YAAY,EAAE,gBAAgB,SAAS,YAAY,EAC9F,YAAY,QAAQ,CAAC,UAAU,CAAC,EAChC,kBAAkB,QAAQ,CAAC,gBAAgB,CAAC,KAC3C,QAIF,CAAA"}

package/dist/object/type-path.js

@@ -4,7 +4,7 @@ import Zod from "zod";
 import { isNil, isObject } from "@bessemer/cornerstone/object";
 import { isNumber } from "@bessemer/cornerstone/math";
 import { contains, containsAll, isEmpty, only } from "@bessemer/cornerstone/array";
-import { failure, success } from "@bessemer/cornerstone/result";
+import * as Results from "@bessemer/cornerstone/result";
 var of = (value) => {
   return value;
 };
@@ -182,7 +182,7 @@ var matches = (targetPath, matchingPath) => {
 };
 var intersectAny = (targetPath, intersectingPath) => {
   if (targetPath.length < intersectingPath.length) {
-    return failure(new Error(`TypePath: ${intersectingPath} can't intersect target TypePath: ${targetPath}`));
+    return Results.failure(new Error(`TypePath: ${intersectingPath} can't intersect target TypePath: ${targetPath}`));
   }
   let index = 0;
   let result = [];
@@ -190,51 +190,49 @@ var intersectAny = (targetPath, intersectingPath) => {
     const intersectingPathSelector = intersectingPath[index];
     const makeError = () => new Error(`Path mismatch when intersecting. targetPath: ${targetPathSelector} does not match intersectingPath: ${intersectingPathSelector}`);
     if (isNil(intersectingPathSelector)) {
-      return success(of(result));
+      return Results.success(of(result));
     } else if (isWildcardSelector(intersectingPathSelector)) {
       result.push(targetPathSelector);
     } else if (isWildcardSelector(targetPathSelector)) {
-      return failure(makeError());
+      return Results.failure(makeError());
     } else if (Array.isArray(intersectingPathSelector)) {
       if (Array.isArray(targetPathSelector)) {
         const filteredTargetPaths = targetPathSelector.filter((it) => contains(intersectingPathSelector, it));
         if (isEmpty(filteredTargetPaths)) {
-          return failure(makeError());
+          return Results.failure(makeError());
         }
         result.push(filteredTargetPaths);
       } else {
         if (!contains(intersectingPathSelector, Number(targetPathSelector))) {
-          return failure(makeError());
+          return Results.failure(makeError());
         }
         result.push(targetPathSelector);
       }
     } else {
       if (Array.isArray(targetPathSelector)) {
         if (targetPathSelector.length !== 1) {
-          return failure(makeError());
+          return Results.failure(makeError());
         }
         const targetPathSelectorIndex = only(targetPathSelector);
         if (targetPathSelectorIndex !== Number(intersectingPathSelector)) {
-          return failure(makeError());
+          return Results.failure(makeError());
         }
         result.push(targetPathSelector);
       } else {
         if (targetPathSelector !== intersectingPathSelector) {
-          return failure(makeError());
+          return Results.failure(makeError());
         }
         result.push(targetPathSelector);
       }
     }
     index++;
   }
-  return success(of(result));
+  return Results.success(of(result));
 };
 var intersect = (targetPath, intersectingPath) => {
   const result = intersectAny(targetPath, intersectingPath);
-  if (!result.isSuccess) {
-    throw result.value;
-  }
-  return result.value;
+  Results.assertSuccess(result);
+  return result;
 };
 export {
   Schema,